前言¶
DeepSeek Harness（DSH）使用中，經常遇到 AI 忘記既定人設、每次對話都要重申立場與工作契約、或者反覆詢問是否繼續的情況。whale-persona 把這些需要反覆交代的內容變成一份可配置的文件，隨會話自動加載。
它出廠是空白的，默認不改變任何 AI 行爲，需要什麼寫什麼。與其他方案不同的是，它的長期記憶機制由代碼強制：AI 只能提議，必須經過人工確認纔會生效。
基本信息¶
- 插件名：whale-persona
- 維護者：shenA2024
- 分類：記憶
- 開源協議：MIT
- 核心定位：人設引擎 / DeepSeek Harness 插件
核心功能¶
插件通過配置文件管理 AI 的行爲與狀態，主要能力包括：
- 自稱與稱呼：支持按具體模型分檔指定自稱與對用戶的稱呼。
- 立場與性格：定義 AI 的基本立場與性格正文。
- 形象與語氣：
- 形象：默認關閉，可注入身份與外貌描述。
- 形象卡：支持存儲本人、用戶及第三方卡片（摘要進提示詞，正文留配置）。
- 語氣：默認關閉，僅調整措辭與節奏，不改變結論與證據標準。
- 工作契約：支持逐條可勾選的契約，
on: false即停用。 - 思維鏈語言：僅修改思考過程的語言，不影響最終回覆語言。
- 長期記憶：採用“提議-確認”模式，只有人工確認後記憶纔會入庫。
- 分類路由：支持記憶條目按
kind分類路由到不同文件。 - 注入體積計量：計量提示詞各段字符數，面板與 CLI 可見。
- 條件反射：支持用戶編寫規則，命中後在代碼層注入指令（默認零規則）。
- 零行爲改變：不配置時全爲空，確保裝上插件不改變原有行爲。
安裝與啓用¶
安裝前請確保環境滿足要求：Node.js >= 20，DeepSeek Harness >= 0.1.6-alpha.1。
- 執行安裝命令：
npx -y whale-persona
安裝完成後需重啓 DSH。
- 重啓後，插件默認爲空白配置。在設置面板中新建或編輯
config.json，填入所需的自稱、立場、契約等內容。
典型用法¶
安裝完成後，可以通過腳本查看當前配置的實際注入效果，或管理預設人設。
- 查看注入內容（預覽）：
node scripts/render-preview.mjs --config examples/demo-config. --cwd D:/work/demo
該命令會打印出實際注入提示詞的三段文本。
- 管理預設：
node scripts/presets.mjs list
node scripts/presets.mjs import starter-plus.
node scripts/presets.mjs apply starter-plus
注意事項¶
- 純 ESM：插件使用純 ESM 模塊，無運行時依賴。
- 零聯網：插件不聯網、不執行命令、不讀取工作目錄，安全可控。
- 記憶確認：長期記憶的生效必須經過人工確認，代碼層強制執行，而非單純依賴提示詞約束。
- ZCode 適配器：ZCode 適配器已停止開發。
