dsh-oil-creator

[!NOTE] 当前开发目标为 Node.js 22.19+、DSH Desktop 0.11.0 内置的 Harness 0.2.0-rc.2；需要 Desktop 的 desktopWorkbenches 服务，不适用于独立 Harness Web。核心片库可独立使用；Screen Studio、字幕、封面、公众号和发布能力均可按需安装。

一条片子，就是一个文件夹

插件不建立封闭的内容数据库。正文和产物仍是普通文件，任何编辑器和 AI 文件工具都能读取：

~/Movies/视频项目/
└── 2026-08-19_DeepSeek Harness 上手/
    ├── topic.md
    ├── script.md
    ├── DeepSeek Harness 上手.mp4
    ├── DeepSeek Harness 上手.srt
    ├── DeepSeek Harness 上手_subtitled.mp4
    ├── DeepSeek Harness 上手_3x4.png
    ├── DeepSeek Harness 上手_4x3.png
    ├── DeepSeek Harness 上手_16x9.png
    ├── visual-review.json
    ├── visual-review.md
    ├── publish-package.json
    └── 公众号文章/

插件只把工程绑定、手写发布标记、同步到的播放数据和生成任务等工作台状态存进 ~/.dsh-oil-creator/overlay.json，不会把正文复制一份藏起来。

一条片子如何向前推进

工作台不会假装替人完成录制、剪辑或最终发布。它负责把每一步需要的文件、状态和下一步动作放在同一个上下文里。

开始使用

1. 安装插件

先从本地源码构建可安装包：

pnpm install --frozen-lockfile --ignore-scripts
pnpm check
pnpm pack

在当前 Desktop 的「工作台管理／已安装的工作台」核对本地 .tgz 安装入口，或用该 Desktop 配套的 dsh plugin add --help 核对支持的输入与参数。只使用明确支持本地包的入口安装生成的 dsh-oil-creator-0.2.0.tgz；重启 Harness 后从工作台管理添加并打开「内容工作台」。不要使用另一个版本的全局 CLI 推断 Desktop 支持情况。

已完成类型检查、构建和 251 项测试，预构建包已安装到 macOS arm64 的 Desktop 0.11.0 并打开内容工作台。市场投稿的最终安装来源与逐项验证记录见 迁移验收记录。独立 Harness Web 和其他平台未验证。

2. 让 AI 完成首次配置

推荐选择 Harness 的 standard 或 code Agent preset，然后直接说：

检查并配置内容工作台，找到适合的内容目录，并告诉我还缺哪些能力。

内置 creator-workbench Skill 会先调用只读的 oil_creator_setup：

1. 寻找已有的内容目录。
2. 检查 Screen Studio、字幕、封面和 Ego Browser 等可选能力。
3. 只报告凭据是否已配置，不把 API Key 读回对话。
4. 先预览配置变化，得到确认后才保存。

首次保存文件前，在工作台的系统目录选择器中选择资料目录；需要新建目录时也在系统选择器中明确操作。取消选择会保留标题和原业务选择。minimal preset 不包含 Skill 和文件工具，不适合首次配置或自动整理目录。

3. 做第一条内容

从工作台新建内容会先选择资料位置，不要求已有会话。选中一期后点击「打开内容会话」，在选择器中确认这一期的目录，由 Desktop 创建或恢复属于内容工作台的原生会话；不会自动发送消息。

可以直接对 AI 说：

今天做一期 DeepSeek Harness 安装上手。新建内容目录，把选题写进笔记，再给我一个脚本初稿。

随后继续说“绑定刚才的 Screen Studio 工程”“等待成片后生成字幕和封面”或“这条还缺什么”。工作台会根据文件夹里的真实产物推进阶段。

核心能力

• 本地片库：按 日期_可读标题 扫描目录，展示阶段、成片、字幕、封面、文章和发布状态。
• 对话上下文：在属于本工作台的会话里，通过 @当前详情、内容搜索或 /current content 把目标文件夹交给 AI。
• AI 自举配置：自动发现标准安装路径，缺少能力时给出明确安装方式，写入前必须预览和确认。
• 长期脚本规则：保存语气、结构、禁忌和目标观众，之后写或修改 script.md 时复用。
• 原生长任务：字幕、封面、烧录和导出等待都返回 Harness job id，可统一查看、等待、取消并接收完成通知。
• 多模态封面审查：把三画幅封面作为 Harness 附件交给模型检查，并把结构化结论保存为 visual-review.json / .md。
• 目录整理：预览并修正旧文件夹名称；默认不执行、不删除文件。
• 可选发布闭环：准备平台草稿后由人最终发表，再同步播放、点赞、评论和作品链接。

完整工具列表和逐步示例见 使用说明。

可选能力

核心片库和脚本管理不依赖下表中的外部工具。缺少某项时，只关闭对应环节。

字幕和封面 Skill 留空时，插件会依次从 ~/.claude/skills、~/.codex/skills、~/.agents/skills 自动发现；只有非标准安装位置才需要填写高级路径。

配置原则

设置入口位于 内容工作台顶部 → 设置。设置页只保留需要人决定的信息，例如内容目录、脚本规则和可选能力凭据；可以通过系统检查发现的路径不重复暴露。

• API Key 使用 Harness 官方凭据服务保存。页面只显示“已配置 / 未配置”，不会回显明文。
• 内容目录可以换成任意已有的绝对路径，每个直接子文件夹代表一条内容。
• enabledPlatforms 默认全开，包含小红书、抖音、B 站和视频号。关闭的平台不会参与 AI 发布或数据同步；全部关闭时不执行这两项操作。
• 脚本规则既可以在设置页修改，也可以让 AI 通过 oil_script_rules 记录和更新。
• Cordis 高级配置仍保留 libraryRoot、dataDir、subtitleSkillDir 和 coverSkillDir，用于自动发现无法覆盖的特殊环境。

数据与权限边界

• 正文、视频、字幕、封面和文章保存在用户选择的本地目录。
• 插件不会自动上传内容；上传只在用户明确调用发布 Skill 后发生，并停在最终发表前。
• 字幕、封面和平台同步会访问各自的外部服务；不安装、不配置就不会启用。
• 目录创建、配置保存和批量重命名都遵循“先预览、再确认、后执行”。

卸载与旧版迁移

通过当前 Desktop 的插件管理入口卸载，再重启 Harness。内容目录、overlay 状态和已有会话不随插件删除。

新版 bundle patch 只插入本包；公共侧栏、工作台切换和原生聊天由 Desktop 管理。旧版如果在用户 profile 中额外手写过 ui-sidebar: disabled，升级时应检查并移除那项历史覆盖；不要把本项目的 patch 复制到用户配置。

开发与验证

pnpm install --frozen-lockfile
pnpm check

pnpm check 会依次运行 TypeScript 检查、Host / Client 构建和 Vitest 测试。欢迎提交 Issue 或 Pull Request；涉及文件格式、配置兼容或外部能力时，请同时补充对应测试和文档。

准备推送开源提交或创建 GitHub tag 前运行 pnpm release:check。它会先拒绝脏工作树、未跟踪的关键文件或缺失的 origin，再验证测试、构建和 GitHub 安装包内容；不会发布到 npm。

文档

• 日常使用与完整工具说明
• 内容文件夹约定
• 插件实现与兼容性说明

使用问题

安装或使用过程中遇到问题，可以到 oiloil.org 联系我。代码缺陷和功能建议仍然欢迎提交 Issue。

License

MIT