dsh-novel-studio
DeepSeek Harness AI 小说工作室：主对话驱动 AI、阅读器式右栏、手动编辑和可恢复版本历史。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Voyage-He/dsh-novel-studio#f4c1f8a9bfd447492af8e87f3ed191f9290c2a4fNovel Studio 以 dsh-novel-studio 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →把 DeepSeek Harness（DSH）的 Web UI 变成一个“对话在中间、小说在右边”的 AI 小说工作室。
它不是把聊天框换个皮肤，而是建立一套可落盘、可追踪、可恢复的创作工程。全书提纲、章节提纲、场景、人物与正文是并列可修改的资料层，没有强制的写作顺序。AI 与作者使用同一份结构化资料，所有写入都会形成版本。
upsert_volume / delete_volume 维护分卷。阅读器顶部持续显示已写字数与目标字数的完成进度。novel_project_read 和 novel_project_write 两个 DSH 工具。模型会先读最新工程，再把结果写回，而不是只把草稿留在聊天回复中。novel/ 目录，不同 workspace 互不干扰。novel/ 目录结构。已初始化的 workspace 会被自动识别并直接加载，也可以在主对话里让 AI 调用 init_project 完成初始化。.git、.gitignore、.DS_Store 外没有任何条目，等待初始化），或目录里已经是有效的小说工程（novel/project.json 与版本历史齐备）。已被其它项目占用的目录（存在 package.json、源码等，或只有内容不明的 novel/ 目录）不会注入入口；目录不可读、状态未知或请求失败时同样不显示，宁可少显示也不错显示。如果确实要在已占用的目录里写小说，可在主对话让 AI 执行 init_project 显式初始化，之后入口会自动出现。在右栏点击“初始化小说工程”（或由 AI 调用 init_project）后创建：
<workspace>/novel/
├── project.json # 当前结构化小说工程，格式化文本，适合 Git diff
└── .history/
├── index.json # 当前 head 与版本摘要
└── revisions/<hash>.json # 可恢复的不可变快照
project.json 是当前状态的唯一工作副本，可以和普通源码一起交给 Git 管理；.history 是插件自己的细粒度恢复层。若只想使用 Git 历史，可在项目自己的 .gitignore 中忽略 novel/.history/。
本地开发目录安装：
npx @deepseek-ai/dsh plugin --profile web add \
dsh-novel-studio@file:/绝对路径/到/novel-plugin
然后使用同一 profile 启动：
npx @deepseek-ai/dsh --profile web
在 DSH 中选择一个 workspace，创建或打开非空会话。会话标题右侧会出现 小说 按钮，点击后打开右侧栏：尚未初始化的 workspace 会显示初始化按钮，点击后创建小说工程；已初始化的 workspace 会自动识别并加载内容。面板按官方右侧栏（ui-sidebar-right）的 tab 机制注册——小说作为一个 tab 类型出现，点击入口即打开该 tab 并同步展开栏目，也可以从右侧栏的“＋”向导页里选择“小说工程”打开；关闭使用面板标题栏的关闭按钮或右侧栏自身的收起控件。对于尚未发送任何消息的空白会话（例如刚选定一个空目录工作区），DSH 会隐藏会话标题栏且右侧栏放不下，此时 小说 按钮出现在输入框上方的常驻行，点击后以右侧浮层打开本面板；发送第一条消息后按钮回到会话标题右侧，并改用官方右侧栏。
移除插件：
npx @deepseek-ai/dsh plugin --profile web remove dsh-novel-studio
id 调用 upsert_character 更新；写入完成后只反馈本次修改总结（条目、版本号、字数变化），具体内容保存在右栏与工程文件中。“放置”只保存人物 id，不复制人物卡内容；因此人物设定或世界知识更新后，下一次生成会自动使用最新资料。放置模式也不要求预先填写章节细纲。
包的 patch.yml 默认配置：
config:
projectDirectory: novel
historyLimit: 300
projectDirectory 必须是 workspace 内的相对路径，不能越出 workspace。historyLimit 范围为 10–1000。用户可以在 profile 的 cordis.patch.yml 中按插件行 id 覆盖配置。DSH 的 patch 会替换整行 config，覆盖时请重述两个字段。
实现遵守官方插件约定：
apply、Schemastery Config 和依赖 inject；资源注册绑定 Cordis 生命周期。dsh.bundle.patch 贡献组合层，通过 dsh.client 暴露浏览器 bundle。ctx.tools.register() 注册官方的原始 ToolDefinition 形状，包含 JSON Schema 参数、规范输出、参数校验与模型可见渲染。@deepseek-ai/dsh-tools 作为运行时依赖安装到 profile；ToolRuntime、调度器与工具管线始终由 DSH 宿主提供，避免两份服务包的私有标识不一致。ctx.slots.inject 等待槽位声明；入口注册到 additive 的 conversation.session.header.utilities，小说面板以更低 priority 显式 shadow 官方 single details 槽位。参考：
当前按 @deepseek-ai/dsh 0.1.0-rc.7 的官方公开契约、Tool 执行流水线与客户端 slot 实现开发。DSH 官方明确仍处于 Developer Preview，未来可能有破坏性变更。
本插件会 shadow 默认工具详情右栏：启用后，点击聊天中的工具行仍会打开右栏，但显示小说工作室而非官方工具详情。关闭或卸载插件后，官方详情面板自动恢复。
npm install
npm run check
npm test
npm run pack:check