@microi.net/cli 4.7.9 → 4.8.2

package/{dist → scripts}/microi-skills.meta.json

@@ -1,13 +1,13 @@
 {
-  "builtAt": "2026-08-08T09:08:20.068Z",
+  "builtAt": "2026-08-08T11:49:31.593Z",
   "source": "../microi.skills",
   "extension": {
     "name": "v8-engine",
-    "version": "4.7.9",
+    "version": "4.8.2",
     "publisher": "Microi"
   },
   "skills": {
-    "version": "4.7.9",
+    "version": "4.8.2",
     "versionRule": "Microi version uses three numeric parts. Each publish increments the last part; when a part exceeds 9 it carries to the previous part: 1.0.9 -> 1.1.0, 1.9.9 -> 2.0.0.",
     "managedBy": "Microi.VSCode/bump-version.js"
   },
@@ -15,10 +15,10 @@
     "dir": "dist/microi.skills",
     "files": 107,
     "skills": 59,
-    "bytes": 1643866
+    "bytes": 1648038
   },
   "fileHashes": {
-    ".microi-skills-version.json": "9f0539ef87377b8b25d6b90348e88dcc3e4214a714ab02a3deb5560d01766885",
+    ".microi-skills-version.json": "b5e58175f8246a1f563204db643b010a417b66c0f5360195a1f4d59f6d0bd612",
     "README.md": "0dfd14a1657650999948056d15edf4440abb2ac0c3147e3e65768937315a6611",
     "ai-engine/SKILL.md": "371b00ce9860d1516f6eb7eeaed001cbfa852c52e7c0cfccbedc4a71a113e568",
     "ai-engine/agents/openai.yaml": "40deb07801006a46b9a7f0020d13251955eeadd04c8e591160210479936f8b5b",
@@ -39,8 +39,8 @@
     "microi-ai-application/agents/openai.yaml": "d3dfc4d0f2fda3391e90e661ca9d8d051cb43824b011d1a88e99db135870454f",
     "microi-ai-application/references/frontend-baseline.md": "c21a2d38292fd8d445a7538afb45d609881f624f32d39c0fc4bbbb3c2fa64a74",
     "microi-client-frontend/SKILL.md": "8e9f3392bb94c74d43b252cc9238b6ea38742a3ee8403d241643e738edcac899",
-    "microi-codex-installer/SKILL.md": "04c964396ce941b402bf4ac7846a85e7b0d9a1b34ca90848e803bd6b1ec7f14e",
-    "microi-codex-installer/agents/openai.yaml": "45b8c906902252b761b49e395b63746d31f784d3067f7295196c5497a7e1ffe0",
+    "microi-codex-installer/SKILL.md": "731eb415155b448f8411ee50c85e963aa47a8542c35af338d32ccc9d06dff330",
+    "microi-codex-installer/agents/openai.yaml": "e531219b74a70204893a156b1c22c69013a4c9d24b132ead912746b1b312cf80",
     "microi-datasource-mapping/SKILL.md": "1626bdf242038838028aa1235c5a6262e22680984583c47a8fc4e5fffb24b7df",
     "microi-db-schema/SKILL.md": "2e4dfd98d7e10bad0e8f68682725e88ebbaa5518bc548f8780685e2cd248defd",
     "microi-db-schema/agents/openai.yaml": "c725a2be4c904472f9e46dc4b49aa642c9f3a4437c91a28ba7cc27167497ede7",
@@ -127,113 +127,113 @@
     "workspace-conventions/SKILL.md": "051287e956466b2ebe6bb3c3fb30842ce8ac4bb470adcbb1212cc8d13087d9f1"
   },
   "fileVersions": {
-    ".microi-skills-version.json": "4.7.9",
-    "README.md": "4.7.9",
-    "ai-engine/SKILL.md": "4.7.9",
-    "ai-engine/agents/openai.yaml": "4.7.9",
-    "app-store/SKILL.md": "4.7.9",
-    "app-store/agents/openai.yaml": "4.7.9",
-    "business-blueprint/SKILL.md": "4.7.9",
-    "datasource-engine/SKILL.md": "4.7.9",
-    "datasource-engine/agents/openai.yaml": "4.7.9",
-    "dos-orm/SKILL.md": "4.7.9",
-    "dos-orm/references/api-reference.md": "4.7.9",
-    "job-engine/SKILL.md": "4.7.9",
-    "job-engine/agents/openai.yaml": "4.7.9",
-    "message-notification/SKILL.md": "4.7.9",
-    "message-notification/agents/openai.yaml": "4.7.9",
-    "message-notification/references/contracts.md": "4.7.9",
-    "microi-ai-app-auth.js": "4.7.9",
-    "microi-ai-application/SKILL.md": "4.7.9",
-    "microi-ai-application/agents/openai.yaml": "4.7.9",
-    "microi-ai-application/references/frontend-baseline.md": "4.7.9",
-    "microi-client-frontend/SKILL.md": "4.7.9",
-    "microi-codex-installer/SKILL.md": "4.7.9",
-    "microi-codex-installer/agents/openai.yaml": "4.7.9",
-    "microi-datasource-mapping/SKILL.md": "4.7.9",
-    "microi-db-schema/SKILL.md": "4.7.9",
-    "microi-db-schema/agents/openai.yaml": "4.7.9",
-    "microi-db-schema/references/core-tables.md": "4.7.9",
-    "microi-db-schema/references/form-component-options.md": "4.7.9",
-    "microi-db-schema/references/schema-overview.md": "4.7.9",
-    "microi-db-schema/references/schema.md": "4.7.9",
-    "microi-db-schema/references/table-catalog.md": "4.7.9",
-    "microi-deployment/SKILL.md": "4.7.9",
-    "microi-deployment/references/deployment-matrix.md": "4.7.9",
-    "microi-docs-coverage/SKILL.md": "4.7.9",
-    "microi-docs-coverage/references/capability-map.md": "4.7.9",
-    "microi-docs-coverage/scripts/audit-doc-skill-coverage.mjs": "4.7.9",
-    "microi-form-engine/SKILL.md": "4.7.9",
-    "microi-form-engine/references/component-catalog.md": "4.7.9",
-    "microi-form-engine/references/data-source-events.md": "4.7.9",
-    "microi-form-layout/SKILL.md": "4.7.9",
-    "microi-frontend-sdk/SKILL.md": "4.7.9",
-    "microi-left-right-layout/SKILL.md": "4.7.9",
-    "microi-microservice/SKILL.md": "4.7.9",
-    "microi-microservice/references/runtime-delivery.md": "4.7.9",
-    "microi-mobile-app-quality/SKILL.md": "4.7.9",
-    "microi-solution-quotation/SKILL.md": "4.7.9",
-    "microi-solution-quotation/agents/openai.yaml": "4.7.9",
-    "microi-solution-quotation/scripts/build_solution_quote.py": "4.7.9",
-    "microi-system-delivery/SKILL.md": "4.7.9",
-    "microi-ui/SKILL.md": "4.7.9",
-    "microi-uniapp-frontend/SKILL.md": "4.7.9",
-    "microi.v8.js": "4.7.9",
-    "module-engine/SKILL.md": "4.7.9",
-    "module-engine/references/module-config.md": "4.7.9",
-    "ocr-engine/SKILL.md": "4.7.9",
-    "ocr-engine/agents/openai.yaml": "4.7.9",
-    "page-engine/SKILL.md": "4.7.9",
-    "performance-testing/SKILL.md": "4.7.9",
-    "playwright-e2e/SKILL.md": "4.7.9",
-    "print-engine/SKILL.md": "4.7.9",
-    "production-readonly-audit/SKILL.md": "4.7.9",
-    "report-engine/SKILL.md": "4.7.9",
-    "report-engine/agents/openai.yaml": "4.7.9",
-    "search-engine/SKILL.md": "4.7.9",
-    "search-engine/agents/openai.yaml": "4.7.9",
-    "spider-engine/SKILL.md": "4.7.9",
-    "translate-engine/SKILL.md": "4.7.9",
-    "translate-engine/agents/openai.yaml": "4.7.9",
-    "ui-design/SKILL.md": "4.7.9",
-    "ui-design/assets/pattern-showcase/app.js": "4.7.9",
-    "ui-design/assets/pattern-showcase/index.html": "4.7.9",
-    "ui-design/assets/pattern-showcase/styles.css": "4.7.9",
-    "ui-design/assets/templates/MCI-DESIGN.md": "4.7.9",
-    "ui-design/references/design-pattern-library.md": "4.7.9",
-    "ui-design/references/mci-design-contract.md": "4.7.9",
-    "ui-design/references/motion-and-media.md": "4.7.9",
-    "ui-design/references/product-flow-recipes.md": "4.7.9",
-    "uniapp-mall-assets/SKILL.md": "4.7.9",
-    "v8-api-config/SKILL.md": "4.7.9",
-    "v8-cache-pattern/SKILL.md": "4.7.9",
-    "v8-crud-api/SKILL.md": "4.7.9",
-    "v8-debugging/SKILL.md": "4.7.9",
-    "v8-explorer-tree/SKILL.md": "4.7.9",
-    "v8-export-import/SKILL.md": "4.7.9",
-    "v8-file-upload/SKILL.md": "4.7.9",
-    "v8-formengine-http/SKILL.md": "4.7.9",
-    "v8-frontend-events/SKILL.md": "4.7.9",
-    "v8-frontend-events/references/bluetooth-print-api.md": "4.7.9",
-    "v8-frontend-events/references/bluetooth-print.md": "4.7.9",
-    "v8-http-integration/SKILL.md": "4.7.9",
-    "v8-image-processing/SKILL.md": "4.7.9",
-    "v8-image-processing/agents/openai.yaml": "4.7.9",
-    "v8-image-processing/references/api-reference.md": "4.7.9",
-    "v8-menu-buttons/SKILL.md": "4.7.9",
-    "v8-mongodb/SKILL.md": "4.7.9",
-    "v8-mq-mqtt/SKILL.md": "4.7.9",
-    "v8-saas-multi-tenant/SKILL.md": "4.7.9",
-    "v8-security/SKILL.md": "4.7.9",
-    "v8-sql-query/SKILL.md": "4.7.9",
-    "v8-table-event/SKILL.md": "4.7.9",
-    "v8-template-engine/SKILL.md": "4.7.9",
-    "v8-utilities/SKILL.md": "4.7.9",
-    "v8-utilities/references/client-api-index.md": "4.7.9",
-    "v8-utilities/references/platform-http-routes.md": "4.7.9",
-    "v8-utilities/references/server-api-index.md": "4.7.9",
-    "v8-workflow/SKILL.md": "4.7.9",
-    "workspace-conventions/SKILL.md": "4.7.9"
+    ".microi-skills-version.json": "4.8.2",
+    "README.md": "4.8.2",
+    "ai-engine/SKILL.md": "4.8.2",
+    "ai-engine/agents/openai.yaml": "4.8.2",
+    "app-store/SKILL.md": "4.8.2",
+    "app-store/agents/openai.yaml": "4.8.2",
+    "business-blueprint/SKILL.md": "4.8.2",
+    "datasource-engine/SKILL.md": "4.8.2",
+    "datasource-engine/agents/openai.yaml": "4.8.2",
+    "dos-orm/SKILL.md": "4.8.2",
+    "dos-orm/references/api-reference.md": "4.8.2",
+    "job-engine/SKILL.md": "4.8.2",
+    "job-engine/agents/openai.yaml": "4.8.2",
+    "message-notification/SKILL.md": "4.8.2",
+    "message-notification/agents/openai.yaml": "4.8.2",
+    "message-notification/references/contracts.md": "4.8.2",
+    "microi-ai-app-auth.js": "4.8.2",
+    "microi-ai-application/SKILL.md": "4.8.2",
+    "microi-ai-application/agents/openai.yaml": "4.8.2",
+    "microi-ai-application/references/frontend-baseline.md": "4.8.2",
+    "microi-client-frontend/SKILL.md": "4.8.2",
+    "microi-codex-installer/SKILL.md": "4.8.2",
+    "microi-codex-installer/agents/openai.yaml": "4.8.2",
+    "microi-datasource-mapping/SKILL.md": "4.8.2",
+    "microi-db-schema/SKILL.md": "4.8.2",
+    "microi-db-schema/agents/openai.yaml": "4.8.2",
+    "microi-db-schema/references/core-tables.md": "4.8.2",
+    "microi-db-schema/references/form-component-options.md": "4.8.2",
+    "microi-db-schema/references/schema-overview.md": "4.8.2",
+    "microi-db-schema/references/schema.md": "4.8.2",
+    "microi-db-schema/references/table-catalog.md": "4.8.2",
+    "microi-deployment/SKILL.md": "4.8.2",
+    "microi-deployment/references/deployment-matrix.md": "4.8.2",
+    "microi-docs-coverage/SKILL.md": "4.8.2",
+    "microi-docs-coverage/references/capability-map.md": "4.8.2",
+    "microi-docs-coverage/scripts/audit-doc-skill-coverage.mjs": "4.8.2",
+    "microi-form-engine/SKILL.md": "4.8.2",
+    "microi-form-engine/references/component-catalog.md": "4.8.2",
+    "microi-form-engine/references/data-source-events.md": "4.8.2",
+    "microi-form-layout/SKILL.md": "4.8.2",
+    "microi-frontend-sdk/SKILL.md": "4.8.2",
+    "microi-left-right-layout/SKILL.md": "4.8.2",
+    "microi-microservice/SKILL.md": "4.8.2",
+    "microi-microservice/references/runtime-delivery.md": "4.8.2",
+    "microi-mobile-app-quality/SKILL.md": "4.8.2",
+    "microi-solution-quotation/SKILL.md": "4.8.2",
+    "microi-solution-quotation/agents/openai.yaml": "4.8.2",
+    "microi-solution-quotation/scripts/build_solution_quote.py": "4.8.2",
+    "microi-system-delivery/SKILL.md": "4.8.2",
+    "microi-ui/SKILL.md": "4.8.2",
+    "microi-uniapp-frontend/SKILL.md": "4.8.2",
+    "microi.v8.js": "4.8.2",
+    "module-engine/SKILL.md": "4.8.2",
+    "module-engine/references/module-config.md": "4.8.2",
+    "ocr-engine/SKILL.md": "4.8.2",
+    "ocr-engine/agents/openai.yaml": "4.8.2",
+    "page-engine/SKILL.md": "4.8.2",
+    "performance-testing/SKILL.md": "4.8.2",
+    "playwright-e2e/SKILL.md": "4.8.2",
+    "print-engine/SKILL.md": "4.8.2",
+    "production-readonly-audit/SKILL.md": "4.8.2",
+    "report-engine/SKILL.md": "4.8.2",
+    "report-engine/agents/openai.yaml": "4.8.2",
+    "search-engine/SKILL.md": "4.8.2",
+    "search-engine/agents/openai.yaml": "4.8.2",
+    "spider-engine/SKILL.md": "4.8.2",
+    "translate-engine/SKILL.md": "4.8.2",
+    "translate-engine/agents/openai.yaml": "4.8.2",
+    "ui-design/SKILL.md": "4.8.2",
+    "ui-design/assets/pattern-showcase/app.js": "4.8.2",
+    "ui-design/assets/pattern-showcase/index.html": "4.8.2",
+    "ui-design/assets/pattern-showcase/styles.css": "4.8.2",
+    "ui-design/assets/templates/MCI-DESIGN.md": "4.8.2",
+    "ui-design/references/design-pattern-library.md": "4.8.2",
+    "ui-design/references/mci-design-contract.md": "4.8.2",
+    "ui-design/references/motion-and-media.md": "4.8.2",
+    "ui-design/references/product-flow-recipes.md": "4.8.2",
+    "uniapp-mall-assets/SKILL.md": "4.8.2",
+    "v8-api-config/SKILL.md": "4.8.2",
+    "v8-cache-pattern/SKILL.md": "4.8.2",
+    "v8-crud-api/SKILL.md": "4.8.2",
+    "v8-debugging/SKILL.md": "4.8.2",
+    "v8-explorer-tree/SKILL.md": "4.8.2",
+    "v8-export-import/SKILL.md": "4.8.2",
+    "v8-file-upload/SKILL.md": "4.8.2",
+    "v8-formengine-http/SKILL.md": "4.8.2",
+    "v8-frontend-events/SKILL.md": "4.8.2",
+    "v8-frontend-events/references/bluetooth-print-api.md": "4.8.2",
+    "v8-frontend-events/references/bluetooth-print.md": "4.8.2",
+    "v8-http-integration/SKILL.md": "4.8.2",
+    "v8-image-processing/SKILL.md": "4.8.2",
+    "v8-image-processing/agents/openai.yaml": "4.8.2",
+    "v8-image-processing/references/api-reference.md": "4.8.2",
+    "v8-menu-buttons/SKILL.md": "4.8.2",
+    "v8-mongodb/SKILL.md": "4.8.2",
+    "v8-mq-mqtt/SKILL.md": "4.8.2",
+    "v8-saas-multi-tenant/SKILL.md": "4.8.2",
+    "v8-security/SKILL.md": "4.8.2",
+    "v8-sql-query/SKILL.md": "4.8.2",
+    "v8-table-event/SKILL.md": "4.8.2",
+    "v8-template-engine/SKILL.md": "4.8.2",
+    "v8-utilities/SKILL.md": "4.8.2",
+    "v8-utilities/references/client-api-index.md": "4.8.2",
+    "v8-utilities/references/platform-http-routes.md": "4.8.2",
+    "v8-utilities/references/server-api-index.md": "4.8.2",
+    "v8-workflow/SKILL.md": "4.8.2",
+    "workspace-conventions/SKILL.md": "4.8.2"
   },
   "files": [
     ".microi-skills-version.json",

package/{dist/microi.skills → skills}/.microi-skills-version.json

@@ -1,6 +1,6 @@
 {
-  "version": "4.7.9",
+  "version": "4.8.2",
   "versionRule": "Microi version uses three numeric parts. Each publish increments the last part; when a part exceeds 9 it carries to the previous part: 1.0.9 -> 1.1.0, 1.9.9 -> 2.0.0.",
   "managedBy": "Microi.VSCode/bump-version.js",
-  "updatedAt": "2026-08-08T09:08:06.049Z"
+  "updatedAt": "2026-08-08T11:49:19.346Z"
 }

package/skills/microi-codex/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: microi-codex
+description: 在 Codex 中完成 Microi吾码 VS Code 扩展的等价工作流，包括连接与登录、AI/MCP 初始化、V8/表单/模块/工作流同步、远程执行与诊断、性能测试、微应用、Playwright 和发布回读。用户提到吾码、Microi、V8引擎、Microi-V8-Engine 或要求使用吾码 Codex 插件时使用。
+---
+
+# Microi吾码 Codex Plugin
+
+本插件与 `Microi.VSCode`、`@microi.net/cli` 共用配置、Token、MCP Server 和 Microi Skills。不要另写原生 HTTP、SQL 或第二套认证实现。
+
+## 先确认工作区连接
+
+1. 调用 `microi_codex`，传 `{ "action": "profiles" }`。
+2. 只有一个已登录连接时，后续可以省略 `profile`；存在多个连接时，始终传 `profiles` 返回的稳定 `name`。
+3. 尚未初始化时，插件根目录是本文件向上两级；使用其中的 `scripts/microi-cli.js`：
+   - `node <plugin-root>/scripts/microi-cli.js init --workspace <workspace>`
+   - 多连接：`profile list|add|remove`
+   - 登录：`auth login|status|logout --profile <name>`
+   - 诊断：`doctor --json`
+4. 登录会在真实终端中隐式输入密码；不要把密码写入命令、日志、Skill、MCP 参数或工作区文件。Token 继续写入 `Microi-V8-Engine/.microi-mcp-tokens.json`，并按 API、OsClient、Type、Network 四段身份隔离。
+
+## 功能路由
+
+- 连接、登录、拉取、推送、差异和 AI 初始化：使用 bundled CLI 的 `profile`、`auth`、`pull`、`push`、`sync status`、`ai init`、`mcp init`、`doctor`。
+- 接口引擎、表单事件、模块、字段、工作流和数据库结构：先用 `action="list_tools"` / `describe_tool`，再调用对应原始 `microi_*` 工具。写工具必须保留确认口令、审计与回读。
+- 远程执行与调试：读取 `v8-debugging/SKILL.md`。Codex 用“获取源码 → 远程执行 → 定位堆栈/日志 → 最小补丁 → 再执行”的结构化循环代替 VS Code DAP 的可视化逐行面板；不得把未执行的源码检查称为真机调试成功。
+- 性能测试：读取 `performance-testing/SKILL.md`，限制并发并输出样本、P95/P99、错误率和停止条件。
+- 微应用：读取 `microi-microservice/SKILL.md`，使用 scaffold、source sync、stream publish 和发布回读原工具；本地构建前遵守内存保护。
+- Playwright：读取 `playwright-e2e/SKILL.md`，使用当前已登录浏览器或受控 Playwright；报告必须来自实际页面执行。
+- 其他领域：从本插件同级 Skills 里选择最小相关 Skill，并完整读取后执行。
+
+## 同步与安全边界
+
+- `Microi-V8-Engine/.microi-config.json` 是三端连接配置事实源；未知字段必须保留。
+- CLI/VS Code/Codex 可并存；较新 provider 版本优先，禁止旧入口回写降级。
+- 推送前先做远端差异检查。写请求超时只表示结果不确定，使用对应 get 工具短超时回读，禁止盲目重复创建或覆盖。
+- 配置和 Token 文件使用现有原子写与锁协议；不要手工拼接或清空用户已有 MCP 配置。
+- Codex Plugin 路由器只选择连接，业务行为必须继续走原 MCP bundle。
+
+完整 VS Code 命令覆盖关系见插件根目录 `assets/feature-matrix.json`。

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

@@ -0,0 +1,140 @@
+---
+name: microi-codex-installer
+description: 当用户在 Codex、WorkBuddy、CodeBuddy、Qoder、Comate、Trae、Cursor、Claude Code 或其它 AI 编程软件中说“安装 @microi.net/cli”“初始化 Microi吾码插件”“添加吾码服务器/MCP”“拉取某连接的所有 V8 代码”，或要求安装、升级、启用、诊断吾码 AI 插件时使用。用户明确要求安装或初始化即视为对应操作授权；普通 Microi 对话只做只读检测，禁止静默安装或改写全局配置。
+---
+
+# Microi吾码 AI 插件与 CLI 安装
+
+本技能负责发现、安装、初始化、升级和诊断 Microi吾码 AI 开发能力。唯一 npm 包为 `@microi.net/cli`；该包同时提供 `microi` CLI、Codex Plugin、WorkBuddy/CodeBuddy 兼容插件清单、完整 Skills 与同源 MCP。正式 marketplace 名称固定为 `microi-net`，插件选择器固定为 `microi@microi-net`，禁止新建 `microi-official` 或第二个 npm 包。
+
+只要本技能已经由 Microi.VSCode、工作区 `microi.skills` 或已安装插件提供，用户说“帮我初始化 Microi吾码插件”时就必须识别该意图，用户不需要再次说出 npm 包名。绝对空白且任何宿主都尚未提供本技能的 AI 会话无法依靠尚未加载的 Skill 自我发现包名；因此冷启动入口统一固化在 VS Code 初始化产物、`@microi.net/cli` 与 Codex Plugin 三处，而不是要求用户记忆第二个包。
+
+## 自然语言入口规则
+
+- 任一 AI 宿主开始处理 Microi吾码低代码、V8、MCP、表单/模块/流程、微应用或平台源码任务时，先判断当前任务是否已经提供 `microi` 的 Skills/MCP/CLI 能力。
+- 能力不明确时立即做只读检测，不得等到缺少工具或上下文后才检查。
+- 用户明确说“安装 `@microi.net/cli`”“初始化 Microi吾码插件”“添加服务器/MCP”或“拉取某连接全部 V8”时，该请求本身就是对应操作授权；立即执行本技能中的确定性命令，不再重复询问同一授权。
+- 用户只是在进行普通 Microi 业务对话、尚未要求安装时，发现插件缺失后必须立即说明将修改 Codex 全局 marketplace、插件配置和本地缓存，并请求一次明确同意。未获同意不得安装、下载或改写全局配置。
+- 用户拒绝或暂不安装时，继续使用工作区现有 `microi.skills`、`@microi.net/cli` 或 MCP 完成可完成的工作，不得阻塞或反复提示。
+
+## 检测
+
+优先使用已经安装的 CLI：
+
+```bash
+microi codex status --json
+```
+
+如果 `microi` 命令不存在，只可先运行不会下载包的本机只读检查：
+
+```bash
+codex plugin marketplace list
+codex plugin list
+```
+
+成功状态必须同时满足：
+
+- marketplace 为 `microi-net`；
+- `microi@microi-net` 显示 `installed, enabled`；
+- 已安装版本等于 CLI 内置 marketplace 的目标版本。
+
+`microi-official` 和 `microi@microi-official` 仅是旧标识，不得写入新文档或新配置；安装器会在新版安装成功后迁移并清理旧标识。
+
+## 获得授权后安装
+
+已安装全局 CLI 时：
+
+```bash
+microi codex install --yes
+```
+
+没有全局 CLI，但用户已明确授权安装时：
+
+```bash
+npx --yes @microi.net/cli@latest codex install --yes
+```
+
+`--yes` 只表示当前用户已经授权这次全局修改，不得由 AI 在普通 Microi 对话中自行补上。只有版本不一致且普通安装不能升级、并确认目标 npm 包已经公开可读时，才使用：
+
+```bash
+microi codex install --yes --force
+```
+
+开发者从可信本地源码验收时，可以显式指定 marketplace 源：
+
+```bash
+microi codex install --yes --source <Microi.VSCode目录>
+```
+
+普通用户不得被引导到来历不明的 Git、本地目录或第三方 registry。不得通过 VPN、伪造地区/企业身份或共享账号绕过 OpenAI 地区与身份政策。
+
+## 空工作区与多宿主初始化
+
+用户明确要求“初始化 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。密码只允许隐式输入，禁止放入命令参数、对话记录或生成文件。
+
+原生配置对应关系：
+
+- 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`；全局插件是可选增强。
+
+完成后运行：
+
+```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
+```
+
+只有返回 `ok: true` 且选择器、状态和版本全部正确，才报告安装完成。随后明确提示用户新建 Codex 任务或重载 Codex；当前已经打开的任务通常不会热加载新增 Skills/MCP。
+
+若 npm 返回 `E404`，说明 `@microi.net/cli` 的目标版本尚未公开或仍在传播。不得删除仍可用的旧插件、不得重复发布同一不可变版本，也不得声称安装成功。

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

@@ -0,0 +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

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

@@ -1,79 +0,0 @@
----
-name: microi-codex-installer
-description: 当用户要求安装、升级或诊断 Microi吾码 Codex 插件，或者 Codex 开始处理 Microi 平台任务但 `microi@microi-net` 插件能力缺失时使用。立即做只读检测；用户明确要求安装时可直接通过 @microi.net/cli 执行，普通对话中则先说明全局改动并取得一次明确授权，禁止静默安装。
----
-
-# Microi吾码 Codex 插件安装
-
-本技能负责发现、安装、升级和迁移 Microi吾码 Codex 插件。正式 marketplace 名称固定为 `microi-net`，插件选择器固定为 `microi@microi-net`，npm 包为 `@microi.net/codex-plugin`。
-
-## 强制入口规则
-
-- Codex 开始处理 Microi吾码低代码、V8、MCP、表单/模块/流程、微应用或平台源码任务时，先判断当前任务是否已经提供 `microi` 插件的 Skills/MCP/CLI 能力。
-- 能力不明确时立即做只读检测，不得等到缺少工具或上下文后才检查。
-- 用户明确说“安装/升级/启用吾码 Codex 插件”时，该请求本身就是安装授权；可直接执行安装命令，不再重复询问。
-- 用户只是在进行普通 Microi 业务对话、尚未要求安装时，发现插件缺失后必须立即说明将修改 Codex 全局 marketplace、插件配置和本地缓存，并请求一次明确同意。未获同意不得安装、下载或改写全局配置。
-- 用户拒绝或暂不安装时，继续使用工作区现有 `microi.skills`、`@microi.net/cli` 或 MCP 完成可完成的工作，不得阻塞或反复提示。
-
-## 检测
-
-优先使用已经安装的 CLI：
-
-```bash
-microi codex status --json
-```
-
-如果 `microi` 命令不存在，只可先运行不会下载包的本机只读检查：
-
-```bash
-codex plugin marketplace list
-codex plugin list
-```
-
-成功状态必须同时满足：
-
-- marketplace 为 `microi-net`；
-- `microi@microi-net` 显示 `installed, enabled`；
-- 已安装版本等于 CLI 内置 marketplace 的目标版本。
-
-`microi-official` 和 `microi@microi-official` 仅是旧标识，不得写入新文档或新配置；安装器会在新版安装成功后迁移并清理旧标识。
-
-## 获得授权后安装
-
-已安装全局 CLI 时：
-
-```bash
-microi codex install --yes
-```
-
-没有全局 CLI，但用户已明确授权安装时：
-
-```bash
-npx --yes @microi.net/cli@latest codex install --yes
-```
-
-`--yes` 只表示当前用户已经授权这次全局修改，不得由 AI 在普通 Microi 对话中自行补上。只有版本不一致且普通安装不能升级、并确认目标 npm 包已经公开可读时，才使用：
-
-```bash
-microi codex install --yes --force
-```
-
-开发者从可信本地源码验收时，可以显式指定 marketplace 源：
-
-```bash
-microi codex install --yes --source <Microi.VSCode目录>
-```
-
-普通用户不得被引导到来历不明的 Git、本地目录或第三方 registry。不得通过 VPN、伪造地区/企业身份或共享账号绕过 OpenAI 地区与身份政策。
-
-## 安装后验收
-
-再次执行：
-
-```bash
-microi codex status --json
-```
-
-只有返回 `ok: true` 且选择器、状态和版本全部正确，才报告安装完成。随后明确提示用户新建 Codex 任务或重载 Codex；当前已经打开的任务通常不会热加载新增 Skills/MCP。
-
-若 npm 返回 `E404`，说明 `@microi.net/codex-plugin` 的目标版本尚未公开或仍在传播。不得删除仍可用的旧插件、不得重复发布同一不可变版本，也不得声称安装成功。

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

@@ -1,7 +0,0 @@
-interface:
-  display_name: "Microi吾码 Codex 插件安装"
-  short_description: "检测并安装或升级 Microi吾码 Codex 插件"
-  default_prompt: "Use $microi-codex-installer to detect and install the Microi吾码 Codex plugin with user authorization."
-
-policy:
-  allow_implicit_invocation: true