@microi.net/cli 5.5.9 → 5.6.0

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

@@ -1,216 +1,216 @@
----
-name: microi-codex-installer
-description: 当用户在 Codex、DeepSeek Harness、WorkBuddy、CodeBuddy、Qoder、Comate、Trae、Cursor、Claude Code 或其它 AI 编程软件中说“安装 @microi.net/cli”“初始化 Microi吾码插件”“添加吾码服务器/MCP”“拉取某连接的所有 V8 代码”，或要求安装、自动升级、启用、诊断吾码 AI 插件时使用。吾码 CLI、Codex/DSH 插件及既有工作区 AI/MCP 默认后台自动更新；失败只延后和提示，不得阻断任何工作。
----
-
-# Microi吾码 AI 插件与 CLI 安装
-
-本技能负责发现、安装、初始化、升级和诊断 Microi吾码 AI 开发能力。唯一 npm 包为 `@microi.net/cli`；该包同时提供 `microi` CLI、Codex Plugin、DeepSeek Harness 原生 profile bundle、WorkBuddy/CodeBuddy 兼容插件清单、完整 Skills 与同源 MCP。Codex marketplace 名称固定为 `microi-net`，插件选择器固定为 `microi@microi-net`，禁止新建 `microi-official` 或第二个 npm 包。
-
-只要本技能已经由 Microi.VSCode、工作区 `microi.skills` 或已安装插件提供，用户说“帮我初始化 Microi吾码插件”时就必须识别该意图，用户不需要再次说出 npm 包名。全新 Codex 与空目录尚未加载任何吾码 Skill 时，用户只需在首次请求中明确 `@microi.net/cli`，例如“通过 `@microi.net/cli` 安装吾码 Codex 插件”；具备终端与网络权限的 AI 必须直接执行本技能中的确定性安装命令。安装完成后，更短的“初始化吾码”“添加服务器/MCP”“拉取全部 V8”均由插件 Skill 自动识别。
-
-## 非阻塞自动更新（强制）
-
-只要当前宿主已装有 Microi VS Code 扩展、`@microi.net/cli`、Codex 插件或 DeepSeek Harness bundle，就应由宿主/CLI 在后台投递自动更新。更新检查与业务工作并行，绝不能成为分析、MCP 调用、源码修改、构建、测试、发布或新任务的前置门禁。
-
-自动更新只从 npm 官方 registry 读取 CLI 最新版：
-
-```bash
-npm view '@microi.net/cli' version --json --prefer-online --registry=https://registry.npmjs.org/
-```
-
-CLI、Codex 插件与工作区状态仍可用以下命令只读核对，但核对未完成不妨碍用户继续工作：
-
-```bash
-microi version --json
-microi codex status --json
-microi dsh status --json
-microi doctor --workspace "<工作区绝对路径>" --json
-```
-
-旧版 CLI 尚不支持 `microi version --json` 时，可使用 `npm list --global '@microi.net/cli' --depth=0 --json` 读取全局安装版本。`microi codex status --json` 的 `expectedVersion` 来自当前 CLI 自带快照，只检查本地一致性，不能代替 npm 在线查询。
-
-标准入口是非阻塞投递命令：
-
-```bash
-microi update --background --workspace "<工作区绝对路径>" --json
-```
-
-后台进程会依次检查/安装全局 CLI、幂等更新 Codex 插件与已存在 DSH 宿主的 profile bundle、执行 `microi ai init`、`microi doctor`、`microi codex status` 和 `microi dsh status`。`codex install --yes` 的 `--yes` 只保留给旧脚本兼容，不再表示必须先取得用户授权。VS Code 扩展同时使用官方扩展宿主的 `workbench.extensions.installExtension` / 自动更新机制；当前 Extension Host 不强制重载。
-
-当前运行中的扩展、CLI、Codex Router、DSH 会话与 MCP 必须继续使用已加载版本，禁止为了升级终止进程、强制重载窗口、结束对话或拒绝新任务。新版本写入版本隔离目录，只在后续新进程或宿主自然重启时接管。npm registry 不可用、版本无法解析、权限不足、文件被占用或安装失败时，写入 `~/.microi/updater/status.json` 并延后重试；可非模态提示“立即重试/查看日志”，但无论用户是否处理，当前、正在进行和新建工作都必须继续。禁止改用第三方 registry 或不明镜像冒充最新版。
-
-## 自然语言入口规则
-
-- 任一 AI 宿主开始处理 Microi吾码低代码、V8、MCP、表单/模块/流程、微应用或平台源码任务时，先判断当前任务是否已经提供 `microi` 的 Skills/MCP/CLI 能力。
-- 能力不明确时可立即做只读检测或后台投递 `microi update`，但不得等待检测/更新完成才开始用户工作。
-- 用户明确说“安装 `@microi.net/cli`”“初始化 Microi吾码插件”“添加服务器/MCP”或“拉取某连接全部 V8”时，直接执行确定性命令，不再询问“是否允许升级”。连接地址、帐号、密码以及远端业务写入仍遵守各自原有确认边界。
-- 普通 Microi 对话发现 CLI、Codex/DSH 插件、AI bundle 或 MCP 不是最新版时，自动更新并继续任务；如自动更新做不到，只给出不阻塞的重试提示，不得把升级选择变成继续工作的条件。
-- 用户关闭自动更新、忽略提示或暂不重载时，当前版本能力照常可用。只在任务确实依赖一个旧版本不存在的具体能力时，准确说明该能力边界并提供降级方案，不能用笼统“版本未通过”拒绝整个任务。
-
-## 检测
-
-需要诊断更新状态时，使用已经安装的 CLI 检查；这些命令是可观测性工具，不是业务门禁：
-
-```bash
-microi version --json
-microi codex status --json
-microi dsh status --json
-microi doctor --workspace "<工作区绝对路径>" --json
-```
-
-如果 `microi` 命令不存在，只可先运行不会下载包的本机只读检查：
-
-```bash
-codex plugin marketplace list
-codex plugin list
-```
-
-理想状态同时满足：
-
-- 全局 CLI、npm 官方最新版与 Codex 插件版本一致；
-- marketplace 为 `microi-net`；
-- `microi@microi-net` 显示 `installed, enabled`；
-- 已安装版本等于 CLI 内置 marketplace 的目标版本。
-- 插件路径位于 `microi-net-marketplace/plugins/microi`，且 `.codex-plugin/plugin.json` 的显示名为 `Microi吾码`。
-- DSH 已安装时，目标 profile 的依赖、`node_modules/@microi.net/cli` 版本、`cordis.patch.yml` 和 `dsh.profile.bundles` 激活项全部一致；DSH 未安装不是其它宿主的失败。
-- `doctor.coexistence.aiBundleVersion` 不低于当前 CLI，MCP provider 没有 `legacy` 或 `upgrade-available`；`newer-provider-preserved` 表示较新的 VS Code/CLI 提供者已被安全保留，可以通过。
-
-`microi-official` 和 `microi@microi-official` 仅是旧标识，不得写入新文档或新配置；安装器会在新版安装成功后迁移并清理旧标识。
-
-## 自动安装与手动恢复
-
-正常情况由 `microi update --background` 自动完成。需要人工立即恢复时，可直接把全局 CLI 更新到 npm 官方最新版：
-
-```bash
-npm install --global @microi.net/cli@latest
-microi codex install --yes
-microi dsh install
-```
-
-全局安装受宿主限制时可使用下面的临时执行方式；它不能证明一个既有旧版全局 CLI 已被升级：
-
-```bash
-npx --yes @microi.net/cli@latest codex install --yes
-```
-
-这条命令把 npm 仅作为下载通道：安装器会将包内完整 Codex Plugin 安全复制到当前用户的 `${CODEX_HOME:-~/.codex}/microi-net-marketplace/plugins/microi`，生成 Codex 官方支持的本地 marketplace，注册 `microi-net`，再安装并启用 `microi@microi-net`。完成并重载后，Codex 的“插件”页面必须显示 **Microi吾码**，来源为 **microi-net**。禁止重新写入 Codex 不支持的 `source: npm` marketplace 条目。
-
-在全新 Codex 的空目录中，以下自然语言必须等价执行上述命令，不得仅生成项目 Skill 后就声称 Codex Plugin 已安装：
-
-```text
-通过 @microi.net/cli@latest 安装吾码 Codex 插件。
-```
-
-`--yes` 仅兼容旧版无人值守脚本，安装器不再把它当作工作授权。只有版本不一致且普通安装不能升级、并确认目标 npm 包已经公开可读时，才使用：
-
-```bash
-microi codex install --yes --force
-```
-
-CLI、Codex 或 DSH 插件安装/升级完成后，后台幂等重新初始化当前工作区 AI 配置并更新 MCP，然后分别验收：
-
-```bash
-microi ai init --workspace "<工作区绝对路径>" --json
-microi doctor --workspace "<工作区绝对路径>" --json
-microi codex status --json
-microi dsh status --json
-```
-
-不得用单独的 `microi mcp init` 代替完整 AI 重新初始化；`ai init` 已默认包含 MCP 更新。只有诊断表明 MCP 仍有明确残留问题时，才追加 `microi mcp init` 做定向恢复。初始化写入采用幂等/原子方式，不终止已启动的 MCP；当前进程继续旧版本，新进程读取新版本。
-
-开发者从可信本地源码验收时，可以显式指定 marketplace 源：
-
-```bash
-microi codex install --yes --source <Microi.VSCode目录>
-```
-
-普通用户不得被引导到来历不明的 Git、本地目录或第三方 registry。不得通过 VPN、伪造地区/企业身份或共享账号绕过 OpenAI 地区与身份政策。
-
-## DeepSeek Harness 原生 Profile Bundle
-
-用户要求“安装吾码 DeepSeek Harness 插件”“让 DSH 支持吾码”时，在已安装官方 `@deepseek-ai/dsh` 且 `dsh`、`pnpm` 可用的前提下直接执行：
-
-```bash
-npx --yes @microi.net/cli@latest dsh install
-microi dsh status --json
-```
-
-安装器必须调用 DSH 官方 `dsh plugin --profile <name> add <package>` 协议。唯一包 `@microi.net/cli` 通过 `dsh.bundle.patch=./cordis.patch.yml` 贡献 `@deepseek-ai/dsh-mcp-client` 配置，禁止另建 npm 包，也禁止把 `.mcp.json` 写给 DSH 后声称已安装。默认安装官方 `web` 与 `headless` profile；指定单个 profile 使用 `--profile <名称>`。
-
-`status` 验收必须回读 `$DSH_HOME/profiles/<profile>/package.json`、安装包版本、bundle patch 与激活列表；工具入口应为 `mcp__microi__microi_codex`。安装后只说明“新 DSH 会话将加载”，不得终止或冒充热更新当前会话。开发者从可信源码验收使用 `microi dsh install --source <Microi.VSCode目录> --force`；普通用户只允许 npm 官方 registry 的精确版本。
-
-## 空工作区与多宿主初始化
-
-用户明确要求“初始化 Microi吾码插件/AI 配置”“添加吾码服务器并配置 MCP”时，该请求同时授权在其指定工作区生成吾码 AI 配置；如果还明确要求安装 Codex Plugin，则先按上一节完成全局插件安装。随后优先执行唯一包的初始化命令：
-
-```bash
-npx --yes @microi.net/cli@latest init --workspace <工作区>
-```
-
-用户还要求首次拉取全部 V8 与数据库结构时增加 `--pull`。用户已经全局安装 CLI 时改用：
-
-```bash
-microi init --workspace <工作区> --pull
-```
-
-`init` 必须能够在干净空目录中依次添加服务器连接、交互登录、生成 `microi.skills/`、`AGENTS.md`、`CLAUDE.md`、Copilot/Cursor/CodeBuddy 规则、CodeBuddy/Qoder/Comate 项目 Skill、typings、`jsconfig.json`，并配置 Codex、VS Code、Cursor、Trae、Claude Code、WorkBuddy、CodeBuddy、Qoder、Comate MCP。密码只允许隐式输入，禁止放入命令参数、对话记录或明文生成文件。Windows 需要静默恢复时，只能写入当前工作区 `Microi-V8-Engine/.microi-workspace-secrets.dpapi.json` 的 DPAPI CurrentUser 密文保险库；MCP 环境只保存该路径和 Key 名，保险库与同目录 Token 文件必须 Git-ignore。
-
-安装/升级后若 `microi doctor` 返回“Token 签名验证失败”，先区分验签密钥变化与 20 天到期。新版 MCP 会从工作区 DPAPI 保险库重载精确 Profile 的帐号密码并自动续登、更新 Token/MCP；不得删除全部 Profile、清空 Token 文件或要求用户反复手工输入。同一 `OsClient` 的多条 SaaS 运行记录必须由后端在 JWT 初始化前收敛到同一个 `AuthSecret`，否则更新后仍会反复失效。
-
-原生配置对应关系：
-
-- WorkBuddy：`.workbuddy/mcp.json`；保存并重载后可直接用自然语言调用 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`。
-- Trae：`AGENTS.md` 与 `.trae/mcp.json`；首次仍需开启项目级 MCP。
-- Codex：`AGENTS.md`、完整 Skills、项目及用户 `config.toml`；全局插件是可选增强。
-- DeepSeek Harness：读取 `AGENTS.md`，MCP 必须通过 `@microi.net/cli` 的原生 profile bundle 注入，不读取项目 `.mcp.json`。
-
-完成后运行：
-
-```bash
-microi doctor --workspace <工作区> --json
-```
-
-当前宿主不会热加载新 Skills/MCP 时，不要求用户立即重载；当前工作继续，用户自然新建任务、重载 Skills/MCP 或重启宿主后再验收新版能力。
-
-## 按服务器连接拉取全部 V8
-
-已有连接时先列出稳定标识：
-
-```bash
-microi profile list --workspace <工作区> --json
-```
-
-用户点名连接名称、OsClient、序号或 MCP 名称后执行：
-
-```bash
-microi pull --profile <连接名称、OsClient、序号或mcpName> --scope all --workspace <工作区>
-```
-
-`profile list --json` 会返回每个连接的稳定 `mcpName`（例如 `microi_demo`），CLI 可直接接受该值。存在同名租户或无法唯一匹配时必须让用户选择，禁止猜服务器。`--scope all` 包含接口引擎、表单事件与字段、模块按钮、工作流和数据库结构。
-
-## WorkBuddy 与 CodeBuddy 原生插件包
-
-`@microi.net/cli` 包根同时携带 `.workbuddy-plugin/plugin.json`、`.codebuddy-plugin/plugin.json`、对应 `marketplace.json`、根 `.mcp.json` 与全部 `skills/`。查看已安装包的真实路径：
-
-```bash
-microi plugin path --json
-```
-
-CodeBuddy CLI 可把该 `packageRoot` 作为本地 marketplace 添加，再安装 `microi@microi-net`；WorkBuddy 按其插件页面添加可信 marketplace，或从已安装包导入 Skill。插件安装、启用和重载属于宿主自身的信任边界：CLI 只生成包与项目配置，不伪造“已经在 UI 安装成功”。即使不安装宿主级插件，执行 `microi init` 后仍可通过项目 MCP、规则与 Skills 完成当前工作区开发。
-
-## 安装后验收
-
-再次执行：
-
-```bash
-microi codex status --json
-microi dsh status --json
-```
-
-返回 `ok: true` 且选择器、状态和版本全部正确时可报告安装完成；必要时再用 `codex plugin list` 核对路径。若宿主尚未热加载，只说明“新版将在下一次自然启动时生效”，不得要求用户立即新建任务或重载才能继续当前工作。
-
-若 npm 返回 `E404`，说明 `@microi.net/cli` 的目标版本尚未公开或仍在传播。不得删除仍可用的旧插件、不得重复发布同一不可变版本，也不得声称安装成功。
+---
+name: microi-codex-installer
+description: 当用户在 Codex、DeepSeek Harness、WorkBuddy、CodeBuddy、Qoder、Comate、Trae、Cursor、Claude Code 或其它 AI 编程软件中说“安装 @microi.net/cli”“初始化 Microi吾码插件”“添加吾码服务器/MCP”“拉取某连接的所有 V8 代码”，或要求安装、自动升级、启用、诊断吾码 AI 插件时使用。吾码 CLI、Codex/DSH 插件及既有工作区 AI/MCP 默认后台自动更新；失败只延后和提示，不得阻断任何工作。
+---
+
+# Microi吾码 AI 插件与 CLI 安装
+
+本技能负责发现、安装、初始化、升级和诊断 Microi吾码 AI 开发能力。唯一 npm 包为 `@microi.net/cli`；该包同时提供 `microi` CLI、Codex Plugin、DeepSeek Harness 原生 profile bundle、WorkBuddy/CodeBuddy 兼容插件清单、完整 Skills 与同源 MCP。Codex marketplace 名称固定为 `microi-net`，插件选择器固定为 `microi@microi-net`，禁止新建 `microi-official` 或第二个 npm 包。
+
+只要本技能已经由 Microi.VSCode、工作区 `microi.skills` 或已安装插件提供，用户说“帮我初始化 Microi吾码插件”时就必须识别该意图，用户不需要再次说出 npm 包名。全新 Codex 与空目录尚未加载任何吾码 Skill 时，用户只需在首次请求中明确 `@microi.net/cli`，例如“通过 `@microi.net/cli` 安装吾码 Codex 插件”；具备终端与网络权限的 AI 必须直接执行本技能中的确定性安装命令。安装完成后，更短的“初始化吾码”“添加服务器/MCP”“拉取全部 V8”均由插件 Skill 自动识别。
+
+## 非阻塞自动更新（强制）
+
+只要当前宿主已装有 Microi VS Code 扩展、`@microi.net/cli`、Codex 插件或 DeepSeek Harness bundle，就应由宿主/CLI 在后台投递自动更新。更新检查与业务工作并行，绝不能成为分析、MCP 调用、源码修改、构建、测试、发布或新任务的前置门禁。
+
+自动更新只从 npm 官方 registry 读取 CLI 最新版：
+
+```bash
+npm view '@microi.net/cli' version --json --prefer-online --registry=https://registry.npmjs.org/
+```
+
+CLI、Codex 插件与工作区状态仍可用以下命令只读核对，但核对未完成不妨碍用户继续工作：
+
+```bash
+microi version --json
+microi codex status --json
+microi dsh status --json
+microi doctor --workspace "<工作区绝对路径>" --json
+```
+
+旧版 CLI 尚不支持 `microi version --json` 时，可使用 `npm list --global '@microi.net/cli' --depth=0 --json` 读取全局安装版本。`microi codex status --json` 的 `expectedVersion` 来自当前 CLI 自带快照，只检查本地一致性，不能代替 npm 在线查询。
+
+标准入口是非阻塞投递命令：
+
+```bash
+microi update --background --workspace "<工作区绝对路径>" --json
+```
+
+后台进程会依次检查/安装全局 CLI、幂等更新 Codex 插件与已存在 DSH 宿主的 profile bundle、执行 `microi ai init`、`microi doctor`、`microi codex status` 和 `microi dsh status`。`codex install --yes` 的 `--yes` 只保留给旧脚本兼容，不再表示必须先取得用户授权。VS Code 扩展同时使用官方扩展宿主的 `workbench.extensions.installExtension` / 自动更新机制；当前 Extension Host 不强制重载。
+
+当前运行中的扩展、CLI、Codex Router、DSH 会话与 MCP 必须继续使用已加载版本，禁止为了升级终止进程、强制重载窗口、结束对话或拒绝新任务。新版本写入版本隔离目录，只在后续新进程或宿主自然重启时接管。npm registry 不可用、版本无法解析、权限不足、文件被占用或安装失败时，写入 `~/.microi/updater/status.json` 并延后重试；可非模态提示“立即重试/查看日志”，但无论用户是否处理，当前、正在进行和新建工作都必须继续。禁止改用第三方 registry 或不明镜像冒充最新版。
+
+## 自然语言入口规则
+
+- 任一 AI 宿主开始处理 Microi吾码低代码、V8、MCP、表单/模块/流程、微应用或平台源码任务时，先判断当前任务是否已经提供 `microi` 的 Skills/MCP/CLI 能力。
+- 能力不明确时可立即做只读检测或后台投递 `microi update`，但不得等待检测/更新完成才开始用户工作。
+- 用户明确说“安装 `@microi.net/cli`”“初始化 Microi吾码插件”“添加服务器/MCP”或“拉取某连接全部 V8”时，直接执行确定性命令，不再询问“是否允许升级”。连接地址、帐号、密码以及远端业务写入仍遵守各自原有确认边界。
+- 普通 Microi 对话发现 CLI、Codex/DSH 插件、AI bundle 或 MCP 不是最新版时，自动更新并继续任务；如自动更新做不到，只给出不阻塞的重试提示，不得把升级选择变成继续工作的条件。
+- 用户关闭自动更新、忽略提示或暂不重载时，当前版本能力照常可用。只在任务确实依赖一个旧版本不存在的具体能力时，准确说明该能力边界并提供降级方案，不能用笼统“版本未通过”拒绝整个任务。
+
+## 检测
+
+需要诊断更新状态时，使用已经安装的 CLI 检查；这些命令是可观测性工具，不是业务门禁：
+
+```bash
+microi version --json
+microi codex status --json
+microi dsh status --json
+microi doctor --workspace "<工作区绝对路径>" --json
+```
+
+如果 `microi` 命令不存在，只可先运行不会下载包的本机只读检查：
+
+```bash
+codex plugin marketplace list
+codex plugin list
+```
+
+理想状态同时满足：
+
+- 全局 CLI、npm 官方最新版与 Codex 插件版本一致；
+- marketplace 为 `microi-net`；
+- `microi@microi-net` 显示 `installed, enabled`；
+- 已安装版本等于 CLI 内置 marketplace 的目标版本。
+- 插件路径位于 `microi-net-marketplace/plugins/microi`，且 `.codex-plugin/plugin.json` 的显示名为 `Microi吾码`。
+- DSH 已安装时，目标 profile 的依赖、`node_modules/@microi.net/cli` 版本、`cordis.patch.yml` 和 `dsh.profile.bundles` 激活项全部一致；DSH 未安装不是其它宿主的失败。
+- `doctor.coexistence.aiBundleVersion` 不低于当前 CLI，MCP provider 没有 `legacy` 或 `upgrade-available`；`newer-provider-preserved` 表示较新的 VS Code/CLI 提供者已被安全保留，可以通过。
+
+`microi-official` 和 `microi@microi-official` 仅是旧标识，不得写入新文档或新配置；安装器会在新版安装成功后迁移并清理旧标识。
+
+## 自动安装与手动恢复
+
+正常情况由 `microi update --background` 自动完成。需要人工立即恢复时，可直接把全局 CLI 更新到 npm 官方最新版：
+
+```bash
+npm install --global @microi.net/cli@latest
+microi codex install --yes
+microi dsh install
+```
+
+全局安装受宿主限制时可使用下面的临时执行方式；它不能证明一个既有旧版全局 CLI 已被升级：
+
+```bash
+npx --yes @microi.net/cli@latest codex install --yes
+```
+
+这条命令把 npm 仅作为下载通道：安装器会将包内完整 Codex Plugin 安全复制到当前用户的 `${CODEX_HOME:-~/.codex}/microi-net-marketplace/plugins/microi`，生成 Codex 官方支持的本地 marketplace，注册 `microi-net`，再安装并启用 `microi@microi-net`。完成并重载后，Codex 的“插件”页面必须显示 **Microi吾码**，来源为 **microi-net**。禁止重新写入 Codex 不支持的 `source: npm` marketplace 条目。
+
+在全新 Codex 的空目录中，以下自然语言必须等价执行上述命令，不得仅生成项目 Skill 后就声称 Codex Plugin 已安装：
+
+```text
+通过 @microi.net/cli@latest 安装吾码 Codex 插件。
+```
+
+`--yes` 仅兼容旧版无人值守脚本，安装器不再把它当作工作授权。只有版本不一致且普通安装不能升级、并确认目标 npm 包已经公开可读时，才使用：
+
+```bash
+microi codex install --yes --force
+```
+
+CLI、Codex 或 DSH 插件安装/升级完成后，后台幂等重新初始化当前工作区 AI 配置并更新 MCP，然后分别验收：
+
+```bash
+microi ai init --workspace "<工作区绝对路径>" --json
+microi doctor --workspace "<工作区绝对路径>" --json
+microi codex status --json
+microi dsh status --json
+```
+
+不得用单独的 `microi mcp init` 代替完整 AI 重新初始化；`ai init` 已默认包含 MCP 更新。只有诊断表明 MCP 仍有明确残留问题时，才追加 `microi mcp init` 做定向恢复。初始化写入采用幂等/原子方式，不终止已启动的 MCP；当前进程继续旧版本，新进程读取新版本。
+
+开发者从可信本地源码验收时，可以显式指定 marketplace 源：
+
+```bash
+microi codex install --yes --source <Microi.VSCode目录>
+```
+
+普通用户不得被引导到来历不明的 Git、本地目录或第三方 registry。不得通过 VPN、伪造地区/企业身份或共享账号绕过 OpenAI 地区与身份政策。
+
+## DeepSeek Harness 原生 Profile Bundle
+
+用户要求“安装吾码 DeepSeek Harness 插件”“让 DSH 支持吾码”时，在已安装官方 `@deepseek-ai/dsh` 且 `dsh`、`pnpm` 可用的前提下直接执行：
+
+```bash
+npx --yes @microi.net/cli@latest dsh install
+microi dsh status --json
+```
+
+安装器必须调用 DSH 官方 `dsh plugin --profile <name> add <package>` 协议。唯一包 `@microi.net/cli` 通过 `dsh.bundle.patch=./cordis.patch.yml` 贡献 `@deepseek-ai/dsh-mcp-client` 配置，禁止另建 npm 包，也禁止把 `.mcp.json` 写给 DSH 后声称已安装。默认安装官方 `web` 与 `headless` profile；指定单个 profile 使用 `--profile <名称>`。
+
+`status` 验收必须回读 `$DSH_HOME/profiles/<profile>/package.json`、安装包版本、bundle patch 与激活列表；工具入口应为 `mcp__microi__microi_codex`。安装后只说明“新 DSH 会话将加载”，不得终止或冒充热更新当前会话。开发者从可信源码验收使用 `microi dsh install --source <Microi.VSCode目录> --force`；普通用户只允许 npm 官方 registry 的精确版本。
+
+## 空工作区与多宿主初始化
+
+用户明确要求“初始化 Microi吾码插件/AI 配置”“添加吾码服务器并配置 MCP”时，该请求同时授权在其指定工作区生成吾码 AI 配置；如果还明确要求安装 Codex Plugin，则先按上一节完成全局插件安装。随后优先执行唯一包的初始化命令：
+
+```bash
+npx --yes @microi.net/cli@latest init --workspace <工作区>
+```
+
+用户还要求首次拉取全部 V8 与数据库结构时增加 `--pull`。用户已经全局安装 CLI 时改用：
+
+```bash
+microi init --workspace <工作区> --pull
+```
+
+`init` 必须能够在干净空目录中依次添加服务器连接、交互登录、生成 `microi.skills/`、`AGENTS.md`、`CLAUDE.md`、Copilot/Cursor/CodeBuddy 规则、CodeBuddy/Qoder/Comate 项目 Skill、typings、`jsconfig.json`，并配置 Codex、VS Code、Cursor、Trae、Claude Code、WorkBuddy、CodeBuddy、Qoder、Comate MCP。密码只允许隐式输入，禁止放入命令参数、对话记录或明文生成文件。Windows 需要静默恢复时，只能写入当前工作区 `Microi-V8-Engine/.microi-workspace-secrets.dpapi.json` 的 DPAPI CurrentUser 密文保险库；MCP 环境只保存该路径和 Key 名，保险库与同目录 Token 文件必须 Git-ignore。
+
+安装/升级后若 `microi doctor` 返回“Token 签名验证失败”，先区分验签密钥变化与 20 天到期。新版 MCP 会从工作区 DPAPI 保险库重载精确 Profile 的帐号密码并自动续登、更新 Token/MCP；不得删除全部 Profile、清空 Token 文件或要求用户反复手工输入。同一 `OsClient` 的多条 SaaS 运行记录必须由后端在 JWT 初始化前收敛到同一个 `AuthSecret`，否则更新后仍会反复失效。
+
+原生配置对应关系：
+
+- WorkBuddy：`.workbuddy/mcp.json`；保存并重载后可直接用自然语言调用 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`。
+- Trae：`AGENTS.md` 与 `.trae/mcp.json`；首次仍需开启项目级 MCP。
+- Codex：`AGENTS.md`、完整 Skills、项目及用户 `config.toml`；全局插件是可选增强。
+- DeepSeek Harness：读取 `AGENTS.md`，MCP 必须通过 `@microi.net/cli` 的原生 profile bundle 注入，不读取项目 `.mcp.json`。
+
+完成后运行：
+
+```bash
+microi doctor --workspace <工作区> --json
+```
+
+当前宿主不会热加载新 Skills/MCP 时，不要求用户立即重载；当前工作继续，用户自然新建任务、重载 Skills/MCP 或重启宿主后再验收新版能力。
+
+## 按服务器连接拉取全部 V8
+
+已有连接时先列出稳定标识：
+
+```bash
+microi profile list --workspace <工作区> --json
+```
+
+用户点名连接名称、OsClient、序号或 MCP 名称后执行：
+
+```bash
+microi pull --profile <连接名称、OsClient、序号或mcpName> --scope all --workspace <工作区>
+```
+
+`profile list --json` 会返回每个连接的稳定 `mcpName`（例如 `microi_demo`），CLI 可直接接受该值。存在同名租户或无法唯一匹配时必须让用户选择，禁止猜服务器。`--scope all` 包含接口引擎、表单事件与字段、模块按钮、工作流和数据库结构。
+
+## WorkBuddy 与 CodeBuddy 原生插件包
+
+`@microi.net/cli` 包根同时携带 `.workbuddy-plugin/plugin.json`、`.codebuddy-plugin/plugin.json`、对应 `marketplace.json`、根 `.mcp.json` 与全部 `skills/`。查看已安装包的真实路径：
+
+```bash
+microi plugin path --json
+```
+
+CodeBuddy CLI 可把该 `packageRoot` 作为本地 marketplace 添加，再安装 `microi@microi-net`；WorkBuddy 按其插件页面添加可信 marketplace，或从已安装包导入 Skill。插件安装、启用和重载属于宿主自身的信任边界：CLI 只生成包与项目配置，不伪造“已经在 UI 安装成功”。即使不安装宿主级插件，执行 `microi init` 后仍可通过项目 MCP、规则与 Skills 完成当前工作区开发。
+
+## 安装后验收
+
+再次执行：
+
+```bash
+microi codex status --json
+microi dsh status --json
+```
+
+返回 `ok: true` 且选择器、状态和版本全部正确时可报告安装完成；必要时再用 `codex plugin list` 核对路径。若宿主尚未热加载，只说明“新版将在下一次自然启动时生效”，不得要求用户立即新建任务或重载才能继续当前工作。
+
+若 npm 返回 `E404`，说明 `@microi.net/cli` 的目标版本尚未公开或仍在传播。不得删除仍可用的旧插件、不得重复发布同一不可变版本，也不得声称安装成功。

