前言¶
DSH 的插件化路線把擴展能力拆成可安裝、可註冊的獨立單元。對日常使用 DSH Web 端的人來說，常見需求並不是單條回答能力，而是同一臺機器上的多個會話如何共享同一組設置：自定義說明、本機長期記憶、回覆語氣，是否都要在每次會話裏重新說明。
dsh-personalize 面向這個問題。它把全局自定義指令、本地長期記憶和回覆語氣預設集中到本機設置中，並應用於本機所有對話。
插件定位¶
dsh-personalize 是一個 DSH Web 插件，由 Zephyr-vibe 維護，採用 MIT 許可證。它用於在當前 DSH 環境中統一維護本機個性化設置，減少在每個會話中重複輸入相同偏好。
該插件運行需要 Node >= 20。它只使用官方公開服務 webServer、tools、systemPrompt，無需修改 DSH 核心。DSH 強調插件化擴展，社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。
核心能力¶
自定義指令¶
自定義指令是一段用戶手寫的說明，會注入每個會話的系統提示。適合放置長期穩定的偏好說明。
本地長期記憶¶
本地長期記憶支持兩種添加方式：
- 手動添加
- 讓智能體自動收集
智能體自動收集時可使用工具：
memory_create
memory_list
memory_delete
記憶條目會注入每個會話的系統提示，並持久化保存在 {DSH_HOME}/personalize/。刪除前需要確認，不會靜默移除。
記憶上限可配置，默認 50，範圍 1–1000。
回覆語氣預設¶
回覆語氣預設提供以下選項：
- 溫和貼心
- 高效直接
- 嚴謹專業
- 風趣幽默
- 自定義
這些預設用於調整回覆風格，並應用於會話。
界面與入口¶
插件提供中英雙語界面，隨 DSH 語言設置切換。
插件註冊到標準 settings.section 插槽。安裝並重啓 Web 端後，會自動出現在設置中。
安裝與啓用¶
直接安裝¶
先執行以下命令，從 tarball 安裝到 Web profile：
dsh plugin --profile web add https://codeload.github.com/Zephyr-vibe/dsh-personalize/tar.gz/refs/heads/main
如果 pnpm 攔截構建腳本，在命令末尾加 --ignore-scripts：
dsh plugin --profile web add https://codeload.github.com/Zephyr-vibe/dsh-personalize/tar.gz/refs/heads/main --ignore-scripts
安裝後重啓 Web 端，即可在「設置」中看到「個性化」入口。
讓 agent 安裝¶
也可以讓 DSH agent 執行安裝。在會話中發送：
幫我把這個項目安裝爲插件：https://github.com/Zephyr-vibe/dsh-personalize
安裝完成後，仍需重啓 Web 端，再進入「設置」查看入口。
文件位置¶
插件零配置，自動解析 DSH_HOME。首次使用時會自動創建以下文件：
{DSH_HOME}/personalize/config.json
{DSH_HOME}/personalize/memory.json
config.json 保存個性化設置，memory.json 保存本地長期記憶。
使用方式¶
設置入口¶
重啓 Web 端後，進入「設置」，找到「個性化」入口。在該入口中維護自定義指令、記憶條目和回覆語氣預設。
Host API¶
插件提供 Host API：
/personalize/api/*
它用於 config 與 memory 操作。該 API 位於瀏覽器信任圍欄內，僅限 loopback + same-origin 訪問。
智能體記憶工具¶
當需要智能體自動收集記憶時，可調用：
memory_create
memory_list
memory_delete
這些工具分別用於創建、查看和刪除記憶條目。刪除前需要確認。
運行與數據注意事項¶
運行期間，插件維護 memory.json 的內存鏡像。外部直接編輯 memory.json 在應用重啓前不會被讀取，並且插件下一次寫入會覆蓋外部編輯。手動編輯後，應重啓 Web 端。
寫操作在客戶端 15 秒後超時。超時請求仍可能在服務端執行，不要立即重試，應先檢查結果。memory.clear 冪等。
如果 memory.json 損壞，插件會將其備份爲：
memory.json.corrupt-<ts>.bak
在文件修復前，所有寫入會被鎖定。
適用場景¶
適合希望在本機 DSH Web 端統一維護自定義指令、長期記憶和回覆語氣的用戶。也適合讓智能體在後續會話中保留少量穩定信息，而不是每次手動重複說明。
由於插件會寫入本機文件，並以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。當前資料明確許可證爲 MIT。
結尾¶
dsh-personalize 的價值在於把本機個性化做成一個可安裝的 DSH Web 插件：自定義指令、本地記憶和回覆語氣預設都能落到會話中，同時把數據保存在本機 {DSH_HOME}/personalize/ 下。
已覈實資料未提供目錄頁 URL。GitHub 倉庫地址爲：
https://github.com/Zephyr-vibe/dsh-personalize
