@comate/zulu 1.3.3 → 1.3.4-beta.2

package/comate-engine/assets/skills/code-security-comate/scripts/repair_vulnerability.py

@@ -82,8 +82,8 @@ def diff_file_content(file_path, new_content):
     return json.dumps(diffs, ensure_ascii=False, indent=2)
 
 
-def upload_files_for_repair(root_path, missing_files, username, user_id):
-    # type: (str, list, str, str) -> None
+def upload_files_for_repair(root_path, missing_files, username, user_id, chat_id=""):
+    # type: (str, list, str, str, str) -> None
     """上传修复过程中缺失的文件。"""
     payload = {"files": {}}
     for name in missing_files:
@@ -97,13 +97,13 @@ def upload_files_for_repair(root_path, missing_files, username, user_id):
 
     http_client.put(
         "{}/api/v1/upload".format(utils.HOST),
-        headers=utils.build_headers(username, user_id),
+        headers=utils.build_headers(username, user_id, chat_id),
         json_body=payload,
     )
 
 
-def repair_vulnerability(root_path, vulnerability_info, username, user_id):
-    # type: (str, dict, str, str) -> dict
+def repair_vulnerability(root_path, vulnerability_info, username, user_id, chat_id=""):
+    # type: (str, dict, str, str, str) -> dict
     """执行漏洞修复，返回包含 diff 的修复结果。"""
     # 计算待修复文件的哈希
     for file_info in vulnerability_info.get("files", []):
@@ -122,7 +122,7 @@ def repair_vulnerability(root_path, vulnerability_info, username, user_id):
     while poll_count < MAX_REPAIR_POLLS:
         result = http_client.post(
             api_url,
-            headers=utils.build_headers(username, user_id),
+            headers=utils.build_headers(username, user_id, chat_id),
             json_body=vulnerability_info,
         )
 
@@ -133,9 +133,9 @@ def repair_vulnerability(root_path, vulnerability_info, username, user_id):
             if upload_retry_count > MAX_UPLOAD_RETRIES:
                 print("错误: 修复上传重试 {} 次后仍有缺失文件".format(MAX_UPLOAD_RETRIES), file=sys.stderr)
                 return {"status": -1, "message": "修复上传重试次数超限"}
