@microi.net/cli 5.5.2 → 5.5.3

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.
Files changed (17) hide show
  1. package/.codebuddy-plugin/marketplace.json +2 -2
  2. package/.codebuddy-plugin/plugin.json +1 -1
  3. package/.codex-plugin/plugin.json +1 -1
  4. package/.workbuddy-plugin/marketplace.json +2 -2
  5. package/.workbuddy-plugin/plugin.json +1 -1
  6. package/assets/build-meta.json +3 -3
  7. package/cordis.patch.yml +1 -1
  8. package/package.json +1 -1
  9. package/scripts/microi-skills.meta.json +193 -193
  10. package/skills/.microi-skills-version.json +2 -2
  11. package/skills/.progressive-disclosure-manifest.json +6 -6
  12. package/skills/ai-engine/SKILL.md +2 -1
  13. package/skills/microi-mobile-app-quality/SKILL.md +1 -1
  14. package/skills/microi-mobile-app-quality/references/progressive-02-9-/344/270/273/351/242/230/345/210/207/346/215/242/345/277/205/351/241/273/347/234/237/345/256/236/344/270/224/345/205/250/345/261/200/347/224/237/346/225/210.md +12 -1
  15. package/skills/v8-export-import/SKILL.md +1 -1
  16. package/skills/workspace-conventions/SKILL.md +236 -236
  17. package/skills/workspace-conventions/references/progressive-01-/347/211/210/346/234/254/346/233/264/346/226/260/346/227/245/345/277/227/344/277/235/346/212/244/350/247/204/345/210/231-/345/274/272/345/210/266.md +50 -50
package/skills/workspace-conventions/references/progressive-01-/347/211/210/346/234/254/346/233/264/346/226/260/346/227/245/345/277/227/344/277/235/346/212/244/350/247/204/345/210/231-/345/274/272/345/210/266.md CHANGED
@@ -1,16 +1,16 @@
1
- # workspace-conventions 详细参考 1
2
-
3
- > 按需读取；本文件由 SKILL.md 的原章节无损拆分。
4
-
5
- <!-- microi-progressive:chunk id=workspace-conventions-010 sha256=d4ee69df49b8cba8d6365f485bd44aab8f5fcccc4cc1c8394220af14ff68f83f -->
1
+ # workspace-conventions 详细参考 1
2
+
3
+ > 按需读取；本文件由 SKILL.md 的原章节无损拆分。
4
+
5
+ <!-- microi-progressive:chunk id=workspace-conventions-010 sha256=d4ee69df49b8cba8d6365f485bd44aab8f5fcccc4cc1c8394220af14ff68f83f -->
6
6
  ## 版本更新日志保护规则（强制）
7
7
 
8
8
  - 日常功能开发、缺陷修复、测试、普通文档补充、Skill 完善和代码重构期间，不得修改 `microi.doc/docs/doc/about/update-log.md`。
9
9
  - 只有用户明确提出“发布版本”“准备发版”“更新版本日志”或直接点名要求修改该文件时，才允许编辑更新日志；“完善文档”或“补充官网说明”不等于授权修改版本日志。
10
10
  - 如果本轮误改了更新日志，必须先按上节完成多对话归属核验；只撤回有本对话精确写入证据的 hunk。必须保留用户、其它对话或其它任务的已提交和未提交内容，归属不明时不得修改并应询问用户。
11
11
 
12
- <!-- /microi-progressive:chunk -->
13
- <!-- microi-progressive:chunk id=workspace-conventions-011 sha256=8e3904f45392b7c27746de274bbc4725a7eb0964f0aeab1d83918c0174336dc4 -->
12
+ <!-- /microi-progressive:chunk -->
13
+ <!-- microi-progressive:chunk id=workspace-conventions-011 sha256=8e3904f45392b7c27746de274bbc4725a7eb0964f0aeab1d83918c0174336dc4 -->
14
14
  ## 配置文件说明中文优先规则
15
15
 
