@microi.net/cli 6.3.0 → 6.3.3

package/skills/microi-codex-installer/SKILL.md

@@ -181,9 +181,54 @@ microi init --workspace <工作区> --pull
 
 安装/升级后若 `microi doctor` 返回“Token 签名验证失败”，先区分验签密钥变化与 20 天到期。新版 MCP 会从 Windows 工作区 DPAPI 保险库、macOS Keychain 或 Linux Secret Service 重载精确 Profile 的帐号密码并自动续登、更新 Token/MCP；不得删除全部 Profile、清空 Token 文件或要求用户反复手工输入。同一 `OsClient` 的多条 SaaS 运行记录必须由后端在 JWT 初始化前收敛到同一个 `AuthSecret`，否则更新后仍会反复失效。
 
+### WorkBuddy 原生注册与验收
+
+通用 `microi ai init` 生成项目规则、Skills 与多宿主配置，不代表 WorkBuddy 的原生连接器列表已出现吾码。开发工具 **6.3.3 起**，在 WorkBuddy 中明确初始化所选连接：
+
+```powershell
+microi profile list --workspace "<工作区绝对路径>" --json
+microi ai init --host workbuddy --profile <mcpName> --workspace "<工作区绝对路径>" --json
+microi doctor --host workbuddy --profile <mcpName> --workspace "<工作区绝对路径>" --json
+```
+
+已核对 WorkBuddy 5.9.3 原生提供者按 `WORKBUDDY_CONFIG_DIR`、应用 `runtimeContext.configDir`、系统用户目录 `~/.workbuddy` 的顺序确定配置根，读取其中的 `mcp.json`。CLI 看不到应用内部上下文时，只能按终端环境和用户目录解析候选路径；`doctor` 的路径不能替代应用 UI/日志的实际路径。两者不同时先校准宿主配置根，不能只检查项目 `.workbuddy/mcp.json` 就判断原生已注册。
+
+显式 `--host workbuddy` 只把所选 Profile 写入已确定的原生用户配置，保留其它服务、未知属性和已有 `disabled` 状态；不改 WorkBuddy 的审批存储或连接器凭据。后续宿主版本仍以实际配置路径、诊断和界面为准。
+
+`doctor --host workbuddy` 核对本机原生配置、启动文件及已有信任/禁用状态，不能证明远端连接或当前对话注入；两者仍需实际调用验证。不要把本机检查成功说成四项全部通过。
+
+遇到既有配置的编码拒绝时先保留原文件。只有整个文件恰好只含本次精确归属的单一连接，且无其它服务或未知根属性时，才可给同一条 `ai init --host workbuddy --profile ...` 命令显式追加 `--repair-workbuddy-encoding` 修复编码并回读；混合或无法确认归属的配置保持原样，不覆盖、不删除，也不借修复授予信任。
+
+验收至少分清以下四项；成功一项不能推断下一项：
+
+| 状态 | 所需证据 |
+|---|---|
+| 配置已生成 | 所选连接和原生配置路径、服务定义回读正确 |
+| 官方 CLI 已连通 | 同源 stdio 的 `initialize`、`tools/list` 与 `microi_get_status` 成功且身份正确 |
+| 宿主原生服务可用 | WorkBuddy 列表实际出现服务，未禁用且已由宿主信任 |
+| 当前对话已注入 | 当前对话真实发现入口并完成只读工具调用 |
+
+`~/.workbuddy/mcp-tool-list.json` 仅缓存工具名称和说明，不能当作服务注册或当前注入凭据。原生确报未信任时，由用户在 WorkBuddy 连接器/MCP 页面完成信任；明确禁用保持不变，不用 CLI 伪造审批。5.9.3 的 stdio 信任摘要包含 command、args、env **键名**和可选 cwd，env 值不参与；版本化启动参数改变可能需要再次信任，不能把普通环境变量值更新一律说成需要重新授权。只有真实宿主状态要求操作时才提出，不能让模型反复索要同一确认。
+
+### 当前对话没有吾码工具时继续工作
+
+按上方四项状态分别验收；WorkBuddy 先核对显式宿主初始化及原生列表。使用宿主真实的工具发现/刷新能力，同时查找原始 `microi_*` 和 `microi_codex` 单入口；发现单入口后通过 `profiles`、`list_tools`、`describe_tool` 调用，不能因没有展开全部原始工具就判断吾码不可用。工具数量以本次发现结果为准。
+
+原生入口仍未出现且宿主允许执行终端时，使用官方 CLI **6.3.2 起**提供的同源 MCP 通道继续当前任务；旧版缺少命令时先按上方官方更新流程升级：
+
+```powershell
+microi profile list --workspace "<工作区绝对路径>" --json
+microi mcp tools --profile <mcpName> --workspace "<工作区绝对路径>" --json
+'{}' | microi mcp call microi_get_status --params-stdin --profile <mcpName> --workspace "<工作区绝对路径>" --json
+```
+
+`mcp tools` 读取真实工具目录和参数 Schema；`mcp call <microi_tool> --params-stdin` 从标准输入读取严格 JSON 对象，无参数也传 `{}`。按返回的当前租户状态完成只读基线后，再调用业务工具；写入仍传原工具要求的 `confirmExecution`、版本/哈希及其它参数，保留授权、审计、回读与结果未知先核对规则。这个入口复用包内同源标准 stdio MCP，不要求 AI 手写桥接、复制 Token、直连 HTTP 或 SQL，也不改变连接四段身份。
+
+CLI 成功只证明官方调用通道可用，不能报告当前宿主已注册工具。明确禁用 MCP、权限/策略拒绝或终端不可用时，不用 CLI 绕过；仅报告实际失败层级及最小恢复动作。不能根据一句“没有工具”就断言 WorkBuddy 不支持热加载，更不能把 WorkBuddy 与千问工作助理混称；核对实际宿主、版本、配置和状态。只有宿主明确要求的信任/启用操作，或官方通道确实无法完成的步骤，才需要用户处理，不能把新开对话作为默认前置条件。
+
 原生配置对应关系：
 
