dsh-openwrite

dsh-Openwrite

在 DeepSeek Harness 中规划、写作、审稿和管理长篇小说。

快速安装 · 开始使用 · 功能 · 文档 · 反馈问题

这是 OpenWrite 的 dsh 插件版本。 DeepSeek Harness 提供 Agent 与交互界面，OpenWrite Core 提供小说领域能力；人物、设定、大纲、正文和评审保存在本地作品目录。

快速安装

0.2.21 标准插件包兼容精确 dsh 版本 0.1.2-rc.1 / 0.1.5-alpha.1 / 0.2.0-rc.2。三个版本均已完成 Web 工作台渲染与 DoG 数据读取验证，Windows Electron 桌面端启动/恢复链路尚未实机复测。可下载版本、各平台验收结果和 SHA-256 以 GitHub Release 附件为准；验收方法见 发布验收。默认使用 npm latest 渠道；商城所需的精确预览版兼容性、验证范围和安装限制见 DSH STORE 接入。

npm 包和对应 GitHub Release 使用同一份验收产物。也可安装精确版本的 Release 包：

dsh plugin --profile web add -w https://github.com/LiPu-jpg/Openwrite/releases/download/v0.2.21/dsh-openwrite-0.2.21.tgz
dsh web

已有匹配版本 dsh 的用户执行：

dsh plugin --profile web add -w dsh-openwrite@latest
dsh web

@latest 在执行安装或升级命令时选择 npm 最新发布版本，不会自动替换正在运行的服务。无需在安装时编译源码。升级前停止 dsh，并核对目标版本的宿主兼容说明。需要复现或回退时，使用 dsh-openwrite@0.2.8 等精确版本；对应版本的 npm 包与 Release 预编译包 为同一份已验收产物。

也可把这段话交给有终端权限的 Agent：

请按 https://github.com/LiPu-jpg/Openwrite 的 README 和对应 Release 安装 OpenWrite。
先核对 Release 验收结果和精确 dsh 版本，再用 dsh plugin --profile web add -w dsh-openwrite@latest 安装。
如宿主不兼容，安装最后一个匹配且已验收的精确版本，不自动升级宿主。
已有本地安装先备份并迁移，保留作品、自定义预设、凭据和其他插件。
启动 dsh web，指导我点击 OpenWrite、准备环境并选择自己的作品。
不要调用写作模型做安装检查，不要自动升级宿主或放宽 pnpm 构建授权。

首次使用会下载固定版本的 uv、Python 3.12 和锁定依赖，保存在当前 dsh 的专属目录。无需预装 Python，也无需克隆两个分支。目标平台为 macOS arm64/x64、Linux x64、Windows x64；各平台通过情况以发布验收报告为准。模型费用另计。

具体的源码安装、升级、迁移和卸载见 安装指南。

dsh 0.2 桌面端升级

0.2.21 修复 #79 的 Windows Desktop 目录选择：宿主接口失败后使用桌面提供的系统文件夹对话框，覆盖侧栏进入与工作台内目录选择。Core 保持 5.8.10。排查与手填路径方式见 安装指南。

0.2.20 捆绑 Core 5.8.10，修复 #76 的草稿恢复、任务状态、编辑和审稿契约，并补充 #65 的英文使用支持。行为与范围见 修复说明。正式可下载版本以 npm latest 和 GitHub Release 为准。

0.2.19 候选包修复两个加载/工具问题：部分安装下「OpenWrite 创作」预设从列表消失、DoG 工具不可用（dsh-dog 宿主包解析失败，#74），以及 novel_* 工具的对象/数组参数在模型输出 JSON 字符串时预览失败、data 字段丢失（#75）。正式可下载版本以 npm latest 和 GitHub Release 为准。升级后需停止并重新启动 dsh，再刷新浏览器页面。

0.2.18 候选包修正 auto:cheapest（Core 5.8.9）：零价模型不再参与比价，自动落到付费低价模型上。正式可下载版本以 npm latest 和 GitHub Release 为准。升级后需停止并重新启动 dsh，再刷新浏览器页面。

0.2.17 候选包新增自动选模（Core 5.8.8）：模型档案的模型名写成 auto:cheapest 会自动选用服务商价格目录中总价最低且满足上下文/输出要求的模型（目录缓存一小时，价格变动自动跟随），写成 auto:popular（OpenRouter）则由官方 openrouter/auto 按社区用量自动选模型。正式可下载版本以 npm latest 和 GitHub Release 为准。升级后需停止并重新启动 dsh，再刷新浏览器页面。