16
16
  AI 新增或修改 Microi 配置文件时，凡是面向开发者、部署人员或用户阅读的自然语言描述，默认必须写中文。适用范围包括 `appsettings*.json`、`docker-compose*.yml`、`launchSettings.json`、`*.example`、安装脚本注释、部署说明和示例配置。
@@ -20,8 +20,8 @@ AI 新增或修改 Microi 配置文件时，凡是面向开发者、部署人员
20
20
  - 如果配置面向海外交付，才可以在中文说明后补充英文括注；不要整段只写英文。
21
21
  - 修改配置说明后，必须确认 JSON/YAML 仍可解析，不能因为中文标点或注释方式导致配置文件失效。
22
22
 
23
- <!-- /microi-progressive:chunk -->
24
- <!-- microi-progressive:chunk id=workspace-conventions-012 sha256=f54d1c6d9ce2a86496dbc89d49158fb5efa7501817be350493247bd6bde37f63 -->
23
+ <!-- /microi-progressive:chunk -->
24
+ <!-- microi-progressive:chunk id=workspace-conventions-012 sha256=f54d1c6d9ce2a86496dbc89d49158fb5efa7501817be350493247bd6bde37f63 -->
25
25
  ## 后端 API 配置白名单与 SaaS 单一事实源（强制）
26
26
 
27
27
  - `Microi.net.Api` 的 `AppSettings` 与同名容器环境变量只允许：`OsClient`、`OsClientType`、`OsClientNetwork`、`OsClientDbType`、`OsClientDbConn`、`OsClientRedisHost`、`OsClientRedisPort`、`OsClientRedisPwd`、`OsClientRedisDataBase`、`OsClientDbMongoConn`。
@@ -29,8 +29,8 @@ AI 新增或修改 Microi 配置文件时，凡是面向开发者、部署人员
29
29
  - `ASPNETCORE_*`、`DOTNET_*` 是框架宿主配置；`PW_*`、MCP、构建、安装器和发布脚本变量只服务各自工具进程。它们不能成为生产 API 的业务配置入口。
30
30
  - 修改后必须用源码测试扫描生产 `.cs`、API `appsettings.json` 及在线/离线 Compose，精确断言十项白名单。不能用注释约定代替自动化守卫。
31
31
 
32
- <!-- /microi-progressive:chunk -->
33
- <!-- microi-progressive:chunk id=workspace-conventions-013 sha256=dbf22caaf1673270e6abf2277704505481f632c68c1da61df992c81a577e24df -->
32
+ <!-- /microi-progressive:chunk -->
33
+ <!-- microi-progressive:chunk id=workspace-conventions-013 sha256=dbf22caaf1673270e6abf2277704505481f632c68c1da61df992c81a577e24df -->
34
34
  ## 身份、可逆业务秘密与敏感操作统一规范（强制）
35
35
 
36
36
  - DiyToken 是吾码多租户、多终端、V8 和低代码权限体系的唯一会话入口。新增密码、SSO、OAuth、Passkey、人脸或其它登录方式时，验证成功后必须继续签发 DiyToken，并复用现有角色、部门、菜单、表权限、数据范围、终端吊销和 Token 轮换；禁止整体替换为 ASP.NET Identity 或并行建立第二套用户/权限 Token。
@@ -42,8 +42,8 @@ AI 新增或修改 Microi 配置文件时，凡是面向开发者、部署人员
42
42
  - 外部登录统一在登录页【登录方式】中展示；Gitee、微信、GitHub 等 Provider 只登录个人中心已绑定的吾码用户，最终签发 DiyToken。Provider 固定协议端点，租户自己的 ClientId/ClientSecret 放 `mci_system_setting`；Secret 不进入浏览器/前端 `V8.SysConfig`，后端接口引擎和后端 V8 事件只能从当前租户 `V8.SysConfig.ServerPrivateSettings[ConfigKey]` 使用，禁止回传或记录原文。
43
43
  - 一键安装恢复客户旧库时只允许定位精确主租户三元组；缺失则幂等创建，重复则停止，不能批量重写其它子租户。新主租户行不得持久化数据库、MongoDB 或 Redis 连接，安装器对 MinIO/OCR 等业务配置的后续更新也必须带同一三元组、活动状态条件并做唯一回读。
