weaver-work-cli 0.1.5 → 0.1.7

package/skills/weaver-e10-jiuchuanhui/references/disabled-capabilities.md

@@ -9,7 +9,7 @@
 | 能力 | 原因 | 处理方式 |
 |---|---|---|
 | `jiuchuanhui.sale.stage-advance`（商机阶段推进） | 依赖缓存 `sale_stage` 配置做阶段 ID 映射与前置校验，属于 Skill 编排层职责 | 用 `sale.update` + `sale.stage.search` 组合实现；先查阶段选项，再按目标阶段映射 ID 走 `sale.update.prepare/apply` |
-| `jiuchuanhui.ds.fields`（表单字段发现） | 接口 `/api/ebuilder/common/ds/fields` 在当前 E10 版本返回 HTTP 400，无法使用 | 字段信息通过缓存初始化（`cache.init`）获取，不依赖此接口 |
+| `jiuchuanhui.ds.fields`（表单字段发现） | 缓存初始化（`cache.init`）已在 `config/{pk}.json` 的 `detail` 中合并字段 `component_type`，字段信息直接读缓存即可，无需单独调用 `/api/ebuilder/common/ds/fields` | 字段 `component_type` 来自缓存配置，未封装为独立 CLI operation |
 
 ## 处理规则
 

package/skills/weaver-e10-jiuchuanhui/references/discovery-config.md

@@ -6,15 +6,15 @@
 
 ## 可用 operation
 
-| Operation | 风险 | 输入要点 |
-|---|---|---|
-| `jiuchuanhui.app.discovery` | 只读 | `tag`（默认 `jch-crm-project`） |
-| `jiuchuanhui.form.discovery` | 只读 | `tag`、`appId` |
-| `jiuchuanhui.field.options` | 只读 | `fieldName`、`sourceType`（必填，值为 `FORM`）；可选 `objId`、`groupId`（可省略自动发现，`groupId` 来自 `app.discovery` tag=`jch-crm-project`） |
-| `jiuchuanhui.rest.cfg.detail` | 只读 | `apid`、`id`（cfgId） |
-| `jiuchuanhui.config.id.by.pk` | 只读 | `mainTable.interface_pk` |
-| `jiuchuanhui.file.preview` | 只读（文件预览） | `fileId` 必填，可选 `fieldId`/`appId`/`customParam` |
-| `jiuchuanhui.get-rest-cfg-detail` | 只读 | `apid`、`id`（cfgId） |
+| Operation | 风险 | 输入要点                                                                                                                                                   |
+|---|---|--------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `jiuchuanhui.app.discovery` | 只读 | `tag`（默认 `jch-crm-project`）                                                                                                                            |
+| `jiuchuanhui.form.discovery` | 只读 | `tag`、`appId`                                                                                                                                          |
+| `jiuchuanhui.field.options` | 只读 | `fieldName`（必填,传入字段ID）、`sourceType`（必填，值为 `FORM`）；可选 `objId`（不传默认按 `uf_jch_customer` 表单发现）、`groupId`（可省略自动发现，来自 `app.discovery` tag=`jch-crm-project`） |
+| `jiuchuanhui.rest.cfg.detail` | 只读 | `apid`、`id`（cfgId）                                                                                                                                     |
+| `jiuchuanhui.config.id.by.pk` | 只读 | `mainTable.interface_pk`                                                                                                                               |
+| `jiuchuanhui.file.preview` | 只读（文件预览） | `fileId` 必填，可选 `fieldId`/`appId`/`customParam`                                                                                                         |
+| `jiuchuanhui.get-rest-cfg-detail` | 只读 | `apid`、`id`（cfgId）                                                                                                                                     |
 
 ## 输入要点
 
@@ -23,7 +23,7 @@
 - 缓存缺失或用户要求刷新时，调用 CLI operation `jiuchuanhui.cache.init`（应用发现 -> objId -> 版本校验 >= 1.5.11 -> cfgId -> 接口配置 -> 关联数据 -> 字段选项 -> 搜索参数 -> 行政区划），再继续业务调用。缓存初始化和刷新**已暴露为 CLI operation `jiuchuanhui.cache.init`**（risk: local-file-write，无需 prepare/apply 确认链）；也可在仓库根运行 `node src/shortcuts/jiuchuanhui/scripts/cache-init.mjs`（薄包装）。
 - 文件预览：`fileId` 为必填；涉及本地文件/远程 URL 解析时先提醒用户文件内容可能进入大模型上下文或发送到文件服务。
 - `file.preview` 返回的 `loadUrl`/`previewLink` 带临时签名（约 7 天），过期需重新调用获取，不要硬编码或长期缓存下载地址；附件 ID 从表单数据字段获取，字段无附件时返回空数组，无需调用本接口。
-
+- `jiuchuanhui.field.options`参数fieldName传入的是字段的id
 ## 命令
 
 Windows PowerShell：

package/skills/weaver-e10-jiuchuanhui/references/general-helpers.md

@@ -18,7 +18,7 @@
 
 ## 输入要点
 
-- `moduleType`：模块类型（如 `customer`/`sale`/`clue`/`contact` 等），`name` 为事项名称。
+- `moduleType`：事项模块类型，必须精确匹配：`customer`（客户）/`saleChance`（商机）/`clue`（线索）/`administrativeDivision`（行政区域）；`name` 为事项名称（必填）。传错值会静默返回“未查询到相关事项”。
 - 行政区划也走按名称查事项 ID：`moduleType: "administrativeDivision"`、`name` 传城市名；返回全路径 ID，可写缓存。
 - `browser-option.search` 是 RelateBrowser 字段的选项查询入口：用 `customBrowserType` 指定浏览类型，返回自定义浏览选项供选择。需已知 `customBrowserType`（自定义浏览类型标识），通过「通过字段id获取字段信息」接口（`jiuchuanhui.field.info.by-ids`）获取 RelateBrowser 字段定义中的 `browser_type` 作为 `customBrowserType`。 常见类型：`customBrowser_industrybrowser`（行业）。
 - 选项字段（Select/RadioBox/CheckBox）传 ID；`RelateBrowser` 字段通过 `browser-option.search` 查询对应类型选项。