-- WorkBuddy：`.workbuddy/mcp.json`；保存并重载后可直接用自然语言调用 MCP。
+- WorkBuddy：通用生成保留项目 `.workbuddy/mcp.json`；原生入口按上节显式 `--host workbuddy` 注册并回读用户配置，在宿主 MCP 页面核对真实连接及信任状态。
 - CodeBuddy：`.codebuddy/skills/microi/SKILL.md`、`.codebuddy/rules/microi.md` 与根 `.mcp.json`。
 - Qoder：`.qoder/skills/microi/SKILL.md`、`AGENTS.md` 与根 `.mcp.json`。
 - 百度 Comate：`.agents/skills/microi/SKILL.md`、`.comate/skills/microi/SKILL.md` 与 `.comate/mcp.json`。
@@ -197,7 +242,7 @@ microi init --workspace <工作区> --pull
 microi doctor --workspace <工作区> --json
 ```
 
-当前宿主不会热加载新 Skills/MCP 时，不要求用户立即重载；当前工作继续，用户自然新建任务、重载 Skills/MCP 或重启宿主后再验收新版能力。
+当前宿主尚未加载新 Skills/MCP 时，按上面的官方 CLI 通道继续已授权工作；用户自然新建任务、刷新 Skills/MCP 或重启宿主后，再独立验收原生工具是否可用。
 
 ## 按服务器连接拉取全部 V8
 
@@ -223,7 +268,7 @@ microi pull --profile <连接名称、OsClient、序号或mcpName> --scope all -
 microi plugin path --json
 ```
 
-CodeBuddy CLI 可把该 `packageRoot` 作为本地 marketplace 添加，再安装 `microi@microi-net`；WorkBuddy 按其插件页面添加可信 marketplace，或从已安装包导入 Skill。插件安装、启用和重载属于宿主自身的信任边界：CLI 只生成包与项目配置，不伪造“已经在 UI 安装成功”。即使不安装宿主级插件，执行 `microi init` 后仍可通过项目 MCP、规则与 Skills 完成当前工作区开发。
+CodeBuddy CLI 可把该 `packageRoot` 作为本地 marketplace 添加，再安装 `microi@microi-net`；WorkBuddy 按其插件页面添加可信 marketplace，或从已安装包导入 Skill。插件安装、启用和重载属于宿主自身的信任边界，不伪造“已经在 UI 安装成功”。不安装宿主级插件时仍可生成项目规则与 Skills；WorkBuddy 原生 MCP 另按上节指定 `--host workbuddy`，不能把通用初始化或 CLI 备用调用当成原生注册成功。
 
 ## 安装后验收