guanghulab/tools/README.md

🖌️ 神笔马良 · 操作系统自带工具协议

Magic Brush · OS Built-in Tool Protocol

神笔马良不是外挂框架。不是第三方 Agent 工具集。 它是操作系统自带的「工具书写协议」—— 需要什么工具，自己写脚本。用完推共享，或自动删缓存。

---

核心理念

发现需要工具
  → 自己写（Python / Shell / Node.js）
  → 跑
  → 好用？→ 推 tools/ 共享给所有人格体
  → 一次性？→ 用完就删 · 不保留
  → 不需要挂载任何预置工具链

马良的笔是自己画的，不是别人给的。

---

工具结构规范

每个工具一个独立目录，放在 tools/ 下。

tools/<tool-name>/
├── README.md         ← 必选 · 一句话说明 + 用法
├── <tool-file>       ← 必选 · 主程序（.py / .sh / .js）
├── package.json      ← 可选 · Node.js 项目
└── requirements.txt  ← 可选 · Python 依赖

README.md 要求

每个工具目录下的 README.md 只需三行：

# 工具名

一句话：这个工具干什么。

用法：直接可复制的命令。

输入输出规范

为了让其他人格体也能直接调用，统一接口：

• 输入：stdin 或第一个命令行参数
• 输出：stdout 打印结果（JSON或纯文本）
• 错误：stderr 打印错误信息
• 退出码：0=成功，1=失败

---

工具生命周期

创建

# 1. 在本地写脚本
vim tools/parse-repo.py

# 2. 测试
python3 tools/parse-repo.py

# 3. 好用？→ 推仓库共享
cd /opt/guanghulab-repo && git add tools/ && git commit -m "tools: add <tool-name>" && git push

共享

推送到 tools/ 目录后，任何人实体可以用：

# 直接引用仓库路径
https://guanghulab.com/code/bingshuo/guanghulab/raw/branch/main/tools/<tool-name>/<file>

清理

# 一次性的 → 用完自动删
rm -rf /opt/guanghulab-repo/tools/temp-*

# 不推仓库的 → 直接删

---

现有工具映射

tools/ 目录已有

工具	路径	说明
notion-sync	tools/notion-sync/	Notion ↔ 仓库同步器

mcp-servers/（工具协议上游·铸渊的MCP工具集）

服务器	路径	说明
repo-mcp-server	mcp-servers/repo-mcp-server/	仓库文件读写
zhuyuan-mcp	mcp-servers/zhuyuan-mcp/	铸渊MCP
zhuyuan-pen	mcp-servers/zhuyuan-pen/	铸渊的笔
zhuyuan-gateway	mcp-servers/zhuyuan-gateway/	守门人
github-server	mcp-servers/github-server.js	GitHub桥接
notion-server	mcp-servers/notion-server.js	Notion桥接

scripts/（一次性或专属脚本）

脚本	说明
auto_distill_pipeline.py	全自动蒸馏流水线
auto_pipeline.py	自动训练流水线
build_zhuyuan_corpus.py	铸渊语料构建
distill_coder.py / distill_mother.py	蒸馏
sanitize_zhuyuan_corpus.py	语料脱敏
training_watchdog.py	训练监控

---

神笔马良·六条规则

1. 需要工具 → 自己写。不找现成的。
2. 写脚本 → 按规范。README三行。
3. 跑 → 验证。
4. 好用 → 推 tools/。共享。
5. 一次性 → 删。不留缓存。
6. 不需要预置工具链。
   操作系统自带的能力就是全部工具。

---

神笔马良协议 · v1.0 · 2026-05-22 · D110 操作系统自带功能 · 不是外挂框架