dsh-memory-feeder
DSH 的记忆写回插件。每个完成的主会话轮次结束后，它把用户与助手的文本同步写入本地队列，再用该会话的模型抽取长期事实，追加到 Markdown 记忆库的候选区，等你核实后再合并。
v1 只写 agents/dsh/inbox.md，不会直接修改 shared/、projects/ 或 MEMORY.md。
行为
- 只处理顶层会话（跳过
origin: subagent），只在 turn/end 且原因为 completed 时入队。
- 入队是同步追加
.pending.jsonl，所以 dsh headless 一次性运行退出前也不会丢。
- 抽取在插件启动后约 1.5 秒、新轮次入队后约 5 秒、失败后 15 秒重试。
- 每个完成轮次向
agents/dsh/inbox.md 追加一块，带来源会话、工作目录、模型、置信度和原始对话摘录；轮次内抽到的事实按 scope 合并成块。
- 已写过的候选记在
.seen.json，重复运行不会重复写；同一队列条目最多尝试 3 次。
- 抽取以用户亲口说的事实、计划、目标、偏好为主；助手的建议不会被改写成用户计划，助手长解释只在有可复用结论时提取。
- 入队前与写盘前清洗
sk-*、GitHub token、Bearer、私钥和 key: value 形式的凭据。
- 抽取器不读正式记忆，可能提出与已有条目重复的候选；合并时以正式条目为准。
安装
方式 A：从 GitHub 安装（web）
dsh plugin --profile web add github:Ryan-G-Rolling/dsh-memory-feeder
装完重启 DSH web，并硬刷新页面。
默认记忆库是 ~/.dsh/memory（Windows 为 C:\Users\<你>\.dsh\memory），插件会自动创建候选区。要指向已有记忆库，在启动 DSH 的同一个 shell 里设置环境变量：
# Windows PowerShell
$env:DSH_MEMORY_ROOT = 'D:\Projects\memory'
# bash / zsh
export DSH_MEMORY_ROOT="$HOME/memory"
DSH_MEMORY_ROOT 只在 patch 里没有显式 memoryRoot 时生效。headless 用的 profile 不一定是 web；桌面版宿主只读自己的 profile 层，这两种情况按方式 B 手动接。
方式 B：手动 patch（桌面版 / 自定义路径）
DSH 分两层：
~/.dsh/cordis.patch.yml：给 web 和 headless 用。~/.dsh/profiles/desktop/cordis.patch.yml：给桌面版用。桌面宿主只读 profile 层，不读 home 层，所以桌面版必须单独 insert；桌面 profile 由 Electron 独占，不能用 dsh plugin --profile desktop 安装。
把下面的 insert 块追加到对应 patch 文件。name 用插件 index.js 的绝对路径（见 cordis.patch.example.yml）：
- insert:
- id: dsh-memory-feeder
name: '<PLUGIN_DIR>/index.js'
config:
memoryRoot: '<MEMORY_ROOT>'
inboxSubdir: agents/dsh
debounceMs: 5000
maxItems: 5
minConfidence: 0.6
两处可以共用同一个队列和 .seen.json，不会重复写同一条记忆。改完桌面 patch 后重启桌面版。
同一个层不要装两次，否则同一轮会入队两次。
配置项
| 键 | 默认值 | 说明 |
|---|
memoryRoot | DSH_MEMORY_ROOT 或 ~/.dsh/memory | 记忆库根目录 |
inboxSubdir | agents/dsh | 候选区相对路径，写入其中的 inbox.md |
debounceMs | 5000 | 新轮次入队后延迟多久抽取 |
startupDelayMs | 1500 | 启动后处理遗留队列的延迟 |
retryDelayMs | 15000 | 失败或队列未清空时的重试间隔 |
maxPerRun | 5 | 每次最多处理几条队列记录 |
maxQueueAttempts | 3 | 单条记录最多尝试次数 |
maxItems | 5 | 每轮最多保留几条候选 |
minConfidence | 0.6 | 低于该置信度的提取结果丢弃 |
minTurnChars | 30 | 用户加助手文本低于该长度不入队 |
maxTranscriptChars | 16000 | 入队文本上限，用户约占 40% |
maxSeenEntries | 2000 | 去重哈希保留条数 |
provider / model | 空 | 留空时用该会话 request/header 的路由 |
queuePath / seenPath / logPath | 插件目录 | 队列、去重表和日志位置 |
路径都建议用绝对路径。Windows 下 YAML 单引号里的反斜杠不需要转义，写成正斜杠也可以。
本地测试
复制 test.patch.example.yml，替换其中的 <PLUGIN_DIR> 与 <MEMORY_ROOT>，然后：
dsh headless --patch "<PLUGIN_DIR>/test.patch.example.yml" "随便完成一轮对话"
测试 patch 把候选区指到 agents/dsh/_feeder_test。headless 通常在入队后立刻退出，异步抽取可能来不及跑；再执行一次同样的命令，启动时就会处理上一条队列记录。
跑完清理：
rm -rf "<MEMORY_ROOT>/agents/dsh/_feeder_test"
rm -f "<PLUGIN_DIR>/.pending.test.jsonl" "<PLUGIN_DIR>/.seen.test.json" "<PLUGIN_DIR>/.feeder.test.log"
日志与排错
- 日志同时写 stderr 和插件目录的
.feeder.log，前缀 [dsh-memory-feeder]；stderr 不污染 headless 的 stdout。
- 启动日志
ready (memoryRoot=...) 会打印实际使用的路径；路径不对时改 memoryRoot 或 DSH_MEMORY_ROOT。
- 入队日志是
queued turn ...；抽取成功是 extracted N item(s) 和 appended ...。
- 卡在
skip turn: no provider/model 时，在配置里显式指定 provider 和 model。
安全边界
- 队列和日志里会有对话原文，按敏感文件对待，不要提交到公开仓库。仓库自带的
.gitignore 已忽略这些文件。
- 不写 API key、token、密码、登录态；敏感信息只放环境变量。
- 写入前会清洗常见凭据格式，但清洗是兜底，不是保证。不要把密钥粘进对话。
- 记忆库如果同步到远端，
inbox.md 里的候选和对话摘录也会一起同步，按需选择私有备份。
限制
- 只处理顶层会话；子代理的对话不入队。
- 依赖 DSH 的
llm 服务和会话 request/header 里的 provider/model。
- 候选不会自动合并、去重到正式条目；需要人或其他 agent 定期清理。
- 默认只写
~/.dsh/memory；要接入已有记忆库，必须显式配置路径。
- 在 Windows 的 DSH 桌面版、web 和 headless 上验证过；其他平台未实测。
License
MIT
