@microi.net/cli 6.1.0 → 6.1.1

package/skills/message-notification/SKILL.md

@@ -139,7 +139,7 @@ await V8.Notification.MarkRead({ All: true });
 - `AfterServerRestart` 用可信后端进程启动标识和主租户当前运行分区的共享 Redis 最新批次计算 occurrence，`Presented` 按数据库稳定回执主键抢占领取资格；同帐号多页面只有一个领取，刷新和重新登录不再次弹出。展示成功前回执应已持久化；响应丢失以同一个页面 `EntryId` 恢复，不以 localStorage 作为事实源。`ShownAt` 与 `ClosedAt` 分离，当前已领取弹窗需保留到关闭、撤回或过期。
 - 超级管理员范围和重启频率的最低接收协议为 2；官方 feed 必须对协议 1 隐去此类公告，接收端出缓存后再次按当前身份裁剪。未知范围、异常协议或无法核验的启动批次失败关闭。重启频率不能再叠加周期计划；多节点滚动发布采用共享最新启动批次，验证负载切换不回退、不重复。
 - 定时任务 `platform-reminder-tick` 每分钟只发送唤醒信号；权威计划与回执保存在数据库。前端监听 `ReceivePlatformReminder` 后回读，SignalR 正常约 60 秒对账、断线约 15 秒轮询并对错误退避；关闭失败重试、撤回和过期收回，禁止使用本机定时器或 localStorage 作为已读事实源。
-- 跨服务器官方源由 `Microi.net` 固定请求 `api.itdos.com`，不允许任意 URL/重定向、不发送用户或密钥，按真实本地 License 筛选并缓存；官方源降级不得阻断本地提醒。匿名 feed 只暴露已发布的版本公告，不可读草稿、租户目标或回执。
+- 跨服务器官方源由 `Microi.net` 固定请求 `api.microi.net`，不允许任意 URL/重定向、不发送用户或密钥，按真实本地 License 筛选并缓存；官方源降级不得阻断本地提醒。匿名 feed 只暴露已发布的版本公告，不可读草稿、租户目标或回执。
 - 官方“消息通知”包单一拥有配置接口 `platform-message-notification-config`、三个提醒接口、四表六索引、统一菜单、每分钟任务与当前内置微服务产物；SaaS 包同步统一菜单、基础空库结构和旧布局退役声明。先更新支持 `DiyFieldRetirements` 的商城，再安装新版 SaaS 包，清理旧入口且保留业务数据。商城包的内置微服务版本需同步。导出母版可能不带物理索引，按已验证 Manifest 补独立 `CREATE INDEX`，由安装器幂等检查；禁止发布测试提醒、真实接收人或回执数据。
 - 共享微服务发布闭包还包含独立“系统日志/监控”包，不能只核对 SaaS、商城和消息通知。先读取相关商城选择清单与实际包，确认 `microi-platform-service` 的所有携带者；按 `platform-service-release.json` 校验同一版本、构建字节与路由。监控包从 `system-observability-package-source.json` 和当前共享运行包经 `configure-system-observability-package.mjs` 再生成，元数据变化要先合并官方母版并升独立包版本。发布前验证各包，安装全部平台应用后再验消息通知页面，避免后安装的旧运行包覆盖新页面；不能通过修改安装器的 Managed 覆盖语义规避。
 - MCP 复用 `microi_get_db_schema / microi_generate_system / microi_admin_table_data / microi_save_engine_code / microi_run_engine`，以及在线应用发现、源码同步和流式发布工具；入口调整使用 `microi_update_module / microi_update_table / microi_delete_field`，写后回读确认不存在旧入口。

package/skills/microi-client-frontend/SKILL.md

@@ -13,8 +13,8 @@ description: Microi.Client 源码架构指南。用于修改 Microi.Client Vue
 右上角授权类型优先读取公开启动配置 `SysConfig.PlatformEdition`，兼容旧版会话查询；
 `SysConfig.HideSystemLicenseVersion` 缺省关闭，标签可点击跳转 `/license`，不能因一次请求失败永久消失。
 
