@microi.net/cli 5.9.4 → 5.9.6

package/skills/microi-ai-application/agents/openai.yaml

@@ -1,4 +1,4 @@
-interface:
-  display_name: "Microi AI 应用开发"
-  short_description: "以 Vue 3、Vite、TypeScript 构建可维护的吾码 AI 应用"
-  default_prompt: "使用 $microi-ai-application 创建一个可维护、可发布并通过多端验收的吾码 AI 应用。"
+interface:
+  display_name: "Microi AI 应用开发"
+  short_description: "以 Vue 3、Vite、TypeScript 构建可维护的吾码 AI 应用"
+  default_prompt: "使用 $microi-ai-application 创建一个可维护、可发布并通过多端验收的吾码 AI 应用。"

package/skills/microi-codex/SKILL.md

@@ -27,18 +27,23 @@ description: 在 Microi Agent、Codex 或 DeepSeek Harness 中完成 Microi吾
 - 桌面包内置技能目录；干净工作区输入 `/microi` 可发现吾码入口，再读取基础规范与专项技能。查不到时先核对当前桌面版本及内置技能资源，不要求用户复制开发机目录，也不要把 MCP 工具名当成斜杠技能名。
 - 对话输入框上下键回填成功提交的提示词，向下可恢复未发送草稿。菜单、输入法候选、选区和多行正常光标移动优先；不要在用户编辑文本时强行覆盖草稿。
 - 消息编辑/撤回通过真实会话分叉到该消息之前的已完成轮次；原会话和已经执行的文件修改保留。撤回将消息恢复为草稿，编辑则重新发送；这不是撤销文件系统。图片随草稿恢复，无法安全恢复的文件附件明确拒绝，不能静默删除附件或只改屏幕文字而保留旧模型上下文。
-- AI 员工桌面工作台提供十岗、任务草稿、执行、成果审阅、已验收依赖、目标和预算。云端执行复用员工中心；本机执行使用显式受限 OpenClaw Agent 与已有 Gateway。Harness 的会话/技能/定时能力不能证明 OpenClaw 的渠道、Gateway、设备节点与全部 cron 语义已完整内置。相关配置和验收读取 `ai-engine/references/ai-employees.md`。
+- AI 员工按项目群协作，十个岗位加技术总监共十一个岗位，可分别选择桌面已配置模型；原任务、成果审阅、目标和预算仍从「任务与验收」进入。群与任务共用用户明确选择并已登录的吾码 MCP，不能默认切到官方账号或首个客户。数据、运行与验收记录归所选租户；未安装员工中心或权限不足必须明确提示，不能擅自向所有客户安装。Harness 的会话/技能/定时能力不能证明完整 OpenClaw 已内置。相关执行边界读取 `ai-engine/references/ai-employees.md`。
+- 员工群消息先持久提交 SQL 消息、运行与 outbox，再返回短确认；后台用稳定 Mongo `_id` 同步并按授权游标分页读取，失败明确显示 SQL 兜底，不能把未确认发送或模型排队当完成。旧历史只在当前群管理者显式操作后分批迁移。SignalR 使用通用 `/api-engine-realtime` 和群授权，只传版本提示；断线重连后重新授权并按游标回读，不将推送当持久记录。Token 留在桌面 Worker，切换 MCP/用户/群时清理旧订阅及迟到响应。最终安装包须实测详情、模型选择保存、短确认、Mongo 回读及断线恢复。
+- Mongo 附件投影保存规范四字段数组的 JSON 字符串，读回仍核对完整消息摘要，不能只比较顶层 ContentHash。冲突先用同源、当前群管理权限限定的只读审计；旧嵌套字段已丢失时不可猜测解码或跳过摘要。派生投影修复仅限 SQL 正文摘要与 outbox 一致、原 outbox 独占租约仍有效、Mongo 同 Message/Group/Owner、时间/序号及其余非附件字段匹配、已知缺陷形态明确的记录；只更新派生附件字段并完整回读核对，不把固定 Id 更新宣称为 Mongo 原子 CAS。未知冲突保留 SQL 兜底，不改业务消息或模型运行、不扫描所有租户。
+- 同一桌面实例的多个 Worker 必须共享本机模型容量预准入，在领取云端任务前取得名额；RPC 超时不等于模型终态，结果未知时停止自动重放并保留核对入口。
+- 员工模型以 16,384 Token 为本功能默认且最高请求预算，不代表厂商输出能力；通过官方 prepareCall 同时冻结路由、能力和派发，按配置中的显式请求上限及剩余上下文收紧，保留用户 thinking/reasoning 控件。max-tokens 表示输出截断，必须记录 Uncertain 并等待核对，不能当完整成果或自动重试；预算不足应在派发前明确拒绝。
+- 员工新运行只允许从用户所选且有效的 MCP 完整身份与当前显式项目群领取；未选群不自动领取其它群，切换连接或群后停止旧范围的新领取。已开始运行按原范围安全收尾，已保存的加密成果重报保留；不能因离群丢弃结果或重放结果未知的模型调用。
 
 - 桌面与手机配对的本机 HTTP 监听必须避开 Fetch 标准禁止端口。系统自动分配的端口也可能不可浏览器访问；只有浏览器允许的真实监听端口才能进入配对 URL。自动命中禁止端口时关闭监听再有界重选，显式配置禁止端口须报错；权限和占用错误仍保留原错误，不改变系统动态端口范围、不绕过浏览器安全策略。同步上游时保护共同端口选择器、配对监听与对应回归。
 
