Coder/deepseek-harness
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: rescan rebased documentation hierarchy

Browse Source
This commit is contained in:
Turtle
2026-08-05 12:46:38 +08:00
parent 012bb0a549
commit 8af3babaea
304 changed files with 1091 additions and 1983 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
packages/session-projection/README.i18n.yaml
View File

@@ -2,5 +2,5 @@
# side as of the last confirmed-consistent state. Both languages carry equal authority;
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write packages/session-projection/README.md
README.md: ae80a905705d205adb4a1ee66c72fa28d0d8b6d6
README.zh.md: 3d4a4aa3151cc92a8b887e85c911b7f6b59bf52f
README.md: f1fc8337bbea6663915c19f39fdf02f14190370d
README.zh.md: 3323166f496fabafabcd96abeaec707a28ce552a

10
packages/session-projection/README.zh.md
View File

@@ -1,10 +1,10 @@
# session-projection/
# session-projection/：会话投影能力家族
[English](README.md) | 中文
会话投影能力家族：领域 host 插件经由此 seam，把日志派生的按会话状态的当前全量值供给客户端载体。
本家族向客户端载体提供从日志派生的当前逐会话状态。
| 包 | ctx 键 | 职责 |
| 包 | 职责 | ctx 键 |
|---|---|---|
| [`session-projection`](session-projection/README.md) | `sessionProjections` | 接口包：merge-extensible 的 `SessionProjectionMap` 类型表、`ProjectionDefinition` 单元契约，以及供载体同步读取的主动驱动注册表 |
| [`session-projection-cache`](session-projection-cache/README.md) | `sessionProjectionCache` | 持久投影缓存：基于域数据形态的按会话单元检查点持久化、带 turn/end + detach 两个必写点的节流后写，以及冷读阶梯（缓存行 + 持久化尾部回放） |
| [`session-projection/`](session-projection/README.md) | 定义并驱动会话投影单元 | `ctx.sessionProjections` |
| [`session-projection-cache/`](session-projection-cache/README.md) | 持久化并恢复投影检查点 | `ctx.sessionProjectionCache` |

4
packages/session-projection/session-projection/README.i18n.yaml
View File

@@ -2,5 +2,5 @@
# side as of the last confirmed-consistent state. Both languages carry equal authority;
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write packages/session-projection/session-projection/README.md
README.md: f4898b8e567fa5998c18111c5f4e27a8a350a42e
README.zh.md: 520205e616cdc1421c8f33f00d2013a6e0947d3d
README.md: a42e88c262915fc5e53cd72205079cbc8029a8df
README.zh.md: f60a48bd41f0c33edb85a495ada9b6818ec46ee5

2
packages/session-projection/session-projection/README.md
View File

@@ -2,7 +2,7 @@
English | [中文](README.zh.md)
Session-projection seam. It owns `ctx.sessionProjections`, the registry that DRIVES every registered projection unit forward over committed session events and serves finished whole values to carriers (the api-proxy history tail page and `session/projection` push frame today; TUI/ACP/headless consumers later). A domain registers pure mathematics; the framework owns the drive. Design authority: the [session-projection RFC](../../../.agents/notes/proposed/architecture/2026-07-27-session-projection-and-command-log.md).
Session-projection seam. It owns `ctx.sessionProjections`, the registry that drives every registered projection unit over committed session events and serves finished whole values to carriers, currently the api-proxy history tail page and `session/projection` push frame. A domain registers pure mathematics; the framework owns the drive. The [session-projection RFC](../../../.agents/notes/proposed/architecture/2026-07-27-session-projection-and-command-log.md) records the design rationale.
## Service: `SessionProjectionRegistry` (ctx key: `sessionProjections`)

2
packages/session-projection/session-projection/README.zh.md
View File

@@ -2,7 +2,7 @@
[English](README.md) | 中文
会话投影 seam。它拥有 `ctx.sessionProjections`——该注册表驱动每个已注册的投影单元在已提交会话事件上前进，并向载体供给成品全量值（今天是 api-proxy 历史尾页与 `session/projection` 推送帧；日后是 TUI、ACP（Agent Client Protocol）、headless 消费方）。领域注册的只是纯数学；驱动权归框架。设计权威：[session-projection RFC](../../../.agents/notes/proposed/architecture/2026-07-27-session-projection-and-command-log.md)。
会话投影 seam。它拥有 `ctx.sessionProjections`：该注册表在已提交的会话事件上驱动每个已注册的投影单元，并向载体提供完整的最终值，目前包括 api-proxy 历史尾页和 `session/projection` 推送帧。领域注册的只是纯数学；驱动权归框架。[session-projection RFC](../../../.agents/notes/proposed/architecture/2026-07-27-session-projection-and-command-log.md)记录了设计理由。
## 服务：`SessionProjectionRegistry`（ctx 键：`sessionProjections`）

4
packages/session-projection/session-projection/src/index.ts
View File

@@ -5,8 +5,8 @@
* forward eagerly over committed session events. Domain host plugins
* contribute pure mathematics (init/apply/view); the framework owns the
* subscription, the per-session watermark cache, and change notification;
* carriers (api-proxy today, TUI/ACP/headless later) consume the snapshot
* read face and the change feed. Neither side knows the other
* carriers consume the snapshot read face and the change feed. Neither side
* knows the other
* (capability-seam three-way split). Design authority: the session-projection
* RFC (.agents/notes/proposed/architecture/2026-07-27-session-projection-and-command-log.md).
*