-<!-- microi-progressive:begin -->
-<!-- microi-progressive:chunk id=microi-client-frontend-000 sha256=9b949c68b0867fc1ecf2e6cb1fd1bec45d22c01ad3be63485e0376d0183d1795 -->
+<!-- microi-progressive:begin -->
+<!-- microi-progressive:chunk id=microi-client-frontend-000 sha256=9b949c68b0867fc1ecf2e6cb1fd1bec45d22c01ad3be63485e0376d0183d1795 -->
 ## 单行文本插槽按钮约定
 
 - `diy-input.vue` 的插槽按钮行为存储在 `diy_field.Config.SlotButtonV8Code`。
@@ -26,8 +26,8 @@ description: Microi.Client 源码架构指南。用于修改 Microi.Client Vue
 
 ---
 
-<!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=microi-client-frontend-001 sha256=fcc37635c7ac9b9e7054a5e9d76b71d5a53977170d25ae3049af95481eca4061 -->
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=microi-client-frontend-001 sha256=fcc37635c7ac9b9e7054a5e9d76b71d5a53977170d25ae3049af95481eca4061 -->
 ## 1. 技术栈和源码入口
 
 ### 详情评论、日志与版本的按需读取
@@ -59,8 +59,8 @@ description: Microi.Client 源码架构指南。用于修改 Microi.Client Vue
 
 ---
 
-<!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=microi-client-frontend-002 sha256=80fada0b0e3e878147bbdcb2017879611a5149324f5bc60cccfa42eb75f2135c -->
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=microi-client-frontend-002 sha256=80fada0b0e3e878147bbdcb2017879611a5149324f5bc60cccfa42eb75f2135c -->
 ## 2. 表单引擎三层结构
 
 ### 模块级跨端视图
@@ -187,8 +187,8 @@ description: Microi.Client 源码架构指南。用于修改 Microi.Client Vue
 
 ---
 
-<!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=microi-client-frontend-003 sha256=a3e2b822a3c2aacea83d3cae796132786e3be45f3a18ceb621c477b6bd1a2442 -->
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=microi-client-frontend-003 sha256=a3e2b822a3c2aacea83d3cae796132786e3be45f3a18ceb621c477b6bd1a2442 -->
 ## 4. 工作流与表单提交
 
 工作流相关文件：
@@ -209,8 +209,8 @@ description: Microi.Client 源码架构指南。用于修改 Microi.Client Vue
 
 ---
 
-<!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=microi-client-frontend-004 sha256=7dc3b1091176a98d652f042c30bc789f5ae6e5b9466ed75951d20ffa3e297a6a -->
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=microi-client-frontend-004 sha256=7dc3b1091176a98d652f042c30bc789f5ae6e5b9466ed75951d20ffa3e297a6a -->
 ## 7. 验证建议
 
 ### 本地 ApiBase 与 OsClient 解析（强制）