-- 同步上游前读取内部源码根目录 `.microi-upstream.json`、`同步dsh-desktop上游.md` 与维护交接记录；分别核对 dsh-desktop 提交、Harness 官方 tag/提交、npm 版本与锁定 integrity。三方比较和补丁意图迁移、干净 `npm ci`、回归及真实界面验收通过后才能推进基线。禁止用整目录覆盖或删除补丁来通过同步。Harness 的同级权限请求应直接使用当前有效模式；提升权限必须填写非空理由，普通调用不要附带这两个升级字段。
-- Microi Agent 是内部仓库中的独立桌面发行物，直接基于 DataElement/dsh-desktop 与 DeepSeek Harness 二次开发，内置固定版本的 Harness SDK、Node.js、MCP / CLI / Skills；不是需要额外 Agent Token 的 CLI 别名。
-- 官方 AI 登录只走桌面账号窗口，固定 `https://api.itdos.com`、`OsClient=iTdos`，使用当前用户的中转 Key 和额度。不要让用户把密码或 AI Key 写入对话、命令行、MCP 参数或模型配置。
+- 1.3.8 起生产宿主为 DeepSeek 官方桌面。同步前读取内部源码根目录 `同步DeepSeek官方上游.md`、`apps/official-desktop/upstream.lock.json` 与维护交接记录；核对官方提交、归档 SHA、版本与完整锁。保留原始快照、自有层和精确接缝，干净安装、回归及真实包验收后才能推进基线。`同步dsh-desktop上游.md` 仅用于历史派生模块，不得恢复退役宿主或 PPT 模式。
+- Microi Agent 是内部仓库中的独立桌面发行物，基于 DeepSeek Harness 官方桌面源码及独立吾码差异层，内置固定 Harness、Node.js、MCP / CLI / Skills；不是需要额外 Agent Token 的 CLI 别名。历史 DataElement 派生模块及许可证仍保留。
+- 官方 AI 登录只走吾码桌面账号窗口，在受支持的 `https://api.microi.net` / `https://api.itdos.com`、`OsClient=iTdos` 使用本人的中转 Key 和额度；它是员工业务 MCP 之外的可选计费来源。不要把密码或 AI Key 写入对话、命令行、MCP 参数或模型配置。
 - 业务连接在「服务器连接（MCP）」中单独添加、登录；官方 AI 账号不授予业务租户权限。项目初始化和资源同步优先使用桌面「项目资源」；其余业务继续调用同源 MCP 的原工具。
 - macOS 登录凭据通过桌面 Keychain/受限 IPC 管理；不要在 macOS 改跑当前只支持 Windows 凭据恢复的 `microi auth login`。不要手改 Token 文件。
 - 桌面安装包中的 Harness、Node 和同源资产随桌面版本升级；不运行 npm 自更新去改写正在使用或已签名的安装目录。外部 Codex / WorkBuddy / CLI 的后台更新规则保持不变。
