docs: harden ai citation and external governance

tools/external/AGENTS.md

@@ -49,4 +49,6 @@ skills/auto-skill/scripts/skill-seekers-src -> Skill_Seekers-development/src
 2. **同仓多入口展示**：使用相对软链接，例如 `skills/<name> -> ../tools/external/<name>`。
 3. **项目内小工具**：只有在无上游、体量小、与本项目强耦合时才直接追踪源码。
 4. **生成输出**：默认不跟踪；若必须保留样例，只提交最小样例和生成说明。
-5. **历史备份**：`scripts/backups/` 按项目资产处理，不套用外部仓库清退规则。
+5. **普通目录**：`html-tools-main/`、`my-nvim/`、`MCPlayerTransfer/`、`XHS-image-to-PDF-conversion/` 当前作为小体量工具快照保留；确认上游 URL 后再转 submodule。
+6. **清退触发**：普通目录出现体量膨胀、生成物混入、上游仓库明确或需要频繁升级时，必须优先转 submodule 或迁出主仓库。
+7. **语言统计**：`tools/external/**` 已在根目录 `.gitattributes` 标记为 `linguist-vendored`，避免外部工具源码污染主仓库语言占比。

tools/external/README.md

@@ -37,9 +37,25 @@ tools/external/
 
 - 提示词转换工具已迁移到 `tools/prompts-library/`。
 - AI 聊天记录保存工具已迁移到 `tools/chat-vault/`。
-- 备份脚本已迁移到 `scripts/backups/`。
 - 技能库入口已迁移到 `skills/`。
 
+## 当前源码表达状态
+
+| 目录 | 当前表达 | 处理策略 |
+|:---|:---|:---|
+| `.tmux/` | Git submodule | 保留 submodule 指针 |
+| `tmux/` | Git submodule | 保留 submodule 指针 |
+| `claude-official-skills/` | Git submodule | 保留 submodule 指针，并通过 `skills/claude-official-skills` 软链接展示 |
+| `Skill_Seekers-development/` | Git submodule | 保留 submodule 指针，并通过 `skills/auto-skill/scripts/Skill_Seekers-development` 软链接供 auto-skill 使用 |
+| `html-tools-main/` | 普通目录 | 体量小，暂作为本仓库工具快照保留；确认上游 URL 后可转 submodule |
+| `my-nvim/` | 普通目录 | 体量小，暂作为配置样例保留；确认上游 URL 后可转 submodule |
+| `MCPlayerTransfer/` | 普通目录 | 体量小，暂作为独立工具快照保留；确认上游 URL 后可转 submodule |
+| `XHS-image-to-PDF-conversion/` | 普通目录 | 体量小，暂作为独立工具快照保留；确认上游 URL 后可转 submodule |
+
+普通目录不得继续扩张为大型源码快照；新增外部仓库默认使用 submodule。
+
+为避免外部工具源码影响主仓库语言统计，根目录 `.gitattributes` 已将 `tools/external/**` 标记为 `linguist-vendored`。
+
 ## 当前软链接显示
 
 | 事实来源 | 展示入口 | 说明 |