@@ -31,7 +31,7 @@ Windows PowerShell：
 weaver-work-cli --json jiuchuanhui run jiuchuanhui.user.id.by-name --input-json '{"mainTable":{"employeeName":"魏思雨"}}'
 weaver-work-cli --json jiuchuanhui run jiuchuanhui.entity.id.by-name --input-json '{"mainTable":{"moduleType":"customer","name":"示例科技有限公司"}}'
 weaver-work-cli --json jiuchuanhui run jiuchuanhui.user.current-profile --input-json '{}'
-weaver-work-cli --json jiuchuanhui run jiuchuanhui.browser-option.search --input-json '{"pathParams":{"customBrowserType":"customer_type"},"params":{"searchValue":"科技"}}'
+weaver-work-cli --json jiuchuanhui run jiuchuanhui.browser-option.search --input-json '{"pathParams":{"customBrowserType":"customBrowser_industrybrowser"},"params":{"searchValue":"科技"}}'
 ```
 
 macOS/Linux（bash/zsh）：
@@ -40,7 +40,7 @@ macOS/Linux（bash/zsh）：
 weaver-work-cli --json jiuchuanhui run jiuchuanhui.user.id.by-name --input-json '{"mainTable":{"employeeName":"魏思雨"}}'
 weaver-work-cli --json jiuchuanhui run jiuchuanhui.entity.id.by-name --input-json '{"mainTable":{"moduleType":"customer","name":"示例科技有限公司"}}'
 weaver-work-cli --json jiuchuanhui run jiuchuanhui.user.current-profile --input-json '{}'
-weaver-work-cli --json jiuchuanhui run jiuchuanhui.browser-option.search --input-json '{"pathParams":{"customBrowserType":"customer_type"},"params":{"searchValue":"科技"}}'
+weaver-work-cli --json jiuchuanhui run jiuchuanhui.browser-option.search --input-json '{"pathParams":{"customBrowserType":"customBrowser_industrybrowser"},"params":{"searchValue":"科技"}}'
 ```
 
 ## 输出处理

package/skills/weaver-e10-jiuchuanhui/references/sale.md

@@ -16,17 +16,17 @@
 | `jiuchuanhui.rival.search` | 只读 | 对手/友商列表 |
 | `jiuchuanhui.sale.win.prepare/apply` | 高风险写 | `saleId`；赢单不可逆 |
 | `jiuchuanhui.sale.lose.prepare/apply` | 高风险写 | `saleid`、`reasonids`（输单原因，**单选**，传一个原因 ID）；可选 `money`（单位为**元**）、`rivals`（对手 ID，**多选**逗号分隔）、`desc`；输单必须先确定原因 |
-| `jiuchuanhui.sale.invalid.prepare/apply` | 高风险写 | `saleid`；无效不可逆 |
-| `jiuchuanhui.sale.pause.prepare/apply` | 高风险写 | `saleid`、`pauseReason`（必填，暂停原因描述）；可选 `restartDate`（**预计重启日期**，格式 `yyyy-MM-dd`） |
+| `jiuchuanhui.sale.invalid.prepare/apply` | 高风险写 | `saleId`；无效不可逆 |
+| `jiuchuanhui.sale.pause.prepare/apply` | 高风险写 | `saleId`、`pauseReason`（必填，暂停原因描述）；可选 `restartDate`（**预计重启日期**，格式 `yyyy-MM-dd`） |
 | `jiuchuanhui.sale.restart.prepare/apply` | 高风险写 | `saleChanceId`（**仅可重启已暂停的商机**）；确认商机已暂停再操作 |
 | `jiuchuanhui.sale.manager-change.prepare/apply` | 高风险写 | `saleChanceId`、`managerId`（目标负责人）；转移/负责人变更共用；**仅本人或本人下级商机可操作**，权限不足返回 HTTP 204 |
 | `jiuchuanhui.sale.link-contacts.prepare/apply` | 高风险写 | `salechanceId`（注意小写 c）、`contactIds`；确认联系人与商机关联关系 |
-| `jiuchuanhui.sale.contact-record.create.prepare/apply` | 高风险写 | `saleid`、`comment_content`（必填）；可选 `type`/`rating`/`contact_information`/`contacts`/`next_time`/`next_content`/`next_contact_information`/`next_contacts`/`rel_remind`。`type` 为**联系类型**（例行联系等），与客户联系记录的 `type`（评论类型）**取值体系不同，勿混用** |
+| `jiuchuanhui.sale.contact-record.create.prepare/apply` | 高风险写 | `saleId`、`comment_content`（必填）；可选 `type`/`rating`/`contact_information`/`contacts`/`next_time`/`next_content`/`next_contact_information`/`next_contacts`/`rel_remind`。`type` 为**联系类型**（例行联系等，默认 `0`），与客户联系记录的 `type`（评论类型）**取值体系不同，勿混用** |
 
 ## 输入要点
 
-- 创建/修改前读缓存 `config/sale_create_api.json`（或 `sale_update_api.json`）的 `detail`，按 `data_key` 组装，`isRequired:"1"` 缺失时追问。
-- Select/RadioBox/CheckBox 传选项 ID；关联客户传 `customerId`；负责人传人员 ID。
+- 创建/修改前读缓存 `config/sale_create_api.json`（或 `sale_update_api.json`）的 `detail.mainFields`（与 `detail.detailFields`，商机明细按需组装），按 `data_key` 组装，`isRequired:"1"` 缺失时追问。
+- Select/RadioBox/CheckBox 传选项 ID；关联客户传 `customer`（客户数据 ID）；负责人传 `manager`（人员 ID）。
 - 搜索商机：默认小页；需要总数时 `count:true` 与列表**并行**发起。
 
 ## 命令
@@ -38,7 +38,7 @@ weaver-work-cli --json jiuchuanhui run jiuchuanhui.sale.search --input-json '{"s
 weaver-work-cli --json jiuchuanhui run jiuchuanhui.sale.get --input-json '{"id":"200001"}'
 weaver-work-cli --json jiuchuanhui run jiuchuanhui.sale.win.prepare --input-json '{"mainTable":{"saleId":"200001"}}'
 weaver-work-cli --json jiuchuanhui run jiuchuanhui.sale.win.apply --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
