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…

What is this?dsh-oil-creator is an AI-assisted local content-creation workbench built as a plugin for DeepSeek Harness (DSH). It tracks a video piece — topic, script, recording, subtitles, cover, and publish status — as one local folder, so an AI agent can help move it through each stage.
Is this a standalone app, or does it need something else to run?It's a plugin for DeepSeek Harness (DSH), not a standalone app — it installs into an existing DSH profile and adds a workbench panel and Skill. The core video-library part works alone; Screen Studio, subtitles, cover generation, WeChat articles, and publishing are optional add-ons.
How do I install and start using it?Install it through DSH's built-in plugin manager (e.g. via the npx @deepseek-ai/dsh command) and restart the web profile. Then ask the bundled creator-workbench Skill to find or create a content directory and report what capabilities are missing, and tell the AI the topic for your next piece to start a folder.
What do I need installed before this works?You need Node.js 22.19+ and DeepSeek Harness 0.1.0-rc.6 or rc.7. Optional features add their own requirements: oil-subtitle plus a DASHSCOPE_API_KEY for subtitles, oil-cover plus a ZENMUX_API_KEY for covers, and macOS-only Screen Studio / Ego Lite integrations for recording and publishing.
Which features only work on macOS, and what still needs a human?Screen Studio auto-editing and the Ego Lite plus video-publisher publishing/data-sync loop are macOS-only; recording, timeline editing, final export, and clicking 'publish' on each platform are always left to the human. Subtitles and covers also need separate API keys you have to obtain yourself.
What does the AI actually do at each stage versus what stays manual?The AI can create folders, write topic.md and script.md, bind and open Screen Studio projects, trigger subtitle/cover generation, and prep multi-platform drafts; a human still decides the topic and wording, does the actual recording/editing, checks proper nouns and typos, and clicks publish on each platform.
Which publishing platforms does it support?It targets Xiaohongshu, Douyin, Bilibili, and Shipinhao (WeChat Channels), all enabled by default through the enabledPlatforms setting; turning a platform off excludes it from AI-assisted publishing and data sync.
Why is a video stored as a plain folder instead of a database?So any editor or AI file tool can read the real files directly — the plugin layers workbench state like bindings and sync flags on top in overlay.json instead of copying content into a closed database.
Creator
oil-oil
Size
1 MB
Stars
201
Age
2mo
Commits · 90 Days