44
44
 
45
- <!-- /microi-progressive:chunk -->
46
- <!-- microi-progressive:chunk id=workspace-conventions-014 sha256=d17f000dd9548f104277acca846c450066e6979a1e0bfec31879a7ba42deccfe -->
45
+ <!-- /microi-progressive:chunk -->
46
+ <!-- microi-progressive:chunk id=workspace-conventions-014 sha256=d17f000dd9548f104277acca846c450066e6979a1e0bfec31879a7ba42deccfe -->
47
47
  ## 多语言优先约定
48
48
 
49
49
  Microi 平台默认支持多语言。AI 修改 `Microi.Client`、`Microi.Server`、`Microi-V8-Engine`、MCP 建模数据、菜单按钮、接口引擎或表单 V8 事件时，凡是用户可见文字都必须先考虑多语言，不要把中文提示、按钮名、Tab 名、菜单名、字段名、Toast/Msg 等硬写死后结束任务。
@@ -54,8 +54,8 @@ Microi 平台默认支持多语言。AI 修改 `Microi.Client`、`Microi.Server`
54
54
  - 不允许把所有多语言映射都创建到 `diy_lang` 根目录。新增词条前先查询是否已有同 Key/同分类数据；写入后需要刷新/回读多语言缓存。
55
55
  - 完成多语言相关改动后，至少切换一次目标语言或调用对应接口验证；涉及页面的任务优先用 Playwright 截图确认关键区域没有残留明显中文。
56
56
 
57
- <!-- /microi-progressive:chunk -->
58
- <!-- microi-progressive:chunk id=workspace-conventions-015 sha256=3db1eb06c79e7d3b5158a7fc4992af4848406d892c054699db3f9215849fcab4 -->
57
+ <!-- /microi-progressive:chunk -->
58
+ <!-- microi-progressive:chunk id=workspace-conventions-015 sha256=3db1eb06c79e7d3b5158a7fc4992af4848406d892c054699db3f9215849fcab4 -->
59
59
  ## 后台菜单层级默认规则
60
60
 
61
61
  AI 通过 MCP、Manifest、V8 或平台 API 创建/修复 Microi 后台菜单时，默认必须规划为至少两级菜单树。真实系统不能把一批 CRUD、报表、日志、设置页直接平铺到根级菜单。
@@ -67,8 +67,8 @@ AI 通过 MCP、Manifest、V8 或平台 API 创建/修复 Microi 后台菜单时
67
67
  - 改造已生成菜单时，不能只停留在文档建议。必须回读 `sys_menu`，列出现有菜单、目标父级、`ParentId`/`Sort` 迁移关系，更新管理员角色权限，再次回读验证菜单树深度。
68
68
  - 只有表单内嵌子表、隐藏路由、系统内部入口等不应出现在导航中的菜单可以例外隐藏；隐藏菜单必须明确设置 `Display=0`、`AppDisplay=0`，并避免误标为有子级的空父菜单。
69
69
 
70
- <!-- /microi-progressive:chunk -->
71
- <!-- microi-progressive:chunk id=workspace-conventions-016 sha256=ea4975115c96e1968ae32b8f2271b79288f99a35cd8cdbf9de672481f3964521 -->
70
+ <!-- /microi-progressive:chunk -->
71
+ <!-- microi-progressive:chunk id=workspace-conventions-016 sha256=ea4975115c96e1968ae32b8f2271b79288f99a35cd8cdbf9de672481f3964521 -->
72
72
  ## 后台任务与安全防护约定
73
73
 
74
74
  Microi 平台级长任务和安全防护属于系统能力，AI 修改框架、MCP 或 V8 示例时必须同步考虑：
@@ -82,8 +82,8 @@ Microi 平台级长任务和安全防护属于系统能力，AI 修改框架、M
82
82
  - 攻击事件、IP 封禁/解封记录应异步写入 MySQL `mci_` 表并写系统日志；同一 IP、同一原因、同一时间窗必须去重合并，不要重复写大量相同失败原因。
