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 翻译成中文配音，保留原说话人的声音。

核心体验

• 实时文件跟随：Agent 调用官方文件工具时，目标文件自动定位，编辑器同步呈现生成中的内容。
• Chat 文件导航：点击官方 Chat 中的作品文件名，文件树会定位并在编辑器打开对应文件。
• 创作文档预览：Markdown 支持标题、表格、任务列表、引用和代码块；JSONL 以带行号、类型和状态的结构化记录呈现。
• 项目媒体库：自动汇总当前 workspace 中各集和交付目录的真实图片/视频成果，支持搜索、类型筛选与跨集引用。
• 真实生成契约：可选内置 GPT Image 2、Seedance 与 MiniMax Music adapter；账号、模型、凭据与可用性由 DSH 运行环境和项目外配置决定。
• 安全编辑：支持源码编辑与快捷保存；人工未保存内容不会被并发 Agent 修改覆盖。
• 稳定长对话：消息区独立滚动，官方 Composer 固定在 Chat 栏底部。

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

能力目录

安装

需要 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 @deepseek-ai/dsh@0.1.2-alpha.3 plugin --profile web add @oh-story/dsh@0.1.5
npx -y @deepseek-ai/dsh@0.1.2-alpha.3 web

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

npx -y @deepseek-ai/dsh@0.1.2-alpha.3 plugin --profile web add https://github.com/zenstory-ai/oh-story-dsh/releases/download/v0.1.5/oh-story-dsh-0.1.5.tgz
npx -y @deepseek-ai/dsh@0.1.2-alpha.3 web

默认在 http://127.0.0.1:3080 打开。

2. 配置模型

首次使用需要在 DSH 的「设置 → 模型」中添加 Provider 并填入 API Key；也可以在启动前设置环境变量 DEEPSEEK_API_KEY。模型、凭据与权限均由 DSH 管理，本插件不接触。

3. 开始创作

添加作品目录为 workspace，新建或打开 Session 后使用 /story、/short-drama、/novel-to-game quick 或 /video-recap。四个工作台可随时通过顶部 Tab 切换。

按需加载

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

1. 装进独立 profile

npx -y @deepseek-ai/dsh@0.1.2-alpha.3 plugin --profile story add @oh-story/dsh@0.1.5

2. 补上界面

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

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

顺序照抄，这个包不用另外安装。

3. 按需启动

npx -y @deepseek-ai/dsh@0.1.2-alpha.3 web                          # 原版 DSH
npx -y @deepseek-ai/dsh@0.1.2-alpha.3 --profile story --port 3081  # 创作工作台

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

致谢

• DeepSeek Harness：提供原生插件运行时、Agent、会话、权限审批与 Web 工作台基础。
• LINUX DO：感谢社区的交流、反馈与开源支持。

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