deepseek-harness/packages/storage/README.zh.md

---

description: "存储组地图：通过具名后端与类型化领域数据形式持久化非会话数据，供浏览本组的用户与维护者阅读。"

kind: "package-group"

packages/storage

English | 中文

概述

存储组跨重启保留非会话应用数据，包括工作区记录和会话伴随数据。需要人类可读文件时选择 storage-json，需要在单个数据库中定点更新时选择 storage-sqlite；storage-domain 增加经过 schema 校验的类型化记录和变更通知，而 storage 选择已配置的后端。这些包是可选项且只面向宿主侧：它们不会向模型暴露工具、提示词内容或会话事件。当应用状态必须在进程结束后继续存在时使用本组；组合没有此类数据时可以省略本组。

目录

• 包
• 相关文档
• 开发备注

---

包

包	职责	ctx 键
storage	把已注册后端与已挂载的数据形式设施连接起来	ctx.storage
storage-json	把每个单元存为一个人类可读的 JSON 文件	注册后端 json
storage-sqlite	把单元作为 JSON 文档存进一个 SQLite 数据库	注册后端 sqlite
storage-domain	在已路由后端之上提供经过 schema 校验、发出变更事件的 KV 领域	ctx.storageDomain

---

相关文档

• 存储子系统——权威约定：后端约定、领域声明、变更事件与生成的 API。
• 领域 KV 存储 Agent Note——本家族的设计、workspace 消费方与被推迟的会话后端迁移。
• Workspace 子系统——领域数据形式的第一个消费方。

---

开发备注

维护者的工作上下文——点击展开

设计 Agent Note 仍标记为 proposed，而本家族已经发布；其范围外事项表就是迁移阶段（`log` 分面、会话后端复用、跨进程变更推送）的延期工作清单。决策落地后，请把结论提升为 implemented 笔记。