package/skills/microi-codex-installer/agents/openai.yaml

@@ -1,7 +1,7 @@
-interface:
-  display_name: "Microi吾码 AI 插件安装"
-  short_description: "初始化吾码 CLI、Skills、MCP 与多宿主插件"
-  default_prompt: "使用 $microi-codex-installer 安装或初始化 @microi.net/cli，配置指定吾码服务器与 MCP，并按需拉取全部 V8 代码。"
-
-policy:
-  allow_implicit_invocation: true
+interface:
+  display_name: "Microi吾码 AI 插件安装"
+  short_description: "初始化吾码 CLI、Skills、MCP 与多宿主插件"
+  default_prompt: "使用 $microi-codex-installer 安装或初始化 @microi.net/cli，配置指定吾码服务器与 MCP，并按需拉取全部 V8 代码。"
+
+policy:
+  allow_implicit_invocation: true

package/skills/microi-datasource-mapping/SKILL.md

@@ -1,11 +1,11 @@
----
-name: microi-datasource-mapping
-description: Microi 选项类字段的数据源 Key/Value 映射规范。用于 Select、Radio、Checkbox、UniApp 枚举显示、KeyValue 配置、数据迁移和接口返回标签映射。
----
+---
+name: microi-datasource-mapping
+description: Microi 选项类字段的数据源 Key/Value 映射规范。用于 Select、Radio、Checkbox、UniApp 枚举显示、KeyValue 配置、数据迁移和接口返回标签映射。
+---
 
 > **Codex 非阻塞自动更新：** 当前宿主为 Codex 时，吾码 CLI、Codex 插件与工作区 AI/MCP 由后台自动更新；需要诊断时读取 `../microi-codex-installer/SKILL.md`。更新失败、等待空闲或尚未重载均不得阻断当前、正在进行或新建任务。非 Codex 宿主跳过此项。
