前言¶
在 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；裝好後刷新窗口，點左側枝條圖標即可開始寫枝。
