mirror of
https://github.com/deepseek-ai/deepseek-harness.git
synced 2026-08-29 04:26:38 +00:00
2.5 KiB
2.5 KiB
description, kind
| description | kind |
|---|---|
| 存储组地图：通过具名后端与类型化领域数据形式持久化非会话数据，供浏览本组的用户与维护者阅读。 | package-group |
packages/storage
English | 中文
概述
存储组为组合提供会话事件日志以外一切数据的持久存储：工作区记录、会话伴随数据，以及其他宿主侧应用数据。借助它，宿主包可以经 schema 校验过的领域数据形式持久化类型化记录，在人类可读的 JSON 后端与支持定点更新的 SQLite 后端之间选择，并在每次持久写入后收到变更事件。本家族是可选项，且只面向宿主侧：它不注册工具、不注入提示词，也不写入会话事件，因此模型与 agent loop（智能体循环）永远不会看到它。当产品需要跨重启保留应用状态时使用它；没有任何此类数据的组合可以省略整个组。
目录
包
| 包 | 职责 | 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 笔记。