D DeployX AI行远序章 原始 Markdown

DxC 0.3.19 · Installation contract

同一份安装说明，给人阅读，也给 Agent 执行。

页面内容直接由公开 Markdown 渲染。宿主 Agent 应读取原始文件，并把 DxC 安装到自身真正识别的一等 Skill 目录。

打开原始 Markdown 返回产品介绍 查看 npm ↗

安装 DxC

本文的公开固定地址为 https://deployxai.com/dxc/install.md。宿主 Agent 应读取原始 Markdown， 不从功能介绍页猜测命令或安装目录。

DxC 可安装到 WorkBuddy、Codex，以及采用 Agent Skills 格式的其他本机 Agent。正在执行安装的宿主 必须先识别自己的一等用户级 Skill 目录，再选择下面对应的命令。不得把 ~/.agents/skills/ 当作所有宿主的默认目录，也不得通过扫描主目录猜测宿主。

安装拓扑只有一种：dxc CLI 安装到当前用户本机的 npm 标准全局可执行位置；14 个官方 Skill 安装到当前宿主 Agent 实际读取的一等用户级 Skill 目录。Skill 不携带、下载或临时解析另一份 CLI； 任何 Skill 执行 DxC 动作时，都只调用 PATH 上已经完成版本核验的本机 dxc。

安装命令没有默认 target。没有提供 --target 或 --directory 时会拒绝执行，避免出现文件已经 写入、宿主却无法发现的假成功。安装只写入选定的 Skill 目录，不会自动登录微信、扫描文章、上传 内容或创建草稿。

宿主 Agent 按以下顺序执行：

  1. 从自身运行时或官方文档确定一等用户级 Skill 目录，不询问用户猜一个目录；
  2. 从 npmjs 精确回读指定版本，再把该版本 CLI 一次性安装到 npm 的标准全局位置；
  3. 用 where dxc 或 command -v dxc 确认全局入口已进入 PATH，并核对 dxc version --json；
  4. 只执行一个对应的 --target，或只执行一个 --directory，两者不得同时提供；
  5. 检查 Skill 安装 JSON 的 cliVersion、skillSetVersion 相同，并有 14 个 installed/skipped 项；
  6. 用同一个 dxc doctor 核验指定 Skill 目录，再重新加载 Skill 索引；
  7. 按宿主原生调用方式发起一次 DxC 任务，再继续微信登录和公众号绑定。

当前固定版本为 0.3.24。只有 npmjs 已返回该精确版本时，才能执行线上安装：

npm view @deployxai/dxc@0.3.24 version --registry=https://registry.npmjs.org/

安装只允许访问上面的官方 registry（注册表）。DNS、下载、完整性或全局安装失败时停止，不循环 重试、不换版本，也不改用仓库源码或过期缓存冒充已发布包。全局安装完成后，正常 Skill 任务只调用 PATH 中的 dxc，不再使用 npm、npx 或其他包执行器联网解析。

需要 Node.js 22.16 及后续 22.x，或 Node.js 24 及以上版本。Windows 使用 npm.cmd install --global 和 where dxc；macOS/Linux 使用 npm install --global 和 command -v dxc。如果入口不在 PATH， 先用 npm prefix --global 确认 npm 的标准全局位置并修正当前用户 PATH，重新打开终端后再核验； 不得硬编码某个用户的绝对路径。

宿主能力核验日期：2026-08-21。Codex 的当前内置安装器把用户 Skill 安装到 $CODEX_HOME/skills（默认 ~/.codex/skills/）， 并使用 $<skill-name> 显式调用；WorkBuddy 当前通过 / 唤起 Skill 列表。这些调用方式属于宿主能力， 不是 Agent Skills 文件格式的一部分，后续变化时应重新核验。

WorkBuddy

WorkBuddy 的一等用户级目录是 ~/.workbuddy/skills/，并且已经验证可以实时消费 DxC 浏览器事件。 在 Windows 中执行：

npm.cmd install --global --registry=https://registry.npmjs.org/ @deployxai/dxc@0.3.24
where dxc
dxc version --json
dxc skills install --target workbuddy --force --json
dxc doctor --target workbuddy --json
dxc setup --no-open

macOS/Linux 把第一行改为 npm install --global ...，把第二行改为 command -v dxc。setup --no-open 会输出 DXC_BROWSER_EVENT；WorkBuddy 应在侧边栏内置浏览器依次打开个人微信登录和公众号绑定页面，并让 当前 CLI 继续等待扫码结果。安装后刷新 Skill 列表；可输入 / 打开列表并选择 dxc-content-workflow，也可直接用自然语言描述任务。

Codex

Codex 的一等用户级目录是 ~/.codex/skills/：

npm install --global --registry=https://registry.npmjs.org/ @deployxai/dxc@0.3.24
command -v dxc
dxc version --json
dxc skills install --target codex --force --json
dxc doctor --target codex --json
dxc setup

