@microi.net/cli 4.6.2 → 4.6.4

package/dist/microi.skills/ui-design/assets/templates/MCI-DESIGN.md

@@ -1,77 +1,158 @@
 # MCI-DESIGN
 
-## 1. 产品目标
+> 本文件同时保存精确 token 与设计理由。实现前先读完整文件；修改视觉结构时同步更新本文件、源码和验收截图。
 
-- 页面服务的用户：
-- 用户进入页面后的首要任务：
-- 首屏必须回答的问题：
-- 成功衡量方式：
+```yaml
+contract:
+  version: 1
+  project:
+  mode: data-workspace
+  intent:
+
+tokens:
+  color:
+    canvas: var(--mci-bg-base)
+    surface: var(--mci-bg-card)
+    surfaceElevated: var(--mci-bg-elevated)
+    textPrimary: var(--mci-text-primary)
+    textSecondary: var(--mci-text-secondary)
+    primary: var(--mci-color-primary)
+    success: var(--mci-color-success)
+    warning: var(--mci-color-warning)
+    danger: var(--mci-color-danger)
+  typography:
+    display: { size: 48px, lineHeight: 1.1, weight: 800 }
+    h1: { size: 32px, lineHeight: 1.2, weight: 750 }
+    h2: { size: 24px, lineHeight: 1.3, weight: 700 }
+    body: { size: 16px, lineHeight: 1.7, weight: 400 }
+    meta: { size: 13px, lineHeight: 1.5, weight: 500 }
+  spacing:
+    micro: 4px
+    compact: 8px
+    control: 12px
+    card: 16px
+    section: 24px
+    page: 32px
+  shape:
+    input: var(--mci-shape-input)
+    panel: var(--mci-shape-panel)
+    card: var(--mci-shape-card)
+    button: var(--mci-shape-button)
+  elevation:
+    card: var(--mci-shadow-card)
+    cardHover: var(--mci-shadow-card-hover)
+    float: var(--mci-shadow-float)
+
+components:
+  primaryButton:
+    height: 44px
+    states:
+      default: { background: "{tokens.color.primary}" }
+      hover: { lift: -1px }
+      focus: { outline: "{tokens.color.primary}" }
+      pressed: { scale: 0.98 }
+      loading: { preserveWidth: true }
+      disabled: { opacity: 0.56 }
+  dataCard:
+    background: "{tokens.color.surface}"
+    radius: "{tokens.shape.card}"
+    padding: "{tokens.spacing.card}"
+    states:
+      default: { elevation: "{tokens.elevation.card}" }
+      hover: { elevation: "{tokens.elevation.cardHover}", lift: -2px }
+      focus: { outline: "{tokens.color.primary}" }
+      selected: { border: "{tokens.color.primary}" }
+
+omissions: []
+```
 
-## 2. 设计模式
+## 1. 产品概览与目标用户
 
-- 主模式：品牌叙事 / 真实产品流程 / 趋势构图 / 沉浸互动 / 动态首屏 / 数据工作台
-- 辅助能力（最多两项）：
-- 明确不采用的视觉手法：
+- 首要用户：
+- 首要任务：
+- 用户进入后第一眼必须理解：
+- 成功结果与衡量方式：
+- 关键设备与使用环境：
 
-## 3. 信息架构
+## 2. 视觉性格与情绪目标
 
-1. 首屏：
-2. 核心任务：
-3. 证据或数据：
-4. 辅助内容：
-5. 最终行动：
+- 主情绪（只选一个）：
+- 具体视觉隐喻：
+- 辅助气质（最多两项）：
+- 选择理由：
+- 明确不采用的视觉语言：
 
-## 4. Design Tokens
+## 3. 颜色
 
