dsh-oil-creator

DeepSeek Harness 上的本地内容工作台。
从选题、脚本、录屏工程到字幕、封面和发布状态，一条片子始终对应一个本地文件夹。

[!NOTE] 当前兼容 Node.js 22.19+、DeepSeek Harness 0.1.0-rc.6 / 0.1.0-rc.7。核心片库可独立使用；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
    ├── publish-package.json
    └── 公众号文章/

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

一条片子如何向前推进

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

开始使用

1. 安装插件

使用 DeepSeek Harness 自带的插件管理命令：

npx @deepseek-ai/dsh plugin --profile web add github:oil-oil/dsh-oil-creator

重启 web profile 后即可使用。插件会登记到配置里，不需要手改 Harness 配置。已经全局安装 dsh 时，可以去掉命令里的 npx @deepseek-ai/dsh。

Harness 从 GitHub 安装时生成的构建包包含 README 引用的最终 assets/readme/hero.svg，不会包含 assets/readme/source/ 下的源素材。

git clone https://github.com/oil-oil/dsh-oil-creator.git
cd dsh-oil-creator
pnpm install --frozen-lockfile
pnpm build
npx @deepseek-ai/dsh plugin --profile web add "$PWD"
npx @deepseek-ai/dsh web

npx @deepseek-ai/dsh plugin --profile web add --allow-build=dsh-oil-creator github:oil-oil/dsh-oil-creator

2. 让 AI 完成首次配置

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

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

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

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

候选目录不存在时，AI 会先展示准备创建的完整路径；确认创建后再重新预览配置。minimal preset 不包含 Skill 和文件工具，不适合首次配置或自动整理目录。

3. 做第一条内容

可以直接对 AI 说：

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

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

核心能力

• 本地片库：按 日期_可读标题 扫描目录，展示阶段、成片、字幕、封面、文章和发布状态。
• 对话上下文：通过 @当前详情、内容搜索或 /current content 把目标文件夹交给 AI。
• AI 自举配置：自动发现标准安装路径，缺少能力时给出明确安装方式，写入前必须预览和确认。
• 长期脚本规则：保存语气、结构、禁忌和目标观众，之后写或修改 script.md 时复用。
• 长任务追踪：字幕、封面和烧录启动后立即返回，由工作台继续观察文件产物和任务状态。
• 目录整理：预览并修正旧文件夹名称；默认不执行、不删除文件。
• 可选发布闭环：准备平台草稿后由人最终发表，再同步播放、点赞、评论和作品链接。

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

可选能力

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

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

配置原则

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

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

数据与权限边界

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

卸载

npx @deepseek-ai/dsh plugin --profile web remove dsh-oil-creator

安装、卸载或更新配置后重启 dsh web。不要手动修改 ~/.dsh/profiles/web/package.json，也不要把项目的 cordis.patch.yml 复制到用户 profile；插件自己的 bundle patch 会负责装配和清理侧栏。

如果旧版本曾在 profile 的 cordis.patch.yml 里手动加入以下内容，迁移后应删除，避免卸载插件后官方侧栏仍被关闭：

- id: ui-sidebar
  disabled: true

开发与验证

pnpm install --frozen-lockfile
pnpm check

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

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

文档

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

使用问题

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

License

MIT