@deployxai/dxc 0.1.13 → 0.2.1

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

@@ -1,226 +1,39 @@
 ---
 name: dxc-wechat-publisher
-description: 把已确认的 Markdown 文章、视觉阶段已生产的内容封面及正文图片交付到微信公众号草稿箱。用户要求预览、绑定或选择公众号、创建微信草稿，或 dxc-content-workflow 推进到 delivery 检查点时使用；创建前默认在系统浏览器展示云端不可变预览，只有宿主能力已验证时才使用右侧浏览器，并取得精确确认。
+description: 把 DxC 项目中已经准备好的文章、封面和正文图片预览并创建到微信公众号草稿箱。用户要求预览、选择公众号、创建微信草稿，或 dxc-content-workflow 返回 delivery 阶段时使用；可以从已有完整项目直接进入交付阶段。
 ---
 
 # DxC 微信草稿交付
 
-## 对用户的呈现
+内部固定使用 `@deployxai/dxc@0.2.1`；Windows 通过 `npm.cmd exec`，macOS/Linux 通过 `npm exec`
+运行，不切换到 PATH 中的其他版本。
 
-用户只通过自然语言使用本 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 只负责最后的微信交付，不生成正文，不正式发布，不群发。
 
-本 Skill 只负责最后的 `delivery` 步骤：选择公众号、云端权威渲染、预览确认、创建草稿
-和回读核验。它不生成正文，不正式发布，不群发。
+## 进入交付
 
-## 就绪检查
+- 总控返回 `step: delivery` 时直接使用该项目。
+- 已有完整项目需要直接进入交付时调用：
 
