dsh-oil-creator README

The project's README from github.com/oil-oil/dsh-oil-creator. As one markdown file: README.md.

dsh-oil-creator：让 AI 和本地内容目录一起工作

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，不会把正文复制一份藏起来。

一条片子如何向前推进

阶段 AI 与插件可以做什么 仍由人确认什么
选题与脚本 新建规范目录，读写 topic.md / script.md，遵守长期脚本规则 选题方向和最终表达
录制与剪辑 绑定并打开 Screen Studio 工程，等待导出文件稳定落盘 录制、时间线剪辑和导出
字幕与封面 启动字幕工作流，打开预览，烧录字幕，生成三种画幅封面 专有名词、标题和错别字
发布 把本地材料交给 video-publisher 准备多平台草稿 各平台最终“发表”按钮
数据回收 通过 Ego Browser 同步已发布作品的播放、赞、评和链接 登录状态和异常匹配结果

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

开始使用

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

如果 pnpm 明确提示安装期构建被阻止，再带 --allow-build 重试；正常安装不需要这一步：

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 工程”“等待成片后生成字幕和封面”或“这条还缺什么”。工作台会根据文件夹里的真实产物推进阶段。

核心能力

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

可选能力

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

能力 可选依赖 说明
字幕转录、排版、预览和烧录 oil-subtitle + DASHSCOPE_API_KEY 首次 clone 后必须运行 bash ~/.agents/skills/oil-subtitle/setup.sh；Key 在百炼控制台申请
三画幅封面 oil-cover + ZENMUX_API_KEY Key 在 ZenMux 申请
Screen Studio 自动剪辑 screen-studio-editor 仅 macOS；录制和导出仍在 Screen Studio 完成
多平台草稿与数据回收 Ego Lite + video-publisher 仅 macOS；需要提前登录各平台创作者后台
公众号图文 oil-video-article 独立工作流，工作台负责展示已有文章

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

配置原则

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

数据与权限边界

卸载

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

dsh-oil-creator (oil-oil/dsh-oil-creator)

Searching Database…

200 ·GitHub
Dsh-oil-creator
这是什么？dsh-oil-creator 是一个 AI 辅助的本地内容创作工作台，以 DeepSeek Harness（DSH）插件的形式构建。它把一条视频作品——选题、脚本、录制、字幕、封面和发布状态——作为同一个本地文件夹来跟踪，让 AI agent 能帮助推进各个阶段。
这是独立应用，还是需要依赖其他东西才能运行？它是 DeepSeek Harness（DSH）的插件，不是独立应用——它安装到已有的 DSH profile 中，添加一个工作台面板和一个 Skill。核心的视频库部分可以独立工作；Screen Studio、字幕、封面生成、微信公众号文章和发布都是可选附加功能。
怎么安装并开始使用？通过 DSH 内置的插件管理器安装（例如用 npx @deepseek-ai/dsh 命令），然后重启 web profile。接着让自带的创作者工作台 Skill 查找或创建内容目录，并汇报缺少哪些能力，再告诉 AI 你下一篇的选题，即可开始一个文件夹。
在它能用之前我需要装好什么？你需要 Node.js 22.19+ 和 DeepSeek Harness 0.1.0-rc.6 或 rc.7。可选功能各有额外要求：字幕需要 oil-subtitle 加 DASHSCOPE_API_KEY，封面需要 oil-cover 加 ZENMUX_API_KEY，录制和发布则依赖仅限 macOS 的 Screen Studio / Ego Lite 集成。
哪些功能只能在 macOS 上用，哪些仍需要人工？Screen Studio 自动剪辑以及 Ego Lite 加视频发布器的发布/数据同步闭环仅限 macOS；录制、时间线剪辑、最终导出和在各平台点击“发布”始终由人工完成。字幕和封面还需要你自行获取的单独 API 密钥。
AI 在各阶段实际做什么，哪些仍靠人工？AI 可以创建文件夹、撰写 topic.md 和 script.md、绑定并打开 Screen Studio 项目、触发字幕/封面生成、准备多平台草稿；而选题和措辞仍由人来定，实际的录制/剪辑、专有名词和错别字检查，以及在各平台点击发布也都由人完成。
它支持哪些发布平台？它面向小红书、抖音、B站和视频号（WeChat Channels），全部通过 enabledPlatforms 设置默认启用；关闭某个平台后，AI 辅助发布和数据同步会把该平台排除在外。
为什么一条视频存储为普通文件夹而不是数据库？这样任何编辑器或 AI 文件工具都能直接读取真实文件——插件把绑定和同步标志等工作台状态叠加在 overlay.json 里，而不是把内容复制进一个封闭的数据库。
What are similar projects?dsh-damage-pulse, dsh-plugin-bridge, dsh-desktop, DSH-Plugins-Marketplace, dsh-web, dsh-tavern, oh-dsh, dsh-lowtide
Which topics is it in?pnpm, subtitles, video-editing, wechat, content-creation, dsh, dsh-plugin, deepseek-harness, workflow, plugin, ai-agent, chinese
Creator
oil-oil
Size
1 MB
Stars
200
Updated
CommitOct 10Releasev0.2.1Oct 10
Age
1mo
Commits · 90 Days