@deployxai/dxc 0.1.0

package/docs/first-user-guide.md

@@ -0,0 +1,187 @@
+# DxC 第一个真实用户指南
+
+更新日期：2026-07-30
+
+这份指南覆盖当前可用的自动闭环：安装 CLI 和九个官方 Skill、个人微信登录或注册、
+绑定公众号、初始化创作偏好、按需导入本地历史文章、从主题或已有 Markdown 正文继续，
+自动完成研究、Brief、大纲、正文、标题、视觉生产和审校，在 Agent 右侧查看云端预览
+并明确确认创建公众号草稿。
+
+视觉步骤会实际调用宿主图片生成能力，或使用用户明确选择的本地 PNG/JPEG；阶段必须
+形成真实内容封面，CLI 不生成占位图。SkillPay、订单和权益尚未接入。
+
+## 1. 安装
+
+要求 Node.js 24。当前仓库可以生成一个可本地安装的 npm 包：
+
+```text
+pnpm install --frozen-lockfile
+pnpm package:cli
+npm install -g .artifacts/deployxai-dxc-0.1.0.tgz
+```
+
+包发布到 npm 后，等价命令才是：
+
+```text
+npm install -g @deployxai/dxc@0.1.0
+```
+
+当前任务没有发布 npm 包，因此不要提前使用第二条命令。安装九个官方 Skill：
+
+```text
+dxc skills install --target workbuddy
+```
+
+Codex 使用：
+
+```text
+dxc skills install --target codex
+```
+
+默认不会覆盖同名目录。只有确认要替换官方副本时才添加 `--force`。检查：
+
+```text
+dxc version --json
+dxc doctor --json
+```
+
+## 2. 首次扫码
+
+云端部署并启用独立网站应用登录后运行：
+
+```text
+dxc setup --server https://content.deployxai.com
+```
+
+全新用户最多看到两次扫码：
+
+1. 个人微信：登录已有 DxC 用户；若从未注册，页面会明确创建新的 DxC 内容空间。
+2. 公众号管理员微信：通过第三方平台授权当前租户管理公众号草稿。
+
+两条链路使用不同 AppID、回调、凭据和身份语义。已有设备会话或已有公众号会被复用。
+完成后检查：
+
+```text
+dxc auth status
+dxc wechat accounts
+```
+
+若列出多个公众号，后续必须明确选择 `accountId`。
+
+## 3. 创作偏好和历史内容
+
+在 WorkBuddy 中直接说“帮我写一篇关于……的公众号文章”或“继续《文章标题》”。宿主
+会隐式触发唯一入口 `dxc-content-workflow`；不需要输入 Skill 名。也可以先检查：
+
+```text
+dxc profile status --json
+dxc knowledge status --json
+```
+
+初始化项目时可以直接导入自己明确选择的 Markdown 或文本历史文章：
+
+```text
+dxc project init --directory <directory> --title "<项目标题>" \
+  --knowledge <article-1.md> <article-2.md> --json
+dxc knowledge import <article-1.md> <article-2.md> --json
+dxc knowledge search "我过去关于现金流的真实案例" --mode hybrid --limit 8 --json
+```
+
+首次语义导入会下载固定哈希的约 24 MB 中文 q8 模型。文章、FTS5 索引和 512 维向量
+只保存在 `~/.dxc`；模型下载请求不包含正文。
+
+`project init` 总会返回知识库文章数和下一条建议。进入研究、Brief、大纲或正文阶段时，
+总控会根据当前任务自动调用本地 hybrid 查询，不需要再说“搜索知识库”。未导入文章时
+会明确询问“现在导入、稍后导入或跳过”，选择继续不会触发目录扫描。
+
+## 4. 准备第一篇文章
+
+初始化项目：
+
+```text
+dxc project init --directory <directory> --title "<项目标题>" --json
+```
+
+新主题路径只需在 Agent 中说明主题、目标读者或参考材料。总控会依次生成
+`01-research.md` 到 `07-quality-review.md`，普通阶段自动继续；只有实质立场分叉、
+最终正文和标题会停下来让你决定。
+
+若已经有正文，也可以把它放到项目清单指定的 `article` 产物，默认是
+`artifacts/04-article.md`。文章使用：
+
+```markdown
+---
+title: 临时标题
+author: DxC
+digest: 这是一段会显示在微信卡片中的摘要
+commentsEnabled: false
+tags: [DxC]
+---
+
+# 正文
+
+这里是文章内容。
+```
+
+当前限制：
+
+- Markdown 不超过 512 KiB；
+- 标题不超过 32 个 Unicode 字符，作者不超过 16 个，摘要不超过 120 个；
+- 本地图片必须是 PNG/JPEG，正文图片单张小于 1 MiB，封面不超过 5 MiB，宽高都不超过
+  12,000 像素；
+- 正文最多 20 张本地图片；CLI 只读取 Markdown 明确引用的文件和显式
+  `--assets-directory`，不递归扫描其他目录；
+- 封面可以显式指定，也可以使用默认 `--cover auto` 从文章声明或素材目录中的
+  `cover.*` 解析。没有真实封面时返回视觉阶段生成或选择，不会生成占位图。
+
+直接说“继续这篇文章”或“把《文章标题》做成公众号草稿”。总控先从当前目录或本地项目
+索引恢复；已有正文会记录来源和哈希，并只跳过这条路线确实不需要的前置步骤。随后自动
+生成标题候选、视觉计划/素材和审校报告，标题选择落入 `artifacts/05-titles.md`，正文
+配图默认放在 `assets/visuals/`。
+
+## 5. 预览和创建草稿
+
+选择目标公众号后创建云端权威预览：
+
+```text
+dxc wechat draft preview \
+  --article artifacts/04-article.md \
+  --assets-directory assets/visuals \
+  --cover auto \
+  --account <account-id> \
+  --title "<已确认标题>"
+```
+
+云端使用所选固定模板渲染，返回短时预览 URL、`snapshotId` 和
+`snapshotHash`，并显示创建时间、到期时间和剩余秒数。Agent 会立即在宿主右侧内置
+浏览器展示页面，不在对话中发送短时 URL。链接过期后重新生成预览，不能
+沿用旧链接确认；Skill 使用
+`dxc wechat draft preview-refresh --snapshot <id> --snapshot-hash <hash>`
+只刷新同一快照的链接，不重新上传正文和图片，并再次在右侧展示。核对公众号、标题、
+预检、配图和预览后，在 Agent
+中明确说：
+
+> 确认这个快照创建到这个公众号的草稿箱。
+
+Skill 才会用已经落盘的幂等键执行
+`dxc wechat draft create --snapshot <snapshot-id> ... --confirm`，并用
+`dxc wechat draft status <intent-id>` 查询进展。用户只会看到中文进度、说明和下一步，
+不会看到内部英文状态或 Worker 信息；标题、作者、摘要和最终正文全部核对一致才算完成。
+阶段 checkpoint 同时记录本次确认绑定的快照哈希、确认者和时间。
+
+若进度提示“需要人工核对”，不要换幂等键重试；先去公众号后台人工核对。DxC
+不调用正式发布或群发 API。
+
+## 6. 生产运行前置
+
+扫码、云端预览和真实草稿需要：
+
+- Server 和 Worker 运行本提交构建产物；
+- Server 与 Worker 连接同一独立 `dxc` Mongo 数据库；
+- 两者连接同一私有 S3 兼容对象存储；
+- Server 注入网站登录和第三方平台安全配置；
+- Worker 注入公众号 API 安全材料和首位用户的 `tenantId`；
+- `content.deployxai.com` 的既有固定登录、授权、回调和预览路由指向 Server。
+
+每次生产发布都必须固定 Git 提交和构建产物哈希，并在部署后核验 Server、Worker 和公网
+健康检查。

