前言¶
在 DSH 插件生態中，dsh-memoryleak 專注於解決智能體開發與使用中的記憶與上下文管理問題。它不依賴外部服務，而是將筆記、待辦事項和知識沉澱存儲爲本地 Markdown 文件。所有數據都在用戶指定的 Vault 文件夾中，方便直接用 Git 管理或編輯器查看。
核心功能¶
該插件提供了一套完整的本地化記憶管理方案：
- 本地 Markdown 文件存儲：所有數據以純文本形式存儲，與 Git 和任何編輯器兼容。
- /ml 命令記錄流水賬：快速記錄日常想法或日誌。
- /ml todo 待辦管理：支持 deadline（截止日）、sleep（喚醒日）、anytime（隨時）三種類型及 urgent/medium/low 三種優先級。
- /ml note 對話沉澱爲知識庫：將當前對話整理爲工作記錄和知識文件。
- /ml ask 從 Vault 檢索知識：基於本地知識庫回答問題。
- /ml mail 增量閱讀郵件：讀取工作郵箱並提取待辦事項，原文不落 Vault。
- /ml view 模糊文件打開：快速打開 Vault 中的任意文件。
- 右側 Dock 記事面板：提供常駐工作臺。
安裝與啓用¶
使用官方安裝命令進行安裝：
dsh plugin --profile web add github:warmwine/dsh-memoryleak
安裝完成後，重啓 DSH Web 即可生效。使用 /ml help 查看全部命令。
典型用法¶
1. 記錄流水賬¶
直接輸入 /ml 加上你想記錄的內容，它會自動寫入當天的日誌文件。
/ml 明天找財務對一下發票
2. 管理待辦事項¶
使用 /ml todo add 添加待辦，支持三種類型：
* d / 1：deadline（必須填日期）
* s / 2：sleep（設定喚醒日期）
* a / 3：anytime（不填日期）
/ml todo add 交季度報告
3. 沉澱對話爲知識¶
在一段工作對話結束後，執行 /ml note。插件會將這段對話交給當前模型進行整理，生成工作記錄和知識文件（存放在 MOMENTO 目錄下）。
/ml note
4. 檢索本地知識¶
直接向智能體提問，它會從 Vault 中檢索相關知識進行回答。
/ml ask 生產主庫的端口是多少？
5. 增量閱讀郵件¶
配置好 IMAP 賬號後，使用 /ml mail read 只讀上次讀取之後的新郵件。郵件原文僅存於系統臨時目錄，分析結果寫入 Vault。
/ml mail read
6. 模糊打開文件¶
使用 /ml view 加上文件名的一部分，系統會列出候選文件供選擇打開。
/ml view
注意事項¶
- 隱私警示：在共享工作區使用需謹慎，防止被蒸餾。
- 命令規範：
/ml note後面不要跟文字，跟在後面的內容不會發送給助手。 - 只讀操作：
/ml ask和/ml mail是隻讀操作，不會修改 Vault 中的文件。 - 安全存儲：郵件原文只進系統臨時目錄；憑證存儲在本地
settings.yaml，不在 Vault 中。 - 環境要求：需要 Node.js >= 20。
- 版本：當前版本爲 0.17.0。
總結¶
dsh-memoryleak 提供了一個輕量級、本地化的記憶解決方案。它通過 /ml 命令體系，將流水賬、待辦、知識庫和郵件閱讀整合在一起，所有內容均以 Markdown 文件形式存儲，適合追求數據掌控和隱私安全的開發者。
