@deployxai/dxc 0.1.5 → 0.1.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deployxai/dxc",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "DeployX 内容工作台 CLI 与官方 Skills",
   "type": "module",
   "bin": {

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

@@ -1,16 +1,19 @@
 ---
 name: dxc-article-outline
-description: DxC 内容工作流的大纲步骤。由 dxc-content-workflow 在 outline 阶段调用，消费已收敛 Brief 和可选研究包，按内容类型与情绪选择结构，并输出带钩子、情绪、金句、数据、案例和配图标记的可解析 Markdown 大纲。
+description: DxC 内容工作流的大纲步骤。由 dxc-content-workflow 在 outline 阶段调用，消费研究包和已收敛 Brief，按内容类型与情绪选择结构，并输出带钩子、情绪、金句、数据、案例和配图标记的可解析 Markdown 大纲。
 ---
 
 # DxC 文章大纲
 
+## 对用户的呈现
+
+用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部调用若找不到 `dxc`，透明改用 `npm exec --yes --package=@deployxai/dxc@0.1.6 -- dxc <参数>`，后续保持同一调用方式；不得让用户打开终端、复制命令或处理环境变量。
+
 本 Skill 只负责 `outline`。大纲是正文和视觉计划共同读取的结构 contract。
 
 ## 进入阶段
 
-1. 运行 `dxc project status --json`，确认 `brief` 已就绪；研究包存在且本次需要证据锚点
-   时一并读取。
+1. 运行 `dxc project status --json`，确认 `research` 和 `brief` 已就绪并一并读取。
 2. 完整读取
    [../dxc-content-workflow/references/stage-contract.md](../dxc-content-workflow/references/stage-contract.md)
    和 [references/outline-methods.md](references/outline-methods.md)。
@@ -18,13 +21,11 @@ description: DxC 内容工作流的大纲步骤。由 dxc-content-workflow 在 o
 
    ```text
    dxc project checkpoint outline --status running \
-     --skill dxc-article-outline --skill-version 0.1.0 \
-     --inputs brief,research \
      --summary "正在选择文章结构并生成可解析大纲" \
      --execution-location agent-hosted --data-transit agent-provider --json
    ```
 
-   未读取研究包时只写 `--inputs brief`。
+   CLI 自动绑定研究包与 Brief，不传 `--inputs`。
 
 ## 生成
 
@@ -42,18 +43,6 @@ description: DxC 内容工作流的大纲步骤。由 dxc-content-workflow 在 o
 
 ```markdown
 ---
-dxc:
-  contract: dxc-content-stage@1
-  workflowId: dxc-article@1
-  projectId: <项目 UUID>
-  stage: outline
-  skill: dxc-article-outline@0.1.0
-  createdAt: <ISO 8601>
-  artifactStatus: complete
-  inputs:
-    - kind: brief
-      path: artifacts/02-brief.md
-      sha256: <Brief 哈希>
 structure: <结构名称>
 primaryEmotion: <主情绪>
 ---

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

@@ -1,22 +1,25 @@
 ---
 name: dxc-article-write
-description: DxC 内容工作流的正文步骤。由 dxc-content-workflow 在 article 阶段调用，消费 Brief、可解析大纲和可选研究包，逐项落实钩子、情绪、金句、数据与案例，生成可直接进入微信公众号渲染的 Markdown 正文，并在最终正文采用前暂停一次。
+description: DxC 内容工作流的正文步骤。由 dxc-content-workflow 在 article 阶段调用，消费研究包、Brief 和可解析大纲，逐项落实钩子、情绪、金句、数据与案例，生成可直接进入微信公众号渲染的 Markdown 正文，并在最终正文采用前暂停一次。
 ---
 
 # DxC 正文写作
 
+## 对用户的呈现
+
+用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部调用若找不到 `dxc`，透明改用 `npm exec --yes --package=@deployxai/dxc@0.1.6 -- dxc <参数>`，后续保持同一调用方式；不得让用户打开终端、复制命令或处理环境变量。
+
 本 Skill 只负责 `article`。正文必须是可发布母稿，不能把内部自检表、提示词或大纲标记
 混进最终正文。
 
 正文同时产生独立的 `artifacts/04-article.golden-lines.json`。它只保存本篇实际采用的金句：
 原句、所在章节与读者价值（认知压缩/情绪共鸣/行动推动/价值宣言）。原句必须逐字出现在正文；
-没有适合做图的金句时写空数组。计算该文件 SHA-256 后，在正文 frontmatter 写入
-`goldenLinesPath` 与 `goldenLinesSha256`；CLI 会校验文件、哈希和正文一致性。
+没有适合做图的金句时写空数组。正文 frontmatter 可以只写 `goldenLinesPath`；CLI 自动创建
+缺失的空 sidecar、计算 `goldenLinesSha256`，并校验文件与正文一致性。
 
 ## 进入阶段
 
-1. 运行 `dxc project status --json`，确认 `brief` 和 `outline` 已就绪；只有实际需要核对
-   证据时才读取可选 `research`。
+1. 运行 `dxc project status --json`，确认 `research`、`brief` 和 `outline` 已就绪并全部读取。
 2. 完整读取
    [../dxc-content-workflow/references/stage-contract.md](../dxc-content-workflow/references/stage-contract.md)
    和 [references/writing-methods.md](references/writing-methods.md)。
@@ -26,12 +29,12 @@ description: DxC 内容工作流的正文步骤。由 dxc-content-workflow 在 a
 
    ```text
    dxc project checkpoint article --status running \
-     --skill dxc-article-write --skill-version 0.1.0 \
-     --inputs brief,outline,research \
      --summary "正在把 Brief 和大纲写成可发布正文" \
      --execution-location agent-hosted --data-transit agent-provider --json
    ```
 
+   CLI 自动绑定研究包、Brief 和大纲，不传 `--inputs`。
+
 ## 写作
 
 - 逐项落实大纲标记，但删除所有 `[钩子]`、`[情绪:]`、`[金句位:]`、`[数据位:]`、
@@ -66,26 +69,10 @@ digest: <正文可兑现的摘要>
 commentsEnabled: true
 dxc_wechat_template_hint: <Agent 建议的云端模板 ID>
 goldenLinesPath: artifacts/04-article.golden-lines.json
-goldenLinesSha256: <金句 sidecar SHA-256>
 tags: [<标签>]
-  dxc:
-  contract: dxc-content-stage@1
-  workflowId: dxc-article@1
-  projectId: <项目 UUID>
-  stage: article
-  skill: dxc-article-write@0.1.0
-  createdAt: <ISO 8601>
-  artifactStatus: awaiting-user
-  inputs:
-    - kind: brief
-      path: artifacts/02-brief.md
-      sha256: <Brief 哈希>
-    - kind: outline
-      path: artifacts/03-outline.md
-      sha256: <大纲哈希>
-  quoteSnapshots:
-    - quoteId: <实际采用的金句 UUID；未采用则为空数组>
-      contentSha256: <采用当时的金句哈希>
+quoteSnapshots:
+  - quoteId: <实际采用的金句 UUID；未采用则为空数组>
+    contentSha256: <采用当时的金句哈希>
 ---
 
 # 工作标题
@@ -107,11 +94,12 @@ tags: [<标签>]
 读取 `dxc profile status --json` 的 `user.confirmationPolicy`。除非它明确为
 `auto-until-delivery`，完成自检后把 checkpoint 写为 `awaiting-user`，`waitingFor` 必须具体：
 “正文已经生成。请确认是否采用这版正文；若作者仍为待确认，请同时给出作者名。”
-用户只做明确确认且正文可见内容未变化时，把 `artifactStatus` 改为 `complete`，再写
-`completed --confirm`。用户提出修改时，先更新正文并重新写一次 `awaiting-user`
+这里的根级 `quoteSnapshots` 是便于 Agent 写入的兼容输入；CLI 会把它迁入
+`dxc.quoteSnapshots`，并生成其余机器元数据。用户只做明确确认且正文可见内容未变化时，
+直接写 `completed --confirm`，CLI 自动把产物状态改为 `complete`。用户提出修改时，先更新正文并重新写一次 `awaiting-user`
 检查点、展示修改后的内容；只有用户确认这个新内容快照后才能完成。不要把一句模糊的
 “继续”解释为正文确认，也不得把修改后的新正文直接绑定到旧确认。
 
 `auto-until-delivery` 时，正文仍须通过相同的事实、作者和发布格式自检，但可直接写
-`artifactStatus: complete` 和 `completed` checkpoint；这不是创建草稿的授权，交付阶段仍须
+`completed` checkpoint；这不是创建草稿的授权，交付阶段仍须
 展示不可变预览并取得明确确认。

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

@@ -5,6 +5,10 @@ description: DxC 内容工作流的 Brief 步骤。由 dxc-content-workflow 在
 
 # DxC 内容 Brief
 
+## 对用户的呈现
+
+用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部调用若找不到 `dxc`，透明改用 `npm exec --yes --package=@deployxai/dxc@0.1.6 -- dxc <参数>`，后续保持同一调用方式；不得让用户打开终端、复制命令或处理环境变量。
+
 本 Skill 只负责 `brief`，把研究结果收敛为下游共同使用的单一命题。
 
 ## 进入阶段
@@ -17,7 +21,6 @@ description: DxC 内容工作流的 Brief 步骤。由 dxc-content-workflow 在
 
    ```text
    dxc project checkpoint brief --status running \
-     --skill dxc-content-brief --skill-version 0.1.0 --inputs research \
      --summary "正在把研究证据收敛为九字段内容 Brief" \
      --execution-location agent-hosted --data-transit agent-provider --json
    ```
@@ -39,18 +42,6 @@ description: DxC 内容工作流的 Brief 步骤。由 dxc-content-workflow 在
 
 ```markdown
 ---
-dxc:
-  contract: dxc-content-stage@1
-  workflowId: dxc-article@1
-  projectId: <项目 UUID>
-  stage: brief
-  skill: dxc-content-brief@0.1.0
-  createdAt: <ISO 8601>
-  artifactStatus: <complete|awaiting-user>
-  inputs:
-    - kind: research
-      path: artifacts/01-research.md
-      sha256: <研究包哈希>
 origin: <hotspot|article|keywords|intent>
 selectedAngle: <已选角度或 null>
 ---
@@ -77,5 +68,5 @@ selectedAngle: <已选角度或 null>
 
 能够唯一收敛时写 `completed` 并立即返回总控。需要用户站队时写 `awaiting-user`，例如：
 “A 侧重反驳行业常识，B 侧重提供中立方法，两者会产生不同文章。请选择 A 或 B。”
-用户明确回答后更新 `selectedAngle`、`artifactStatus` 和选择理由，再写
-`completed --confirm`。不要要求用户确认九个字段的每个细节。
+用户明确回答后更新 `selectedAngle` 和选择理由，再写 `completed --confirm`；CLI 自动更新
+机器状态。不要要求用户确认九个字段的每个细节。

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

@@ -1,29 +1,37 @@
 ---
 name: dxc-content-review
-description: DxC 内容工作流的审校步骤。由 dxc-content-workflow 在 quality-review 阶段调用，消费正文和已选标题，并可核对研究证据与视觉计划，检查事实、待补项、结构、标题承诺、作者、风格和当前微信公众号交付边界；通过时自动继续，只有阻断问题才暂停。
+description: DxC 内容工作流的审校步骤。由 dxc-content-workflow 在 quality-review 阶段调用，消费研究包、正文和已选标题，并可核对视觉计划，检查研究覆盖、事实、待补项、结构、标题承诺、作者、风格和当前微信公众号交付边界；通过时自动继续，只有阻断问题才暂停。
 ---
 
 # DxC 内容审校
 
+## 对用户的呈现
+
+用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部调用若找不到 `dxc`，透明改用 `npm exec --yes --package=@deployxai/dxc@0.1.6 -- dxc <参数>`，后续保持同一调用方式；不得让用户打开终端、复制命令或处理环境变量。
+
 本 Skill 只负责 `quality-review`。它产出可追溯报告，不在审校过程中静默改写已经确认的
 正文。
 
 ## 进入阶段
 
-1. 运行 `dxc project status --json`，确认 `article` 与 `titles` 已完成。
+1. 运行 `dxc project status --json`，确认 `research`、`article` 与 `titles` 已完成。只有受控
+   接管用户已有正文时，`research` 才可以是总控记录的 `skipped`。
 2. 完整读取
    [../dxc-content-workflow/references/stage-contract.md](../dxc-content-workflow/references/stage-contract.md)
    和 [references/review-checklist.md](references/review-checklist.md)。
-3. 研究包和视觉计划就绪且本次需要核对时一并读取。以实际输入写 `running` checkpoint：
+3. 始终读取研究包并核对来源与正文主张；视觉计划就绪时一并读取。以实际输入写 `running`
+   checkpoint：
 
    ```text
    dxc project checkpoint quality-review --status running \
-     --skill dxc-content-review --skill-version 0.3.0 \
-     --inputs research,article,titles,visual-plan \
      --summary "正在核对事实、标题承诺、正文质量和交付边界" \
      --execution-location agent-hosted --data-transit agent-provider --json
    ```
 
+   CLI 自动绑定研究包、正文和标题；本次确实读取视觉计划时才用 `--inputs visual-plan`。
+   受控接管已有正文时，CLI 会识别已跳过的研究阶段，审校报告必须把研究覆盖记为
+   `not-applicable`，不得声称事实已经过研究核验。
+
 ## 审校
 
 - 把问题分为 `blocker`、`warning`、`note`。只有会导致虚构、误导、身份错误、无法渲染或
@@ -45,24 +53,10 @@ description: DxC 内容工作流的审校步骤。由 dxc-content-workflow 在 q
 
 ```markdown
 ---
-dxc:
-  contract: dxc-content-stage@1
-  workflowId: dxc-article@1
-  projectId: <项目 UUID>
-  stage: quality-review
-  skill: dxc-content-review@0.3.0
-  createdAt: <ISO 8601>
-  artifactStatus: <complete|blocked>
-  inputs:
-    - kind: article
-      path: artifacts/04-article.md
-      sha256: <正文哈希>
-    - kind: titles
-      path: artifacts/05-titles.md
-      sha256: <标题哈希>
 verdict: <pass|block>
 blockerCount: <整数>
 warningCount: <整数>
+researchCoverage: <pass|warning|not-applicable>
 ---
 
 # 内容审校
@@ -81,6 +75,8 @@ warningCount: <整数>
 | -------- | ---- | ---- |
 ```
 
+热点研究由用户明确跳过外部观点拆解时，`researchCoverage` 必须是 `warning` 且至少计入一条
+warning；研究完整时为 `pass`，受控接管已有正文且研究已跳过时为 `not-applicable`。
 `verdict: pass` 时直接写 `completed`，返回总控进入交付；不要求用户确认“审校通过”。
 存在 blocker 时写 `awaiting-user`，在 `waitingFor` 中逐项说明需要用户提供来源、作者、
 删除哪条主张或允许怎样修改。解决正文或标题后，其哈希变化会让审校自动失效并重跑。

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

@@ -5,14 +5,19 @@ description: DxC 图文内容工作流的唯一公开入口。用户说“写一
 
 # DxC 内容工作流
 
+## 对用户的呈现
+
+用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部调用若找不到 `dxc`，透明改用 `npm exec --yes --package=@deployxai/dxc@0.1.6 -- dxc <参数>`，后续保持同一调用方式；不得让用户打开终端、复制命令或处理环境变量。
+
 把本 Skill 作为 DxC 唯一公开入口。每次显式或隐式调用都视为一次“恢复并继续”，而不是
 从第一步重新开始。不要要求用户逐个点名下游 Skill，也不要要求用户先安装另一个
 “安装 Skill”。
 
 ## 每次触发先恢复
 
-1. 运行 `dxc version --json`。若 CLI 不存在或协议不兼容，说明所需版本并停止；不得自行
-   执行任意安装脚本。
+1. 运行 `dxc version --json`。若当前环境找不到 `dxc`，不要打断用户，按“对用户的呈现”中的
+   PATH 无关调用方式自动继续。只有固定 npm 包也无法执行时，才用普通语言说明安装暂时未完成并
+   自动保留当前进度；不要展示内部命令或让用户处理环境。
 2. 从用户话语中提取文章标题、项目 ID 或目录提示。用户给出明确目录时直接运行
    `dxc project status --directory <directory> --json`；否则运行：
 
@@ -48,9 +53,9 @@ description: DxC 图文内容工作流的唯一公开入口。用户说“写一
    主赛道、目标读者、内容价值承诺。每次分 2–4 题展示带“推荐”项的选择卡；不要用空白描述题
    让用户从零编写，只有用户主动选择“自定义”才收集一句补充。其余字段默认跳过，并明确告知
    用户之后可以直接说“查看我的画像”“把目标读者改为……”或“补充我的文风”。
-2. 把回答写入当前工作目录内用户可见的 JSON 文件，再运行
-   `dxc profile save --input <file> --json`。不得询问或写入密码、Cookie、Token、
-   AppSecret 等凭据。
+2. 把回答写入仅当前用户可读的临时 JSON 文件，再运行 `dxc profile save --input <file> --json`，
+   成功或失败后都清理该临时文件。除非用户主动要求检查，否则不展示 JSON 和路径。不得询问或
+   写入密码、Cookie、Token、AppSecret 等凭据。
 3. 用户自然语言要求查看画像时，运行 `dxc profile status --json`，按“身份与定位／表达与
    边界／可选偏好／历史资料”列出当前值与尚未设置项。用户明确要求修改某一画像字段时，先运行
    `dxc profile status --json`，只展示该字段的旧值与 reference 中对应候选项；确认后写入局部
@@ -69,10 +74,13 @@ description: DxC 图文内容工作流的唯一公开入口。用户说“写一
    - 稍后导入或跳过：运行普通 `project init`，并展示返回的
      `knowledgeBootstrap.status` 和 `recommendedCommand`；
    - 不扫描主目录、Obsidian、云盘或浏览器。
-6. 仅在进入云端预览或交付时，运行 `dxc setup --no-open`。个人微信登录和公众号管理员授权是两种不同扫码语义，
-   不得混为一谈。读取 CLI 输出的 `DXC_BROWSER_EVENT` 后，必须由当前 Agent 在右侧
-   `agent-side-panel`（右侧内置浏览器区域）自动打开事件中的 URL；不要向用户展示 URL、
-   不要让用户点击链接。若宿主没有内置浏览器，暂停而不是切换到系统浏览器。
+6. 仅在进入云端预览或交付时完成扫码。个人微信登录和公众号管理员授权是两种不同扫码语义，
+   不得混为一谈。浏览器按以下顺序降级，任一级成功后保持 CLI 轮询继续运行：
+   - 只有当前宿主已经证明能实时消费同一运行任务的 `DXC_BROWSER_EVENT` 并打开右侧浏览器时，
+     才运行 `dxc setup --no-open`；如果打开动作失败，终止本次等待并立即改用下一项；
+   - 其他情况直接运行 `dxc setup`，由 CLI 自动打开 Windows 或 macOS 的系统默认浏览器；
+   - 系统浏览器也无法打开时，CLI 会输出短时 URL；只把它呈现为一个“继续扫码”的可点击链接，
+     不展示命令、参数、事件名或其他技术信息，也不把链接写入项目文件。
 
 ## 初始化历史内容记忆
 
@@ -126,8 +134,10 @@ description: DxC 图文内容工作流的唯一公开入口。用户说“写一
 7. `quality-review`
 8. `delivery`
 
-这是线性 MVP，不构造 DAG（有向无环图）或通用工作流引擎。用户明确提供已有文章并要求
-从该产物继续时，可自动把当前路线不需要的前置步骤记录为 `skipped`，同时保存原因。
+这是线性 MVP，不构造 DAG（有向无环图）或通用工作流引擎。CLI 只允许写入当前
+`nextStage`，不能用手工 checkpoint 越过尚未完成或已经 `stale` 的阶段。唯一的阶段接入例外
+是用户明确提供可信 Markdown 正文：总控可在 `article` 接管它，并由 CLI 在同一接管动作中把
+`research`、`brief`、`outline` 记录为 `skipped`；这不是允许从任意阶段任意标记完成。
 
 ## 调用步骤 Skill
 
@@ -141,6 +151,9 @@ description: DxC 图文内容工作流的唯一公开入口。用户说“写一
 - 用户已经提供可信下游产物，且明确要求从该产物继续时，可以把当前路线确实不需要的
   前置步骤记录为 `skipped`；必须在 `metadata.summary` 说明来源和原因，不得冒充对应
   专家 Skill 已运行。
+- 新的主题、热点、事件、参考文章、关键词或创作意图都从 `research` 启动。当前系统不会
+  定时发现热点；`monitor` 也只在用户明确要求时保存本地来源并立即检查一次，不会自行唤醒
+  八步工作流。
 - 不把 SkillHub 中同名或相似的第三方 Skill 冒充官方实现。
 - 需要第三方工具时，先展示来源、固定版本、权限、体积和数据去向；取得同意后由用户或宿主安装。
 - 不允许第三方 Skill 绕过统一产物路径、检查点或用户确认。
@@ -149,10 +162,12 @@ description: DxC 图文内容工作流的唯一公开入口。用户说“写一
   `assets/visuals` 显式采集，把素材哈希纳入云端不可变快照；不得把提示词或图片建议
   冒充已进入草稿。
 
-若用户提供已经完成的 Markdown 正文并要求从正文继续，把正文复制到清单指定的
+若用户提供已经完成的、可读取且可信的 Markdown 正文并要求从正文继续，把正文复制到清单指定的
 `article` 产物路径，按阶段 contract 记录来源和哈希，再用
 `dxc-content-workflow@0.6.0` 写入 `awaiting-user` 检查点，`--inputs` 留空并明确说明
-这是用户提供的既有正文；在用户确认当前正文内容后，再用同一 Skill 和版本写
+这是用户提供的既有正文。CLI 会同时创建 `research`、`brief`、`outline` 三个 `skipped`
+检查点；若这些阶段已经有产物或非 `skipped` 检查点，则拒绝覆盖，避免混合两条路线。
+在用户确认当前正文内容后，再用同一 Skill 和版本写
 `completed --confirm`。CLI 只为这条受控接管路线放宽 `brief + outline` 输入要求，这
 不代表 `dxc-article-write` 已运行。只跳过这条路线确实不需要的前置步骤，后续标题、
 视觉计划、审校和交付仍按 catalog 自动推进。
@@ -162,16 +177,15 @@ description: DxC 图文内容工作流的唯一公开入口。用户说“写一
 ```bash
 dxc project checkpoint <stage> \
   --status running \
-  --skill <dxc-skill-name> \
-  --skill-version <semver-or-unknown> \
-  --inputs <实际读取的上游产物，逗号分隔> \
   --summary "<正在执行的动作>" \
   --execution-location <local-device|agent-hosted|unknown> \
   --data-transit <local-only|agent-provider|dxc-cloud|unknown> \
   --json
 ```
 
-没有输入的第一阶段省略 `--inputs`。CLI 会把阶段 contract 写到 `.dxc/checkpoints/`：
+CLI 从 catalog 自动确定 Skill 和版本，并自动绑定必需输入。只有实际读取了 catalog 中的可选
+输入时才补 `--inputs <可选阶段>`；不要计算或复制路径、哈希。CLI 会把阶段 contract 写到
+`.dxc/checkpoints/`：
 
 - `inputs`：本次实际读取的上游产物路径、大小和哈希；
 - `outputs`：本阶段声明或已经生成的产物；
@@ -185,9 +199,6 @@ dxc project checkpoint <stage> \
 ```bash
 dxc project checkpoint <stage> \
   --status awaiting-user \
-  --skill <dxc-skill-name> \
-  --skill-version <version> \
-  --inputs <实际输入> \
   --summary "<已经完成什么>" \
   --waiting-for "<新会话也能恢复的具体问题>" \
   --execution-location <location> \
@@ -214,10 +225,12 @@ dxc project checkpoint <stage> \
   要改命题时则从 `brief` 重做。不得沿用失效标题、素材或预览快照。
 - 视觉阶段没有图片生成能力且用户未提供可用封面时，给出“启用生成能力／选择本地封面”的具体路径后暂停。
 - 普通研究、可唯一收敛的 Brief、大纲、视觉计划和通过的内部审校完成后自动继续。
+- 热点研究默认拆解外部公开观点并形成支持、反对、补充光谱。若用户明确选择只做事实核验，
+  研究阶段必须暂停一次确认，并把这一缺口传给审校；宿主不能自行替用户跳过。
 - 不把“用户继续”推断为对未知正文、未知公众号或未知渲染快照的确认。
 - `article` 调用 `dxc-article-write@0.1.0`，用户确认正文后才进入标题。
 - `titles` 调用 `dxc-title-write@0.3.0`，保留候选、风险和用户最终选择。
-- `delivery` 必须调用 `dxc-wechat-publisher@0.5.0`，使用正文和视觉阶段已经生产的封面
+- `delivery` 必须调用 `dxc-wechat-publisher@0.6.0`，使用正文和视觉阶段已经生产的封面
   与正文图片完成通用草稿闭环。
 - 多个公众号存在时必须让用户选择。
 - 创建草稿前必须用宿主右侧内置浏览器展示不可变预览快照并取得明确确认；不要在对话里

package/skills/dxc-content-workflow/references/catalog.json

@@ -11,13 +11,14 @@
       "name": "dxc-research",
       "stage": "research",
       "status": "available",
-      "version": "0.1.0",
-      "description": "围绕主题和用户指定来源生成可追溯的本地研究产物。",
+      "version": "0.2.0",
+      "description": "围绕主题和用户指定来源生成结构化、可追溯的本地研究产物；热点默认覆盖外部观点光谱。",
       "execution": "agent-cli",
       "implementationLevel": "agent-local-tools",
       "verificationLevel": "local-integration-tested",
       "knownGaps": [
-        "公开网页研究仍依赖宿主 Agent 的浏览能力，尚无 DxC 统一来源适配器和定时研究 Runner。"
+        "公开网页研究仍依赖宿主 Agent 的浏览能力；DxC 只提供确定性采集原语，尚无定时热点发现 Runner。",
+        "热点研究若退化为只核验事实，必须记录用户明确跳过外部观点拆解；CLI 不判断观点内容质量。"
       ],
       "inputArtifacts": [],
       "optionalInputArtifacts": [],
@@ -49,8 +50,8 @@
       "implementationLevel": "agent-guided",
       "verificationLevel": "contract-tested",
       "knownGaps": ["结构选择和章节内容质量仍由 Agent 负责，CLI 不评价创作优劣。"],
-      "inputArtifacts": ["brief"],
-      "optionalInputArtifacts": ["research"],
+      "inputArtifacts": ["research", "brief"],
+      "optionalInputArtifacts": [],
       "outputArtifacts": ["outline"],
       "requiresHumanConfirmation": false
     },
@@ -64,8 +65,8 @@
       "implementationLevel": "agent-local-tools",
       "verificationLevel": "local-integration-tested",
       "knownGaps": ["正文质量由 Agent 负责；CLI 和渲染器验证格式、引用素材和交付边界。"],
-      "inputArtifacts": ["brief", "outline"],
-      "optionalInputArtifacts": ["research"],
+      "inputArtifacts": ["research", "brief", "outline"],
+      "optionalInputArtifacts": [],
       "outputArtifacts": ["article"],
       "requiresHumanConfirmation": true
     },
@@ -112,8 +113,8 @@
       "implementationLevel": "agent-guided",
       "verificationLevel": "contract-tested",
       "knownGaps": ["事实语义和风格判断由 Agent 负责；CLI 验证结论、计数和输入绑定。"],
-      "inputArtifacts": ["article", "titles"],
-      "optionalInputArtifacts": ["research", "visual-plan"],
+      "inputArtifacts": ["research", "article", "titles"],
+      "optionalInputArtifacts": ["visual-plan"],
       "outputArtifacts": ["quality-review"],
       "requiresHumanConfirmation": false
     },
@@ -121,14 +122,14 @@
       "name": "dxc-wechat-publisher",
       "stage": "delivery",
       "status": "available",
-      "version": "0.5.0",
+      "version": "0.6.0",
       "description": "执行素材上传和权威渲染，在宿主右侧内置浏览器展示预览，确认目标公众号后创建草稿。",
       "execution": "agent-cli-cloud",
       "implementationLevel": "local-cloud-end-to-end",
       "verificationLevel": "real-platform-smoke",
       "knownGaps": ["支付权益、生产部署门禁和异常草稿人工核对流程仍需在生产环境完成专项验证。"],
-      "inputArtifacts": ["article", "titles"],
-      "optionalInputArtifacts": ["visual-plan", "quality-review"],
+      "inputArtifacts": ["article", "titles", "visual-plan", "quality-review"],
+      "optionalInputArtifacts": [],
       "outputArtifacts": ["delivery"],
       "requiresHumanConfirmation": true
     }

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

@@ -1,20 +1,21 @@
 # DxC 阶段产物 contract
 
 每个内容 Skill 都遵守同一份轻量 contract。CLI checkpoint 是机器恢复真值，Markdown
-产物是用户可见真值。CLI 会解析 YAML frontmatter，并按阶段校验必填字段、Skill 版本、
-项目 ID、实际输入路径和哈希；非空占位 Markdown 不能再冒充已完成阶段。
+产物是用户可见真值。Agent 只写阶段特有的语义字段和正文；CLI 统一生成、更新并校验
+`dxc` 机器元数据。非空占位 Markdown 不能冒充已完成阶段。
 
 ## 输入
 
-- 只读取 catalog 声明的必需输入和本次实际使用的可选输入。
-- 开始阶段时把实际输入种类传给 `dxc project checkpoint --inputs`。CLI 自动记录路径、
-  大小和 SHA-256；没有读取的可选输入不要写占位符。
+- catalog 声明的必需输入由 CLI 自动绑定，不传 `--inputs`，也不手抄路径或哈希。
+- 只有本次确实读取了可选输入时，才用 `--inputs` 补充该可选阶段；即使漏写必需阶段，CLI
+  也会自动补齐。交付阶段未显式传参时还会绑定所有已经就绪并实际用于交付的视觉和审校产物。
 - 上游哈希变化后，下游 checkpoint 会变为 `stale`。从最早失效阶段重做，不沿用旧标题、
   旧审校或旧预览。
 
 ## 输出
 
-输出必须写到 `dxc.project.json` 为当前阶段声明的路径，并以以下 YAML frontmatter 开头：
+输出必须写到 `dxc.project.json` 为当前阶段声明的路径。Agent 只写各 Skill 模板列出的阶段
+特有字段；可以完全省略 `dxc`。执行 `project checkpoint` 时，CLI 会原子补成：
 
 ```yaml
 ---
@@ -33,13 +34,17 @@ dxc:
 ---
 ```
 
-第一阶段可用 `inputs: []`。通用元数据统一放在 `dxc` 下，阶段特有字段放在同一个
-frontmatter 中，不覆盖上述字段。
+不要手工填写或修改这段元数据。CLI 从 catalog、项目清单、真实文件和当前时间取得 Skill、
+版本、项目 ID、ISO `Z` 时间、状态、输入路径和 SHA-256；用户确认时也由 CLI 把
+`artifactStatus` 从 `awaiting-user` 切为 `complete`。旧产物里位于根级的 `quoteSnapshots`
+会自动迁移到 `dxc.quoteSnapshots`。标题的正文哈希、视觉素材哈希、交付幂等键和可解析时间
+同样由 CLI 从真实产物或云端响应规范化，不由 Agent 计算。
 正文、来源、候选和报告放在 frontmatter 之后，保持 Markdown 可直接阅读和编辑。
 
 阶段特有字段由各 Skill 的输出模板定义。视觉阶段还会校验真实 PNG/JPEG、素材目录、
-体积和 SHA-256。每个正文都必须有独立金句交接 sidecar（旁车文件），在 frontmatter 中记录
-相对路径与 SHA-256；sidecar 的每条原句必须逐字出现在正文。视觉计划的每张正文配图都必须
+体积和 SHA-256。每个正文都必须有独立金句交接 sidecar（旁车文件）；CLI 会在缺失时创建
+空 sidecar、重算其 SHA-256，并把仅有空白或标点差异的金句归一为正文中的精确文本。真正的
+措辞差异仍会拒绝，避免静默改写正文。视觉计划的每张正文配图都必须
 提供唯一的 `placementAnchor: after-heading:<正文二级标题全文>`，交付 CLI 据此插入，找不到或
 重复匹配即拒绝预览。标题完成时必须存在不超过 32 个 Unicode 字符的最终标题；审校完成时
 必须是零阻断的 `pass`；交付完成时必须存在意图 ID、微信 MediaID 和完成状态。
@@ -52,21 +57,29 @@ frontmatter 中，不覆盖上述字段。
 - `failed`：写稳定错误码和可恢复边界。外部结果不确定时绝不盲目重试。
 - `skipped`：只用于用户已有可信下游产物的路线，并在摘要中说明来源和原因。
 
+checkpoint 必须写入 `project status` 返回的当前 `nextStage`。上游变化使某一步及其下游变为
+`stale` 后，必须从最早失效阶段重新执行；CLI 不接受直接重写更晚阶段来恢复“完成”。唯一例外
+是总控接管用户明确提供的可信 Markdown 正文：CLI 在写 `article` 检查点的同一动作中为
+`research`、`brief`、`outline` 建立 `skipped` 记录，且这些阶段不得已有产物或非跳过记录。
+
 Skill、执行位置、数据去向、输入输出哈希、摘要和等待问题必须同时落到 checkpoint。
 不得把 Cookie、Token、密码、请求头、绝对浏览器 Profile 路径或第三方全文写入元数据。
 
 ## 确认绑定
 
 - 新检查点使用 `checkpointVersion: "3"`。
-- `article`、`titles`、`delivery` 的待确认状态包含 `confirmationBinding`，记录
+- 需要用户确认的阶段包含 `confirmationBinding`，记录
   `snapshotHash`、`snapshotType` 和 `requestedAt`。
 - 用户确认后使用 `--confirm --confirmed-by <稳定身份标识>`；CLI 记录 `confirmedAt`
-  和 `confirmedBy`。没有更强身份来源时可使用 `local-interactive-user`，不得伪造姓名。
+  和 `confirmedBy`，并自动更新产物状态。没有更强身份来源时可使用
+  `local-interactive-user`，不得伪造姓名。
 - 正文绑定排除生命周期元数据后的文章内容哈希；标题绑定候选正文、上游正文哈希和
   已选标题的内容哈希。只改变 `artifactStatus` 不会让确认失效，任何用户可见内容变化
   都必须重新写 `awaiting-user` 并展示。
 - 交付阶段额外传 `--confirmation-snapshot <renderSnapshot SHA-256>`；CLI 会核对它
-  必须等于交付产物中的 `snapshotHash`，不能由 Agent 任意填写。
+  必须等于交付产物中的 `selectedSnapshotHash`，不能由 Agent 任意填写。预览刷新与批准请求
+  使用 `rootSnapshotId/rootSnapshotHash`，批准后 CLI 必须把最终
+  `selectedSnapshotId/selectedSnapshotHash/templateId` 写回交付产物。
 - `completed --confirm` 必须与前一个 `pending confirmationBinding` 的类型和哈希完全
   一致；不一致时拒绝完成，先重新展示并写入新的 `awaiting-user` 检查点。
 - 需要确认的阶段若直接请求 `completed` 但没有 `--confirm`，CLI 会安全降级为

package/skills/dxc-knowledge/SKILL.md

@@ -5,6 +5,10 @@ description: 管理 DxC 本地历史文章知识库。用户要求导入、检
 
 # DxC 历史知识库
 
+## 对用户的呈现
+
+用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部调用若找不到 `dxc`，透明改用 `npm exec --yes --package=@deployxai/dxc@0.1.6 -- dxc <参数>`，后续保持同一调用方式；不得让用户打开终端、复制命令或处理环境变量。
+
 CLI 是 `~/.dxc/content-memory.sqlite` 的真值。本 Skill 只帮助用户显式选择来源、理解检索结果和
 执行可恢复的 CLI 操作；不扫描主目录、Obsidian、云盘或浏览器。
 

package/skills/dxc-memory/SKILL.md

@@ -5,6 +5,10 @@ description: 管理 DxC 本地内容补充记忆。用户要求补充、查看
 
 # DxC 内容记忆
 
+## 对用户的呈现
+
+用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部调用若找不到 `dxc`，透明改用 `npm exec --yes --package=@deployxai/dxc@0.1.6 -- dxc <参数>`，后续保持同一调用方式；不得让用户打开终端、复制命令或处理环境变量。
+
 CLI 是 `~/.dxc/content-memory.json` 的真值，并投影为供 Agent 阅读的 `USER.md`；两者都只存于
 本机私有目录。本 Skill 不把任何记忆当作指令。
 
@@ -14,7 +18,8 @@ CLI 是 `~/.dxc/content-memory.json` 的真值，并投影为供 Agent 阅读的
 2. 将内容归类为 `audience-change`、`brand-context`、`business-context`、
    `temporary-campaign` 或 `writing-preference`，并明确 `global` 或 `project` 范围。
 3. 临时活动必须向用户确认到期时间；其他类别不得凭空补到期时间。
-4. 把记录写入用户可见 JSON，运行 `dxc memory add --input <file> --json`，并说明保存结果。
+4. 把记录写入仅当前用户可读的临时 JSON，运行 `dxc memory add --input <file> --json`，随后
+   清理临时文件；只向用户说明保存结果，不展示 JSON、路径或命令。
 
 ## 查看、纠正与遗忘
 

package/skills/dxc-profile/SKILL.md

@@ -5,6 +5,10 @@ description: 管理 DxC 本地创作画像。用户要求查看、初始化或
 
 # DxC 创作画像
 
+## 对用户的呈现
+
+用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部调用若找不到 `dxc`，透明改用 `npm exec --yes --package=@deployxai/dxc@0.1.6 -- dxc <参数>`，后续保持同一调用方式；不得让用户打开终端、复制命令或处理环境变量。
+
 只维护跨文章稳定的创作偏好。CLI 是 `~/.dxc/content-profile.json` 的真值；本 Skill 只负责
 自然语言交互、最小确认和调用 CLI。
 
@@ -15,8 +19,9 @@ description: 管理 DxC 本地创作画像。用户要求查看、初始化或
 2. 未初始化时，读取
    [../dxc-content-workflow/references/onboarding-questions.md](../dxc-content-workflow/references/onboarding-questions.md)，
    只收集首次必填的五项。按原有候选项分组展示；用户选择自定义时才收集一句补充。
-3. 把答案写入用户可见的临时 JSON，再运行 `dxc profile save --input <file> --json`。不得收集
-   密码、Cookie、Token 或任何平台密钥。
+3. 把答案写入仅当前用户可读的临时 JSON，再运行 `dxc profile save --input <file> --json`，
+   随后清理临时文件。默认不向用户展示 JSON、路径或命令。不得收集密码、Cookie、Token 或
+   任何平台密钥。
 
 ## 局部更新
 

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

@@ -5,6 +5,10 @@ description: 管理 DxC 本地可追溯金句库。用户要求收录、查看
 
 # DxC 金句库
 
+## 对用户的呈现
+
+用户只通过自然语言使用本 Skill。不要向用户展示 npm、CLI、PATH、PowerShell、Shell、JSON、内部命令或临时文件路径；只说明当前结果、需要用户做的选择，以及无法自动打开页面时的可点击临时链接。内部调用若找不到 `dxc`，透明改用 `npm exec --yes --package=@deployxai/dxc@0.1.6 -- dxc <参数>`，后续保持同一调用方式；不得让用户打开终端、复制命令或处理环境变量。
+
 用户可直接维护 `~/Documents/DxC/金句库.md`；CLI 负责确定性 CRUD、同步和索引。每条金句保留
 稳定 ID、原句、来源类型、来源说明、归属、标签、逐字使用边界和状态；索引同步时使用内容哈希判断
 是否需要更新。本 Skill 只负责自然语言交互与调用 CLI。