MooTool 1.7.8:把随手记和 JSON 管理从数据库搬到文件夹里

2026-07-04 27 预计阅读时间: 1 分钟
来源: oschina.net AI 摘要 Original link

Disclaimer: This article is an AI-assisted summary. Read it together with the original source when precision matters. The summary may omit context, version differences, or edge cases and is not official documentation.

预计阅读时间:8 分钟

MooTool 1.7.8 的重点不是多加一个炫目的按钮,而是把开发者高频使用的两类内容:随手记和 JSON 文档,从更封闭的数据库管理方式,推向更透明的 txt 文件、文件夹和 Git 工作流。这类改动看起来朴素,但对长期使用工具的人很关键:数据更容易备份、比较、迁移,也更适合纳入团队或个人的版本管理习惯。

文件化以后,工具数据不再困在工具里

这次更新里,【随手记】的数据管理从数据库改为 txt 文件,并支持文件夹与 Git 版本控制。对开发者来说,这意味着笔记不再只是某个桌面应用内部的一组记录,而是可以被普通编辑器、命令行、搜索工具和 Git 直接处理的文件。

这类设计的好处很直接:

  • ripgrep、IDE 或系统搜索快速查历史记录。
  • 用 Git 查看某条笔记什么时候改过、改了什么。
  • 换机器时,可以直接同步文件夹,而不是导出导入数据库。
  • 数据格式简单,长期可读性更好。

边界也要说清楚:文件化不等于天然解决所有同步冲突。如果你在多台机器上同时编辑同一个 txt 文件,Git 仍然可能产生冲突。好消息是,冲突至少是明文的,开发者能看懂、能合并。

JSON 管理也开始“文档化”和“Git 化”

更新摘要里提到,【JSON】参考随手记实现文档化与 Git 化管理,并新增文件夹工具栏操作。这个方向很实用:很多开发者手里都有一堆 JSON 片段,例如接口响应样例、配置模板、调试 payload、第三方 webhook 示例。

如果这些 JSON 只存在工具内部,复用成本会越来越高;如果它们落成文件,就可以进入常规工程实践:

  • 按项目、接口、环境建立目录。
  • 对 JSON 文件做格式化、校验和 diff。
  • 在 Git 里记录字段变更。
  • 和接口文档、测试用例、Mock 服务放在一起管理。

新增文件夹工具栏操作也说明 MooTool 这次不是只改了存储层,而是在交互上把“文件夹作为一等对象”暴露出来。对桌面小工具来说,这比单纯增加一个导入导出按钮更贴近日常工作流。

可以这样实践:把 MooTool 数据目录纳入 Git

下面示例基于一个明确假设:你已经在 MooTool 中把【随手记】或【JSON】数据放到某个本地文件夹,例如 ~/Documents/MooTool。实际路径请替换为你自己的目录。

cd ~/Documents/MooTool

git init

cat > .gitignore <<'EOF'
.DS_Store
Thumbs.db
*.tmp
*.bak
EOF

git add .
git commit -m "Initialize MooTool notes and JSON documents"

之后,每次整理完随手记或 JSON 文档,可以提交一次:

cd ~/Documents/MooTool

git status
git diff -- notes/example.txt
git diff -- json/sample-response.json

git add notes json
git commit -m "Update API notes and JSON samples"

如果你希望把 JSON 文件纳入基本校验,可以在数据目录里放一个简单脚本。下面脚本会递归检查当前目录下所有 .json 文件是否合法,并输出规范化后的缩进内容到临时文件,适合在提交前跑一遍。

cat > check-json.sh <<'EOF'
#!/usr/bin/env bash
set -euo pipefail

find . -name '*.json' -type f -print0 | while IFS= read -r -d '' file; do
  python3 -m json.tool "$file" > /tmp/mootool-json-check.json
  echo "OK $file"
done
EOF

chmod +x check-json.sh
./check-json.sh

如果要进一步接入 Git hook,可以这样做:

mkdir -p .git/hooks
cat > .git/hooks/pre-commit <<'EOF'
#!/usr/bin/env bash
set -euo pipefail

find . -name '*.json' -type f -print0 | while IFS= read -r -d '' file; do
  python3 -m json.tool "$file" > /dev/null
  echo "JSON OK: $file"
done
EOF

chmod +x .git/hooks/pre-commit

这样提交时,明显损坏的 JSON 会被拦下来。它不会替你判断字段语义是否正确,但能挡住少逗号、多括号这类低级错误。

排序能力虽小,但会影响日常效率

这次【随手记/JSON】列表支持按名称、更新时间、创建时间排序,其中默认按更新时间排序。这个默认值合理:开发者打开工具时,通常最想找的是“刚才改过的那份 payload”或“最近记下的排查结论”。

不同排序适合不同场景:

  • 更新时间:适合日常工作流,最近处理的内容浮在上面。
  • 创建时间:适合回顾某个问题的记录脉络。
  • 名称:适合已经建立命名规范的 JSON 样例和笔记库。

建议给文件名加一点结构,例如:

notes/
  api-auth-token-refresh.txt
  incident-2025-01-payment-timeout.txt
json/
  user-login-request.json
  user-login-response-success.json
  webhook-payment-failed.json

有了稳定命名,再配合名称排序和 Git diff,MooTool 就更像一个轻量的开发者资料库,而不是临时剪贴板。

采用建议:先管住目录,再谈同步

MooTool 1.7.8 的价值在于把桌面工具的数据管理方式拉近了开发者熟悉的文件系统和 Git。建议从三个动作开始:

  • 给随手记和 JSON 分别建立清晰目录,不要所有文件堆在根目录。
  • 把数据目录纳入 Git,至少保留本地提交历史。
  • 对 JSON 文件加提交前校验,避免坏样例沉进资料库。

需要注意的是,Git 适合版本管理,不等于实时同步工具。如果你要跨设备使用,可以再叠加云盘、私有 Git 仓库或其他同步方案,但要避免多端同时编辑同一个文件。对一个“开发者常备小工具”来说,这次更新最值得关注的点正是:数据终于可以按开发者自己的方式被管理了。


相关推荐