@microi.net/cli 6.0.0 → 6.0.2

package/skills/v8-cache-pattern/SKILL.md

@@ -55,20 +55,20 @@ V8.Cache.HashDelete(hashKey, 'Reserved');
 平台 Redis 管理器固定路由为 `#/mci-redis-manager`：
 
 - Redis 管理器接口要求已登录且当前用户 `Level >= 9999`。它只接受 `tenant`（当前租户默认 Redis）和 `saved`（主租户 `mci_redis_connection` 中保存的额外连接）两种模式；当前源码明确拒绝 `temporary`，也没有匿名临时连接模式。
+- 从 v8.5.12 起，Redis 管理器由 `Microi.Cache` 强制实施租户边界：主租户身份以 API 宿主的 `OsClient` 配置为准，主租户超级管理员可管理当前受控连接中的全部 Key；子租户超级管理员只能扫描、读取和维护完整的 `Microi:{当前OsClient}:` 前缀，不能靠 `Level=9999`、请求参数或切换数据库取得主租户权限。精确读取、删除、覆盖、重命名的两端、TTL、批量删除和缓存失效均执行同一检查，批量请求中出现越权 Key 时整批拒绝。普通业务 `V8.Cache` 仍只允许当前租户。
+- 子租户只能选择当前连接配置的数据库；MCP 省略 `database` 时使用后端配置，不默认传 `0`。页面以 `CanSelectDatabase` / `AllowedKeyPrefix` 为事实，不能从前端账号等级推断。`*` 与普通搜索词自动限定当前租户，显式其它租户前缀直接拒绝。子租户统计不返回共享实例 INFO、DBSIZE 或节点全局 L1 统计；扫描样本数量通过 `KeyCountIsEstimate` 标识。
 - 保存连接记录必须按 `TenantOsClient` 隔离，密码只在后端保护并且不回传前端；调用方只传保存后的 `connectionId`。
 - Key 列表必须使用 `SCAN` 游标分页，禁止在生产 Redis 上使用阻塞式 `KEYS *`。内容查看支持 String、Hash、List、Set、Sorted Set、Stream；集合内容要分页并限制单次条数。
 - 写入 Hash/List/Set/Sorted Set 时先完整解析 JSON，再覆盖旧 Key；删除、覆盖、重命名和 TTL 变更属于破坏性操作，必须先展示目标连接、数据库与 Key 并要求明确确认。
 - 管理接口不开放任意 Redis 命令、Lua、`FLUSHALL` 或 `FLUSHDB`；批量删除最多 500 个 Key，重命名不覆盖既有目标。
 
-对应后端管理入口包括只读统计 `/api/cache/statistics`、节点 L1 精确失效
-`/api/cache/invalidate`、模式失效 `/api/cache/invalidate-pattern`，以及 Redis 管理器
-路由前缀 `/api/cache/redis/`。它们都属于受权管理能力，不是匿名业务 API。
+当前统一入口为 Managed 接口引擎 `platform-cache-manager`，通过 `V8.Method.ManageCache` 调用可信后端；旧 `/api/cache/*` 路由由兼容入口处理。节点全局 `Statistics` 只开放主租户，子租户使用受限 `RedisStatistics`。这些都是受权管理能力，不是匿名业务 API。
 
 MCP 默认操作当前 MCP `OsClient` 的租户 Redis；额外连接只传管理页保存后的 `connectionId`，禁止在 MCP 参数、日志或回答中传递 Redis 密码。
 
 | MCP 工具 | 用途 | 确认规则 |
 |------|------|------|
-| `microi_redis_statistics` | 服务器、内存、客户端、命中率与 Key 类型统计 | 只读 |
+| `microi_redis_statistics` | 主租户服务器统计 / 子租户命名空间 Key 样本统计 | 只读 |
 | `microi_redis_list_keys` | SCAN 分页检索 Key、类型、TTL、内存估算 | 只读 |
 | `microi_redis_get_key` | 分页查看单个 Key 内容 | 只读 |
 | `microi_redis_delete_keys` | 单个或批量删除，最多 500 个 | `confirmExecution="DELETE"` |
@@ -310,3 +310,7 @@ fire-and-forget；否则数千个 `SCAN/DEL/PUBLISH` 会同时进入同一个
 - 每个租户可能使用不同 Redis，订阅初始化状态不得用一个全局 `static bool` 共享；
 - 缓存实例必须保存创建时的准确 `OsClient`，按模式 `SCAN/DEL` 时直接使用该租户连接；禁止根据 Redis DB 编号反推连接，因为不同租户可能在不同服务器上使用相同 DB 编号；
 - 等待发布只解决回压，业务写入和缓存失效仍需保持 `OsClient` 隔离及可重试幂等。
+
+## Redis 管理隔离验收
+
+使用已登记的隔离主/子租户，在同一 Redis 数据库创建有短 TTL 的唯一测试 Key，逐个验证两台 API：子租户正常维护自身 String/Hash/List/Set/Sorted Set；扫描不返回主租户或相似前缀；读取、混合批删、跨前缀重命名、TTL、覆盖和失效越权全部拒绝，拒绝后由主租户回读原值未变。验收后只清理登记的测试 Key。禁止用官方业务租户做可写 Full，也不能用物理分库替代 Key 授权测试。

package/skills/v8-export-import/SKILL.md

@@ -217,3 +217,8 @@ return { Code: 1, Data: dataList, DataCount: dataList.length };
 - 父子表边界：固定父记录外键优先于 Excel 同名列；接口引擎仍须核对目标表、项目/主记录存在性、业务状态和额度。需要整批钩子的模块禁止 `ContinueOnError`。
 - 重复提交：客户端每次重新选择文件生成新的 `_ImportIdempotencyKey`，同一 HTTP 重试沿用该键；服务端按租户、表、菜单、用户和请求键保存状态，`Pending/Running/Succeeded` 均不得重复创建写入任务。该机制不等同于“相同文件作为新请求再次上传”的内容判重。
 - 自动化检查：至少覆盖同批汇总超量、稳定行锁先于累计回查、整批回滚、父外键不可被 Excel 覆盖、同一请求重试只写一次，以及错误中包含行号和业务上限明细。
+
+## 替换导入接口的上传与重试验收
+
+- `ImportApi` 相对地址必须按当前 `ApiBase`（含路径前缀）解析，并携带当前登录与租户上下文；完整地址和 `$ApiBase$` 继续兼容。nginx HTTP 405 可能源于前端误向静态站点上传，先核对实际请求 URL，不能据错误页排除代码问题。
+- 同步替换接口返回 `Code=1`，未配置 `ImportProgressApi` 且没有运行中状态时，直接展示最终结果与行数；不得查询它从未写入的标准导入进度。异步替换接口须配置进度协议。明确失败后重试必须把保留的原文件重新放入上传队列，同时保留映射与操作标识；HTTP 200 的 `Code=0` 也属于失败。超过 90 秒的未完成请求只提示等待并阻止重复提交，不能把等待时间当成失败、自动重放或宣称服务端已取消。自定义接口幂等仍需由业务实现。验收覆盖真实 multipart、同步成功、HTTP 405、同文件重试、迟到回调与标准异步兼容。

