oh-story-dsh README

The project's README from github.com/zenstory-ai/oh-story-dsh. As one markdown file: README.md.

oh-story-dsh

小说、短剧、互动游戏与视频解说创作工作台

DeepSeek Harness · Oh Story · Drama Skills · NovelToGame · video-recap-skills · MIT

oh-story-dsh 是基于 DeepSeek Harness(DSH)构建的社区插件,把小说、短剧、互动游戏与视频解说四条创作流水线带进 DSH。DSH 管理 Agent、会话、模型、权限和 Chat;插件提供创作 Skills、专业 Roles、项目协议与对应工作台。

本项目与 DeepSeek 官方无隶属、合作或背书关系;DeepSeek Harness 名称与品牌素材归其权利人所有。

小说工作台

小说工作台

文件树、编辑器、Chat 三栏。覆盖长篇、短篇、选题、扫榜、拆文、导入、审稿、去 AI 味与封面流程,13 个 Oh Story Skills 与 7 个专业 Roles 按固定上游版本随插件交付。

短剧工作台

短剧工作台

每集按请求维护最多五份可读 Markdown:剧本.md、视觉设定.md、分镜.md、图片提示词.md、视频提示词.md。「生产」视图把这些文档投影为镜头板、素材板、任务/版本、成片顺序和关系画布,并就地提示重复 ID、悬空引用与格式错误。生产交付走 DSH 原生会话、当前 Preset 工具与权限确认。

游戏工作台

游戏工作台

左侧实时试玩、右侧 DSH Chat 的两列布局。/novel-to-game quick 的生成物写入 game-adaptations/<project>/,build/app/index.html 就绪后自动进入项目列表,可刷新、全屏、切换项目。内置《金瓶梅 · 风月总账》完整可玩构建,开箱即可验证输入、核心循环、结局与重开。

视频工作台

视频工作台

同样是预览左、Chat 右。项目放在 video-recaps/<project>/:原片在 sources/,上游工作产物在 work/,交付在 outputs/。工作台提供原片/剪后片/成片切换、阶段提示、运行清单与质检产物查看,视频经 HTTP Range 流式预览。在 Chat 里直接描述目标即可:

给 /path/to/video.mp4 做一个 3 分钟中文解说成片,保留关键原声,字幕烧进画面。
把 /path/to/english.mp4 翻译成中文配音,保留原说话人的声音。

核心体验

各工作台的能力边界与协议约束见架构说明。

能力目录

工作台 上游能力 主要入口
小说 Oh Story 0.7.9 · 13 Skills · 7 Roles /story、/story-long-write、/story-review
短剧 Drama Skills 0.6.5 · 10 Skills /short-drama、/short-drama-write、/short-drama-storyboard
游戏 NovelToGame 0.3.0 · 7 Skills · 《金瓶梅》可玩示例 /novel-to-game quick、/game-build、/game-qa
视频 video-recap-skills 0.4.0 · 6 Skills /video-recap、/video-script

安装

安装命令会临时提供 pnpm;只安装 Node.js 的机器也能执行。DSH 的 plugin add 内部需要 pnpm,单独运行 npx @deepseek-ai/dsh ... plugin add 不会自动补上它。

需要 Node.js 24+。视频工作台的流水线还需要宿主机安装 Python 3.10+ 与带 libass subtitles 滤镜的 ffmpeg/ffprobe(macOS brew install ffmpeg,Debian/Ubuntu sudo apt install ffmpeg)。

1. 安装插件并启动 DSH Web

npx -y --package [email protected] --package @deepseek-ai/[email protected] dsh plugin --profile web add @oh-story/[email protected] &&
npx -y @deepseek-ai/[email protected] web

也可以直接安装 GitHub Release 中经过同一套测试的预构建包:

npx -y --package [email protected] --package @deepseek-ai/[email protected] dsh plugin --profile web add https://github.com/zenstory-ai/oh-story-dsh/releases/download/v0.1.8/oh-story-dsh-0.1.8.tgz &&
npx -y @deepseek-ai/[email protected] web

保持终端运行,浏览器默认自动打开。如果没有自动打开,请复制终端打印的完整 http://127.0.0.1:3080/?token=... 链接访问;首次认证需要链接里的 token。关闭终端会停止服务。

2. 配置模型

开始 AI 创作前需要在 DSH 的「设置 → 模型」中添加 Provider 并填入 API Key;也可以在启动前设置环境变量 DEEPSEEK_API_KEY。如果只查看已有作品,可在首次引导中选择「稍后配置 / Configure later」。模型、凭据与权限均由 DSH 管理,本插件不接触。

3. 配置媒体生成 API(短剧生产需要)

DeepSeek 只负责写剧本、分镜和提示词,本身不会生图、生视频或生音乐。短剧的「生产」把这些提示词交给 short-drama-produce Skill,由它调用下面的供应商 API 生成媒体。Key 不在界面里填,而是在启动 DSH 之前写入宿主机环境变量:

能力 供应商 必需环境变量 可选
图片 GPT Image 2 OPENAI_API_KEY OPENAI_BASE_URL
视频 Seedance(火山方舟) ARK_API_KEY、SEEDANCE_MODEL SEEDANCE_BASE_URL、SEEDANCE_ALLOWED_RATIOS、SEEDANCE_MIN_DURATION/SEEDANCE_MAX_DURATION
视频 MiniMax H3 MINIMAX_API_KEY、MINIMAX_VIDEO_MODEL、MINIMAX_VIDEO_RESOLUTIONS MINIMAX_VIDEO_BASE_URL、MINIMAX_VIDEO_RATIOS、MINIMAX_VIDEO_MIN_DURATION/MINIMAX_VIDEO_MAX_DURATION
音乐 MiniMax Music MINIMAX_API_KEY MINIMAX_BASE_URL
export OPENAI_API_KEY=...            # 图片
export ARK_API_KEY=... SEEDANCE_MODEL=...   # 视频,模型/Endpoint ID 以账号开通的为准
npx -y @deepseek-ai/[email protected] web