83
83
  - 手动封禁、手动解封、自动解封都要有审计记录。封禁响应要返回 DosResult 风格 JSON，便于前端明确提示。
84
84
 
85
- <!-- /microi-progressive:chunk -->
86
- <!-- microi-progressive:chunk id=workspace-conventions-017 sha256=f3f2f378b99fc5621ea9a6dd1b924a8db171ca8e55588f6b48d3ac4084306e41 -->
85
+ <!-- /microi-progressive:chunk -->
86
+ <!-- microi-progressive:chunk id=workspace-conventions-017 sha256=f3f2f378b99fc5621ea9a6dd1b924a8db171ca8e55588f6b48d3ac4084306e41 -->
87
87
  ## 业务逻辑优先接口引擎约定
88
88
 
89
89
  AI 为 Microi 平台新增或修改任何业务逻辑、后台工具、数据维护能力、官网流程、在线 AI 能力、导入导出、初始化、修复任务、页面配套接口或租户 SaaS 流程时，默认优先使用接口引擎实现，不要直接新增 `Microi.net.Api` Controller 或把业务分支写死到 C# 后端。
@@ -99,8 +99,8 @@ AI 为 Microi 平台新增或修改任何业务逻辑、后台工具、数据维
99
99
  - 第三方 HTTP 集成默认用 `V8.Http` 放在接口引擎；若平台密钥绝不能进入可编辑 V8，只在 C# 暴露最小、租户隔离、不可覆盖密钥的安全原子方法，业务字段选择、状态流转和页面动作仍由接口引擎/表单事件编排。
100
100
  - 平台级强制安全校验不能为了“全部低代码化”放进租户可编辑脚本而被绕过；可以留在 C#，但必须是通用、失败关闭的安全边界，不得夹带某个项目的业务文案、字段组合或状态机。
101
101
 
102
- <!-- /microi-progressive:chunk -->
103
- <!-- microi-progressive:chunk id=workspace-conventions-018 sha256=b5ed99d715e5fc5a62d5a9618397f0e40899b400f377dc3fedc41d18d6db73dd -->
102
+ <!-- /microi-progressive:chunk -->
103
+ <!-- microi-progressive:chunk id=workspace-conventions-018 sha256=b5ed99d715e5fc5a62d5a9618397f0e40899b400f377dc3fedc41d18d6db73dd -->
104
104
  ## 应用商城优先于 Microi.Upgrade（强制）
105
105
 
106
106
  能由应用包声明、差异安装和回读验收完成的升级，不得在 `Microi.Server/Microi.Upgrade/` 新增定制 .NET 升级类。表、字段、Tab、菜单、角色权限、接口引擎、表单事件、数据源、页面、打印、工作流、任务及可幂等安装的种子数据，默认都属于应用商城资源。
@@ -112,8 +112,8 @@ AI 为 Microi 平台新增或修改任何业务逻辑、后台工具、数据维
112
112
  - 允许的 .NET 迁移只能按持久化版本/迁移账本执行待办步骤，使用共享租约且业务幂等；禁止把新迁移同时加入版本链和“每次启动无条件全租户对账”列表。启动成本必须与待执行迁移数相关，不能随历史升级文件总数对每个租户线性增长。
113
113
  - 评审 `Microi.Upgrade` PR 时先做资源分类：若只是补字段、Tab 或低代码元数据，移出升级器并发布应用包；若保留 C#，必须提供双节点、重复启动、租约丢失、失败不推进版本以及旧新节点共存测试。
114
114
 
115
- <!-- /microi-progressive:chunk -->
116
- <!-- microi-progressive:chunk id=workspace-conventions-019 sha256=333125c854376da9f58b988c0ff2e4e94592de5437107182da838878ceb6b447 -->
115
+ <!-- /microi-progressive:chunk -->
116
+ <!-- microi-progressive:chunk id=workspace-conventions-019 sha256=333125c854376da9f58b988c0ff2e4e94592de5437107182da838878ceb6b447 -->
117
117
  ## 在线 AI 应用上下文默认发现规则（强制）
