前言¶
在 DeepSeek Harness（DSH）裏接 AstrBot、Cline、Continue、iShellPro 等客戶端時，常見情況是：每個客戶端各自寫 system prompt，對話記憶也不互通——在聊天機器人裏聊過的偏好，換到 IDE 插件裏往往要從頭再說一遍。
dsh-persona-gateway 把「人格 + 長期記憶」放到本機網關層：客戶端只需改 base URL 和二級 Key，同一套人格與記憶可以跟着你在不同工具之間複用。下面介紹它的定位、能力與安裝用法；事實以倉庫 README 與 package.json 爲準。
這是什麼¶
dsh-persona-gateway 是 DSH 社區插件（維護者 1292858901），在 SkillHub 分類爲「工作流」。插件在本機起一個 OpenAI 兼容（及部分 Anthropic 兼容）端點，上游默認指向 DeepSeek API；人格與記憶狀態集中在 ~/.dsh/persona/ 目錄，便於備份與遷移。
當前 package 版本爲 0.8.0，許可證 MIT，運行環境要求 DSH 0.2.0 及以上。
核心功能¶
人格¶
人格以穩定前綴形式疊加在客戶端自帶 system prompt 之前，不覆蓋客戶端原有提示詞。內容來自 ~/.dsh/persona/persona.md，可在 DSH 設置面板中維護。
記憶¶
- 存儲：
~/.dsh/persona/memory.jsonl，一行一條，便於 diff。 - 注入：每輪按相關性選取最多 4 條、合計 900 字符以內，避免整庫塞進上下文。
- 抽取：對話結束後由 AI 判斷是否值得寫入；默認開啓「自動記憶」，關閉後不再抽取。
- 節流：一分鐘內最多抽取一次；寒暄與過短回答會跳過。
- 上限：默認 300 條；超出時觸發 AI 壓縮，仍超則淘汰最舊條目；面板提供「壓縮」按鈕合併重複、刪除過時項（置頂條目不參與壓縮）。
- 導入導出：支持 JSON 包、裸數組或原始 jsonl，自動去重。
檢索方式爲關鍵詞打分（中文二元組 + 英文詞），不依賴 embedding。
網關與安全¶
- 客戶端使用面板生成的二級 Key（
sk-l2-…，只顯示一次）；庫內僅存 SHA-256 哈希，面板僅展示前綴與尾號。 - 官方 DeepSeek API Key 寫在本地
config.json（權限 0600），用於網關調用api.deepseek.com；不能用 DSH 登錄憑證代替，否則上游會 401。 - 控制面路徑
/persona-gw/*僅允許本機迴環訪問；非迴環請求會被拒絕。
安裝與啓用¶
需要已安裝 DSH 0.2.0+。README 推薦僅通過 git 方式安裝，勿對同一 profile 用 install_bundle 指向本地目錄（易引發 pnpm ERR_PNPM_EPERM；若已踩坑見倉庫 TROUBLESHOOTING.md）。
安裝命令（與插件市場按鈕一致）：
dsh plugin --profile desktop add github:1292858901/dsh-persona-gateway
裝好後在 DSH 打開 設置 → 人格網關（「插件」頁同一張卡片進入同一面板）。
典型用法¶
- 填官方 Key：在面板填寫 DeepSeek API Key，點「測試連通性」確認可用。
- 創建二級 Key：生成供客戶端使用的
sk-l2-…，妥善保存（只顯示一次）。 - 改客戶端配置：
- Base URL：面板上的「客戶端地址」，例如http://192.168.0.58:8787/v1
- API Key：上一步的二級 Key
- 模型：persona（推薦，走網關配置的模型） - 驗證：客戶端發一句話，在面板日誌中查看是否出現類似
request … 注入 N 條記憶的記錄。
網關配置項（面板）¶
| 項 | 說明 |
|---|---|
| 客戶端地址 | 留空則按監聽地址自動生成；走反代或隧道時填對外地址 |
| 監聽地址 | 127.0.0.1 僅本機；0.0.0.0 允許局域網（需放行防火牆端口） |
| 端口 | 默認 8787，改動後即時重啓監聽 |
| 上游地址 | 默認 https://api.deepseek.com/v1 |
| 記憶上限 | 默認 300 條 |
| 自動記憶 | 關閉後不再抽取新記憶 |
Anthropic 協議客戶端¶
Claude Code 等走 Anthropic Messages 的客戶端可透傳到 DeepSeek Anthropic 兼容端點。示例（將地址與 Token 換成你的值；ANTHROPIC_BASE_URL 結尾不要加 /v1）：
export ANTHROPIC_BASE_URL=http://192.168.0.58:8787
export ANTHROPIC_AUTH_TOKEN=sk-l2-...
人格注入 system，記憶注入最後一條 user 消息。
適用場景與注意¶
適合誰：需要在多個 OpenAI 兼容（或部分 Anthropic 兼容）客戶端之間共享同一套人格與長期記憶、且願意在本機跑一層網關的 DSH 用戶。
數據與隱私：記憶爲明文，可能含服務器地址等敏感信息，導出或分享前請自行檢查。記憶不能跨設備自動同步，遷移靠導出/導入或拷貝 ~/.dsh/persona/ 目錄。
已知限制（摘自 README）：Anthropic 側僅從 text_delta 收集文本用於記憶抽取，tool_use 原樣透傳不參與；檢索非語義向量，相關性依賴關鍵詞規則。
運行權限：插件隨當前 DSH 進程與用戶權限運行，可訪問本機配置與記憶文件。安裝前建議在 GitHub 閱讀源碼與 MIT 許可證，確認符合你的安全策略。
DSH 生態理念是「一切皆插件」；SkillHub 目錄頁 爲社區站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-persona-gateway 把人格與長期記憶從各客戶端裏抽到網關層，換 base URL 即可在多工具間複用同一狀態。進一步瞭解與安裝：
- 目錄頁：https://www.skillhub.cn/plugins/1292858901/dsh-persona-gateway
- 源碼與文檔：https://github.com/1292858901/dsh-persona-gateway
