moxi-drama-studio

墨戏生花 · Moxi

> 跑在 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 上的短剧创作工作台（源码公开 · 个人非商业免费）：在无限画布上，把一部短剧从一句话故事写到可导出 docx，再判断它到底能不能拍。

>

> 底座：DeepSeek Harness（DSH）· 界面：无限画布 + 管理后台 · 数据：本机项目工作区文件 · 许可：非商业免费（商用需授权）

---

> 🆕 2026-11-07 起源码完整公开：DSH 三个插件、规则包、技能、确定性脚本与评测集全部入库；此前实验版以安装包形式分发。2026-11-08 起许可调整为「个人非商业免费 + 商用需授权」（PolyForm Noncommercial 1.0.0，见 [LICENSE](LICENSE)）。

1. 这是什么

墨戏生花（Moxi）是一个跑在 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 上的短剧创作插件。DSH 是 DeepSeek 的本地 Agent 运行时（「一切皆插件」），墨戏生花以三个插件的形式接入它。它把「写短剧」拆成一条可复跑的流水线，全部跑在你自己的电脑上：

新建剧作 → 概念设定 → 角色资产 → 分集节拍 → 分场表 → 剧本
        → 确定性检查（场景头 / 字数 / 场次 / 场号 / 集号）→ 合规红线 → 质检
        → 可拍性报告（时长 / 角色 / 钩子）→ 逐集签收 → 人工放行 → 导出 docx

它想解决的不是「让 AI 写完一集」，而是一部长剧怎么稳定写完、写完怎么判断能不能拍。所以分工是：

• 写交给模型：概念、节拍、分场、剧本、质检打分；
• 判尽量交给确定性脚本：字数、场次、场景头格式、重复段落、合规红线、时长估算、钩子检测；
• 放行留给人：逐集签收，加一道可配置的放行闸门。

适合：短剧编剧与小型工作室（批量出稿 + 质量门）、想把创作规则沉淀成资产的个人创作者、想照着写 DSH 插件的开发者。

不覆盖：长篇小说、非短剧体裁、纯格式转换——规则包与技能都只服务短剧。

拆到代码里是四层：

| 层 | 是什么 | 在哪里 |

|---|---|---|

| 业务内核 | moxi-core Host 插件：项目 / 节点 / 正文 / 检查 / 导出 / 可拍性 / 放行的唯一读写入口 | dsh/bundles/moxi-core/ |

| 两个界面 | moxi-canvas 无限画布、moxi-admin 管理后台 | dsh/bundles/moxi-canvas/、dsh/bundles/moxi-admin/ |

| 领域资产 | 规则包、创作技能、确定性检查脚本、评测集 | rules/v2/、skills/、scripts/、harness/ |

| 数据 | 本机项目工作区：Markdown / JSON / JSONL，无数据库服务 | ~/Documents/Moxi/projects/ |

2. 功能亮点

• 无限画布：一张画布就是一部剧。节点分 9 类（项目根 / 设定集 / 资产 / 分集节拍 / 分场表 / 剧本场次 / 质检 / 合规 / 分镜·导出），支持拖拽、缩放、连线、双击改名、撤销重做、视口持久化。
• 1–30 集一键直出：选起止集，按「节拍 → 分场 → 剧本 → 确定性检查 → 质检 / 合规」流水线生成；进度抽屉实时显示，可取消、可续跑、断点恢复。单任务上限 30 集。
• 生成前快照：启动生成前自动拍快照，不满意可一键「回退到生成前」（回退本身也可撤销）。
• 确定性检查：场景头格式、净字数、场次连续、空场、重复段落、合规红线粗筛；findings 写回节点，状态机自动流转。模型只负责写与评，判定由脚本算。
• 可拍性报告：逐集给出估算时长（对白字数 + 动作行，±25% 容差）、场次、角色对白、集末钩子、是否落在设定集内、角色出场分布；每集可人工签收，签收绑定稿件版本，改稿自动失效。
• 放行闸门：未签收 / 签收失效 / 缺集末钩子都不放行；确需跳过必须填理由，并写入审计。
• 管理后台 5 页：工作台 KPI、项目、规则与技能、模型与用量（含链路探针）、日志与按范围导出。
• 墨稿皮肤：宣纸 #F4F0E7 / 墨 #252A2B / 朱砂 #A44736，明暗两套跟随系统明暗；也可以一键切回宿主外观。
• 本机数据 + 审计：写操作只追加进 history/events.jsonl；写事务走 WAL，可回滚；删除是软删，进 .trash/ 可找回。
• 对话 / 画布双入口：可以直接在 DSH 对话里说需求，让 Agent 调用工具；也可以在画布上手动操作。两条通道共用同一个 moxi-core，改的是同一份数据。

3. 界面截图

| 首页 · 墨稿创作台 | 无限画布 |

|---|---|

| | |

| 项目卡片、待放行 / 已放行标记；可一键切回宿主外观 | 9 类节点、节点间连线、工位条与底部状态栏 |

| 可拍性报告（逐集签收） | 放行闸门（未签收 / 缺钩子拦截） |

|---|---|

| | |

| 逐集看估算时长、场次、角色、集末钩子，并逐集签收 | 被闸门拦下时给出计数卡与具体集号，可去签收或填理由强制放行 |

> 截图来自实验版 v0.1.0-exp.5 的实际界面（演示项目）。

4. 架构

用户 ──对话──▶ DSH Agent ──工具（moxi_*）──▶ moxi-core ──▶ 本机项目工作区（MD / JSON / JSONL）
  └──操作──▶ 墨戏画布 / 墨戏后台 ──/api/moxi/*──▶ moxi-core

┌─────────────────────────────────────────────────────────────────────────────┐
│ DeepSeek Harness：会话 / Agent / 工具 / 技能 / 存储 / Web UI                │
│ 独立 profile：moxi（不动 desktop profile，不影响现有 DSH 界面）             │
├─────────────────────────┬─────────────────────────┬─────────────────────────┤
│ moxi-core（Host 插件）  │ moxi-canvas（客户端）   │ moxi-admin（客户端）    │
│ 业务唯一入口：          │ 无限画布工作台：        │ 管理后台 5 页：         │
│ 项目 / 节点 / 正文      │ 节点 / 连线 / 正文      │ KPI / 项目              │
│ 检查 / 导出 / 可拍性    │ 生成 / 可拍性           │ 规则与技能              │
│ 放行 / 审计             │ 签收 / 放行 / 导出      │ 模型与用量              │
│ 15 个 Agent 工具        │                         │ 日志与导出              │
│ 36 条同源 HTTP 路由     │                         │                         │
├─────────────────────────┴─────────────────────────┴─────────────────────────┤
│ 领域内核：rules/v2（规则包）· skills/moxi-drama-creation（技能）            │
│ scripts/（确定性检查 / 构建 / 迁移）· harness/（评测）                      │
├─────────────────────────────────────────────────────────────────────────────┤
│ 数据：本机项目工作区文件（Markdown / JSON / JSONL）                         │
└─────────────────────────────────────────────────────────────────────────────┘