@microi.net/cli — Microi吾码 CLI + 多宿主 AI Plugin

@microi.net/cli 是 Microi吾码唯一的 AI/npm 产品，同时提供：

• 全局命令 microi；
• Codex Plugin、DeepSeek Harness 原生 profile bundle，以及 WorkBuddy/CodeBuddy 兼容 plugin 与 marketplace 清单；
• 与 Microi.VSCode 同源的 MCP Server、连接/Token/同步协议；
• 支持多服务器、租户、产品类型和网络环境的 microi_codex 路由；
• 全套 Microi Skills 与 VS Code 命令覆盖矩阵。

安装与空工作区初始化

npm install -g @microi.net/cli
microi init --workspace <工作区> --pull

未全局安装时，也可以一次执行：

npx --yes @microi.net/cli@latest init --workspace <工作区> --pull

命令会引导添加服务器、登录、生成 AI 指令/Skills/类型提示，并同时配置 Codex、VS Code、Cursor、Trae、Claude Code、WorkBuddy、CodeBuddy、Qoder、Comate MCP；密码仅在当前进程中隐式输入，不写入命令参数或配置文件。

在这些 AI 软件的空工作区中，可以直接说：

安装 @microi.net/cli@latest，初始化 Microi吾码插件；添加指定服务器和 MCP，登录后拉取该连接的所有 V8 代码。

初始化会生成 .workbuddy/mcp.json、根 .mcp.json、.comate/mcp.json，以及 CodeBuddy/Qoder/Comate 项目 Skill。当前会话不支持热加载时继续使用已加载版本，新版在下一次自然启动时生效。

安装 Codex Plugin

microi version --json
microi codex status --json
microi codex install --yes

marketplace 固定为 microi-net，插件选择器固定为 microi@microi-net。安装器会迁移旧的 microi-official 标识，以及曾指向 @microi.net/codex-plugin 的吾码 marketplace 文件。安装不终止当前 Codex Router，新版在后续新进程中生效。

全新 Codex 的空目录中可直接对 AI 说“通过 @microi.net/cli@latest 安装吾码 Codex 插件”。AI 应执行 npx --yes @microi.net/cli@latest codex install --yes：npm 仅负责下载，安装器将本包完整复制到 ${CODEX_HOME:-~/.codex}/microi-net-marketplace/plugins/microi，生成官方支持的本地 marketplace 并安装启用插件。Codex 下次自然启动后，插件页显示 Microi吾码，来源为 microi-net。

Codex Router、VS Code 扩展与 CLI 会自动投递统一后台更新：

microi update --background --workspace "<工作区绝对路径>" --json

更新器只使用 npm 官方 registry，并自动升级 CLI、Codex/DeepSeek Harness 插件、AI 指令、Skills 与 MCP。当前进程继续使用旧版本；断网、权限不足、文件占用或安装失败只会延后重试和非阻塞提示，不影响当前、正在进行或新建工作。

本 npm 包根目录本身就是有效的 Codex Plugin。发布到 npm 只完成 CLI 下载与用户本地 marketplace 安装能力，不代表已经进入 ChatGPT/Codex 通用公开插件目录；公开目录仍需按 OpenAI 官方流程提交审核。

安装 DeepSeek Harness Plugin

DeepSeek Harness 已安装且 dsh、pnpm 可用时执行：

microi dsh status --json
microi dsh install

默认幂等安装到 DSH 官方 web 与 headless profile；也可用 --profile <名称> 指定一个 profile。本包通过 dsh.bundle.patch 和 cordis.patch.yml 接入官方 @deepseek-ai/dsh-mcp-client，不是向 DSH 写入无效的 .mcp.json。安装后新建 DSH 会话，工具入口为 mcp__microi__microi_codex。开发源码可用 microi dsh install --source <Microi.VSCode目录> --force 验收。

后台更新会在检测到 DSH 时自动幂等升级 bundle；DSH 或 pnpm 不存在、网络失败时只记录延后状态，不影响其它宿主和当前任务。

WorkBuddy / CodeBuddy 原生插件

包根同时包含 .workbuddy-plugin/、.codebuddy-plugin/、.mcp.json 和全部 skills/。运行 microi plugin path --json 可取得本机真实包根与清单路径，供 WorkBuddy 插件页或 CodeBuddy 本地 marketplace 导入。宿主自身的安装、启用和工作区信任仍需由用户授权，CLI 不伪造 UI 安装状态。