-weaver-work-cli --json jiuchuanhui run jiuchuanhui.sale.lose.prepare --input-json '{"mainTable":{"saleId":"200001","reasonids":"400001"}}'
+weaver-work-cli --json jiuchuanhui run jiuchuanhui.sale.lose.prepare --input-json '{"mainTable":{"saleid":"200001","reasonids":"400001"}}'
 weaver-work-cli --json jiuchuanhui run jiuchuanhui.sale.link-contacts.prepare --input-json '{"mainTable":{"salechanceId":"200001","contactIds":"300001,300002"}}'
 ```
 
@@ -49,7 +49,7 @@ weaver-work-cli --json jiuchuanhui run jiuchuanhui.sale.search --input-json '{"s
 weaver-work-cli --json jiuchuanhui run jiuchuanhui.sale.get --input-json '{"id":"200001"}'
 weaver-work-cli --json jiuchuanhui run jiuchuanhui.sale.win.prepare --input-json '{"mainTable":{"saleId":"200001"}}'
 weaver-work-cli --json jiuchuanhui run jiuchuanhui.sale.win.apply --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
-weaver-work-cli --json jiuchuanhui run jiuchuanhui.sale.lose.prepare --input-json '{"mainTable":{"saleId":"200001","reasonids":"400001"}}'
+weaver-work-cli --json jiuchuanhui run jiuchuanhui.sale.lose.prepare --input-json '{"mainTable":{"saleid":"200001","reasonids":"400001"}}'
 weaver-work-cli --json jiuchuanhui run jiuchuanhui.sale.link-contacts.prepare --input-json '{"mainTable":{"salechanceId":"200001","contactIds":"300001,300002"}}'
 ```
 

package/skills/weaver-e10-jiuchuanhui/references/source-manifest.json

@@ -11,7 +11,7 @@
   },
   "generatedAt": "2026-09-09T00:00:00.000Z",
   "sourceSet": {
-    "aggregateSha256": "47a4fe6dc3b258bfcf5a79c6122edf67494b3466ff976bd63bef2c5624f42833",
+    "aggregateSha256": "8250427995b794af54d88c815f03d241e57a7ddd309ba04fcfe70a88f5aa8512",
     "sourceRoots": [
       "weaver-e10-jiuchuanhui"
     ],
@@ -2620,7 +2620,7 @@
     }
   },
   "artifactBaseline": {
-    "aggregateSha256": "pending-after-write",
+    "aggregateSha256": "4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945",
     "files": []
   },
   "notes": [
@@ -2629,4 +2629,4 @@
     "缓存初始化（cache.init）已暴露为 CLI operation（risk: local-file-write，写入本地缓存文件）；商机阶段推进（sale.stage-advance）按模块边界不暴露为 CLI operation，由 Skill 编排层承担。",
     "manifest 只记录路径、hash、影响映射和转换摘要，不保存 Cookie、Token、个人主目录绝对路径或大段源正文。"
   ]
-}
+}

package/skills/weaver-e10-jucailin/SKILL.md

@@ -15,7 +15,7 @@ cliHelp: "weaver-work-cli ehr --help"
 
 # 泛微聚才林人事云
 
-**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)，其中包含安装、E10 认证、JSON 输出和高风险写入规则。若不存在则必须先执行 `weaver-work-cli skills install shared --skills-dir <当前Agent的Skills目录>`，若 CLI 未安装则先执行 `npm install -g weaver-work-cli`，安装或读取失败时必须停止执行。**
+**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)，其中包含安装、E10 认证、JSON 输出和高风险写入规则。若不存在则必须先执行 `weaver-work-cli skills install shared --target-dir <当前Agent的Skills目录>`，若 CLI 未安装则先执行 `npm install -g weaver-work-cli`，安装或读取失败时必须停止执行。**
 
 
 本技能覆盖聚才林业务域：**人事档案（hr）**、**出勤管理（attend）**、**薪酬管理（salary）**、**招聘（recruit，读 + 写）**。招聘写操作走 prepare→apply 确认协议；撤销类写操作不实现，原因见 [`references/safety-boundaries.md`](references/safety-boundaries.md)。
@@ -52,7 +52,7 @@ weaver-work-cli --json ehr run <operation> --input -
 
 ## 跨子系统差异（必须先知道）
 
-三个子系统的响应契约和分页结构不统一，已在 CLI 内归一化，但语义差异仍会影响结果解读：
+四个子系统（人事档案 / 出勤 / 薪酬 / 招聘）的响应契约和分页结构不统一，已在 CLI 内归一化，但语义差异仍会影响结果解读：
 
 - **响应成功判定**：出勤是 `success` 布尔，人事档案是 `code=200`，薪酬个人报表是 `status` 布尔。
 - **分页**：出勤统计接口不返回 page 对象。其余表格接口的 `pageSize` **由服务端固定，传参无效**：通讯录为 100，出勤与报表类为 20。全量数据必须递增 `current` 翻页（已实测：通讯录 `current=1` 返回 100 条、`current=2` 返回 45 条，合计 145）。

package/skills/weaver-e10-mail/SKILL.md

@@ -10,16 +10,32 @@ author: 泛微网络科技股份有限公司
 agent_created: true
 requires:
   bins: ["weaver-work-cli"]
+dependencies:
+  - weaver-e10-login
 cliHelp: "weaver-work-cli mail --help"
 ---
 
-**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)，其中包含安装、E10 认证、JSON 输出和高风险写入规则。若不存在则必须先执行 `weaver-work-cli skills install shared --skills-dir <当前Agent的Skills目录>`，若 CLI 未安装则先执行 `npm install -g weaver-work-cli`，安装或读取失败时必须停止执行。**
+**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)，其中包含安装、E10 认证、JSON 输出和高风险写入规则。若不存在则必须先执行 `weaver-work-cli skills install shared --target-dir <当前Agent的Skills目录>`，若 CLI 未安装则先执行 `npm install -g weaver-work-cli`，安装或读取失败时必须停止执行。**
 
 认证和登录态只能按共享规则通过 `weaver-work-cli auth ...` 命令判断；禁止直接读取、列出、打印或解析用户主目录下的旧 `.e10-cli`、auth、config 或 Keychain 数据。
 所有命令通过 `weaver-work-cli --json mail run <operation>` 执行：简单 JSON 优先传 `--input-json '<json>'`，复杂或多行 JSON 先写入 UTF-8 文件再传 `--input <path>`，只有确认当前 shell 能稳定传管道时才使用 `--input -`。调用前先按需读取 references 下对应的文件，查参数结构，不要猜字段；**references 是第一信息源**，`weaver-work-cli mail schema` 是 operation、字段和风险等级的合约来源。
 命令示例、提示词和临时说明必须同时兼容 Windows 和 macOS/Linux；涉及 JSON 输入、用户目录、路径分隔符、Python 启动器、文件删除、目录查看或文件比对时，同时给 Windows PowerShell 与 macOS/Linux（bash/zsh）两套示例。Agent 先根据当前系统和 shell 选择对应示例，不确定时用 `node -p "process.platform"` 判断。Windows/PowerShell 下不要使用 `printf`、`$HOME/...`、`~/...`、bash 反斜杠续行、`rm/ls/diff/python3` 等 Unix-only 写法。
 涉及邮件附件、图片、本地文件、远程 URL 文件或邮件正文解析的操作，执行前必须提醒用户：文件内容可能被上传到 E10 邮件系统，并可能进入当前大模型上下文用于理解和处理；必须等待用户明确确认后才继续。
 