-1. 运行 `dxc version --json`，要求 CLI `0.1.x` 且协议兼容。
-2. 若设备尚未登录或没有公众号，按以下顺序打开扫码页：已验证能实时接管事件的宿主使用
-   `dxc setup --server <https-url> --no-open` 并在右侧打开；右侧打开失败或能力未经验证时，
-   立即改用不带 `--no-open` 的 `dxc setup --server <https-url>`，让 CLI 调用 Windows 或 macOS
-   的系统默认浏览器；系统浏览器也失败时，把 CLI 返回的短时 URL 呈现为“继续扫码”的可点击
-   链接。前两级不向用户展示 URL，第三级不展示任何命令、参数或技术解释。该流程最多出现两次
-   不同语义的扫码：
-   - 个人微信登录或明确注册 DxC 用户；
-   - 公众号管理员授权第三方平台的草稿能力。
-     页面打开后保持 CLI 轮询继续运行；链接过期时自动重新执行当前扫码步骤并打开新链接，
-     不要求用户重新输入命令。
-3. 运行 `dxc wechat accounts`。没有可用账号时停止；多个账号时向用户展示名称和
-   `accountId`，要求明确选择，不能使用“上一次账号”。
-4. 运行 `dxc project status --directory <project> --json`，读取实际产物路径。要求正文
-   就绪、标题已确认，且视觉阶段已经在 `assets/visuals` 生产或选择内容相关的
-   `cover.png`/`cover.jpg`。缺封面时返回视觉阶段处理；不得生成纯色占位图。
-5. 把 `delivery` 检查点写为 `running`：
-
-   ```bash
-     dxc project checkpoint delivery \
-       --status running \
-     --summary "正在为已确认文章生成微信公众号预览" \
-     --execution-location local-device \
-     --data-transit dxc-cloud \
-     --json
-   ```
-
-   CLI 自动绑定正文、标题，以及已经就绪的视觉计划和审校报告；不要手抄发布副本、路径或
-   哈希，也不要记录没有读取的占位产物。
-
-## 生成不可变云端预览
-
-运行：
-
-```bash
-dxc wechat draft preview \
-  --article <article.md> \
-  --assets-directory <project>/assets/visuals \
-  --visual-plan <visual-plan.md> \
-  --cover <cover.png-or-jpeg-or-auto> \
-  --account <account-id> \
-  --title "<已确认标题>" \
-  --browser system \
-  --json
-```
-
-若 Agent 已根据文章类型给出建议，可在文章 frontmatter 写入目录中的
-`dxc_wechat_template_hint`；它只决定首次预览，用户始终在预览页选择最终模板。CLI 会显式上传
-Markdown、封面和正文图片，由云端使用建议或默认固定模板权威渲染，并返回
-`snapshot.id`、`snapshot.snapshotHash`、`preview.url`、目标账号和预检结果。
-返回还包含 `preview.createdAt`、`preview.expiresAt`、`preview.expiresInSeconds` 和
-`snapshot.inlineAssets`；正文图片哈希属于不可变快照。`auto` 只从文章声明或显式素材
-目录解析已经存在的 `cover.*`，不会生成占位封面。
-
-CLI 只在上传字节中移除本地工作流专用的 `dxc`、`goldenLinesPath` 和
-`goldenLinesSha256` frontmatter，原始正文产物保持不变。Agent 不得另外创建
-`04-article.publish.md` 之类的发布副本来规避云端校验。
-
-CLI 默认用系统浏览器实际打开页面。只有当前宿主已证明会实时消费
-`kind=wechat-draft-preview` 的 `DXC_BROWSER_EVENT`、导航最终 URL 并跟随模板切换跳转时，才显式
-改用 `--browser agent`。仅收到事件或显示空面板不算用户已查看；此时必须对同一快照运行
-`preview-refresh ... --browser system --json`，由 CLI 打开系统默认浏览器。系统浏览器也无法打开时，
-把 CLI 返回的短时 URL 仅渲染为“查看预览”的可点击链接；不展示原始 URL、命令或技术说明，
-也不把链接写进日志或项目产物。
-
-正文图片是交付必需品，不是可静默降级项。视觉计划或 Markdown 声明了正文图片时，必须核对
-`snapshot.inlineAssets` 数量和逻辑路径全部一致；任一图片缺失、无法读取、上传失败或未进入
-快照时停止并修复，不得只保留封面继续创建草稿。项目产物统一保存 `/` 分隔的便携相对路径；
-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`：
-
-```markdown
----
-state: previewed
-accountId: <uuid>
-rootSnapshotId: <最初渲染快照 uuid>
-rootSnapshotHash: <最初渲染快照 sha256>
-selectedSnapshotId: <当前最终选中快照 uuid，首次预览时与 root 相同>
-selectedSnapshotHash: <当前最终选中快照 sha256，首次预览时与 root 相同>
-templateId: <当前最终模板 ID>
-previewSelectionRevision: <preview-status 返回的非负选择修订号>
-previewExpiresAt: <ISO 8601>
-intentId: null
----
-
-# 微信草稿交付
-
-- 公众号：<名称和 AppID 脱敏标识>
-- 标题：<已确认标题>
-- 模板：<用户在预览页最终选择的 templateId>
-- 预览：已在右侧内置浏览器或系统默认浏览器展示
-- 预检：<通过，或逐项列出问题>
-```
-
-使用与进入步骤相同的输入和执行参数把检查点写为 `awaiting-user`，并增加：
-
-```text
---summary "不可变预览已经生成并绑定目标公众号"
---waiting-for "是否确认把这个快照创建到这个公众号的草稿箱？"
---confirmation-snapshot <selectedSnapshotHash>
-```
-
-只向用户展示公众号名称、标题、封面、正文图片数和预检结果，并提醒查看已经打开的预览。
-不要展示 `accountId`、`snapshotId`、`snapshotHash`、幂等键、短时 URL、剩余秒数或内部命令。
-最终预览页面成功加载后，不等待用户再次追问，立即在 WorkBuddy 对话中呈现一次“确认创建草稿”
-和“返回修改”两个动作；宿主支持可点击选项时使用可点击选项，否则只询问一次：“确认创建草稿，
-还是返回修改？”预览页只显示“返回 WorkBuddy 确认”的只读提示，不得在短时预览链接中加入
-创建草稿的按钮或其他写操作。用户最初提出“放进草稿箱”是任务意图，不能替代看到最终预览
-后的这一次确认；不得再增加第二次同义确认。
-
-模板切换会使切换前的确认失效；浏览器回退到旧预览也不能恢复旧确认。若创建命令返回
-`PUBLISHING_PREVIEW_REQUIRED`，说明最终预览尚未成功打开，应重新打开当前预览后再询问；若
-返回 `PUBLISHING_APPROVAL_STALE`，说明确认后预览选择又发生变化，应展示当前最终预览并重新
-取得一次确认。不得把这两类错误改成自动确认或直接创建草稿。
-恢复时先比较当前时间与 `previewExpiresAt`：链接已过期则运行：
-
-```bash
-dxc wechat draft preview-refresh \
-  --snapshot <rootSnapshotId> \
-  --snapshot-hash <rootSnapshotHash> \
-  --browser system \
-  --json
-```
-
-这只为原始快照（以及已记录的最终模板选择）重建短时链接，不得重跑正文、素材或草稿意图。
-把新的 `previewExpiresAt` 写回交付产物；刷新和创建请求仍以交付产物中的 root 快照发起，
-服务端会解析为用户最后选择的不可变 selected 快照。默认在系统浏览器打开；仅已验证宿主才
-可改用 `--browser agent`。仅刷新同一个最终预览不会改变预览选择版本；若模板、
-正文或素材发生变化，仍必须重新打开最终预览并取得明确确认。
-
-若 `preview-status` 或其他读取命令返回 `DXC_API_REQUEST_FAILED`，记录 CLI 返回的 HTTP 状态码，
-并先核对 CLI 与服务端是否部署同一发布版本。该错误没有证明远端未处理任何写操作：不得跳过
-预览门、不得改用新幂等键、不得把它归类为可安全重试；仅可读取已有 intent 状态，必要时进入
-“需要人工核对”。
-
-## 创建与核验
-
-只有用户在看到上述信息后明确确认，才运行：
-
-```bash
-dxc wechat draft create \
-  --account <account-id> \
-  --snapshot <rootSnapshotId> \
-  --snapshot-hash <rootSnapshotHash> \
-  --delivery artifacts/08-delivery.md \
-  --confirm \
-  --json
-```
-
-CLI 会根据项目与 root 快照生成并落盘幂等键；创建时从 `--delivery` 读取并复用该值，不需要
-Agent 手抄。若同时显式传键，必须与 delivery 完全一致；公众号或 root 快照不一致也会在任何
-服务端请求前停止。批准响应必须与 delivery 中的 `selectedSnapshotId`、
-`selectedSnapshotHash`、`templateId` 和 `previewSelectionRevision` 全部一致，CLI 才会继续
-创建意图并写入 `intent.id` 与 `processing` 状态。任一字段不一致说明用户确认后模板又变化，
-CLI 必须在创建意图前停止。
-再用
-`dxc wechat draft status <intent-id> --json` 查询进度：
+  ```text
+  dxc workflow start --from delivery --directory "<项目目录>" --json
+  ```
 
-- `progress.terminal` 为 `false` 时：按 `progress.pollAfterSeconds` 静默、安全查询；只有等待
-  明显超出服务端建议或用户主动询问时才展示 `progress.label`、`progress.message` 和
-  `progress.nextAction`。不要展示内部处理阶段或 Worker 信息，也不要再次创建。
-- `progress.terminal` 为 `true`，且存在微信 `mediaId`，标题、作者、摘要和正文的
-  `verification` 全部匹配时：把 `state`、`intentId`、`mediaId` 和核验结果写回交付
-  产物，然后写下列检查点；CLI 自动更新 `dxc.artifactStatus`：
-  `completed --confirm --confirmed-by <稳定身份标识>
---confirmation-snapshot <selectedSnapshotHash>
---summary "微信草稿创建并回读核验成功"` 检查点。
-- `progress.label` 为“需要人工核对”时：记录诊断并停止，禁止盲目重试微信副作用，
-  等待人工核对。
+- 只使用本页列出的 workflow 领域命令。
 
-微信返回 `mediaId` 只证明草稿可能已经创建；若回读 `verification.contentMatched=false`，必须保留
-`CREATED_UNVERIFIED`/“需要人工核对”。标题、作者和摘要匹配不能替代正文核验，也不能完成
-delivery checkpoint；应先保存比对哈希和诊断，再由人工确认或后续改进微信 HTML 规范化规则。
+## 预览与创建草稿
 
-- `progress.label` 为“未完成”时：记录稳定错误码，写 `failed --error-code <code>`；
-  只有服务端状态明确为 `FAILED`（证明在外部副作用发生前失败）时，才允许用户明确确认后运行：
+1. 调用 `dxc workflow preview --directory "<项目目录>" --json`。CLI 在内部准备图片、创建云端预览并
+   打开浏览器。
+2. 多个公众号时，只展示名称让用户选择，再用 `--account <ID>` 重新预览；不要猜测账号。
+3. 预览打开后只询问一次：“确认创建草稿，还是返回修改？”
+4. 用户明确确认后调用：
 
-  ```text
-  dxc wechat draft retry \
-    --intent <当前 FAILED intent-id> \
-    --delivery artifacts/08-delivery.md \
-    --confirm \
-    --json
-  ```
+   ```text
+   dxc workflow deliver --directory "<项目目录>" --confirm --json
+   ```
 
-  CLI 会重新从服务端读取原状态，绑定 `previousIntentId`，生成新的幂等键，并把重试次数与谱系
-  写回 delivery。只有服务端还能证明失败发生在任何非幂等图片上传或草稿创建之前时才接受；
-  图片上传或草稿创建已经开始后的 `FAILED`、`CREATED_UNVERIFIED`、
-  `ASSET_UPLOAD_UNVERIFIED`、仍在处理、已成功或“需要人工核对”的意图一律拒绝重试；不得改用
-  新的手写幂等键绕过。新的重试意图如果再次明确 `FAILED`，仍须服务端重新证明安全，并由用户
-  再次确认当前失败意图作为下一条链的来源。
+5. `completed` 时告知草稿已创建；`preview-required` 时重新展示当前预览；`needs-attention` 时说明
+   CLI 返回的问题并停止，不拼装底层命令或再次创建草稿。
 
-正文、标题、模板、渲染器版本、封面或正文图片变化后，原确认失效；必须重新生成预览并确认。
+用户最初提出“放进草稿箱”不能替代查看最终预览后的这一次确认。

package/skills/dxc-wechat-publisher/agents/openai.yaml

@@ -1,6 +1,6 @@
 interface:
   display_name: "DxC 微信草稿交付"
-  short_description: "上传完整图文，默认系统浏览器展示预览，单次确认后创建微信草稿"
-  default_prompt: "使用 $dxc-wechat-publisher 上传当前文章的封面和全部正文图片，默认在系统浏览器实际打开云端预览；只有宿主右侧浏览器能力已验证时才使用右侧预览，在我明确确认一次后创建微信公众号草稿。"
+  short_description: "打开微信公众号最终预览，只确认一次后创建完整图文草稿"
+  default_prompt: "使用 $dxc-wechat-publisher 打开文章预览，并在我确认一次后创建微信公众号草稿。"
 policy:
   allow_implicit_invocation: false