Windows 使用 npm.cmd install --global ... 和 where dxc。直接执行上述 setup 时由 CLI 打开系统浏览器； 通过宿主 Skill 执行时，当前 Codex 已验证能实时消费 DXC_BROWSER_EVENT 才改用 setup --no-open。 安装后新建任务或 重新加载 Skill；显式调用使用 $dxc-content-workflow，也可直接用自然语言描述任务。不要把 /dxc-content-workflow 是否出现在命令菜单作为 Skill 是否安装成功的判断依据。

其他兼容 Agent

宿主只有在自身运行时或官方文档明确说明 ~/.agents/skills/ 是一等用户级 Skill 目录时，才使用：

npm install --global --registry=https://registry.npmjs.org/ @deployxai/dxc@0.3.24
command -v dxc
dxc version --json
dxc skills install --target agents --force --json
dxc doctor --target agents --json
dxc setup

否则，宿主先确定自己实际读取的用户级 Skill 目录，再显式安装：

npm install --global --registry=https://registry.npmjs.org/ @deployxai/dxc@0.3.24
command -v dxc
dxc version --json
dxc skills install --directory <宿主的用户级 Skill 目录> --force --json
dxc doctor --directory <宿主的用户级 Skill 目录> --json

安装完成后，宿主必须重新加载或新建任务，确认能发现 dxc-content-workflow，并按自己的原生方式 调用一次。目录中存在文件只证明安装器完成了本地写入，不证明宿主已经识别 Skill。

不要让 DxC 猜测宿主名称或扫描主目录。云端或沙箱宿主无法读取本机目录时，需要由宿主自己的上传、 配置仓库或插件机制提供 Skill；本地安装命令不能替代该宿主的注册流程。

浏览器交接

微信登录、公众号绑定和最终预览采用同一顺序：

  1. 当前宿主已验证能实时处理浏览器事件时，使用侧边栏内置浏览器；
  2. 否则由 CLI 打开系统默认浏览器；
  3. 系统调用失败时，只向用户提供一个可点击的短时链接。

最终预览默认由 CLI 先请求宿主侧边栏；未登记成功时自动打开系统浏览器，系统调用失败时才返回一个 短时链接。Skill 不拼装降级状态机。--browser system 只作为显式跳过侧边栏的覆盖项。降级始终 复用同一不可变快照，不产生新的内容确认。链接不得写入项目、普通日志或长期记忆。

安全边界

  • 个人微信登录与公众号管理员授权是两次不同的扫码操作；
  • 不要求提交公众号 AppID 或 AppSecret；
  • 多个公众号必须由用户选择；
  • 创建草稿前必须查看最终预览并明确确认；
  • DxC 只创建草稿，不正式发布、不群发；
  • 草稿结果无法确认时保持未完成，不盲目重试。

更新记录

0.3.24 · 2026-09-08

  • 大纲与正文 Skill 改为简短创作指导、按需方法参考和成品语义评估；不要求套固定结构、逐段动作或手法组合。
  • 正文继续以材料、阅读目的、前后关系与事实支撑核对成稿，保留作者声音与实际表达选择。

0.3.23 · 2026-09-07

  • 记忆、画像和知识库的必守作者上下文完整交接给创作与独立审校；旧快照仍须由用户明确刷新。
  • 安装后的官方 Skill 现会完整传递 CLI 返回的参数与受控选择，避免宿主猜测内部引用。
  • 最终标题会一致应用到公众号预览及封面依赖，容量超限预览可安全切换模板恢复。
  • 继续保持最终预览确认、幂等草稿与未知结果保守停止边界。

0.3.17 · 2026-09-02

  • 启用“长期学习”后，DxC 会记录最小作者信号；未启用时不落盘，信号在用户确认前不影响写作。
  • 新项目创建时固定读取创作画像、有效长期记忆和相关历史知识；进行中的项目只有明确刷新后才重新采用全局资料。
  • 质量审校通过且正文未变化时，完成稿会幂等进入本地历史文章资料库；索引未就绪会明确标记待修复。
  • 长期记忆迁移到与历史知识共用的本地 SQLite、FTS5 和向量检索基础设施；旧 JSON 数据会原子迁移并保留备份。
  • 金句作为“表达建议”类记忆的兼容视图，继续保留来源归属与逐字使用边界。
  • 去 AI 味校准增强，能识别同义的纠偏、顿悟、否定和对称模板，在保留事实与判断后直接表达。

0.3.16 · 2026-08-31

  • WorkBuddy 推进工作流时，不再因 CLI 的正常写入和并发保护触发“批量删除”确认；宿主无需理解或处理内部文件。
  • 微信作者署名统一按公众号后台展示宽度校验：最多 8 个汉字宽度，半角英文按半个汉字计算。
  • 微信明确拒绝创建草稿且确认未产生草稿时，会给出修改署名并重新预览的安全动作；结果不确定时仍然保守停止。
  • 正文新增独立的去 AI 味审核门；正文变化后旧结论自动失效，必须重新完整复核。
  • 正文章节引用保持稳定，视觉资产统一交付 PNG，并在内容未变化时安全复用已有图片。

0.3.15 · 2026-08-30

  • 工作流被其他进程占用时返回稳定、可理解的忙碌状态，减少宿主误判和无效重试。