deepseek-harness-memory
Claude Code 风格长期记忆插件（dsh 版）：跨会话持久记忆，会话启动自动注入。
- 存储：纯 markdown 记忆文件 +
MEMORY.md索引 + YAML frontmatter，与 Claude Code 格式 1:1 兼容（可直接读取/导入~/.claude下的既有记忆）。 - 自动注入：每次 prompt 组装时，用户级 + 当前工作区级的记忆索引出现在系统提示词中（
MEMORY.md前 200 行 / 25KB + 最新 200 个记忆文件，与 Claude Code 计量一致）。 - 工具：
memory（add / update / delete / list / read / import-claude）。
存储布局
~/.dsh/memory/ # 用户级记忆
├── MEMORY.md # 索引（一行一条：- [标题](文件.md) — 描述）
└── <name>.md # 记忆文件（frontmatter + 正文）
~/.dsh/memory/projects/<key>/ # 工作区级记忆
├── MEMORY.md
└── <name>.md<key>由工作区路径变换得到（: \ _→-），与 Claude Code 的~/.claude/projects/<key>/memory/一一对应，例如C:\work\my-project→C--work-my-project。- 记忆文件格式：
---
name: <记忆名>
description: <一行描述——用于将来判断相关性>
type: <feedback | reference | project>
modified: <ISO 时间戳，自动维护>
---
<事实；feedback/project 型按「事实 + **Why:** + **How to apply:**」结构>记忆纪律（写入系统提示词，引导模型）
- 保存：用户明确要求记住、给出偏好/修正、或学到将来有用的事实（构建命令、调试洞见、约定、外部系统位置）。
- 不保存：代码模式/结构（可从项目读取）、git 历史、调试解法、AGENTS.md 已记录内容、临时任务细节；绝不保存 API 密钥/密码。
- 验证：记忆里提到的具体文件/函数在推荐前先确认其仍存在（记忆是写入时的快照）。
配置（cordis.patch.yml 覆盖 memory 行的 config）
| 键 | 默认 | 说明 |
|---|---|---|
memoryRoot | ~/.dsh/memory | 记忆根目录 |
scope | auto | auto（有工作区用 workspace，否则 user）/ user / workspace |
maxIndexLines | 200 | 注入的 MEMORY.md 行数上限 |
maxIndexBytes | 25000 | 注入的 MEMORY.md 字节上限 |
maxList | 200 | 注入/列出的记忆文件数上限 |
includeInPrompt | true | 是否注入系统提示词 |
importClaudeMemory | true | list/注入时若 dsh 侧为空，回退只读 Claude Code 同 key 目录 |
projectAliases | {} | 路径 key → 统一 key 的映射（见下） |
projectAliases：同一项目的多 checkout 归一
Claude Code 按工作区路径切分记忆，同一项目（不同分支/多个 checkout）的记忆会散落在多个目录。projectAliases 把这些路径 key 映射到一个统一 key，使记忆属于项目而非路径——在任何 checkout 里工作，读写同一份记忆：
projectAliases:
C--work-my-project-a: my-project
C--work-my-project-b: my-project新增 checkout 时，把它的路径 key 加一行映射即可。别名配置应写在 profile 的 cordis.patch.yml 覆盖层（该行 config 为整行替换，需同时重述其他字段）。
安装 / 升级 / 回滚
# 前置：安装 pnpm（dsh plugin 依赖）
npm install -g pnpm
# 安装（在本插件目录执行；dsh.bundle 声明会自动加入 profile bundles 层）
dsh plugin --profile web add .
# 升级（重新修改代码后）
dsh plugin --profile web update deepseek-harness-memory
# 回滚（记忆文件保留不删）
dsh plugin --profile web remove deepseek-harness-memory重启 dsh web 后生效。无 pnpm 的兜底：把 deepseek-harness-memory 目录复制到 ~/.dsh/profiles/node_modules/deepseek-harness-memory/，并在 ~/.dsh/profiles/web/cordis.patch.yml 追加：
- insert:
- id: memory
name: 'deepseek-harness-memory'迁移 Claude Code 记忆
两个途径：
1. 自动回退：importClaudeMemory: true（默认）时，若 dsh 侧无记忆，注入会回退读取 ~/.claude/projects/<同key>/memory/ 与 ~/.claude/memory/（只读，不改原文件）。 2. 正式导入：对模型说「用 memory 工具 import-claude 导入记忆」，或让模型调用 memory action=import-claude——把 Claude Code 既有记忆复制到 ~/.dsh/memory/（原文件不动）。
开发
插件本体为纯 ESM JS（零运行时依赖，仅 node:fs/path/crypto），lib/index.js 依赖 @deepseek-ai/dsh-tools 与 @deepseek-ai/schemastery（从 profile 的 node_modules 解析）。
已知限制
- 无自动记忆提取（Claude Code 的 turn-end 记忆子代理）：模型按系统提示词纪律主动 add/update，与用户明确要求「记住」时等效。
- 无
/memory、/toggle-memory命令（dsh 无对等命令体系）。 - 记忆明文存储，勿存密钥/PII。