+# 泛微E10邮件
+
+## 认证与请求头契约
+
+登录与会话由 E10 登录能力统一提供：文档型约定为 `weaver-e10-login` 技能，本 CLI 场景下等价入口是 `weaver-work-cli auth ...` 命令体系。业务 Skill 不自建登录流程，不索取、打印或转存任何凭证。
+
+CLI 发往 E10 的每个请求都自动携带以下三项用户信息参数，**缺一不可**（业务入参里不要传这些字段，也不要手工拼装请求头）：
+
+```text
+Cookie: <登录返回的完整原始 Cookie 串，原样透传，禁止裁剪/去重/改写>
+eteamsid: <登录返回的 ETEAMSID>
+User-Agent: AgentType=<agentType>,IsAgent=true
+```
+
 ## 路由优先级（先判断是不是 E10 邮件，再选 operation）
 
 只要用户的核心对象是泛微 E10 邮件（收件箱/发件箱/草稿/已删除/垃圾箱/待办邮件、邮件正文、附件、签名、模板、联系人、黑名单、往来邮件），就优先使用 `weaver-e10-mail`。
@@ -44,16 +60,16 @@ cliHelp: "weaver-work-cli mail --help"
 | 查看可用 operation、字段和风险等级 | `mail schema` | [`mail-agent-entry.md`](references/mail-agent-entry.md) |
 | 查询邮件列表 | `mail run mail.list` | [`mail-read.md`](references/mail-read.md) |
 | 往来邮件 | `mail run mail.contact.list` | [`mail-read.md`](references/mail-read.md) |
-| 查看邮件详情/正文 | `mail run mail.view.info` / `mail.run mail.view.content` | [`mail-read.md`](references/mail-read.md) |
-| 未读统计 / 邮件配置 | `mail run mail.unread.count` / `mail.run mail.config.get` | [`mail-read.md`](references/mail-read.md) |
-| 收件人解析（内部/部门/外部） | `mail run mail.person.search` / `mail.run mail.dep.search` / `mail.run mail.address.search` | [`mail-read.md`](references/mail-read.md) |
+| 查看邮件详情/正文 | `mail run mail.view.info` / `mail run mail.view.content` | [`mail-read.md`](references/mail-read.md) |
+| 未读统计 / 邮件配置 | `mail run mail.unread.count` / `mail run mail.config.get` | [`mail-read.md`](references/mail-read.md) |
+| 收件人解析（内部/部门/外部） | `mail run mail.person.search` / `mail run mail.dep.search` / `mail run mail.address.search` | [`mail-read.md`](references/mail-read.md) |
 | 发送/回复/转发/存草稿 | `mail run mail.send.prepare/apply` | [`mail-send.md`](references/mail-send.md) |
-| 标星 / 已读 / 全部已读 / 待办 / 移动 / 逻辑删除 / 文件夹 / 撤回 | `mail run mail.star` / `mail.run mail.read.status` / `mail.run mail.read.all` / `mail.run mail.wait.add` / `mail.run mail.move.folder` / `mail.run mail.delete.move` / `mail.run mail.folder.create` / `mail.run mail.folder.delete` / `mail.run mail.recall` | [`mail-manage.md`](references/mail-manage.md) |
+| 标星 / 已读 / 全部已读 / 待办 / 移动 / 逻辑删除 / 文件夹 / 撤回 | `mail run mail.star` / `mail run mail.read.status` / `mail run mail.read.all` / `mail run mail.wait.add` / `mail run mail.move.folder` / `mail run mail.delete.move` / `mail run mail.folder.create` / `mail run mail.folder.delete` / `mail run mail.recall` | [`mail-manage.md`](references/mail-manage.md) |
 | 联系人 / 分组 | `mail run mail.contacts.*` | [`mail-contacts.md`](references/mail-contacts.md) |
 | 模板 | `mail run mail.template.*` | [`mail-template.md`](references/mail-template.md) |
 | 签名 / 二维码名片 | `mail run mail.sign.*` | [`mail-sign.md`](references/mail-sign.md) |
 | 黑名单 | `mail run mail.blacklist.*` | [`mail-blacklist.md`](references/mail-blacklist.md) |
-| 附件上传 / 下载 / 附件中心 | `mail run mail.attachment.upload` / `mail.run mail.attachment.download` / `mail.run mail.attachment.center` | [`mail-attachment.md`](references/mail-attachment.md) |
+| 附件上传 / 下载 / 附件中心 | `mail run mail.attachment.upload` / `mail run mail.attachment.download` / `mail run mail.attachment.center` | [`mail-attachment.md`](references/mail-attachment.md) |
 | 破坏性/缺口操作（已暂缓） | 无可用命令 | [`safety-boundaries.md`](references/safety-boundaries.md) |
 
 处理链：

package/skills/weaver-e10-meeting/SKILL.md

@@ -10,6 +10,8 @@ author: 泛微网络科技股份有限公司
 agent_created: true
 requires:
   bins: ["weaver-work-cli"]
+dependencies:
+  - weaver-e10-login
 cliHelp: "weaver-work-cli meeting --help"
 ---
 
@@ -21,6 +23,24 @@ cliHelp: "weaver-work-cli meeting --help"
 
 本 Skill 通过 `weaver-work-cli meeting` 命令调用真实 operation，不绕过 CLI 直接拼接口。
 
