@microi.net/cli 6.0.1 → 6.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.codebuddy-plugin/marketplace.json +2 -2
- package/.codebuddy-plugin/plugin.json +1 -1
- package/.codex-plugin/plugin.json +43 -43
- package/.mcp.json +1 -1
- package/.workbuddy-plugin/marketplace.json +2 -2
- package/.workbuddy-plugin/plugin.json +1 -1
- package/LICENSE +21 -21
- package/README.md +71 -71
- package/assets/build-meta.json +7 -7
- package/assets/feature-matrix.json +138 -138
- package/assets/logo.svg +4 -4
- package/cordis.patch.yml +1 -1
- package/package.json +82 -82
- package/scripts/codex-marketplace.json +20 -20
- package/scripts/mcp-codex-stdio-adapter.js +189 -189
- package/scripts/mcp-server.js +81 -81
- package/scripts/mcp-trae-windows-launcher.cmd +21 -21
- package/scripts/microi-cli-mcp.js +7 -7
- package/scripts/microi-cli.js +60 -59
- package/scripts/microi-codex-broker.js +466 -466
- package/scripts/microi-codex-router.js +635 -635
- package/scripts/microi-skills.meta.json +220 -220
- package/skills/.microi-skills-version.json +6 -6
- package/skills/.progressive-disclosure-manifest.json +64 -64
- package/skills/microi-client-frontend/SKILL.md +266 -258
- package/skills/microi-codex/SKILL.md +130 -116
- package/skills/microi-codex-installer/SKILL.md +4 -2
- package/skills/microi-deployment/SKILL.md +1 -1
- package/skills/microi-microservice/SKILL.md +348 -344
- package/skills/microi-system-delivery/SKILL.md +100 -98
- package/skills/microi-system-delivery/references/progressive-02-/350/207/252/345/212/250/345/214/226/346/265/213/350/257/225/345/277/205/351/241/273/350/246/206/347/233/226/347/232/204/345/235/221.md +2 -2
- package/skills/page-engine/SKILL.md +231 -227
- package/skills/playwright-e2e/SKILL.md +33 -31
- package/skills/v8-cache-pattern/SKILL.md +8 -4
- package/skills/v8-export-import/SKILL.md +5 -0
- package/skills/v8-file-upload/SKILL.md +4 -0
- package/skills/v8-security/references/progressive-01-2-/346/235/203/351/231/220/346/240/241/351/252/214.md +10 -2
- package/skills/workspace-conventions/SKILL.md +111 -102
- package/skills/workspace-conventions/references/progressive-02-microi-net-api-/346/234/254/345/234/260/345/220/257/345/212/250/347/272/246/345/256/232.md +4 -3
- package/skills/workspace-conventions/references/progressive-03-cli-/344/270/216-ide-/346/217/222/344/273/266/351/224/231/347/211/210/345/205/261/345/255/230/347/272/246/345/256/232.md +4 -4
- package/skills/workspace-conventions/references/progressive-04-/345/267/245/344/275/234/345/214/272/344/270/216/345/271/263/345/217/260/344/270/223/351/241/271/344/277/235/351/232/234.md +6 -4
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
> 按需读取;本文件由 SKILL.md 的原章节无损拆分。
|
|
4
4
|
|
|
5
|
-
<!-- microi-progressive:chunk id=workspace-conventions-038 sha256=
|
|
5
|
+
<!-- microi-progressive:chunk id=workspace-conventions-038 sha256=5dbfb261596e9c61fcc330adca7a1ff40a3a1508cd89be3c7b10410e591aa557 -->
|
|
6
6
|
## CLI 与 IDE 插件错版共存约定
|
|
7
7
|
|
|
8
8
|
- CLI 与 IDE 插件共用配置、Token、MCP、Skills 或生成文件时,所有持久化协议必须按“新字段可选、旧字段保留、未知字段不删除”设计。不得将 JSON 解析到旧类型后只序列化已知字段。
|
|
@@ -24,11 +24,11 @@
|
|
|
24
24
|
- 根因:新 scope/新版本在 npm 网站、写入节点和公共 registry 读取节点之间存在短暂传播窗口;固定少量、短间隔轮询不足以区分“尚未发布”和“已经接收但尚未公开传播”。
|
|
25
25
|
- 通用规则:发布命令成功和公共回读确认必须作为两个阶段记录。npm 新版本回读使用 `--prefer-online` 和分钟级有限重试;重试结束仍为 E404 时标记 `pending-propagation`,禁止自动重发同一不可变版本,并提供独立只读验证命令稍后确认。只有发布命令本身失败且公共 registry 也始终不存在时,才进入补发流程。
|
|
26
26
|
- 自动化检查:模拟 `npm publish` 成功后前几次 `npm view` 返回 E404、随后返回期望版本,断言不会重复发布;再模拟重试窗口结束仍为 E404,断言输出待传播状态和只读验证命令,而不是提示重新上传同一版本。
|
|
27
|
-
## Git
|
|
27
|
+
## Git 大文件推送检查(强制)
|
|
28
28
|
|
|
29
29
|
- 每次 Git 推送前检查暂存内容及全部待推送提交中新引入的 Blob,不能只看工作树、最新提交或首尾文件差异;中间提交加入后又删除的大文件仍会进入历史。以刚核验的远端引用为基线,结合 `git rev-list --objects` 与 `git cat-file --batch-check` 检查真实对象大小;基线或对象不完整时先补齐并复核,不能绕过检查。
|
|
30
|
-
-
|
|
31
|
-
- 图片、PDF、PPT/PPTX
|
|
30
|
+
- 单个新增 Blob 达到 **10 MiB**,或本次新增 Blob 合计达到 **50 MiB** 必须停止推送并核对用途。截图、配图、PDF/PPT、视频、压缩包、安装包、模型和导出附件不论大小均禁止进入源码历史,必须经授权 MCP 上传 CDN,迁移完成后重新检查所有待推送提交。大小阈值是兜底检查,不是小文件可入库的豁免;一般推送授权或大文件清单确认不能替代 CDN 迁移。列出路径、实际字节数、SHA-256、目标仓库/分支和合计体积作为回执,不盲目再次推送。
|
|
31
|
+
- 图片、PDF、PPT/PPTX、视频、压缩资源、导出报告等交付附件必须通过当前授权租户的 MCP 上传到 CDN;吾码官方公开资源使用经核验的 microi_itdos 与 https://file.microi.net 前缀,核验实际下载字节数、SHA-256 和真实 MIME 后使用 FileServer/CDN 地址引用。源码仓库保留必要源码、引用、内容指纹清单及可重复生成的说明;不能静默提交导出产物。生成和验签下载缓存放在工作区 `.tmp/`,不得把已迁移资源通过旧分支或 PR 重新合并进公开历史。运行必需的字体、模板和第三方二进制按用途判断,不得以必要运行依赖为由混入截图或交付附件;大体积依赖先明确用途与分发方案,不得擅自删除用户文件。
|
|
32
32
|
- 历史瘦身另行确认改写范围,保留同事提交、有效分支、标签和可恢复证据;仅删除当前文件不能释放仍被历史引用的大对象。用户授权瘦身后使用明确引用清单及旧值保护,禁止未经盘点直接执行 `push -f --all` 或 `--mirror`,禁止为解除配额清空、删除或重建仓库。服务端 PR 引用、reflog、恢复记录和配额阻挡应通过管理界面或技术支持处理。
|
|
33
33
|
- 推送失败时保存原生 Git 的完整命令、退出码和 stdout/stderr,隐藏凭据但不删减错误正文,回读远端引用确认实际状态;区分本地 Hook、网络、权限与服务端容量拒绝。同一错误不盲目重跑,向技术支持提供与该次候选绑定的实际压缩体积、引用范围和完整日志,不能把本地精简成功当作远端已瘦身。
|
|
34
34
|
|
|
@@ -19,7 +19,7 @@ Microi 平台后端功能必须默认按多节点部署设计:多个 API/Worke
|
|
|
19
19
|
- 若要求宿主机掉电或 `kill -9` 窗口内也绝对零丢失,必须在返回业务成功前取得外部持久消息队列、共享 outbox 或同步 WAL 的持久化确认;“内存队列随后异步落盘”不能宣称覆盖尚未持久化的强杀窗口。
|
|
20
20
|
|
|
21
21
|
<!-- /microi-progressive:chunk -->
|
|
22
|
-
<!-- microi-progressive:chunk id=workspace-conventions-003 sha256=
|
|
22
|
+
<!-- microi-progressive:chunk id=workspace-conventions-003 sha256=fd7e446aa87c7d8fecac6a258dab354bfa81415a2ed60c11f5b3069557dfa049 -->
|
|
23
23
|
## 本地资源与 OOM 保护规范(强制)
|
|
24
24
|
|
|
25
25
|
AI 在用户本机启动 Node.js、Vite、Webpack、dotnet build、Java、Docker build、浏览器自动化、压力测试或其他可能长时间占用 CPU/内存的进程前,必须先评估资源,不得为了“让构建跑过”无限抬高堆内存或 Worker 数。
|
|
@@ -30,7 +30,7 @@ AI 在用户本机启动 Node.js、Vite、Webpack、dotnet build、Java、Docker
|
|
|
30
30
|
- 禁止将 `--max-old-space-size`、JVM heap、Docker memory 或类似上限设为接近物理内存总量。除非用户明确授权独占构建窗口,单个 AI 启动的进程树不得持续占用超过物理内存的 25%。
|
|
31
31
|
- 后台/长任务必须记录根 PID、子进程、启动时间和独立日志,每 15-30 秒监测一次进程树内存与全机可用内存。任务失败、中断或达阈值时必须停止整个子进程树,不得遗留孤儿 Node/dotnet/Java 进程。
|
|
32
32
|
- 全量构建无法在上述阈值内完成时,先停止并改用定向 lint、类型检查、按模块构建或按测试文件验证。如仍必须进行全量验收,应明确报告资源瓶颈,交由 CI/专用构建机或经用户明确同意的独占时段执行,禁止在用户正在使用的 VS Code 会话里硬跑。
|
|
33
|
-
-
|
|
33
|
+
- **本地测试程序与依赖生命周期(强制)**:默认复用当前 MCP 对应的 MySQL、Redis、MongoDB、MinIO/OSS 等实际依赖,以及健康源码/Vite;用独立测试库、租户和命名空间隔离,不按 AI 任务或节点创建整套 Docker/Compose。本机无容器、旧夹具被清理或执行 Full 都不是新建服务的理由,不再把临时测试容器许可作为常规问题。只有现有依赖确实无法满足具体验收且有证据时才采用最小必要替代方案。每轮成功、失败、取消及资源阻塞退出均精确删除自建临时容器与纯测试资源、收回自有进程和浏览器,并独立回读;既有共享服务保持原状。报告内存不足前先收回本任务遗留占用。详见[本地测试程序与依赖生命周期](progressive-02-microi-net-api-本地启动约定.md#本地测试程序与依赖生命周期强制)。
|
|
34
34
|
|
|
35
35
|
### `Microi.Client` 框架前端构建频率(强制)
|
|
36
36
|
|
|
@@ -139,7 +139,7 @@ AI 在工作区任意任务中生成的**一次性临时脚本、诊断文件、
|
|
|
139
139
|
- 文档改动后执行 `npm run docs:build`;验收时检查本次没有无理由新增 `.md` 页面或导航路由。
|
|
140
140
|
|
|
141
141
|
<!-- /microi-progressive:chunk -->
|
|
142
|
-
<!-- microi-progressive:chunk id=workspace-conventions-009 sha256=
|
|
142
|
+
<!-- microi-progressive:chunk id=workspace-conventions-009 sha256=90d90834a2080c2a2f08bae1092557761b6b23c79274f8d4dc2b115c121f5b51 -->
|
|
143
143
|
## 多对话共享工作区变更归属保护(强制)
|
|
144
144
|
|
|
145
145
|
### 功能验收后的源码提交与推送(强制)
|
|
@@ -149,8 +149,10 @@ AI 在工作区任意任务中生成的**一次性临时脚本、诊断文件、
|
|
|
149
149
|
- 推送前先获取上游的新提交并安全整合;共享工作区有并行改动时优先在隔离候选中合并,不用整树 stash/reset 覆盖他人成果,不强推共享分支,不绕过仓库 Hook。需要精确回滚时保留独立、说明清楚的功能提交;回滚已推送功能通常使用新的反向提交,不改写共享历史。
|
|
150
150
|
- 正式发布的候选必须包含此前已交付功能和本任务已核验的源码,先按仓安全本地提交,再冻结包含闭源源码在内的完整构建输入、提交号和内容哈希;仅更新说明页面时也要核对整个站点候选。Git 远端推送/回读与制品发布是独立交付步骤,默认可并行或在制品之后补推,不能把远端已包含 HEAD、推送成功或 Gitee/GitLab/GitHub 可达作为 NuGet、API/PC Docker、官网 Docker 等合格制品的上传前置条件。保留对应产品的 Full、闭源隔离、DLL 加密、候选/产物一致性、最终冒烟和渠道回读;官网继续执行整站构建与内容/入口验收。隔离工作树干净或持有发布锁,均不能代替源码完整性检查。
|
|
151
151
|
- 收尾逐仓记录本地提交号、远端分支和独立回读结果,分别报告源码、NuGet、Docker、官网及客户部署。远端网络、认证或容量故障首次失败后最多短重试一次,累计定向排障不超过 5 分钟;保存本地提交、失败原因和待补推清单,已通过全部制品门禁的渠道立即继续发布,不得反复请求同一例外授权。源码冲突、归属不明、保护路径违规、缺少实际构建输入或候选漂移必须先解决,不能当作可忽略的远端故障。后续合并改变源码/构建输入时重新冻结并按新候选验收,禁止将新提交冒充已发布制品来源;缺少远端回执仍标为源码未交付,不得宣称全部完成。
|
|
152
|
+
- 官方应用发布仅验收 `microi_itdos` 对应主租户 `iTdos` 的更新与回读,不批量升级、不等待线上子租户;子租户升级是独立部署任务。Full 仍保留已登记的隔离主、子测试租户及越权、升级回归,不将测试夹具称为官网子租户部署。
|
|
153
|
+
- 发布边界必须在 `Microi一键编译发布.sh` 及其调用入口生效,不能只依赖 AI 提示词。普通用户直接运行脚本同样保留适用的 Full、DLL 加密、冒烟和候选校验;运行脚本不授予官方 iTdos 写入权,也不授权升级其全部生产子租户。
|
|
152
154
|
|
|
153
|
-
- **Git
|
|
155
|
+
- **Git 资源与大文件检查(强制)**:截图、PDF/PPT、音视频、压缩包和其它大体积交付资源必须通过 MCP 上传 CDN,禁止进入 Gitee/GitHub 源码历史;官方公开资源使用 microi_itdos 与 https://file.microi.net。提交前查暂存区,推送前查全部待推送提交中新引入的 Blob,不能仅看最终树。单个 10 MiB / 合计 50 MiB 为兜底门槛;小截图和附件仍不得入库。完整规则见[Git 大文件推送检查](progressive-03-cli-与-ide-插件错版共存约定.md#git-大文件推送检查强制)。
|
|
154
156
|
|
|
155
157
|
同一工作区可能同时被用户、其它 Codex 对话、IDE、自动化任务或外部 Git 操作修改。任务启动前已经存在、或无法用本对话证据严格证明归属的差异,一律视为他人资产并保留;“工作区是脏的”不是清理授权。
|
|
156
158
|
|