@@ -255,12 +255,12 @@ WebOS 直链容器不能只等旧版 `CallbackSysMenuModel` / `CallbackCurrentDi
 
 ---
 
-<!-- /microi-progressive:chunk -->
-## 详细参考路由（渐进披露）
-
-仅在当前任务涉及对应主题时读取；下列文件合计保留了原 SKILL.md 的全部详细知识。
-
-- [references/progressive-01-3-动态按钮系统.md](references/progressive-01-3-动态按钮系统.md)：3. 动态按钮系统；5. 路由与打开方式；6. 修改前必查清单
-- [references/progressive-02-8-运行时高频坑复盘.md](references/progressive-02-8-运行时高频坑复盘.md)：8. 运行时高频坑复盘；7.1 登录验证码与 Sys_Config；Microi 前端 SDK 约束
-- [references/progressive-03-vue3-前端微服务宿主规则.md](references/progressive-03-vue3-前端微服务宿主规则.md)：Vue3 前端微服务宿主规则；在线 AI 应用与微服务页面协作；浏览器访问密钥路由
-<!-- microi-progressive:end -->
+<!-- /microi-progressive:chunk -->
+## 详细参考路由（渐进披露）
+
+仅在当前任务涉及对应主题时读取；下列文件合计保留了原 SKILL.md 的全部详细知识。
+
+- [references/progressive-01-3-动态按钮系统.md](references/progressive-01-3-动态按钮系统.md)：3. 动态按钮系统；5. 路由与打开方式；6. 修改前必查清单
+- [references/progressive-02-8-运行时高频坑复盘.md](references/progressive-02-8-运行时高频坑复盘.md)：8. 运行时高频坑复盘；7.1 登录验证码与 Sys_Config；Microi 前端 SDK 约束
+- [references/progressive-03-vue3-前端微服务宿主规则.md](references/progressive-03-vue3-前端微服务宿主规则.md)：Vue3 前端微服务宿主规则；在线 AI 应用与微服务页面协作；浏览器访问密钥路由
+<!-- microi-progressive:end -->

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

@@ -1,233 +1,233 @@
----
-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.Agent、工作区 `microi.skills` 或已安装插件提供，用户说“帮我初始化 Microi吾码插件”时就必须识别该意图，用户不需要再次说出 npm 包名。全新 Codex 与空目录尚未加载任何吾码 Skill 时，用户只需在首次请求中明确 `@microi.net/cli`，例如“通过 `@microi.net/cli` 安装吾码 Codex 插件”；具备终端与网络权限的 AI 必须直接执行本技能中的确定性安装命令。安装完成后，更短的“初始化吾码”“添加服务器/MCP”“拉取全部 V8”均由插件 Skill 自动识别。
-
-## Microi Agent 桌面宿主
-
-- Microi Agent 是同仓独立桌面发行物，内置固定版本的 DeepSeek Harness SDK、Node.js、MCP / CLI / Skills；不是需要额外 Agent Token 的 CLI 别名。
-- 官方 AI 登录只走桌面账号窗口，固定 `https://api.microi.net`、`OsClient=iTdos`，使用当前用户的中转 Key 和额度。不要让用户把密码或 AI Key 写入对话、命令行、MCP 参数或模型配置。
-- 业务连接在「服务器连接」中单独添加、登录；官方 AI 账号不授予业务租户权限。项目初始化和资源同步优先使用桌面「项目资源」；其余业务继续调用同源 MCP 的原工具。
-- CLI 登录、`auth import --session-stdin` 与 MCP Token 恢复：Windows 使用 DPAPI，macOS 使用 Keychain；包含 Linux 支持的 CLI/MCP 使用 Secret Service，需要 `/usr/bin/secret-tool`、当前用户 D-Bus 和已解锁钥匙环。缺少时，CLI 写入/会话引用恢复给出 `MICROI_SECURE_STORAGE_UNAVAILABLE`，MCP 也可能报告凭据不可用，均不回退明文。核对正式包实际能力，源码或模拟 provider 测试不能代替 npm 发布及 Linux 实机验收。不要手改 Token 文件；导入后用 `doctor`、MCP `initialize`、`tools/list`、`microi_get_status` 回读。
-- 桌面安装包中的 Harness、Node 和同源资产随桌面版本升级；不运行 npm 自更新去改写正在使用或已签名的安装目录。外部 Codex / WorkBuddy / CLI 的后台更新规则保持不变。
-- 首次为浅色玻璃水纹，支持深色和自选主题色。停止或退出后的任务保留历史，当前 SDK 的跨进程历史仅供查看，需新建任务引用继续。
-
-## 非阻塞自动更新（强制）
-
-任意 AI 模型与宿主每次新建或接续吾码任务，都必须执行 [基础规范](../workspace-conventions/SKILL.md) 中的版本检查、首次“Microi吾码开发工具版本”播报与后台自动升级；不能因为用户只问业务问题就跳过。`@microi.net/cli` 必须自动升级到 npm 官方 `latest`，再同步 Skills、AI 规则和 MCP。具体播报、回读与失败边界以基础规范为唯一来源；本技能提供执行和诊断方法。
-
-只要当前宿主已装有 Microi VS Code 扩展、`@microi.net/cli`、Codex 插件或 DeepSeek Harness bundle，就应由宿主/CLI 在后台投递自动更新。更新检查与业务工作并行，绝不能成为分析、MCP 调用、源码修改、构建、测试、发布或新任务的前置门禁。
-
-自动更新只从 npm 官方 registry 读取 CLI 最新版：
-
-图形界面启动的 VS Code/Electron 可能没有终端 PATH。更新器必须发现用户安装的 Node/npm（Microi 用户目录、系统安装目录、Homebrew、nvm/Volta），优先用对应 Node 与 npm-cli.js 的绝对路径运行，并为 npm 子进程补齐 PATH。独立 Node 不继承 Electron 的 `ELECTRON_RUN_AS_NODE`，原 Electron 宿主执行 CLI 时保留它；不得从当前工作区查找并执行同名程序。缺少本机运行时应准确说明 Node/npm 未安装，不能误报 npm 官方 registry 不可访问；继续保留后台延后重试和不重载当前窗口规则。
-
-```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 在线查询。
-
-Codex/DSH 的 `microi_codex action="profiles"` 同时返回 `toolchain`：`loadedVersion` 是当前进程已加载的提供者版本，`workspaceSkillsVersion` 是当前工作区 Skills manifest 版本；`automaticUpdate` 包含启用状态、状态文件路径、`state`、`latestObservedVersion`、`globalVersion` 和 `checkedAt`。历史状态只作诊断，不能当成刚查询的官方最新版；`unknown`、`scheduled`、`running`、`deferred` 和 `completed-with-warnings` 均不能声称全部同步完成。状态文件损坏或缺失时保留当前能力并重新后台检查。
-
-标准入口是非阻塞投递命令：
-
-```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 --registry=https://registry.npmjs.org/
-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 ai init`，它默认包含 MCP 更新；旧版单独 `microi mcp init` 只配置连接，必须补 `ai init`。新版 MCP 初始化联动同一 AI 注入器，同时补齐 Skills 和宿主规则，仍保留用户自定义或已跟踪入口；不能把初始化成功解释为模型已读全部规则。开工应按基础规范回报实际读取的总控和完整清单。初始化写入采用幂等/原子方式，不终止已启动的 MCP；当前进程继续旧版本，新进程读取新版本。
-
-开发者从可信本地源码验收时，可以显式指定 marketplace 源：
-
-```bash
-microi codex install --yes --source <Microi.Agent目录>
-```
-
-普通用户不得被引导到来历不明的 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.Agent目录> --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。
-
-无 TTY 的宿主使用 `auth login --credentials-stdin` 安全注入原始 `{Username,Password}` JSON，已有独立会话使用 `auth import --session-stdin`；按精确 Profile 选择目标。密码保留原始空格，不得 trim，也不能进入 argv、源码或日志。普通非 TTY 密码提示会拒绝输入，不使用回显 readline。云平台不透明代理占位符不是原始密码：宿主若不支持原始秘密注入，或没有系统安全存储，应准确说明该边界，不能声称登录成功、伪造 Token 或写明文兼容补丁。
-
-安装/升级后若 `microi doctor` 返回“Token 签名验证失败”，先区分验签密钥变化与 20 天到期。新版 MCP 会从 Windows 工作区 DPAPI 保险库、macOS Keychain 或 Linux Secret Service 重载精确 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.Agent、工作区 `microi.skills` 或已安装插件提供，用户说“帮我初始化 Microi吾码插件”时就必须识别该意图，用户不需要再次说出 npm 包名。全新 Codex 与空目录尚未加载任何吾码 Skill 时，用户只需在首次请求中明确 `@microi.net/cli`，例如“通过 `@microi.net/cli` 安装吾码 Codex 插件”；具备终端与网络权限的 AI 必须直接执行本技能中的确定性安装命令。安装完成后，更短的“初始化吾码”“添加服务器/MCP”“拉取全部 V8”均由插件 Skill 自动识别。
+
+## Microi Agent 桌面宿主
+
+- Microi Agent 是同仓独立桌面发行物，内置固定版本的 DeepSeek Harness SDK、Node.js、MCP / CLI / Skills；不是需要额外 Agent Token 的 CLI 别名。
+- 官方 AI 登录只走桌面账号窗口，固定 `https://api.microi.net`、`OsClient=iTdos`，使用当前用户的中转 Key 和额度。不要让用户把密码或 AI Key 写入对话、命令行、MCP 参数或模型配置。
+- 业务连接在「服务器连接」中单独添加、登录；官方 AI 账号不授予业务租户权限。项目初始化和资源同步优先使用桌面「项目资源」；其余业务继续调用同源 MCP 的原工具。
+- CLI 登录、`auth import --session-stdin` 与 MCP Token 恢复：Windows 使用 DPAPI，macOS 使用 Keychain；包含 Linux 支持的 CLI/MCP 使用 Secret Service，需要 `/usr/bin/secret-tool`、当前用户 D-Bus 和已解锁钥匙环。缺少时，CLI 写入/会话引用恢复给出 `MICROI_SECURE_STORAGE_UNAVAILABLE`，MCP 也可能报告凭据不可用，均不回退明文。核对正式包实际能力，源码或模拟 provider 测试不能代替 npm 发布及 Linux 实机验收。不要手改 Token 文件；导入后用 `doctor`、MCP `initialize`、`tools/list`、`microi_get_status` 回读。
+- 桌面安装包中的 Harness、Node 和同源资产随桌面版本升级；不运行 npm 自更新去改写正在使用或已签名的安装目录。外部 Codex / WorkBuddy / CLI 的后台更新规则保持不变。
+- 首次为浅色玻璃水纹，支持深色和自选主题色。停止或退出后的任务保留历史，当前 SDK 的跨进程历史仅供查看，需新建任务引用继续。
+
+## 非阻塞自动更新（强制）
+
+任意 AI 模型与宿主每次新建或接续吾码任务，都必须执行 [基础规范](../workspace-conventions/SKILL.md) 中的版本检查、首次“Microi吾码开发工具版本”播报与后台自动升级；不能因为用户只问业务问题就跳过。`@microi.net/cli` 必须自动升级到 npm 官方 `latest`，再同步 Skills、AI 规则和 MCP。具体播报、回读与失败边界以基础规范为唯一来源；本技能提供执行和诊断方法。
+
+只要当前宿主已装有 Microi VS Code 扩展、`@microi.net/cli`、Codex 插件或 DeepSeek Harness bundle，就应由宿主/CLI 在后台投递自动更新。更新检查与业务工作并行，绝不能成为分析、MCP 调用、源码修改、构建、测试、发布或新任务的前置门禁。
+
+自动更新只从 npm 官方 registry 读取 CLI 最新版：
+
+图形界面启动的 VS Code/Electron 可能没有终端 PATH。更新器必须发现用户安装的 Node/npm（Microi 用户目录、系统安装目录、Homebrew、nvm/Volta），优先用对应 Node 与 npm-cli.js 的绝对路径运行，并为 npm 子进程补齐 PATH。独立 Node 不继承 Electron 的 `ELECTRON_RUN_AS_NODE`，原 Electron 宿主执行 CLI 时保留它；不得从当前工作区查找并执行同名程序。缺少本机运行时应准确说明 Node/npm 未安装，不能误报 npm 官方 registry 不可访问；继续保留后台延后重试和不重载当前窗口规则。
+
+```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 在线查询。
+
+Codex/DSH 的 `microi_codex action="profiles"` 同时返回 `toolchain`：`loadedVersion` 是当前进程已加载的提供者版本，`workspaceSkillsVersion` 是当前工作区 Skills manifest 版本；`automaticUpdate` 包含启用状态、状态文件路径、`state`、`latestObservedVersion`、`globalVersion` 和 `checkedAt`。历史状态只作诊断，不能当成刚查询的官方最新版；`unknown`、`scheduled`、`running`、`deferred` 和 `completed-with-warnings` 均不能声称全部同步完成。状态文件损坏或缺失时保留当前能力并重新后台检查。
+
+标准入口是非阻塞投递命令：
+
+```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 --registry=https://registry.npmjs.org/
+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 ai init`，它默认包含 MCP 更新；旧版单独 `microi mcp init` 只配置连接，必须补 `ai init`。新版 MCP 初始化联动同一 AI 注入器，同时补齐 Skills 和宿主规则，仍保留用户自定义或已跟踪入口；不能把初始化成功解释为模型已读全部规则。开工应按基础规范回报实际读取的总控和完整清单。初始化写入采用幂等/原子方式，不终止已启动的 MCP；当前进程继续旧版本，新进程读取新版本。
+
+开发者从可信本地源码验收时，可以显式指定 marketplace 源：
+
+```bash
+microi codex install --yes --source <Microi.Agent目录>
+```
+
+普通用户不得被引导到来历不明的 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.Agent目录> --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。
+
+无 TTY 的宿主使用 `auth login --credentials-stdin` 安全注入原始 `{Username,Password}` JSON，已有独立会话使用 `auth import --session-stdin`；按精确 Profile 选择目标。密码保留原始空格，不得 trim，也不能进入 argv、源码或日志。普通非 TTY 密码提示会拒绝输入，不使用回显 readline。云平台不透明代理占位符不是原始密码：宿主若不支持原始秘密注入，或没有系统安全存储，应准确说明该边界，不能声称登录成功、伪造 Token 或写明文兼容补丁。
+
+安装/升级后若 `microi doctor` 返回“Token 签名验证失败”，先区分验签密钥变化与 20 天到期。新版 MCP 会从 Windows 工作区 DPAPI 保险库、macOS Keychain 或 Linux Secret Service 重载精确 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-datasource-mapping/SKILL.md

@@ -60,6 +60,15 @@ export function createOptionLabel(options = []) {
 - 异步回填前核对表单实例、记录Id、依赖值和当前选择；换记录、换部门、改选后的迟到响应丢弃。失败不得伪造名称或清空已有业务关联。
 - 验收覆盖新增检索、编辑、只读详情、首屏外已有值、停用/越权关联和迟到响应；必须实际截图核对可读名称，不能仅看控件类型或接口返回成功。
 
+### 平台统一已选值补查
+
+- 标准 Select/MultipleSelect/Radio/Checkbox/Autocomplete 在列表、编辑、只读详情统一按已保存键补查，更新显示选项而不改表单值、不触发变更事件；树形控件沿用专用节点/祖先解析。仅旧客户端未具备此能力时才考虑上节项目级静默显示对象兼容，不把该兼容写回业务 Id。
+- 普通数据与 Key-Value 本地映射；SQL 由后端读取真实字段配置、校验所属表和字段可见性，保留原过滤条件，仅移除可识别的最外层候选排序/分页，再用参数化 IN 查询保存键和显示字段。禁止字符串拼接 Id、追加绕过资格条件的 OR、扫描所有分页或自动猜测复杂 SQL。
+- 自定义 API、接口引擎、数据源引擎必须先实现 `_ResolveSelectedValues:true`、`_SelectedValues` 数组的受控批量协议，返回 `DataAppend.SelectedValuesResolved:true`，再启用 `Config.SelectedValueLookup=true`。MCP `microi_build_field_config` 的 ApiEngine/DataSource 支持 `selectedValueLookup` 布尔值。旧响应不能冒充协议成功；停用、删除、无权访问和未知语法保留原 Id。
+- 单字段最多 200 值；单 SQL 批次最多 20 字段/500 值，并发 2；同字段/租户/用户/会话/记录/配置短期去重 30 秒。只补当前页缺失值，不建立跨用户永久字典。列表中依赖逐行 `$V8.Form.*` 的 SQL 需要显式安全解析，不能借用第一行上下文。
+- 列表只补实际展示列，同字段 JOIN 别名合并；直接保存显示值时不补查。回归必须覆盖单选/多选、Text/Json、存储/显示字段有无、普通/KV/SQL/引擎/API、本地/远程搜索、数值零、清空、只读和实际提交值，不能只测名称出现。
+- 验收覆盖非第一页 Id、同页重复 Id、多字段批量、搜索后保留、记录/会话切换迟到结果、异常降级及保存值不变。客户端单测不等于客户已部署；必须配套 API/前端并在真实路径回读。
+
 ## 三、历史遗留数据迁移
 
 从第三方数据库迁移枚举前，先用 `microi_inspect_external_database` 确认真实字段类型和说明，再用受限 `microi_query_external_database` 抽样唯一值。第三方显示文字不能直接成为吾码协议 Key；建立明确的“源值 -> 稳定 Key -> 展示 Value”映射，未识别值进入失败清单，禁止静默写成“未知”。持续同步应把映射版本写入任务配置，并保证同一源记录重投不会重复新增。

package/skills/microi-deployment/SKILL.md

@@ -98,7 +98,7 @@ System.Drawing.Common 的 .NET 10 支持库引用 System.Formats.Nrbf，Dos.Comm
 临时指定运行目标：
 
 ```text
-http://localhost:61500/?OsClient=iTdos&ApiBase=https%3A%2F%2Fapi.itdos.com
+http://localhost:61500/?OsClient=iTdos&ApiBase=https%3A%2F%2Fapi.microi.net
 ```
 
 URL 的 `ApiBase`、`OsClient` 优先级最高，但不会隔离同源 localStorage/Pinia/Token。多个 AI