前言¶

在 DeepSeek Harness（DSH）裏寫長提示或任務說明時，常見做法是手動複製目錄結構、再另開一輪對話讓模型幫忙改稿；角色設定則往往散落在本地 Markdown 裏，插入輸入框還要自己切窗口。若希望這些動作留在當前會話、且儘量少註冊額外模型工具，@jayyuen66/dsh-dir-prep-organize 把「潤色」和「模板」做成輸入框右側的兩個控件，由宿主已有的 LLM 與設置服務完成重寫與插入。

下面介紹該插件的定位、能力邊界，以及安裝與典型用法。事實以 GitHub 倉庫 與 npm 包 @jayyuen66/dsh-dir-prep-organize（當前版本 0.1.8）說明爲準。

這是什麼¶

dsh-dir-prep-organize 是維護者 JayYuen666 發佈的 DSH 插件：在 Web 對話輸入框右側增加可拆分的「潤色」按鈕和「模板」下拉。潤色會把草稿、會話工作目錄頂層（文件名、大小及關鍵文本文件全文）與會話內真實的 user/assistant 輪次交給當前會話選定的模型（取不到時回落宿主默認模型）重寫；模板則在光標處插入角色正文，不重建整份草稿。插件不註冊模型工具，也不自建 HTTP 路由，數據面走宿主 Typert Remote 命名空間 dirPrepOrganize。

核心功能¶

潤色¶

主鍵點擊後直接潤色；▾ 子菜單可選擇「以某個角色的風格潤色」（只借用術語與語氣，不執行該角色任務）。成功時用重寫結果替換輸入框草稿；失敗時不修改草稿，按鈕約 4 秒錯誤態，原因在 tooltip。寫回有條件：會話 id、草稿版本與輸入階段（plain）均與發起請求時一致，否則結果丟棄並提示「輸入框內容已變化，潤色結果未寫回」。默認超時 organizeTimeoutMs 爲 120000 ms，經宿主 llm.stream 調用；finish reason 非 stop 視爲失敗。

模板¶

下拉按條目 group 分組，空 group 歸入「通用」。內置 85 條精選角色模板，由 scripts/gen-defaults.mjs 從包內 agents/ 角色庫生成（上游爲 agency-agents-zh，MIT）；列表在宿主側，瀏覽器首次打開菜單或進入設置卡時懶加載 Remote 方法 defaults。插入經輸入框版本校驗的插入面，引用塊與附件保持原樣；提交過程中兩個控件禁用。

設置卡「角色庫」¶

同一份模板列表同時驅動「模板」下拉與「潤色」▾ 角色菜單。支持增刪改、兩步恢復默認、一鍵導入整套內置庫、按路徑導入本地 .md 或目錄，以及登記 importAllowRoots 額外允許導入根。改動在設置頁先進入草稿，點保存後生效；持久化在 dsh 數據目錄的 settings.yaml，命名空間條目 id 爲 dir-prep-organize。

安裝與啓用¶

安裝命令（Web profile）：

dsh plugin --profile web add @jayyuen66/dsh-dir-prep-organize

卸載：

dsh plugin --profile web remove @jayyuen66/dsh-dir-prep-organize

包發佈在公共 npm，無需憑據。要求 Node.js >= 22.12（ESM 包，具名導出，無 default export）。宿主 dsh 兼容性由包內 engines.dsh（^0.2.1-rc.3）判定；README 記載發佈時在 0.2.1-rc.3 至 0.2.2-alpha.2 窗口內逐版驗證，窗口會隨宿主發佈滾動，被拒版本需按文檔使用 allow-version 顯式擔責。

安裝後通過 dsh.bundle.patch 注入層 dir-prep-organize；客戶端半在 conversation.input.right 註冊控件，並在 plugins.bundle.config 以包名 @jayyuen66/dsh-dir-prep-organize 掛載設置卡。

確認是否生效可按 README 建議：

1. 輸入框右側應出現「潤色」與「模板」。若未出現，可用 dsh --profile web --dump-config 查看層棧是否含 dir-prep-organize（該命令會改寫 profile 根裝配文件，判讀時需同時看 stdout 與 stderr）。
2. 打開「模板」，應經 defaults 加載內置列表；加載中顯示 loading 行。
3. 按潤色主鍵，成功則替換草稿，失敗則草稿不變。
4. 設置頁出現「角色庫」小節，保存後改動生效。

典型用法¶

1. 在輸入框寫好草稿，確認會話 cwd 指向當前項目目錄。
2. 需要直接改稿時點「潤色」主鍵；需要特定行文風格時打開 ▾，選角色後再潤色。
3. 需要插入角色設定時，光標定位到插入點，在「模板」下拉選條目，文本寫入光標處。
4. 自定義模板或導入本地角色：打開插件設置卡「角色庫」，編輯或填寫路徑導入；未登記 importAllowRoots 時，導入路徑通常須在會話 cwd 或內置 agents/ 內（設置卡導入請求無會話上下文，sessionId 爲空串）。

潤色時，目錄列表、對話與角色正文整份送入模型，插件不會替你截斷；上下文溢出或 body 超限（413）需自行收窄輸入。關鍵文件摘要僅覆蓋 README 列出的擴展名白名單，且會跳過名稱命中敏感詞邊界的文件；詳見倉庫「數據與隱私」一節。

高級部署項（設置卡無控件）包括 maxSnippetBytes（默認 262144）、readConcurrency（默認 8），需經 settings.yaml 或條目 config: 修改。

適用場景與注意¶

適合經常在 DSH Web 裏寫提示、並希望結合當前會話目錄與同會話模型做一次性改稿，或快速插入 curated 角色模板的開發者。插件不提供 CLI、不讀環境變量、不註冊 organize_text 一類工具；潤色與摘要讀取仍依賴宿主會話、Agent、文件系統與 LLM 服務。

DSH 生態主張「一切皆插件」；SkillHub 目錄頁 爲社區收錄，與 DeepSeek / 幻方無官方從屬關係。安裝前請自行審閱 源碼與 MIT 許可證，並記住插件以當前 dsh 進程權限運行：潤色會把草稿、目錄條目、關鍵文件全文及真實對話輪次發往所選模型提供商。

結尾¶

dsh-dir-prep-organize 把目錄上下文潤色與角色模板插入收攏到輸入框旁，Settings 與 Remote RPC 分工明確，且不擴展模型工具面。需要細節、FAQ 與 Remote 方法表時，見倉庫 README.zh-CN.md。

• 目錄頁：https://www.skillhub.cn/plugins/JayYuen666/dsh-dir-prep-organize
• GitHub：https://github.com/JayYuen666/dsh-dir-prep-organize