前言¶
在 DSH 裏做智能體時，常見的問題之一是：會話可以處理日誌、人物畫像和產品資料，但這些內容如果沒有統一入口，就仍會散落在本地文本中，檢索和複用都要繞回外部工具。
dsh-plugin-jinji 是一個 DeepSeek Harness（DSH）插件。它在網頁界面的左側欄新增「記憶」入口，讓日誌和人物/產品畫像可以直接在 DSH 裏瀏覽。插件定位爲極簡文本記憶系統，無需安裝其他軟件，無需編譯，無第三方依賴。
這是什麼¶
dsh-plugin-jinji 提供雙軌記憶：一軌是流水日誌，一軌是人物/產品實體畫像。組織和維護以大模型爲核心驅動。倉庫地址爲 https://github.com/quan2005/dsh-plugin-jinji，許可證爲 MIT，package.json 中的 author 寫作 dsh-plugin-jinji Contributors。
核心功能¶
下面按使用路徑說明已確認的功能。
入口與瀏覽¶
- 左側欄新增「記憶」按鈕。
- 日誌頁按月份分組，展示卡片瀑布流。
- 畫像頁按「本人 / 產品 / 所在團隊」分組。
- 詳情視圖可顯示排版正文或原始文本，並展示當月日誌列表。
檢索與操作¶
- 支持按標題、摘要、標籤即時搜索過濾日誌與畫像。
- 支持鍵盤操作：↑/↓ 高亮、Enter 打開、Esc 分級退出。
會話與寫入¶
- 新會話啓動時自動注入最近日誌與全部畫像摘要。
- 如需關閉啓動注入，可設置：
config.startupContext: false
- 可選一鍵安裝「謹跡祕書」Agent 預設，以主動書寫記憶。
配置與性能¶
- 「設置 → 插件配置」中有「謹跡記憶」卡片，可可視化調整日誌/畫像條數與摘要上限。
- 使用索引文件指紋緩存與漸進渲染，大庫瀏覽不卡。
- 跟隨官方深色主題；窄屏 ≤960px 自動切單列。
- 內容做轉義和路徑校驗，只讀不改。
安裝與啓用¶
先確認環境滿足 Node >=20。
使用插件命令安裝：
dsh plugin --profile web add github:quan2005/dsh-plugin-jinji
然後重啓 dsh web。
也可以使用 npm 安裝：
npm install dsh-plugin-jinji
然後在該 profile 的 cordis.yml 裏以 npm 包方式掛載本插件。
插件找日誌庫的順序如下：
1、配置文件中的 root
2、環境變量 DSH_JINJI_ROOT
3、dsh 啓動時所在目錄
典型用法¶
經過上面的安裝，可以先在左側欄點擊「記憶」，查看日誌和畫像。
日常使用時，可先做搜索，再用鍵盤定位：
- 用搜索框按標題、摘要、標籤過濾。
- 用 ↑/↓ 高亮條目。
- 用 Enter 打開詳情。
- 用 Esc 分級退出。
需要調整上下文注入範圍時，在「設置 → 插件配置 → 謹跡記憶」卡片中調整日誌/畫像條數、摘要字節上限。配置保存在記憶根目錄的 .jinji-memory.json，無需重啓，新會話生效；兩個 DSH 會話並行保存配置不會互相覆蓋。
如果希望某個會話主動書寫記憶，可在「謹跡記憶」卡片中一鍵安裝「謹跡祕書」Agent 預設，然後在新建會話時選用該預設。
開發驗證時可用：
npm run check
檢查代碼語法。
npm run smoke
用模擬環境跑一遍自檢。
npm run pack
預覽發佈包裏會包含哪些文件。
適用場景與注意¶
適合需要在 DSH 中瀏覽日誌、畫像，並在新會話中複用這些摘要的人。它把「記憶」入口直接放在 DSH 網頁界面裏，減少在 DSH 之外反覆切換工具。
使用前需要注意：插件以當前 dsh 進程權限運行，安裝前建議檢查源碼和 MIT 許可證，確認滿足本地安全要求。插件聲明爲只讀不改，內容均做轉義和路徑校驗；如果日誌庫或畫像內容來自敏感數據，仍應按本地數據合規要求處理。
參考¶
- GitHub：
https://github.com/quan2005/dsh-plugin-jinji - 社區目錄頁（插件線索，非官方應用商店；本次資料未獨立確認）：
https://www.skillhub.cn/plugins/quan2005/dsh-plugin-jinji