只配置用得到的那几个即可:没有视频 Key 仍然可以写分镜、生成关键帧图片。短剧工作台的「生产」视图顶部会显示每个供应商是否已配置、缺哪个变量;插件只报告变量是否存在,从不读取或展示 Key 的值。插件启动时会把这四个内置 adapter 登记到一份不含凭据的配置文件(默认在系统临时目录下仅当前用户可读写的 oh-story-dsh-<uid>/ 里,「生成环境」条会显示完整路径),Agent 运行 production_tool.py run 时直接引用它;自己写 adapter 或改超时,就把文件路径写进 OH_STORY_DRAMA_ADAPTER_CONFIG。每个供应商的参数、分辨率与时长约束见随包的 short-drama-produce/references/providers/。

视频解说工作台另用 MIMO_API_KEY(Fish Audio TTS 另需 FISH_API_KEY),小说封面则使用当前 Preset 里可见的图片生成工具。

4. 开始创作

首次进入会先看到 DSH 首页。点击左侧 Workspaces 旁的 +(添加工作区 / Add workspace),选择存放作品的文件夹,再在下方 选择工作区 / Choose workspace 中选中该目录,DSH 会打开一个空白会话;也可以从左侧打开已有会话。目录里已有创作项目时,会显示「小说 / 短剧 / 游戏 / 视频」四个工作台标签。

空目录会保留 DSH 原生 Chat。配置好模型后,输入 /story、/short-drama、/novel-to-game quick 或 /video-recap 开始创作;Agent 写出第一个创作文件后,工作台会自动出现。查看已有作品不需要 API Key。工作台收起后,可通过会话区的「创作工作台」按钮重新打开。

没看到界面时

按需加载

插件装进哪个 profile,那个 profile 的每个 Session 就都会加载创作 Skills;工作台只在有创作项目时显示。想让原版 web 保持干净、只在创作时打开工作台,就把插件装进独立 profile。

1. 装进独立 profile

npx -y --package [email protected] --package @deepseek-ai/[email protected] dsh plugin --profile story add @oh-story/[email protected]

2. 补上界面

新 profile 默认没有界面。编辑 ~/.dsh/profiles/story/package.json,把 dsh.profile.bundles 改成:

"bundles": [
  "@deepseek-ai/dsh-base",
  "@deepseek-ai/dsh-web-app",
  "@oh-story/dsh"
]

@deepseek-ai/dsh-web-app 是 DSH 自带的 Web 界面包,需要在创作插件之前加载。

3. 按需启动

npx -y @deepseek-ai/[email protected] web                          # 原版 DSH
npx -y @deepseek-ai/[email protected] --profile story --port 3081  # 创作工作台

两个 profile 用不同端口可以同时运行。模型、凭据、workspace 与历史会话由 DSH 统一保存,切换 profile 不会丢。安装与启动请使用同一个 dsh 版本,混用会报 unknown option '--no-open' 一类的错。

致谢

更新日志 · 贡献指南 · 架构说明 · 安全策略

oh-story-dsh (zenstory-ai/oh-story-dsh)

Searching Database…

What is this?oh-story-dsh is a community plugin for DeepSeek Harness (DSH) that adds four creative workbenches to DSH: novel writing, short-drama production, interactive game adaptation, and video recap/commentary.
Is this a standalone app, or does it plug into something else?It is a plugin, not a standalone app. DSH itself manages the Agent, sessions, models, permissions and Chat; this plugin only adds writing Skills, Roles, project conventions and the matching workbenches on top of DSH.
How do I install and start it?You install it into DSH with the plugin's `plugin add` command run via `npx @deepseek-ai/dsh`, which temporarily provisions pnpm even on a Node-only machine, then launch `dsh web`; a browser tab opens automatically with a token link for first-time auth.
What do I need on my machine besides DSH itself?Node.js 24+ is required for the plugin. The video-recap workbench additionally needs Python 3.10+ and ffmpeg/ffprobe built with the libass subtitles filter on the host.
Can DeepSeek itself generate the images, video and music?No. DeepSeek only writes the script, storyboard and prompts; actual image, video and music generation is delegated to separate paid provider APIs (GPT Image 2, Seedance, MiniMax) configured via your own environment variables.
What does the game workbench ship with out of the box?It includes a complete playable demo, '金瓶梅 · 风月总账' (Jin Ping Mei: Romance Ledger), so you can verify input, core loop and endings before generating your own game with /novel-to-game quick.
Why would I install this into a separate DSH profile?Creative Skills load for every session in whatever profile the plugin is installed in, so putting it in its own 'story' profile keeps your default DSH web interface clean; that profile then needs @deepseek-ai/dsh-web-app added manually to get a UI.
Do I need an API key just to look at existing work?No — browsing already-written novels, episodes or videos needs no API key; you only need to configure a model Provider (or set DEEPSEEK_API_KEY) once you want the Agent to actually write new content.
Which providers power optional image, video and music generation?Built-in adapters call GPT Image 2 for images, Seedance or MiniMax H3 for video, and MiniMax Music for soundtracks, each requiring its own API key set as a host environment variable before launching DSH.
Size
56.1 MB
Stars
526
Age
1mo
Commits · 90 Days