0.2.16 候选包补漏 #64/#67：字数精简重试耗尽后保稿时，length_out_of_range/length_warning 标记与校验问题现在随草稿产物持久化（Core 5.8.7），导出/审阅侧可追溯。正式可下载版本以 npm latest 和 GitHub Release 为准。升级后需停止并重新启动 dsh，再刷新浏览器页面。

0.2.15 候选包修复 #63/#66（Windows 残留 project.lock 永久阻断写作，报错 [WinError 87]；Core 5.8.6 自动清理死进程残留锁并带上下文报错）、#64/#67（continuous_write 单章失败即整队终止、max_failures 失效、字数超限丢弃初稿；现在按容错上限续跑并保留超长稿）、#68（横评进行中详情接口恒 400）和 #69（推理模型评审输出预算被锁死 4096 导致评审全灭）。正式可下载版本以 npm latest 和 GitHub Release 为准。升级后需停止并重新启动 dsh，使桥接服务端加载新代码，再刷新浏览器页面。

0.2.14 候选包修复 #60 和 #61：系统代理下 NO_PROXY 含 [::1] 不再让所有模型连接测试误报"服务商拒绝了请求"（桥接层消毒 + Core 5.8.5 归类为本地配置错误）；Embedding 连接测试的依赖预热、硬超时与收尾兜底，加上桥接层的健康探活与 stderr 落盘，不再出现"后端活着但不服务、只能重启 dsh"的僵尸态。正式可下载版本以 npm latest 和 GitHub Release 为准。升级后需停止并重新启动 dsh，使桥接服务端加载新代码，再刷新浏览器页面。

0.2.13 修复 #57 的创作页刷新循环：批注与版本读取不再作为写操作通知刷新，Core 的只读请求也不再增加工作区变更序号。正式可下载版本以 npm latest 和 GitHub Release 为准。升级后需停止并重新启动 dsh，使桥接服务端加载新代码，再刷新浏览器页面。

0.2.12 进一步修复 #50、#51、#52 的预设注册、导航、工作台挂载和 DoG 接口。连续审读按内容修订刷新，避免轮询闪烁（#54）。

0.2.11 修复 #45，适配精确宿主版本 0.2.0-rc.2：工作台兼容新的 turn-tail list 槽位，DoG 调试面板使用新的 sessionStatus；根包和所有子包的兼容声明同步更新。已验证 0.2.0-rc.2 的 Web 客户端启动、OpenWrite 入口、DoG 面板及其他插件共存；Windows Electron 桌面端恢复链路尚未实机复测。

dsh-openwrite@0.2.10 不包含这项修复，请升级到 0.2.21 的 GitHub Release 包。 不要通过给旧子包授权来代替升级：dsh-openwrite 的版本豁免不会覆盖 @dsh-novel/studio-panel@<ver> 和 @dsh-external/dsh-dog@<ver>，而旧客户端在 0.2.0-rc.2 上激活失败可能触发桌面端的 profile 恢复。

若已发生恢复，先关闭桌面端并备份当前 profile，再从自己的 cordis.patch.yml.bak-* 备份恢复 patch，同时恢复原 package.json 的 dsh.profile.bundles 列表。安装包和作品目录通常仍在；不要用出厂模板覆盖其他插件配置。详细排查见 安装指南。

开始使用

• 执行 dsh web，打开它给出的浏览器地址，点击侧栏 OpenWrite。等待环境就绪后，选择作品目录。
• 入口自动建立 OpenWrite 创作 会话；点击 创作 即可打开工作台，无需先发消息。对话模型在 dsh 中配置；小说生成与评审模型在「任务 → 模型」配置。
• 和 Agent 讨论题材、人物与大纲，确认后再开始写章。已有旧稿可通过「任务 → 导入与导出」接入。

日常操作	入口
看进度、继续写作	/progress、/write-next
审稿、修改选段	/review-chapter、/revise-span
查伏笔、设定与写法记忆	/foreshadow、/canon、/learn
导出成稿	/export-book 或「任务 → 导入与导出」

已有会话不会自动切换预设。详细操作与工作区规则见 使用流程。

界面语言：面板已内置中文与英文词典，跟随 dsh 语言设置。切换方法：Settings → General → Language → English（选择后存为 locale.preference）。Agent 的 persona 和所有技能入口要求用作者的对话语言回复；运行环境与任务状态提供英文，Studio 报错附带英文说明和稳定错误码。已有作品内容不会自动翻译，正文按作者指定的语言生成。

