SkyKiss9/AI-long-term-memory

AI 长期记忆 — 面向 Codex 与 DeepSeek Harness 的项目连续性

给 Codex 和 DeepSeek Harness (dsh) 的长期项目连续性技能 · 脱敏公开版
A redacted bilingual project-continuity skill for Codex agents and DeepSeek Harness (dsh)

Codex Skill · DeepSeek Harness Plugin · dsh · AGENTS.md · Project Continuity · Long-Term Memory

中文说明

这是一个给 Codex 和 DeepSeek Harness (dsh) 长期项目使用的连续性技能。它解决的不是“怎么写一段交接摘要”，而是“当新对话没有旧上下文时，怎样准确恢复项目目标、演变、用户决定、决定理由、边界、当前状态和下一步”。

这个公开版本已经脱敏，只保留通用方法和通用工具，不包含任何真实项目记录、业务数据、历史对话、账号信息、日志、凭证或私有仓库内容。

它解决什么问题

- 新对话只拿到压缩摘要，项目真实目标、边界和当前状态丢失。
- 助手把自己的建议误当成用户已经确认的决定。
- 接手时不知道哪些路线已经被替代、哪些风险已经被接受、下一步到底该做什么。

它怎么工作

1. 原始材料保留事实，时间线用一两行记录变化和来源，当前交接只作为书签。
2. 普通新对话只读当前交接，然后直接处理用户的工作。
3. 信息不足或冲突时，AI按引用局部回查；不默认加载完整历史。
4. 有实质变化时由AI自动写回，用户不需要管理记忆系统。

日常接续与专项审计

- 日常接续：只读当前交接，必要时局部回查。
- 首次建档、完整历史审计和多轮失真复核：属于专项工作，才读取完整来源。
- 清单里的状态只是历史说明，不能自动把普通对话变成考试。

30秒快速开始（Codex）

1. 把 skills/maintain-project-continuity 放进你的 Codex 技能目录。
2. 在目标项目里登记 .codex/project-continuity.json。
3. 把规则块写进目标项目的 AGENTS.md。
4. 运行校验脚本确认项目记录结构完整。

校验结果使用 output_schema_version: 1，只表示结构检查；不包含记忆、业务或用户体验验收结论。

示例：

python skills/maintain-project-continuity/scripts/install_project.py  --project-name "My Project"
python skills/maintain-project-continuity/scripts/validate_project.py

DeepSeek Harness (dsh) 快速开始

1. 在本仓库目录运行 dsh plugin --profile web add ./dsh-plugin。
2. 运行 node ./dsh-plugin/scripts/install.mjs，把标准 SKILL.md 技能包安装到 dsh 用户技能目录 $DSH_HOME/skills/maintain-project-continuity（默认是 ~/.dsh/skills/maintain-project-continuity）。安装会先暂存完整目录，再整体替换旧版本；如果激活失败，会回滚旧目录，因此旧版本遗留文件不会继续保留。
3. cordis.patch.yml 有意保持为空，因为不需要挂载 Cordis runtime row。
4. 重启 dsh web（或新开会话），接续技能即可在技能列表中使用。

Windows 注意：dsh plugin add 的本地路径不能含空格；如果仓库路径含空格，先把 dsh-plugin 目录复制到无空格路径（例如 C:\dsh-continuity）再执行安装。

清单状态为 registered 时，只表示清单和规则已经安装；只有目标项目存在可用的时间线和当前交接，校验结果才会报告 continuation_ready: true。

这个仓库包含什么

- 通用技能正文
- 通用项目规则块
- 通用模板
- 通用安装脚本
- 通用校验脚本
- 一个脱敏示例清单
- 技能契约测试
- dsh-plugin/：DeepSeek Harness (dsh) 插件包

这个仓库不包含什么

- 任何真实项目的总览、时间线、当前交接
- 真实对话归档
- 用户数据、业务数据、密钥、账号、远端环境信息
- 针对某个具体项目的私有决策记录

核心方法

1. 原始材料证明事实。
2. 时间线只记日期、实质变化和直接来源；理由仅在确有必要时补一句。
3. 当前交接只保留当前位置、边界和下一项已授权工作，不积累历史。

技能里最关键的几个约束

- 普通开始只读当前交接，不默认读完整时间线和全部来源。
- 用户照常工作和决策，AI负责查找、维护和写回。
- 只有首次建档、明确审计或局部回查无法解决冲突时才读取完整历史。
- 检查脚本只检查结构，不证明记忆、业务或用户体验已经通过。
- 项目事实只能来自该项目自己登记的记录，不能偷偷拿全局记忆、旧任务或外部资料补历史。

目录结构

- skills/maintain-project-continuity/：技能本体
- skills/maintain-project-continuity/assets/：规则块与模板
- skills/maintain-project-continuity/references/：方法说明
- skills/maintain-project-continuity/scripts/：安装与校验脚本
- skills/maintain-project-continuity/tests/：契约测试
- dsh-plugin/：DeepSeek Harness (dsh) 插件包

公开命名

