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/workspace/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/workspace/README.md
README.md: ba92e95d3cde0a95eaaeae5a9b4384c3b8c9c4b8
README.zh.md: 96fd4b9790dcb5cc69e068aa14e2348dfa86a31e
README.md: 9f6ead776c1e5d36af5b6917ad8f27725b11e6a0
README.zh.md: aa691ec681112f4c25a6391c33eabd2711c7abfc

2
packages/workspace/README.md
View File

@@ -8,4 +8,4 @@ This family owns persistent workspaces: user directories with titles and ordered
|---|---|---|
| [`workspace/`](workspace/README.md) | Registers workspaces and accounts for their sessions | `ctx.workspace` |
Workspace deletion removes the registry record, not user files or session logs. See the [workspace lifecycle decision](../../.agents/notes/implemented/feature/2026-07-27-workspace-registration-deletion.md) and [storage design](../../.agents/notes/proposed/architecture/2026-07-24-domain-kv-storage-and-workspace.md).
The [workspace package reference](workspace/README.md) owns lifecycle, persistence, and deletion semantics.

8
packages/workspace/README.zh.md
View File

@@ -1,11 +1,11 @@
# workspace/：Workspace 实体
# workspace/：workspace 实体家族
[English](README.md) | 中文
Workspace 系列负责持久 workspace 概念：用户工作所在的目录，包含标题以及属于它的有序会话列表。设计记录：[领域 KV 存储 Agent Note](../../.agents/notes/proposed/architecture/2026-07-24-domain-kv-storage-and-workspace.md)。
本家族拥有持久 workspace：带标题和有序会话成员关系的用户目录。
| 包 | 职责 | ctx 键 |
|---|---|---|
| `workspace/` | 基于存储领域数据形式的 `WorkspaceRegistry` 服务：按 realpath 去重的路径、会话归属记账、实体缓存 | `ctx.workspace` |
| [`workspace/`](workspace/README.md) | 注册 workspace 并记录其会话归属 | `ctx.workspace` |
所有权信息以 workspace 记录中的 `sessionIds`（有序）为准，绝不从会话 cwd 派生；`attachSession` 会验证会话头的 cwd 解析到 workspace 路径，因此一个会话在结构上最多属于一个 workspace。删除 Workspace 只会移除该注册表记录及会话归属记录：目录、用户文件和会话日志都会保留，相关会话则进入 Ungrouped（参见[决策记录](../../.agents/notes/implemented/feature/2026-07-27-workspace-registration-deletion.md)）。
[workspace 包参考](workspace/README.md)负责生命周期、持久化和删除语义。