starfishwrx/dsh-git-memory

DSH Git Memory

CI
License: MIT

为 DeepSeek Harness 提供的基于 Git 的、可审查的长期上下文。

状态：兼容性验证 / 预 alpha 阶段。当前版本用于验证 DSH
集成接缝，并有意不存储用户记忆。

产品方向

DSH Git Memory 围绕一个信任不变式构建：

一次受控的记忆事务等于一次 Git 提交。

预期产品在第一天就为 DeepSeek Harness 提供有用的上下文，然后在正常使用过程中
积累有来源支撑的记忆。被接受的记忆保持本地化、可 diff、可审查、可回滚。

当前可用的功能

- 可安装的 DSH bundle，带有 dsh.bundle 清单。
- 通过 ctx.systemPrompt.context() 注册的稳定动态上下文。
- 对 session/event 的仅元数据观察。
- 一条直接的人类命令：/memory status。
- 一个只读的模型工具：memory_status。
- Windows 和 Ubuntu CI。
- 不持久化对话记录，不进行后台模型调用，不写入记忆。

该验证版本仅在进程内存中记录聚合事件计数和时间戳。
它从不保留消息或工具结果的内容。

从源码快速开始

前置条件：

- Node.js 24 或更新版本。
- pnpm 11。
- DeepSeek Harness 0.1.0-rc.6。

git clone https://github.com/starfishwrx/dsh-git-memory.git
cd dsh-git-memory
pnpm install
pnpm verify
dsh plugin --profile web add .
dsh --profile web --dump-config

启动 Web profile，然后运行：

/memory status

模型也可以调用：

memory_status

该包尚未发布到 npm。GitHub 依赖安装会运行包的 prepare 构建，
因此需要显式的 pnpm allowBuilds 权限。测试源码安装时请固定一个提交。

计划的用户体验

1. /memory setup 收集基本的个人资料、项目、目标、偏好、边界和同意信息。
2. 确认后的引导草稿成为一次可审计的基线提交。
3. 正常的 DSH 会话生成有界、脱敏的记忆候选。
4. 审查模式允许用户批准、编辑或拒绝候选。
5. 只有在初始信任期之后，才能启用保守的自动化。
6. DSH 接收一个有界的动态上下文快照；详细回忆使用
memory_search。

交付计划请参见路线图和
架构。

安全姿态

- 受管理的仓库将位于 $DSH_HOME/git-memory 下，而不是用户的
源码仓库内。
- 记忆工具不会接受任意的文件系统目标位置。
- 凭据、私钥、cookie 和令牌等敏感值会被
硬性拒绝。
- 原始会话记录不会被复制到记忆 Git 历史中。
- Git 远程、推送以及对受管理仓库之外的写入默认被禁用
默认。
- 模型推断出的观察结果绝不能静默地成为全局用户策略。

在贡献存储代码之前，请阅读 PRIVACY.md、THREAT_MODEL.md 以及
目标数据模型。

开发

pnpm install
pnpm typecheck
pnpm test
pnpm build

pnpm verify 运行稳定的 CI 检查。已安装 DSH 的维护者可以将 DSH_BIN 设置为
DSH 的 lib/bin.js 的绝对路径，并运行
pnpm smoke:dsh。该冒烟脚本会将构建好的 bundle 安装到一个一次性
配置文件中，在临时端口上启动 DSH，检查 Web 响应，然后进行清理。

在未来版本中，唯一允许直接依赖不稳定 DSH API 的模块
是 DSH 适配器层。在该边界得到验证之前，兼容性探针
有意保持精简。

兼容性

当前测试的版本线是 Node.js 24 上的 DeepSeek Harness 0.1.0-rc.6。
DSH 发展迅速，因此插件和 Harness 版本被有意固定。参见
COMPATIBILITY.md。

贡献

欢迎提交 issue 和有针对性的 pull request。请阅读
CONTRIBUTING.md。切勿在测试夹具中使用真实对话记录、凭据、
个人路径或私有用户上下文。

许可证

MIT。参见 LICENSE。