前言¶
在 DSH 里做剧本、跑团大纲或分支剧情时，常见问题是用通用笔记工具难以表达「枝」与「干」的关系，而独立网页笔记往往又要自己配 API Key、把凭据写进页面或 localStorage。DeepSeek Harness 本身已有模型目录与 ctx.llm，客户端插件可以把 UI 嵌进宿主，同时把对话和总结接到宿主凭据上。枝条笔记（dsh-branch-notes）由社区维护者 Magelovania 发布，目标就是把 coc-notes 那套「一层一列、可拖枝」的编辑体验搬进 Harness：左侧栏多一个枝条图标，点开即整块面板，AI 抽屉与「一键总结」直接走 Harness 内置模型，页面侧不需要 DeepSeek API Key。
这是什么¶
dsh-branch-notes 是 DeepSeek Harness 客户端类插件（分类：客户端）。当前资料中的版本为 0.4.20，许可证 MIT，源码与说明在 GitHub：Magelovania/dsh-branch-notes；社区目录页为 skillhub.cn 上的条目。插件声明的 DSH 兼容范围为 >=0.2.0-rc.1 <0.3.0-0，并面向 web profile 注入客户端运行时。
宿主侧路由前缀为 /api/dsh-branch-notes，插件相关日志与开发开关等落在 ~/.dsh/branch-notes。剧本正文在浏览器 IndexedDB（库名 coc-notes），与 Harness 同一台机器、同一 profile 下持久保存。
核心功能¶
编辑与视图¶
面板提供三种顶栏视图，默认 主干：一层一列的枝条卡片、包络色带、路径高亮；支持 树状 横向画布与 地点 视图（按「地点」类型归拢）。主干视图下可长按约半秒进入拖动模式，把整棵子树换父枝；支持判定卡片的「生成判定三分支」、专注写作、缩放与导出 Markdown 等。快捷键与细节以 README 为准（例如 Tab/Enter 建枝、Ctrl+J 打开 AI 抽屉、Ctrl+K 搜索）。
AI 与总结¶
前端通过 fetch('/api/dsh-branch-notes/chat') 等请求进入插件服务端，再调用 ctx.llm.stream(...)，使用 Harness 当前默认模型或抽屉里手选模型（如资料中提到的 Flash / V4-Pro 等目录项）。/chat、/summarize 采用 OpenAI 兼容流式协议，页面不会保留 apiKey / apiBase / model 等旧字段。顶部「总结」只更新未锁定的条目，生成后自动锁定；AI 抽屉默认可选「大纲 / 全文」两种上下文粒度以控制 token。
对话里打开面板¶
插件注册工具 branch_notes_open。在任意对话中说「打开枝条笔记」或带定位标题时，模型可调用该工具；宿主写命令后客户端轮询并切换到面板（有标题时可跳到对应枝条）。亦可向 /api/dsh-branch-notes/commands 发 JSON，例如 {"note":"","reload":true} 触发面板内重载（改 web/app.html 后开发时常用）。
费用与保存¶
AI 抽屉可显示按剧本统计的调用次数与 tokens（数据来自 Harness 返回的 usage，价目说明见 README）。编辑有 800ms 去抖写 IndexedDB，并支持可配置的定时落盘；关页或切后台也会存一次。
安装与启用¶
安装后需 刷新一次 Harness 窗口（Ctrl+R），左侧竖排图标中会出现枝条入口。
方式一（插件市场，收录后）：在 DSH「插件 → 发现」中搜索「枝条笔记」一键安装。
方式二（命令行，推荐 Release tarball）：
# 版本号以 GitHub Releases 为准；以下为资料中的示例
dsh plugin --profile desktop add https://github.com/Magelovania/dsh-branch-notes/releases/download/v0.4.20/dsh-branch-notes-0.4.20.tgz
# 需本机可访问 github 且允许 git 时也可用：
dsh plugin --profile desktop add github:Magelovania/dsh-branch-notes
npm 包名同为 dsh-branch-notes（dsh plugin --profile desktop add dsh-branch-notes），资料注明 npm 发版可能滞后，若要对齐最新版宜用 tarball 地址。
方式三：本地源码开发见仓库 README 文末「本机开发」。
插件在 dsh 进程权限下运行；安装前宜自行查看源码、许可证与 cordis.patch.yml，确认与当前 Harness 版本匹配。
典型用法¶
- 安装并
Ctrl+R刷新后，点左侧 枝条图标 进入中央面板。 - 在主干视图用
Tab/Enter建下级或同级枝，双击或F2/e改标题与正文；需要 AI 时Ctrl+J打开抽屉，按需切换「大纲 / 全文」上下文。 - 跑团或剧情向：对空白「判定」卡按
Tab或菜单「生成判定三分支…」，生成成功 / 失败 / 孤注一掷三条子枝。 - 在 Harness 对话中说「打开枝条笔记，定位到某标题」，由
branch_notes_open切面板并跳转（标题须与文档中一致）。 - 换机或换浏览器：用设置中的 导出 .json 全量备份 再导入；Markdown 导出默认目录见 Harness 面板说明（资料示例为
文档\枝条笔记导出\<剧本名>\）。
开发调试面板重载（PowerShell 示例，资料原文）：
$b = 'http://127.0.0.1:19387/api/dsh-branch-notes'
[IO.File]::WriteAllText("$env:TEMP\cmd.json", '{"note":"","reload":true}', (New-Object Text.UTF8Encoding($false)))
curl.exe -s -X POST --data-binary "@$env:TEMP\cmd.json" -H "Content-Type: application/json" "$b/commands"
适用场景与注意¶
适合谁：需要在 DSH 内写 分支结构 的剧本、模组大纲、跑团节点与地点梳理，并希望在同一窗口里用 宿主已配置的模型 做对话、总结，而不是在笔记页再填 Key 的用户。
生态说明：DSH 奉行「一切皆插件」；skillhub.cn 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系，本文不等同于官方应用商店推荐。
注意：
- 若依赖「账号通道」类模型（资料中的
deepseek-account），需先在 Harness「设置 → 账号」登录，否则插件会收到未授权类错误，下拉里也会标明原因。 - 笔记与视图状态主要在 本机浏览器存储；敏感剧本请自行备份与导出策略。
- 安装与启用插件等于扩展宿主能力，务必核对仓库版本、兼容区间与源码后再用于生产环境。
结尾¶
dsh-branch-notes 把枝条式剧本编辑嵌进 DeepSeek Harness，并把 AI 接到 ctx.llm，省去在页面里配置 API Key 的一步。入口在目录页 Magelovania/dsh-branch-notes（skillhub） 与仓库 github.com/Magelovania/dsh-branch-notes；装好后刷新窗口，点左侧枝条图标即可开始写枝。