118
118
 
119
119
  AI 开始处理定制页面、弹窗、Web、UniApp、微服务或应用商城任务时，不能只搜索本地目录。只要当前 MCP 已连接到目标 `OsClient`，必须先读取在线 AI 应用上下文：
@@ -138,8 +138,8 @@ AI 开始处理定制页面、弹窗、Web、UniApp、微服务或应用商城
138
138
 
139
139
  如果 MCP 返回登录过期，必须先修复或刷新目标 MCP 身份，再继续把 MCP 读取结果当作当前事实；不能因为读取失败就假设在线应用不存在并重复创建。
140
140
 
141
- <!-- /microi-progressive:chunk -->
142
- <!-- microi-progressive:chunk id=workspace-conventions-020 sha256=4d3aef6042f7e43be7c2bf61430ce461bfb75bfb853b1ca000b0f5c5836eff7f -->
141
+ <!-- /microi-progressive:chunk -->
142
+ <!-- microi-progressive:chunk id=workspace-conventions-020 sha256=4d3aef6042f7e43be7c2bf61430ce461bfb75bfb853b1ca000b0f5c5836eff7f -->
143
143
  ## VS Code 插件空目录生成规则
144
144
 
145
145
  Microi.VSCode 面向普通用户时，用户本地可能只是一个空工作区。插件生成 AI 指令文件时不能假设用户已经有 `microi.skills/`、`Microi-V8-Engine/`、`AI-Project/` 或某个固定前端项目目录。
@@ -150,8 +150,8 @@ Microi.VSCode 面向普通用户时，用户本地可能只是一个空工作区
150
150
  - 生成文案必须明确：普通用户不需要手动克隆 skills，也不需要每次对 AI 说“严格遵循 microi.skills”；只要插件初始化成功，AI 就应默认按 skills 工作。
151
151
  - 插件升级时应继续保护用户本地修改过的 skill 文件，只覆盖插件曾生成且用户未改过的文件。
152
152
 
153
- <!-- /microi-progressive:chunk -->
154
- <!-- microi-progressive:chunk id=workspace-conventions-021 sha256=d6da1a47b1f8ed4b1ea863b052c5e1fa7767e2809c39abe4813ea000d9a30db6 -->
153
+ <!-- /microi-progressive:chunk -->
154
+ <!-- microi-progressive:chunk id=workspace-conventions-021 sha256=d6da1a47b1f8ed4b1ea863b052c5e1fa7767e2809c39abe4813ea000d9a30db6 -->
155
155
  ## Microi 版本号规则
156
156
 
157
157
  Microi 通用版本号采用 `主版本.次版本.修订版本` 三段数字格式，从 `1.0.0` 开始。每次发布时最后一位加 1；当某一位超过 `9` 时向前一位进位并将当前位归 `0`，例如 `1.0.9 -> 1.1.0`、`1.9.9 -> 2.0.0`、`9.9.9 -> 10.0.0`。
@@ -162,8 +162,8 @@ Microi 通用版本号采用 `主版本.次版本.修订版本` 三段数字格
162
162
 
163
163
  插件初始化或升级同步 `microi.skills/` 时，必须以 `.microi-skills-manifest.json` 的逐文件 hash 判断是否可覆盖：本地文件不存在则写入；本地文件与旧 manifest hash 一致说明用户未改，可自动升级；本地文件已被用户修改、或本地版本比插件捆绑版本更新时，必须保留用户版本并提示差异。不能因为插件版本号更高或更低，就粗暴覆盖本地 skills。创始人本地随时修改 skills 的工作区尤其要保护；普通用户未修改过的旧 skills 才应该被最新插件覆盖升级。
164
164
 
165
- <!-- /microi-progressive:chunk -->
166
- <!-- microi-progressive:chunk id=workspace-conventions-022 sha256=709c669676154b9b469feefad4761544a8cb29fba2e050262b26390c1c4e327c -->
165
+ <!-- /microi-progressive:chunk -->
166
+ <!-- microi-progressive:chunk id=workspace-conventions-022 sha256=709c669676154b9b469feefad4761544a8cb29fba2e050262b26390c1c4e327c -->
167
167
  ## C# dynamic 强类型落地规则