+## 适用场景（何时使用本技能）
+
+用户提到会议、会议室、预约/建会、会议冲突、改期/改地点/改参会人、取消/删除会议、回执、签到、会议类型或会议室占用视图时，使用本技能。
+
+用户要处理的是日程、审批流程或组织人员查询时，分别转 `weaver-e10-calendar` / `weaver-e10-workflow` / `weaver-e10-hrm`。
+
+## 认证与请求头契约
+
+登录与会话由 E10 登录能力统一提供：文档型约定为 `weaver-e10-login` 技能，本 CLI 场景下等价入口是 `weaver-work-cli auth ...` 命令体系。业务 Skill 不自建登录流程，不索取、打印或转存任何凭证。
+
+CLI 发往 E10 的每个请求都自动携带以下三项用户信息参数，**缺一不可**（业务入参里不要传这些字段，也不要手工拼装请求头）：
+
+```text
+Cookie: <登录返回的完整原始 Cookie 串，原样透传，禁止裁剪/去重/改写>
+eteamsid: <登录返回的 ETEAMSID>
+User-Agent: AgentType=<agentType>,IsAgent=true
+```
+
 ## 路由优先级
 
 1. 先判断用户意图是否属于会议域：会议、会议室、预约/建会、会议冲突、签到、回执、会议类型、占用视图。
@@ -103,4 +123,5 @@ cliHelp: "weaver-work-cli meeting --help"
 - **提前结束会议（meeting.over）不提供**：服务端接口为空实现（源码中 service 调用被注释、直接返回成功），调用只会得到"假成功"；请引导用户在系统页面操作，禁止绕过 CLI 自行拼接口。
 - EB 版业务链路（`query_mtDetail_list`、`create_meeting`、占用/回执/签到三件套、议题、纪要、报表）未随 v1 实现，见 manifest `withheldOperations`。
 - 周期会议走工作流（`repeatWorkFlowBaseIds` 非空）与 `onlyFlowCreate=1` 的流程建会需要工作流集成，CLI 会主动拒绝。
-- 签到二维码、签到写操作、会议室/类型管理、会议变更/取消/结束未实现。
+- 签到二维码、签到写操作、会议室/类型的增删改管理未实现（查询与占用可用，见命令表）。
+- 会议变更（`meeting.change.*`）与取消（`meeting.cancel.*`）**已实现**，按上文「处理链：变更 / 取消 / 删除会议」执行；只有「提前结束会议」不支持，见上一条。

package/skills/weaver-e10-okr/SKILL.md