-- 桌面 UI 沿用 dsh-desktop 的设计系统；首页保留 dsh 原生会话区，并在下方用无外层卡片边框、无整块背景的差异层完整展示吾码 AI 大类与 29 项图像工具。工具 Id、名称和分类以 `Microi.Client/src/views/ai-engine/ai-image-tool-directory.js` 为事实源，点击时在「Microi吾码」主面板打开原生三栏工作台，禁止跳转浏览器页面；模型来源可选当前对话模型、吾码官方中转站或已登录服务器连接。服务器连接入口和“预览版”不重复放进首页。AI 数据分析明确使用 `microi_run_engine` 调用 `mci_ai_data_assistant`，不能改成绕过 MCP 的直接数据库访问。
-- Microi Agent 左侧「功能区」动态读取 dsh 的 `settings.section` 注册表，并在主界面 `main` 面板中渲染原设置组件；第一项「Microi吾码」合并官方账号和吾码 AI，第二项为「服务器连接（MCP）」，之后提供 AI 员工、采集引擎、环境与服务管理入口，再接 dsh 原生设置。功能区与工作区可拖动调高，默认无滚动条；首页/聊天页不显示虚假选中态。底部入口显示「关于 v版本号」及 `LicenseType` 版本标签，连接手机入口保持同一行。品牌显示 `Microi Agent` 与 `HARNESS` 标签，新安装默认浅色，用户仍可切换浅色/深色。
+- 桌面 UI 通过官方 slots 接入吾码面板，首页保留官方会话区及吾码 AI 大类与 29 项图像工具。工具目录以 `Microi.Client/src/views/ai-engine/ai-image-tool-directory.js` 为事实源，点击在「Microi吾码」主面板使用；模型来源可选当前对话模型、吾码官方中转或已登录业务连接。AI 数据分析通过同源 MCP 调用 `mci_ai_data_assistant`。1.4.0 起不挂载旧 dsh-desktop PPT 模式、模板 dock 或独立菜单；普通 Office 技能、用户文件与历史不删除。
+- 左侧工作区位于功能区上方；功能区用官方注册表接入插件、自动化任务、审查、吾码账号与 AI、服务器连接（MCP）、AI 员工、采集及环境服务管理，独立滚动且窄屏可达。底部「关于 v版本号」与连接手机同一行；意见反馈显示吾码官网及 QQ 群 51050055，不跳 DeepSeek 登录。自定义应用 Logo/名称只改变桌面本机品牌。默认浅色并支持深色。
 - 桌面安装包版本从 `1.0.0` 开始，使用吾码三段十进制进位规则。正式新版本先在发布源码中执行 `version:bump`，核对并提交三个版本文件；Mac 拉取后使用 `bash ./一键打包Mac.sh` 在临时 Git 工作树中打包当前已提交版本，默认不再升版，失败也不能把生成文件留在原检出目录。`--current` 仅作旧命令兼容；同版本本地重打包不得覆盖已公开的不可变产物。测试、类型检查和普通 Web 构建不升版。
 - Windows 安装包的构建成功、Authenticode 签名、SmartScreen/商店信任、HDFS 上传与 CDN 回读是不同证据；双击 `一键打包Windows.cmd` 时自动探测 Microsoft Artifact Signing 或本机可信证书，没有凭据则继续生成明确标记的未签名包，显式 `-Signing Signed` 才失败关闭。签名必须先覆盖安装器及独立执行文件，再计算发布 SHA256。macOS 默认 `bash ./一键打包Mac.sh` 同样自动探测并在无凭据时生成未签名包；`--signed` 是正式门禁，必须在缺少证书或公证钥匙串时失败，并通过 `codesign`、`spctl`、`stapler validate` 后才标记已签名公证。
 - Harness 本机探测必须以独立硬计时器约束 TCP 连接和响应头，Node 失败后用 Chromium 复核。两个通道在认证地址公布后连续连接失败时，仅重启一次到 IPv6 `::1`；IPv6 也必须实际取得有效 HTTP 响应，不得伪造就绪、绑定所有网卡或关闭鉴权。普通模式与安全模式使用同一规则，500 响应不得触发网络回退或算作就绪。日志同时记录桌面版本、实际监听地址和进程内 HTTP 自检；探测不带凭据、不跟随重定向、不输出自检 Token。恢复日志只去除缓冲区之间的重叠，不能用全局 Set 删除重试中的相同超时。发布运行 `scripts/verify-harness-startup.mjs`，以包内 Node/Harness、真实 Chromium 页面验证普通与安全模式、Node 超时回退、IPv4 双通道受阻后 IPv6 鉴权和双通道真实无响应的有界失败。Mac 验收与 Windows 真机、安装升级、客户设备验收分别记录。

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

