前言¶
在 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 文件形式存储，适合追求数据掌控和隐私安全的开发者。
