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…

Что это?dsh-oil-creator — локальная рабочая среда создания контента с помощью ИИ, построенная как плагин для DeepSeek Harness (DSH). Она ведёт видеоконтент — тему, сценарий, запись, субтитры, обложку и статус публикации — как одну локальную папку, чтобы ИИ-агент помогал продвигать его через каждый этап.
Это отдельное приложение или ему нужно что-то ещё для работы?Это плагин для DeepSeek Harness (DSH), а не отдельное приложение — он устанавливается в существующий DSH-профиль и добавляет панель рабочей среды и Skill. Основная часть с видеобиблиотекой работает сама по себе; Screen Studio, субтитры, генерация обложек, статьи WeChat и публикация — необязательные дополнения.
Как установить и начать пользоваться?Установите его через встроенный менеджер плагинов DSH (например, командой npx @deepseek-ai/dsh) и перезапустите web-профиль. Затем попросите встроенный creator-workbench Skill найти или создать каталог контента и сообщить, каких возможностей не хватает, и назовите ИИ тему следующего материала, чтобы завести папку.
Что должно быть установлено, чтобы это заработало?Нужны Node.js 22.19+ и DeepSeek Harness 0.1.0-rc.6 или rc.7. Необязательные функции добавляют свои требования: oil-subtitle плюс DASHSCOPE_API_KEY для субтитров, oil-cover плюс ZENMUX_API_KEY для обложек, а также интеграции Screen Studio / Ego Lite только для macOS — для записи и публикации.
Какие функции работают только на macOS и что всё ещё требует человека?Автомонтаж Screen Studio и цикл публикации и синхронизации данных Ego Lite плюс video-publisher работают только на macOS; запись, монтаж на таймлайне, финальный экспорт и нажатие «опубликовать» на каждой платформе всегда остаются за человеком. Субтитрам и обложкам также нужны отдельные API-ключи, которые вы должны получить сами.
Что ИИ реально делает на каждом этапе, а что остаётся ручным?ИИ может создавать папки, писать topic.md и script.md, привязывать и открывать проекты Screen Studio, запускать генерацию субтитров и обложек и готовить черновики для нескольких платформ; человек по-прежнему решает тему и формулировки, делает саму запись и монтаж, проверяет имена собственные и опечатки и нажимает «опубликовать» на каждой платформе.
Какие платформы публикации он поддерживает?Он нацелен на Xiaohongshu, Douyin, Bilibili и Shipinhao (WeChat Channels), все включены по умолчанию через настройку enabledPlatforms; выключение платформы исключает её из публикации с помощью ИИ и синхронизации данных.
Почему видео хранится как обычная папка, а не в базе данных?Чтобы любой редактор или ИИ-инструмент для файлов мог читать настоящие файлы напрямую — плагин накладывает состояние рабочей среды вроде привязок и флагов синхронизации поверх в overlay.json, вместо копирования контента в закрытую базу данных.
Creator
oil-oil
Size
1 MB
Stars
200
Age
1mo
Commits · 90 Days