-            print("上传缺失文件: {} 个 (重试 {}/{})".format(len(missing), 
+            print("上传缺失文件: {} 个 (重试 {}/{})".format(len(missing),
                                                    upload_retry_count, MAX_UPLOAD_RETRIES), file=sys.stderr)
-            upload_files_for_repair(root_path, missing, username, user_id)
+            upload_files_for_repair(root_path, missing, username, user_id, chat_id)
             time.sleep(REPAIR_POLL_INTERVAL)
             continue
 
@@ -194,6 +194,7 @@ def main():
     parser = argparse.ArgumentParser(description="代码安全漏洞修复工具")
     parser.add_argument("--root-path", required=True, help="项目根目录")
     parser.add_argument("--username", required=True, help="Comate 用户名")
+    parser.add_argument("--chat-id", default="", help="对话唯一标识 (COMATE_SESSION_ID)，用于关联扫描/修复映射")
     parser.add_argument("--vulnerability-info", default=None, help="漏洞信息 JSON 字符串")
     parser.add_argument("--parsed-result", default=None,
                         help="解析结果文件路径 (parsed_result.json)，与 --vulnerability-info 二选一")
@@ -206,7 +207,8 @@ def main():
 
     user_id = utils.make_user_id(args.username)
 
-    logger.info("repair_vulnerability start: username=%s, root_path=%s", args.username, args.root_path)
+    logger.info("repair_vulnerability start: username=%s, chat_id=%s, root_path=%s", args.username,
+                args.chat_id, args.root_path)
 
     root_path = os.path.realpath(args.root_path)
     if not os.path.isdir(root_path):
@@ -233,7 +235,7 @@ def main():
             print("错误: 漏洞信息 JSON 解析失败: {}".format(e), file=sys.stderr)
             sys.exit(1)
 
-    result = repair_vulnerability(root_path, vulnerability_info, args.username, user_id)
+    result = repair_vulnerability(root_path, vulnerability_info, args.username, user_id, args.chat_id)
 
     output_file = os.path.join(output_dir, "repair_result.json")
     with open(output_file, "w", encoding="utf-8") as f:

package/comate-engine/assets/skills/code-security-comate/scripts/report_chat.py

@@ -85,7 +85,7 @@ def report_chat(chat_id, scan_result, git_url, git_branch, ide, query, root_path
             "url": git_url,
             "branch": git_branch,
         },
-        "ide": ide,
+        "ide": ide + " skill",
         "query": query,
         "status": 0,
         "errMessage": "",

package/comate-engine/assets/skills/comate-docs-comate/SKILL.md

@@ -13,128 +13,96 @@ metadata:
 ## 前置依赖
 
 - **Skill 依赖 `get-ugate-token`**：认证通过 get-ugate-token skill 自动获取个人身份 token
-- **Python 依赖**：`requests` 库
+- **Skill 依赖 `ku-operator`**：通过 ku-operator 的 query-content 能力获取文档内容
 - **当前用户名**: ${COMATE_USERNAME}，即`COMATE_USERNAME=${COMATE_USERNAME}`
 
-
-## 认证说明
-
-本 skill 依赖 `get-ugate-token` skill 进行个人身份认证。调用时自动获取 ugate token：
-
-- 若本地已有有效的 token 缓存文件，直接使用，无需用户介入
-- 若 token 不存在或已过期，`get-ugate-token` 会向用户询问授权token
-- 用户完成授权后，重新发起操作即可
-
 ## 质量原则
 
 - 必须以知识库实时内容为准。
-- 回答时引用具体页面 URL。
-
-## 知识库 URL 与 ID 解析（重要）
-
-```
-https://ku.baidu-int.com/knowledge/{spaceGuid}/{groupGuid}/{repoGuid}/{docGuid}
-```
-
-| URL 段       | 含义         | 说明                        |
-|-------------|------------|---------------------------|
-| `spaceGuid` | 空间 ID      | 一般不需要使用                   |
-| `groupGuid` | 分组 ID      | 一般不需要使用                   |
-| `repoGuid`  | **知识库 ID** | 用于 `--repo-guid` 参数       |
-| `docGuid`   | **文档 ID**  | 用于 `--doc-id` 参数，URL 最后一段 |
-
-**路径段数判断链接类型：**
-
-- **4 段**（含 docGuid）→ 文档链接，可直接 `query-content` 读取
-- **3 段**（仅到 repoGuid）→ 知识库链接，需先 `query-repo` 查询目录
-
-## 重要概念：文档即目录
-
-知识库中**文档和目录是同一个概念**——任何文档都可以拥有子文档。读取文档后应通过 `query-repo --parent-doc-guid <该文档ID>`
-检查是否有子文档，按需加载以提供完整结果。
-
-## CLI 子命令一览
-
-统一入口：`python3 scripts/ku_operator.py <子命令> [参数]`
-
-| 子命令                 | 功能                  | 必填参数                                  | 常用可选参数                                                    |
-|---------------------|---------------------|---------------------------------------|-----------------------------------------------------------|
-| `query-content`     | 查询文档内容（Markdown 输出） | `--doc-id` 或 `--url`（二选一）             | `--save-assets-dir`, `--no-download-assets`, `--raw-json` |
-| `query-repo`        | 查询知识库目录（文本树形输出）     | `--repo-guid`                         | `--parent-doc-guid`, `--page`                             |
-
-**关键用法说明：**
-
-- `query-content` 默认自动下载远程图片/附件到 `./ku_assets/{doc_id}/`，并替换 Markdown 中的 URL。读取文档后注意 stderr
-  资源下载摘要，按需用 Read 工具查看已下载的图片。
-
-## API 详细文档
-
-各子命令的详细参数、输出格式、使用示例见 `references/` 目录：
-
-| 文档                                | 内容          |
-|-----------------------------------|-------------|
-| `references/query_content.md`     | 文档内容查询详细说明  |
-| `references/query_repo.md`        | 知识库目录查询详细说明 |
-
-## 错误处理
-
-**可自行修复（重试）：** 参数缺失、ID 格式错误（repoGuid/docGuid 搞反）、页码超出范围
-
-**需告知用户（不重试）：**
-
-- 认证失败（401/403）→ 提示用户重新发起操作以触发 ugate-auth 授权
-- 文档不存在（404）→ 告知用户检查文档是否已被删除
-- 无操作权限 → 告知用户联系知识库管理员
-- 服务端错误（5xx）→ 告知用户稍后再试
+- 回答时引用具体页面 URL，用户通过 URL 连接可以直接进入页面
 
 ## Comate Product Snapshot
 
-1. **Agent 模式（One Agent, Three Modes）**：Ask（问答/解释）、Plan（复杂任务规划，含澄清表单和 Human-in-the-loop
-   审核）、Build（直接生成实现）
-2. **Context 系统**：Skills（可移植技能包）、Subagents（并行子智能体）、Rules（项目/个人规范）、Commands（`/` 指令）、MCP（Model
-   Context Protocol）、`@` 关联上下文
-3. **并行执行**：工具级 + Subagent 级并行；异步执行（Worktree、云端沙盒）
-4. **Skills 市场**：内置 `/find-skills` 指令，从远端 Skills 中心搜索并安装 skill；内置 `/create-skill` 一键创建项目级或个人级
-   skill
+1. **Agent 模式（One Agent, Three Modes）**：Agent（直接生成实现，默认模式）、Ask（只读问答/解释）、Plan（复杂任务先规划再执行，含澄清和 Human-in-the-loop 审核）；Shift+Tab 快速切换
+2. **Context 系统**：Skills（可移植技能包）、Subagents（并行子智能体，内置 Explore Agent）、Rules（项目/个人规范）、Commands（`/` 指令，内置 `/code-review`、`/debug`、`/unit-test`）、MCP（Model Context Protocol，渐进式加载）、`@` 关联上下文（File/Folder/Terminal/Doc/Rules）
+3. **并行执行**：工具级 + Subagent 级并行；Explore Agent 作为 SubAgent 多步推理检索代码库
+4. **Skills 市场**：内置 `/find-skills` 指令，从远端 Skills 中心搜索并安装 skill；内置 `/create-skill` 一键创建项目级或个人级 skill
 5. **Zulu CLI**：命令行工具，可在终端、iPipe CI/CD 流水线中运行 Comate Agent
 6. **Jinx Code**：Web 端 Vibe Coding 产品，云端沙盒执行，网址 `https://web-agent-next.baidu-int.com/`
-7. **MCP 渐进式加载**：以 MCP Server 为粒度按需加载工具定义，大幅节省上下文 Tokens
+7. **MCP 渐进式加载**：以 MCP Server 为粒度按需加载工具定义，大幅节省上下文 Tokens；支持 MCP 市场 UI 一键添加
 8. **兼容性**：兼容 Claude Code、Codex、Cursor 等 20+ Agent 工具的 Skills 目录格式
+9. **自动化**：Hooks 可插拔扩展能力
+10. **模型管理**：支持在设置页面启用/禁用模型，过滤出你需要的模型列表
+11. **新增功能**：Checkpoints（Agent 变更自动快照，随时回滚）、并行 Tab（多标签页并行任务）、代码审查界面（diff 格式逐块接受/撤销）
+12. **Copet**：MacOS 桌面宠物应用，任务执行时可视化状态
+13. **Mission Mode**：以任务为中心的研发模式（仅 Comate AI IDE）；支持多任务并行（独立上下文）、多代码库联动（一个 Workspace 绑定多个仓库）、工作流全程串联（自动绑卡/提交/发起 CR）
+
+## Content retrieve
+
+示例命令，只需替换对应文档的 url 即可
+`
+cd ${COMATE_SKILL_DIR}/../ku-operator-comate && COMATE_USERNAME=${COMATE_USERNAME} python3 scripts/ku_operator.py query-content --url "https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/WBcj3KdE3ATpQR"
+`
+
 
 ## Workflow
 
 1. 明确用户问题属于哪个类别：功能使用、模型选择/计费、Skills/Context、CLI、故障排除、最新动态。
 2. 按需加载 `references/` 中对应的参考文件（见下方 Reference Map）。
-3. 用 playwright-cli 抓取对应文档页面（见下方 Doc Map）。
 4. 综合文档内容和参考文件回答，并给出知识库页面链接作为引用。
-5. 对于 Skills 安装问题，优先引导用户使用 `/find-skills` 指令，其次提供手动目录路径。
 
 ## Doc Map
 
-所有页面均在同一知识空间，基础路径：`https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/`
-
-| 章节                  | URL 页面 ID（`jyGhbHUQQG/` 后缀） | 说明                                           |
-|---------------------|-----------------------------|----------------------------------------------|
-| 知识库首页/目录            | `WBcj3KdE3ATpQR`            | 36 篇子页面的总目录                                  |
-| 开始使用                | `CAu-Eo5qijd3xY`            | 开始使用章节入口                                     |
-| Agent               | `rEVzf39R6KVKXM`            | Agent 章节入口（模式说明）                             |
-| Mission Mode               | 独立连接`https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/mcV1ZM02Cz/laPtUbdW5yJsbo`                      | Mission Mode 用户手册                             |
-| Context             | `Pn9zCxdoUeQ-SC`            | Context 章节入口                                 |
-| Skills（Context 子页）  | `BAD2sU4Yqs1kCP`            | Skills 完整说明：格式、目录、/create-skill、/find-skills |
-| 账户                  | `XOEDtioqXFa5zg`            | 账户章节入口                                       |
-| 使用账单（账户子页）          | `cMPrc68gwEX1Hs`            | 多模型列表、按 Token 计价、资源账户绑定                      |
-| 数据度量（账户子页）          | `iSLaMIFKeD7Pmy`            | 个人/团队 Coding Agent 使用数据视图                    |
-| 故障排除                | `sEQ16HgwkyDc_H`            | 故障排除章节                                       |
-| Changelog           | `6Ft3QPJ87cXqek`            | 版本更新历史                                       |
-| 周边生态                | `XLL_Zhb2ruCp4l`            | 周边生态章节入口                                     |
-| Zulu CLI（周边生态子页）    | `amicnOzxkkzxiQ`            | CLI 安装、参数、iPipe 用法、Docker 镜像                 |
-| Jinx Code（周边生态子页）   | `jor-aKcmbLwRKv`            | Web 端云沙盒 Vibe Coding 产品介绍                    |
-| 团队动态                | `9y6h0rTC3Bdg8V`            | 团队动态章节入口                                     |
-| 【动态】Comate 4.0 升级情况 | `Hb6OQz5Jc7/mhBWPhoBv258Ve` | 4.0 架构详解、SWE-Bench 评分、使用数据分析                 |
-| 【实践】打通如流知识库         | `Nrj3-AWvt1DPt-`            | 使用 ku-doc-manage Skill 直接读写知识库文档             |
-| 【实践】内网资源大集合         | `Np0ZvForjkgRBz`            | baidu-intranet-access Skill 安装和使用指南          |
-| 【实践】拆卡提码一条龙         | `hbAL01OPSL9LMU`            | create-cr Skill：从 PRD 建 iCafe 卡片到提交代码        |
-| 【研究】MCP 渐进式加载       | `EpzgIaNtaVAHf-`            | MCP 上下文优化原理，对比 Claude Code、Cursor 方案         |
+所有页面均在同一知识空间，基础路径：`https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG`
+
+| 章节                        | URL 页面 ID | 说明                        |
+|---------------------------|------------------|---------------------------|
+| 知识库首页/目录                  | `WBcj3KdE3ATpQR` | 11 个顶级章节的总目录              |
+| 开始使用                      | `CAu-Eo5qijd3xY` | 开始使用章节入口                  |
+| 开始使用 > 快速开始               | `KhrgIWkjEkRdA3` | 安装、模型列表（含 Tokens 倍数）、快速上手 |
+| 开始使用 > 概念                 | `SjueaOAs7omDOW` | Tab/Agent/Mode/Skills/Rules/Subagents/@ / 概念词汇 |
+| 开始使用 > 功能使用手册             | `byA0I1Gd9YAt_t` | 功能使用详细说明                  |
+| 开始使用 > 模型                 | `SRSExwbEp2FHVf` | 所有模型属性详情页                 |
+| Mission Mode                | `TboTJTD5shkc7p` | 以任务为中心的研发模式（仅 Comate AI IDE）；多任务并行/多代码库联动/工作流全程串联 |
+| Mission Mode 使用手册           | 独立路径 `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/mcV1ZM02Cz/laPtUbdW5yJsbo` | 完整操作手册：5步快速上手、Workspace 配置、三大核心能力详解 |
+| Agent                     | `rEVzf39R6KVKXM` | Agent 章节入口                |
+| Agent > 概述                | `eOPhb1KxQEXmfl` | Agent 工作原理、工具列表、消息压缩、Checkpoints、并行 Tab |
+| Agent > 模式（Mode）          | `NYGrqnNt_A8Y0g` | Agent/Ask/Plan 三种模式详解及切换方式 |
+| Agent > 审查（Review）        | `x2I2B2sbqLPtSl` | diff 审查界面、逐块接受/撤销、/code-review 命令 |
+| Agent > 安全性               | `90BNp3Z4eV4XuI` | 安全性说明                     |
+| Model                     | `14-z1y4EdPxllF` | Model 章节入口（模型选择）          |
+| Model > 查询可用模型列表          | `ZS3uu0XgQjLm31` | 输入代码库地址查询可用模型             |
+| Model > 看不到外部模型怎么办        | `IhV9oBqa4VrEcR` | 6步排查：账号/资源账户/代码库密级/Workspace类型/版本/Reload |
+| Context                   | `Pn9zCxdoUeQ-SC` | Context 章节入口              |
+| Context > Skills          | `BAD2sU4Yqs1kCP` | Skills 完整说明：格式、目录、/create-skill、/find-skills |
+| Context > Subagents       | `4HSaAXnNTSW1fX` | Subagents 说明：内置 Explore Agent、自定义 Subagent 格式 |
+| Context > @关联上下文          | `9ZnJeejauIRvTk` | @ 快捷键：File/Folder/Terminal/Doc/Rules |
+| Context > Semantic Search | `4QvLhmceIx4I9O` | 语义检索说明                    |
+| Context > Commands        | `nLF-end9lwqeej` | / 命令说明：内置 /code-review、/debug、/unit-test |
+| Context > MCP             | `t0diKSjnMyiFEG` | MCP 配置（个人/项目级）、MCP 市场 UI、手动配置 |
+| Context > Rules           | `KmCRxSZy1wGkeh` | Rules 格式与配置说明             |
+| 自动化                       | `TFK964x5GaGnOd`    | 自动化 章节入口                  |
+| 自动化 > Hooks               | `SsPwYQyvQxdGeb`    | Hooks                     |
+| 账户                        | `XOEDtioqXFa5zg` | 账户章节入口                    |
+| 使用账单（账户子页）                | `cMPrc68gwEX1Hs` | 多模型列表、按 Token 计价、资源账户绑定   |
+| 数据度量（账户子页）                | `iSLaMIFKeD7Pmy` | 个人/团队 Coding Agent 使用数据视图 |
+| 故障排除                      | `sEQ16HgwkyDc_H` | 故障排除章节                    |
+| 故障排除 > Comate常见问题         | `4goStF_n2tJpsB` | 常见问题                      |
+| Changelog                 | `6Ft3QPJ87cXqek` | 版本更新历史                    |
+| 周边生态                      | `XLL_Zhb2ruCp4l` | 周边生态章节入口                  |
+| Zulu CLI（周边生态子页）          | `amicnOzxkkzxiQ` | CLI 安装、参数、iPipe 用法、Docker 镜像 |
+| Jinx Code（周边生态子页）         | `jor-aKcmbLwRKv` | Web 端云沙盒 Vibe Coding 产品介绍 |
+| Copet（周边生态子页）             | `z7z8_oXn5YP8rt` | MacOS 桌面宠物应用，任务执行状态可视化    |
+| 团队动态                      | `9y6h0rTC3Bdg8V` | 团队动态章节入口                  |
+| 【动态】Comate 4.0 升级情况       | `Hb6OQz5Jc7/mhBWPhoBv258Ve` | 4.0 架构详解、SWE-Bench 评分、使用数据分析 |
+| 【动态】Comate上下文重磅升级         | `9k-K32PXRHIycf` | Explorer Agent 升级、CodebaseSearch 全链路升级 |
+| 【动态】模型管理功能上线              | `Wxf9N2-pqP8GKf` | 新增模型管理页面，支持启用/禁用模型        |
+| 【动态】Comate正在和将来的Feature   | `VFcMaO6en_p8jJ` | Comate 近期和规划中的功能动态        |
+| 【实践】打通如流知识库               | `Nrj3-AWvt1DPt-` | 使用 ku-doc-manage Skill 直接读写知识库文档 |
+| 【实践】内网资源大集合               | `Np0ZvForjkgRBz` | baidu-intranet-access Skill 安装和使用指南 |
+| 【实践】拆卡提码一条龙               | `hbAL01OPSL9LMU` | create-cr Skill：从 PRD 建 iCafe 卡片到提交代码 |
+| 【实践】让Comate做代码「尸检」        | `Z0TRY_G1wG2s2v` | 代码 post-mortem 实践         |
+| 【研究】MCP 渐进式加载             | `EpzgIaNtaVAHf-` | MCP 上下文优化原理，对比 Claude Code、Cursor 方案 |
 
 ## Reference Map
 
@@ -143,6 +111,3 @@ https://ku.baidu-int.com/knowledge/{spaceGuid}/{groupGuid}/{repoGuid}/{docGuid}
 - `references/product-overview.md` → 产品架构、模式说明、Context 系统、并行执行机制
 - `references/models-and-billing.md` → 支持的模型列表、按密级的模型权限、计费规则
 - `references/doc-map-extended.md` → 完整 URL 索引（含所有已知子页面）
-
-
-

package/comate-engine/assets/skills/comate-docs-comate/references/doc-map-extended.md

@@ -15,20 +15,55 @@
 | 页面标题 | 完整 URL |
 |----------|----------|
 | 开始使用（章节入口） | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/CAu-Eo5qijd3xY` |
+| 快速开始 | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/KhrgIWkjEkRdA3` |
+| 概念（Tab/Agent/Mode/Skills/Rules/Subagents/@/模型） | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/SjueaOAs7omDOW` |
+| 功能使用手册 | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/byA0I1Gd9YAt_t` |
+| 模型（所有模型属性详情） | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/SRSExwbEp2FHVf` |
+
+### Mission Mode
+
+| 页面标题 | 完整 URL |
+|----------|----------|
+| Mission Mode（章节入口） | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/TboTJTD5shkc7p` |
+| Mission Mode 使用手册（多任务并行/多代码库/工作流串联） | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/mcV1ZM02Cz/laPtUbdW5yJsbo` |
 
 ### Agent
 
 | 页面标题 | 完整 URL |
 |----------|----------|
 | Agent（章节入口） | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/rEVzf39R6KVKXM` |
+| Agent > 概述（工具列表/Checkpoints/并行Tab） | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/eOPhb1KxQEXmfl` |
+| Agent > 模式（Agent/Ask/Plan 详解） | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/NYGrqnNt_A8Y0g` |
+| Agent > 审查（Review，diff 界面） | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/x2I2B2sbqLPtSl` |
+| Agent > 安全性 | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/90BNp3Z4eV4XuI` |
+
+### Model
+
+| 页面标题 | 完整 URL |
+|----------|----------|
+| Model（章节入口） | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/14-z1y4EdPxllF` |
+| 查询可用模型列表 | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/ZS3uu0XgQjLm31` |
+| 看不到外部模型怎么办（6步排查） | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/IhV9oBqa4VrEcR` |
 
 ### Context
 
 | 页面标题 | 完整 URL |
 |----------|----------|
 | Context（章节入口） | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/Pn9zCxdoUeQ-SC` |
-| Skills | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/BAD2sU4Yqs1kCP` |
-| @关联上下文 | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/XLL_Zhb2ruCp4l` |
+| Skills（格式/目录/create-skill/find-skills） | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/BAD2sU4Yqs1kCP` |
+| Subagents（内置 Explore Agent / 自定义） | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/4HSaAXnNTSW1fX` |
+| @关联上下文（File/Folder/Terminal/Doc/Rules） | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/9ZnJeejauIRvTk` |
+| Semantic Search | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/4QvLhmceIx4I9O` |
+| Commands（/code-review、/debug、/unit-test） | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/nLF-end9lwqeej` |
+| MCP（MCP 市场 UI / 手动配置） | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/t0diKSjnMyiFEG` |
+| Rules | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/KmCRxSZy1wGkeh` |
+
+### 自动化
+
+| 页面标题 | 完整 URL |
+|-------|----------|
+| 自动化（章节入口，Hooks） | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/TFK964x5GaGnOd` |
+| Hooks | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/SsPwYQyvQxdGeb` |
 
 ### 账户
 
@@ -41,14 +76,16 @@
 ### 故障排除
 
 | 页面标题 | 完整 URL |
-|----------|----------|
+|------|----------|
 | 故障排除（章节入口） | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/sEQ16HgwkyDc_H` |
+| Comate常见问题| `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/4goStF_n2tJpsB` |
 
 ### Changelog
 
 | 页面标题 | 完整 URL |
 |----------|----------|
 | Changelog（章节入口） | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/6Ft3QPJ87cXqek` |
+| 2026年2月25日（核心能力升级/体验优化/稳定性） | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/JU0OwJbjCtRR9i` |
 
 ### 周边生态
 
@@ -57,17 +94,25 @@
 | 周边生态（章节入口） | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/XLL_Zhb2ruCp4l` |
 | Zulu CLI（命令行工具） | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/amicnOzxkkzxiQ` |
 | Jinx Code（Web 端 Vibe Coding） | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/jor-aKcmbLwRKv` |
+| Copet（MacOS 桌面宠物应用） | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/z7z8_oXn5YP8rt` |
 
 ### 团队动态
 
 | 页面标题 | 完整 URL |
 |----------|----------|
 | 团队动态（章节入口） | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/9y6h0rTC3Bdg8V` |
-| 【研究】MCP 渐进式加载节省 Tokens | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/EpzgIaNtaVAHf-` |
-| 【实践】使用 Comate 打通如流知识库 | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/Nrj3-AWvt1DPt-` |
-| 【实践】「我们搞了一个Skill」之 拆卡提码一条龙 | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/hbAL01OPSL9LMU` |
-| 【实践】「我们搞了一个Skill」之 内网资源大集合 | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/Np0ZvForjkgRBz` |
+| 【动态】Comate正在和将来的Feature | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/VFcMaO6en_p8jJ` |
+| 【动态】你的工位正在被 4 位"赛博同事"占领 | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/9FLOfwN8Fc8xWu` |
+| 【动态】人在食堂，吃饭前让Comate做一个测SBTI的Skill | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/tLeDLjuv0PinvE` |
+| 【动态】模型管理功能上线（模型太多？不想思考？） | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/Wxf9N2-pqP8GKf` |
+| 【动态】Comate上下文重磅升级 -- 从检索到推理 | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/9k-K32PXRHIycf` |
 | 【动态】Comate 4.0 升级情况及效果 | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/Hb6OQz5Jc7/mhBWPhoBv258Ve` |
+| 【实践】使用Comate打通如流知识库，告别复制粘贴 | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/Nrj3-AWvt1DPt-` |
+| 【实践】「我们搞了一个Skill」之 内网资源大集合 | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/Np0ZvForjkgRBz` |
+| 【实践】「我们搞了一个Skill」之 拆卡提码一条龙 | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/hbAL01OPSL9LMU` |
+| 【实践】让Comate每次给代码做「尸检」 | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/Z0TRY_G1wG2s2v` |
+| 【实践】什么？Comate也敢debate我？ | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/MUaw7BQHaQzm9X` |
+| 【研究】使用渐进式的方式加载MCP以节省上下文Tokens | `https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/EpzgIaNtaVAHf-` |
 
 ## 外部工具链接
 

package/comate-engine/assets/skills/comate-docs-comate/references/models-and-billing.md

@@ -1,37 +1,56 @@
 # Comate 模型列表与计费
 
-> 辅助参考文件。模型上线情况随产品迭代变化，以知识库「使用账单」页面的实时内容为准。
+> 辅助参考文件。模型上线情况随产品迭代变化，以知识库「使用账单」页面和「开始使用 > 模型」页面的实时内容为准。
 
-## 模型选择方式
+## 模型选择与管理
 
+- **Models 管理页面**：可启用/禁用不需要的模型，过滤出你常用的列表；修改后需 Reload 或 Restart IDE 生效
 - **Auto 模式**：根据用户 Query 自动选择最合适的模型（推荐日常使用）
-- **Max 模式**：更大上下文窗口，适合复杂/长程任务，但消耗 Tokens 较多
-- 切换路径：打开 Agent → 模型下拉选择 / 开启 Max 模式
+- **切换路径**：打开 Agent → 模型下拉选择
+- 看不到某些模型？参考「Model > 看不到外部模型怎么办」：登录账号、关联资源账户、检查代码库密级、Workspace 类型、版本更新、Reload IDE
 
 ## 按代码库密级的模型权限
 
-| 密级 | 是否允许海外模型 | 可用模型（示例） |
-|------|-----------------|-----------------|
-| 保密 L1 / 个人库 / GitHub 代码库 | ❌ | GLM-4.7、MiniMax M2.5、Kimi K2.5 |
-| 保密 L0 | ✅ | MiniMax、DeepSeek-V3.1、GLM-4.7、Claude 4.5 Sonnet、Claude Opus 4.5、Gemini 3 Pro Preview |
-| 开源、三方、基础库 | ✅ | 同上 + 更多 |
-
-## 当前模型价格（人民币/百万 Tokens，仅供参考）
-
-| 模型 | 输入 | 输出 | 缓存命中 |
-|------|------|------|----------|
-| DeepSeek V3.1（千帆） | 8元 | 32元 | 3.2元 |
-| GLM 4.6/4.7 | 3元 | 12元 | 0.6元 |
-| GLM 5 | 6元 | 22元 | 1.5元 |
-| MiniMax 2.1/2.5 | 2.1元 | 8.4元 | 2.625元 |
-| Kimi K2 | 4元 | 16元 | 0.8元 |
-| Kimi K2.5 | 4.4元 | 23.1元 | 0.77元 |
-| Claude Haiku 4.5 | 7.7元（1.1$） | 38.5元（5.5$） | 9.625元 |
-| Claude 4.5/4.6 Sonnet | 23.1元（3.3$） | 115.5元（16.5$） | 28.875元 |
-| Claude 4.5/4.6 Opus | 38.5元（5.5$） | 192.5元（27.5$） | 48.125元 |
-| Gemini 3 Pro Preview | 14元（2$） | 84元（12$） | 1.4元 |
-
-> 账单显示逻辑：1 Request = 0.3元（折算）
+| 密级 | 是否允许海外模型 | 说明 |
+|------|-----------------|------|
+| 保密 L1 / 个人库 / GitHub 代码库 | ❌ | 仅可使用国内模型 |
+| 保密 L0 / 开源库 / 三方库 / 基础库 | ✅ | 国内 + 海外模型均可用 |
+| 纯目录（无 .git 或非保密） | ✅ | 国内 + 海外模型均可用 |
+
+> 未绑定资源账户的用户无法使用海外模型。绑定入口：`https://oneapi-comate.baidu-int.com/mine`
+
+## 当前可用模型列表
+
+> 以知识库「开始使用 > 快速开始」和「开始使用 > 模型」页面为准，下表为最新快照。
+
+### 海外模型（需 L0/开源/纯目录 + 已绑资源账户）
+
+| 模型 | 默认上下文 | 简介 | Tokens 倍数 | 功能 |
+|------|-----------|------|------------|------|
+| Claude Opus 4.6 | 200k | 最强大的模型，适合解决高难编码任务 | 1.6x | Thinking、Image |
+| Claude Opus 4.5 | 200k | 面向深度编码与复杂问题求解的高性能模型 | 1.6x | Thinking、Image |
+| Claude Sonnet 4.6 | 200k | Claude 系列最新模型，编码任务性能卓越 | 1x | Thinking、Image |
+| Claude Sonnet 4.5 | 200k | 在性能与成本之间保持较好平衡，适合复杂任务处理 | 1x | Thinking、Image |
+| Claude Haiku 4.5 | 200k | 面向简单任务的高效模型，响应速度快 | 0.3x | Thinking、Image |
+| Gemini 3.1 Pro | 200k | Google 最新旗舰模型，非常适合日常使用 | 0.45x | Thinking、Image |
+| Gemini 3.0 Pro | 200k | 高级通用模型，适合复杂问题和 Web 页面开发 | 0.45x | Thinking、Image |
+| Gemini 3.0 Flash | 200k | 低延迟与高效率，适合高并发或实时场景 | 0.3x | Thinking、Image |
+| GPT-5.2 Codex | 200k | 适合复杂、长时间运行的编码任务 | 1x | Thinking、Image |
+| GPT-5.3 Codex | 272k | OpenAI 最新的编程模型，适合高难度编程任务 | — | Thinking、Image |
+| GPT-5.4 | 272k | OpenAI 最新旗舰模型，适合复杂任务 | — | Thinking、Image |
+
+### 国内模型（所有密级可用）
+
+| 模型 | 默认上下文 | 简介 | Tokens 倍数 | 功能 |
+|------|-----------|------|------------|------|
+| MiniMax M2.5 | 200k | 兼具编码能力、数据处理和复杂问题分解，速度极快 | 0.2x | Thinking |
+| MiniMax M2.7 | 200k | 强化复杂工程系统深层理解和编码，善于调度多 Agent 协作 | — | Thinking |
+| Kimi K2.5 | 200k | 原生多模态模型，长文本理解与多类型输入表现突出 | 0.2x | Thinking、Image |
+| GLM-4.7 | 200k | 适用于复杂推理、代码理解等场景，能力均衡 | 0.2x | Thinking |
+| GLM-5 | 200k | 适合复杂、长时间运行的编码任务 | 0.3x | Thinking |
+| GLM-5-Turbo | 200k | 对复杂、长链路指令理解更强，提升大量 Skills 下精准识别准确度 | — | Thinking |
+
+> 以上 Tokens 倍数为相对费用参考，以知识库实时价格为准。
 
 ## 使用额度
 

package/comate-engine/assets/skills/comate-docs-comate/references/product-overview.md

@@ -1,18 +1,28 @@
 # Comate 产品概览
 
-> 辅助参考文件，以知识库实时内容为准。当前快照反映 Comate 4.0（2026年3月全量）情况。
+> 辅助参考文件，以知识库实时内容为准。当前快照反映 Comate 4.x（2026年4月）情况。
 
 ## 产品定位
 
-Comate（内部研发代号 Zulu）是百度内部 AI 编程智能体，基于 VSCode IDE 插件形态，支持厂内部署、SaaS、VPC 等多种环境，面向研发全流程提供 AI 辅助。
+Comate（内部研发代号 Zulu）是百度内部 AI 编程智能体，基于 VSCode IDE 插件形态，支持厂内部署、SaaS、VPC 等多种环境，面向研发全流程提供 AI 辅助。支持 VSCode、JetBrains 系列、Android Studio、Xcode、Visual Studio 多个 IDE，以及专属 Comate AI IDE。
 
 ## 核心架构：One Agent, Three Modes
 
 | 模式 | 英文 | 适用场景 |
 |------|------|----------|
-| 问答模式 | Ask | 代码解释、问题解答、轻量查询 |
-| 计划模式 | Plan | 复杂任务：表单式澄清 → 计划创建/修改 → Human-in-the-loop 审核 → 执行 |
-| 构建模式 | Build | 直接生成实现，适合明确的开发需求 |
+| 智能体模式 | Agent | 复杂任务：自主探索代码库、多文件编辑、运行命令（默认模式） |
+| 只读问答模式 | Ask | 代码解释、问题解答，不做任何文件修改 |
+| 计划模式 | Plan | 先分析代码库、提出澄清性问题、生成可编辑计划，再执行 |
+
+按 `Shift+Tab` 快速切换模式。
+
+## Agent 核心能力
+
+- **工具**：读取文件、搜索文件、编辑文件、运行 Shell 命令、语义搜索、网络检索、调用子代理等
+- **Checkpoints**：Agent 变更自动快照，随时通过 `Restore Checkpoint` 按钮回滚，本地存储、独立于 Git
+- **并行 Tab**：多标签页并行执行不同 Agent 任务，每个 Tab 独立上下文和会话历史
+- **消息压缩**：对话变长时自动生成摘要，也支持手动触发内容总结
+- **代码审查界面**：Agent 生成的变更以 diff 格式展示，支持逐块保留/撤销；内置 `/code-review` 命令让 Agent 提出改进建议
 
 ## Context 系统
 
@@ -28,33 +38,44 @@ Comate（内部研发代号 Zulu）是百度内部 AI 编程智能体，基于 V
 
 ### Subagents
 
-- 并行执行子任务的独立 Agent 实例
-- Comate 接收用户 Query 后会自动发出多个并行子任务，提升执行速度和效果
+- 并行执行子任务的独立 Agent 实例，每个 Subagent 有自己独立的上下文窗口
+- **内置 Explore Agent**：专为代码库探索而生，多步推理、并行工具调度，最终返回带精确文件路径的结构化回答；作为 SubAgent 运行，不污染主 Agent 上下文
+- **自定义 Subagent**：在 `.comate/agents/`（项目级）或 `~/.comate/agents/`（个人级）定义带 YAML 头的 Markdown 文件
 
 ### Rules
 
-- 项目或个人级编码规范文件
+- 项目或个人级编码规范文件，定义 Agent 行为（代码规范、框架偏好、项目约定）
 - 支持通过 `/create-skill` 将已有 Rules 迁移为 Skills
 
 ### Commands
 
-- 使用 `/` 在输入框中调用（如 `/find-skills`、`/create-skill`、`/ku-doc-manage`）
-- 支持显式指定 Skill、Subagent 或 Command
+- 使用 `/` 在输入框中调用
+- **内置命令**：`/code-review`、`/debug`、`/unit-test`（系统级，预计开放自定义）
+- **Skill 调用**：`/find-skills`、`/create-skill` 等
 
 ### MCP（Model Context Protocol）
 
 - 支持自定义安装 MCP Server，连接外部工具
+- **MCP 市场 UI**：在 Comate 页面点击 MCP 选项，通过市场一键添加或手动配置
 - **渐进式加载**：以 MCP Server 为粒度按需加载，避免全量 400+ 工具塞满上下文
-- 加载流程：Server 摘要（轻量）→ 模型判断是否需要 → 实时拉取完整工具定义 → 调用
+- **配置方式**：个人级（`~/.comate/mcp.json`）或项目级（`.comate/mcp.json`）
+- 支持 STDIO、SSE、Streamable HTTP 三种传输类型
 
 ### @ 关联上下文
 
-- 使用 `@` 在输入框中关联文件、代码、文档等上下文
+- 使用 `@` 在输入框中关联 File、Folder、Terminal、Doc、Rules 等上下文
 - 支持 `/` 和 `@` 多选搭配
 
 ### Semantic Search
 
-- 全代码库语义检索，支持精准定位相关代码片段
+- 全代码库语义检索，支持精准定位相关代码片段；秒级索引构建和检索
+- 结合 Explore Agent 实现 Agentic Search（多步推理检索）
+
+## 模型管理
+
+- **Models 管理页面**：可启用/禁用模型，过滤出你需要的模型列表
+- 修改后需 Reload 或 Restart IDE 生效
+- **常见问题**：看不到外部模型 → 参考「Model > 看不到外部模型怎么办」6步排查
 
 ## 并行化策略
 
@@ -62,7 +83,32 @@ Comate（内部研发代号 Zulu）是百度内部 AI 编程智能体，基于 V
 |------|------|
 | 工具级并行 | 同一轮推理中多个工具并发调用 |
 | Subagent 级并行 | 多个子 Agent 并发执行不同子任务 |
-| 异步执行（规划中） | Automations（定时/Webhook 触发）、Worktree、云端沙盒 |
+| 并行 Tab | 多标签页同时运行不同 Agent 对话 |
+
+## 周边生态
+
+- **Zulu CLI**：命令行工具，可在终端、iPipe CI/CD 流水线中运行 Comate Agent
+- **Jinx Code**：Web 端 Vibe Coding，云端沙盒执行，网址 `https://web-agent-next.baidu-int.com/`
+- **Copet**：MacOS 桌面宠物应用（v1.1+），任务执行时动画展示工作状态，多角色可选
+
+## Mission Mode（仅 Comate AI IDE）
+
+以任务为中心的研发模式，理念：让任务成为工程活动的基本单元，AI 围绕任务推进而非围着代码转。
+
+| 特性 | Code Mode（传统） | Mission Mode |
+|------|----------------|--------------|
+| 关注点 | 代码写了什么 | 任务完成到哪了 |
+| AI 角色 | 帮你补几行代码 | 围绕任务自主推进全流程 |
+| 基本单元 | 文件/分支/PR | 任务 |
+
+### 三大核心能力
+
+1. **多任务并行**：同一工作区同时跑多个任务，每个任务独立上下文互不干扰
+2. **多代码库联动**：一个 Workspace 绑定多个代码仓库，AI 自动感知跨库依赖
+3. **工作流全程串联**：任务完成自动生成 commit message 并绑卡提交、发起 iCode CR
+
+**入口页面**：`https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/jyGhbHUQQG/TboTJTD5shkc7p`
+**完整手册**：`https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/_SKPgSwp2G/mcV1ZM02Cz/laPtUbdW5yJsbo`
 
 ## 性能数据（4.0，2026年3月）