168
168
 
169
169
  后端源码中从 `dynamic`、`JObject`、`ExpandoObject`、表单参数或 `DynamicHelper` 读取出来的值，如果后续要调用字符串方法、扩展方法或参与强类型判断，必须先显式落到强类型变量。不要用 `var` 承接 `DynamicHelper.GetDynamicStringValue(...)` 后再调用 `DosIsNullOrWhiteSpace()` 这类扩展方法，因为调用点可能仍按 dynamic 绑定，运行时会出现 `'string' does not contain a definition for ...`。
@@ -184,25 +184,25 @@ if (string.IsNullOrWhiteSpace(tableName)) { return; }
184
184
 
185
185
  如果方法内部只通过 `DynamicHelper` 读取对象字段，方法参数优先声明为 `object`，不要声明为 `dynamic`。这样可以减少 C# 运行时动态绑定进入普通字符串工具链的机会。
186
186
 
187
- <!-- /microi-progressive:chunk -->
188
- <!-- microi-progressive:chunk id=workspace-conventions-023 sha256=91feb164525de8824674bd62eae72fc549d64ad253b0551d3504ecb7aba5bf51 -->
187
+ <!-- /microi-progressive:chunk -->
188
+ <!-- microi-progressive:chunk id=workspace-conventions-023 sha256=91feb164525de8824674bd62eae72fc549d64ad253b0551d3504ecb7aba5bf51 -->
189
189
  ## 根目录保留文件说明
190
-
191
- 根目录只允许存在以下类型的文件和目录：
192
-
193
- | 路径 | 说明 | 是否可删除 |
194
- |------|------|-----------|
195
- | `.github/` | GitHub Actions、Copilot 配置 | 否 |
196
- | `.venv/` | Python 虚拟环境，AI 代理使用 | 否（必要） |
197
- | `.vscode/` | VS Code 工作区配置 | 否 |
198
- | `microi.skills/` | 通用技能文档库 | 否 |
199
- | `Microi.Server/` | .NET 后端 | 否 |
200
- | `Microi.Client/` | PC 前端 Vue3 | 否 |
201
- | `microi-v8-engine/` | V8 接口引擎代码 | 否 |
202
- | `AI-Project/` | 各租户/项目 | 否 |
203
- | `switch-env.ps1` | 本地环境切换工具 | 否（有用） |
204
- | `.tmp/` | AI 临时文件（gitignored） | 可删整个目录 |
205
- | `.microi-e2e/` | Microi.VSCode 插件 E2E 产物 | 可定期清理 |
206
- | `.microi-performance/` | 性能测试报告 | 可定期清理 |
207
-
208
- <!-- /microi-progressive:chunk -->
190
+
191
+ 根目录只允许存在以下类型的文件和目录：
192
+
193
+ | 路径 | 说明 | 是否可删除 |
194
+ |------|------|-----------|
195
+ | `.github/` | GitHub Actions、Copilot 配置 | 否 |
196
+ | `.venv/` | Python 虚拟环境，AI 代理使用 | 否（必要） |
197
+ | `.vscode/` | VS Code 工作区配置 | 否 |
198
+ | `microi.skills/` | 通用技能文档库 | 否 |
199
+ | `Microi.Server/` | .NET 后端 | 否 |
200
+ | `Microi.Client/` | PC 前端 Vue3 | 否 |
201
+ | `microi-v8-engine/` | V8 接口引擎代码 | 否 |
202
+ | `AI-Project/` | 各租户/项目 | 否 |
203
+ | `switch-env.ps1` | 本地环境切换工具 | 否（有用） |
204
+ | `.tmp/` | AI 临时文件（gitignored） | 可删整个目录 |
205
+ | `.microi-e2e/` | Microi.VSCode 插件 E2E 产物 | 可定期清理 |
206
+ | `.microi-performance/` | 性能测试报告 | 可定期清理 |
207
+
208
+ <!-- /microi-progressive:chunk -->