@@ -132,7 +132,7 @@ microi codex status --json
 microi dsh status --json
 ```
 
-不得用单独的 `microi mcp init` 代替完整 AI 重新初始化；`ai init` 已默认包含 MCP 更新。只有诊断表明 MCP 仍有明确残留问题时，才追加 `microi mcp init` 做定向恢复。初始化写入采用幂等/原子方式，不终止已启动的 MCP；当前进程继续旧版本，新进程读取新版本。
+完整初始化优先使用 `microi ai init`，它默认包含 MCP 更新；旧版单独 `microi mcp init` 只配置连接，必须补 `ai init`。新版 MCP 初始化联动同一 AI 注入器，同时补齐 Skills 和宿主规则，仍保留用户自定义或已跟踪入口；不能把初始化成功解释为模型已读全部规则。开工应按基础规范回报实际读取的总控和完整清单。初始化写入采用幂等/原子方式，不终止已启动的 MCP；当前进程继续旧版本，新进程读取新版本。
 
 开发者从可信本地源码验收时，可以显式指定 marketplace 源：
 

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-db-schema/agents/openai.yaml

@@ -1,4 +1,4 @@
-interface:
-  display_name: "Microi DB Schema"
-  short_description: "Use the Microi database dictionary and core table relationships."
-  default_prompt: "Use the Microi DB schema skill to inspect platform tables, fields, V8 event storage, menu configuration, workflow metadata, and system table relationships."
+interface:
+  display_name: "Microi DB Schema"
+  short_description: "Use the Microi database dictionary and core table relationships."
+  default_prompt: "Use the Microi DB schema skill to inspect platform tables, fields, V8 event storage, menu configuration, workflow metadata, and system table relationships."

package/skills/microi-deployment/SKILL.md

@@ -76,7 +76,9 @@ System.Drawing.Common 的 .NET 10 支持库引用 System.Formats.Nrbf，Dos.Comm
 | 生产 Linux、快速安装、可滚动升级 | Docker/Compose |
 | 无互联网环境 | 在联网机制作离线包，再在目标机校验并安装 |
 | Windows 传统环境 | IIS + .NET Hosting Bundle + 独立依赖 |
-| 开发/调试 | 后端源码 + 前端 Vite，本地依赖或隔离容器 |
+| 开发/调试 | 复用健康服务，或启动后端源码/隔离目录中的编译产物 + 前端 Vite；优先共用已授权开发/测试依赖 |
+
+本地测试遵循 `../workspace-conventions/SKILL.md` 的“本地测试程序与依赖生命周期”：不能按 AI 任务或双节点测试默认新建整套 Docker/Compose；每轮结束均收回自建进程和获准创建的临时容器，既有共享服务保持原状态。
 
 本地 `Microi.Client` 默认读取 `src/config.json` 的 `ApiBaseDev`，也允许在 `#` 前通过 URL 参数
 临时指定运行目标：
