Curator

# 监护人 <p align="center"> <img src="docs/media/demo.gif" alt="监护人面板演示" width="760" /> </p> > 适用于您Claude Code技能和MCP服务器的开源本地仪表盘。免费，无需登录，无需API密钥。一览您的库，找到重复项，决定保留哪些。 ## 它做什么 `监护人`在本地运行一个网络仪表盘，网址为 `http://127.0.0.1:4711`，让您可以实际看到您的技能和MCP设置中有什么。 - **一览无遗的概览** — 总技能数、始终加载与按需使用的令牌成本、等级分布、最重要的描述、最重要的正文、MCP服务器。 - **集群重叠分析** — 分层聚类以显示重叠的技能。点击任意集群，查看共享的核心词汇、每个技能的独特词汇和成对相似度。成员如果没有独特词汇，则被标记为可能重复的技能。 - **主题浏览** — 在侧边栏中自动检测标签分组（`kotlin`、`testing`、`frontend`等）。一个技能可以属于多个主题。 - **原地编辑和删除** — 点击用户拥有的技能，编辑正文，保存。或删除它。插件安装的技能是只读的。 - **每次更改前的备份** — 写入 `~/.claude/curator/backups/`。每次编辑和删除都是可逆的。 没有任何更改会自动应用。您决定保留什么。 默认情况下，技能扫描包括： - `~/.claude/skills` - `~/.claude/plugins` - `~/.agents/skills` - 当前工作区及其父目录中的 `.agents/skills` 要扫描其他工作区本地的技能库，请传递一个路径列表，并使用shell的路径分隔符： ```bash CURATOR_EXTRA_SKILLS_DIRS=/path/to/project/.agents/skills 监护人 scan ``` ## 安装 ```bash git clone git@github.com:KarimJebara/Curator.git cd Curator npm install npm link # 将`监护人`添加到PATH；一次性设置 ``` `npm link`是可选的 — 您也可以将所有内容作为`node bin/curator.js <cmd>`运行。 ### 可选：安装为可点击的Mac应用程序 如果您想要一个`Curator.app`，可以通过Spotlight或Dock启动，而不是从终端运行`监护人 dashboard`: ```bash bash scripts/build-app.sh cp -r dist/Curator.app /Applications/ ``` 点击图标会打开一个终端窗口，运行`监护人 dashboard`。关闭终端窗口会停止服务器。需要先运行`npm link`，使`监护人`位于PATH中。 ## 快速入门 ```bash 监护人 scan # 确定性快照，~3秒，无需API密钥 监护人 dashboard # 在浏览器中打开 http://127.0.0.1:4711 ``` 就这样。默认扫描是完全确定性的，几秒钟内完成。还有一个每周cron选项，如果您想让它自动重新快照： ```bash 监护人 schedule install ``` ## 工作原理 一次`监护人 scan`会生成您库的两个视图： **集群** — 基于TF-IDF + 二元组的Ward-linkage层次聚类，带有轮廓置信度评分。每个集群都有高（≥0.28）、中（0.18–0.28）或低（<0.18）的置信度徽章，让您知道该分组的可信度。点击仪表盘中的集群，查看其成员的共享内容、每个成员的独特内容和成对余弦相似度。成员如果没有独特词汇，会突出显示 — 这些是您的重复技能。 **主题** — 基于技能名称、描述和已知词汇扫描的标签分组。一个技能可以属于多个主题。在仪表盘侧边栏中显示。 ## 始终加载与按需令牌成本 仪表盘区分的两种不同成本类别： - **始终加载** — 每个SKILL.md顶部的`description:`行在**每次会话**中都会加载到Claude中，以便autorouter可以决定调用哪个技能。无论您是否使用该技能，都需要支付此费用。通常每个技能30–100个令牌。 - **按需使用** — 技能的正文（前面的内容除外）在**仅当技能工具实际触发**时才会加载。通常200–6,000个令牌。 两者分别评级，因为规则不同。冗长的描述会每次会话都造成伤害 — 这是应该积极修剪的类型。冗长的正文只会在技能实际触发的会话中造成伤害，因此如果触发后值得，深度是可以接受的。 ## 高级：LLM驱动的重写（可选） 默认扫描是确定性的。如果您想要机器提出的专业化，请传递 `--rewrite` 运行5阶段的LLM流水线： ```bash 监护人 scan --rewrite # ~2–3分钟每个集群 监护人 review # 浏览建议为是/否的闪存卡 ``` | 阶段 | 模型 | 目的 | |---|---|---| | 1. 检测集群 | 无 | 确定性聚类 | | 2. 指纹识别 | Haiku 4.5 | 提取每个技能的独特优势 | | 3. 专业化 | Sonnet 4.6 | 提出重命名 + 压缩提示 | | 4. 生成路由器 | Sonnet 4.6 | 生成路由器SKILL.md | | 5. 验证 | Sonnet 4.6（全新实例） | 独立的第二意见 | 这是高级用户模式，而不是主要功能。仅仪表盘就是主要功能。 ## 比较 `监护人`不是该领域的第一个工具。在 [`docs/COMPARISON.md`](./docs/COMPARISON.md)中有诚实的比较。简而言之： - [`claudetoolkit.com`](https://claudetoolkit.com/) — 封闭源代码桌面GUI，freemium。最接近的类似产品。如果您想要一个商业化产品，涵盖每种配置类型，请选择此产品。我们是开源替代品，专注于技能 + MCP，带有聚类功能。 - [`claude-config-audit`](https://github.com/paolodalprato/claude-config-audit)，[`mcp-optimizer`](https://github.com/choam2426/mcp-optimizer)，[`mcp-tidy`](https://github.com/nnnkkk7/mcp-tidy)，`mcp-checkup`，[`claude-code-organizer`](https://github.com/mcpware/claude-code-organizer) — 所有开源CLI审计工具。没有Web仪表盘或聚类功能。我们借鉴了这些工具的检测模式（并给予了 credit）。 ## 路线图 **v0.1（当前）** - 本地Web仪表盘，集群重叠分析，始终加载与按需令牌评级 - MCP重复 + 令牌成本检测，孤儿和漂移标记 - 每周cron快照 - 可选 `--rewrite` LLM流水线 **v0.2（下一个）** - 通过UI编辑MCP服务器 - 批量选择 + 删除 - 仪表盘中的斜杠命令和代理 - 技能对比 - 根据 `~/.claude/projects/*.jsonl` 跟踪效果（查找应该触发但未触发的技能） - 跨工具：Cursor，Codex，OpenCode，Claude Desktop ## 许可证和贡献 MIT — 见 [LICENSE](./LICENSE)。CLI是并将保持MIT。 贡献需要经过CLA（见 [CONTRIBUTING.md](./CONTRIBUTING.md)）— 需要保持项目长期许可。CLA bot会在您的第一个PR上为您签名。