oh-story-dsh

<h1 align="center">Oh Story DSH</h1>

<b>小说、短剧、互动游戏与视频解说创作工作台，装进 DeepSeek Harness。</b>

<a href="https://zenstory.ai/zh/dsh"><b>项目主页</b></a>  ·  <a href="#安装"><b>安装</b></a>  ·  <a href="#看看它的输出"><b>看看它的输出</b></a>  ·  <a href="README_EN.md"><b>English</b></a>

这是什么

oh-story-dsh 是 DeepSeek Harness（DSH）的社区插件，与 DeepSeek 无隶属关系。装上它，DSH Web 里多出四个创作工作台：小说、短剧、游戏、视频解说。Agent、会话、模型、权限审批和 Chat 仍然全是 DSH 原生的，插件只添加创作 Skills、专业 Roles、项目文件协议和工作台界面，不带第二套 Agent 运行时或项目数据库。

以下清单对应当前源码；已发布安装包的上游提交固定在该版本的 manifest 中，未发布更新见 Unreleased。

工作台	上游能力（固定版本，随插件打包）	主要入口
小说	Oh Story 0.9.1 · 13 Skills · 7 Roles	/story、/story-long-write、/story-review
短剧	Drama Skills 0.9.2 · 11 Skills	/short-drama、/short-drama-write、/short-drama-storyboard、/short-drama-edit
游戏	NovelToGame 0.6.1 · 7 Skills · 《金瓶梅》ADV 可玩示例（18+）	/novel-to-game quick、/game-build、/game-qa
视频	video-recap-skills 0.6.2 · 7 Skills（3 个用户入口）	/video-recap、/video-script、/video-reference

最新版本 v0.1.19（2026-10-27）。默认安装固定使用 DeepSeek Harness 0.2.1-rc.4；npm latest 的 0.2.1-rc.2 与更早的 0.2.0-rc.2 仍受支持。变更见 CHANGELOG.md 与 Releases；升级步骤见常见问题「升级到新版本后要做什么」。

四个工作台

下面四段动图都是打包后的插件装进官方 DSH Web 的真实画面，取自原生集成测试的录制；右侧 Chat、模型、用量和耗时都是 DSH 自己的。

小说

文件树、编辑器、Chat 三栏。Agent 写文件时编辑器跟着它走，点 Chat 里的文件名就能在编辑器打开。覆盖长篇、短篇、选题、扫榜、拆文、导入、审稿、去 AI 味与封面。

短剧

每集按需维护最多五份核心创作 Markdown：剧本.md、视觉设定.md、分镜.md、图片提示词.md、视频提示词.md。「生产」视图把它们投影成镜头板、素材板、任务/版本、成片顺序和可平移缩放的无限关系画布，并就地指出重复 ID、悬空引用与格式错误。生图、生视频、配音、生音乐的任务先预览、你确认后才调用供应商 API；成片由 /short-drama-edit 按《剪辑单.md》渲染到 剧集/<EP>/制作成果/成片/。

游戏

左侧实时试玩、右侧 Chat。/novel-to-game quick 的产物写进 game-adaptations/<project>/，build/app/index.html 就绪后自动进入项目列表，可刷新、全屏、切换项目。游戏在独立 origin 与 iframe sandbox 里运行。随包的《金瓶梅 · 风月总账》ADV 示例不用 API Key 也能玩：还没有作品时点欢迎卡上的「先玩内置示例」，之后在「游戏项目」下拉的「内置示例」里选择。示例改编自古典小说，含成人内容（18+），进入前会确认年龄。

视频解说

左侧预览、右侧 Chat。项目放在 video-recaps/<project>/：原片在 sources/，工作产物在 work/，交付在 outputs/。可在原片、剪后片、成片之间切换，查看阶段提示、运行清单与质检产物；视频经 HTTP Range 流式预览。还没有视频项目时，空状态先列出运行环境：Python 3.10+、ffmpeg/ffprobe 与 MIMO_API_KEY 是否就绪。

四个工作台共同的规矩

• 文件就是创作事实：工作台只投影项目里的文件，不写并行数据库；改哪份文件就是改哪一层决定。人工未保存的内容不会被并发的 Agent 写入覆盖。
• 媒体生产先确认：短剧媒体任务先在 Chat 展示准确内容与预检结果，你确认同一任务后才执行。媒体 Key 放在宿主机环境变量里，插件只报告是否已配置。
• 不占别的场景：只有当前 workspace 里真的有创作项目时才接管布局，随时可收起，收起后会话回到 DSH 原生形态，选择按 workspace 记住。

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

安装

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

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

保持终端运行，浏览器默认自动打开；没有自动打开就复制终端打印的完整 http://127.0.0.1:3080/?token=... 链接访问，首次认证需要链接里的 token。关闭终端会停止服务。安装与启动请使用同一个 dsh 版本。本页默认命令固定使用 npm next 的 0.2.1-rc.4，npm latest 的 0.2.1-rc.2 同样验证过；本插件接受 >=0.2.0-rc.2 <0.2.1-0 与 >=0.2.1-alpha.1 <0.2.2-0。仍在用 0.2.0-rc.2 时，安装与启动两条命令都要换成 @deepseek-ai/[email protected]；不要把两个宿主版本混用。DSH 会在安装与加载时检查版本，不匹配时给出明确提示（dsh plugin allow-version 可自担风险放行）。

…