package/skills/v8-file-upload/SKILL.md

@@ -7,6 +7,10 @@ description: Microi V8 与 MCP 文件上传下载指南。用于处理流式 AI
 
 # Microi V8 文件上传下载
 
+## 源码仓库资源隔离（默认强制）
+
+截图、配图、PDF/PPT、音视频、压缩包、模型、安装包和其它大体积交付资源统一通过 MCP 上传 CDN，禁止提交到 Gitee/GitHub 源码历史，即使压缩到小于 1 MB 也不能把截图或附件改放源码仓库。官方资源使用已校验的 `microi_itdos`（`https://api.itdos.com + OsClient=iTdos`）公有桶与 `https://file.microi.net` 前缀；私有资料按租户实际权限保持私有。源码只存 URL、字节数、SHA-256、MIME 等轻量清单。上传后独立回读实际字节和类型，PDF 验证 Range；超过 Base64 协议容量使用流式/分片工具。暂存区及每个待推送提交都须排除资源本体，详细门禁遵循 [工作区默认 CDN 规范](../workspace-conventions/SKILL.md#截图与大体积资源必须走-cdn默认强制)。
+
 你正在为 Microi 吾码平台编写文件上传/下载/返回相关代码。平台分布式存储（HDFS）支持阿里云OSS、MinIO、亚马逊S3，存储方案由 SaaS 引擎按租户配置。上传对象的 `Content-Type` 由框架按实际对象路径统一确定，覆盖 HTML、JS/MJS、CSS、JSON/MAP、SVG、字体与 WASM，未知后缀保留 `application/octet-stream`。MinIO、S3、OSS 普通与分片上传使用同一映射；该映射不替代上传权限、内容和配额校验。旧对象不会因后端升级自动改变元数据：先核对字节数和 SHA-256，再修正类型或按正式应用发布流程产生新版本。不要把源码与公有编译产物混在一起，也不要关闭 `nosniff` 掩盖类型错误。
 
 文件与发布测试默认使用当前 MCP 连接下、当前租户实际生效的 HDFS Provider；先只读核实提供商与对象范围，沿已授权隔离前缀执行公私权限、原始字节、哈希、MIME 与写后回读断言。已确定当前环境后，不再为其它 OSS/MinIO/S3 反复询问或新建存储；仅明确的提供商缺陷、迁移或兼容任务才扩展矩阵，并逐项报告真实执行与未覆盖范围。提供商不可用或断言失败必须保留真实错误，不能换提供商或省略回读来冒充通过。

package/skills/v8-security/references/progressive-01-2-/346/235/203/351/231/220/346/240/241/351/252/214.md

@@ -2,7 +2,7 @@
 
 > 按需读取；本文件由 SKILL.md 的原章节无损拆分。
 
-<!-- microi-progressive:chunk id=v8-security-005 sha256=09f88aaf8da914fdbec8bc8668cef588a02217354a210515230471fbfdddd27f -->
+<!-- microi-progressive:chunk id=v8-security-005 sha256=657db8189d96c594073735e9182af9d3e9a91f4f7dd111ecf2c7fe1eec6d7ede -->
 ## 2. 权限校验
 
 ### DiyToken 是平台会话与权限入口，不替换为 ASP.NET Identity
@@ -16,6 +16,14 @@ DiyToken 与 `sys_user`、`OsClient`、终端 `did`、共享 Redis 登录态、
 
 开发新登录入口时只实现“验证身份 -> 获取仍启用的 `sys_user` -> 签发 DiyToken”，禁止并行创建第二套用户、角色、权限 Token 或会话有效期规则。
 
+### MCP 角色开发授权
+
+`Level >= 9999` 保留完整 MCP 权限及授权管理入口。其他账号须由超级管理员在开发工具连接窗口或角色编辑中明确授予 `McpDevelopment`，两处使用同一 `sys_rolelimit` 记录和并发版本；没有记录、损坏或重复配置一律拒绝。
+
+每次请求从当前租户主库复核活动用户、有效角色、模块/表及操作开关。访问范围与创建/修改、删除必须由同一角色同时满足；Full 只读与 Role 写入不得合成 Full 写入。Role 范围只支持明确白名单的安全元数据编辑及保留行/字段授权的业务操作，不开放可执行脚本、SQL、数据源或权限配置。已验签的 MCP/VSCode 会话也不能改走普通 FormEngine/接口引擎 HTTP 绕过限制。
+
+仅对获准的 MCP 调用，完整范围且同时具有创建/修改、删除的角色可作为可信开发者执行服务端开发；这类权限能够间接访问或修改数据，不得宣传为隔离的纯界面编辑。它不改变账号 Level，不放宽普通后台管理入口，不允许普通账号改写 MCP 授权。撤销须即时生效；受限角色、完整只读、写但不可删、多角色组合、普通 HTTP 绕过、跨租户、旧 Token 与并发授权保存必须纳入验收。
+
 ### 平台 FormEngine 授权边界
 
 **Token 只完成身份认证，不是任意表的访问凭证。** 来自浏览器、UniApp、SDK 或其它外部客户端的通用 FormEngine 请求，必须由服务端完成以下授权，V8 或前端代码不得自行模拟、放宽：
@@ -39,7 +47,7 @@ DiyToken 与 `sys_user`、`OsClient`、终端 `did`、共享 Redis 登录态、
 
 跨租户公共发现接口可以匿名，但返回值必须采用严格字段白名单，只返回公开标识和展示信息，禁止返回 `ApiKey`、上游 Endpoint、连接串或内部配置。例如官方 AI 中转模型清单应保持 `IsEnable=1`、`StopHttp=0`、`AllowAnonymous=1`，且只返回模型 Id、展示名等公开字段；将这类被其它租户服务器调用的发现接口误改为非匿名，会让所有消费者得到空模型列表或 `NoAuth`，属于破坏性配置变更。发布和升级后必须用无 Token 的真实 HTTP 请求验证返回字段与匿名状态。
 
-> 后端接口引擎、后端表单 V8 和平台内部调用由服务端在构造参数时设置不可由 HTTP JSON 注入的 `_TrustedServerInvocation`，因此调用 `V8.FormEngine` 不要求 `_SysMenuId`。`_InvokeType:'Server'` 只是事件调用语义，不是外部客户端可用的授权开关；普通用户即使在请求中伪造这两个字段也不能成为可信调用。任何能让普通用户写 V8、接口引擎、任务或数据源配置的管理入口本身都必须限制为 `Level >= 9999`，否则会重新获得任意数据执行能力。
+> 后端接口引擎、后端表单 V8 和平台内部调用由服务端在构造参数时设置不可由 HTTP JSON 注入的 `_TrustedServerInvocation`，因此调用 `V8.FormEngine` 不要求 `_SysMenuId`。`_InvokeType:'Server'` 只是事件调用语义，不是外部客户端可用的授权开关；普通用户即使在请求中伪造这两个字段也不能成为可信调用。能写 V8、接口引擎、任务或数据源的普通管理入口仍限制为 `Level >= 9999`。MCP 唯一例外是上节明确授权的 Full 范围且同时具有创建/修改、删除权限的可信开发角色，并须通过 MCP 专用逐请求鉴权；不能由菜单授权或请求参数推导此例外。
 
 > 外层 `AddFormData` 的客户端菜单/`Add` 权限校验与事件内部执行权是两件事：前者防止无新增权限的用户进入事件，后者允许已经进入的 `SubmitBeforeServerV8` / `SubmitAfterServerV8` 像接口引擎一样在当前租户内执行复杂 SQL、跨表事务和其它表 CRUD。不要把客户端菜单范围再次套到服务器 V8 的嵌套调用。
 

package/skills/workspace-conventions/SKILL.md

@@ -5,6 +5,29 @@ description: 每次 Microi 任务开始前必读的基础规范。用于识别
 
 # Microi 工作区全局约定
 
+## 截图与大体积资源必须走 CDN（默认强制）
+
+- 截图、宣传配图、PDF、PPT/PPTX、视频、音频、模型、压缩包、安装包、导出报告及其它大体积资源不得提交或推送到 Gitee、GitHub 等源码仓库。截图和交付附件无论压缩后是否低于大小阈值都走 CDN；禁止通过 Base64、Git LFS、分卷、改后缀、强制暂存或中间提交绕过。一般“提交并推送”的授权不能解除此规则，也不再走“先上传大文件到 Git 再处理”的路径。
+- 吾码官方公开资源必须通过已核验 `https://api.itdos.com + OsClient=iTdos` 的 `microi_itdos` MCP 上传公有桶，并使用 `https://file.microi.net` 前缀访问。普通客户资源使用已授权租户 MCP 与实际 CDN/FileServer，敏感、私有资料保持私有权限，不能为了公开链接改为公有桶。大文件使用已有流式/分片上传能力，不绕过 MCP 直接使用存储密钥。
+- 源码只保存必要代码、轻量可编辑模板、CDN URL、文件名、字节数、SHA-256、MIME 和必要生成说明；原图、压缩件、PDF、下载校验缓存放任务专属临时目录，交付后按清理规则回收。上传成功后必须独立下载核对字节数、哈希和真实 MIME；PDF 同时检查 Range 分段读取。未知上传结果先回读，不能盲重传。
+- 提交前检查暂存区，推送前以刚核验的远端引用检查全部待推送提交的新增 Blob；既查资源类型，也查单个 10 MiB / 合计 50 MiB 的体积门槛。发现禁止入库资源就停止受影响的提交/推送，迁移 CDN 并从本次候选索引/提交中排除；中间提交加入后又删除也不合格。不得改写共享历史、删除用户本地原图或清空既有仓库。必要运行依赖另按真实用途审查，但不能借此提交截图和交付附件。
+
+完整上传与回读流程见 [文件上传下载规范](../v8-file-upload/SKILL.md)，Git 对象检查与历史边界见 [Git 大文件推送检查](references/progressive-03-cli-与-ide-插件错版共存约定.md#git-大文件推送检查强制)。
+
+## 测试临时文件必须随任务清理（强制）
+
+本节适用于开发、测试、诊断和发布产生的全部自有临时资产，包括工作区根 `.tmp/`、宿主临时目录（如 `$CODEX_HOME/tmp`）和隔离 Git worktree，并替代历史“任务完成后可以不清理”的约定。目录位置和 `.gitignore` 不改变收尾责任。
+
+- 创建前使用独立的 `.tmp/<任务标识>/`，登记本任务创建的目录、文件、进程及用途；不得混用其它任务目录。每轮测试成功、失败、取消或中断退出时都执行 `finally` / teardown，先关闭本任务的写入者、浏览器和临时服务，再删除本轮已无用途的临时文件；不能等用户再次要求清理磁盘。
+- 默认删除本任务的一次性脚本、下载/解压副本、编译输出、隔离依赖、测试夹具和冗余截图/trace/video/日志。交付必需的少量报告、关键截图、发布哈希/回执先脱敏并归档到对应项目的长期交付目录，回读归档完整后再删临时副本；不得把完整构建树、源码副本或依赖目录当作验收证据长期留存。
+- 失败仍需排查或下一阶段确实依赖的文件，只保留可解释的最小集合，记录路径、体积、原因、归属和清理时机；排查/依赖结束后立即删除。崩溃来不及执行 teardown 时，下次接续先核对自有清单并补清；不能以“测试失败”“以后可能有用”为由无限保留。
+- 隔离副本只为实际并发冲突或构建输入冻结创建，优先复用合适的工作树、稀疏检出和最小夹具；禁止每次重试复制整套源码、Git 历史、依赖、SDK 和运行目录。创建前盘点源盘与目标盘可用空间及已有同类副本，按本轮实际需求估算新增体积；测试结束先回收旧运行/编译目录，再创建下一轮。不要把临时目录移到另一块盘当作清理。
+- 工作树不是永久保留项：任务结束逐仓检查未提交、未跟踪、忽略文件和未推送提交，已合入/已归档且无活动引用的副本按 Git/宿主支持的方式移除并回读注册表；必要差异先最小归档并校验可恢复性，不复制完整构建树。嵌套独立 Git 仓库逐个核对；禁止因存在 `.git` 就跳过整个任务目录，也禁止把主工作区存在当成差异已安全保存的证明。
+- **规则必须落到执行入口**：新增或维护测试、构建、发布脚本时，将自有临时资产回收写入实际的 `finally`、测试框架 teardown/after hook 或宿主归档流程，并验证成功与失败退出均回收。`Microi.Tests/run-tests.ps1` 的 Full 隔离 `.net-artifacts` 由入口自动回收，保留结果报告与 `artifact-cleanup.json`；已有共享目录不取得删除权。仅修改 Skill、模型读过规则或工具显示最新版，都不能声称自动清理已生效；须检查已安装正文及实际执行结果。硬崩溃/强杀可能跳过收尾，恢复时按归属清单补清，不能承诺任意中断都即时删除。
+- 删除前核验解析后的绝对路径位于本任务 `.tmp` 子目录，检查重解析点/符号链接、当前进程 CWD/文件锁、Git worktree 与未提交源码、发布锁以及虚拟机/容器引用。保留用户文件、唯一源码/未提交改动、正式交付物、共享资源和其它任务资产；独占 Git 工作树先按 Git/宿主支持的移除方式完成检查，不能直接递归删除。
+- 历史垃圾清理先做体积与引用盘点，只删已核验无引用、无跟踪源码且可再生成的产物；文件名含 `.tmp`、目录名为 `bin/obj` 或时间较旧都不能单独证明可删。禁止整体清空共享 `.tmp/`，禁止为了清理结束其它任务或重启 Docker/WSL。
+- 清理后独立回读已删路径不存在、保护对象仍在和磁盘可用空间；收尾报告删除体积、剩余保留项和原因。遇到文件锁、权限或自动审批拒绝时保留目标并准确报告，禁止换工具绕过。测试通过与临时文件清理完成是两个验收项，不能互相代替。
+
 ## 质量优先与适用范围
 
 准确性、业务完整性、安全和真实验收优先于 token 与回复长度。先确定完整系统、局部修改或只读分析；新建系统意图按完整交付，不能因短提示词或预算缩小八项清单及菜单/报表增补。局部修改定位真实目标和依赖，信息不足、动态关系或影响不明时扩大读取，不凭摘要猜测或写入。
@@ -14,7 +37,7 @@ description: 每次 Microi 任务开始前必读的基础规范。用于识别
 工作区保护始终有效：保留他人差异与共享进程，临时产物只放根 `.tmp/`，闭源源码只从独立内部仓提交。修改/提交前读取 [共享工作区与 Git 保障](references/progressive-04-工作区与平台专项保障.md#多对话共享工作区变更归属保护强制)；启动构建、测试服务或浏览器前读取同文件资源/OOM规则并检查现有资源。后端/任务/权限变更读取分布式与安全章节；平台源码定位、文档和 Skills 修改读取对应章节。平台能力四项检查仍固定保留在本入口。
 
 <!-- microi-progressive:begin -->
-<!-- microi-progressive:chunk id=workspace-conventions-000 sha256=0b8322a967e67a45f195860314357a7b974555b6f3d0b642fe910dc769bd7e23 -->
+<!-- microi-progressive:chunk id=workspace-conventions-000 sha256=aca51a9aec956dd31d4865eeb25b3d33452106b363659970773b40b48d22e346 -->
 ## 任务启动前 Skill 读取规则（强制）
 
 AI 处理任何 Microi 低代码、V8、MCP、OpenClaw、采集引擎、前端、后端、UniApp、文档、测试或交付任务前，必须先按任务类型读取相关 `microi.skills/**/SKILL.md`。不能等到写代码或出问题后才补读。
@@ -59,7 +82,7 @@ AI 处理任何 Microi 低代码、V8、MCP、OpenClaw、采集引擎、前端
 - 官方或社区独立业务应用、游戏及客户项目的测试归应用自身源码根的 `tests/` 或独立测试工程，由该应用自己的测试和发布入口执行；不得放入 `Microi.Tests`、创建转调包装或接入平台 Quick/Full。官方发布身份不改变测试归属。应用开发中涉及平台通用缺陷时，仅把通用最小回归夹具加入平台门禁，应用业务断言仍在应用项目维护。
 - `Microi一键编译发布.sh` 的所有 PC/API 镜像路径（包括仅推送、热修复）都必须先通过按指定 MCP 实际依赖选定的 Full 发布矩阵；选中范围内缺少环境、零用例、失败、取消、跳过、待办或无法解析测试结果一律停止。未纳入本次矩阵的提供商标为“不适用（未执行）”，不冒充通过，也不单独阻塞常规发布。禁止关闭断言、删测试、排除已选失败项目或修改门禁阈值来发布。
 - 测试成功必须绑定本次候选源码和实际构建上下文的内容哈希，构建后、每次推送前复核。旧产物没有可验证回执或源码/产物漂移时必须重建重测，禁止“当前源码通过测试 + 推送另一份旧 DLL/前端 dist”。 所有测试默认使用当前 MCP 经同源只读发现的 MongoDB 实际版本与当前租户实际生效的 HDFS 提供商；目标唯一时直接沿已授权隔离范围执行，不为旧 MongoDB 或其它 OSS/MinIO/S3 反复询问、新建服务或替换当前提供商。只有明确的兼容、迁移或提供商缺陷任务才扩展真实矩阵；未执行项如实记未覆盖，不以同一端点冒充多版本，也不因环境发现获得生产业务写入授权。
-- 常规发布只验证用户指定 MCP 对应的实际依赖：MySQL、MongoDB 实际版本、Redis，以及租户实际生效的 MinIO 或 OSS/HDFS 等存储；不默认同时验证所有数据库版本或所有存储提供商。先核实 Profile、ApiBase、OsClient 和依赖类型，在已授权隔离范围执行；依赖发现不扩大生产写入或新建 Docker 测试依赖的授权。
+- 常规发布只验证用户指定 MCP 对应的实际依赖：MySQL、MongoDB 实际版本、Redis，以及租户实际生效的 MinIO 或 OSS/HDFS 等存储；不默认同时验证所有数据库版本或所有存储提供商。先核实 Profile、ApiBase、OsClient 和依赖类型，在已授权隔离范围执行；默认复用已配置依赖，不因本地无容器另建服务；依赖发现不扩大生产业务写入、付费资源或用户明确禁止的操作范围。
 - SQL Server 的真实连接、提供商兼容与专项验收默认不纳入常规发布矩阵；只有用户明确指定排查、修复或验收 SQL Server 问题时才执行。检测到 SQL Server 连接/驱动、旧 Full 清单或通用数据库代码变更都不能自行触发该专项，也不需要每次申请 SQL Server 免测。既有不连接 SQL Server 的离线单元断言照常保留，但不能据此声称 SQL Server 已实测。
 - 交付记录逐项列明修复与测试映射、执行数量、未覆盖边界和镜像摘要。覆盖率与 Full 都不能证明所有租户业务、任意生产数据和第三方系统绝对无误；真实客户路径仍需只读验收。详细矩阵见 `microi-system-delivery/references/progressive-02-自动化测试必须覆盖的坑.md`。
 
@@ -114,6 +137,6 @@ AI 在任何新建或已有对话中处理 Microi吾码任务并向用户输出
 
 - [references/progressive-01-版本更新日志保护规则-强制.md](references/progressive-01-版本更新日志保护规则-强制.md)：版本更新日志保护规则（强制）；配置文件说明中文优先规则；后端 API 配置白名单与 SaaS 单一事实源（强制）；身份、可逆业务秘密与敏感操作统一规范（强制）；多语言优先约定；后台菜单层级默认规则；后台任务与安全防护约定；业务逻辑优先接口引擎约定；应用商城优先于 Microi.Upgrade（强制）；在线 AI 应用上下文默认发现规则（强制）；VS Code 插件空目录生成规则；Microi 版本号规则；C# dynamic 强类型落地规则；根目录保留文件说明
 - [references/progressive-02-microi-net-api-本地启动约定.md](references/progressive-02-microi-net-api-本地启动约定.md)：Microi.net.Api 本地启动约定；多 AI 对话共享本地服务与发布互斥（强制）；本地租户与测试凭据读取约定；自动化登录约定；V8 远端/本地同步收尾约定；V8 缓存刷新约定；MCP 元数据更新验收约定；MCP 可用性排查约定；MCP 写入超时与降级约定；Codex MCP 单入口约定；.venv Python 环境说明；后端代码改动后的重启验收；MCP 可调用性诊断补充；Windows MCP 控制台闪窗复盘
-- [references/progressive-03-cli-与-ide-插件错版共存约定.md](references/progressive-03-cli-与-ide-插件错版共存约定.md)：CLI 与 IDE 插件错版共存约定；Git 大文件推送确认
+- [references/progressive-03-cli-与-ide-插件错版共存约定.md](references/progressive-03-cli-与-ide-插件错版共存约定.md)：CLI 与 IDE 插件错版共存约定；Git 大文件推送检查
 - [references/progressive-04-工作区与平台专项保障.md](references/progressive-04-工作区与平台专项保障.md)：工作区与平台专项保障
 <!-- microi-progressive:end -->

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

@@ -2,13 +2,16 @@
 
 > 按需读取；本文件由 SKILL.md 的原章节无损拆分。
 
-<!-- microi-progressive:chunk id=workspace-conventions-010 sha256=d4ee69df49b8cba8d6365f485bd44aab8f5fcccc4cc1c8394220af14ff68f83f -->
+<!-- microi-progressive:chunk id=workspace-conventions-010 sha256=f123b0b70030df276188dbb77617c41f74767ab27ea38d5472634cc3b6beca8b -->
 ## 版本更新日志保护规则（强制）
 
 - 日常功能开发、缺陷修复、测试、普通文档补充、Skill 完善和代码重构期间，不得修改 `microi.doc/docs/doc/about/update-log.md`。
 - 只有用户明确提出“发布版本”“准备发版”“更新版本日志”或直接点名要求修改该文件时，才允许编辑更新日志；“完善文档”或“补充官网说明”不等于授权修改版本日志。
 - 如果本轮误改了更新日志，必须先按上节完成多对话归属核验；只撤回有本对话精确写入证据的 hunk。必须保留用户、其它对话或其它任务的已提交和未提交内容，归属不明时不得修改并应询问用户。
 
+- 编写正式更新日志必须以“上一条已发布更新日志所对应的正式候选”为起点，逐仓核对到本次冻结候选之间的全部提交、合并和最终文件差异；不能只取最后一次提交、最后一次推送或仅看当前任务。历史改写导致的等价提交按内容去重，合并提交需要核对实际引入的功能。保留起止提交、逐项来源与纳入/排除原因的本地审计记录；客户私有业务、生成文件与重复提交不得凑成平台功能条目。
+- 页面版本断档（例如 v8.5.6 后直接是 v8.5.11）时，查验中间各正式版本的候选及渠道回执并补齐可证实的遗漏，不能把当前候选新增功能倒写为历史版本已发布。历史条目补充需用户的更新日志授权；本次新版本单列，并区分代码已完成、制品已发布与客户部署。日志内容不能以“六条概括”替代完整区间核对，也不能因条数少直接推断缺失。
+
 <!-- /microi-progressive:chunk -->
 <!-- microi-progressive:chunk id=workspace-conventions-011 sha256=8e3904f45392b7c27746de274bbc4725a7eb0964f0aeab1d83918c0174336dc4 -->
 ## 配置文件说明中文优先规则
@@ -186,7 +189,7 @@ if (string.IsNullOrWhiteSpace(tableName)) { return; }
 如果方法内部只通过 `DynamicHelper` 读取对象字段，方法参数优先声明为 `object`，不要声明为 `dynamic`。这样可以减少 C# 运行时动态绑定进入普通字符串工具链的机会。
 
 <!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=workspace-conventions-023 sha256=4ef009cbfca343640e69ccdb6be47f3cb13ad8a67f9ff770debce20c919f1bb3 -->
+<!-- microi-progressive:chunk id=workspace-conventions-023 sha256=44d2ca45e8fb85bb86f2f84f3fad09abc0687fb89f9e0e4f624917d258d485c3 -->
 ## 根目录保留文件说明
 
 根目录只允许存在以下类型的文件和目录：
@@ -202,7 +205,7 @@ if (string.IsNullOrWhiteSpace(tableName)) { return; }
 | `microi-v8-engine/` | V8 接口引擎代码 | 否 |
 | `AI-Project/` | 各租户/项目 | 否 |
 | `switch-env.ps1` | 本地环境切换工具 | 否（有用） |
-| `.tmp/` | AI 临时文件（gitignored） | 可删整个目录 |
+| `.tmp/` | AI 临时文件（gitignored） | 按任务归属清理，禁止整体清空共享目录 |
 | `.microi-e2e/` | Microi.Agent 插件 E2E 产物 | 可定期清理 |
 | `.microi-performance/` | 性能测试报告 | 可定期清理 |
 

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

@@ -2,16 +2,17 @@
 
 > 按需读取；本文件由 SKILL.md 的原章节无损拆分。
 
-<!-- microi-progressive:chunk id=workspace-conventions-039 sha256=8cfc7d1e2a6a0a766845c79775efe8c7fb15ef805a47e8bc1965128e348f3062 -->
+<!-- microi-progressive:chunk id=workspace-conventions-039 sha256=6a24718aa7e8b1b34cc6ff212d5a8331976d338bb60d99401c256c469e522a67 -->
 ## 本地测试程序与依赖生命周期（强制）
 
 - 启动前盘点当前源码/Vite/API、数据库、Redis、MongoDB、MinIO、端口及其归属。健康且适用的开发/测试服务优先复用；已有服务不满足时，优先直接启动本地源码，或把本轮编译产物复制到任务隔离目录启动，避免锁住共享构建输出。登记实际源码、配置来源、PID、创建时间、工作目录和监听端口；不能启动另一份旧 DLL 冒充当前候选。
 - 多节点 HTTP、并发和租户隔离测试优先使用多个本机吾码程序进程，连接同组已授权依赖；库、租户、Schema、Redis DB/Key 前缀和存储命名空间负责测试隔离。`fixture`、独立候选目录和 Full 不等于每个 AI 对话或节点都要创建一整套 Docker。复用仅限已授权开发/测试资源，不向生产业务库注入测试数据，也不对共享服务进行破坏性故障测试。
-- 普通联调、登录、表单、V8 和浏览器验收不默认创建本地 Docker/Compose。确实只能通过指定引擎/版本、容器安装或镜像行为验证时，先说明既有依赖为何不能满足、最少容器清单、资源上限和收尾方式，并取得对该动作的明确授权；已授权同一清单不重复询问。一般开发、Full 和镜像发布授权不自动授权新增数据库等测试服务。已授权镜像的构建、推送和不启动容器的镜像字节检查按各自制品流程执行，不能扩张为启动整套测试基础设施。
+- 普通联调、登录、表单、V8、Full 和镜像发布默认复用当前 MCP 对应的 MySQL、Redis、MongoDB、MinIO/OSS 等实际依赖，包括已配置的远端依赖；本机没有容器不等于缺少测试环境。先核实连接归属、实际版本、可用性和安全隔离范围，通过独立测试库、租户、Redis Key 前缀或专用 DB、对象前缀隔离，不能向生产业务库写测试数据，也不能清空共享 Redis、Bucket 或其它任务的数据。
+- 不要把“是否允许临时创建测试容器”作为常规确认步骤，也不要因为旧夹具已删除就改为新建一套服务。只有已经验证现有 MCP 依赖、既有测试服务及本地程序均无法满足本次具体协议/版本验收时，才记录不能复用的证据，采用最小必要替代方案；确需临时容器时限定资源、仅监听回环地址、登记归属和清理器，按本次用户明确边界执行。一般可逆测试实施细节不重复索取许可；涉及真实数据处置、额外费用或用户禁止的操作时仍遵守相应边界。
 - 创建或借用前建立资源台账，区分既有、借用和本轮新建；容器登记完整 Id、任务标签、数据挂载及消费者，进程登记 PID、创建时间、命令入口、工作目录和后代。共享依赖有唯一协调者，消费者退出不删除其它任务仍在使用的服务，也不能把他人资源仅凭名称认领为本任务资源。既有共享开发服务必要重启后的替换进程继承共享身份，收尾时保持健康；任务专用实例仍须结束，不能改称“共享服务”来免除清理。
 - 每轮验证成功、失败、超时、取消、异常或资源门限不足退出时，都立即执行收尾，不等整个功能交付完成。脚本用 `finally` 并处理可捕获的中断；启动到一半失败也回收已创建资源，外层监督程序退出时由已登记归属的清理器兜底。停止本轮自建 API/Vite/测试程序、watcher、浏览器及其子进程，以及获准新建的临时容器；不因“待续”长期保留运行资源。确需继续后台运行时，记录用户要求、负责人和有效期限。
 - 清理前重验精确身份，正常停止后独立回读进程及后代已退出、监听/连接已消失、容器已停止或移除；只输出白名单状态，不回显口令、Env 或连接串。既有或借用的共享实例保持原状态，不按进程名全杀，不执行全局 Docker prune、WSL/Docker 重启或删全部编排。
-- 数据保留与运行资源分开处理：移除临时容器前核对实际持久卷；没有数据卷时，先归档唯一数据或只停止保留容器。Redis 等关闭持久化时，保留空卷不能代替保存内存状态，应先通过现有安全连接显式保存并校验落盘。资源紧张时避免默认使用 fork 式后台保存；保存失败或超时不得无限重试或删除唯一数据，应先停止写入消费者、保留容器与卷、列明失败，并采用有界恢复方案或请求数据处置决定。默认不删除数据卷、绑定目录、镜像及测试证据，不使用 `rm -v` 或 `down -v`；删除这些数据需要对应的明确授权。
+- 数据保留与运行资源分开处理：自建且只含可重建测试数据的临时容器、专用测试卷、任务目录和测试命名空间，用完即按登记归属精确删除并独立回读，不能只停止容器或以“下次可能用到”为由积累。共享依赖、既有卷、缓存镜像、用户数据和其它任务资源不在清理范围。若临时资源含唯一业务数据或归属不明，先归档最小必要数据并验证，不能以清理名义删除；需要数据处置决定时明确指出具体对象。Redis 关闭持久化时，保留空卷不能代替保存唯一数据；避免资源紧张时默认 fork 保存。禁止全局 `prune`、通配删除或对共享编排使用 `down -v`。
 - 资源不足时先盘点并收回本任务闲置/遗留的进程和临时容器，再重新测量，不能留下自建数据库占用后要求用户关闭应用。测试结果、清理结果、数据保留和渠道发布分别记录；清理失败必须列出精确资源及原因，不能声称“已全部退出”或用减少用例、关闭断言、放宽发布门禁代替恢复环境。
 
 <!-- /microi-progressive:chunk -->

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

@@ -2,7 +2,7 @@
 
 > 按需读取；本文件由 SKILL.md 的原章节无损拆分。
 
-<!-- microi-progressive:chunk id=workspace-conventions-038 sha256=1dd79589434568ac963b144f4278707e4836bf477181b5e7a3a82c0275d3189e -->
+<!-- microi-progressive:chunk id=workspace-conventions-038 sha256=5dbfb261596e9c61fcc330adca7a1ff40a3a1508cd89be3c7b10410e591aa557 -->
 ## CLI 与 IDE 插件错版共存约定
 
 - CLI 与 IDE 插件共用配置、Token、MCP、Skills 或生成文件时，所有持久化协议必须按“新字段可选、旧字段保留、未知字段不删除”设计。不得将 JSON 解析到旧类型后只序列化已知字段。
@@ -24,11 +24,11 @@
 - 根因：新 scope/新版本在 npm 网站、写入节点和公共 registry 读取节点之间存在短暂传播窗口；固定少量、短间隔轮询不足以区分“尚未发布”和“已经接收但尚未公开传播”。
 - 通用规则：发布命令成功和公共回读确认必须作为两个阶段记录。npm 新版本回读使用 `--prefer-online` 和分钟级有限重试；重试结束仍为 E404 时标记 `pending-propagation`，禁止自动重发同一不可变版本，并提供独立只读验证命令稍后确认。只有发布命令本身失败且公共 registry 也始终不存在时，才进入补发流程。
 - 自动化检查：模拟 `npm publish` 成功后前几次 `npm view` 返回 E404、随后返回期望版本，断言不会重复发布；再模拟重试窗口结束仍为 E404，断言输出待传播状态和只读验证命令，而不是提示重新上传同一版本。
-## Git 大文件推送确认（强制）
+## Git 大文件推送检查（强制）
 
 - 每次 Git 推送前检查暂存内容及全部待推送提交中新引入的 Blob，不能只看工作树、最新提交或首尾文件差异；中间提交加入后又删除的大文件仍会进入历史。以刚核验的远端引用为基线，结合 `git rev-list --objects` 与 `git cat-file --batch-check` 检查真实对象大小；基线或对象不完整时先补齐并复核，不能绕过检查。
-- 默认将单个新增 Blob 达到 **10 MiB**，或本次新增 Blob 合计达到 **50 MiB** 视为需要确认的大文件推送。列出具体路径、实际字节数、SHA-256、目标仓库/分支及合计体积，向用户明确询问是否推送，收到答复前暂停受影响的 Git 推送。一般“提交并推送”授权不能代替这份具体大文件清单的确认；用户已明确确认同一清单和内容时可继续，路径、哈希、数量或体积变化后须重新确认。不要因远端已有且本次未增加的历史大文件反复索要授权。
-- 图片、PDF、PPT/PPTX、视频、压缩资源、导出报告等交付附件默认通过当前授权租户的 MCP 上传到 CDN，核验实际下载字节数、SHA-256 和真实 MIME 后使用 FileServer/CDN 地址引用。源码仓库保留必要源码、引用、内容指纹清单及可重复生成的说明；不能静默提交导出产物。生成和验签下载缓存放在工作区 `.tmp/`，不得把已迁移资源通过旧分支或 PR 重新合并进公开历史。运行必需的字体、模板和第三方二进制按用途判断，达到上述阈值仍须列入确认，不得擅自删除或转移。
+- 单个新增 Blob 达到 **10 MiB**，或本次新增 Blob 合计达到 **50 MiB** 必须停止推送并核对用途。截图、配图、PDF/PPT、视频、压缩包、安装包、模型和导出附件不论大小均禁止进入源码历史，必须经授权 MCP 上传 CDN，迁移完成后重新检查所有待推送提交。大小阈值是兜底检查，不是小文件可入库的豁免；一般推送授权或大文件清单确认不能替代 CDN 迁移。列出路径、实际字节数、SHA-256、目标仓库/分支和合计体积作为回执，不盲目再次推送。
+- 图片、PDF、PPT/PPTX、视频、压缩资源、导出报告等交付附件必须通过当前授权租户的 MCP 上传到 CDN；吾码官方公开资源使用经核验的 microi_itdos 与 https://file.microi.net 前缀，核验实际下载字节数、SHA-256 和真实 MIME 后使用 FileServer/CDN 地址引用。源码仓库保留必要源码、引用、内容指纹清单及可重复生成的说明；不能静默提交导出产物。生成和验签下载缓存放在工作区 `.tmp/`，不得把已迁移资源通过旧分支或 PR 重新合并进公开历史。运行必需的字体、模板和第三方二进制按用途判断，不得以必要运行依赖为由混入截图或交付附件；大体积依赖先明确用途与分发方案，不得擅自删除用户文件。
 - 历史瘦身另行确认改写范围，保留同事提交、有效分支、标签和可恢复证据；仅删除当前文件不能释放仍被历史引用的大对象。用户授权瘦身后使用明确引用清单及旧值保护，禁止未经盘点直接执行 `push -f --all` 或 `--mirror`，禁止为解除配额清空、删除或重建仓库。服务端 PR 引用、reflog、恢复记录和配额阻挡应通过管理界面或技术支持处理。
 - 推送失败时保存原生 Git 的完整命令、退出码和 stdout/stderr，隐藏凭据但不删减错误正文，回读远端引用确认实际状态；区分本地 Hook、网络、权限与服务端容量拒绝。同一错误不盲目重跑，向技术支持提供与该次候选绑定的实际压缩体积、引用范围和完整日志，不能把本地精简成功当作远端已瘦身。
 

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

@@ -19,7 +19,7 @@ Microi 平台后端功能必须默认按多节点部署设计：多个 API/Worke
 - 若要求宿主机掉电或 `kill -9` 窗口内也绝对零丢失，必须在返回业务成功前取得外部持久消息队列、共享 outbox 或同步 WAL 的持久化确认；“内存队列随后异步落盘”不能宣称覆盖尚未持久化的强杀窗口。
 
 <!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=workspace-conventions-003 sha256=478664d863219c724b8d19d25e7ac17420add6229c9efab5b75823d815aede53 -->
+<!-- microi-progressive:chunk id=workspace-conventions-003 sha256=fd7e446aa87c7d8fecac6a258dab354bfa81415a2ed60c11f5b3069557dfa049 -->
 ## 本地资源与 OOM 保护规范（强制）
 
 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
 - 禁止将 `--max-old-space-size`、JVM heap、Docker memory 或类似上限设为接近物理内存总量。除非用户明确授权独占构建窗口，单个 AI 启动的进程树不得持续占用超过物理内存的 25%。
 - 后台/长任务必须记录根 PID、子进程、启动时间和独立日志，每 15-30 秒监测一次进程树内存与全机可用内存。任务失败、中断或达阈值时必须停止整个子进程树，不得遗留孤儿 Node/dotnet/Java 进程。
 - 全量构建无法在上述阈值内完成时，先停止并改用定向 lint、类型检查、按模块构建或按测试文件验证。如仍必须进行全量验收，应明确报告资源瓶颈，交由 CI/专用构建机或经用户明确同意的独占时段执行，禁止在用户正在使用的 VS Code 会话里硬跑。
-- **本地测试程序与依赖生命周期（强制）**：优先复用健康源码/Vite，或在隔离目录启动已编译的吾码程序；共用已授权开发/测试依赖，用库、租户和命名空间隔离，不按 AI 任务或节点批量创建 Docker/Compose。新建本地 Docker 测试依赖须有必要性、最小清单及用户针对该动作的授权，一般开发、Full 或镜像发布不自动包含此动作。每轮成功、失败、取消及资源阻塞退出均收回自建进程、浏览器和临时容器并独立回读，保留既有共享服务；报告内存不足前先收回本任务遗留占用。详见[本地测试程序与依赖生命周期](progressive-02-microi-net-api-本地启动约定.md#本地测试程序与依赖生命周期强制)。
+- **本地测试程序与依赖生命周期（强制）**：默认复用当前 MCP 对应的 MySQL、Redis、MongoDB、MinIO/OSS 等实际依赖，以及健康源码/Vite；用独立测试库、租户和命名空间隔离，不按 AI 任务或节点创建整套 Docker/Compose。本机无容器、旧夹具被清理或执行 Full 都不是新建服务的理由，不再把临时测试容器许可作为常规问题。只有现有依赖确实无法满足具体验收且有证据时才采用最小必要替代方案。每轮成功、失败、取消及资源阻塞退出均精确删除自建临时容器与纯测试资源、收回自有进程和浏览器，并独立回读；既有共享服务保持原状。报告内存不足前先收回本任务遗留占用。详见[本地测试程序与依赖生命周期](progressive-02-microi-net-api-本地启动约定.md#本地测试程序与依赖生命周期强制)。
 
 ### `Microi.Client` 框架前端构建频率（强制）
 
@@ -39,7 +39,7 @@ AI 在用户本机启动 Node.js、Vite、Webpack、dotnet build、Java、Docker
 - Vite 热更新未生效时，先检查页面、控制台、文件监听和当前 61500 开发服务归属；确需重启时按共享进程与发布锁规范精确停止本工作区原有 `npm run dev`，再重新执行 `npm run dev`。不得用 `npm run build` 代替开发服务重启，也不得结束所有 `node`、浏览器或其它对话的进程。
 - 本规则只约束 `Microi.Client/` 吾码框架前端源码。独立 MicroService、Web、UniApp 等应用源码仍按其交付 Skill 在发布前执行自身必要的构建；不得因为本规则跳过微服务正式产物生成。
 <!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=workspace-conventions-004 sha256=093ef306e8f2f873b76524ce69ce7fd5194cfa0b361bd564f0c767f88439a817 -->
+<!-- microi-progressive:chunk id=workspace-conventions-004 sha256=443f093b8ae93e4f62df416006bc34969a6d8cde4741745acc5fdec829d957da -->
 ## 临时文件与 AI 产物放置规则（强制）
 
 - 长期交付资料归对应 `AI-Project/` 项目；不得重新生成公开根仓 `output/`。本工作区既有资料在 `AI-Project/microi/文档/历史交付资料/output/`，第三方推广 Skill 在 `AI-Project/microi/推广/skills/yixiaoer/`，均不随公开源码分发。
@@ -64,7 +64,7 @@ AI 在工作区任意任务中生成的**一次性临时脚本、诊断文件、
 - 孤立的 `node_modules/`（根目录没有 `package.json`，不应安装 npm 包）
 - 孤立的 `obj/`、`dist/`、`build/`（非对应项目文件）
 
-`.tmp/` 已在 `.gitignore` 中排除，可以随意创建临时文件。任务完成后如无保留价值可以不清理。
+`.tmp/` 已在 `.gitignore` 中排除，但创建临时文件必须登记归属，并在每轮测试结束后按 [测试临时文件随任务清理](../SKILL.md#测试临时文件必须随任务清理强制) 删除已无用途的自有产物；必要证据先最小归档，确需暂留的文件记录原因与清理时机，不能无限堆积。
 
 **2026-06 强制补充**：AI 不得在任何子项目目录下放置一次性日志、自动化截图、接口回收文件或调试脚本。像 `Microi.Server/Microi.net.Api/.tmp-*.log`、`Microi.Client/*.png` 这类文件一律视为规范失败，必须移到 `<workspace-root>/.tmp/` 或 `<workspace-root>/.tmp/screenshots/`。正式 Playwright 工程由 Microi.Agent 插件生成时可以继续使用 `.microi-e2e/`，但 AI 为某个任务手写的一次性 Playwright 脚本、报告和截图仍然必须放在 `.tmp/`。
 
@@ -139,7 +139,7 @@ AI 在工作区任意任务中生成的**一次性临时脚本、诊断文件、
 - 文档改动后执行 `npm run docs:build`；验收时检查本次没有无理由新增 `.md` 页面或导航路由。
 
 <!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=workspace-conventions-009 sha256=bec8162387c470c0cad1252645dbb4ecdafb0abb5f9b042525b6df8671e77ab0 -->
+<!-- microi-progressive:chunk id=workspace-conventions-009 sha256=90d90834a2080c2a2f08bae1092557761b6b23c79274f8d4dc2b115c121f5b51 -->
 ## 多对话共享工作区变更归属保护（强制）
 
 ### 功能验收后的源码提交与推送（强制）
@@ -147,10 +147,12 @@ AI 在工作区任意任务中生成的**一次性临时脚本、诊断文件、
 - 每个已完成并通过相应验收的功能、修复或独立里程碑，必须把本任务源码、测试和必要文档按实际 Git 仓库分别提交并推送；不能仅保存在工作区、stash、临时目录或已发布产物中。用户明确要求不提交/不推送、只读任务和未完成的实验除外，不为无改动仓库制造空提交。
 - 提交前回读工作树、暂存区、上游和远端；按可核验的本任务 hunk 暂存，保留其它对话的改动与既有暂存项。公开根仓只提交公开代码；闭源目录只从各自独立仓库根提交并推送到其已有内部远端，严格执行公开仓闭源路径门禁，不能用 gitlink 或强制添加绕过隔离。
 - 推送前先获取上游的新提交并安全整合；共享工作区有并行改动时优先在隔离候选中合并，不用整树 stash/reset 覆盖他人成果，不强推共享分支，不绕过仓库 Hook。需要精确回滚时保留独立、说明清楚的功能提交；回滚已推送功能通常使用新的反向提交，不改写共享历史。
-- 正式发布的候选必须包含此前已交付功能和本任务已核验的源码，先按仓安全本地提交，再冻结完整构建输入与内容哈希；仅更新说明页面时也要核对整个站点候选。Git 远端推送与提交号回读默认在制品发布前完成；若用户明确授权“Git 推送失败不阻断 NuGet/Docker”，仅允许把这两类平台制品的远端推送移到并行或后续步骤，不放宽 Full、闭源隔离、加密、候选/产物一致性及渠道回读。隔离工作树没有未提交变更不等于已包含最新功能；发布锁也不能代替源码完整性检查。
-- 收尾逐仓记录本地提交号、远端分支和回读结果，区分源码、NuGet、Docker 与客户部署。远端网络、认证或容量故障时作有界诊断，保留本地提交、失败原因和待补推清单；在上述用户明确授权且本地候选已完成全部制品门禁时，可继续独立发布 NuGet/Docker，但必须如实标记源码尚未推送，不能宣称完整交付。源码冲突、归属不明、保护路径违规或候选漂移不是“Git 推送故障”，必须先处理，不能借例外发布不确定源码。
+- 正式发布的候选必须包含此前已交付功能和本任务已核验的源码，先按仓安全本地提交，再冻结包含闭源源码在内的完整构建输入、提交号和内容哈希；仅更新说明页面时也要核对整个站点候选。Git 远端推送/回读与制品发布是独立交付步骤，默认可并行或在制品之后补推，不能把远端已包含 HEAD、推送成功或 Gitee/GitLab/GitHub 可达作为 NuGet、API/PC Docker、官网 Docker 等合格制品的上传前置条件。保留对应产品的 Full、闭源隔离、DLL 加密、候选/产物一致性、最终冒烟和渠道回读；官网继续执行整站构建与内容/入口验收。隔离工作树干净或持有发布锁，均不能代替源码完整性检查。
+- 收尾逐仓记录本地提交号、远端分支和独立回读结果，分别报告源码、NuGet、Docker、官网及客户部署。远端网络、认证或容量故障首次失败后最多短重试一次，累计定向排障不超过 5 分钟；保存本地提交、失败原因和待补推清单，已通过全部制品门禁的渠道立即继续发布，不得反复请求同一例外授权。源码冲突、归属不明、保护路径违规、缺少实际构建输入或候选漂移必须先解决，不能当作可忽略的远端故障。后续合并改变源码/构建输入时重新冻结并按新候选验收，禁止将新提交冒充已发布制品来源；缺少远端回执仍标为源码未交付，不得宣称全部完成。
+- 官方应用发布仅验收 `microi_itdos` 对应主租户 `iTdos` 的更新与回读，不批量升级、不等待线上子租户；子租户升级是独立部署任务。Full 仍保留已登记的隔离主、子测试租户及越权、升级回归，不将测试夹具称为官网子租户部署。
+- 发布边界必须在 `Microi一键编译发布.sh` 及其调用入口生效，不能只依赖 AI 提示词。普通用户直接运行脚本同样保留适用的 Full、DLL 加密、冒烟和候选校验；运行脚本不授予官方 iTdos 写入权，也不授权升级其全部生产子租户。
 
-- **Git 大文件推送确认（强制）**：每次 Git 推送前检查全部待推送提交中新引入的 Blob；单个达到 10 MiB 或合计达到 50 MiB 时，必须提供路径、实际大小、SHA-256 和目标仓库/分支，取得用户对具体清单的确认后才推送。一般提交推送授权不能代替大文件确认；完整检查、CDN 引用、历史瘦身与失败回执规则见[Git 大文件推送确认](progressive-03-cli-与-ide-插件错版共存约定.md#git-大文件推送确认强制)。
+- **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-大文件推送检查强制)。
 
 同一工作区可能同时被用户、其它 Codex 对话、IDE、自动化任务或外部 Git 操作修改。任务启动前已经存在、或无法用本对话证据严格证明归属的差异，一律视为他人资产并保留；“工作区是脏的”不是清理授权。