AI 应用AI 写作AI 技能AI 插件dsh-plugin【免费下载链接】Openwritedsh-OpenwriteOpenWrite 的 DeepSeek Harness 小说创作插件含统一创作 Agent、90 个小说工具、原生工作台与标准审稿 DAG项目地址https://gitcode.com/gh_mirrors/op/Openwrite点击查看免费下载OpenWrite 是运行在 DeepSeek Harnessdsh中的小说创作插件内置原生场景结构管理能力它用稳定场景 ID把长篇正文拆成可引用的场景实体支持阅读顺序与故事时间双序查看并在跨章迁移时以三重 revision 保护数据安全。本教程面向新手带你完成从旧稿分场预览、元数据维护到跨章移动场景的完整流程。 如果你还没安装 OpenWrite执行dsh plugin --profile web add -w dsh-openwritelatest再运行dsh web进入工作台即可无需克隆仓库。1️⃣ 为什么长篇写作需要「场景」这一层很多写作工具里章chapter是最小组织节点章内的 beat 只是一段段文本列表——无法被持久引用。当你需要重排、拆分或跨章移动一段情节时只能整章操作风险很高。OpenWrite 在审计文档中明确了这一缺口P2 级问题并给出了解法让场景成为一等公民每个场景拥有稳定 ID不随章节变化而漂移所属章与章内阅读序号故事时间排序键与标签在场人物、地点、事件引用正定位锚与新鲜度状态 设计依据见 docs/OPEN_SOURCE_NOVEL_AUDIT.md其中还定义了验收标准重排、跨章移动后正文与引用完整导出遵循阅读顺序时间线遵循故事时间。2️⃣ 找到入口资料 → 大纲 → 原生场景结构在 dsh 工作台点击侧栏OpenWrite打开创作会话后进入「资料」页签导航到「大纲 → 原生场景结构」。工作台面板由 SceneWorkbench.tsx 实现副标题写得很直白按稳定场景 ID 管理元数据与章内、跨章顺序。面板顶部是状态行共有 4 种状态定义见 SceneWorkbench.tsx状态含义你能做什么absent尚未迁移项目还没有原生场景结构审阅下方只读迁移预览current当前结构与当前章节一致✅ 可编辑元数据和顺序、移动场景stale已过期章节已变化元数据与移动停用需重新预览迁移ambiguous有歧义存在无法自动判定的场景逐项解决结构问题只有current状态下编辑按钮才可用——这是防止误改的核心设计。3️⃣ 读懂场景卡片一个场景、两套顺序迁移完成后每个场景显示为一张卡片包含场景 ID、所属章、标题、故事时间标签 排序键、人物、地点、事件。数据模型见 SceneWorkbench.tsx。阅读顺序 vs 故事时间面板工具栏提供两种显示顺序切换阅读顺序读者实际读到的先后正文物理顺序故事时间按story_time_sort_key排序适合回忆杀、倒叙、多线叙事实践建议给每个场景填写故事时间标签如「第 3 天·夜」和可比较的排序键如D3-night之后切到故事时间视图倒叙结构是否自洽一眼可见。排序逻辑实现在 SceneWorkbench.tsx。编辑场景元数据点击场景卡片的「编辑」按钮可修改标题、故事时间排序键/标签、人物、地点、事件逗号分隔多个。保存走 CAS 乐观锁请求必须携带当前场景结构的expected_revision若期间结构已被他人/后台任务修改工作台会提示「修订冲突」并自动刷新到最新版本让你重试冲突处理见 SceneWorkbench.tsx。✅ 关键保障元数据编辑绝不改动正文一个字——它只写场景侧车数据sidecar正文 SHA 保持不变既有评审不会因此失效。4️⃣ 跨章迁移场景预览 → 应用 → 回滚三步走第 1 步只读预览逐项核对旧正文首次接入或结构过期stale时面板底部会出现「迁移预览只读」区块。预览本身不写入项目只列出将要发生的分场/迁移项。你核对无误后勾选「我已核对只读预览确认应用迁移」「应用迁移」按钮才会解锁UI 逻辑见 SceneWorkbench.tsx。第 2 步应用迁移需要精确 revision应用迁移必须携带预览生成时的expected_preview_revision与显式确认标志——预览过期期间章节变了时服务端会拒绝你必须重新生成预览。成功后会返回migration_id工作台记录本会话最近一次迁移。第 3 步一键回滚到迁移前如果迁移结果不符合预期点击「回滚最近迁移」OpenWrite 会恢复迁移前字节级一致的场景侧车rollback 由当前结构 revision 做 CAS 保护。对应工具说明见 tools.ts。移动场景到另一章编辑面板里还有「移动场景」区域选择目标章 目标位置从 0 开始点击移动。跨章移动需要三重 revision 同时匹配场景自身 revision、源章 revision、目标章 revision缺一不可请求体构造见 SceneWorkbench.tsx。⚠️ 跨章移动正文时OpenWrite 会触发既有的正文接纳流程manuscript acceptance flow移动后正文变化会使旧评审立即 stale按写作→评审→修订的闭环重新交付而不是静默改写。5️⃣ stale/ambiguous 如何保护你的稿件场景结构的生命周期规则定义在 docs/WORKFLOWS.md章节正文变化后旧结构进入stale元数据编辑与移动自动停用你重新预览并确认迁移后结构重新锚定为current交付导出成稿会阻断 stale/ambiguous 状态避免把过期结构写进成品完整备份导出始终回退到完整正文场景结构只是增强层删掉它稿件也完好。这套「宁可停下、不可错改」的语义是长篇项目中避免连锁损坏的关键。6️⃣ 进阶Agent 可用的 7 个场景工具除了面板操作你还可以直接在 OpenWrite 创作会话里用自然语言指挥 Agent 操作场景。桥接层提供了 7 个novel_scene_*工具清单见 DESIGN.md实现见 tools.ts工具作用novel_scene_structure读取全量场景结构稳定 ID、双序、章 revision、引用与问题novel_chapter_scenes读取单章的场景切片novel_scene_migration_preview生成只读、精确 revision 的分场预览novel_scene_migration_apply应用一份新鲜预览需精确 revision 显式确认novel_scene_migration_rollback字节级回滚到迁移前novel_scene_updateCAS 更新场景标题/故事时间/人物地点事件引用novel_scene_move章内/跨章移动场景三重 revision 保护示例对话「用novel_scene_structure检查当前结构状态如果有 stale 就先重新生成迁移预览给我核对再应用。」Agent 会按预览→确认→应用的安全顺序执行而不是直接写盘。7️⃣ 常见问题 FAQQ1大纲里规划了但还没写的章节会出现在场景列表吗不会。planned_missing章节保留在项目计划中不会作为可编辑场景显示面板只会提示「N 个规划章节尚无稿件」逻辑见 SceneWorkbench.tsx。Q2修改场景元数据会影响正文字数或导出吗不会。元数据存于场景侧车有效标记不计入可读字数也不进入默认导出。Q3导出和续写分别遵循哪个顺序导出遵循阅读顺序连续性时间线遵循故事时间。这正是双序设计的价值。Q4迁移后想彻底放弃场景结构怎么办结构数据是独立 sidecar备份导出永远包含完整正文按 docs/WORKFLOWS.md 的规则正文不会因结构过期而损坏。8️⃣ 小结稳定 ID 双序 三重保护OpenWrite 的场景结构管理可以浓缩成三句话稳定场景 ID让重排、拆分、跨章移动不再牵一发动全身阅读顺序 / 故事时间双序让倒叙多线长篇的组织问题可视化revision 保护 只读预览 可回滚迁移确保每一步结构操作都可核对、可撤销。配合「资料 → 大纲」面板和 7 个novel_scene_*工具你可以在写作中途随时重构长篇结构而不必担心正文和既有评审被破坏。更多工作台细节见 packages/studio-panel/README.md完整创作流程见 docs/WORKFLOWS.md。赞分享AI 应用AI 写作AI 技能AI 插件dsh-plugin【免费下载链接】Openwritedsh-OpenwriteOpenWrite 的 DeepSeek Harness 小说创作插件含统一创作 Agent、90 个小说工具、原生工作台与标准审稿 DAG项目地址https://gitcode.com/gh_mirrors/op/Openwrite点击查看免费下载相关推荐novelWriter 场景结构实战用三级标题、引用标记与拆分工具组织章节内的多场景novelWriter 场景结构实战用三级标题、引用标记与拆分工具组织章节内的多场景 本文以 novelWriter 示例项目中的真实场景文档 bc0cbd2桌面应用Blockbench场景管理Collection与Outliner节点组织Blockbench场景管理Collection与Outliner节点组织 你是否曾在编辑复杂3D模型时陷入节点混乱的困境当模型包含数十个立方体、骨骼和动画桌面应用3D渲染图形学插件系统Redot Engine场景管理如何组织复杂的游戏世界结构Redot Engine场景管理如何组织复杂的游戏世界结构 Redot Engine是一款强大的跨平台2D和3D游戏引擎其场景管理系统为开发者提供了构建复杂游戏开发图形学创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考