@@ -130,7 +132,7 @@ Microi API 安装时，`AppSettings` 与同名容器环境变量只允许以下
 - LibreTranslate 属于一键安装默认组件：安装选择空输入按 `1` 处理，语言套餐空输入按基础套餐 `1` 处理；因此用户一路按 Enter 使用官方推荐组合。只有明确输入 `0` 才跳过，提示、端口预算、官网文档和静态回归测试必须一致。
 - OCR 的 Upgrade29 与 LibreTranslate 的 Upgrade31 字段门禁只在对应附加服务部署检查通过后回读，每秒一次、最多 15 秒；首轮成功就继续，超时快速关闭对应能力并提示镜像/迁移版本，不得退回 5 分钟空等，也不得直接创建字段绕过平台升级。附加能力门禁失败不得中断已通过完整升级链和 readiness 的核心平台。
 - 官方 API/Web 使用浮动 `latest` 时，生成的 Compose 必须设置 `pull_policy: always` 或在启动前显式拉取并核对，不能因宿主机已有同名镜像就复用旧版本；测试专用本机镜像覆盖必须明确使用 `never`，避免误访问或覆盖远端镜像。
-- 端口、密码和数据目录全部生成后，安装器必须注册统一的失败收尾：数据库、缓存、存储、API/Web、完整升级链或 API liveness/readiness 等核心后段错误保留原始非零退出码，并输出标题为“安装未完成”的恢复汇总，列出已生成端口、凭据、目录、失败阶段和全部容器状态。OCR/LibreTranslate 的网络、镜像、容器或 SaaS 配置失败只记录附加能力警告、保持对应能力未启用并继续核心安装。两种结果都不得把 `Running` 当 readiness，也不得绕过 Upgrade29/Upgrade31 或完整升级链门禁。
+- 端口、密码和数据目录全部生成后，安装器必须注册统一的失败收尾：数据库、缓存、存储、API/Web、完整升级链或 API liveness/readiness 等核心后段错误保留原始非零退出码，并输出标题为“安装未完成”的恢复汇总，列出已生成端口、受限凭据文件位置与脱敏状态、目录、失败阶段和全部容器状态。OCR/LibreTranslate 的网络、镜像、容器或 SaaS 配置失败只记录附加能力警告、保持对应能力未启用并继续核心安装。两种结果都不得把 `Running` 当 readiness，也不得绕过 Upgrade29/Upgrade31 或完整升级链门禁。
 - 从客户/旧库恢复安装时，安装器只按 `OsClient + OsClientType + OsClientNetwork + IsEnable + IsDeleted` 处理目标主租户：0 条时幂等创建最小可运行记录，1 条时原位复用，超过 1 条失败关闭。禁止把所有活动 `sys_osclients` 批量改成输入的 OsClient；新记录不得落库 `DbConn/DbReadConn/DbMongoConnection` 或 Redis 主机、端口、密码，这些继续由十项编排启动配置提供。MinIO、OCR 等安装值随后只更新这个精确三元组并回读唯一性。
 
 ### 复盘：普通帐号运行安装器直到步骤 5 才因 `/microi/compose` 权限失败
@@ -165,7 +167,7 @@ Microi API 安装时，`AppSettings` 与同名容器环境变量只允许以下
 
 - 健康开发服务默认复用；需要重载源码时串行重启。长期后端只从项目目录执行
   `dotnet run --launch-profile Microi.net.Api`，禁止直接运行 `bin/Release/net10.0`
