@modesto_ma/dsh-guanxiang 0.2.0-beta.1 → 0.2.0-beta.3

package/README.md

@@ -64,7 +64,7 @@
 - **代码快照不可变。** 子 Agent 在 `<reposDir>/.snapshots/<仓库名>/` 下按提交创建的 `git worktree` 快照里工作。快照创建后不再改动，同一提交的派发共用一份；没有分析在用、且已不是最新提交的快照会被删除。
 - **运行目录。** 每次派发在父会话目录下创建 `.guanxiang/runs/<runId>/<序号>-<应用 id>/`，下载的日志放在这里，子 Agent 也只在这里写文件；应用仓库对子 Agent 只读。
 - **等待式派发。** 工具等待所有子 Agent 结束后一次返回，一条消息对应一张完整回复；超过派发超时或调用被取消时停止仍在运行的子 Agent。子会话中不提供派发工具。
-- **SKILL 改进（可选，默认关闭）。** 子 Agent 发现应用的日志分析 SKILL 有欠缺时，可以在运行目录写出修改提议；经用户授权后，观象把它推送到应用仓库的新分支并创建合并请求，见 [SKILL 改进](#skill-改进)。
+- **SKILL 改进（可选，默认关闭）。** 子 Agent 发现应用的日志分析 SKILL 有欠缺时，可以在运行目录写出修改提议；经用户授权后，观象经 [dsh-repo](https://github.com/modestoma/dsh-repo) 把它提交到应用仓库的新分支并创建合并请求（GitLab MR 或 GitHub PR），见 [SKILL 改进](#skill-改进)。
 
 ## 安装与配置
 
@@ -114,16 +114,19 @@ npm 发行包已包含构建产物；本地 `link:` 安装前必须先执行 `pn
       enabled: false                   # 默认关闭
       maxFiles: 16                     # 一次提议最多新增或修改的文件数
       maxFileBytes: 262144             # 提议中单个文件的大小上限
-    skillUpdateAuthor:                 # 可选：SKILL 改进提交的作者；省略时使用本机 git 的 user.name / user.email
+    skillUpdateAuthor:                 # 可选：SKILL 改进提交的作者；省略时是 dsh-repo 中该主机令牌的主人
       name: 观象
       email: guanxiang@example.com
+    analyze:                           # 日志平台分析接口，见下文
+      enabled: false                   # 默认关闭
+    analyzeTokenRef: GUANXIANG_ANALYZE_TOKEN  # 接口访问令牌在 DSH 凭据库中的名称
 ```
 
 配置在加载时校验，不合法时插件加载失败。git 地址支持 https/http/ssh/git/file URL、`user@host:path` 和绝对路径，拉取时使用本机已有的 git 凭据（SSH key 或 credential helper），不会弹出交互式输入。
 
 ### 访问令牌
 
-用 https 地址拉取 GitLab 等私有仓库时，可以配置个人访问令牌（GitLab 需要 `read_repository` 权限；开启 [SKILL 改进](#skill-改进) 时需要 `write_repository`）：
+用 https 地址拉取 GitLab 等私有仓库时，可以配置个人访问令牌（GitLab 需要 `read_repository` 权限；[SKILL 改进](#skill-改进) 的提交改由 dsh-repo 的令牌完成，这里不需要写权限）：
 
 - **配置只写名称。** `gitCredentials` 的每一项把一个地址前缀（`https://主机[:端口][/路径]`）对应到一个令牌名称 `tokenEnv`；地址在前缀下的 https 仓库使用该令牌，多个前缀匹配时取路径最长的。ssh、`user@host:path` 和本地路径不受影响。
 - **令牌值在 DSH 凭据库。** 令牌通过 DSH 的 `ctx.credentials` 读取（默认组合加载的 `@deepseek-ai/dsh-credentials-local`，文件 `$DSH_HOME/.credentials.yaml`，仅本机用户可读），可以在设置面板的「访问令牌」分页保存，也可以设置同名环境变量或写进 `.env`。每次拉取都重新读取，更换令牌不用重启。面板接口只接受已保存的配置引用的名称，也从不返回令牌值。
@@ -145,6 +148,7 @@ DSH Web 左侧栏的「观象」入口打开整页设置面板：
 | 应用仓库 | git 地址列表（分支可选）、每个仓库的拉取状态、提交号、应用描述与不可用原因，单个或全部重新拉取 |
 | 访问令牌 | 填 GitLab 地址、令牌别名和令牌三项即可添加；用户名固定为 oauth2，凭据库键名自动分配（`GUANXIANG_GITLAB_TOKEN`、`GUANXIANG_GITLAB_TOKEN_2`……）。每行显示令牌是否已设置及来源，可替换或清除 |
 | 日志下载 | 允许下载的域名、单文件大小上限、下载超时 |
+| 分析接口 | [日志平台分析接口](#日志平台分析接口)的开关、访问令牌（只显示是否已设置）、飞书渠道是否就绪，以及调用地址与字段摘要 |
 | 高级 | 拉取目录、更新间隔、单次应用数上限、派发超时、SKILL 改进开关与提议上限，恢复 cordis.yml 配置 |
 
 面板保存的值写入 `$DSH_HOME/guanxiang/settings.json`（只保存与 cordis.yml 不同的字段），按与配置相同的规则校验；令牌值不在其中，存入 DSH 凭据库。面板接口 `/guanxiang/*` 使用 DSH 自己的登录与来源校验，写操作另做同源校验。
@@ -170,24 +174,81 @@ skill: log-analysis             # 对应 .dsh/skills/log-analysis/SKILL.md
 
 ## SKILL 改进
 
-开启 `skillUpdates.enabled`（设置面板「高级」→「SKILL 改进」）后，分析中发现的 SKILL 欠缺可以经用户授权后提交为合并请求：
+开启 `skillUpdates.enabled`（设置面板「高级」→「SKILL 改进」）后，分析中发现的 SKILL 欠缺可以经用户授权后提交为合并请求。提交和创建合并请求经 [dsh-repo](https://github.com/modestoma/dsh-repo) 的 `dshRepos` 服务完成（需要 dsh-repo 0.1.0-beta.2 及以上）：需要同时安装 dsh-repo，并在它的 `hosts` 中配置应用仓库所在的主机和令牌；没有该服务或版本不符时工具报错。
 
 1. **子 Agent 写提议。** 子 Agent 的任务消息多出一节说明：把要改的文件从 `.dsh/skills/<skill>/` 复制到运行目录的 `skill-proposal/files/`（保持相对路径）后修改，理由写进 `skill-proposal/reason.md`。仓库对子 Agent 仍然只读。
 2. **派发结果标出提议。** 派发结束后，观象检查已完成任务的提议：只接受普通文件和受限的文件名、UTF-8 文本、文件数与大小上限，`SKILL.md` 不能设置 `user-invocable: false`。合格的提议在结果中给出改动行数，并在运行目录写出 `skill-proposal.diff`；不合格的给出原因。
 3. **父 Agent 展示并提交。** 入口 SKILL 让父 Agent 在汇总回复后附上改动和 diff，再调用 `guanxiang_propose_skill`（参数为任务的运行目录和一句话摘要）。只接受本次 DSH 运行中由同一会话派发过的任务；应用、仓库和分析时的提交取自派发记录。
-4. **请求授权。** 工具通过 DSH 的审批服务（`ctx.approval`，`@deepseek-ai/dsh-user-approval`）请求一次性授权，说明将推送的仓库、分支、目标分支、改动文件和理由。经 dsh_channels 使用时显示为飞书决策卡片，在 DSH Web 中显示为审批提示；观象与 dsh_channels 之间没有代码依赖。只有「允许」才推送；拒绝、撤回或没有可回答的界面时都不推送。会话的审批策略为 `never`（例如 DSH 的「完全访问」权限模式）时请求一律被拒绝，所以要在「询问」类权限模式下使用；DSH 组合没有审批服务时工具报错。
-5. **推送新分支并创建合并请求。** 观象进程（不是 Agent）在拉取仓库中以分析时的提交为父提交生成提交，只改 `.dsh/skills/<skill>/` 下的文件，不动任何检出和快照；然后推送到新分支 `guanxiang/skill-<应用 id>-<树对象前缀>`，用 GitLab push options（`merge_request.create`、`merge_request.target`、`merge_request.title`、`merge_request.description`）创建合入跟踪分支的合并请求，返回服务器给出的合并请求链接。同一改动的分支已存在时不再请求授权，也不推送。从不推送已有分支或默认分支，合并由仓库的评审流程决定；合并后下次 `/guanxiang` 拉取即生效。
+4. **请求授权。** 工具通过 DSH 的审批服务（`ctx.approval`，`@deepseek-ai/dsh-user-approval`）请求一次性授权，说明将提交的仓库、分支、目标分支、改动文件和理由。经 dsh_channels 使用时显示为飞书决策卡片，在 DSH Web 中显示为审批提示；观象与 dsh_channels 之间没有代码依赖。只有「允许」才提交；拒绝、撤回或没有可回答的界面时都不提交。会话的审批策略为 `never`（例如 DSH 的「完全访问」权限模式）时请求一律被拒绝，所以要在「询问」类权限模式下使用；DSH 组合没有审批服务时工具报错。
+5. **提交新分支并创建合并请求。** 观象进程（不是 Agent）经 `dshRepos` 以分析时的提交为起点建新分支 `guanxiang/skill-<应用 id>-<树对象前缀>`，提交 `.dsh/skills/<skill>/` 下有改动的文件，再创建合入跟踪分支的合并请求，返回它的链接。同一改动的分支已存在时不再请求授权，也不提交；等待授权期间分支被别人建出时同样不提交。从不提交到已有分支或默认分支，合并由仓库的评审流程决定；合并后下次 `/guanxiang` 拉取即生效。提交成功但合并请求创建失败时，工具返回分支和失败原因，可以在代码托管平台上手动创建。
 
 注意：
 
-- 只支持 GitLab：不支持 push options 的服务器会拒绝这次推送。https 仓库的令牌需要 `write_repository`（不需要 `api`）；ssh 地址使用本机的 SSH key。
-- 个人访问令牌加了写权限后，可以推送你有权限的所有项目。建议改用只覆盖应用仓库的项目或组访问令牌，设置过期时间，并保护应用仓库的默认分支。
-- 合并请求以令牌主人的身份创建，提交作者是 `skillUpdateAuthor` 或本机 git 身份。飞书群里点「允许」的人可能不是令牌主人；合并请求描述写明了来源会话与分析提交。
+- 支持 GitLab（包括自建实例）和 GitHub。应用仓库的 git 地址（https、ssh 或 `user@host:path`）要能被 dsh-repo 识别为已配置主机上的仓库；dsh-repo 的令牌在 GitLab 上需要 `api` 权限，在 GitHub 上需要 Contents 和 Pull requests 的读写权限。
+- 有写权限的令牌可以改动它能访问的所有项目。建议用只覆盖应用仓库的项目或组访问令牌，设置过期时间，用 dsh-repo 的 `repos` 限定范围，并保护应用仓库的默认分支。
+- 合并请求以 dsh-repo 令牌主人的身份创建，提交作者是 `skillUpdateAuthor`，省略时也是令牌主人。飞书群里点「允许」的人可能不是令牌主人；合并请求描述写明了来源会话与分析提交。
 - 日志内容不可信，可能诱导模型写出不当的 SKILL。观象只限制改动范围，内容需要授权的人和合并请求的评审者把关。
 
+## 日志平台分析接口
+
+日志平台调用观象的分析接口：观象经 [dsh_channels](https://github.com/modestoma/dsh_channels) 的 `feishuTopics` 服务在指定群里发一张分析卡（发起人、触发时间、应用、错误码和日志详情页表格），在卡片下开话题，把平台给的 prompt 原样交给一个新 Session（prompt 开头的斜杠命令由 DSH 展开成对应 SKILL，例如 `/guanxiang`），分析过程在话题内流式输出。分析结束后分析卡的状态标签随之更新，群里通过准入的成员都可以在该话题内追问。日志包地址写在 prompt 里，下载、解压、超时都由 prompt 调用的 SKILL 处理（Session 的沙箱需要能访问日志存储地址）。
+
+接口原由 dsh_channels 0.7 提供，从 dsh_channels 0.8 起迁到观象，请求、响应、错误文本和去重记录都不变。
+
+**前提**：
+
+- dsh_channels 0.8 及以上已加载并提供 `feishuTopics` 服务（版本 1）。没有这个服务时观象不注册接口：dsh_channels 0.7 自带同名接口，升级前由它提供；服务版本不兼容时观象记一条警告，也不注册。设置面板「分析接口」分页显示飞书渠道是否就绪。
+- 只有带 Web 的 profile（web、desktop）有这个接口，headless 没有。
+
+**开启**：在设置面板「分析接口」打开开关（`analyze.enabled`，默认关，保存后立即生效），并在同一页保存访问令牌（建议 32 位以上随机串）。令牌存入 DSH 凭据库的 `GUANXIANG_ANALYZE_TOKEN`（名称可用 `analyzeTokenRef` 修改），也可以设置同名环境变量或写进 `.env`。接口挂在 DSH Web 服务上（与 Web 界面同一端口），路径 `/open-api/logalyze` 放在 DSH 的 `/api` 之外，网关可以把它与需要登录的 DSH 接口分开放行；DSH 通过反向代理挂在前缀下时，地址随之带上前缀（如 `https://<域名>/dsh/open-api/logalyze`）。该路由不走 DSH 登录 cookie，访问令牌是唯一凭据。开关关闭时所有请求返回 404；令牌每次请求都重新读取，轮换后下一次请求生效；令牌未设置时所有请求返回 503。
+
+**从 dsh_channels 0.7 迁移**：把观象和 dsh_channels 一起升级；在观象面板「分析接口」打开开关并保存令牌（新名称 `GUANXIANG_ANALYZE_TOKEN`，可以填原来的令牌值，日志平台无需改动）；然后从 cordis.yml 删掉 dsh_channels 的 `analyzeEnabled` 和 `analyzeToken`（新版 dsh_channels 会对这两项打印警告）。升级前接受过的 `Idempotency-Key` 升级后照常重放。
+
+**请求**：
+
+```http
+POST /open-api/logalyze
+Authorization: Bearer <令牌>
+Idempotency-Key: <平台生成的唯一值，1-200 个可见 ASCII 字符>
+Content-Type: application/json
+
+{
+  "requesterUserId": "a1b2c3d4",
+  "triggeredAt": "2026-10-22 19:30",
+  "app": "camera",
+  "errorCode": "E1001",
+  "logDetails": [
+    { "name": "设备 A 崩溃日志", "url": "https://logs.example.com/detail/1" },
+    { "name": "设备 B 崩溃日志", "url": "https://logs.example.com/detail/2" }
+  ],
+  "chatId": "oc_xxx",
+  "prompt": "/guanxiang https://logs.example.com/1.zip https://logs.example.com/2.zip 请分析这些日志"
+}
+```
+
+- `requesterUserId`：平台发起人的飞书 user_id，分析卡 @ 此人；路由记录里也以此人作为发起人。
+- `triggeredAt`：平台上发起分析的时间，1–64 字符，原样显示在分析卡上（时区和格式由平台决定）。
+- `app` / `errorCode`：只允许 `A-Z a-z 0-9 . _ -`（1–128 字符），决定工作区 `<dsh_channels baseDir>/analyze/<app>/<errorCode>/`；同一应用同一错误码的所有分析都在这个工作区里，每次分析各有一个话题目录。
+- `logDetails`：触发分析的日志在日志平台上的详情页，1–50 条，每条 `name`（1–200 字符）+ `url`（http/https）。只在分析卡的表格里列出，观象不会访问这些地址。
+- `chatId`：目标群，必须是 dsh_channels 已授权的群（`/auth group add` 或其面板「访问与授权」），机器人需在群内；dsh_channels `accessMode: open` 时不校验。
+- `prompt`：1–100000 字符，原样作为首条用户消息，不追加任何内容。
+- 只接受以上 7 个字段，多余字段返回 400。
+
+**响应**：校验通过、分析卡发出后立即返回 `202`：
+
+```json
+{ "ok": true, "chatId": "oc_xxx", "messageId": "om_xxx" }
+```
+
+`messageId` 是分析卡的消息 id，分析话题挂在它下面。同步错误都带中文 `error`：`401` 令牌无效、`404` 接口开关未打开（或接口未注册）、`405` 不是 POST、`400` 参数或 `Idempotency-Key` 不合法、`403` 目标群未授权、`409` 同一个 `Idempotency-Key` 已被内容不同的请求使用、`413` 请求体超过 1 MiB、`415` 不是 JSON、`502` 分析卡发送失败（如机器人不在群里）、`503` 飞书未连接或未设置令牌。
+
+**去重**：同一个 `Idempotency-Key` 再次请求（包括并发重试）原样返回第一次的结果，不会再发卡、再分析。记录由 dsh_channels 永久保存。分析卡发出后的失败（话题创建、Session 创建）不会回滚这条记录：分析卡的状态变成「失败」并写明原因，需要重试时请换一个新的 `Idempotency-Key`。
+
+**群里看到的**：先是分析卡「@发起人 于 <triggeredAt> 发起了对 X 应用 Y 错误码不良日志的分析」，下面是日志详情页表格，标题栏标签为「分析中」；紧接着话题内一张流式卡片，首轮分析在这里流式输出，带停止按钮。首轮结束后分析卡的标签变成「已完成」「已停止」或「失败」；DSH 在首轮进行中重启时，重新连上飞书后仍是「分析中」的分析卡会改成「已中断」，在话题内回复即可继续。分析话题是群内共享的：群里任何通过 dsh_channels 准入的成员都可以在话题内追问、停止或回答审批卡。卡片、话题与权限的细节见 dsh_channels README 的「群话题服务（feishuTopics）」。
+
 ## 通过飞书使用
 
-观象与 [dsh_channels](https://github.com/modestoma/dsh_channels) 没有代码耦合。dsh_channels 把不在自己命令表中的 `/` 开头消息作为普通 prompt 交给 dsh，dsh 识别 `/guanxiang` 后展开入口 SKILL。飞书附件的宿主路径会出现在消息里，入口 SKILL 会把它作为日志路径派发。
+在飞书里使用 `/guanxiang` 不需要观象与 [dsh_channels](https://github.com/modestoma/dsh_channels) 之间的任何接口：dsh_channels 把不在自己命令表中的 `/` 开头消息作为普通 prompt 交给 dsh，dsh 识别 `/guanxiang` 后展开入口 SKILL。飞书附件的宿主路径会出现在消息里，入口 SKILL 会把它作为日志路径派发。只有[日志平台分析接口](#日志平台分析接口)经 dsh_channels 的 `feishuTopics` 服务发卡开话题；观象只在开发时依赖 dsh_channels 的类型，运行时按服务名查找，没有加载 dsh_channels 时其余功能不受影响。
 
 ## 开发
 
@@ -196,6 +257,8 @@ pnpm install
 pnpm check        # 类型检查（Host 与 Client）+ 单元测试 + 构建 + 两个加载自检
 ```
 
+`@modesto_ma/dsh-channels` 是开发依赖，只用来引入 `feishuTopics` 服务的类型（`@modesto_ma/dsh-channels/topics`，`import type`），构建产物不包含它。
+
 ## 发布
 
 版本号由 semantic-release 按 Conventional Commits 计算。推送到 `dev` 后，检查通过就自动发布 beta；正式版**只在手动触发时发布**，推送到 `main` 只跑检查。只有 `feat`、`fix` 或破坏性变更会产生新版本，其余类型的提交不发布。PR 标题需符合 `<type>(<scope>): <summary>`，type 取 `feat | fix | docs | test | refactor | chore | ci`。
@@ -215,6 +278,7 @@ pnpm check        # 类型检查（Host 与 Client）+ 单元测试 + 构建 +
 | `src/skill/entry.ts` | `/guanxiang` 入口 SKILL |
 | `src/dispatch/` | 派发工具、日志下载、子 Agent 首条消息 |
 | `src/skill-update/` | SKILL 修改提议的校验、提交、授权与推送 |
+| `src/analyze/` | 日志平台分析接口：请求校验、令牌、到 `feishuTopics` 的转换 |
 | `src/settings/` | 面板契约、覆盖文件、HTTP 路由 |
 | `src/client/` | 左侧栏入口与设置页面 |
 | `examples/order-service/` | 示例应用仓库 |

package/lib/client.js

@@ -48,7 +48,7 @@ window.__ModuleLoader__.load({
 		const SETTINGS_ROUTE = "/guanxiang/settings";
 		/** POST：立即重新拉取全部仓库，或 body `{ url }` 指定的一个仓库。 */
 		const SYNC_ROUTE = "/guanxiang/sync";
-		/** PUT：body `{ tokenEnv, value }` 把令牌存入 DSH 凭据库；DELETE：body `{ tokenEnv }` 删除已存的值。只接受已保存的访问令牌配置引用的名称。 */
+		/** PUT：body `{ tokenEnv, value }` 把令牌存入 DSH 凭据库；DELETE：body `{ tokenEnv }` 删除已存的值。只接受已保存的访问令牌配置引用的名称和分析接口令牌的名称。 */
 		const TOKEN_ROUTE = "/guanxiang/token";
 		//#endregion
 		//#region src/client/api.ts
@@ -157,9 +157,9 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region src/client/page.tsx
 		/**
-		* 左侧栏「观象」主区页面：应用仓库、访问令牌、日志下载、高级（含 SKILL 改进）四个分页，共用
-		* 一份草稿和底部保存条；令牌值不进草稿，单独存入 DSH 凭据库。仓库拉取中时
-		* 每 2 秒刷新状态。
+		* 左侧栏「观象」主区页面：应用仓库、访问令牌、日志下载、分析接口、高级（含 SKILL 改进）五个
+		* 分页，共用一份草稿和底部保存条；令牌值不进草稿，单独存入 DSH 凭据库。
+		* 仓库拉取中时每 2 秒刷新状态。
 		*
 		* @module dsh-guanxiang/client/page
 		*/
@@ -181,6 +181,10 @@ window.__ModuleLoader__.load({
 				id: "download",
 				label: "日志下载"
 			},
+			{
+				id: "analyze",
+				label: "分析接口"
+			},
 			{
 				id: "advanced",
 				label: "高级"
@@ -202,7 +206,8 @@ window.__ModuleLoader__.load({
 				timeoutSec: trimNumber(settings.download.timeoutMs / 1e3),
 				skillUpdatesEnabled: settings.skillUpdates.enabled,
 				skillMaxFiles: String(settings.skillUpdates.maxFiles),
-				skillMaxKb: trimNumber(settings.skillUpdates.maxFileBytes / KB)
+				skillMaxKb: trimNumber(settings.skillUpdates.maxFileBytes / KB),
+				analyzeEnabled: settings.analyze.enabled
 			};
 		}
 		function positive(text, label, allowZero = false) {
@@ -239,7 +244,8 @@ window.__ModuleLoader__.load({
 					enabled: draft.skillUpdatesEnabled,
 					maxFiles,
 					maxFileBytes: Math.round(positive(draft.skillMaxKb, "提议单文件大小上限") * KB)
-				}
+				},
+				analyze: { enabled: draft.analyzeEnabled }
 			};
 		}
 		function sameSettings(draft, settings) {
@@ -485,6 +491,18 @@ window.__ModuleLoader__.load({
 								setDraft,
 								overridden: state.overridden
 							}) : null,
+							tab === "analyze" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(AnalyzeTab, {
+								draft,
+								setDraft,
+								analyze: state.analyze,
+								credentialsAvailable: state.credentials.available,
+								overridden: state.overridden,
+								busy,
+								onSave: async (value) => await run(() => saveToken(state.analyze.tokenEnv, value), "已保存分析接口令牌，下一个请求起生效", false) !== void 0,
+								onClear: () => {
+									run(() => clearToken(state.analyze.tokenEnv), "已清除面板保存的分析接口令牌", false);
+								}
+							}) : null,
 							tab === "advanced" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(AdvancedTab, {
 								draft,
 								setDraft,
@@ -1077,6 +1095,224 @@ window.__ModuleLoader__.load({
 				})]
 			})] });
 		}
+		const TOPICS_STATUS = {
+			ready: {
+				pill: "gx__pill--ok",
+				text: "飞书渠道就绪"
+			},
+			missing: {
+				pill: "gx__pill--bad",
+				text: "未找到飞书渠道"
+			},
+			incompatible: {
+				pill: "gx__pill--bad",
+				text: "飞书渠道版本不兼容"
+			}
+		};
+		function AnalyzeTab({ draft, setDraft, analyze, credentialsAvailable, overridden, busy, onSave, onClear }) {
+			const [value, setValue] = (0, react.useState)("");
+			const token = analyze.token;
+			const save = () => {
+				const trimmed = value.trim();
+				if (trimmed === "" || busy) return;
+				onSave(trimmed).then((ok) => {
+					if (ok) setValue("");
+				});
+			};
+			const topics = TOPICS_STATUS[analyze.topics];
+			const endpoint = new URL(analyze.route.slice(1), document.baseURI).href;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+				className: "gx__sec",
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h2", {
+					className: "gx__secTitle",
+					children: "日志平台分析接口"
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "gx__list",
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "gx__row",
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "gx__rowText",
+							children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: "gx__rowLabel",
+									children: [
+										"开启接口 ",
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Overridden, {
+											keys: overridden,
+											name: "analyze"
+										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+											className: `gx__pill ${topics.pill}`,
+											children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { className: "gx__dot" }), topics.text]
+										})
+									]
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+									className: "gx__rowSummary",
+									children: "日志平台调用接口后，观象经飞书渠道（dsh-channels 0.8 及以上）在目标群发出分析卡片，并在卡片下的话题里开始分析；群内成员都可以在话题里继续追问。关闭时接口回复 404。"
+								}),
+								analyze.topics === "ready" ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+									className: "gx__rowError",
+									children: analyze.topics === "missing" ? "接口需要 dsh-channels 0.8 及以上版本并已加载；dsh-channels 0.7 自带同名接口，升级前由它提供。" : "请把观象与 dsh-channels 升级到相互兼容的版本。"
+								})
+							]
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: "gx__rowCtl",
+							children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+								type: "checkbox",
+								className: "gx__check",
+								"aria-label": "开启分析接口",
+								checked: draft.analyzeEnabled,
+								onChange: (event) => {
+									setDraft({
+										...draft,
+										analyzeEnabled: event.target.checked
+									});
+								}
+							})
+						})]
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "gx__row gx__row--top",
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "gx__rowText",
+							children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: "gx__rowLabel",
+									children: [
+										"访问令牌 ",
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+											className: "gx__tag gx__mono",
+											children: analyze.tokenEnv
+										}),
+										credentialsAvailable ? tokenPill(token) : null
+									]
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: "gx__rowSummary",
+									children: [
+										"日志平台以 ",
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+											className: "gx__mono",
+											children: "Authorization: Bearer <令牌>"
+										}),
+										" 调用接口。令牌未设置时接口回复 503。"
+									]
+								}),
+								credentialsAvailable ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+									className: "gx__rowError",
+									children: "当前 DSH 组合没有加载凭据服务（@deepseek-ai/dsh-credentials-local），无法保存或读取令牌。"
+								}),
+								token?.error === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+									className: "gx__rowError",
+									children: token.error
+								}),
+								token !== void 0 && token.writable ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: "gx__addRow gx__addRow--flush",
+									children: [
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+											className: "gx__input gx__mono",
+											type: "password",
+											autoComplete: "new-password",
+											spellCheck: false,
+											placeholder: token.configured ? "输入新令牌以替换" : "粘贴令牌",
+											value,
+											onChange: (event) => {
+												setValue(event.target.value);
+											},
+											onKeyDown: (event) => {
+												if (event.key === "Enter") save();
+											}
+										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+											type: "button",
+											className: "gx__btn",
+											disabled: busy || value.trim() === "",
+											onClick: save,
+											children: "保存令牌"
+										}),
+										token.configured && token.source === "file" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+											type: "button",
+											className: "gx__btn gx__btn--ghost",
+											disabled: busy,
+											onClick: onClear,
+											children: "清除"
+										}) : null
+									]
+								}) : null
+							]
+						})
+					})]
+				})]
+			}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+				className: "gx__sec",
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h2", {
+					className: "gx__secTitle",
+					children: "调用方式"
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "gx__list",
+					children: [
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: "gx__row",
+							children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								className: "gx__rowText",
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+									className: "gx__rowLabel",
+									children: "地址"
+								}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: "gx__rowSummary gx__mono",
+									children: ["POST ", endpoint]
+								})]
+							})
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: "gx__row",
+							children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								className: "gx__rowText",
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+									className: "gx__rowLabel",
+									children: "请求头"
+								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+									className: "gx__rowSummary gx__mono",
+									children: "Authorization: Bearer <令牌> · Idempotency-Key: <1-200 个可见 ASCII 字符> · Content-Type: application/json"
+								})]
+							})
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: "gx__row",
+							children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								className: "gx__rowText",
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+									className: "gx__rowLabel",
+									children: "请求体"
+								}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: "gx__rowSummary gx__mono",
+									children: [
+										"requesterUserId, triggeredAt, app, errorCode, logDetails[",
+										"{",
+										"name, url",
+										"}",
+										"], chatId, prompt"
+									]
+								})]
+							})
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: "gx__row",
+							children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								className: "gx__rowText",
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+									className: "gx__rowLabel",
+									children: "响应"
+								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+									className: "gx__rowSummary",
+									children: "202 已发出分析卡片（同一 Idempotency-Key 重试返回同一张卡片）；400/401/404/405/409/413/415 请求问题；403 目标群未授权；502 卡片发送失败；503 飞书未连接或令牌未设置。字段说明见观象 README。"
+								})]
+							})
+						})
+					]
+				})]
+			})] });
+		}
 		function AdvancedTab({ draft, setDraft, overridden, busy, onReset }) {
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
 				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
@@ -1182,7 +1418,7 @@ window.__ModuleLoader__.load({
 										})]
 									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 										className: "gx__rowSummary",
-										children: "子 Agent 发现应用的日志分析 SKILL 有欠缺时可以写出修改提议；经用户授权后，观象用访问令牌把它推送到新分支并创建合并请求（GitLab，令牌需要 write_repository 权限）。"
+										children: "子 Agent 发现应用的日志分析 SKILL 有欠缺时可以写出修改提议；经用户授权后，观象经 dsh-repo 把它提交到新分支并创建合并请求（GitLab 或 GitHub，需要安装 dsh-repo 并配置该仓库主机的令牌）。"
 									})]
 								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 									className: "gx__rowCtl",