-```yaml
-color:
-  background: var(--mci-bg)
-  surface: var(--mci-surface)
-  text: var(--mci-text)
-  muted: var(--mci-text-muted)
-  primary: var(--mci-primary)
-  success: var(--mci-success)
-  warning: var(--mci-warning)
-  danger: var(--mci-danger)
-spacing: [4, 8, 12, 16, 24, 32, 48, 64]
-radius:
-  input: var(--mci-shape-input)
-  panel: var(--mci-shape-panel)
-  card: var(--mci-shape-card)
-  button: var(--mci-shape-button)
-shadow:
-  card: var(--mci-shadow-card)
-  float: var(--mci-shadow-float)
-```
+- 页面底色与表面关系：
+- 主色只用于：
+- 成功 / 警告 / 危险 / 信息色语义：
+- 明亮与暗黑主题的对比策略：
+- 透明表面的叠加底色：
+
+## 4. 字体
+
+| 角色 | 字号 / 行高 / 字重 | 用途 | 禁止 |
+| --- | --- | --- | --- |
+| Display |  |  |  |
+| H1 |  |  |  |
+| H2 |  |  |  |
+| Body |  |  |  |
+| Meta |  |  |  |
+
+## 5. 布局与间距
+
+- Desktop：12 列，最大宽度：
+- Tablet：8 列，重排规则：
+- Mobile：4 列，左右安全间距：
+- 内部紧凑间距：
+- 区域与页面留白：
+
+## 6. 层级、材质与形状
+
+- 深度来自：色调层 / 细边框 / 环境阴影 / 透明材质 / 实体投影
+- 圆角或切角表达的性格：
+- 页面 / 卡片 / 浮层的层级关系：
+- 低性能与不支持透明效果时的降级：
 
-## 5. 字体层级
+## 7. 组件与状态
 
-| 用途 | 桌面 | 移动 | 字重 | 行高 |
-| --- | ---: | ---: | ---: | ---: |
-| Display | 64 | 40 | 700 | 1.05 |
-| H1 | 40 | 32 | 700 | 1.15 |
-| H2 | 28 | 24 | 650 | 1.25 |
-| Body | 16 | 15 | 400 | 1.7 |
-| Meta | 13 | 12 | 500 | 1.5 |
+| 组件 | Default | Hover / Focus / Pressed | Loading | Empty / Error | Disabled | Selected / Success |
+| --- | --- | --- | --- | --- | --- | --- |
+| 主按钮 |  |  |  | - |  |  |
+| 搜索 / 筛选 |  |  |  |  |  |  |
+| 列表 / 数据卡片 |  |  |  |  | - |  |
+| 表单 |  |  |  |  |  |  |
+| 弹层 |  |  |  |  |  |  |
 
-## 6. 组件与状态
+### 数据卡片
 
-| 组件 | 默认 | Hover / Pressed | Loading | Empty | Error | Disabled | Success |
-| --- | --- | --- | --- | --- | --- | --- | --- |
-| 主按钮 |  |  |  | - |  |  |  |
-| 搜索 / 筛选 |  |  |  |  |  |  |  |
-| 列表 / 卡片 |  |  |  |  |  | - |  |
-| 表单 |  |  |  | - |  |  |  |
+- 信息顺序：身份 → 标题/状态 → 关键字段 → 时间/辅助标签 → 操作。
+- 缺图：40—44px 紧凑标记，不渲染大面积装饰占位图。
+- 默认列数：桌面 4，平板 2—3，移动 1；显式业务配置优先。
+- 操作：一个主动作、一至两个次动作，其余进入“更多”；危险动作降权。
 
-## 7. 动效时间线
+## 8. 页面模式与信息架构
+
+1. 首屏：
+2. 核心任务：
+3. 证据或数据：
+4. 辅助内容：
+5. 最终行动：
+
+- 主模式：品牌叙事 / 真实产品流程 / 趋势构图 / 沉浸互动 / 动态首屏 / 数据工作台
+- 辅助能力（最多两项）：
+
+## 9. 动效与媒体
 
 - 0—120ms：
 - 120—360ms：
 - 360—800ms：
-- 循环动效：
-- `prefers-reduced-motion` 降级：
+- 循环动效存在理由：
+- 图片比例与 `object-fit`：
+- `prefers-reduced-motion` 与静态降级：
 
-## 8. 响应式
+## 10. 响应式与安全区
 
 | 宽度 | 栅格 | 导航 | 主操作 | 内容重排 |
 | --- | --- | --- | --- | --- |
@@ -79,20 +160,40 @@ shadow:
 | 768 | 8 列 |  |  |  |
 | 1440 | 12 列 |  |  |  |
 
-## 9. 媒体与性能
+## 11. 可访问性、性能与降级
 
-- 图片格式、尺寸与 `object-fit`：
-- 视频 / Canvas / WebGL 的存在理由：
-- 静态降级资源：
+- 键盘顺序与可见焦点：
+- 正文、状态与交互对比度：
+- 触控目标：移动端不小于 44px
 - 首屏资源预算：
-- 失败与超时处理：
+- 网络失败、媒体失败与离线策略：
+- 骨架屏、空态、错误态与恢复路径：
+
+## 12. 应当与禁止
+
+### 应当
+
+-
+
+### 禁止
+
+-
+
+## 有意省略
+
+| 规则 | 省略理由 | 替代方案 |
+| --- | --- | --- |
+|  |  |  |
 