-  或 `bin/Release/publish` 作为 E2E 服务。
+  或 `bin/Release/publish` 作为长期 E2E 服务。一次性测试本轮编译/发布产物时，复制到任务隔离目录启动，并登记身份、端口与最终收尾，避免占用共享 Release 输出。
 - API、PC、官网、Agent 分别使用 `api-release.lock`、`pc-release.lock`、`website-release.lock`、`agent-release.lock`，可并行发布；同类发布互斥。合并发布只取得所选产品的锁，部分取得失败时释放本次已取得的锁。
 - API 启动前执行 `node Microi.Server/tools/release-lock.mjs assert api <工作区根>`，PC 使用 `assert pc`；官网/Agent 不阻塞二者。旧全局锁仅在真实命令入口和状态目录证明 API 热修复或 Agent 归属后缩小阻塞范围，未知锁仍阻塞，不能删除活跃锁。
 - Windows 发布前调用 `Microi.Server/tools/Microi.LocalProcessManager.ps1 -Action PrepareRelease -ReleaseScope api|pc|all`。API 仅处理匹配工作区的后端与 Release DLL；PC 仅处理匹配的 Vite；官网不清理二者。禁止按进程名全机清理。
@@ -179,7 +181,7 @@ Microi API 安装时，`AppSettings` 与同名容器环境变量只允许以下
   `Microi.net.Api/bin/Release/net10.0` DLL。只结束 `VBCSCompiler` 不能解决正在运行的
   `.NET Host` 对业务 DLL 的锁定。
 - Edge/Chrome 用户浏览器、VS Code 的 Playwright Test Server、MCP/语言服务 Node、
-  数据库和 Redis 不属于发布清理范围。人工查看使用进程管理器的 `-Action Status`。
+  既有或借用的数据库和 Redis 不属于发布清理范围；本轮新建临时依赖仍须按基础规范收尾。人工查看使用进程管理器的 `-Action Status`。
 - PowerShell 7 下的 macOS/Linux 进程管理使用真实端口、命令行、精确大小写 CWD 和启动时间回读；身份不明或 PID 复用时失败关闭，只结束已核验根进程的后代。无扩展名 `Microi.net.Api` apphost 须采用规范绝对可执行路径，精确位于当前 API 项目的 `bin/` 下，且 CWD 精确等于项目目录；非规范路径、同名外部程序、读取失败均拒绝。身份函数回归进入 Full，实际停止能力仍需自有进程与端口验收。专项回归必须在自有目录、端口和真实进程中证明当前工作区可停止、外部工作区保留，以及原始文件锁诊断；不允许为了跨平台放宽跳过门禁。
 
 ## 一键发布产物边界与缓存

package/skills/microi-docs-coverage/references/capability-map.md

@@ -69,7 +69,7 @@ Markdown。第一列是相对 `microi.doc/docs/doc/` 的路径；第二列 Skill
 | `system-engine/vision-engine.md` | vision-engine, ai-engine, microi-microservice, app-store, v8-security | ONNX 视觉特征、租户样本匹配、异步 AI 回退、摄像头帧、人脸治理、微服务与商城交付 |
 | `system-engine/translate-engine.md` | translate-engine | 多语言与翻译供应商 |
 | `system-engine/unity-integration.md` | unity-integration, v8-api-config, microi-client-frontend | Unity UPM、WebGL/Windows、多人租约、公屏、DiyToken 与 V8 通讯边界 |
-| `system-engine/visualization-engine.md` | page-engine, microi-ui | 3D、CAD、goView 与数据大屏能力边界 |
+| `system-engine/visualization-engine.md` | page-engine, microi-ui, microi-microservice | 3D、LIS 型材库、CAD、goView 与数据大屏能力边界及微服务交付 |
 | `system-engine/wf-engine.md` | v8-workflow | 工作流设计和事件 |
 | `v8-engine/ai-apiengine.md` | ai-engine, v8-api-config, microi-system-delivery | AI 编程与短提示词；完整开发默认清单覆盖原推荐提示词 1–8 |
 | `v8-engine/api-engine.md` | v8-api-config, v8-utilities | 接口上下文、配置、分布式锁续租和调用 |