-
-# microi-datasource-mapping — 数据源 Key/Value 映射规范
+
+# microi-datasource-mapping — 数据源 Key/Value 映射规范
 
 ## 一、后台字段数据源的两种模式
 
@@ -22,68 +22,68 @@ Microi 低代码平台中，`Select / Radio / Checkbox` 等选项组件支持两
 
 ## 二、移动端前端显示枚举值的规范
 
-移动端（UniApp）不应假定页面已经加载后台 `diy_field.Config`。优先由接口返回当前租户可用的 `Key/Value` 选项，或复用项目内的共享字典模块；只有不会被租户配置动态修改的协议枚举，才适合在前端维护映射函数：
+移动端（UniApp）不应假定页面已经加载后台 `diy_field.Config`。优先由接口返回当前租户可用的 `Key/Value` 选项，或复用项目内的共享字典模块；只有不会被租户配置动态修改的协议枚举，才适合在前端维护映射函数：
 
 ```js
 // ✅ 正确做法：手写完整的枚举映射
-function statusLabel(status) {
-  return ({
-    Draft: '草稿',
-    Enabled: '启用',
-    Disabled: '停用'
-  })[status] || status; // 未知值显示原始 key
-}
-
-// ✅ 动态选项：后端返回 [{ Key, Value }] 后建立映射
-export function createOptionLabel(options = []) {
-  const map = new Map(options.map(x => [String(x.Key), x.Value]));
-  return key => map.get(String(key ?? '')) || String(key ?? '');
-}
-```
-
-**原则**：
-- 映射函数兜底返回原始 key，方便发现新枚举值或配置漂移
-- **不要** 用 `|| '未知'` 作为兜底，否则后台新增类型后移动端会显示"未知"而不是英文 key（更难排查）
-- 租户可配置的 Select/Radio/Checkbox 选项不得复制成官方 Skill 中的固定业务字典
+function statusLabel(status) {
+  return ({
+    Draft: '草稿',
+    Enabled: '启用',
+    Disabled: '停用'
+  })[status] || status; // 未知值显示原始 key
+}
+
+// ✅ 动态选项：后端返回 [{ Key, Value }] 后建立映射
+export function createOptionLabel(options = []) {
+  const map = new Map(options.map(x => [String(x.Key), x.Value]));
+  return key => map.get(String(key ?? '')) || String(key ?? '');
+}
+```
+
+**原则**：
+- 映射函数兜底返回原始 key，方便发现新枚举值或配置漂移
+- **不要** 用 `|| '未知'` 作为兜底，否则后台新增类型后移动端会显示"未知"而不是英文 key（更难排查）
+- 租户可配置的 Select/Radio/Checkbox 选项不得复制成官方 Skill 中的固定业务字典
 
 ---
 
-## 三、历史遗留数据迁移
-
-从第三方数据库迁移枚举前，先用 `microi_inspect_external_database` 确认真实字段类型和说明，再用受限 `microi_query_external_database` 抽样唯一值。第三方显示文字不能直接成为吾码协议 Key；建立明确的“源值 -> 稳定 Key -> 展示 Value”映射，未识别值进入失败清单，禁止静默写成“未知”。持续同步应把映射版本写入任务配置，并保证同一源记录重投不会重复新增。
-
-当后台 Select 字段的 Key 发生变更时（如从英文 `Normal` 改为中文 `普通会员`），DB 中已存入的旧 key 不会自动更新。需要手动执行迁移：
+## 三、历史遗留数据迁移
+
+从第三方数据库迁移枚举前，先用 `microi_inspect_external_database` 确认真实字段类型和说明，再用受限 `microi_query_external_database` 抽样唯一值。第三方显示文字不能直接成为吾码协议 Key；建立明确的“源值 -> 稳定 Key -> 展示 Value”映射，未识别值进入失败清单，禁止静默写成“未知”。持续同步应把映射版本写入任务配置，并保证同一源记录重投不会重复新增。
+
+当后台 Select 字段的 Key 发生变更时（如从英文 `Normal` 改为中文 `普通会员`），DB 中已存入的旧 key 不会自动更新。需要手动执行迁移：
 
 ```js
 // 接口引擎：一次性数据迁移
