前言¶
DSH 的插件生態強調「一切皆插件」,社區目錄是獨立站點,與 DeepSeek / 幻方無官方從屬關係。在寫作類智能體場景裏,常見拆分方式是:host 側引擎負責項目、書庫、檢索與編排;瀏覽器側面板負責展示與操作。兩者之間需要一層協議適配,避免把生成能力和完整寫操作直接暴露給客戶端。
dsh-writing-remote 就是這一層:它把 host 側寫作引擎的數據能力,以 Typert remote 的形式接給客戶端面板使用。
這是什麼¶
dsh-writing-remote 由 x2802490130-prog 維護,是 DSH 寫作三件套中的 host 側數據通道。
它解決的問題是:
dsh-tool-writing引擎跑在 host 側,擁有項目、書庫、檢索和編排能力;dsh-client-ui-writing面板跑在客戶端,需要讀取這些數據並進行展示;- 兩者之間通過 Typert 協議交互,remote 包負責把引擎能力適配成面板可調用的 Remote 方法。
這個包的邊界比較明確:提供只讀數據和編排觸發,所有寫操作仍在 host 側引擎裏完成,不把生成能力暴露給客戶端。
核心功能¶
dsh-writing-remote 暴露的主要是 dsh-tool-writing 引擎中的項目、書庫與檢索數據,並提供少量編排觸發方法。
數據讀取¶
面板可以通過 Remote 方法獲取以下內容:
| 方法 | 面板用途 |
|---|---|
workspaceIndex |
索引視圖、項目 tab |
projectStatus |
項目概覽 |
chaptersList |
章節列表 |
chapterText |
單章正文預覽 |
loreList |
設定瀏覽 |
projectSearch |
項目全文檢索 |
libraryList |
書庫列表 |
librarySearch |
書庫檢索 |
evolutionList |
演化版本鏈 |
threadGraph |
多線敘事線索圖譜數據 |
這些方法面向的是「面板要什麼,remote 就提供什麼」的只讀場景。
編排觸發¶
dsh-writing-remote 還提供兩個觸發類方法:
| 方法 | 用途 |
|---|---|
syncNow |
章末自動編排,包括摘要、抽取、演化和伏筆提醒 |
scaffoldNow |
非破壞式鋪骨架,空目錄可一鍵初始化 |
這裏需要注意:remote 只負責觸發,真正執行仍由 host 側引擎完成。
方法定位¶
所有 Remote 方法都以 projectRoot 爲第一參數定位小說工程。
面板側通常傳入當前工作區作爲 projectRoot,host 側再基於該目錄實例化對應引擎。
安裝與啓用¶
可以使用 DSH 插件方式安裝:
dsh plugin --profile web add dsh-writing-remote
也可以按 npm 包安裝:
npm install dsh-writing-remote
配置項只有 libraryRoot。
libraryRoot
默認值是:
$DSH_HOME/writing-library
這個目錄與引擎共享書庫根,用於指定 dsh-tool-writing 引擎使用的書庫位置。
典型用法¶
下面是一個典型的接入流程。
1、先安裝 remote 包:
dsh plugin --profile web add dsh-writing-remote
2、如需調整書庫位置,配置 libraryRoot:
libraryRoot=$DSH_HOME/writing-library
3、在客戶端面板調用 Remote 方法時,把當前小說工程目錄作爲 projectRoot 傳入。
例如:
- 查看項目索引:調用
workspaceIndex - 查看項目狀態:調用
projectStatus - 查看章節:調用
chaptersList - 預覽單章:調用
chapterText - 瀏覽設定:調用
loreList - 檢索項目內容:調用
projectSearch - 查看書庫:調用
libraryList - 檢索書庫:調用
librarySearch - 查看演化:調用
evolutionList - 查看線索圖:調用
threadGraph - 觸發章末編排:調用
syncNow - 觸發初始化骨架:調用
scaffoldNow
這些調用都依賴 projectRoot 定位具體小說工程,面板傳入的是當前工作區。
適用場景與注意¶
dsh-writing-remote 適合以下場景:
- 已經有
dsh-tool-writing寫作引擎; - 有
dsh-client-ui-writing客戶端面板; - 需要在 Web 面板中查看項目、章節、設定、書庫、檢索、演化和線索圖;
- 希望只把只讀數據和編排觸發暴露給客戶端,寫操作仍留在 host 側。
使用時需要注意:
- 它提供的是 host 側數據通道,不是獨立寫作引擎;
- 只讀數據和編排觸發,生成與寫操作仍在 host 側引擎完成;
- 插件以當前
dsh進程權限運行,安裝前應檢查源碼和許可證; - 許可證爲 MIT;
- 社區插件目錄是獨立站點,不應理解爲官方應用商店。
鏈接¶
GitHub:
https://github.com/x2802490130-prog/dsh-writing-remote
插件目錄線索地址:
https://www.skillhub.cn/plugins/x2802490130-prog/dsh-writing-remote
該目錄頁地址來自插件線索,未在本次已抓取資料中驗證。