DSH 每次開啓新對話,AI 都會重置狀態,不再記得你習慣的交互方式。如果需要 AI 在每個新會話中都遵循特定的指令(例如:優先確認目標、先講原理再給代碼、或是要求每完成一步就自動備份),就需要手動調整系統提示詞。這種方式重複且容易遺漏。
dsh-user-style 是一個用於管理用戶工作風格檔案的插件。它將你的偏好轉化爲可編輯的配置,並在每次提示詞組裝前注入系統提示詞。通過懸浮面板和三層作用域機制,你可以讓 AI 在所有對話中保持一致的行爲模式。
核心功能¶
- 懸浮面板:右下角提供一枚可拖動的小藥丸,點擊即可快速切換檔案和作用範圍,無需進入深層設置。
- 三層作用域:支持全局默認、按工作區綁定(針對特定目錄)、以及僅當前會話臨時覆蓋。上層配置會覆蓋下層配置。
- 四套內置預設:提供「嚴謹審慎」、「快速直接」、「節點備份」、「教學講解」四種預設,可根據實際場景選擇。
- AI 協議修改:通過
user_style工具,AI 可以主動提議修改風格,但必須經你確認後纔會寫入。 - 默認不啓用:插件安裝後不會自動生效,需要手動開啓。
- 零外部依賴:不依賴宿主側的第三方庫,確保在任意環境下都能加載。
安裝與啓用¶
安裝此插件後,必須完全退出並重啓 DeepSeek Harness 才能生效。宿主側不支持熱更新。
方式一:使用 DSH CLI(推薦)¶
在側邊欄點擊「插件」→「安裝」,輸入倉庫地址:
github:himoew/dsh-user-style
方式二:使用一鍵腳本¶
克隆倉庫並運行安裝腳本:
git clone https://github.com/himoew/dsh-user-style.git
cd dsh-user-style
install.bat
腳本會自動處理依賴安裝、創建 Junction(目錄聯接)以及備份 package.json。
方式三:手動安裝¶
在 <DSH_HOME>\profiles\desktop\ 目錄下:
# 1. 創建指向倉庫的目錄聯接
New-Item -ItemType Junction -Path ".\node_modules\dsh-user-style" -Target "<本倉庫絕對路徑>"
# 2. 編輯 package.json
# 在 dependencies 中添加 "dsh-user-style": "link:<本倉庫路徑>"
# 並將 "dsh-user-style" 追加至 dsh.profile.bundles 數組
安裝完成後,在插件列表中找到 dsh-user-style 並將其狀態切換爲「運行」。
使用方法¶
懸浮面板操作¶
右下角的懸浮面板顯示當前狀態:
- 藍點:已啓用;灰點:未啓用
- 顯示當前生效的檔案名和作用範圍
- 可拖動:位置會自動保存;拖到屏幕邊緣會自動隱藏,拖回恢復
點擊面板後,你可以:
1. 選擇預設檔案。
2. 選擇作用範圍(全局 / 僅本會話 / 應用到此工作區)。
3. 選擇後立即生效,下一條消息將攜帶新的系統提示詞。
三層作用域邏輯¶
生效優先級從高到低:
1. 僅本會話:臨時覆蓋當前對話。
2. 工作區綁定:針對特定項目目錄生效。
3. 全局默認:默認基礎風格。
工作區匹配採用「最長前綴 + 路徑邊界」規則。例如,將 D:\proj 綁定爲 A 檔,那麼 D:\proj\inner 也會使用 A 檔,而 D:\proj-other 則不會被誤匹配。
內置預設說明¶
內置預設通過逐條原樣注入系統提示詞來定義行爲:
| 預設名稱 | 核心行爲 |
|---|---|
| 嚴謹審慎 | 目標不清晰時不動手;不確定/歧義時不假設;改代碼/文件前先確認。 |
| 快速直接 | 有成熟方案直接用;不自檢;可用就實測;結束時總結原因與步驟。 |
| 節點備份 | 每跑通一個功能就主動備份;按節點分點彙報;半成品不算節點。 |
| 教學講解 | 先講原理後結論;先給最小可運行示例;解釋「爲什麼」。 |
讓 AI 修改風格¶
插件註冊了 user_style 工具。你可以直接告訴 AI 你希望的風格,例如「以後回答都先給結論」。
AI 會複述確認,只有在你確認後,它纔會通過工具寫入新的檔案。這避免了 AI 誤改配置。
數據位置與維護¶
所有配置與記錄存儲在以下位置:
<DSH_HOME>\dsh-user-style\store.json # 檔案與各級綁定關係
<DSH_HOME>\dsh-user-style\trace.jsonl # 最近 40 次提示詞組裝留痕
<DSH_HOME>\dsh-user-style\last-render.txt # 最近一次注入的文本內容
升級插件不會修改 store.json。升級只會刷新未編輯過的內置預設,你自定義的檔案和綁定關係會保留。
卸載¶
運行卸載腳本:
uninstall.bat
腳本會清理鏈接和配置清單中的記錄,但不會刪除 store.json。若要徹底刪除,需手動刪除整個 <DSH_HOME>\dsh-user-style\ 目錄。
技術約束與注意事項¶
- 腳本編碼:
scripts/*.ps1必須保存爲 UTF-8 with BOM。Windows PowerShell 5.1 若讀取無 BOM 的文件,中文內容會變成亂碼。 - 工具參數:註冊工具時參數必須是標準 JSON Schema。屬性級的
required: true(defineTool的寫法)會導致服務商報錯,必須使用數組格式required: ['action']。 - 宿主依賴:插件刻意不依賴
@deepseek-ai/*等外部包,以確保通過 Junction 方式安裝時能正常加載。 - DSH 版本:插件要求
dsh.engines.dsh: ">=0.2.0-rc.1 <0.2.1-0"。
結語¶
dsh-user-style 通過結構化的系統提示詞注入,解決了多會話場景下 AI 風格不一致的問題。默認禁用的設計保證了它不會影響現有對話,僅在需要時生效。配合懸浮面板和作用域管理,它是一個輕量且高效的協作工具。