Claude-DSH-Memory
把 Claude Code 的项目记忆目录（MEMORY.md + 主题 .md 文件）直接复用给 DeepSeek Harness（DSH）会话的原生 Cordis 插件。
同一个项目，Claude Code 和 DSH 读同一份记忆：在 DSH 里聊出来的结论会落回 Claude 下次能读到的文件，反过来也一样。
它做什么
| 能力 | 行为 |
|---|
| 会话开始注入 | 每个主会话开始时注入一次 MEMORY.md 索引与维护约定 |
| 8 个工具 | claude_memory_status / index / manifest / search / read / write / forget / repair_index |
| 写保护 | DSH 内用 write/edit 等工具直接改记忆目录会被拒绝，必须走 claude_memory_*；读取不受限 |
| 显式意图提醒 | 用户说"记住/忘掉"时追加一行操作指引（默认开启） |
| 后台提取 | 回合结束后可选地用当前模型补录记忆（默认开启，只补录、不删除、不阻塞回合） |
安装
在 DSH 里用 Plugin Manager 安装本目录（bundle 形态，Host-only）：
plugin_manager install_bundle target="D:\work\Claude-DSH-Memory"
安装后对当前 profile 全量生效。首次安装通过 HMR 即可激活；替换已安装的包需要重启。
工具一览
| 工具 | 作用 |
|---|
claude_memory_status | 解析到的记忆目录、是否已核对、条目/类型统计、提取与保护计数、告警 |
claude_memory_index | 读 MEMORY.md（受注入预算限制） |
claude_memory_manifest | 列出所有条目元数据，标出 indexed:false 的孤儿条目 |
claude_memory_search | 词法检索，任一关键词命中即可（OR） |
claude_memory_read | 读完整正文 + revision（更新/删除前必须先读） |
claude_memory_write | create / update / upsert，同步维护索引 |
claude_memory_forget | 移入私有 trash/，从索引移除；不真删 |
claude_memory_repair_index | 对齐索引与磁盘（默认 dryRun） |
冲突检测：revision = sha256(文件字节)。update/forget 必须带 expected_revision，不匹配即报 CM_REVISION_MISMATCH，不自动合并。
配置
cordis.patch.yml 里的 config 全部可选，默认值即可工作：
- insert:
- id: claude-dsh-memory
name: 'claude-dsh-memory'
config:
projectMemoryDirs:
'D:/work/demo-app': 'C:/Users/you/.claude/projects/D--work-demo-app/memory'
createMissing: true
autoExtract: true
extract:
provider: deepseek
model: deepseek-chat
| 字段 | 默认 | 说明 |
|---|
claudeConfigDir | $CLAUDE_CONFIG_DIR 或 ~/.claude | Claude 配置根 |
projectMemoryDirs | {} | 项目路径 → 记忆目录；最可靠的方式 |
createMissing | true | 记忆目录不存在时允许写工具创建（读永远不创建） |
injectBaseline | true | 会话开始注入索引 |
indexMaxLines / indexMaxChars | 200 / 12000 | 索引注入预算 |
injectMaxChars | 16000 | 整条注入的硬上限 |
intentReminder | pre-step | pre-step | claimed | off |
guardEnabled | true | DSH 内写保护 |
autoExtract | true | 回合结束后后台提取 |
extract.provider / .model | 空 | 空则用当前默认模型路由 |
extract.timeoutMs | 120000 | 单次提取超时 |
extract.maxOperations | 10 | 单批最多 10 个操作（≤10） |
extract.excludeProjects | [] | 不做提取的项目路径前缀 |
stateRoot | <DSH_HOME>/claude-memory | 插件私有状态（不能落在记忆目录内） |
lockTimeoutMs / lockStaleMs | 5000 / 30000 | 目录锁 |
logLevel | info | silent | error | info | debug |
记忆目录怎么定位
顺序（首个成功即用）：
projectMemoryDirs 里最长的路径前缀匹配- Git 仓库根（
git rev-parse --git-common-dir 的父目录）再匹配一次
- 仓库内
.claude/settings*.json 有 autoMemoryDirectory → 拒绝猜测，要求显式映射（CM_DIR_NEEDS_MAPPING）
- 用户级
~/.claude/settings.json 的 autoMemoryDirectory
- 环境变量
CLAUDE_CODE_PROJECT_DIR_NAME
- slug 推断：
<claudeConfigDir>/projects/<非字母数字→->/memory，标记 confirmed:false
例：D:\work\demo-app → D--work-demo-app。
推断出来的目录会在 status 和注入里注明"尚未在 Claude Code 中核对"。最省事的做法是显式配置 projectMemoryDirs。
保护语义（重要）
- 被拦的是工具路径：任何非只读工具的参数里出现记忆目录下的路径（含相对路径）都会被拒绝，覆盖
write、edit、apply_patch 以及未来的写类工具。
- shell 只能提示性拦截：命令文本里出现记忆目录会被拒绝，但字符串拼接、编码、子进程、其它插件直调
ctx.fs 都能绕过。这不是安全边界，只是防误操作。
- Claude Code 自己不受影响：它不在 DSH 里，也不经过这些工具。两边同时写靠"目录锁 + revision + 发布前整目录指纹"检测，检测到就以报错结束，不自动合并。
后台提取
回合正常结束（completed）后，若满足资格，插件把"本轮用户消息（≤12k）+ 助手最终消息（≤20k）+ 记忆元数据 manifest"发给当前模型，要求返回最多 10 个 create/update 操作：
- 禁止 delete（schema 层就不接受）
- 校验不过 → 整批丢弃，材料进
<stateRoot>/projects/<key>/review/
- 发布前比对整目录指纹，期间目录变了 → 整批放弃（
CM_EXTRACT_STALE），不重放
- 全局并发 1、不重试、输入无变化时零模型调用
隐私：这一步会把上述对话内容发送到当前配置的 provider。介意就把 autoExtract 设为 false。日志只记文件名与错误码，不记正文。
状态目录
插件的私有状态（队列、备份、回收站、日志）在 <DSH_HOME>/claude-memory，可用 stateRoot 改位置。
开发
node --test "test/*.test.js" # 82 个单测，纯 node:test，无依赖
许可
Apache-2.0，见 LICENSE 与 NOTICE。
