mirror of
https://github.com/deepseek-ai/deepseek-harness
synced 2026-08-15 21:04:50 +00:00
7e445c3a67
git mv the 12 packages from session-persistence/, session-projection/, session-title/, and telemetry/ into one session/ group per the regrouping RFC; merge the four group READMEs into one bilingual triplet; rewrite the group segment in tsconfig references (intra-group references shorten to ../<pkg>), tsconfig.base.json paths/globs, knip.json keys, vitest include, gate scripts, and authored doc/note citations; regenerate module graph, doc graphs, catalogs, and the lockfile importer keys. No npm names change. Full unit suite: 8779 passed; the 18 reported failures reproduce as env flakes (ambient-proxy IPv6 tunneling, watched-dir inotify timeouts under parallel load) — each passes in isolation with NO_PROXY set, matching their known pre-existing behavior on master.
3.1 KiB
3.1 KiB
session/：持久会话数据平面
English | 中文
围绕 core/session 常驻内存实时服务的持久家族：持久化 seam 连同其存储后端与检查点策略、供出日志派生全量值的投影 seam、日志支持的标题，以及外发会话遥测。全部都是产品包（package）。session-query/ 仍是同级独立组：读取／工具面的消费不依赖持久化内部实现。
持久化
持久会话数据的持久化机制、语义检查点策略以及随产品交付的存储后端。
| 包 | 职责 | ctx 键 |
|---|---|---|
session-persistence/ |
定义持久化服务和共享写入协调机制 | ctx.sessionPersistence |
session-checkpoint-policy/ |
应用语义持久性检查点 | 包装 ctx.llm 和 ctx.tools |
session-persistence-jsonl/ |
将会话持久化到 JSONL 文件 | 注册到 ctx.sessionPersistence |
session-persistence-sqlite/ |
将会话持久化到 SQLite | 注册到 ctx.sessionPersistence |
会话持久化决策记录了持久化设计。
投影
向客户端载体提供从日志派生的当前逐会话状态。
| 包 | 职责 | ctx 键 |
|---|---|---|
session-projection/ |
定义并驱动会话投影单元 | ctx.sessionProjections |
session-projection-cache/ |
持久化并恢复投影检查点 | ctx.sessionProjectionCache |
标题
从会话日志派生持久会话标题，并支持可选的模型后端 provider。
| 包 | 职责 | ctx 键 |
|---|---|---|
session-title/ |
负责标题状态、回退行为、provider 注册与刷新 | ctx.sessionTitle |
session-title-llm/ |
提供共享的模型标题生成能力 | — |
session-title-first-message-llm/ |
根据第一条合格的人类消息生成会话标题 | 注册到 ctx.sessionTitle |
session-title-all-messages-llm/ |
根据所有合格的人类消息生成会话标题 | 注册到 ctx.sessionTitle |
部署可注册一个模型后端 provider；未注册时，服务仍提供确定性回退。
遥测
将会话活动投影为外发遥测，并将投递委派给配置的上报后端。遥测决策记录上报边界；模式决策记录即时、反馈门控与禁用投递。
| 包 | 职责 |
|---|---|
session-telemetry/ |
定义捕获、脱敏、投影，以及实时或按需后端投递。 |
session-telemetry-otel/ |
通过 OpenTelemetry 日志以 FULL、FEEDBACK_ONLY 或 DISABLED 模式投递遥测。 |