# @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.Code 同源的 MCP Server、连接/Token/同步协议；
- 支持多服务器、租户、产品类型和网络环境的 `microi_codex` 路由；
- 全套 Microi Skills 与 VS Code 命令覆盖矩阵。

## 安装与空工作区初始化

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

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

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

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

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

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

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

## 安装 Codex Plugin

```bash
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 会自动投递统一后台更新：

```bash
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` 可用时执行：

```bash
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.Code目录> --force` 验收。

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

## WorkBuddy / CodeBuddy 原生插件

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