oh-story-dsh

oh-story-dsh 是 DeepSeek Harness（DSH）的社区插件，与 DeepSeek 无隶属关系。它把小说、短剧、互动游戏与视频解说四条创作流水线装进 DSH：DSH 负责 Agent、会话、模型、权限和 Chat，插件负责创作 Skills、专业 Roles、项目协议和对应的工作台。

• 小说：文件树、编辑器、Chat 三栏，13 个 Oh Story Skills 与 7 个专业 Roles 随插件交付。
• 短剧：每集维护剧本、视觉设定、分镜、图片与视频提示词，「生产」视图投影为镜头板与素材板，成片由 /short-drama-edit 装配。
• 游戏：/novel-to-game quick 生成可玩构建，左侧实时试玩、右侧 Chat。
• 视频解说：给本地视频做中文解说成片或配音翻译，原片、剪后片、成片就地预览。

安装

需要 Node.js 24+。安装命令会临时提供 pnpm，只装了 Node.js 的机器也能执行：

npx -y --package pnpm@11.7.0 --package @deepseek-ai/dsh@0.1.5-rc.1 dsh plugin --profile web add @oh-story/dsh@0.1.9 &&
npx -y @deepseek-ai/dsh@0.1.5-rc.1 web

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

开始 AI 创作前，在 DSH 的「设置 → 模型」中添加 Provider 并填入 API Key，或在启动前设置环境变量 DEEPSEEK_API_KEY。只查看已有作品可在首次引导中选择「稍后配置 / Configure later」。

GitHub Release 中的预构建包经过同一套测试：

npx -y --package pnpm@11.7.0 --package @deepseek-ai/dsh@0.1.5-rc.1 dsh plugin --profile web add https://github.com/zenstory-ai/oh-story-dsh/releases/download/v0.1.9/oh-story-dsh-0.1.9.tgz &&
npx -y @deepseek-ai/dsh@0.1.5-rc.1 web

DSH 的 plugin add 内部需要 pnpm，命令里的 --package pnpm@11.7.0 就是为此准备的。

视频工作台的流水线还需要宿主机安装 Python 3.10+ 与带 libass subtitles 滤镜的 ffmpeg/ffprobe（macOS brew install ffmpeg，Debian/Ubuntu sudo apt install ffmpeg）。视频解说另用 MIMO_API_KEY（Fish Audio TTS 另需 FISH_API_KEY）。

DeepSeek 负责写剧本、分镜和提示词；生图、生视频、生音乐由短剧「生产」交给 short-drama-produce Skill，再调用下面的供应商 API 完成。Key 在启动 DSH 之前写入宿主机环境变量：

export OPENAI_API_KEY=...            # 图片
export ARK_API_KEY=... SEEDANCE_MODEL=...   # 视频，模型/Endpoint ID 以账号开通的为准
npx -y @deepseek-ai/dsh@0.1.5-rc.1 web

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

开始创作

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

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

下面的请求复制改一改就能用，替换方括号内容后发送。

视频解说，在 Chat 里直接描述目标：

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

已有稿件，第一轮只讨论续写方案，先把方向谈清楚，再决定是否落到项目文件：

我想规划这部自有或已获授权小说的下一场戏。只阅读当前 workspace 中我点名的 [章节文件] 和 [设定文件]；[末尾片段] 尚未写完，不要把它算成完整章节。先列出与下一场戏有关的已知事实、视角人物目前知道的事，以及尚缺或冲突的信息。再给两个续写方向，分别说明人物要什么、阻力是什么、行动造成什么可见变化；不要提前揭示 [秘密]，停在 [场景边界]。本轮只在 Chat 回复，不创建、移动或改写任何文件，不生成正文或调用媒体服务；不清楚的地方列为问题，不补成既定事实。

选定方向后，再明确要求按随包流程导入或规划，并把“是否写文件、是否写正文、写到哪一章”说清楚；保留原稿备份。

没看到界面时

• 安装报 pnpm not found on PATH：重新执行上面带 --package pnpm@11.7.0 的完整安装命令，确认安装成功后再启动。
• 浏览器未打开或要求认证：打开终端打印的完整带 ?token=... 链接；端口被占用时用 web --port 3081，并访问新打印的链接。
• 没有四个创作标签：先添加作品目录并打开会话。空目录需要先在 Chat 中运行创作命令，生成创作文件后工作台才会出现；已收起的工作台可用会话区的「创作工作台」按钮恢复。已有作品仍不显示时，检查安装与启动是否使用同一个 profile，重启 DSH 并刷新页面。
• 独立 story profile 没有网页服务：按下方「按需加载」一节补上 @deepseek-ai/dsh-web-app，新 profile 需要单独添加 Web 界面。

小说工作台

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

短剧工作台

每集按请求维护最多五份可读 Markdown：剧本.md、视觉设定.md、分镜.md、图片提示词.md、视频提示词.md。「生产」视图把这些文档投影为镜头板、素材板、任务/版本、成片顺序和关系画布，并就地提示重复 ID、悬空引用与格式错误。成片装配交给 /short-drama-edit：它把排定的镜序写成《剪辑单.md》，再渲染到 剧集/<EP>/制作成果/成片/。生产交付走 DSH 原生会话、当前 Preset 工具与权限确认。

游戏工作台

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

视频工作台

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

核心体验

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

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

能力目录

按需加载

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

1. 装进独立 profile

npx -y --package pnpm@11.7.0 --package @deepseek-ai/dsh@0.1.5-rc.1 dsh plugin --profile story add @oh-story/dsh@0.1.9

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/dsh@0.1.5-rc.1 web                          # 原版 DSH
npx -y @deepseek-ai/dsh@0.1.5-rc.1 --profile story --port 3081  # 创作工作台

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

常见问题

用 DeepSeek 写小说，一定要装插件吗？ 只讨论一个梗概或修改一段自带文本，用普通模型聊天就够，自己把结果放回稿件即可；要围绕本地作品目录持续创作、在工作台里看文件，再装 DSH 加本插件。想用账户化的网页项目，可选 ZenStory 托管工作台，具体区别见写作环境对比。

查看已有作品需要 API Key 吗？ 不需要。首次引导选择「稍后配置」，打开作品目录就能浏览文件；开始 AI 创作时再配置模型。

分镜或游戏设计写好了，成片和可玩构建从哪来？ 短剧成片由 /short-drama-edit 按《剪辑单.md》渲染，需要先配置媒体生成 API；游戏构建由 /game-build 生成，就绪后自动进入游戏工作台的项目列表。

延伸阅读

• DeepSeek 写小说指南：选择作品目录、配置宿主模型，再给出题材、视角与本轮停靠点。
• 导入与续写：分清已完成章节、未完成片段、必须保留的设定和下一段范围。
• 短剧角色一致性：分清身份、造型与逐镜状态。
• 有后果的游戏选择：明确行动代价、可见变化和后续承接。
• 原声与旁白分工：先列出关键台词、画面依据和需要解说的空隙。
• 写作环境对比：普通聊天、DSH 插件与托管工作台各适合什么。

致谢

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

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