package/docs/history/content-forge-prd-v0.2-summary.md

@@ -0,0 +1,81 @@
+# 《博主内容生产系统》v0.2 历史摘要
+
+来源文件：`博主内容生产系统_PRD.md`
+来源时间：2026-07-24
+本地核验时间：2026-07-25
+公开分享链接：
+
+`https://codebuddy.work/agents/share/AQJrGsUAQfUN57uxVO778ti7XTtpnP1YRgPw4hbdye8zA6Q9DsetIb2qAW-HDAy-?platform=workbuddy`
+
+## 历史定位
+
+原文将产品称为 Content Forge for Bloggers，目标是为个人博主、内容工作室和 MCN 提供多平台、多人设、可配置的内容生产流水线。
+
+两类发起方式：
+
+1. 自动追踪热点；
+2. 博主主动提供参考文章、关键词或写作意图。
+
+两类输入最终归一为 `Brief`（需求命题卡），再进入调研、观点、大纲、正文、标题/视觉和发布准备。
+
+## 原始角色地图
+
+| 原始角色 | 主要产物 | 当前映射 |
+|---|---|---|
+| Topic Scout | 热点选题候选 | 未来 `dxc-topic-scout` |
+| Research Analyst | Brief、资料和观点 | 未来 `dxc-research` |
+| Outline Architect | 文章大纲 | 未来 `dxc-writing-framework` |
+| Content Writer | Markdown 正文 | 未来 `dxc-style-writer` |
+| Title & Visual Designer | 标题、封面和插图 | 未来 `dxc-visual-designer` |
+| Publisher | 平台草稿 | 当前 `dxc-wechat-publisher` |
+
+原文的有效原则被保留：
+
+- 不同上游归一为稳定中间契约；
+- 每个关键产物有人工确认；
+- 中间产物可落盘、可追溯；
+- 外部失败有状态和重试；
+- 自动化不应跳过作者的最终控制。
+
+## 原始配置地图
+
+原文定义了：
+
+- Blogger Profile：博主、笔名、赛道和更新频率；
+- Niche Config：关键词、选题偏好和黑名单；
+- Style Config：语气、人称、段落、口头禅和情绪；
+- Value Config：价值观、立场、红线和读者承诺；
+- Data Source Config：热点和研究来源；
+- Structure Config：文章结构、字数、案例和金句；
+- Title & Visual Config：标题和视觉偏好；
+- Platform Config：平台发布参数；
+- Workflow Config：确认、通知、超时和重试；
+- Memory Config：历史文章、反馈、爆款和失败案例。
+
+终态仍需要这些能力，但它们应优先保存为用户可见的 profile/Skill 文件或明确的云端领域对象，不应一次性做成庞大配置后台。
+
+## 被当前决策覆盖的内容
+
+以下内容只保留历史意义：
+
+- 原文把热点、调研、大纲和写作放进早期 MVP；当前 MVP 从已有文章开始。
+- 原文以多平台为目标；当前阶段只做微信公众号。
+- 原文 `Platform Config` 中包含公众号 AppID 凭证；当前产品强制使用微信第三方平台授权，客户不提交 AppID/AppSecret。
+- 原文把标题和配图放在第一/二期；当前 MVP 只接收和检查用户提供的标题、封面和图片，自动生成后置。
+- 原文未定义 Agent Native 安装、CLI、SkillPay 和云端权威渲染；这些已成为当前架构核心。
+
+## 与当前路线的关系
+
+当前从原始角色 F（Publisher）开始建立可靠主干：
+
+```text
+ArticleSource
+  → RenderSnapshot
+  → Approval
+  → DraftIntent
+  → DraftDelivery
+```
+
+未来 A-E 类能力以 `dxc-*` Skills 从上游接入并产出/修改 `ArticleSource`，不重写发布、授权、支付和审计主干。
+
+原始 PRD 全文继续由上方公开分享链接保存。本仓库保留经过范围校正的摘要，避免把历史假设误当成当前真值。