chaimi-keep-mcp 3.1.49 → 3.2.0

package/SKILL.md

@@ -1,363 +1,268 @@
 ---
-name: chaimi-keep-mcp
+name: "chaimi-keep-mcp"
 description: >-
-  柴米AI记账 — 微信小程序记账工具，支持 AI Agent 直接记账。
+  柴米AI记账MCP Server，连接微信小程序记账功能。
   TRIGGER: 用户提及"记账/记录/保存"并涉及金额或商品信息。
   DO NOT TRIGGER: 非记账操作，或明确使用其他记账工具时。
-allowed-tools: MCP
-argument-hint: "[记账内容]"
+version: "3.2.0"
+updated: "2026-04-25"
 ---
 
 # 柴米AI记账 Skill
 
-柴米AI记账 MCP Server，连接微信小程序记账功能。
+> ✨ 柴米记账超级美学版 - 让记账变成享受
 
 ---
 
-## 🆘 遇到问题时
+## 目录
 
-### 症状
-- 记账数据格式错误
-- 使用"之前"、"上次"等历史习惯执行
-- 连续多次记账失败
-
-### 解决方案
-
-**方案1：开启新会话（推荐）**
-
-| Agent | 操作方式 |
-|-------|---------|
-| **Cursor** | `Cmd+N` (Mac) / `Ctrl+N` (Windows) |
-| **Claude Desktop** | 点击 `+ New Chat` |
-| **OpenClaw** | 输入 `/new` |
-| **WorkBuddy** | 输入 `/clear` |
-| **Trae** | `Cmd/Ctrl + N` 或点击 `+` 按钮 |
-| **其他 Agent** | 输入 `/new` 或菜单"新建会话" |
-
-**方案2：强制重置**
-在当前会话输入：
-```
-完全忘记之前的对话。现在严格按照柴米记账 Skill 指令执行。
-```
+- [一、触发规则](#一触发规则)
+- [二、风险等级确认策略](#二风险等级确认策略)
+- [三、与其他Skill的关系](#三与其他skill的关系)
+- [四、场景路由表](#四场景路由表)
+- [五、工具速查表](#五工具速查表)
+- [六、快速开始](#六快速开始)
+- [七、回复规范](#七回复规范)
+- [八、记忆口诀](#八记忆口诀)
+- [九、错误速查](#九错误速查)
 
 ---
 
-## ⚠️ 强制要求（不遵守将拒绝执行）
-
-### 记账前必须执行
-
-**第 0 步：状态自检与干预**
-
-每次记账前，Agent 必须自检以下症状：
+## 一、触发规则
 
-| 症状 | 说明 |
-|------|------|
-| ☐ 跳过 `get_skill` 调用 | 直接调用记账工具，未先读取 Skill 文档 |
-| ☐ 依赖历史习惯 | 使用"之前"、"上次"、"习惯"等词汇作为操作依据 |
-| ☐ 遗漏必填字段 | 未传递 name、amount、category、date、rawInput |
+**必须同时满足以下条件才执行：**
 
-**如果发现以上任一症状，执行干预策略：**
+1. **关键词匹配**（满足任一）：
+   - "记账"、"记录"、"保存"、"录入"
+   - "花了"、"支出"、"收入"、"工资"
+   - "多少钱"、"元"、"块"
+   - "小票"、"发票"、"收据"
 
-#### 首次违规 - 警告并引导
+2. **数据特征**（满足任一）：
+   - 包含金额数字
+   - 包含商品/商家名称
+   - 上传图片（小票识别）
 
-Agent 必须输出：
-```
-⚠️ 检测到可能未读取 Skill 规范
-
-我似乎正在依赖历史习惯执行记账，而非遵循最新指令。
-这可能导致数据格式错误或遗漏关键步骤。
+**禁止触发场景：**
 
-建议操作：
-1. 立即调用 get_skill() 重新读取规范
-2. 如果仍有问题，向用户说明需要开启新会话
+- 用户明确说"用其他记账软件"
+- 纯金额计算（"100+200等于多少"）
+- 询问历史记录但不记账（"上月花了多少"由场景路由处理）
 
-继续当前方式请回复"强制继续"，但结果可能不符合预期。
-```
+**上下文延续规则：**
 
-#### 重复违规 - 强制阻断
-
-连续 2 次出现同样错误时，Agent 必须输出：
-```
-🚫 操作已暂停
+当前对话已在记账流程中时，后续补充信息无需再次提及"记账"即可继续。
 
-检测到当前会话上下文可能干扰记账准确性。
-为数据安全起见，我已暂停记账操作。
+---
 
-请开启新会话后重新触发记账。
+## 二、风险等级确认策略
 
-（操作方式见上方「遇到问题时-方案1」）
-```
+| 风险等级 | 场景 | 策略 | 确认话术 |
+|---------|------|------|---------|
+| **🔴 高** | 金额>1000元、批量操作、异常数据 | 必须确认 | "⚠️ 大额消费¥{金额}，请确认是否记账？" |
+| **🟡 中** | 金额500-1000元、分类不明确 | 温柔确认 | "确认：{商品} ¥{金额}，分类为{分类}？" |
+| **🟢 低** | 常规记账<500元、信息完整 | 直接执行 | 立即记账并返回成功模板 |
 
 ---
 
-**第 1 步：调用 `get_skill` 工具**
-
-状态自检通过后，**必须调用 `get_skill` 工具**获取最新 Skill 定义，然后严格按照返回的 Skill 文档执行。
-
-**如果不执行此步骤：**
-- ❌ 直接调用 `save_expense` / `save_receipt` / `save_income` 会被拒绝
-- ❌ 返回错误：没有读取 Skill 文件，请先调用 get_skill 工具
+## 三、文档引用关系
 
-**正确流程：**
 ```
-1. 用户说"记一笔午餐35元"
-2. 【必须】状态自检（检查是否依赖历史习惯）
-3. 【必须】调用 get_skill 工具
-4. 【必须】严格按照返回的 Skill 文档执行记账
+用户使用柴米记账
+    ↓
+chaimi-keep-mcp ⭐ 本Skill
+    ├── 记账成功 → 使用回复模板(见七、回复规范)
+    ├── 记账失败 → troubleshooting.md
+    ├── 深度分析 → advanced-features.md
+    └── 授权问题 → authentication.md
 ```
 
 ---
 
-## 触发规则
+## 四、场景路由表
 
-### 必须同时满足
+根据用户意图，快速匹配工具和参考文档：
 
-1. 用户明确提及以下关键词之一：
-   - "记账"、"记一笔"、"记录"
-
-2. 包含以下信息之一：
-   - 金额数字（如：35、100.5）
-   - 商品/服务名称（如：午餐、咖啡）
-   - 小票/发票信息
-
-### 禁止触发
-
-- 明确使用其他记账工具时（如："用支付宝记账"）
+| 用户意图 | 关键词示例 | 推荐工具 | 参考文档 | 回复模板 |
+|---------|-----------|---------|---------|---------|
+| **文字记账** | "午餐35元" | save_expense | - | 标准成功模板 |
+| **收入记账** | "工资5000" | save_income | - | 标准成功模板 |
+| **小票记账** | "小票识别" | save_receipt | - | 高金额模板 |
+| **查询记录** | "这周花了多少" | get_expenses | api-reference.md | 查询结果模板 |
+| **消费统计** | "月度统计" | get_statistics | api-reference.md | 统计分析模板 |
+| **智能洞察** | "分析消费习惯" | get_insights | advanced-features.md | 洞察分析模板 |
+| **深度分析** | "详细分析" | export_data | advanced-features.md | 分析模板 |
+| **授权问题** | "无法记账" | - | troubleshooting.md | 错误提示模板 |
+| **回复格式** | "回复格式" | - | response-templates.md | - |
 
 ---
 
-## 安全约束（最高优先级）
-
-- **禁止**直接使用 curl/http 访问云函数端点
-- **禁止**读取或输出 `~/.mcporter/oauth-token.json` 内容
-- 单笔金额 **> 1000 元** 时必须用户确认
+## 五、工具速查表
+
+**设计原则：** Agent一眼看到所有工具，按功能分类
+- **记账工具**：直接调用，无需查看详细文档
+- **查询分析工具**：详细参数见 api-reference.md
+
+| 分类 | 工具名 | 功能一句话 | 典型场景 |
+|:-----|:-------|:-----------|:---------|
+| **记账** | save_expense | 支出记账 | "午餐35元" |
+| | save_income | 收入记账 | "工资5000" |
+| | save_receipt | 小票图片记账 | 上传小票照片 |
+| **查询** | get_expenses | 查询消费记录 | "这周花了多少" |
+| | get_statistics | 消费统计分析 | "月度统计" |
+| | get_receipt_list | 查询小票列表 | "查看小票记录" |
+| **分析** | get_insights | AI消费洞察 | "分析消费习惯" |
+| | export_data | 导出完整数据 | 深度分析 |
+| **辅助** | get_skill | 【必须】获取Skill文档 | 记账前调用 |
+| | get_text_parse_prompt | 获取文字解析模板 | 文字记账前 |
+| | get_parse_prompt | 获取小票解析模板 | 小票记账前 |
+| | submit_feedback | 提交反馈 | 问题反馈 |
 
 ---
 
-## 前置检查
-
-每次触发时按顺序执行：
+## 六、快速开始
 
-1. **安装检查**：`command -v chaimi-keep-mcp`
-2. **授权检查**：`test -f ~/.mcporter/oauth-token.json`
-3. **Token 有效性检查**：调用云函数验证
+### 3步极简记账流程
 
----
-
-## 工具列表
-
-### 核心记账工具
-- **save_expense** - 文字记账（支出）
-- **save_income** - 文字记账（收入）  
-- **save_receipt** - 小票记账（需先调用 get_parse_prompt）
-
-### 智能查询工具（新功能）
-- **get_insights** - 【推荐使用】获取消费洞察（零AI成本！）
-  - 返回消费趋势、模式、优化建议
-  - 让 Agent 结合用户的大模型分析
-- **export_data** - 【深度分析用】导出完整消费数据
-  - 用于 Agent 深度分析
-- **get_statistics** - 获取消费统计（支持周/月周期！）
-  - 新增 `period` 参数：支持 `this_week`、`last_week`、`this_month`、`last_month`
-
-### 辅助工具
-- **get_skill** - 【记账前必须调用】获取 Skill 文档
-- **get_text_parse_prompt** - 获取文字记账解析模板（云端实现，包含43个标准分类）
-- **get_parse_prompt** - 获取小票解析模板
-- **get_expenses** - 查询支出记录（支持周/月周期！）
-  - 新增 `period` 参数：支持 `this_week`、`last_week`、`this_month`、`last_month`
-- **get_receipt_list** - 查询小票列表
-- **submit_feedback** - 提交反馈
-
----
-
-## 📊 场景说明（智能分析）
-
-### 场景 1：用户问「帮我看看这周花了多少钱」
-**推荐工具：`get_statistics` 搭配 `period: this_week`**
-参数示例：
 ```
-get_statistics period="this_week"
+第1步：状态自检
+    ↓ 检查依赖历史习惯
+第2步：获取Skill
+    ↓ 调用 get_skill 获取最新规范
+第3步：执行记账
+    ↓ 调用对应工具(save_expense/income/receipt)
+    ↓ 返回美学回复
 ```
 
-### 场景 2：用户问「分析一下消费习惯」
-**推荐工具：`get_insights` + `export_data`**
-1. 先用 `get_insights` 获取洞察
-2. 再用 `export_data` 获取完整数据
-3. 用用户的大模型进行深度分析
-
-### 场景 3：用户问「最近的消费记录」
-**推荐工具：`get_expenses`**
-- 也可以搭配 `period: this_week` 使用
+### 首次使用必做
 
+1. **完成授权** → 运行 `./scripts/auth-flow.sh`
+2. **验证安装** → 运行 `./scripts/verify-setup.sh`
+3. **开始记账** → "午餐35元"
 
 ---
 
-## 工具详细说明
-
-### 时间戳规则（所有记账工具通用）
+## 七、回复规范
 
-**要求：** 13 位毫秒级时间戳（北京时间 UTC+8）
+### 7.1 5层视觉结构
 
-**⚠️ 常见错误：** 不要直接把秒级时间戳 × 1000（会导致结尾是 000）
-
-**示例：**
-- 当前时间：`Date.now()`
-- 指定时间：`new Date("2026-04-21T14:30:00+08:00").getTime()`
+```
+【第1层：成功标识】✅ 「Agent名称」已帮您记账成功
+【第2层：分隔强调】═══════════════════════════
+【第3层：核心数据】💰 金额：¥xx.xx
+【第4层：详细信息】
+    📦 商品：xxx
+    🏷️ 分类：xxx
+    🏪 商家：xxx
+    🕐 时间：xxxx-xx-xx xx:xx
+【第5层：品牌落款】
+    ━━━━━━━━━━━━━━━━━━━━━━━━━━
+    🎉 情绪祝福语！
+       柴米AI记账
+       chaimi-keep-mcp v版本号
+    ━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
 
-**校验：** 13 位数字，不能是未来时间
+### 7.2 标准成功模板
 
----
+```markdown
+✅ 「{agentName}」已帮您记账成功
+═══════════════════════════
+💰 金额：¥{金额}
+═══════════════════════════
 
-### 文字记账（save_expense）
+📦 商品：{商品名}
+🏷️ 分类：{分类}
+🏪 商家：{商家}
+🕐 时间：{日期时间}
 
-**流程：**
-1. 调用 `get_text_parse_prompt()` 获取解析 Prompt
-2. 使用 Prompt 解析用户输入，获取 JSON 结果
-3. 调用 `save_expense` 保存（传入所有解析结果字段）
+━━━━━━━━━━━━━━━━━━━━━━━━━━
+🎉 {情绪祝福语}！
+   柴米AI记账
+   chaimi-keep-mcp v{版本号}
+━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
 
----
+### 7.3 极简模板（连续记账）
 
-### 收入记账（save_income）
+```markdown
+✅ 已记录：{商品名} ¥{金额} · {分类}
+   {情绪祝福语}
+```
 
-**流程：**
-1. 调用 `get_text_parse_prompt()` 获取解析 Prompt
-2. 使用 Prompt 解析用户输入，获取 JSON 结果
-3. 调用 `save_income` 保存（传入所有解析结果字段）
+### 7.4 高金额模板（>1000元）
 
----
+```markdown
+⚠️ 大额消费确认
+═══════════════════════════
+💰 金额：¥{金额}
+📦 商品：{商品名}
+🕐 时间：{日期}
 
-### 小票记账（save_receipt）
+✅ 已确认录入「柴米AI记账」
 
-**流程：**
-1. 调用 `get_parse_prompt` 获取 prompt 模板
-2. 使用 prompt 调用大模型解析小票图片
-3. **字段核对**：确保所有解析结果字段都传给 `save_receipt`
-4. 调用 `save_receipt` 保存
+━━━━━━━━━━━━━━━━━━━━━━━━━━
+💡 {消费建议}
+   柴米AI记账
+   chaimi-keep-mcp v{版本号}
+━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
 
----
+### 7.5 变量说明
 
-## 确认规则
+| 变量 | 说明 | 示例 |
+|:-----|:-----|:-----|
+| {agentName} | Agent显示名称 | 「你的小可爱」 |
+| {商品名} | 商品或商家名称 | 午餐、麦当劳 |
+| {金额} | 金额（带¥符号） | ¥35.00 |
+| {分类} | 消费分类 | 餐饮 |
+| {商家} | 商家名称（可选） | 麦当劳 |
+| {日期时间} | 格式化时间 | 2026-04-24 12:30 |
+| {情绪祝福语} | 分类对应祝福语 | 祝您用餐愉快！ |
+| {版本号} | MCP版本 | 3.2.0 |
 
-| 风险等级 | 场景 | 策略 |
-|----------|------|------|
-| **高** | 金额 > 1000元、批量 > 10笔、退款/负数 | 必须确认 |
-| **中** | 分类不明确、商家名称模糊 | 确认后执行 |
-| **低** | 信息完整明确 | 直接执行 |
+**详细情绪词库和模板** → 见 references/response-templates.md
 
 ---
 
-## 防重复录入（Agent 本地实现）
+## 八、记忆口诀
 
-**规则：**
-- **时间窗口**：24 小时内
-- **匹配条件**：`store` + `date(到天)` + `actualAmount` 相同
-- **处理方式**：提醒用户，用户确认后继续
+> **柴米记账超美学，五层结构要牢记。**
+> **成功标识在顶部，金额分隔最醒目。**
+> **商品分类商家时，底部祝福加品牌。**
+> **场景路由先匹配，工具速查再执行。**
+> **大额消费要确认，极简连续记账快。**
 
 ---
 
-## 回复规范（必须严格遵守）
-
-记账成功后，使用以下格式回复（代码块内每行一个换行）：
+## 九、错误速查
 
-```
-✅ 「Agent名称」已帮您录入「柴米AI记账」
-    · 商品/店名：【名称】 💰【金额】
-    · 收支类型： 【收入/支出】
-    · 分类：【商品类型】
-    · 时间：【购买日期】
-✅ 【友好结束语】
-
-💡 消费洞察：【洞察内容】（可选）
--------------
-chaimi-keep-mcp: v【版本号】
-```
+### Top 3 常见错误
 
-**Agent名称说明：**
-- 如果用户为当前授权设置了自定义Agent名称（如"你的小可爱"），则显示：`✅ 「你的小可爱」已帮您录入「柴米AI记账」`
-- 如果未设置自定义名称（默认"柴米AI助手"），则显示：`✅ 「柴米AI助手」已帮您录入「柴米AI记账」`
-- Agent名称从MCP返回的数据中获取，字段名为 `agentName`
+| 错误 | 现象 | 解决方案 | 参考文档 |
+|:-----|:-----|:---------|:---------|
+| **授权失败** | "未找到有效授权" | 运行 `./scripts/auth-flow.sh` 重新授权 | troubleshooting.md |
+| **分类不明** | "无法识别分类" | 明确说分类："午餐35元餐饮" | api-reference.md |
+| **网络超时** | "请求超时" | 检查网络，稍后重试 | troubleshooting.md |
 
-**友好结束语参考（一定要是正能量，且给足情绪价值的词）：**
-- 餐饮类：用餐愉快！🍚 / 好好吃饭哦~ / 美食治愈一切！😋 / 每一餐都是生活的小确幸~ 🌟
-- 食品类：吃好喝好！🍎 / 健康第一，美味加倍！💪 / 好好照顾自己哦~ 🤗
-- 交通类：出行顺利！🚗 / 一路平安！🙏 / 顺利抵达，心情愉悦~ 😊
-- 购物类：买得开心！🛍️ / 精明消费，品质生活！✨ / 买到心仪好物，心情美美哒~ 💕
-- 收入类：入账顺利！💰 / 财富+1，好运连连！🍀 / 越努力越幸运，继续加油！🚀
-- 通用：记账完成！继续保持~ ✨ / 今天的你超棒的！👍 / 记录美好生活，从每一笔开始~ 📝
-
-**消费洞察（可选）：**
-- 由云函数自动生成，返回记账后的即时洞察
-- 示例：这是你本周第19次餐饮消费，要不要看看本周餐饮花了多少钱？
-
-**真实示例：**
-
-```
-✅ 「你的小可爱」已帮您录入「柴米AI记账」
-    · 商品：猪脚 💰 ¥33
-    · 收支类型： 支出
-    · 分类：     餐饮
-    · 时间：2026年4月24日
-✅ 好好吃饭哦~
-
-💡 消费洞察：这是你本周第23次餐饮消费，要不要看看本周餐饮花了多少钱？
--------------
-chaimi-keep-mcp: v3.1.48
-```
+**完整故障排除** → 见 references/troubleshooting.md
 
 ---
 
-## 错误处理
-
-| 错误类型 | 处理方式 |
-|----------|----------|
-| 未安装 | 引导安装：`npm install -g chaimi-keep-mcp` |
-| 未授权 | MCP Server 自动返回授权错误和验证码，Agent 引导用户在小程序中完成授权 |
-| Token 过期 | MCP Server 自动刷新，或返回授权错误需要重新授权 |
-| 参数错误 | 提示用户补充必要信息 |
-
-### 未授权详细处理流程
-
-当调用记账工具时，如果用户未授权，MCP Server 会自动返回授权错误，包含验证码。
-
-**第 1 步：捕获授权错误**
-
-当 MCP Server 返回如下错误时：
-```
-NEED_AUTH:GGCY-AC84
-```
-
-表示需要授权，验证码为 `GGCY-AC84`。
-
-**第 2 步：引导用户完成授权**
-
-Agent 必须向用户显示：
-```
-🔐 请先完成授权
-
-━━━━━━━━━━━━━━
-📱 验证码：GGCY-AC84
-━━━━━━━━━━━━━━
-
-请在"柴米AI记账"小程序中完成授权：
-
-1️⃣ 打开微信小程序"柴米AI记账"
-
-2️⃣ 点击"我的" → "Agent 授权"
-
-3️⃣ 输入验证码：GGCY-AC84
-
-4️⃣ 点击确认授权
-
-授权完成后告诉我，我将继续为您记账。
-```
-
-**第 3 步：用户确认授权后**
+## 相关文档
 
-用户告知授权完成后，Agent **直接重新调用**之前的记账工具，无需其他操作。
-- 如果授权成功，记账会自动完成
-- 如果授权失败，会再次返回错误
+| 文档 | 路径 | 说明 |
+|:-----|:-----|:-----|
+| 详细回复模板 | references/response-templates.md | 情绪词库、完整模板 |
+| API详细说明 | references/api-reference.md | 工具参数、返回值 |
+| 故障排除 | references/troubleshooting.md | 常见问题、解决方案 |
+| 高级功能 | references/advanced-features.md | insights、export深度用法 |
+| 授权详解 | references/authentication.md | 授权流程、Token管理 |
+| 可执行脚本 | scripts/ | auth-flow.sh 等 |
+| 输出模板 | templates/ | 分析报告固定格式 |
 
 ---
 
-*最后更新：2026-04-16*
+**文档版本：v3.2.0**
+**最后更新：2026-04-25**
+**Status：生产就绪**

package/_meta.json

@@ -0,0 +1,59 @@
+{
+  "name": "chaimi-keep-mcp",
+  "description": "柴米AI记账MCP Server，连接微信小程序记账功能，提供超级美学用户体验",
+  "version": "3.2.0",
+  "updated": "2026-04-25",
+  "author": "柴米AI团队",
+  "category": "financial",
+  "tags": ["记账", "财务管理", "小程序", "微信"],
+  "entry": "SKILL.md",
+  "references": {
+    "response-templates": {
+      "path": "references/response-templates.md",
+      "description": "详细回复模板库，包含情绪词库和场景模板",
+      "lines": 424,
+      "trigger": "记账成功后、查询结果展示、错误提示、用户引导"
+    },
+    "api-reference": {
+      "path": "references/api-reference.md",
+      "description": "查询分析类工具API说明（记账工具已保密）",
+      "lines": 206,
+      "trigger": "查询统计、数据分析、导出数据"
+    },
+    "troubleshooting": {
+      "path": "references/troubleshooting.md",
+      "description": "故障排除指南，包含常见问题及解决方案",
+      "lines": 269,
+      "trigger": "授权失败、记账失败、查询异常"
+    },
+    "authentication": {
+      "path": "references/authentication.md",
+      "description": "授权流程详解，包含Token管理和安全实践",
+      "lines": 142,
+      "trigger": "首次授权、Token过期、安全设置"
+    },
+    "advanced-features": {
+      "path": "references/advanced-features.md",
+      "description": "高级功能详解，包含深度分析和智能洞察",
+      "lines": 146,
+      "trigger": "深度分析、数据导出、高级查询"
+    }
+  },
+  "stats": {
+    "total_lines": 1489,
+    "main_skill_lines": 273,
+    "references_lines": 1216,
+    "reference_count": 5
+  },
+  "dependencies": [],
+  "status": "production",
+  "features": [
+    "支出记账",
+    "收入记账",
+    "小票识别记账",
+    "消费记录查询",
+    "统计分析",
+    "智能洞察",
+    "数据导出"
+  ]
+}

package/bin/global-install.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+/**
+ * 全局安装脚本 - 同步 Skill 到所有支持的 Agent
+ * 
+ * 功能：
+ * 1. 同步到 Skill 架构 Agent（OpenClaw、WorkBuddy）
+ * 2. 同步到 MCP 直连 Agent（Claude、Cursor、Windsurf）的辅助目录
+ * 3. 提供统一的管理入口
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// 全局 Skill 安装目录
+const GLOBAL_SKILL_DIR = path.join(os.homedir(), '.chaimi-mcp', 'skills', 'chaimi-keep-mcp');
+
+// 所有支持的 Agent 路径
+const ALL_AGENTS = [
+  // Skill 架构 Agent
+  {
+    name: 'OpenClaw',
+    skillPath: path.join(os.homedir(), '.openclaw', 'skills', 'chaimi-keep-mcp'),
+    type: 'skill',
+    platform: ['darwin', 'linux']
+  },
+  {
+    name: 'WorkBuddy',
+    skillPath: path.join(os.homedir(), '.workbuddy', 'skills', 'chaimi-keep-mcp'),
+    type: 'skill',
+    platform: ['darwin', 'linux', 'win32']
+  },
+  {
+    name: 'MCPorter',
+    skillPath: path.join(os.homedir(), '.mcporter', 'skills', 'chaimi-keep-mcp'),
+    type: 'skill',
+    platform: ['darwin', 'linux', 'win32']
+  },
+  // MCP 直连 Agent - 辅助文档
+  {
+    name: 'Claude Desktop',
+    skillPath: path.join(os.homedir(), '.chaimi-mcp', 'agent-docs', 'claude'),
+    type: 'mcp',
+    platform: ['darwin', 'linux', 'win32']
+  },
+  {
+    name: 'Cursor',
+    skillPath: path.join(os.homedir(), '.chaimi-mcp', 'agent-docs', 'cursor'),
+    type: 'mcp',
+    platform: ['darwin', 'linux', 'win32']
+  },
+  {
+    name: 'Windsurf',
+    skillPath: path.join(os.homedir(), '.chaimi-mcp', 'agent-docs', 'windsurf'),
+    type: 'mcp',
+    platform: ['darwin', 'linux', 'win32