前言¶
在 DeepSeek Harness（DSH）裏做角色扮演或伴侶型對話，常見問題是：人設寫在系統提示裏越堆越長，模型仍會忘劇情；把整段聊天記錄每輪塞進上下文，既費 token，也不利於區分「設定」和「發生過的事」。社區插件 companion-memory（維護者 Root-7-KHX）把人格文檔、好感度、活躍記憶和按日期歸檔的知識庫放在本地，並按對話隔離；新對話默認不注入，需要時在側邊欄一鍵開啓。本文介紹其定位、能力與安裝啓用方式，事實以倉庫 README 與 SkillHub 目錄頁 爲準。DSH 生態強調「一切皆插件」；SkillHub 是社區目錄，與 DeepSeek / 幻方無官方從屬關係。
這是什麼¶
companion-memory 是 DSH 的「記憶」類插件（npm 包名 @local/companion-memory，當前版本 1.2.1，許可證 MIT，要求 Node ≥ 22）。官方簡介概括爲：per-conversation persona docs、favorability tracking、recent 48h transcript search and a date-archived local knowledge base——即每個對話獨立的人格配置、好感度追蹤、最近約 48 小時（按「聊天時間」計）的對話檢索，以及本地日期歸檔知識庫。
數據默認落在 $DSH_HOME/companion-memory（若無則回退 ~/.dsh/companion-memory），不上傳遠端服務器。
核心功能¶
下面按 Host 側行爲與面板能力概括，不展開 QQ 接入的全部細節（倉庫「最近更新」中有 AI 主動冒泡、QQ 網關、聲紋認人等說明，需要時可讀 README）。
按對話隔離與默認關閉¶
每個已開啓的對話各自擁有 角色性格.md、允許&禁止行爲.md、預設發言例句.md，以及好感度、活躍記憶、知識庫文件。關閉某對話的伴侶記憶只停止向模型注入，不刪除已有數據。未開啓的對話不受插件影響。
人格文檔與權重¶
「配置」頁在三份 Markdown 中按固定字段填空；保存後下一輪對話即按新設定生效，優先級高於記憶。條目可設 1~100 權重（默認 50），注入時按權重排序。默認允許 AI 在劇情需要或用戶明確要求時小步修改「角色性格」與「預設發言例句」（須寫理由並歸檔）；「允許&禁止行爲」默認僅用戶可改。可通過 profile 補丁關閉 AI 改文檔：
- id: companion-memory
config:
aiEditDocs: false
或分項控制 personality / examples / rules（見 README）。
記憶、好感度與自我演化¶
「記憶」頁維護全局活躍記憶（重信息原文不改寫，約 30 個聊天交互日後可歸檔進知識庫）、角色對當前說話人的好感度（-100~100，多人對話按人分開；滿 ±100 後加深部分記入羈絆值）、以及 AI 自我演化四類條目（性格細節 / 喜歡 / 討厭 / 習慣）。模型通過 Host 提供的 companion_memory 工具在每輪結束時記錄重點、更新好感度，並可用 evolve 等動作；系統提示詞末尾會提醒先調用 turn_end。若模型漏調，默認 passiveTurnEnd 會用旁路補記，避免統計斷檔。
兩段式檢索與知識庫¶
| 時間範圍 | 數據位置 | 工具動作 |
|---|---|---|
| 最近 2 個聊天日 | recent.json |
search_recent / read_recent |
| 更早 | archive/、monthly/、packs/ |
search_kb / read_archive |
「聊天時間」指真正發生過有效對話的自然日；沒聊天的日子不計入 48 小時額度與交互日。知識庫另有 48 小時歸納、每 30 交互日月度打包、以及按輪數或 token 閾值的自動打包；上下文接近模型窗口時會壓縮較早對話爲記憶塊寫入 packs/，長聊可繼續。
面板與覈對¶
側邊欄「伴侶記憶」含配置、情緒、記憶、知識庫、狀態、總覽、備份、接入軟件等頁面；會話標籤欄另有隻讀速覽。總覽頁列出注入給模型的各塊內容及完整系統提示詞，便於覈對。備份頁可導出/導入 JSON 記憶包。
說話方式¶
默認注入簡短、口語化的回覆約束（約 1~3 句），可在 profile 中調整：
- id: companion-memory
config:
replyStyle:
mode: brief
maxSentences: 3
mode 可選 brief / normal / detailed / off。
安裝與啓用¶
先到 GitHub Releases 複製最新資產直鏈（常用 local-companion-memory-<版本>.tgz，或整包 companion-memory-<版本>.zip）。在 DSH 插件市場選「從鏈接安裝」填入直鏈，或使用命令行（版本號以 Releases 頁附件名爲準）：
dsh plugin add <Release 資產直鏈，例如 .../releases/download/v1.1.x/local-companion-memory-1.1.x.tgz>
也可下載 zip 解壓後，在插件管理器中通過 install_bundle 指向解壓目錄（README 方式二、三）。安裝後刷新 Web GUI，側邊欄應出現「伴侶記憶」。若側邊欄無入口，README 常見問題提到檢查 package.json 是否爲 UTF-8 無 BOM。
啓用步驟：
- 打開「伴侶記憶」面板，在「當前對話」欄確認會話；
- 點擊「開啓本對話」；
- 在「配置」頁填寫三份角色文檔；
- 正常聊天；需要時用「總覽」覈對注入內容，用「知識庫」或直接向 AI 提問以回憶更早內容。
SkillHub 亦提供「請安裝 DSH 插件 Root-7-KHX/companion-memory」的說明，可與上述 Releases 直鏈方式配合使用。
典型用法¶
倉庫 README「使用」一節的可復現流程與上一節一致，補充幾點：
- 多人同一會話時，AI 可區分說話人並分開記好感度，劇情記憶共享。
- 導入備份 JSON 時可選合併或覆蓋；導入後可選自動回顧原文提煉活躍記憶。
- 外部軟件接入：在數據根目錄
integrations/放置清單 JSON，在「接入軟件」頁刷新；實際橋接由對應軟件實現（例如調用POST /companion/api/memory/add），詳見倉庫docs/接入軟件.md。
適用場景與注意¶
適合：需要在 DSH 中長期角色扮演、希望人設可編輯且與對話記憶分離、並要在本地檢索歷史與歸檔的開發者或玩家。
注意：
- 插件以當前 DSH 進程權限讀寫本地目錄；安裝前應閱讀 源碼 與 MIT 許可證，自行評估是否滿足環境與合規要求。
- 卸載或升級插件不會刪除
~/.dsh/companion-memory（或$DSH_HOME下對應目錄）中的會話數據；刪除某會話記憶需手動刪sessions/<對話 id>/，刪前建議先導出備份。 - GitHub 公開星標約爲社區關注度參考（目錄線索爲 2 stars），不代表官方背書。
結尾¶
companion-memory 把人格配置、好感度、熱緩存與歸檔知識庫收進 DSH 側邊欄，並按對話開關與隔離，減輕「忘設定」和「上下文塞滿歷史」兩類問題。進一步瞭解可訪問 SkillHub 目錄頁 與 GitHub 倉庫 的 README、截圖與 Releases。