配置模型

安装和环境健康检查不需要模型 API Key，也不会调用写作模型。与 Agent 对话、生成章节和审稿需要可用的模型配置；使用收费服务商时会产生 API 费用。

• 对话模型：在 dsh 宿主中配置，用于 OpenWrite 创作会话。
• 小说生成、评审与测试模型：在「任务 → 模型」添加服务商，按服务商提供的信息填写模型名、接口地址和 API Key。不要把密钥粘贴到对话、作品正文或 Git 仓库。
• 作品目录：选择自己的本地目录；后端端口与 Python 环境由插件管理，无需手动配置。

旧开发安装的全局模型配置不会自动迁入受管理环境，迁移步骤见 安装指南。模型连通性测试可能实际调用服务商，应与不调用模型的环境健康检查区分。

示例：从大纲开始一部新小说

打开 OpenWrite，选择一个空的作品目录并完成初始化，然后进入 OpenWrite 创作 会话。可发送：

请先帮我规划一部短篇悬疑小说：主角是一位修复旧照片的摄影师。
先提出人物、核心谜题和五章大纲，等我确认后再生成正文。

确认大纲后使用 /write-next 开始写章，在「创作」中编辑正文或添加选区批注；使用 /review-chapter 审稿，在应用修订前查看差异。生成与评审会使用前面配置的模型。成稿通过 /export-book 或「任务 → 导入与导出」导出。

功能

工作环节	可以做什么
规划与资料	在同一创作会话中整理灵感、人物、世界观、分层大纲与伏笔，维护作品设定。
正文创作	章节导航、连续审读、正文编辑、选区批注与着色、内部状态/关系标记、自动保存、版本保护与场景结构管理。
审稿与修订	六域评审、问题定位、修订差异和复评；通过 DAG 查看流程、依赖及证据。
模型测试	测章节写作或指定范围的大纲设计，多模型独立生成与交叉评审，查看质量、可靠性和费用；候选保存在隔离副本。
研究与检索	检索作品资料与参考库，管理研究报告、正典和写作记忆。
导入与成书	旧稿导入、作品迁移、完整备份，以及 Markdown / TXT / EPUB 导出。

「创作 / 资料 / 任务」是三个主要工作台。OpenWrite Studio 在本版本中作为领域后端运行，日常操作在 dsh 中完成。

文档与开发

文档	内容
安装指南	Agent 安装步骤、手动安装、模型配置、升级和排错
使用流程	Workspace、规划、写章、审稿、修订、导入导出
模型测试	章节选择、大纲范围、任务 DAG 和结果解读
审稿 DAG	标准评审框架与证据结构
工程说明	组件职责、维护命令、调研和改进记录
维护手册 · 架构设计	版本、插件契约、安装维护和跨仓库职责

packages/openwrite-bridge/   小说工具与后端桥接
packages/studio-panel/       dsh 原生工作台
presets/openwrite/          OpenWrite 创作预设与技能
scripts/                   安装、启动、检查与 DoG 适配
conductor/                 连续写章、评审与修订编排

开发检查：npm run check:plugin；跨仓库契约检查：npm run check。 小说核心位于同仓库的 native-core 分支，与本分支分别维护。工程进度与验证记录保留在 GOAL.md。

许可与来源

项目采用 Apache-2.0。oh-story-* 技能和随包编辑器保留各自目录中的原有许可证。 Logo 基于 OpenWrite native-core 分支，已调整深浅主题配色；基于 DeepSeek Harness，图谱集成使用 dsh-dog。

生态目录：dsh-TUI · 社区插件市场。OpenWrite 当前面向 DeepSeek Harness 的 web profile，使用 dsh web 打开创作工作台；尚未验证 dsh-TUI 界面兼容性。

Language / 语言

In dsh, choose Settings → General → Language → English (locale.preference). The OpenWrite panel follows the host language. The writing agent and slash-command help follow your conversation language; manuscripts, outlines and assets retain their existing language. You can say “Please write and review this novel in English.” The bundled Chinese skill files are procedural instructions, not an output-language restriction. Runtime setup messages use English. Backend failures include stable code, English message, request_id, and the original diagnostic text.

在 dsh 的 设置 → 通用 → 语言 → English 切换面板语言。Agent 的回复和命令帮助跟随 当前对话语言；正文与资产遵循作品已有语言，除非作者要求翻译。

任务恢复、编辑确认及审稿职责范围见 可靠性修复说明。