-var affected = V8.Db.FromSql(
-  'UPDATE biz_member SET Level = @p0, UpdateTime = @p1 WHERE Level = @p2'
-)
-  .AddInParameter('@p0', 'NormalMember')
-  .AddInParameter('@p1', DateNow('yyyy-MM-dd HH:mm:ss'))
-  .AddInParameter('@p2', 'Normal')
-  .ExecuteNonQuery();
-return { Code: 1, Msg: '迁移完成，共更新 ' + affected + ' 条', Data: { Updated: affected } };
-```
-
-**最佳实践**：
-1. 执行前先 `SELECT COUNT(*)` 确认受影响行数
-2. 迁移接口默认 `StopHttp=1`，仅管理员可运行；保留版本和审计记录
-3. 新字段应从一开始就统一使用 Key≠Value 格式（英文 key + 中文 label），避免后续迁移
-
----
-
-## 四、租户与项目映射隔离
-
-官方 Skill 只维护平台通用机制，不记录任何客户名称、真实 `OsClient`、客户表名、接口 Key 或业务枚举。项目专有映射应保存在对应应用源码、租户私有配置或项目级 Skill 中，并遵循以下规则：
-
-1. 每个映射注明事实源（字段 KeyValue、数据源引擎或接口引擎）和更新时间。
-2. 动态选项优先实时读取；允许缓存时，缓存 Key 必须包含 `OsClient` 和配置版本。
-3. 后台字段配置修改后刷新字段/数据源缓存，前端不得长期保留另一份无版本的硬编码字典。
-4. 历史值兼容只放在受影响项目中；迁移完成后仍保留审计与回滚说明。
-5. 示例统一使用 `demo`、`biz_*` 等虚构名称，禁止把客户项目复制进官方文档、官方 Skill 或平台 AI 公共知识库。
-
----
+var affected = V8.Db.FromSql(
+  'UPDATE biz_member SET Level = @p0, UpdateTime = @p1 WHERE Level = @p2'
+)
+  .AddInParameter('@p0', 'NormalMember')
+  .AddInParameter('@p1', DateNow('yyyy-MM-dd HH:mm:ss'))
+  .AddInParameter('@p2', 'Normal')
+  .ExecuteNonQuery();
+return { Code: 1, Msg: '迁移完成，共更新 ' + affected + ' 条', Data: { Updated: affected } };
+```
+
+**最佳实践**：
+1. 执行前先 `SELECT COUNT(*)` 确认受影响行数
+2. 迁移接口默认 `StopHttp=1`，仅管理员可运行；保留版本和审计记录
+3. 新字段应从一开始就统一使用 Key≠Value 格式（英文 key + 中文 label），避免后续迁移
+
+---
+
+## 四、租户与项目映射隔离
+
+官方 Skill 只维护平台通用机制，不记录任何客户名称、真实 `OsClient`、客户表名、接口 Key 或业务枚举。项目专有映射应保存在对应应用源码、租户私有配置或项目级 Skill 中，并遵循以下规则：
+
+1. 每个映射注明事实源（字段 KeyValue、数据源引擎或接口引擎）和更新时间。
+2. 动态选项优先实时读取；允许缓存时，缓存 Key 必须包含 `OsClient` 和配置版本。
+3. 后台字段配置修改后刷新字段/数据源缓存，前端不得长期保留另一份无版本的硬编码字典。
+4. 历史值兼容只放在受影响项目中；迁移完成后仍保留审计与回滚说明。
+5. 示例统一使用 `demo`、`biz_*` 等虚构名称，禁止把客户项目复制进官方文档、官方 Skill 或平台 AI 公共知识库。
+
+---
 
 ## 五、接口引擎 OsClient 传递规范
 
@@ -100,11 +100,11 @@ function withOsClient(url) {
 }
 
 // 请求头中包含：
-// { OsClient: OS_CLIENT, Token: 'xxx', ... }
-
-// ❌ 不要在已经携带租户请求头时，再把租户写死到 URL
-// /apiengine/order-query--OsClient--demo--
-// 这种写法在路由匹配时可能出错，导致 404 或参数丢失
-```
-
-**结论**：`callEngine()` 系列函数已在请求头中传递 `OsClient` 时，无需在 URL 中重复传递。对于需要 query 参数识别租户的端点，使用运行期变量 `?OsClient=${encodeURIComponent(OS_CLIENT)}`，不得写死真实租户。
+// { OsClient: OS_CLIENT, Token: 'xxx', ... }
+
+// ❌ 不要在已经携带租户请求头时，再把租户写死到 URL
+// /apiengine/order-query--OsClient--demo--
+// 这种写法在路由匹配时可能出错，导致 404 或参数丢失
+```
+
+**结论**：`callEngine()` 系列函数已在请求头中传递 `OsClient` 时，无需在 URL 中重复传递。对于需要 query 参数识别租户的端点，使用运行期变量 `?OsClient=${encodeURIComponent(OS_CLIENT)}`，不得写死真实租户。