前言¶

DeepSeek Harness（DSH）的插件生態旨在通過模塊化擴展滿足各類開發與創作需求。在進行長文本創作或智能體文檔管理時，單純依賴對話窗口的上下文窗口往往難以容納完整內容，而將資料與正文混排則容易造成上下文混亂。本地優先的寫作工具是解決這一痛點的常見方案。

dsh-writing-desk 是一款面向 DSH 的本地優先寫作工作臺插件，由 nousag 維護。它將工作區 .dsh-notes/ 目錄下的 Markdown 筆記作爲資料庫，內置卷/章文件管理與正文編輯器，支持在 DSH 界面中直接調用本地資料進行寫作。

插件定位¶

dsh-writing-desk 作爲一個 DSH 插件，旨在提供輕量級的寫作環境。它通過半窗面板呈現，打開後佔據窗口右半邊，讓位給左側的 DSH 對話窗口，實現資料查看與 AI 協作的並行操作。

安裝前需確保已安裝 dsh CLI，並目標 profile 爲 web。

1、使用官方源安裝：

dsh plugin --profile web add dsh-writing-desk

2、本地開發安裝（需使用絕對路徑）：

dsh plugin --profile web add <本目錄絕對路徑>

安裝完成後，需重啓 dsh web 才能生效。卸載命令如下：

dsh plugin --profile web remove dsh-writing-desk

插件主要包含以下功能模塊：

1、卷/章文件管理
正文按「卷 → 章」兩級組織在 <工作區>/寫作/ 目錄下。新建卷會自動生成“第一卷”、“第二卷”等，新建章會自動生成“第一章”、“第二章”等，且每卷獨立重置編號。章節與卷支持點擊 ✎ 重命名。

2、正文編輯器
提供 Markdown 格式化編輯功能，支持字號與字體設置。具備自動保存與手動保存（Ctrl/Cmd+S）能力，並提供實時字數統計與寫作目標打卡。

3、資料預覽與引用
側欄提供資料列表與實時預覽雙欄視圖。支持全文搜索。核心交互爲“選中即引用”：在預覽區選中一段文字，點擊彈出的“添加到正文中”，即可以引用塊形式插入至當前章節光標處。

4、書籍與導出
支持多本書籍獨立保存與管理。提供導出功能，支持 Markdown、TXT、Word、PDF 等格式。

5、數據安全
採用原子寫入機制與自動保存策略，防止因切換或崩潰導致的數據丟失。

1、編輯正文
點擊側邊欄底部的「寫作工作臺」入口，切換到「寫作」標籤。點擊具體的卷或章文件，編輯器加載後，使用 Ctrl/Cmd+S 保存，或等待停頓自動保存。

2、引用資料
在「資料」標籤中查看本地筆記。選中一段文字後，使用鼠標點擊彈出的“添加到正文中”按鈕，文字將以引用塊格式直接插入到當前編輯章節的光標位置。

3、搜索調用
在編輯器下方的“插入資料”搜索框中輸入關鍵詞，可快速查找並調用本地筆記。

插件對文件系統與網絡有明確的權限限制：

1、文件系統權限
僅讀取工作區 .dsh-notes/ 下的資料文件；讀寫工作區 寫作/ 目錄下的卷目錄與 .md 章節文件。

2、網絡權限
僅建立本機迴環 HTTP API，無外部網絡請求與遙測數據發送。

3、憑據管理
不收集或傳輸任何用戶憑據。

dsh-writing-desk 爲 DSH 用戶提供了從資料管理到正文撰寫、再到最終導出的閉環本地工作流。適合需要頻繁查閱本地筆記並利用 AI 進行輔助創作的場景。項目源碼與文檔詳見 GitHub 倉庫。