-## 10. 验收清单
+## 验收清单
 
+- [ ] 机器块能解析，核心章节顺序正确，无重复或近似拼写章节。
+- [ ] 所有 `{路径}` 引用存在且无循环；无未说明的孤立 token。
 - [ ] 首屏在 3 秒内说清产品、对象和主操作。
 - [ ] 默认、加载、空、错误、禁用、权限、成功状态可验证。
 - [ ] 390 / 768 / 1440 无横向滚动、遮挡和错位。
 - [ ] 明亮、暗黑主题均有足够对比度。
-- [ ] 所有可点击元素有 hover/focus/pressed 和真实结果。
+- [ ] 所有可点击元素有 hover、focus、pressed 和真实结果。
 - [ ] 动效尊重 `prefers-reduced-motion`。
+- [ ] 契约差异与实现差异同时评审，没有意外删除或语义漂移。
 - [ ] 所有图片、字体、模型和代码资产来源合法且可离线构建。

package/dist/microi.skills/ui-design/references/design-pattern-library.md

@@ -28,6 +28,19 @@
 
 选择后填写：页面目标、用户角色、主模式、辅助能力、视觉锚点、主动作、最大宽度、栅格、字体层级、主题、状态矩阵、动效预算、移动端重排和验收截图。
 
+### 用具体隐喻定义气质
+
+宽泛形容词不能直接指导实现。把“高级、现代、极简、科技”收敛成一个可以推导规则的具体隐喻，并同时写出它排除什么：
+
+| 具体隐喻 | 可推导规则 | 明确排除 |
+| --- | --- | --- |
+| 安静的专业工作台 | 中性色表面、细边框、四列可读卡片、紧凑内部间距、宽松区块留白 | 大面积字母占位、彩虹渐变、所有按钮同权 |
+| 温暖的手工纸张 | 暖底、自然低饱和色、柔和圆角、轻触感阴影 | 冷硬霓虹、尖锐切角、持续发光 |
+| 夜间发光仪表舱 | 深色分层、少量青蓝紫状态光、清晰数字层级、短促状态动效 | 大面积炫光、随机彩色图表、低对比正文 |
+| 雾感通透界面 | 灰白低彩、细线、轻透明表面、大留白、慢速淡入 | 厚重投影、不透明色块堆叠、过度模糊 |
+
+先写“用户任务、主情绪、具体隐喻、三条应当、三条禁止”，再选择 token 与组件。完整双层契约见 [mci-design-contract.md](mci-design-contract.md)。
+
 ## 品牌叙事
 
 ### 首屏结构

package/dist/microi.skills/ui-design/references/mci-design-contract.md

@@ -1,84 +1,163 @@
 # MCI-DESIGN 设计契约
 
-大型项目在根目录维护 `MCI-DESIGN.md`，让设计决策可版本管理、可复用、可被 AI 和人共同读取。它是对 `Microi.UI/src/theme/tokens.css` 的语义说明，不替代真实源码 token。
+大型项目在根目录维护 `MCI-DESIGN.md`，让界面意图、精确取值和组件状态可以版本管理、自动检查，并由人和 AI 共同延续。它是 `Microi.UI/src/theme/tokens.css` 的项目级语义说明，不替代真实源码 token，也不替代线框、原型和视觉验收。
 
-## 必需章节
+## 双层单源模型
 
-1. 产品与用户
-2. 视觉性格
+设计契约必须同时包含两层，缺少任一层都不完整：
+
+1. **机器可读层**：颜色、字体、间距、圆角、阴影、组件状态和引用关系。它回答“准确使用什么值”，用于检查、差异比较和生成运行时变量。
+2. **人类可读层**：产品对象、受众、情绪目标、视觉隐喻、信息层级、选择理由和明确禁区。它回答“为什么这样设计”，帮助接手者在契约没有覆盖的新场景中作出一致判断。
+
+精确值会随项目变化，设计理由决定取舍方向。若两层暂时冲突，先核对用户最新要求和合法源码，再同时修订契约与实现，禁止只改其中一边。
+
+## 意图优先级
+
+设计前按以下顺序收敛，不从颜色选择器开始：
+
+1. 用户进入页面后的首要任务与成功结果。
+2. 页面希望产生的一个主情绪，例如可信、安静、敏捷、温暖或专注。
+3. 一个具体视觉隐喻，例如“安静的专业工作台”“柔和的手工纸张”“夜间发光仪表舱”。具体隐喻比堆叠“高级、现代、极简”等形容词更能约束色彩、材质、密度和动效。
+4. 一组明确的“应当 / 禁止”，把隐含边界写出来。
+5. 最后才是 token、组件和页面实现。
+
+一个页面只保留一个主隐喻，辅助气质最多两项。不要把温暖圆润、深色霓虹、通透玻璃和高密度数据等多套语言同时堆在一个界面。
+
+## 固定章节顺序
+
+核心章节按以下顺序书写，便于稳定解析和审查：
+
+1. 产品概览与目标用户
+2. 视觉性格与情绪目标
 3. 颜色
 4. 字体
 5. 布局与间距
