@deployxai/dxc 0.1.8 → 0.1.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deployxai/dxc",
-  "version": "0.1.8",
+  "version": "0.1.13",
   "description": "DeployX 内容工作台 CLI 与官方 Skills",
   "type": "module",
   "bin": {
@@ -12,6 +12,7 @@
   "dependencies": {
     "@huggingface/tokenizers": "0.1.3",
     "onnxruntime-web": "1.22.0",
+    "sharp": "0.35.3",
     "zod": "4.4.3"
   },
   "files": [

package/skills/dxc-article-outline/SKILL.md

@@ -7,7 +7,7 @@ description: DxC 内容工作流的大纲步骤。由 dxc-content-workflow 在 o
 
 ## 对用户的呈现
 
-用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部所有 CLI 调用都使用固定运行入口：Windows 为 `npm.cmd exec --yes --registry=https://registry.npmjs.org/ --package=@deployxai/dxc@0.1.8 -- dxc <参数>`，macOS/Linux 为相同参数的 `npm exec`。Windows 不得先尝试 npm 生成的无扩展名 `dxc`，同一任务后续必须保持已选入口；不得让用户打开终端、复制命令或处理环境变量。
+用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部所有 CLI 调用都使用固定运行入口：Windows 为 `npm.cmd exec --yes --registry=https://registry.npmjs.org/ --package=@deployxai/dxc@0.1.13 -- dxc <参数>`，macOS/Linux 为相同参数的 `npm exec`。Windows 不得先尝试 npm 生成的无扩展名 `dxc`，同一任务后续必须保持已选入口；不得让用户打开终端、复制命令或处理环境变量。
 
 本 Skill 只负责 `outline`。大纲是正文和视觉计划共同读取的结构 contract。
 

package/skills/dxc-article-write/SKILL.md

@@ -7,7 +7,7 @@ description: DxC 内容工作流的正文步骤。由 dxc-content-workflow 在 a
 
 ## 对用户的呈现
 
-用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部所有 CLI 调用都使用固定运行入口：Windows 为 `npm.cmd exec --yes --registry=https://registry.npmjs.org/ --package=@deployxai/dxc@0.1.8 -- dxc <参数>`，macOS/Linux 为相同参数的 `npm exec`。Windows 不得先尝试 npm 生成的无扩展名 `dxc`，同一任务后续必须保持已选入口；不得让用户打开终端、复制命令或处理环境变量。
+用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部所有 CLI 调用都使用固定运行入口：Windows 为 `npm.cmd exec --yes --registry=https://registry.npmjs.org/ --package=@deployxai/dxc@0.1.13 -- dxc <参数>`，macOS/Linux 为相同参数的 `npm exec`。Windows 不得先尝试 npm 生成的无扩展名 `dxc`，同一任务后续必须保持已选入口；不得让用户打开终端、复制命令或处理环境变量。
 
 本 Skill 只负责 `article`。正文必须是可发布母稿，不能把内部自检表、提示词或大纲标记
 混进最终正文。

package/skills/dxc-content-brief/SKILL.md

@@ -7,7 +7,7 @@ description: DxC 内容工作流的 Brief 步骤。由 dxc-content-workflow 在
 
 ## 对用户的呈现
 
-用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部所有 CLI 调用都使用固定运行入口：Windows 为 `npm.cmd exec --yes --registry=https://registry.npmjs.org/ --package=@deployxai/dxc@0.1.8 -- dxc <参数>`，macOS/Linux 为相同参数的 `npm exec`。Windows 不得先尝试 npm 生成的无扩展名 `dxc`，同一任务后续必须保持已选入口；不得让用户打开终端、复制命令或处理环境变量。
+用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部所有 CLI 调用都使用固定运行入口：Windows 为 `npm.cmd exec --yes --registry=https://registry.npmjs.org/ --package=@deployxai/dxc@0.1.13 -- dxc <参数>`，macOS/Linux 为相同参数的 `npm exec`。Windows 不得先尝试 npm 生成的无扩展名 `dxc`，同一任务后续必须保持已选入口；不得让用户打开终端、复制命令或处理环境变量。
 
 本 Skill 只负责 `brief`，把研究结果收敛为下游共同使用的单一命题。
 

package/skills/dxc-content-review/SKILL.md

@@ -7,7 +7,7 @@ description: DxC 内容工作流的审校步骤。由 dxc-content-workflow 在 q
 
 ## 对用户的呈现
 
-用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部所有 CLI 调用都使用固定运行入口：Windows 为 `npm.cmd exec --yes --registry=https://registry.npmjs.org/ --package=@deployxai/dxc@0.1.8 -- dxc <参数>`，macOS/Linux 为相同参数的 `npm exec`。Windows 不得先尝试 npm 生成的无扩展名 `dxc`，同一任务后续必须保持已选入口；不得让用户打开终端、复制命令或处理环境变量。
+用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部所有 CLI 调用都使用固定运行入口：Windows 为 `npm.cmd exec --yes --registry=https://registry.npmjs.org/ --package=@deployxai/dxc@0.1.13 -- dxc <参数>`，macOS/Linux 为相同参数的 `npm exec`。Windows 不得先尝试 npm 生成的无扩展名 `dxc`，同一任务后续必须保持已选入口；不得让用户打开终端、复制命令或处理环境变量。
 
 本 Skill 只负责 `quality-review`。它产出可追溯报告，不在审校过程中静默改写已经确认的
 正文。

package/skills/dxc-content-workflow/SKILL.md

@@ -7,7 +7,7 @@ description: DxC 图文内容工作流的唯一公开入口。用户说“写一
 
 ## 对用户的呈现
 
-用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部所有 CLI 调用都使用固定运行入口：Windows 为 `npm.cmd exec --yes --registry=https://registry.npmjs.org/ --package=@deployxai/dxc@0.1.8 -- dxc <参数>`，macOS/Linux 为相同参数的 `npm exec`。Windows 不得先尝试 npm 生成的无扩展名 `dxc`，同一任务后续必须保持已选入口；不得让用户打开终端、复制命令或处理环境变量。
+用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部所有 CLI 调用都使用固定运行入口：Windows 为 `npm.cmd exec --yes --registry=https://registry.npmjs.org/ --package=@deployxai/dxc@0.1.13 -- dxc <参数>`，macOS/Linux 为相同参数的 `npm exec`。Windows 不得先尝试 npm 生成的无扩展名 `dxc`，同一任务后续必须保持已选入口；不得让用户打开终端、复制命令或处理环境变量。
 
 把本 Skill 作为 DxC 唯一公开入口。每次显式或隐式调用都视为一次“恢复并继续”，而不是
 从第一步重新开始。不要要求用户逐个点名下游 Skill，也不要要求用户先安装另一个
@@ -116,7 +116,10 @@ description: DxC 图文内容工作流的唯一公开入口。用户说“写一
    不重新执行此前步骤。
 4. `blocked`：
    - `stale` 表示输出或输入产物已改变；读取 `recoveryPlan` 一次获得拓扑有序的全部失效阶段，
-     从第一项开始连续重跑，不要让用户逐条发现 visual-plan、quality-review、delivery；
+     从第一项开始执行其 `command` 并连续重跑，不要让用户逐条发现 visual-plan、quality-review、
+     delivery；`command` 里的 `dxc` 是逻辑入口，执行时必须替换为本 Skill 已选定的当前平台
+     固定运行入口，不能调用 PATH 中的旧版 CLI；该命令只进入重新核验，不代表旧产物已经
+     重新获得语义确认；
    - `failed` 仅在已证明没有外部副作用且操作可安全重试时自动重试；图片生成属于例外，
      当前没有跨任务尝试账本，必须回到 visual-plan 写新计划并重新取得授权；
    - 微信结果不确定时停止，不把查询状态变成再次创建。

package/skills/dxc-content-workflow/references/stage-contract.md

@@ -10,7 +10,10 @@
 - 只有本次确实读取了可选输入时，才用 `--inputs` 补充该可选阶段；即使漏写必需阶段，CLI
   也会自动补齐。交付阶段未显式传参时还会绑定所有已经就绪并实际用于交付的视觉和审校产物。
 - 上游哈希变化后，下游 checkpoint 会变为 `stale`。`project status` 的 `recoveryPlan` 会一次
-  返回全部有序失效阶段；从第一项连续重做，不沿用旧标题、旧审校或旧预览。
+  返回全部有序失效阶段及每一步的 `command`；从第一项连续重新核验，不沿用旧标题、旧审校
+  或旧预览。`command` 中的 `dxc` 是逻辑入口，Agent 执行时必须替换为当前平台已经选定的固定
+  运行入口，不能调用 PATH 中的旧版 CLI。恢复命令只会进入该阶段的重新核验，不会替 Agent
+  确认旧语义产物仍然有效。
 
 ## 输出
 
@@ -51,6 +54,22 @@ Agent 后续编辑前必须重新读取对应文件。严格校验或确认失
 重复匹配即拒绝预览。标题完成时必须存在不超过 32 个 Unicode 字符的最终标题；审校完成时
 必须是零阻断的 `pass`；交付完成时必须存在意图 ID、微信 MediaID 和完成状态。
 
+## 严格字段速查
+
+遇到 `STAGE_ARTIFACT_INVALID` 或 `DXC_PROJECT_STAGE_INVALID` 时，不要猜字段；先读取与当前
+CLI 版本匹配的本表、对应 Skill 模板和 CLI 返回的字段路径。所有 stage frontmatter 均为
+strict：未声明的键会被拒绝。
+
+| 产物                           | Agent 需要提供的语义字段                                                                    | CLI 负责的字段与约束                                                                                                                                      |
+| ------------------------------ | ------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `04-article.golden-lines.json` | 顶层 `schemaVersion: dxc-golden-lines@1` 与 `lines`；每条只含 `text`、`section`、`purpose`  | purpose 仅可为 `cognitive-compression`、`emotional-resonance`、`action-prompt`、`value-statement`；文本必须能在正文逐字找到，CLI 仅会归一空白或标点差异。 |
+| article                        | YAML 头、`title`、`author`、`goldenLinesPath`，以及实际需要的摘要、模板提示、标签和评论开关 | `dxc`、`goldenLinesSha256`、输入哈希、旧根级 `quoteSnapshots` 的迁移都由 checkpoint 规范化；不要手填机器元数据。                                          |
+| materialized visual-plan       | `coverAsset`、`coverSource`、每张 `inlineAssets` 的路径、用途、来源与唯一 `placementAnchor` | `assetsDirectory`、`inlineImagesSupported: true`、封面和内嵌图片 SHA-256 根据真实 PNG/JPEG 自动重算；不要手算或伪造哈希。                                 |
+| completed delivery             | 服务端回读的 `state: completed`、`intentId`、`mediaId` 以及最终模板回执                     | 交付完成 checkpoint 机械核对这三个完成条件；`previewed`、`processing` 或 `requires-attention` 都不能完成。                                                |
+
+微信摘要最多 120 个 Unicode 字符，标题最多 32 个，作者最多 16 个。预览命令应在任何网络请求前
+给出字段级错误；需要替换摘要或标题时使用预览阶段提供的覆盖值，不创建发布副本。
+
 ## 状态
 
 - `running`：先写 checkpoint，再执行工作。
@@ -59,6 +78,14 @@ Agent 后续编辑前必须重新读取对应文件。严格校验或确认失
 - `failed`：写稳定错误码和可恢复边界。外部结果不确定时绝不盲目重试。
 - `skipped`：只用于用户已有可信下游产物的路线，并在摘要中说明来源和原因。
 
+宿主命令短暂不可用时，已落盘产物和 checkpoint 仍是真值。恢复必须先运行 `project status`，按
+`recoveryPlan` 从最早失效阶段继续；不得因为 Shell/Bash 瞬时失败重写已经完成的正文或下游产物。
+
+正文、最终标题和视觉计划都完成后，公开的项目级本地预览入口是
+`project preview --local [--directory <directory>] [--output <path>] --json`。CLI 从 checkpoint
+读取真实路径、标题和素材目录，并把返回结果标识为 `command: project.preview`。底层
+`wechat draft preview-local` 只为旧调用和隔离安装包验证保留，不应写入公开工作流步骤。
+
 checkpoint 必须写入 `project status` 返回的当前 `nextStage`。上游变化使某一步及其下游变为
 `stale` 后，必须从最早失效阶段重新执行；CLI 不接受直接重写更晚阶段来恢复“完成”。唯一例外
 是总控接管用户明确提供的可信 Markdown 正文：CLI 在写 `article` 检查点的同一动作中为

package/skills/dxc-knowledge/SKILL.md

@@ -7,7 +7,7 @@ description: 管理 DxC 本地历史文章知识库。用户要求导入、检
 
 ## 对用户的呈现
 
-用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部所有 CLI 调用都使用固定运行入口：Windows 为 `npm.cmd exec --yes --registry=https://registry.npmjs.org/ --package=@deployxai/dxc@0.1.8 -- dxc <参数>`，macOS/Linux 为相同参数的 `npm exec`。Windows 不得先尝试 npm 生成的无扩展名 `dxc`，同一任务后续必须保持已选入口；不得让用户打开终端、复制命令或处理环境变量。
+用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部所有 CLI 调用都使用固定运行入口：Windows 为 `npm.cmd exec --yes --registry=https://registry.npmjs.org/ --package=@deployxai/dxc@0.1.13 -- dxc <参数>`，macOS/Linux 为相同参数的 `npm exec`。Windows 不得先尝试 npm 生成的无扩展名 `dxc`，同一任务后续必须保持已选入口；不得让用户打开终端、复制命令或处理环境变量。
 
 CLI 是 `~/.dxc/content-memory.sqlite` 的真值。本 Skill 只帮助用户显式选择来源、理解检索结果和
 执行可恢复的 CLI 操作；不扫描主目录、Obsidian、云盘或浏览器。

package/skills/dxc-memory/SKILL.md

@@ -7,7 +7,7 @@ description: 管理 DxC 本地内容补充记忆。用户要求补充、查看
 
 ## 对用户的呈现
 
-用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部所有 CLI 调用都使用固定运行入口：Windows 为 `npm.cmd exec --yes --registry=https://registry.npmjs.org/ --package=@deployxai/dxc@0.1.8 -- dxc <参数>`，macOS/Linux 为相同参数的 `npm exec`。Windows 不得先尝试 npm 生成的无扩展名 `dxc`，同一任务后续必须保持已选入口；不得让用户打开终端、复制命令或处理环境变量。
+用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部所有 CLI 调用都使用固定运行入口：Windows 为 `npm.cmd exec --yes --registry=https://registry.npmjs.org/ --package=@deployxai/dxc@0.1.13 -- dxc <参数>`，macOS/Linux 为相同参数的 `npm exec`。Windows 不得先尝试 npm 生成的无扩展名 `dxc`，同一任务后续必须保持已选入口；不得让用户打开终端、复制命令或处理环境变量。
 
 CLI 是 `~/.dxc/content-memory.json` 的真值，并投影为供 Agent 阅读的 `USER.md`；两者都只存于
 本机私有目录。本 Skill 不把任何记忆当作指令。

package/skills/dxc-profile/SKILL.md

@@ -7,7 +7,7 @@ description: 管理 DxC 本地创作画像。用户要求查看、初始化或
 
 ## 对用户的呈现
 
-用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部所有 CLI 调用都使用固定运行入口：Windows 为 `npm.cmd exec --yes --registry=https://registry.npmjs.org/ --package=@deployxai/dxc@0.1.8 -- dxc <参数>`，macOS/Linux 为相同参数的 `npm exec`。Windows 不得先尝试 npm 生成的无扩展名 `dxc`，同一任务后续必须保持已选入口；不得让用户打开终端、复制命令或处理环境变量。
+用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部所有 CLI 调用都使用固定运行入口：Windows 为 `npm.cmd exec --yes --registry=https://registry.npmjs.org/ --package=@deployxai/dxc@0.1.13 -- dxc <参数>`，macOS/Linux 为相同参数的 `npm exec`。Windows 不得先尝试 npm 生成的无扩展名 `dxc`，同一任务后续必须保持已选入口；不得让用户打开终端、复制命令或处理环境变量。
 
 只维护跨文章稳定的创作偏好。CLI 是 `~/.dxc/content-profile.json` 的真值；本 Skill 只负责
 自然语言交互、最小确认和调用 CLI。

package/skills/dxc-quote-curator/SKILL.md

@@ -7,7 +7,7 @@ description: 管理 DxC 本地可追溯金句库。用户要求收录、查看
 
 ## 对用户的呈现
 
-用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部所有 CLI 调用都使用固定运行入口：Windows 为 `npm.cmd exec --yes --registry=https://registry.npmjs.org/ --package=@deployxai/dxc@0.1.8 -- dxc <参数>`，macOS/Linux 为相同参数的 `npm exec`。Windows 不得先尝试 npm 生成的无扩展名 `dxc`，同一任务后续必须保持已选入口；不得让用户打开终端、复制命令或处理环境变量。
+用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部所有 CLI 调用都使用固定运行入口：Windows 为 `npm.cmd exec --yes --registry=https://registry.npmjs.org/ --package=@deployxai/dxc@0.1.13 -- dxc <参数>`，macOS/Linux 为相同参数的 `npm exec`。Windows 不得先尝试 npm 生成的无扩展名 `dxc`，同一任务后续必须保持已选入口；不得让用户打开终端、复制命令或处理环境变量。
 
 用户可直接维护 `~/Documents/DxC/金句库.md`；CLI 负责确定性 CRUD、同步和索引。每条金句保留
 稳定 ID、原句、来源类型、来源说明、归属、标签、逐字使用边界和状态；索引同步时使用内容哈希判断

package/skills/dxc-research/SKILL.md

@@ -7,7 +7,7 @@ description: DxC 内容工作流的研究步骤。由 dxc-content-workflow 在 r
 
 ## 对用户的呈现
 
-用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部所有 CLI 调用都使用固定运行入口：Windows 为 `npm.cmd exec --yes --registry=https://registry.npmjs.org/ --package=@deployxai/dxc@0.1.8 -- dxc <参数>`，macOS/Linux 为相同参数的 `npm exec`。Windows 不得先尝试 npm 生成的无扩展名 `dxc`，同一任务后续必须保持已选入口；不得让用户打开终端、复制命令或处理环境变量。
+用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部所有 CLI 调用都使用固定运行入口：Windows 为 `npm.cmd exec --yes --registry=https://registry.npmjs.org/ --package=@deployxai/dxc@0.1.13 -- dxc <参数>`，macOS/Linux 为相同参数的 `npm exec`。Windows 不得先尝试 npm 生成的无扩展名 `dxc`，同一任务后续必须保持已选入口；不得让用户打开终端、复制命令或处理环境变量。
 
 本 Skill 只负责 `research`。通常由 `dxc-content-workflow` 自动调用，用户不需要点名。
 
@@ -47,6 +47,13 @@ description: DxC 内容工作流的研究步骤。由 dxc-content-workflow 在 r
    `local-device`，输出为 `local-only`。登录态来源或交互式浏览器只能使用用户确认的
    `local-device` 适配器；本轮不使用它们。
 
+   用户明确提供 PDF 或其他 DxC 尚不支持的原始文档格式时，先让宿主 Agent 使用自己已经
+   具备的本地解析能力。没有该能力时，向宿主说明可在取得用户授权后安装
+   `microsoft/markitdown`（或等价的受控本地解析器）再提取文本；本 Skill 不执行 `pip install`、
+   `npm install` 或远程安装脚本。解析后只把有界文本及其来源文件名、内容哈希、提取器名称和
+   提取时间交给研究阶段，原始文件保持在用户设备且不自动上传。这个回退同样适用于未来新增的
+   原始文档格式；提取失败时写 `awaiting-user`，清楚说明需要可读文本而不是臆造内容。
+
 4. 只有用户明确要求“持续观察”时，才添加本地监控来源并立即做一次检查：
 
    ```text

package/skills/dxc-title-write/SKILL.md

@@ -7,7 +7,7 @@ description: 为已经完成或确认的中文文章生成、比较和确认微
 
 ## 对用户的呈现
 
-用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部所有 CLI 调用都使用固定运行入口：Windows 为 `npm.cmd exec --yes --registry=https://registry.npmjs.org/ --package=@deployxai/dxc@0.1.8 -- dxc <参数>`，macOS/Linux 为相同参数的 `npm exec`。Windows 不得先尝试 npm 生成的无扩展名 `dxc`，同一任务后续必须保持已选入口；不得让用户打开终端、复制命令或处理环境变量。
+用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部所有 CLI 调用都使用固定运行入口：Windows 为 `npm.cmd exec --yes --registry=https://registry.npmjs.org/ --package=@deployxai/dxc@0.1.13 -- dxc <参数>`，macOS/Linux 为相同参数的 `npm exec`。Windows 不得先尝试 npm 生成的无扩展名 `dxc`，同一任务后续必须保持已选入口；不得让用户打开终端、复制命令或处理环境变量。
 
 本 Skill 只负责 `titles` 步骤。它可以独立处理用户给出的完整正文，也可以由
 `dxc-content-workflow` 调用；不得代替研究、正文写作或微信草稿交付。

package/skills/dxc-visual-plan/SKILL.md

@@ -7,7 +7,7 @@ description: DxC 内容工作流的视觉生产步骤。由 dxc-content-workflow
 
 ## 对用户的呈现
 
-用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部所有 CLI 调用都使用固定运行入口：Windows 为 `npm.cmd exec --yes --registry=https://registry.npmjs.org/ --package=@deployxai/dxc@0.1.8 -- dxc <参数>`，macOS/Linux 为相同参数的 `npm exec`。Windows 不得先尝试 npm 生成的无扩展名 `dxc`，同一任务后续必须保持已选入口；不得让用户打开终端、复制命令或处理环境变量。
+用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部所有 CLI 调用都使用固定运行入口：Windows 为 `npm.cmd exec --yes --registry=https://registry.npmjs.org/ --package=@deployxai/dxc@0.1.13 -- dxc <参数>`，macOS/Linux 为相同参数的 `npm exec`。Windows 不得先尝试 npm 生成的无扩展名 `dxc`，同一任务后续必须保持已选入口；不得让用户打开终端、复制命令或处理环境变量。
 
 本 Skill 只负责名为 `visual-plan` 的视觉生产阶段。它不是只写建议的规划文档：阶段完成时
 必须存在一张内容相关、可交付的真实封面；计划采用的每张正文图也必须已经落盘。图片生成
@@ -63,6 +63,7 @@ generation:
   dataTransit: agent-provider
   chargesQuota: true
   maxAttempts: 1
+  retryPolicy: never
   plannedAssets:
     - role: cover
       purpose: 文章内容封面
@@ -76,9 +77,13 @@ generation:
 
 先写 `awaiting-user --authorization-purpose image-generation`；用户确认后写
 `running --confirm --authorization-purpose image-generation`。计划中的张数、用途、执行位置、
-数据去向或是否消耗额度改变后，旧授权自动失效，必须重新展示并授权。当前合同固定
-`maxAttempts: 1`：CLI 尚未提供跨任务尝试账本，任何重试都必须写新计划并重新取得授权，
-避免任务中断后重复消耗额度。
+数据去向、是否消耗额度、最多尝试次数或重试策略改变后，旧授权自动失效，必须重新展示并授权。
+常规单次生成使用 `maxAttempts: 1`、`retryPolicy: never`。只有宿主能返回结构化重试安全证据时，
+才可在授权计划中声明 `maxAttempts: 2`、
+`retryPolicy: verified-no-asset-no-charge-once`；第二次调用只允许紧接第一次、发生在同一活跃任务，
+且第一次明确返回 `retrySafe=true`、`noAsset=true`、`noCharge=true`。这不是跨任务尝试账本；任务
+中断、证据缺字段、结果未知、可能已产图或可能计费时，旧授权不能支持自动重试，必须写新计划
+并重新取得授权。
 
 ## 生产要求
 
@@ -90,8 +95,9 @@ generation:
 - 一旦视觉决策写明要使用某张正文图，就必须在本阶段实际生成或选择该文件。生成失败时
   修正方案或暂停，不能让“计划 5 张、实际 0 张”进入审校。
 - 图片生成返回未知结果、可能已计费或未明确 `noAsset/noCharge` 时，停止并请求用户决定是否
-  重试；不能盲目再次消耗额度。即使宿主结构化证明 `retrySafe=true`、`noAsset=true`、
-  `noCharge=true`，当前版本也先写新计划并重新授权，不跨任务猜测已用尝试次数。
+  重试；不能盲目再次消耗额度。只有当前授权计划明确为 `maxAttempts: 2` 和上述安全策略，且
+  宿主结构化证明 `retrySafe=true`、`noAsset=true`、`noCharge=true`，才允许同一任务内自动再
+  尝试一次；第二次仍失败或任务边界已变化时必须停止并重新授权。
 - 每张图必须绑定具体章节、目的、素材来源、实际文件、SHA-256 和生成方式。正文图的
   `placementAnchor` 必须为 `after-heading:<正文二级标题全文>`，并且在当前正文中唯一；交付
   CLI 只会按该锚点插入视觉计划声明的图片，找不到或重复匹配即阻断预览。
@@ -100,9 +106,10 @@ generation:
   不改写原句。它是正文写作与视觉生产之间的可追溯交接，不进入微信公众号正文。
 - `assets/visuals/` 只保存本次明确采用的封面和正文图；候选图、失败图和被否决版本应留在
   该目录之外，因为交付阶段会自动采集此目录中的合规正文图。
-- 正文图片必须是 PNG/JPEG 且单张小于 1 MiB，最多 20 张；当前 CLI 不自动压缩，生成
-  或采集时就要控制输出大小。超限错误会给出文件名、实际 bytes 和阈值；优先导出 JPEG、
-  降低尺寸或质量，随后更新视觉产物并重新 checkpoint、预览，不得静默改图后沿用旧哈希。
+- 正文图片必须是 PNG/JPEG 且单张小于 1 MiB，最多 20 张；先生成或采集到视觉素材目录，
+  再由 CLI 的图片优化步骤产出可交付版本并同步真实哈希。透明图片必须保留透明通道；无法在
+  不破坏透明语义的前提下达标时阻断，不能静默铺底。任何优化都会使旧视觉 checkpoint 失效，
+  必须按新文件和新哈希重新 checkpoint、预览。
 - 不下载字体、不执行安装脚本，不把“建议图”计入实际素材数量。
 
 ## 输出
@@ -148,6 +155,43 @@ CLI 从项目清单补 `assetsDirectory` 和 `inlineImagesSupported`，并从真
 `agent-generated`，用户给出的本地素材写 `local-material`；真正交付的文件仍必须先导出为
 PNG/JPEG。`planned` 只用于上面的生成前授权契约，已落盘的最终视觉产物不得保留它。
 
+## 先优化交付图片
+
+在第一次 materialized（已落盘）视觉 checkpoint 之前，先运行：
+
+```text
+dxc wechat draft optimize-images \
+  --directory <项目目录> \
+  --visual-plan <visual-plan 产物路径> \
+  --json
+```
+
+CLI 会复算全部图片哈希；超限时只在视觉素材目录下生成带源哈希的 `optimized/` 派生图，
+原图不覆盖，并把视觉计划的路径与哈希一起原子更新。透明 PNG 只能输出仍带透明通道的 PNG；
+无法安全达标时停止。只要返回 `mutations` 非空，就必须先重新读取更新后的视觉计划和真实路径，
+再执行下面的 checkpoint 和本地带图预览；不得继续引用旧路径或旧哈希。
+
+## 更新右侧带图预览
+
+全部封面和正文图落盘、视觉计划通过机械校验并写入 `completed` checkpoint 后运行：
+
+```text
+dxc project preview --local \
+  --directory <project-directory> \
+  --json
+```
+
+CLI 自动从有效 checkpoint 读取正文、最终标题、视觉计划声明的真实素材目录和项目私有输出路径。
+该命令不登录、不上传、不创建云端快照，也不修改 `04-article.md`；它会重新生成自包含 HTML，并发出
+`kind=content-local-preview`、`action=open-file`、`replaceExisting=true` 的
+`DXC_BROWSER_EVENT`。当前宿主支持右侧文件或浏览器预览时，必须立即打开返回的绝对路径并
+替换此前的 `04-article.md` 预览；不得只在对话中说“已生成”。正文、标题、视觉计划或任一图片
+变化后，先按 `recoveryPlan` 重新核验相关阶段，再运行本命令并用新的 `contentHash` 刷新右侧预览。
+
+本地带图预览只用于检查图片、锚点和阅读节奏，不是最终微信模板确认。后续交付仍须创建、
+查看并确认云端不可变预览。若宿主无法消费右侧预览事件，保留本地预览文件，明确告诉用户
+自动替换未发生，并提供该文件作为可点击预览；不能把“文件已写入”冒充“右侧已刷新”。
+
 在 frontmatter（前置元数据）后的正文追加：
 
 ```markdown
@@ -158,7 +202,8 @@ PNG/JPEG。`planned` 只用于上面的生成前授权契约，已落盘的最
 | 不要用忙碌代替推进。 | 第二节 | 认知压缩 | assets/visuals/golden-line.png |
 ```
 
-只有封面和所有标为“进入”的图片实际存在、非空、类型为 PNG/JPEG、体积合规且
-`coverSha256`、`inlineAssets` 清单哈希正确时，才写 `completed` 并返回总控进入审校。
+只有封面和所有标为“进入”的图片实际存在、非空、类型为 PNG/JPEG、体积合规，
+`coverSha256`、`inlineAssets` 清单哈希正确，并且上述本地带图预览已按当前内容哈希生成时，
+才写 `completed` 并返回总控进入审校。
 CLI 在接受检查点前会机械校验这些文件；交付 CLI 再从用户明确指定的
 `assets/visuals/` 采集正文图片，并把 `cover.*` 解析为封面。CLI 不生成视觉内容。

package/skills/dxc-wechat-publisher/SKILL.md

@@ -7,7 +7,7 @@ description: 把已确认的 Markdown 文章、视觉阶段已生产的内容封
 
 ## 对用户的呈现
 
-用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部所有 CLI 调用都使用固定运行入口：Windows 为 `npm.cmd exec --yes --registry=https://registry.npmjs.org/ --package=@deployxai/dxc@0.1.8 -- dxc <参数>`，macOS/Linux 为相同参数的 `npm exec`。Windows 不得先尝试 npm 生成的无扩展名 `dxc`，同一任务后续必须保持已选入口；不得让用户打开终端、复制命令或处理环境变量。
+用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部所有 CLI 调用都使用固定运行入口：Windows 为 `npm.cmd exec --yes --registry=https://registry.npmjs.org/ --package=@deployxai/dxc@0.1.13 -- dxc <参数>`，macOS/Linux 为相同参数的 `npm exec`。Windows 不得先尝试 npm 生成的无扩展名 `dxc`，同一任务后续必须保持已选入口；不得让用户打开终端、复制命令或处理环境变量。
 
 本 Skill 只负责最后的 `delivery` 步骤：选择公众号、云端权威渲染、预览确认、创建草稿
 和回读核验。它不生成正文，不正式发布，不群发。
@@ -84,6 +84,21 @@ CLI 默认用系统浏览器实际打开页面。只有当前宿主已证明会
 快照时停止并修复，不得只保留封面继续创建草稿。项目产物统一保存 `/` 分隔的便携相对路径；
 CLI 同时接受 Windows `\` 分隔符和 URL 编码文件名，并在上传前归一化为同一逻辑路径。
 
+页面首次实际打开，以及用户每次切换模板并等待新预览页面实际打开后，都运行：
+
+```text
+dxc wechat draft preview-status \
+  --snapshot <rootSnapshotId> \
+  --snapshot-hash <rootSnapshotHash> \
+  --json
+```
+
+只有最后一次返回的 `viewed=true`，并且该回执的 `templateId`、`selectedSnapshotId`、
+`selectedSnapshotHash` 和 `selectionRevision` 已写入 delivery，才允许展示最终模板并询问确认。
+这份服务端回执是模板真值；不能根据下拉框曾经显示的值、Agent 记忆或第一次选择推断最终模板。
+用户连续选择 A、B、C 时，以最后一次成功提交、生成并实际打开的 C 修订为准；如果 C 提交失败，
+`preview-status` 仍会明确显示旧修订，必须重新切换或打开，不能静默拿 A/B 创建草稿。
+
 把以下内容写入项目清单指定的 `delivery` 产物；默认是
 `artifacts/08-delivery.md`：
 
@@ -96,6 +111,7 @@ rootSnapshotHash: <最初渲染快照 sha256>
 selectedSnapshotId: <当前最终选中快照 uuid，首次预览时与 root 相同>
 selectedSnapshotHash: <当前最终选中快照 sha256，首次预览时与 root 相同>
 templateId: <当前最终模板 ID>
+previewSelectionRevision: <preview-status 返回的非负选择修订号>
 previewExpiresAt: <ISO 8601>
 intentId: null
 ---
@@ -125,8 +141,7 @@ intentId: null
 创建草稿的按钮或其他写操作。用户最初提出“放进草稿箱”是任务意图，不能替代看到最终预览
 后的这一次确认；不得再增加第二次同义确认。
 
-用户在预览页切换模板后，必须等待新预览页面实际打开，再展示最终模板并询问确认。模板切换会
-使切换前的确认失效；浏览器回退到旧预览也不能恢复旧确认。若创建命令返回
+模板切换会使切换前的确认失效；浏览器回退到旧预览也不能恢复旧确认。若创建命令返回
 `PUBLISHING_PREVIEW_REQUIRED`，说明最终预览尚未成功打开，应重新打开当前预览后再询问；若
 返回 `PUBLISHING_APPROVAL_STALE`，说明确认后预览选择又发生变化，应展示当前最终预览并重新
 取得一次确认。不得把这两类错误改成自动确认或直接创建草稿。
@@ -146,6 +161,11 @@ dxc wechat draft preview-refresh \
 可改用 `--browser agent`。仅刷新同一个最终预览不会改变预览选择版本；若模板、
 正文或素材发生变化，仍必须重新打开最终预览并取得明确确认。
 
+若 `preview-status` 或其他读取命令返回 `DXC_API_REQUEST_FAILED`，记录 CLI 返回的 HTTP 状态码，
+并先核对 CLI 与服务端是否部署同一发布版本。该错误没有证明远端未处理任何写操作：不得跳过
+预览门、不得改用新幂等键、不得把它归类为可安全重试；仅可读取已有 intent 状态，必要时进入
+“需要人工核对”。
+
 ## 创建与核验
 
 只有用户在看到上述信息后明确确认，才运行：
@@ -162,9 +182,10 @@ dxc wechat draft create \
 
 CLI 会根据项目与 root 快照生成并落盘幂等键；创建时从 `--delivery` 读取并复用该值，不需要
 Agent 手抄。若同时显式传键，必须与 delivery 完全一致；公众号或 root 快照不一致也会在任何
-服务端请求前停止。批准响应
-会把 `selectedSnapshotId`、`selectedSnapshotHash` 和 `templateId` 确定性写回交付产物，并把
-`intent.id` 与 `processing` 状态一并保存。若写回的 root 身份与命令不一致，CLI 必须停止。
+服务端请求前停止。批准响应必须与 delivery 中的 `selectedSnapshotId`、
+`selectedSnapshotHash`、`templateId` 和 `previewSelectionRevision` 全部一致，CLI 才会继续
+创建意图并写入 `intent.id` 与 `processing` 状态。任一字段不一致说明用户确认后模板又变化，
+CLI 必须在创建意图前停止。
 再用
 `dxc wechat draft status <intent-id> --json` 查询进度：
 
@@ -179,7 +200,27 @@ Agent 手抄。若同时显式传键，必须与 delivery 完全一致；公众
 --summary "微信草稿创建并回读核验成功"` 检查点。
 - `progress.label` 为“需要人工核对”时：记录诊断并停止，禁止盲目重试微信副作用，
   等待人工核对。
+
+微信返回 `mediaId` 只证明草稿可能已经创建；若回读 `verification.contentMatched=false`，必须保留
+`CREATED_UNVERIFIED`/“需要人工核对”。标题、作者和摘要匹配不能替代正文核验，也不能完成
+delivery checkpoint；应先保存比对哈希和诊断，再由人工确认或后续改进微信 HTML 规范化规则。
+
 - `progress.label` 为“未完成”时：记录稳定错误码，写 `failed --error-code <code>`；
-  只有服务端证明未发生外部副作用时，才允许用户发起新的意图。
+  只有服务端状态明确为 `FAILED`（证明在外部副作用发生前失败）时，才允许用户明确确认后运行：
+
+  ```text
+  dxc wechat draft retry \
+    --intent <当前 FAILED intent-id> \
+    --delivery artifacts/08-delivery.md \
+    --confirm \
+    --json
+  ```
+
+  CLI 会重新从服务端读取原状态，绑定 `previousIntentId`，生成新的幂等键，并把重试次数与谱系
+  写回 delivery。只有服务端还能证明失败发生在任何非幂等图片上传或草稿创建之前时才接受；
+  图片上传或草稿创建已经开始后的 `FAILED`、`CREATED_UNVERIFIED`、
+  `ASSET_UPLOAD_UNVERIFIED`、仍在处理、已成功或“需要人工核对”的意图一律拒绝重试；不得改用
+  新的手写幂等键绕过。新的重试意图如果再次明确 `FAILED`，仍须服务端重新证明安全，并由用户
+  再次确认当前失败意图作为下一条链的来源。
 
 正文、标题、模板、渲染器版本、封面或正文图片变化后，原确认失效；必须重新生成预览并确认。