这个公开仓库使用展示名 AI Long-Term Memory（AI长期记忆），面向 Codex 与 DeepSeek Harness (dsh)。
为了兼容已有触发方式，技能内部技术名仍然保留为 maintain-project-continuity。

English
这是一个面向Codex 和 DeepSeek Harness（dsh）中长期运行项目的连续性技能。它并不试图解决“如何编写一份简短交接摘要”的问题，而是解决“一个全新的对话如何在不继承隐藏上下文的情况下，准确恢复项目目标、演进过程、用户决策、决策依据、边界、当前状态和下一步”的问题。

这个公开版本已完全脱敏。它只保留通用方法和通用工具。它不包含真实项目笔记本、业务数据、对话归档、账户信息、日志、凭据或私有仓库内容。

它解决什么问题

- 全新对话继承的是压缩摘要，因而丢失真实目标、边界和当前状态。
- 助手的提议会被误读为用户已批准的决策。
- 交接会丢失已被取代的路线、已接受的风险和真正的下一步行动。

它如何工作

1. 原始来源保留事实，时间线用一两行记录每一次实质性变更及其来源，而交接只是一个书签。
2. 一个普通的新对话读取当前交接，并开始用户的工作。
3. 当某些内容缺失或相互矛盾时，AI 会沿着有针对性的引用查找，而不是加载全部历史。
4. AI 会自动写回实质性变更；用户无需管理系统记忆。

日常延续与审计

- 日常延续只读取当前交接，并在需要时通过有针对性的查找进行扩展。
- 首次重建、全历史审计和多轮漂移研究属于特殊验证工作。
- 清单状态是历史标签，不是把普通对话变成考试的路由器。

30 秒快速开始（Codex）

1. 将 skills/maintain-project-continuity 放入你的 Codex 技能目录。
2. 在目标项目中注册 .codex/project-continuity.json。
3. 将受管连续性块插入目标项目的 AGENTS.md。
4. 运行验证脚本，并确认项目记录结构完整。

验证器输出使用 output_schema_version: 1，且只报告结构；它不认证记忆、业务结果或用户体验。

示例：

python skills/maintain-project-continuity/scripts/install_project.py  --project-name "My Project"
python skills/maintain-project-continuity/scripts/validate_project.py

DeepSeek Harness（dsh）快速开始

1. 在此仓库检出目录中，运行 dsh plugin --profile web add ./dsh-plugin。
2. 运行 node ./dsh-plugin/scripts/install.mjs，将标准 SKILL.md 包安装到 $DSH_HOME/skills/maintain-project-continuity（默认 ~/.dsh/skills/maintain-project-continuity）。重新安装会暂存一份完整副本并整体替换技能目录，从而移除旧版本中的陈旧文件；如果激活失败，则恢复先前的目录。
3. cordis.patch.yml 有意留空，因为不需要挂载任何 Cordis 运行时行。
4. 重启 dsh web（或启动一个新会话）；连续性技能会出现在技能列表中。

Windows 注意事项：dsh plugin add 无法接受包含空格的本地路径。如果你的检出路径包含空格，请先将 dsh-plugin 目录复制到一个不含空格的路径（例如 C:\dsh-continuity），然后再从那里安装。

registered 意味着清单和规则已安装；它并不意味着普通续接已就绪。要使 continuation_ready: true，还需要可用的时间线和当前交接。

本仓库包含的内容

- 通用技能主体
- 通用项目规则块
- 通用模板
- 通用安装脚本
- 通用验证脚本
- 经过脱敏的示例清单
- 该技能的契约测试
- dsh-plugin/：一个 DeepSeek Harness (dsh) 插件包

本仓库不包含的内容

- 任何真实项目的概览、时间线或当前交接
- 真实对话存档
- 用户数据、业务数据、机密、账户或远程环境细节
- 与特定项目绑定的私有决策记录

核心方法

1. 原始来源证明事实。
2. 时间线只记录日期、实质性变更和直接来源；仅在重要时添加原因。
3. 交接只保留当前位置、边界和下一项已授权工作，而不是累积历史。

最重要的规则

- 普通启动只读取当前交接，而不是完整时间线或来源历史。
- 用户正常工作和决策；AI 负责查找、维护和回写。
- 仅在首次重建、明确审计，或定向查找无法解决的冲突时，才读取完整历史。
- 验证脚本只检查结构；它们不认证记忆、业务结果或用户体验。
- 项目事实必须来自项目自身已登记的记录，而不是来自全局记忆、旧任务或外部材料。

仓库布局

- skills/maintain-project-continuity/：技能本身
- skills/maintain-project-continuity/assets/：规则块和模板
- skills/maintain-project-continuity/references/：方法说明
- skills/maintain-project-continuity/scripts/：安装和验证脚本
- skills/maintain-project-continuity/tests/：契约测试
- dsh-plugin/：DeepSeek Harness (dsh) 插件包

公开命名

这个公开仓库使用显示名称 AI Long-Term Memory (AI长期记忆)，适用于 Codex 和 DeepSeek Harness (dsh)。
为了与现有触发器兼容，内部技术技能名称仍为 maintain-project-continuity。