-6. 层级与形状
-7. 组件契约
-8. 页面模式
+6. 层级、材质与形状
+7. 组件与状态
+8. 页面模式与信息架构
 9. 动效与媒体
 10. 响应式与安全区
-11. 可访问性
-12. 禁止事项
-
-## 最小模板
-
-```markdown
-# 项目设计契约
-
-## 产品与用户
-- 首要用户：
-- 首要任务：
-- 关键设备：
-
-## 视觉性格
-- 三个关键词：专业、清晰、克制
-- 主模式：真实产品流程
-- 辅助能力：数据工作台
-
-## 颜色
-- `--mci-color-primary`：主动作与选中态
-- `--mci-color-success`：已完成、在线
-- `--mci-color-warning`：需关注
-- `--mci-color-danger`：错误与危险动作
-- `--mci-bg-base/card/elevated`：页面、卡片、浮层
-- `--mci-text-primary/secondary/tertiary`：正文层级
-
-## 字体
-- Display：48/56, 800
-- H1：32/40, 750
-- H2：24/32, 700
-- Body：16/28, 400
-- Meta：13/20, 500
-
-## 布局与间距
-- Desktop：12 列，最大宽度 1280px
-- Mobile：4 列，左右 16px
-- 间距：4/8/12/16/24/32/48/64
-
-## 组件契约
-### PrimaryButton
-- 高度 44px；图标 + 文字居中
-- 状态：default/hover/focus/pressed/loading/disabled
-- 主按钮每个页面最多一个视觉焦点
-
-### Card
-- 使用 `--mci-bg-card`、`--mci-border-color`、`--mci-shape-card`
-- 卡片可点击时才有 hover/pressed
-
-## 页面模式
-- 首页：品牌叙事 + 产品对象
-- 列表：筛选 + 骨架 + 业务卡片 + 分页
-- 表单：分段 + 草稿 + 错误摘要 + 固定操作栏
-
-## 动效与媒体
-- 入场 320ms；微交互 160ms；仅 transform/opacity
-- 复杂媒体提供静态海报与 reduced-motion 降级
-
-## 禁止事项
-- 禁止全局泛化 CSS、纯文字底部导航、假按钮、无降级远程资源
+11. 可访问性、性能与降级
+12. 应当与禁止
+
+允许在末尾增加项目专属章节，但必须保留未知扩展内容，不能重复核心章节，也不能用近似拼写制造第二套同义章节。确实不适用的项目可以省略某一规则，但要在“有意省略”中说明理由。
+
+## 机器可读层
+
+机器块应使用语义命名，避免 `blue500`、`bigRadius`、`shadow2` 这类只描述外观、不说明用途的名字。组件可通过 `{路径}` 引用共享 token；引用必须存在，不能形成循环。
+
+```yaml
+contract:
+  version: 1
+  project: 示例项目
+  mode: data-workspace
+  intent: 安静、清晰、可快速扫描的专业工作台
+
+tokens:
+  color:
+    canvas: var(--mci-bg-base)
+    surface: var(--mci-bg-card)
+    surfaceElevated: var(--mci-bg-elevated)
+    textPrimary: var(--mci-text-primary)
+    textSecondary: var(--mci-text-secondary)
+    primary: var(--mci-color-primary)
+    danger: var(--mci-color-danger)
+  typography:
+    title: { size: 16px, lineHeight: 1.45, weight: 700 }
+    body: { size: 14px, lineHeight: 1.65, weight: 400 }
+    meta: { size: 12px, lineHeight: 1.5, weight: 500 }
+  spacing:
+    compact: 8px
+    control: 12px
+    card: 16px
+    section: 24px
+  shape:
+    control: var(--mci-shape-input)
+    card: var(--mci-shape-card)
+    pill: var(--mci-radius-full)
+  elevation:
+    card: var(--mci-shadow-card)
+    cardHover: var(--mci-shadow-card-hover)
+
+components:
+  dataCard:
+    background: "{tokens.color.surface}"
+    radius: "{tokens.shape.card}"
+    padding: "{tokens.spacing.card}"
+    states:
+      default: { elevation: "{tokens.elevation.card}" }
+      hover: { elevation: "{tokens.elevation.cardHover}", lift: -2px }
+      focus: { outline: "{tokens.color.primary}" }
+      selected: { border: "{tokens.color.primary}" }
+      disabled: { opacity: 0.56 }
+
+omissions:
+  - rule: backgroundVideo
+    reason: 高频数据页不需要持续媒体，减少干扰与资源开销
 ```
 
+机器块至少满足：
+
+- 有主色、页面底色、表面色、主/次文字色和危险色。
+- 字体角色包含字号、行高、字重；间距、圆角和层级都有明确单位或 `--mci-*` 引用。
+- 组件状态覆盖适用的 default、hover、focus、pressed、loading、empty、error、disabled、selected、success。
+- 同一语义只定义一次；组件优先引用共享 token，而不是重新复制值。
+- Alpha、混色和玻璃表面必须说明叠加在哪种底色上；只给透明度不算完整颜色定义。
+
+## 人类可读层
+
+每个核心选择都要写一行理由，尤其是：
+
+- 为什么这种气质适合目标用户与任务。
+- 颜色如何区分主动作、状态、表面和内容层级。
+- 字体如何形成阅读节奏，中文和数字如何共存。
+- 内部紧凑与外部宽松分别使用哪些间距。
+- 深度来自色调层、细边框、环境阴影、透明材质还是实体投影。
+- 圆角、切角、胶囊或有机形状表达什么性格。
+- 卡片、按钮、输入、导航、弹层在所有状态下如何变化。
+- 哪些装饰会破坏任务，应明确禁止。
+
+## 可迁移的视觉气质
+
+以下不是成品主题，而是把意图翻译为系统规则的示例：
+
+| 气质 | 色彩与材质 | 形状与间距 | 动效 | 禁止 |
+| --- | --- | --- | --- | --- |
+| 温暖友好 | 暖白或浅沙底、自然低饱和强调色、轻触感层次 | 圆润或轻微有机形，外部留白宽松 | 柔和上浮与按压 | 冷硬高对比、密集霓虹、尖锐切角 |
+| 深色发光 | 深色表面、少量青蓝紫发光语义、清晰高对比文字 | 边界精确、圆角克制、层级紧凑 | 短促聚焦与状态脉冲 | 大面积炫光、彩虹状态色、持续漂移 |
+| 雾感通透 | 灰白低彩底、细线边框、轻透明表面 | 大留白、轻圆角、细腻分层 | 慢速淡入与透明度变化 | 厚重投影、不透明色块堆叠、过度模糊 |
+
+## 后台数据卡片契约
+
+后台数据卡片是高频操作容器，不是营销海报：
+
+- 固定信息顺序：真实图片或紧凑身份标记 → 标题与状态 → 2—4 个关键字段 → 时间/辅助标签 → 操作区。
+- 配置了图片但当前行无图时，使用 40—44px 的首字/图标标记；禁止生成占据卡片三分之一以上的装饰占位图。
+- 默认桌面四列，显式列数配置优先；中等宽度自动降为三列或两列，移动端单列。卡片最小可读宽度优先于“同屏塞更多”。
+- 标题最多两行，主次文字、金额、状态与时间有固定层级；标签只表达状态或分类，不把每个字段都做成胶囊。
+- 操作区优先一个主动作、一至两个次动作，其余收进“更多”；危险动作不得与主动作同权。移动端触控目标不小于 44px。
+- 骨架屏必须复刻最终标题、字段和操作区的几何结构；空态解释原因并提供下一步。
+- 整卡可进入详情时必须提供键盘焦点、Enter/Space 触发和可见 focus；内部按钮阻止事件冒泡。
+
+## 契约检查、差异与输出
+
+每次修改契约或 UI 时，按顺序检查：
+
+1. **结构**：核心章节存在且顺序正确，无重复章节、疑似拼写错误或无法识别的 token 组。
+2. **类型**：颜色、长度、数字、布尔值和状态对象类型正确，token 式文本没有被误放在普通说明里而漏解析。
+3. **引用**：所有 `{路径}` 可解析，无循环引用；未被组件、页面或输出消费的孤立 token 要删除或说明用途。
+4. **语义**：主色、表面、文字层级、组件状态和有意省略完整；命名能解释用途。
+5. **可访问性**：正文和交互态对比度满足项目标准，焦点可见，键盘路径连续，低动效降级完整。
+6. **差异门禁**：评审设计契约的语义变更和实现变更是否同时出现；意外删除、重命名或大范围 token 漂移应阻止合入。
+7. **输出**：需要生成运行时变量或其它主题格式时，只由已校验的机器块派生，禁止维护第二份手工 token。
+
+契约格式若仍在演进，项目必须锁定 `contract.version`，升级时先查看差异并一次性迁移。跨平台脚本要提供不依赖文件扩展名的稳定入口，避免不同终端执行出不同结果。
+
 ## AI 使用规则
 
-- 开始实现前读取本契约和 `ui-design` skill。
-- 契约缺少的值优先继承 Microi.UI token，不临时发明新色值或圆角。
-- 新模式在两个以上页面重复时先更新契约，再抽成 `Mci*` 或项目级 `mci-*` 组件。
-- 修改契约后至少截图一张受影响页面的桌面和移动版本。
-- 契约与实现冲突时，以当前合法源码和用户最新明确要求为准，并同步修订契约。
+- 开始实现前完整读取契约和 `ui-design` skill；先复述页面任务、主气质和三条禁止事项，再写页面。
+- 契约缺少的精确值优先继承 Microi.UI token；不能用“看起来差不多”的硬编码补洞。
+- 先稳定颜色、字体、间距、层级和形状，再定义组件状态；不要在基础 token 尚未收敛时过早堆复杂组件结构。
+- 新模式在两个以上页面重复时，先更新契约，再抽成 `Mci*` 或项目级 `mci-*` 组件。
+- 修改契约后至少截图一张受影响页面的桌面和移动版本，并覆盖亮/暗主题及相关业务状态。
+- 契约、源码、浏览器截图三者冲突时不得宣称完成；修复后重新执行结构检查、定向测试和视觉验收。

package/dist/microi.skills/workspace-conventions/SKILL.md

@@ -477,3 +477,10 @@ AI 只要修改了 `Microi.Server/**` 下会影响 `Microi.net.Api` 运行结果
 - 根因：发布脚本把三个 registry 都视为同一个全局硬门禁，并把最容易受账号、scope 和 2FA 影响的 npm 放在扩展市场之前，没有区分必选目标、可选目标和严格发布模式。
 - 通用规则：默认发布按目标隔离；先完成并回读必选目标，再独立尝试可选目标。可选目标失败应保留同版本不可变产物并输出补发入口；只有显式严格模式才要求所有目标预检通过后继续。
 - 自动化检查：模拟 npm 未登录、scope 404 和 npm publish 非零退出，断言两个扩展市场的发布调用与回读仍会执行；另测严格模式在版本递增前停止，补发命令不递增版本且复用同版本产物。
+
+### 复盘：npm 已接收新版本但公共回读短暂 404
+
+- 触发场景：`npm publish` 已成功返回，npmjs.com 包页面也已出现新包或新版本，但紧随其后的 `npm view <package>@<version> version` 在数十秒内连续返回 E404，联合发布脚本因此把成功发布误报为失败。
+- 根因：新 scope/新版本在 npm 网站、写入节点和公共 registry 读取节点之间存在短暂传播窗口；固定少量、短间隔轮询不足以区分“尚未发布”和“已经接收但尚未公开传播”。
+- 通用规则：发布命令成功和公共回读确认必须作为两个阶段记录。npm 新版本回读使用 `--prefer-online` 和分钟级有限重试；重试结束仍为 E404 时标记 `pending-propagation`，禁止自动重发同一不可变版本，并提供独立只读验证命令稍后确认。只有发布命令本身失败且公共 registry 也始终不存在时，才进入补发流程。
+- 自动化检查：模拟 `npm publish` 成功后前几次 `npm view` 返回 E404、随后返回期望版本，断言不会重复发布；再模拟重试窗口结束仍为 E404，断言输出待传播状态和只读验证命令，而不是提示重新上传同一版本。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@microi.net/cli",
-  "version": "4.6.2",
+  "version": "4.6.4",
   "description": "Microi吾码 AI 开发命令行：服务器连接、登录、AI/MCP 初始化与 V8 资源同步",
   "license": "MIT",
   "homepage": "https://microi.net/doc/v8-engine/vs-code-plugin.html",