前言¶

在 DSH 插件生態裏，寫作類任務通常不只依賴瀏覽器側界面，還需要 host 側數據服務和寫作引擎配合。對智能體開發者來說，如果項目目錄、書庫、檢索結果、設定與人物演化分散在不同入口，查看和定位成本會比較高。

dsh-client-ui-writing 是一個 Web 客戶端插件，由 x2802490130-prog 維護，許可證爲 MIT。它當前 package.json 版本爲 0.6.2，在 DeepSeek Harness 的寫作預設會話中提供側邊欄寫作面板和會話內全書索引視圖。

這個插件本身不直接生成正文。它的職責是讀取數據、展示信息、觸發編排；重活由 host 側引擎完成。

定位與邊界¶

這個插件的定位比較明確：

• 面向 DSH 客戶端寫作場景。
• 提供側邊欄寫作面板。
• 提供會話內全書索引視圖。
• 支持項目、書庫、搜索、演化四類信息查看。
• 支持觸發 novel_sync 等編排動作。
• 只在寫作預設會話中顯示。

它的運行邊界也很清楚：

• 面板只讀數據並觸發編排。
• 不直接生成正文。
• 生成、檢索、書庫、編排等重活由 host 側完成。
• host 側需要安裝 dsh-writing-remote，並且該鏈路依賴 dsh-tool-writing。
• 寫作引擎使用獨立的 DSH_WRITING_API_KEY。

模式門控條件如下：

agentPreset === "writing"

也就是說，只有寫作預設會話會顯示面板與索引視圖，其他會話中隱藏。

核心功能¶

側邊欄寫作面板¶

側邊欄寫作面板包含四個 tab：項目、書庫、搜索、演化。

項目¶

項目 tab 用於查看當前寫作項目結構，包括：

• 分卷/章節目錄。
• 字數、狀態、摘要。
• 全書統計。
• 情節日誌尾部預覽。
• 空項目初始化入口。

空項目可以一鍵初始化寫作工程，對應動作是：

scaffoldNow

書庫¶

書庫 tab 用於展示飼料區中的小說信息，包括：

• 書名。
• 作者。
• 分類。
• 章數。
• 字數。

如果書庫爲空，面板會提示使用導入動作：

novel_library_import

搜索¶

搜索 tab 提供項目與書庫聯合全文檢索。

命中後可以直接定位到對應章節。這個入口適合查找人名、設定、情節等分散在項目和書庫中的內容。

演化¶

演化 tab 用於查看設定和人物演化信息，包括：

• 設定/人物演化版本鏈。
• 內聯 diff。
• SVG 線索圖譜。

如果演化信息爲空，面板會提示先登記：

novel_sync
novel_threads

章末編排¶

面板提供章末編排入口，可以一鍵觸發：

novel_sync

該動作包含：

• 章節摘要。
• 設定抽取。
• 演化檢測。
• 伏筆提醒。

會話內全書索引視圖¶

在寫作預設會話中，除了側邊欄面板，還提供會話內全書索引視圖。

這個視圖用於快速查看和定位當前書：

• 分卷目錄。
• 字數、狀態、摘要。
• 快速定位。
• 章節預覽。
• 打開原文。

操作方式包括：

• 用數字直達第 N 章。
• 用 /、Ctrl+/ 或 Alt+K 聚焦搜索框。
• 用 ↑↓ 選擇。
• 用 Enter 預覽。
• 用 Esc 關閉。
• 觸摸或拖拽左右滑動切換模塊。

安裝與啓用¶

安裝前先確認 host 側依賴已經就緒：

dsh-writing-remote
dsh-tool-writing

其中 dsh-writing-remote 是 host 側數據通道，dsh-tool-writing 是 host 側寫作引擎依賴。寫作引擎使用獨立的 API key：

DSH_WRITING_API_KEY

安裝 dsh-client-ui-writing 可以使用 DSH 插件命令：

dsh plugin --profile web add dsh-client-ui-writing

也可以使用 npm 安裝：

npm install dsh-client-ui-writing

該插件的 peerDependencies 如下：

{
  "react": "^18.2.0",
  "@deepseek-ai/cordis": "^4.0.1",
  "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
  "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6"
}

官方包走 peer，不內嵌這些依賴。

典型用法¶

下面是幾個比較直接的使用路徑。

空項目初始化¶

如果當前項目還沒有寫作工程結構，可以先在面板中使用：

scaffoldNow

這一步用於初始化寫作工程，方便後續繼續管理分卷、章節和摘要。

導入書庫¶

如果書庫爲空，可以使用：

novel_library_import

導入後，書庫 tab 會展示書名、作者、分類、章數、字數等信息。

章末同步¶

完成一章內容後，可以觸發：

novel_sync

該動作會執行章節摘要、設定抽取、演化檢測、伏筆提醒。

登記演化線索¶

如果演化 tab 還沒有數據，可以先運行：

novel_sync
novel_threads

完成登記後，再查看版本鏈、內聯 diff 和 SVG 線索圖譜。

會話內快速定位¶

在寫作預設會話裏，可以直接用數字跳轉到章節：

12

也可以用快捷鍵聚焦搜索框：

/
Ctrl+/
Alt+K

選中條目後，用 Enter 預覽，用 Esc 關閉。

適用場景與注意¶

適合這類使用方式：

• 你已經在 DSH 中維護寫作項目。
• 你需要在瀏覽器側查看項目目錄、書庫、搜索和演化。
• 你需要在會話內快速定位章節、預覽章節、打開原文。
• 你需要一個只負責查看和觸發編排的客戶端入口。
• 重活希望交給 host 側 dsh-writing-remote 和 dsh-tool-writing 處理。

需要注意幾點：

• 該插件以當前 dsh 進程權限運行。
• 安裝前應檢查源碼與許可證。
• 它不直接生成正文。
• 它依賴 host 側寫作鏈路。
• 它只在 agentPreset === "writing" 的會話中顯示。
• 當前許可證爲 MIT。

鏈接¶

GitHub 倉庫：

https://github.com/x2802490130-prog/dsh-client-ui-writing

插件目錄頁（如所在目錄站收錄該插件）：

https://www.skillhub.cn/plugins/x2802490130-prog/dsh-client-ui-writing