前言¶
DeepSeek Harness (DSH) 的插件化架構允許開發者擴展智能體的能力。在本地化個人知識管理和長期記憶方面，MemoKnow 提供了一個輕量級的解決方案。它通過結構化記錄和文檔快照，幫助智能體維持上下文記憶並檢索導入的文檔知識。
MemoKnow 是什麼¶
MemoKnow 是 DeepSeek Harness 的一個本地個人記憶和知識管理插件，由 twoyoung91 維護。它解決智能體如何從聊天記錄中提取持久化事實、以及如何管理個人知識庫的問題。該插件將記錄存儲在 SQLite 中，通過 SHA-256 對原始文檔進行快照，結合 FTS5 全文搜索與可選的 sqlite-vec 語義檢索，並在 DSH 界面內提供管理面板。
安裝與啓用¶
- 從 GitHub Releases 下載對應版本的
.tgz文件（例如dsh-external-dsh-memoknow-0.2.0.tgz）。 - 在命令行執行安裝命令，將其添加到 web profile：
dsh plugin --profile web add C:\path\to\dsh-external-dsh-memoknow-0.2.0.tgz
- 重啓 DSH（如果正在運行），然後打開 Settings → MemoKnow。
核心功能¶
- 記憶審查與導入：在 DSH 設置中提供審查建議的界面，允許檢查證據、編輯建議記憶或批准/駁回。
- 知識庫管理：支持導入文本、Markdown、Word、PDF、CSV 和 Excel 文檔。導入的內容以不可變快照存儲，支持搜索和預覽提取的文本。
- 控制與配置：支持暫停自動學習、設置 token 預算、檢查待處理會話及每日使用情況。
- 檢索能力：默認使用 Local FTS（無需模型）。可選啓用 Local CPU 嵌入（會下載模型）或 OpenAI 兼容的嵌入服務。
- 記憶維護：支持編輯或永久忘記單個記憶記錄。
使用方式¶
- 打開 DSH Settings → MemoKnow，進入知識庫管理頁面。
- 審查記憶：查看建議的記憶列表，檢查其來源會話和證據，決定是否批准。
- 搜索與預覽：在知識庫中搜索已導入的文檔，預覽提取出的文本內容。
- 控制學習：在設置頁面調整學習策略，例如暫停自動記憶、限制 token 使用量，或查看待處理的會話。
注意事項¶
- 非官方組件：這是一個獨立社區插件，並非 DeepSeek Harness 的官方組件。
- 單用戶本地化：專爲一個人的本地 DSH 個人資料設計，不支持多用戶或雲同步。
- 安全存儲：僅存儲 API 密鑰的環境變量名稱，絕不保存密鑰的具體值。
- 數據結構：SQLite 是元數據和生命週期狀態的權威來源，原始文檔快照是不可變的。
- 兼容性限制：嵌入圖像被忽略；不支持舊版 Excel (
.xls)；不支持直接通過github:安裝；不支持xls格式。 - Managed 模式限制：在託管嵌入模式下，設置 API 更新無法覆蓋策略。
數據存儲¶
默認數據根目錄爲 $DSH_HOME/memoknow，當 DSH_HOME 未設置時則爲 ~/.dsh/memoknow。
memoknow.sqlite3
objects/sha256/aa/bb/<full-sha256>[.txt]
models/ # 僅在啓用 Local CPU 嵌入後創建