@@ -0,0 +1,139 @@
+---
+name: weaver-e10-okr
+display_name: 泛微E10 OKR 目标管理
+display_name_en: Weaver E10 OKR
+description: "泛微E10 OKR 目标管理能力，覆盖目标分页查询、目标详情、关键成果查询与保存、目标对齐、目标评论、目标详情页链接，以及标准版与 ebuilder 双链路判定，通过 weaver-work-cli okr 命令执行。"
+description_zh: "泛微E10 OKR 目标管理能力，覆盖目标分页查询、目标详情、关键成果查询与保存、目标对齐、目标评论、目标详情页链接，以及标准版与 ebuilder 双链路判定，通过 weaver-work-cli okr 命令执行。"
+description_en: "Weaver E10 OKR capabilities, including goal list and detail queries, key results, goal alignment, goal comments, goal detail links, and standard/ebuilder link detection, delivered through the weaver-work-cli okr command."
+version: 1.0.0
+author: 泛微网络科技股份有限公司
+agent_created: true
+requires:
+  bins: ["weaver-work-cli"]
+dependencies:
+  - weaver-e10-login
+cliHelp: "weaver-work-cli okr --help"
+---
+
+# 泛微E10 OKR 目标管理
+
+**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)，其中包含安装、E10 认证、JSON 输出和高风险写入规则。若不存在则必须先执行 `weaver-work-cli skills install shared --target-dir <当前Agent的Skills目录>`，若 CLI 未安装则先执行 `npm install -g weaver-work-cli`，安装或读取失败时必须停止执行。**
+
+本技能覆盖 OKR 目标管理业务域：**目标分页查询**、**目标详情**、**关键成果查询与保存**、**目标对齐**、**目标评论**、**目标详情页链接**、**链路判定**。所有写操作（新建/编辑目标、保存关键成果、添加目标对齐）全部走 `prepare -> apply` 确认协议。
+
+## 认证与请求头契约
+
+登录与会话由 E10 登录能力统一提供：文档型约定为 `weaver-e10-login` 技能，本 CLI 场景下等价入口是 `weaver-work-cli auth ...` 命令体系。业务 Skill 不自建登录流程，不索取、打印或转存任何凭证。
+
+CLI 发往 E10 的每个请求都自动携带以下三项用户信息参数，**缺一不可**（业务入参里不要传这些字段，也不要手工拼装请求头）：
+
+```text
+Cookie: <登录返回的完整原始 Cookie 串，原样透传，禁止裁剪/去重/改写>
+eteamsid: <登录返回的 ETEAMSID>
+User-Agent: AgentType=<agentType>,IsAgent=true
+```
+
+## 命令入口
+
+```text
+weaver-work-cli okr --help
+weaver-work-cli okr schema
+weaver-work-cli --json okr run <operation> --input-json '{"key":"value"}'
+```
+
+`schema` 是可用能力的唯一事实来源。禁止把本技能或源文档里的接口路径当成可直接调用的地址，也禁止把未出现在 `schema` 中的能力当作可用 operation。
+
+高频便捷命令（等价于对应 operation 的薄包装）：
+
+```text
+weaver-work-cli okr route
+weaver-work-cli okr list --period-type 3 --period-range 2026-09
+weaver-work-cli okr get --id <目标ID>
+weaver-work-cli okr viewlink --ids <目标ID1>,<目标ID2>
+```
+
+## 认证
+
+所有请求复用 `weaver-work-cli` 托管的 E10 会话，业务输入只描述业务对象和意图。所有 `datajson` 结构接口的 `header.operator` 由 CLI 自动填充为当前登录用户，无需在输入中提供。
+
+凭证必须由 E10 命名凭据插件提供，由 `weaver-work-cli auth` 托管获取。禁止硬编码地址、账号、口令、Cookie、ETEAMSID 或其它会话凭据，禁止用浏览器自动化绕过登录流程，禁止读取、列出、打印或解析认证目录与文件。认证诊断只能通过 `weaver-work-cli auth` 系列命令、`weaver-work-cli doctor --e10` 和业务命令返回的 JSON 错误完成。
+
+## 链路判定（先做，再做业务）
+
+OKR 目标在不同租户走**两套互不兼容的接口链路**，由 `okr.version.check` 读取 `ver_name` 判定：
+
+- `ver_name >= V2` → **e10-ebuilder 链路**（`/api/ebuilder/form/formdata/v2/...`）。
+- 其它 / 版本接口不可用 → **e10 标准版链路**（`/api/workrelate/goal/...`、`/api/goal/common/comment/...`）。
+
+判定结果按租户缓存 1 天，命中缓存时不会重复请求版本接口。判定后严禁跨链路混用接口。细节见 [`references/okr-link-routing.md`](references/okr-link-routing.md)。
+
+## Reference 路由表
+
+命中任一条件时，执行下一步前读取对应 reference。
+
+| 触发条件 | Reference |
+| --- | --- |
+| 判断当前租户走标准版还是 ebuilder、链路判定结果异常、目标详情页链接打不开、需要 eb 表单 id | [`references/okr-link-routing.md`](references/okr-link-routing.md) |
+| 查目标列表、按周期/责任人/名称找目标、查目标详情、查关键成果列表、查目标评论、取详情页链接 | [`references/okr-query.md`](references/okr-query.md) |
+| 新建目标、修改目标（写，prepare→apply） | [`references/okr-write.md`](references/okr-write.md) |
+| 新建或修改关键成果（写，prepare→apply） | [`references/okr-keyresult.md`](references/okr-keyresult.md) |
+| 添加目标对齐（写，prepare→apply，仅 ebuilder 链路） | [`references/okr-align.md`](references/okr-align.md) |
+
+## 高优先级语义
+
+- **目标**：goal / OKR objective，用户常说「目标」「OKR」「年度目标」「月度目标」「部门目标」。
+- **关键成果**：key result / KR，是目标的子项，ebuilder 链路有独立接口，标准版链路随目标返回。
+- **目标对齐**：把当前目标挂到另一个目标之下，**仅 ebuilder 链路可用**。
+- **目标周期**：`period_type` 取 1-年度 / 2-季度 / 3-月度 / 4-自定义；`period_range` 格式随类型变化（年度/季度为 `yyyy`，月度为 `yyyy-MM`，自定义为 `开始日期,结束日期`）；季度还需 `period_quarter` 取 1-4。
+- **人员 ID**：`principalid`（责任人）、`partners`（参与人）必须传**人员 ID**（先通过 weaver-e10-hrm 解析姓名），不是姓名，禁止取 `userId` 字段。
+- **目标状态**：标准版 `status` 为 0-草稿 / 1-正式；ebuilder 用 `m_status`（1-进行中 2-已完成 3-已撤销 4-审批中 5-未开始）。
+
+## 关键业务规则（CLI 已内置）
+
+- **目标列表固定四列**：「目标名称、目标责任人名称、目标周期类型、目标周期范围」，且目标名称为可点击的详情页链接（绝对地址）。
+- **新建目标默认草稿**：标准版链路新建默认 `status=0`（保存草稿），不直接提交。
+- **编辑目标为全量合并**：`update.prepare` 先查询当前详情再合并用户修改；标准版链路必须显式传 `status`，避免把正式目标静默回退为草稿。
+- **ebuilder 新建默认值**：`m_status=1`（进行中）、`progress=0`。
+- **详情不直出评论正文**：`okr.get` 在标准版链路只返回评论总条数与「是否需要查看评论内容」的提示，正文必须由用户确认后再调 `okr.comment.list` 获取。
+- **链路专属能力明确报错**：eb 链路不支持按名称/状态筛选目标，标准版链路没有 `okr.kr.list`/`okr.align.create`，ebuilder 链路没有 `okr.comment.list`；CLI 会返回 `policy/link_unsupported` 或 `link_filter_unsupported`，不会静默忽略。
+
+## 处理链（写操作）
+
+新建/编辑目标、保存关键成果、添加目标对齐必须走 `prepare -> apply`：
+
+1. `prepare` 只归一化输入、按需查询当前数据（编辑时）、生成预览和 continuation，**不写入**。
+2. 向用户摘要目标、差异、风险。
+3. 用户明确确认后调用 `apply`，必须带 `confirm=true` 和 prepare 返回的 continuation。
+4. `apply` 遇到网络中断/不确定结果时返回 `partial/write_uncertain`，**禁止自动重试**，先做只读回查。
+
+## 失败处理
+
+- 遇到 `partial`、`write_uncertain`、登录失效、回查失败或网络中断，立即停止当前写流程，不自动重试写入。
+- 认证类错误（`authentication`/`session_expired`）：引导用户执行 `weaver-work-cli auth login`，不要用其他方式排查。
+- `policy/link_unsupported`：当前链路没有该能力，不要换接口硬试，按 reference 中的替代路径处理。
+- `validation/link_filter_unsupported`：ebuilder 链路列表不支持该筛选条件，改用 `query_scope=self` 或 `principalid` + 周期条件。
+- `validation/period_quarter_invalid`、`validation/scope_data_id_required`、`validation/principal_dept_required`：补齐周期/部门参数后重试 prepare。
+- 业务失败看 stderr JSON 的 `error.type` / `error.subtype` / `error.message`。
+
+## 不在范围
+
+- 人员「姓名 → 人员 ID」解析不在此技能内，交给 weaver-e10-hrm skill。
+- 目标分类、部门、岗位等组织字典查询不在此技能内，按需走对应业务 Skill。
+- 禁止绕过 CLI 直接 curl/fetch 访问 E10 接口。
+- 禁止把未出现在 `okr schema` 中的能力当作可用 operation。
+
+## 平台兼容
+
+命令示例同时兼容 Windows 与 macOS/Linux。简单 JSON 用 `--input-json`，复杂 JSON 存 UTF-8 文件后用 `--input <path>`。
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json okr run okr.list --input-json '{"period_type":"3","period_range":"2026-09","page_size":10}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+printf '%s\n' '{"period_type":"3","period_range":"2026-09","page_size":10}' | weaver-work-cli --json okr run okr.list --input -
+```

package/skills/weaver-e10-okr/references/okr-align.md

@@ -0,0 +1,59 @@
+# 目标对齐（okr-align）
+
+目标对齐用于把**当前目标**挂到**对齐目标**之下。该能力**仅 ebuilder 链路可用**——e10 标准版源资料没有提供对应接口，标准版租户调用会返回 `policy/link_unsupported`。
+
+| operation | 风险 | 作用 |
+| --- | --- | --- |
+| `okr.align.create.prepare` | read-before-write | 补全双方负责人、生成预览与 continuation，**不写入** |
+| `okr.align.create.apply` | high-risk-write | 提交添加目标对齐 |
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `current_id` | 目标 ID | 必填，当前目标 |
+| `align_obj_id` | 目标 ID | 必填，被对齐的目标 |
+| `cur_obj_principalid` | 人员 ID | 可选，当前目标负责人 |
+| `ali_obj_principalid` | 人员 ID | 可选，对齐目标负责人 |
+| `confirm` / `continuation` | - | 仅 `apply` 需要 |
+
+## 关键业务规则
+
+- **两个目标不能相同**：`current_id === align_obj_id` 时返回 `validation/align_invalid`。
+- **自动补全双方负责人**：未显式提供 `cur_obj_principalid`/`ali_obj_principalid` 时，`prepare` 会用目标详情接口分别取两个目标的负责人；任一取不到会返回 `validation/align_principal_unresolved`，此时需要显式传入人员 ID（由 weaver-e10-hrm 解析），**CLI 不会臆造负责人**。
+- `preview` 会展示当前目标/当前目标负责人/对齐目标/对齐目标负责人四项，确认前务必核对双方是否选反。
+
+## 确认链
+
+1. `okr.align.create.prepare` 返回 `preview` 与 `continuation`。
+2. 用户明确确认后调 `okr.align.create.apply`，传 `current_id`、`align_obj_id`、`confirm=true`、`continuation`。
+3. continuation 绑定 `baseUrl`/`profile`/`userId`，10 分钟有效；`current_id` 或内容指纹变化返回 `validation/target_changed`，需重新 prepare。
+
+## 调用示例
+
+准备对齐：
+
+```text
+weaver-work-cli --json okr run okr.align.create.prepare --input-json '{"current_id":"<当前目标ID>","align_obj_id":"<对齐目标ID>"}'
+```
+
+用户核对双方负责人后提交：
+
+```text
+weaver-work-cli --json okr run okr.align.create.apply --input-json '{"current_id":"<当前目标ID>","align_obj_id":"<对齐目标ID>","confirm":true,"continuation":"<prepare 返回的 continuation>"}'
+```
+
+显式指定双方负责人（详情接口取不到时）：
+
+```text
+weaver-work-cli --json okr run okr.align.create.prepare --input-json '{"current_id":"<当前目标ID>","align_obj_id":"<对齐目标ID>","cur_obj_principalid":"<人员ID>","ali_obj_principalid":"<人员ID>"}'
+```
+
+## 失败处理
+
+- `policy/link_unsupported` → 当前租户走标准版链路，没有目标对齐接口，不要换接口硬试。
+- 写入请求发出后连接中断 → `partial/write_uncertain`，禁止自动重试；先调 `okr.get`（或按 `okr.kr.list` 的方式）回查目标关系是否已建立。
+- 源资料只提供**添加**对齐的接口，没有解除对齐的 operation。
+
+## 注意
+
+- 确认前必须让用户看清「谁对齐谁」，`current_id` 是挂在下面的那两个之一，方向弄反需要重建关系。
+- 禁止手工构造或跨任务复用 continuation。

package/skills/weaver-e10-okr/references/okr-keyresult.md

@@ -0,0 +1,68 @@
+# 关键成果保存（okr-keyresult）
+
+关键成果（KR）的新建与修改共用一对 operation，**是否新建由有没有传 `kr_id` 决定**。
+
+| operation | 风险 | 作用 |
+| --- | --- | --- |
+| `okr.kr.save.prepare` | read-before-write | 归一化输入、生成预览与 continuation，**不写入** |
+| `okr.kr.save.apply` | high-risk-write | 提交关键成果保存（新建或修改） |
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `kr_id` | 关键成果 ID | **不传=新建，传了=修改** |
+| `object_id` | 目标 ID | 必填，关键成果所属目标 |
+| `name` | string | 关键成果名称，必填 |
+| `principalid` | 人员 ID | 责任人，默认当前登录用户 |
+| `participants` | 人员 ID 或数组 | 参与人（**仅标准版链路**） |
+| `target_value` | number | 目标值 |
+| `actual_value` | number | 实际值 |
+| `weight` | number | 权重 |
+| `progress` | number | 进度 0-100 |
+| `score` | number | 分数 |
+| `range` | `[开始,结束]` 或 `"开始,结束"` | 起止日期 `yyyy-MM-dd` |
+| `kr_unit` | string | 单位（**仅 ebuilder 链路**） |
+| `confidence` | number | 信心指数（**仅 ebuilder 链路**） |
+| `risk` | `"1"`/`"2"`/`"3"` | 风险指数：1-正常 2-有风险 3-已延期（**仅 ebuilder 链路**） |
+| `confirm` / `continuation` | - | 仅 `apply` 需要 |
+
+## 链路差异
+
+- **标准版链路**：写入 `/api/workrelate/goal/fs/krForm/saveForm` 的 `baseInfo`；新建不传 `id`，修改传 `id`。`kr_unit`/`confidence`/`risk` 属于 ebuilder 字段，被忽略后记入 `meta.notes`。
+- **ebuilder 链路**：按有无 `kr_id` 选择 `okr_createKeyResult` 或 `okr_updateKeyResult`；`participants` 属于标准版字段，被忽略后记入 `meta.notes`。
+
+## 确认链
+
+1. `okr.kr.save.prepare` 返回 `preview`（关键成果名称、所属目标、责任人、目标值/实际值、权重、起止日期、操作=新建或修改）与 `continuation`。
+2. 用户明确确认后调 `okr.kr.save.apply`，传 `confirm=true`、`continuation`，以及 `object_id` 与 `name`（schema 必需）。
+3. continuation 绑定 `baseUrl`/`profile`/`userId`，10 分钟有效；内容指纹变化返回 `validation/target_changed`，需重新 prepare。
+
+## 调用示例
+
+新建关键成果：
+
+```text
+weaver-work-cli --json okr run okr.kr.save.prepare --input-json '{"object_id":"<目标ID>","name":"后端接口开发","target_value":53,"actual_value":20,"weight":100,"progress":37,"range":["2026-01-01","2026-12-31"]}'
+```
+
+用户确认后提交：
+
+```text
+weaver-work-cli --json okr run okr.kr.save.apply --input-json '{"object_id":"<目标ID>","name":"后端接口开发","confirm":true,"continuation":"<prepare 返回的 continuation>"}'
+```
+
+修改已有关键成果（带 `kr_id`）：
+
+```text
+weaver-work-cli --json okr run okr.kr.save.prepare --input-json '{"kr_id":"<关键成果ID>","object_id":"<目标ID>","name":"后端接口开发","progress":80}'
+```
+
+## 失败处理
+
+- 写入请求发出后连接中断 → `partial/write_uncertain`，禁止自动重试；先通过 `okr.get`（标准版）或 `okr.kr.list`（ebuilder）复核。
+- ebuilder 链路要批量核对关键成果时，用 `okr.kr.list` 按 `object_id` 分页查询。
+
+## 注意
+
+- **源资料只提供关键成果的新建与编辑接口，没有删除接口**，因此 CLI 不提供删除关键成果的 operation，不要尝试拼接口。
+- `range` 传反（开始晚于结束）会被拒绝；`risk` 只接受 1/2/3。
+- 结果不确定时先只读回查，不要重放写请求。

package/skills/weaver-e10-okr/references/okr-link-routing.md

@@ -0,0 +1,67 @@
+# 链路判定与详情页链接（okr-link-routing）
+
+OKR 目标在不同租户使用**两套互不兼容的接口链路**。同一租户内只使用其中一条，判定结果由 CLI 按租户缓存，业务侧不应自行猜测链路。
+
+## 判定依据
+
+| 项 | 值 |
+| --- | --- |
+| 版本接口 | `POST /api/ebuilder/form/formdata/v2/getFormDataList/okr_searchAppver` |
+| 版本字段 | `datajson.datas[].mainTable.ver_name` |
+| 路由规则 | `ver_name >= V2` → ebuilder 链路；其它或接口不可用 → 标准版链路 |
+| 缓存 | 按租户隔离，key 前缀 `okr:version:`，有效期 1 天（86400 秒） |
+
+兼容 `V2` / `v2` / `V14` / `2` 等写法，只比较主版本号。
+
+### `okr.version.check`
+
+- 入参：`refresh`（boolean，默认 `false`）。`refresh=true` 时忽略缓存重新判定。
+- 返回：`link`（`standard` | `eb`）、`verName`、`tenantKey`、`cached`、`degraded`、`reason`、`checkedAt`、`versionInterface`。
+- **缓存只在真正拿到版本答案时写入**。标准版租户通常没有该 ebuilder 接口，此时接口报错会**降级为标准版链路**（`degraded=true`、`verName=null`、`reason` 说明原因），且**不写缓存**、不硬编码链路。
+
+便捷入口：`weaver-work-cli okr route`（`okr.version.check` 的薄包装，加 `--refresh` 忽略缓存）。
+
+## 两套链路的接口面
+
+| 能力 | 标准版链路 | ebuilder 链路 |
+| --- | --- | --- |
+| 目标分页查询 | `POST /api/workrelate/goal/getSearchList` | `POST /api/ebuilder/form/formdata/v2/getFormDataList/okr_pageQueryGoal` |
+| 目标详情 | `GET /api/workrelate/goal/getObjectDetail/{id}` | `POST /api/ebuilder/form/formdata/v2/getFormDataByPk/okr_queryGoal` |
+| 关键成果列表 | 随目标列表/详情返回（`keyresultList`） | `POST .../getFormDataList/okr_pageQueryGoalKeyResults` |
+| 关键成果保存 | `POST /api/workrelate/goal/fs/krForm/saveForm` | `POST .../saveFormData/okr_createKeyResult` / `.../updateFormData/okr_updateKeyResult` |
+| 目标评论 | `POST /api/goal/common/comment/commentPage` | **无接口** |
+| 目标对齐 | **无接口** | `POST .../saveFormData/okr_createGoalAlign` |
+| 新建 / 编辑目标 | `POST /api/workrelate/goal/create` / `/update` | `POST .../saveFormData/okr_createGoal` / `.../updateFormData/okr_updateGoal` |
+
+链路专属能力被调用时会返回 `policy/link_unsupported`，**不要换接口硬试**。
+
+## ebuilder 目标详情页表单 id
+
+ebuilder 链路的详情页地址形如 `/sp/ebdfpage/card/0/{okr目标详情eb表单id}/{目标id}`，其中的**表单 id 需要解析**：
+
+| 项 | 值 |
+| --- | --- |
+| 应用标签 appTag | `weaver-wr-goal-eb` |
+| 表单标签 formTag | `uf_wrgm_baseinfo` |
+| 解析步骤 | `GET /api/bs/ebuilder/app/tags/getAppIds?tag=<appTag>` → `GET /api/ebuilder/form/obj/getObjsByTag?tag=<formTag>&appId=<appId>` |
+| 已知固定租户 | 租户 `tqasclatif` 的 okr 目标详情表单 id 为 `1027322801024458753`，命中时跳过两步解析 |
+| 缓存 | 解析结果按租户长期缓存（key 前缀 `okr:ebform:`） |
+
+`okr.eb.form.resolve` 用于显式解析并返回该表单 id（仅 ebuilder 链路可用）。
+
+**表单 id 解析失败只影响链接，不影响主操作**：链接降级为 `null` 并写入 `warnings`（「目标详情页链接暂不可用」），绝不因此让主查询/主写入失败或被重试。
+
+## 详情页链接
+
+| operation | 用途 |
+| --- | --- |
+| `okr.viewlink` | 传入目标 ID（数组或英文逗号拼接字符串），返回 `path`（站内相对路径）与 `url`（绝对地址） |
+| `okr.detail.link` | 返回当前链路的地址模板，不含具体目标 id |
+
+标准版地址模板 `/sp/goal/openDetail?id={goalId}`；ebuilder 地址模板 `/sp/ebdfpage/card/0/{formId}/{goalId}`。
+
+## 注意
+
+- 本 reference 只说明判定与链接语义，**接口路径不是可直接调用的地址**；实际调用一律通过 `weaver-work-cli okr run <operation>`。
+- 链路判定结果来自租户实际版本，不要根据「客户是否上过 ebuilder」之类的经验臆断链路。
+- 同一次任务内如果需要多次操作，复用同一租户的判定结果即可，不必每次 `refresh`。