dsh-worktree-groups 0.0.0-stage → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +168 -2
- package/cordis.patch.yml +17 -0
- package/icon.svg +20 -0
- package/lib/activity.d.ts +78 -0
- package/lib/activity.d.ts.map +1 -0
- package/lib/activity.js +241 -0
- package/lib/activity.js.map +1 -0
- package/lib/client.d.ts +78 -0
- package/lib/client.d.ts.map +1 -0
- package/lib/client.js +4280 -0
- package/lib/git.d.ts +109 -0
- package/lib/git.d.ts.map +1 -0
- package/lib/git.js +317 -0
- package/lib/git.js.map +1 -0
- package/lib/icons.d.ts +148 -0
- package/lib/icons.d.ts.map +1 -0
- package/lib/icons.js +144 -0
- package/lib/icons.js.map +1 -0
- package/lib/index.d.ts +32 -0
- package/lib/index.d.ts.map +1 -0
- package/lib/index.js +47 -0
- package/lib/index.js.map +1 -0
- package/lib/ledger.d.ts +97 -0
- package/lib/ledger.d.ts.map +1 -0
- package/lib/ledger.js +276 -0
- package/lib/ledger.js.map +1 -0
- package/lib/live-merge.d.ts +44 -0
- package/lib/live-merge.d.ts.map +1 -0
- package/lib/live-merge.js +227 -0
- package/lib/live-merge.js.map +1 -0
- package/lib/live-state.d.ts +158 -0
- package/lib/live-state.d.ts.map +1 -0
- package/lib/live-state.js +281 -0
- package/lib/live-state.js.map +1 -0
- package/lib/locales.d.ts +71 -0
- package/lib/locales.d.ts.map +1 -0
- package/lib/locales.js +199 -0
- package/lib/locales.js.map +1 -0
- package/lib/projects.d.ts +88 -0
- package/lib/projects.d.ts.map +1 -0
- package/lib/projects.js +418 -0
- package/lib/projects.js.map +1 -0
- package/lib/routes.d.ts +376 -0
- package/lib/routes.d.ts.map +1 -0
- package/lib/routes.js +1875 -0
- package/lib/routes.js.map +1 -0
- package/lib/row-memo.d.ts +34 -0
- package/lib/row-memo.d.ts.map +1 -0
- package/lib/row-memo.js +46 -0
- package/lib/row-memo.js.map +1 -0
- package/lib/sidebar.d.ts +126 -0
- package/lib/sidebar.d.ts.map +1 -0
- package/lib/tree-model.d.ts +1226 -0
- package/lib/tree-model.d.ts.map +1 -0
- package/lib/tree-model.js +2143 -0
- package/lib/tree-model.js.map +1 -0
- package/lib/types.d.ts +98 -0
- package/lib/types.d.ts.map +1 -0
- package/lib/types.js +8 -0
- package/lib/types.js.map +1 -0
- package/locale/en.json +6 -0
- package/locale/zh.json +6 -0
- package/package.json +88 -4
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 rayman.lv
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,169 @@
|
|
|
1
|
-
|
|
1
|
+
<p align="center">
|
|
2
|
+
<img src="icon.svg" alt="dsh-worktree-groups" width="72" height="72">
|
|
3
|
+
</p>
|
|
2
4
|
|
|
3
|
-
|
|
5
|
+
<h1 align="center">dsh-worktree-groups</h1>
|
|
6
|
+
|
|
7
|
+
<p align="center">
|
|
8
|
+
基于 DeepSeek Harness 插件机制构建的侧栏增强方案,将工作区与会话按 <strong>项目 → Git Worktree → 会话</strong> 三级树分组管理。
|
|
9
|
+
</p>
|
|
10
|
+
|
|
11
|
+
<p align="center">
|
|
12
|
+
<a href="docs/README.md"><img src="https://img.shields.io/badge/%E6%96%87%E6%A1%A3-blue?logo=googledocs&logoColor=white" alt="文档"></a>
|
|
13
|
+
<a href="https://www.npmjs.com/package/dsh-worktree-groups"><img src="https://img.shields.io/npm/v/dsh-worktree-groups?color=CB3837&logo=npm" alt="npm"></a>
|
|
14
|
+
<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue" alt="License: MIT"></a>
|
|
15
|
+
<a href="https://dshfind.com/zh/plugins/lvrayman/dsh-worktree-groups?ref=badge"><img src="https://dshfind.com/api/badge/lvrayman/dsh-worktree-groups?metric=downloads&lang=zh" alt="dshfind 下载量"></a>
|
|
16
|
+
</p>
|
|
17
|
+
|
|
18
|
+
## 告别平铺工作区,按 Git Worktree 自然归位。
|
|
19
|
+
|
|
20
|
+
DeepSeek Harness 原生侧栏(`@deepseek-ai/dsh-client-ui-workspace`,占据 `sidebar.workspaces` 槽位)将每个注册的工作区渲染成**平级**分组,多个指向同一 Git 仓库不同分支的 worktree 在侧栏中彼此孤立,未主动注册过的 worktree 更是完全不可见。
|
|
21
|
+
|
|
22
|
+
`dsh-worktree-groups` 以 `priority: -1` 接管 `sidebar.workspaces` 槽位,通过 Git `commonDir` 自动将同一仓库下的所有 worktree 归并到同一个项目节点下,并提供未注册 worktree 自动发现、懒注册、一键新建/移除 worktree、已删 worktree 历史会话回收桶、三层拖拽排序与渐进式展开。
|
|
23
|
+
|
|
24
|
+
已支持 DeepSeek Harness 桌面版(Desktop)与 Web Host,安装最新版即可使用:
|
|
25
|
+
|
|
26
|
+
`dsh-worktree-groups@0.1.1`
|
|
27
|
+
|
|
28
|
+
## 界面结构预览
|
|
29
|
+
|
|
30
|
+
```text
|
|
31
|
+
▾ MyProject ← 项目(按 git common dir 自动归并多个 DSH 工作区)
|
|
32
|
+
▾ develop [主] ← 主 worktree 行(点击行体展开/折叠;运行中任务图标高亮)
|
|
33
|
+
🐋 修复登录跳转… ← 默认展示 5 条,运行中会话自动置顶
|
|
34
|
+
⊞ 展开更多 5 个 | 收起 ← 渐进式展开(5 → 10 → 15…)
|
|
35
|
+
▾ feature/ohos ← 已注册 worktree
|
|
36
|
+
▾ feature/hb4-main ← 未注册 worktree(自动发现,点 + 时才懒注册)
|
|
37
|
+
▾ release/6.1.20
|
|
38
|
+
▾ history-worktree-session ← 已移除 worktree 的历史会话自动归入此桶
|
|
39
|
+
▾ LogAnalyst ← 单 worktree 的 Git 项目同样保持三级结构
|
|
40
|
+
▾ feature/refactor-render
|
|
41
|
+
🐋 会话 1 …
|
|
42
|
+
📁 Documents(非 Git) ← 非 Git 普通目录保持平铺形态
|
|
43
|
+
▾ 最近 ← 跨工作区按最近活动时间倒序(任意活动实时触发)
|
|
44
|
+
(未分组) ← 侧栏底部,保持原生兜底位置
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
## 主要特性
|
|
48
|
+
|
|
49
|
+
- **项目 → Worktree → 会话三级树**:按 Git `commonDir` 将指向同一仓库的多个 DSH 工作区自动归并为单个项目节点;所有 Git 项目(含单 worktree 仓库)统一产出 worktree 子行,非 Git 普通目录保持平铺。
|
|
50
|
+
- **自动发现未注册 Worktree 与懒注册**:直接解析 `git worktree list --porcelain`,无需事先在 DSH 中逐个添加工作区即可在侧栏看到全部 worktree;仅在首次点击该 worktree 的 `+` 新建会话时才向宿主注册工作区,避免产生冗余注册记录。
|
|
51
|
+
- **同位置新建会话草稿保留**:在同一 worktree / 工作区下点击 `+` 新建会话时,若已存在未发送消息的空白会话则自动复用并跳转,避免冲掉未发送的输入框草稿。
|
|
52
|
+
- **`history-worktree-session` 历史会话回收桶**:worktree 被移除(通过 UI 移除或外部 `rm -rf`)后,其名下会话不会掉入「未分组」,而是通过「插件台账(`$DSH_HOME/worktree-groups.json`)+ 路径前缀启发(`<主仓名>-<后缀>` 同父目录)」双源识别,自动归入所属项目的 `history-worktree-session` 桶。
|
|
53
|
+
- **死工作区自动清理**:非主工作树且磁盘目录已不存在的工作区注册记录会自动从 DSH 注销(仅清理注册表,**绝不触碰磁盘文件与会话日志**)。
|
|
54
|
+
- **原地新建与移除 Worktree**:
|
|
55
|
+
- **新建**:项目行 `…` → `新建 worktree…` → 选择新建或复用分支、起始分支与路径(默认 `<主仓父目录>/<主仓名>-<分支名>`)→ 自动执行 `git worktree add`、注册工作区并开启新会话。
|
|
56
|
+
- **移除**:worktree 行 `…` → `移除 worktree` → 遇未提交改动时弹窗警告并提供强制删除选项 → 移除后自动注销工作区(保留 Git 分支)。
|
|
57
|
+
- **运行中任务高亮与顶部区**:当会话自身或其下任意层级子代理正在运行时,所属项目文件夹图标、worktree 分支图标实时高亮着色,并将运行中会话固定在该分组顶部(运行中锁定拖拽,运行结束后恢复自由拖拽)。
|
|
58
|
+
- **三层拖拽手动排序**:项目、worktree、会话三个层级均支持同容器内上下拖拽排序,首次拖拽即切入手动排序模式(持久化于浏览器 `localStorage`),并随时可通过菜单「恢复默认排序」。
|
|
59
|
+
- **渐进式会话展开与底部「最近」分区**:每个容器默认展示前 5 条会话,点击「展开更多 5 个」按步长渐进展开(同行附带「收起」);侧栏底部提供「最近」分区,按会话最后活动时间(含流式输出与子代理事件)全局倒序展示。
|
|
60
|
+
- **工作空间归档与恢复**:支持将暂不使用的项目/工作空间从侧栏归档隐藏,并在 **设置 → 已归档的工作空间** 中随时一键恢复。
|
|
61
|
+
- **极致性能与实时响应**:服务端采用 Git 仓库指纹缓存、会话单次扫描复用、并发请求合并(singleflight)、ETag / 304 协商缓存与台账读写节流;客户端内置实时会话叠加层(live-merge),新建会话与新建 worktree 即刻呈现。
|
|
62
|
+
|
|
63
|
+
## 安装指南
|
|
64
|
+
|
|
65
|
+
### 方式一:DSH 桌面端插件管理器(推荐)
|
|
66
|
+
|
|
67
|
+
打开 DeepSeek Harness Desktop,进入 **插件(Plugins) → 添加插件(Add plugin)**:
|
|
68
|
+
|
|
69
|
+
- **从 npm 安装**(支持在线检查版本与更新):
|
|
70
|
+
```text
|
|
71
|
+
dsh-worktree-groups
|
|
72
|
+
```
|
|
73
|
+
- **从 GitHub 安装**:
|
|
74
|
+
```text
|
|
75
|
+
github:lvrayman/dsh-worktree-groups
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
### 方式二:使用 `dsh plugin` CLI 安装
|
|
79
|
+
|
|
80
|
+
- **Desktop Profile**:
|
|
81
|
+
```sh
|
|
82
|
+
dsh plugin --profile desktop add -w dsh-worktree-groups@latest
|
|
83
|
+
```
|
|
84
|
+
- **Web Host Profile**:
|
|
85
|
+
```sh
|
|
86
|
+
dsh plugin --profile web add -w dsh-worktree-groups@latest
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
> 也可以将 `dsh-worktree-groups@latest` 替换为 `github:lvrayman/dsh-worktree-groups`。安装或切换来源后,请按提示重启 DeepSeek Harness。
|
|
90
|
+
|
|
91
|
+
### 方式三:本地源码开发与调试(`pnpm link`)
|
|
92
|
+
|
|
93
|
+
克隆本仓库并构建后,可通过本地目录或 `link:` 接入对应 Profile:
|
|
94
|
+
|
|
95
|
+
```sh
|
|
96
|
+
git clone https://github.com/lvrayman/dsh-worktree-groups.git
|
|
97
|
+
cd dsh-worktree-groups
|
|
98
|
+
npm install
|
|
99
|
+
npm run build
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
在 DSH 桌面端 **插件 → 添加插件** 中直接选择本地仓库目录,或手动将其链接至 `~/.dsh/profiles/web/package.json`:
|
|
103
|
+
|
|
104
|
+
```sh
|
|
105
|
+
# 1. 在 ~/.dsh/profiles/web/package.json 中:
|
|
106
|
+
# - dsh.profile.bundles 数组追加 "dsh-worktree-groups"
|
|
107
|
+
# - dependencies 追加 "dsh-worktree-groups": "link:/path/to/dsh-worktree-groups"
|
|
108
|
+
# 2. 更新 Profile 依赖
|
|
109
|
+
cd ~/.dsh/profiles/web && pnpm install
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
本包自带的 [`cordis.patch.yml`](cordis.patch.yml) 由 [`package.json`](package.json) 的 `dsh.bundle.patch` 声明,Profile 启动时自动合并,**无需**手动修改 Profile 的 `cordis.patch.yml`。新增 bundle 后需重启 DSH 生效。
|
|
113
|
+
|
|
114
|
+
## 侧栏行交互速查
|
|
115
|
+
|
|
116
|
+
| 行类型 | 悬停按钮 | 交互说明 |
|
|
117
|
+
| --- | --- | --- |
|
|
118
|
+
| **侧栏顶部(搜索框右侧)** | `+` | 添加工作区(复用宿主目录选择器,缺席时自动回退路径输入弹窗) |
|
|
119
|
+
| **Git 项目行** | `…` | `新建 worktree…`、手动排序下的 `恢复默认排序`、`归档工作空间` |
|
|
120
|
+
| **Worktree 行** | `+` 与 `…` | `+` 在该 worktree 新建会话(未注册时自动懒注册);`…` 提供在文件管理器中打开、复制路径、重命名工作区、移除 worktree |
|
|
121
|
+
| **非 Git 工作区行** | `+` 与右键菜单 | `+` 在该工作区新建会话;右键菜单支持重命名、归档工作空间、删除工作区、恢复默认排序 |
|
|
122
|
+
| **会话行** | `…` 与右键菜单 | 重命名、派生会话(Fork)、归档会话、(history 桶内)移出 history |
|
|
123
|
+
| **最近 / 未分组行** | 无 | 点击展开/折叠分区 |
|
|
124
|
+
|
|
125
|
+
## 已知行为与本地存储说明
|
|
126
|
+
|
|
127
|
+
- **拖拽顺序与展开状态存储在浏览器端**(`localStorage`):
|
|
128
|
+
- `dsh-worktree-groups.collapsed`:节点折叠状态
|
|
129
|
+
- `dsh-worktree-groups.expandedAll`:渐进式展开层级
|
|
130
|
+
- `dsh-worktree-groups.order`:三层手动拖拽顺序
|
|
131
|
+
- 更换浏览器或清除站点数据会回退至默认排序,不会影响会话数据。
|
|
132
|
+
- **插件台账**:`$DSH_HOME/worktree-groups.json`(默认 `~/.dsh/worktree-groups.json`)仅记录 worktree 历史归属与已归档项目键值,不修改宿主任何原生会话文件。
|
|
133
|
+
- **路径前缀启发边界**:`<主仓名>-<后缀>` 同父目录启发式识别在存在同名前缀兄弟仓库(如同时存在 `App` 与 `AppKit`)时可能将后者的孤儿目录归入前者的 history 桶,仅影响展示归属,绝不丢失或改动任何数据。
|
|
134
|
+
|
|
135
|
+
## 开发与验证
|
|
136
|
+
|
|
137
|
+
```sh
|
|
138
|
+
npm install
|
|
139
|
+
npm run typecheck # TypeScript 类型检查(含 .ts 与 .tsx)
|
|
140
|
+
npm run build # tsc 编译宿主半边 lib/ + esbuild 打包客户端半边 lib/client.js
|
|
141
|
+
npm test # 构建并运行全部 node --test 单元与契约回归测试
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
构建产物:
|
|
145
|
+
|
|
146
|
+
- `lib/index.js`:宿主半边入口(注册 HTTP 路由、Git worktree 扫描、台账管理与活动追踪)。
|
|
147
|
+
- `lib/client.js`:浏览器客户端半边 bundle(`window.__ModuleLoader__.load({ id: "dsh-worktree-groups", ... })`)。
|
|
148
|
+
|
|
149
|
+
**依赖规范**:`@deepseek-ai/*` 一律不放入 `dependencies`,宿主服务全部通过 `ctx.get(name)` 运行时获取,`@deepseek-ai/cordis` 仅作 `import type` 与 `peerDependencies` 声明,避免与宿主运行时产生多实例冲突。
|
|
150
|
+
|
|
151
|
+
## 文档导航
|
|
152
|
+
|
|
153
|
+
本项目采用文档驱动开发(DDD)与三层知识库管理,完整设计、接口契约与历史工作记录均位于 [`docs/`](docs/README.md):
|
|
154
|
+
|
|
155
|
+
- [文档总索引](docs/README.md)
|
|
156
|
+
- [领域术语表(CONTEXT.md)](CONTEXT.md)
|
|
157
|
+
- [产品需求文档(PRD)](docs/PRD.md)
|
|
158
|
+
- [模块与接口契约(INTERFACES)](docs/INTERFACES.md)
|
|
159
|
+
- [宿主契约核实报告(HOST-CONTRACTS)](docs/HOST-CONTRACTS.md)
|
|
160
|
+
- [代码知识库(L1 / L2 / L3 架构与实现详解)](docs/knowledge/README.md)
|
|
161
|
+
- [协作规范(AGENTS.md)](AGENTS.md)
|
|
162
|
+
|
|
163
|
+
## 项目声明与商标
|
|
164
|
+
|
|
165
|
+
本项目是独立的开源社区项目,不是 DeepSeek 官方产品。DeepSeek 及相关名称和商标归其各自权利人所有。
|
|
166
|
+
|
|
167
|
+
## 许可
|
|
168
|
+
|
|
169
|
+
[MIT](LICENSE)
|
package/cordis.patch.yml
ADDED
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
# dsh-worktree-groups 组合包 patch。
|
|
2
|
+
#
|
|
3
|
+
# 本文件由 package.json 的 `dsh.bundle.patch` 声明。profile 启动时,Desktop 会为
|
|
4
|
+
# `dsh.profile.bundles` 里的每个包解析其 `dsh.bundle.patch` 并作为一层 patch 合并
|
|
5
|
+
# (见 app/lib/profile-*.js 的 bundle 层构建逻辑),所以**不需要**手工往 profile 的
|
|
6
|
+
# cordis.patch.yml 里再写一份 insert。
|
|
7
|
+
#
|
|
8
|
+
# 安装(两处都要改 <DSH_HOME>/profiles/web/package.json):
|
|
9
|
+
# 1. dsh.profile.bundles 追加 "dsh-worktree-groups"
|
|
10
|
+
# 2. dependencies 追加 "dsh-worktree-groups": "link:<本包绝对路径>"
|
|
11
|
+
# 然后 cd <DSH_HOME>/profiles/web && pnpm install
|
|
12
|
+
#
|
|
13
|
+
# 新增 bundle 必须重启 DSH Desktop 才生效(patchReload: "live" 只覆盖 patch 文件
|
|
14
|
+
# 内容的热重载,不含 bundle 层增删)。
|
|
15
|
+
- insert:
|
|
16
|
+
- id: dsh-worktree-groups
|
|
17
|
+
name: dsh-worktree-groups
|
package/icon.svg
ADDED
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" width="36" height="36" viewBox="0 0 36 36">
|
|
2
|
+
<defs>
|
|
3
|
+
<mask id="wtg-nodes-cutout">
|
|
4
|
+
<rect width="36" height="36" fill="#fff"/>
|
|
5
|
+
<circle cx="11" cy="10" r="1.8" fill="#000"/>
|
|
6
|
+
<circle cx="11" cy="26" r="1.8" fill="#000"/>
|
|
7
|
+
<circle cx="25" cy="15" r="1.8" fill="#000"/>
|
|
8
|
+
<circle cx="25" cy="24" r="1.8" fill="#000"/>
|
|
9
|
+
</mask>
|
|
10
|
+
</defs>
|
|
11
|
+
<g mask="url(#wtg-nodes-cutout)">
|
|
12
|
+
<path d="M11 10V26" stroke="#3b82f6" stroke-width="2.4" stroke-linecap="round"/>
|
|
13
|
+
<path d="M11 14C11 15 15 15 25 15" stroke="#10b981" stroke-width="2.2" stroke-linecap="round" fill="none"/>
|
|
14
|
+
<path d="M11 20C11 23 16 24 25 24" stroke="#3b82f6" stroke-width="2.2" stroke-linecap="round" fill="none"/>
|
|
15
|
+
<circle cx="11" cy="10" r="3.8" fill="#3b82f6"/>
|
|
16
|
+
<circle cx="11" cy="26" r="3.8" fill="#3b82f6"/>
|
|
17
|
+
<circle cx="25" cy="15" r="3.6" fill="#10b981"/>
|
|
18
|
+
<circle cx="25" cy="24" r="3.6" fill="#3b82f6"/>
|
|
19
|
+
</g>
|
|
20
|
+
</svg>
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 会话「最后更新时间」跟踪(2026-10-29 RAS1–RAS5)。
|
|
3
|
+
*
|
|
4
|
+
* ## 为什么需要这个模块
|
|
5
|
+
*
|
|
6
|
+
* 宿主 `SessionSummary.updatedAt = max(header.createdAt, metadata.lastPromptAt)`,而
|
|
7
|
+
* `lastPromptAt` **只在用户发言时推进**(`dsh-api-session-controller/lib/types/list.js`)。
|
|
8
|
+
* 助手回复、工具执行、子代理/后台任务活动都不会改变它 ⇒ 侧栏「最近」分区无法让
|
|
9
|
+
* 「正在被更新」的旧会话上浮。本模块监听宿主 Cordis 事件 `session/event`,用
|
|
10
|
+
* `event.time` 记录每个会话的最后活动时间,并在载荷组装时把子代理活动传播到祖先。
|
|
11
|
+
*
|
|
12
|
+
* ## 约束(见 `docs/design/2026-10-29-recent-any-activity-sort.md`)
|
|
13
|
+
*
|
|
14
|
+
* - 事件回调只做 O(1) 内存记录:不读日志、不扫盘、不抛错。
|
|
15
|
+
* - 记录表是**进程内**内存态(LRU 上限 {@link SESSION_ACTIVITY_LIMIT});重启后回退 `updatedAt`。
|
|
16
|
+
* - `lastActivityAt` 恒为有限数字且 `>= updatedAt`;只有「最近」分区消费它排序。
|
|
17
|
+
*/
|
|
18
|
+
import type { Context } from '@deepseek-ai/cordis';
|
|
19
|
+
/** 活动表容量上限:超过后按 LRU 淘汰最久未更新的一条(防止长进程无界增长)。 */
|
|
20
|
+
export declare const SESSION_ACTIVITY_LIMIT = 4096;
|
|
21
|
+
/**
|
|
22
|
+
* 归一化会话 id:去掉宿主顶层会话的 `session-` 前缀,首尾空白裁掉。
|
|
23
|
+
*
|
|
24
|
+
* 事件里的 `session.id` 与载荷里的 `sessionId` 可能一个带前缀、一个不带(子代理常见),
|
|
25
|
+
* 统一到同一把键,避免「记录到了但查不到」。非字符串/空串返回 `''`。
|
|
26
|
+
*/
|
|
27
|
+
export declare function normalizeActivitySessionId(id: unknown): string;
|
|
28
|
+
/** 会话活动时间表。 */
|
|
29
|
+
export interface SessionActivityTracker {
|
|
30
|
+
/** 记录一次活动;只保留最大值;非法 id/时间忽略;重复记录会把键移到 LRU 尾部。 */
|
|
31
|
+
record(sessionId: unknown, time: unknown): void;
|
|
32
|
+
/** 取该会话已记录的最大活动时间(内部按归一化 id 查找);没有则 `undefined`。 */
|
|
33
|
+
lastActivityAt(sessionId: unknown): number | undefined;
|
|
34
|
+
/** 当前记录条数(测试/诊断用)。 */
|
|
35
|
+
readonly size: number;
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* 造一个活动时间表。
|
|
39
|
+
*
|
|
40
|
+
* @param limit - 容量上限;非法或小于 1 时回退 {@link SESSION_ACTIVITY_LIMIT}。
|
|
41
|
+
*/
|
|
42
|
+
export declare function createSessionActivityTracker(limit?: number): SessionActivityTracker;
|
|
43
|
+
/** 当前活动版本号(只增不减)。 */
|
|
44
|
+
export declare function sessionActivityVersion(): number;
|
|
45
|
+
/** 记录一次活动(进程级单例)。 */
|
|
46
|
+
export declare function recordSessionActivity(sessionId: unknown, time: unknown): void;
|
|
47
|
+
/** 取某会话已记录的最大活动时间(进程级单例)。 */
|
|
48
|
+
export declare function lastSessionActivityAt(sessionId: unknown): number | undefined;
|
|
49
|
+
/** 清空进程级活动表(测试用;生产环境不调用)。 */
|
|
50
|
+
export declare function resetSessionActivity(): void;
|
|
51
|
+
/**
|
|
52
|
+
* 监听宿主 Cordis 事件 `session/event(session, event)`,把 `(session.id, event.time)`
|
|
53
|
+
* 写入进程级活动表。
|
|
54
|
+
*
|
|
55
|
+
* 宿主上下文没有 `on`(老宿主 / 测试替身)、监听注册抛错、事件形状不符时一律**静默降级**,
|
|
56
|
+
* 绝不因为活动跟踪而让插件加载失败或产生未捕获异常。监听器会随插件上下文一起释放;
|
|
57
|
+
* 返回的 disposer 可提前解除(重复调用安全)。
|
|
58
|
+
*/
|
|
59
|
+
export declare function registerSessionActivityObserver(ctx: Context): () => void;
|
|
60
|
+
/** `attachLastActivityTimes` 需要的最小行形状(`SessionRow` 结构兼容)。 */
|
|
61
|
+
export interface SessionActivityBearing {
|
|
62
|
+
sessionId: string;
|
|
63
|
+
updatedAt: number;
|
|
64
|
+
parentSessionId?: string;
|
|
65
|
+
/** 输出字段:最后更新时间(有限数字,且 >= updatedAt)。 */
|
|
66
|
+
lastActivityAt?: number;
|
|
67
|
+
}
|
|
68
|
+
/**
|
|
69
|
+
* 给一批会话行写 `lastActivityAt = max(updatedAt, 自身/后代活动时间)`。
|
|
70
|
+
*
|
|
71
|
+
* 纯函数(只依赖进程级活动表,不读写磁盘)。规则:
|
|
72
|
+
* - 没有活动记录 ⇒ `lastActivityAt = updatedAt`(与旧行为一致)。
|
|
73
|
+
* - 记录比 `updatedAt` 旧 ⇒ 仍取 `updatedAt`(不降低排序键)。
|
|
74
|
+
* - 子代理活动沿 `parentSessionId` 向祖先传播;缺失父引用、自环、多节点环安全终止。
|
|
75
|
+
* - 同一归一化 id 的多行写同一个值。
|
|
76
|
+
*/
|
|
77
|
+
export declare function attachLastActivityTimes(rows: SessionActivityBearing[]): void;
|
|
78
|
+
//# sourceMappingURL=activity.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../src/activity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,8CAA8C;AAC9C,eAAO,MAAM,sBAAsB,OAAO,CAAA;AAK1C;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,CAQ9D;AAOD,eAAe;AACf,MAAM,WAAW,sBAAsB;IACrC,iDAAiD;IACjD,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;IAC/C,oDAAoD;IACpD,cAAc,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;IACtD,sBAAsB;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,GAAE,MAA+B,GAAG,sBAAsB,CA2C3G;AAmBD,qBAAqB;AACrB,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED,qBAAqB;AACrB,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAG7E;AAED,6BAA6B;AAC7B,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAE5E;AAED,6BAA6B;AAC7B,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAYD;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,IAAI,CA8BxE;AAED,6DAA6D;AAC7D,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,wCAAwC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,sBAAsB,EAAE,GAAG,IAAI,CAiD5E"}
|
package/lib/activity.js
ADDED
|
@@ -0,0 +1,241 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 会话「最后更新时间」跟踪(2026-10-29 RAS1–RAS5)。
|
|
3
|
+
*
|
|
4
|
+
* ## 为什么需要这个模块
|
|
5
|
+
*
|
|
6
|
+
* 宿主 `SessionSummary.updatedAt = max(header.createdAt, metadata.lastPromptAt)`,而
|
|
7
|
+
* `lastPromptAt` **只在用户发言时推进**(`dsh-api-session-controller/lib/types/list.js`)。
|
|
8
|
+
* 助手回复、工具执行、子代理/后台任务活动都不会改变它 ⇒ 侧栏「最近」分区无法让
|
|
9
|
+
* 「正在被更新」的旧会话上浮。本模块监听宿主 Cordis 事件 `session/event`,用
|
|
10
|
+
* `event.time` 记录每个会话的最后活动时间,并在载荷组装时把子代理活动传播到祖先。
|
|
11
|
+
*
|
|
12
|
+
* ## 约束(见 `docs/design/2026-10-29-recent-any-activity-sort.md`)
|
|
13
|
+
*
|
|
14
|
+
* - 事件回调只做 O(1) 内存记录:不读日志、不扫盘、不抛错。
|
|
15
|
+
* - 记录表是**进程内**内存态(LRU 上限 {@link SESSION_ACTIVITY_LIMIT});重启后回退 `updatedAt`。
|
|
16
|
+
* - `lastActivityAt` 恒为有限数字且 `>= updatedAt`;只有「最近」分区消费它排序。
|
|
17
|
+
*/
|
|
18
|
+
/** 活动表容量上限:超过后按 LRU 淘汰最久未更新的一条(防止长进程无界增长)。 */
|
|
19
|
+
export const SESSION_ACTIVITY_LIMIT = 4096;
|
|
20
|
+
/** 宿主顶层会话 id 的固定前缀(`session-<uuid>`)。 */
|
|
21
|
+
const SESSION_ID_PREFIX = 'session-';
|
|
22
|
+
/**
|
|
23
|
+
* 归一化会话 id:去掉宿主顶层会话的 `session-` 前缀,首尾空白裁掉。
|
|
24
|
+
*
|
|
25
|
+
* 事件里的 `session.id` 与载荷里的 `sessionId` 可能一个带前缀、一个不带(子代理常见),
|
|
26
|
+
* 统一到同一把键,避免「记录到了但查不到」。非字符串/空串返回 `''`。
|
|
27
|
+
*/
|
|
28
|
+
export function normalizeActivitySessionId(id) {
|
|
29
|
+
if (typeof id !== 'string')
|
|
30
|
+
return '';
|
|
31
|
+
let value = id.trim();
|
|
32
|
+
if (value === '')
|
|
33
|
+
return '';
|
|
34
|
+
if (value.length > SESSION_ID_PREFIX.length && value.startsWith(SESSION_ID_PREFIX)) {
|
|
35
|
+
value = value.slice(SESSION_ID_PREFIX.length);
|
|
36
|
+
}
|
|
37
|
+
return value;
|
|
38
|
+
}
|
|
39
|
+
/** 只接受有限数字的时间戳;其余(NaN / Infinity / 字符串 / undefined)返回 undefined。 */
|
|
40
|
+
function finiteTime(value) {
|
|
41
|
+
return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* 造一个活动时间表。
|
|
45
|
+
*
|
|
46
|
+
* @param limit - 容量上限;非法或小于 1 时回退 {@link SESSION_ACTIVITY_LIMIT}。
|
|
47
|
+
*/
|
|
48
|
+
export function createSessionActivityTracker(limit = SESSION_ACTIVITY_LIMIT) {
|
|
49
|
+
const capacity = typeof limit === 'number' && Number.isFinite(limit) && limit >= 1
|
|
50
|
+
? Math.floor(limit)
|
|
51
|
+
: SESSION_ACTIVITY_LIMIT;
|
|
52
|
+
const times = new Map();
|
|
53
|
+
/** 把键移到 Map 尾部(LRU 的「最近使用」端);不存在则忽略。 */
|
|
54
|
+
const touch = (key) => {
|
|
55
|
+
const value = times.get(key);
|
|
56
|
+
if (value === undefined)
|
|
57
|
+
return;
|
|
58
|
+
times.delete(key);
|
|
59
|
+
times.set(key, value);
|
|
60
|
+
};
|
|
61
|
+
return {
|
|
62
|
+
record(sessionId, time) {
|
|
63
|
+
const key = normalizeActivitySessionId(sessionId);
|
|
64
|
+
const at = finiteTime(time);
|
|
65
|
+
if (key === '' || at === undefined)
|
|
66
|
+
return;
|
|
67
|
+
const prior = times.get(key);
|
|
68
|
+
if (prior !== undefined) {
|
|
69
|
+
if (prior >= at) {
|
|
70
|
+
// 值没变(或更旧),但仍是一次「观测」⇒ 刷新 LRU 位置。
|
|
71
|
+
touch(key);
|
|
72
|
+
return;
|
|
73
|
+
}
|
|
74
|
+
times.delete(key);
|
|
75
|
+
}
|
|
76
|
+
times.set(key, at);
|
|
77
|
+
while (times.size > capacity) {
|
|
78
|
+
const oldest = times.keys().next().value;
|
|
79
|
+
if (oldest === undefined)
|
|
80
|
+
break;
|
|
81
|
+
times.delete(oldest);
|
|
82
|
+
}
|
|
83
|
+
},
|
|
84
|
+
lastActivityAt(sessionId) {
|
|
85
|
+
const key = normalizeActivitySessionId(sessionId);
|
|
86
|
+
return key === '' ? undefined : times.get(key);
|
|
87
|
+
},
|
|
88
|
+
get size() {
|
|
89
|
+
return times.size;
|
|
90
|
+
},
|
|
91
|
+
};
|
|
92
|
+
}
|
|
93
|
+
/**
|
|
94
|
+
* 进程级单例。
|
|
95
|
+
*
|
|
96
|
+
* `resetSessionActivity` 直接换新实例(而不是 clear),让测试之间彻底隔离;
|
|
97
|
+
* 其余导出的读写函数都通过闭包读当前实例。
|
|
98
|
+
*/
|
|
99
|
+
let singleton = createSessionActivityTracker(SESSION_ACTIVITY_LIMIT);
|
|
100
|
+
/**
|
|
101
|
+
* 活动版本号(2026-11-14 PERF1):每观测到一次宿主 `session/event` 就 +1。
|
|
102
|
+
*
|
|
103
|
+
* `routes.ts` 的会话行缓存用它判断「自上次全量列举以来是否有过任何会话活动」——
|
|
104
|
+
* 没有活动 ⇒ 缓存仍可信,免去一次全量扫盘。只增不减;`resetSessionActivity` 不回退它
|
|
105
|
+
* (回退会让缓存误判为「无变化」)。
|
|
106
|
+
*/
|
|
107
|
+
let activityVersion = 0;
|
|
108
|
+
/** 当前活动版本号(只增不减)。 */
|
|
109
|
+
export function sessionActivityVersion() {
|
|
110
|
+
return activityVersion;
|
|
111
|
+
}
|
|
112
|
+
/** 记录一次活动(进程级单例)。 */
|
|
113
|
+
export function recordSessionActivity(sessionId, time) {
|
|
114
|
+
activityVersion += 1;
|
|
115
|
+
singleton.record(sessionId, time);
|
|
116
|
+
}
|
|
117
|
+
/** 取某会话已记录的最大活动时间(进程级单例)。 */
|
|
118
|
+
export function lastSessionActivityAt(sessionId) {
|
|
119
|
+
return singleton.lastActivityAt(sessionId);
|
|
120
|
+
}
|
|
121
|
+
/** 清空进程级活动表(测试用;生产环境不调用)。 */
|
|
122
|
+
export function resetSessionActivity() {
|
|
123
|
+
singleton = createSessionActivityTracker(SESSION_ACTIVITY_LIMIT);
|
|
124
|
+
}
|
|
125
|
+
/** 从宿主 `Session` 实例里取 id(`session.id` 优先,退化到 `session.header.id`)。 */
|
|
126
|
+
function hostSessionIdOf(session) {
|
|
127
|
+
if (typeof session !== 'object' || session === null)
|
|
128
|
+
return undefined;
|
|
129
|
+
const direct = session.id;
|
|
130
|
+
if (typeof direct === 'string' && direct !== '')
|
|
131
|
+
return direct;
|
|
132
|
+
const header = session.header;
|
|
133
|
+
if (typeof header?.id === 'string' && header.id !== '')
|
|
134
|
+
return header.id;
|
|
135
|
+
return undefined;
|
|
136
|
+
}
|
|
137
|
+
/**
|
|
138
|
+
* 监听宿主 Cordis 事件 `session/event(session, event)`,把 `(session.id, event.time)`
|
|
139
|
+
* 写入进程级活动表。
|
|
140
|
+
*
|
|
141
|
+
* 宿主上下文没有 `on`(老宿主 / 测试替身)、监听注册抛错、事件形状不符时一律**静默降级**,
|
|
142
|
+
* 绝不因为活动跟踪而让插件加载失败或产生未捕获异常。监听器会随插件上下文一起释放;
|
|
143
|
+
* 返回的 disposer 可提前解除(重复调用安全)。
|
|
144
|
+
*/
|
|
145
|
+
export function registerSessionActivityObserver(ctx) {
|
|
146
|
+
const context = ctx;
|
|
147
|
+
if (typeof context.on !== 'function')
|
|
148
|
+
return () => undefined;
|
|
149
|
+
let disposed = false;
|
|
150
|
+
try {
|
|
151
|
+
const disposer = context.on.call(ctx, 'session/event', (session, event) => {
|
|
152
|
+
if (disposed)
|
|
153
|
+
return;
|
|
154
|
+
try {
|
|
155
|
+
const id = hostSessionIdOf(session);
|
|
156
|
+
if (id === undefined)
|
|
157
|
+
return;
|
|
158
|
+
const time = finiteTime(event?.time);
|
|
159
|
+
if (time === undefined)
|
|
160
|
+
return;
|
|
161
|
+
recordSessionActivity(id, time);
|
|
162
|
+
}
|
|
163
|
+
catch {
|
|
164
|
+
// 事件回调里绝不抛:宿主虽逐监听器隔离异常,但本插件的纪律是「缺失即降级,绝不崩」。
|
|
165
|
+
}
|
|
166
|
+
});
|
|
167
|
+
return () => {
|
|
168
|
+
disposed = true;
|
|
169
|
+
if (typeof disposer !== 'function')
|
|
170
|
+
return;
|
|
171
|
+
try {
|
|
172
|
+
disposer();
|
|
173
|
+
}
|
|
174
|
+
catch {
|
|
175
|
+
// 释放失败不影响插件卸载。
|
|
176
|
+
}
|
|
177
|
+
};
|
|
178
|
+
}
|
|
179
|
+
catch {
|
|
180
|
+
return () => undefined;
|
|
181
|
+
}
|
|
182
|
+
}
|
|
183
|
+
/**
|
|
184
|
+
* 给一批会话行写 `lastActivityAt = max(updatedAt, 自身/后代活动时间)`。
|
|
185
|
+
*
|
|
186
|
+
* 纯函数(只依赖进程级活动表,不读写磁盘)。规则:
|
|
187
|
+
* - 没有活动记录 ⇒ `lastActivityAt = updatedAt`(与旧行为一致)。
|
|
188
|
+
* - 记录比 `updatedAt` 旧 ⇒ 仍取 `updatedAt`(不降低排序键)。
|
|
189
|
+
* - 子代理活动沿 `parentSessionId` 向祖先传播;缺失父引用、自环、多节点环安全终止。
|
|
190
|
+
* - 同一归一化 id 的多行写同一个值。
|
|
191
|
+
*/
|
|
192
|
+
export function attachLastActivityTimes(rows) {
|
|
193
|
+
if (rows.length === 0)
|
|
194
|
+
return;
|
|
195
|
+
const keys = new Array(rows.length);
|
|
196
|
+
const value = new Map();
|
|
197
|
+
const parentOf = new Map();
|
|
198
|
+
for (let index = 0; index < rows.length; index += 1) {
|
|
199
|
+
const row = rows[index];
|
|
200
|
+
const key = normalizeActivitySessionId(row.sessionId);
|
|
201
|
+
keys[index] = key;
|
|
202
|
+
const updatedAt = finiteTime(row.updatedAt) ?? 0;
|
|
203
|
+
const own = key === '' ? updatedAt : Math.max(updatedAt, singleton.lastActivityAt(key) ?? 0);
|
|
204
|
+
if (key !== '') {
|
|
205
|
+
const prior = value.get(key);
|
|
206
|
+
value.set(key, prior === undefined ? own : Math.max(prior, own));
|
|
207
|
+
}
|
|
208
|
+
const parentKey = normalizeActivitySessionId(row.parentSessionId);
|
|
209
|
+
if (key !== '' && parentKey !== '' && parentKey !== key && !parentOf.has(key)) {
|
|
210
|
+
parentOf.set(key, parentKey);
|
|
211
|
+
}
|
|
212
|
+
}
|
|
213
|
+
// 祖先传播:每轮把子值抬到父值;值只增不减且有上界 ⇒ 必然终止。轮数再加一道保险,
|
|
214
|
+
// 防止未来有人把 parentOf 改成可自增的形态后死循环。
|
|
215
|
+
if (parentOf.size > 0) {
|
|
216
|
+
const maxPasses = Math.min(1024, Math.max(1, rows.length + 1));
|
|
217
|
+
for (let pass = 0; pass < maxPasses; pass += 1) {
|
|
218
|
+
let changed = false;
|
|
219
|
+
for (const [key, parentKey] of parentOf) {
|
|
220
|
+
const childValue = value.get(key);
|
|
221
|
+
const parentValue = value.get(parentKey);
|
|
222
|
+
// 父不在本批行里时不凭空造条目:只传播已存在的行。
|
|
223
|
+
if (childValue === undefined || parentValue === undefined)
|
|
224
|
+
continue;
|
|
225
|
+
if (childValue > parentValue) {
|
|
226
|
+
value.set(parentKey, childValue);
|
|
227
|
+
changed = true;
|
|
228
|
+
}
|
|
229
|
+
}
|
|
230
|
+
if (!changed)
|
|
231
|
+
break;
|
|
232
|
+
}
|
|
233
|
+
}
|
|
234
|
+
for (let index = 0; index < rows.length; index += 1) {
|
|
235
|
+
const row = rows[index];
|
|
236
|
+
const key = keys[index];
|
|
237
|
+
const resolved = key === '' ? undefined : value.get(key);
|
|
238
|
+
row.lastActivityAt = resolved ?? (finiteTime(row.updatedAt) ?? 0);
|
|
239
|
+
}
|
|
240
|
+
}
|
|
241
|
+
//# sourceMappingURL=activity.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"activity.js","sourceRoot":"","sources":["../src/activity.ts"],"names":[],"mappings":"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"}
|
package/lib/client.d.ts
ADDED
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* dsh-worktree-groups 客户端半边入口。
|
|
3
|
+
*
|
|
4
|
+
* 职责(契约 `docs/INTERFACES.md` §2.4 + §2.7 裁定 5):
|
|
5
|
+
* 1. 在 `sidebar.workspaces`(single/root)以 **`priority: -1`** 注册,遮蔽官方
|
|
6
|
+
* `ui-workspace` 的 `0`(single slot 低者渲染)。
|
|
7
|
+
* 2. `children` 里只声明**自建的**子键 `sidebar.workspaces.worktreeDirectoryFlow`
|
|
8
|
+
* —— **绝不能**声明官方键 `sidebar.workspaces.directoryFlow`:`SlotCore.register`
|
|
9
|
+
* 对同键重复声明直接抛错,而官方 `ui-workspace` 必须保持挂载(它同时提供
|
|
10
|
+
* `uiWorkspace` 服务,是另外 5 个客户端插件的硬 `inject` 依赖,禁用会让 web
|
|
11
|
+
* 启动期 `assertEntriesActive` 抛错 ⇒ 整页白屏)。
|
|
12
|
+
* 3. 声明 `locale` 拿到宿主 `t`;注册本插件的词典命名空间(`zh`)。
|
|
13
|
+
* ⚠️ 注册走 `ctx.inject(['locale'], …)`(**等 locale 服务出现**,子 fiber 不阻塞本 entry),
|
|
14
|
+
* **不是**一次性 `ctx.get('locale')` 探测 —— 后者会因 entry 并发启动而静默漏注册,
|
|
15
|
+
* 导致侧栏满屏裸 key(2026-09-23 缺陷,见 `apply` 内注释与
|
|
16
|
+
* `docs/worklog/2026-09-23-sidebar-menu-raw-keys.md`)。
|
|
17
|
+
* 4. **不声明 `store`** —— 本插件不读原生的分组/排序 store,展开态自管 localStorage。
|
|
18
|
+
* 5. 通过 `inject` 工厂把宿主客户端服务包成 {@link SidebarBridge} 交给组件;每个服务
|
|
19
|
+
* 都用 `ctx.get()` **惰性读取**,缺席时降级不抛(PRD R6)。
|
|
20
|
+
*
|
|
21
|
+
* ⚠️ **`inject` 数组里只用 `slots`**(硬依赖:没有它连槽位都注册不了)。`locale`
|
|
22
|
+
* 若写进 `inject`,在 locale 插件缺席的组合里本 entry 会永久 pending,而 web 启动
|
|
23
|
+
* 对未激活 entry 是**硬失败**(`assertEntriesActive` 抛 `web boot: N entries did not
|
|
24
|
+
* activate`)⇒ 整页白屏。所以 `locale` **不写进 `inject`**。
|
|
25
|
+
*
|
|
26
|
+
* ⚠️⚠️ 但**不要**因此以为「locale 缺席也有退路」——下面这条常被误读,务必看清:
|
|
27
|
+
*
|
|
28
|
+
* 1. `ctx.get('locale')` 的惰性探测(见 `apply`)**只用于注册词典**
|
|
29
|
+
* (`locale.register(LOCALE_NS, { zh })`)。**取 `t` 的路径不是它。**
|
|
30
|
+
* 2. **`entry.locale` 是声明式的:声明即无退路。** renderer 的 `standardKit`
|
|
31
|
+
* (`dsh-client-ui-renderer/lib/client.js`)对每个 entry 执行:
|
|
32
|
+
*
|
|
33
|
+
* ```js
|
|
34
|
+
* if (entry.locale !== void 0) {
|
|
35
|
+
* const face = host.locale
|
|
36
|
+
* if (face === void 0) throw new SlotAssemblyError(
|
|
37
|
+
* "entry declares locale namespace '" + entry.locale +
|
|
38
|
+
* "' but no locale face is installed (locale plugin missing from the composition?)")
|
|
39
|
+
* kit['t'] = localeSeat(face, entry.locale)
|
|
40
|
+
* }
|
|
41
|
+
* ```
|
|
42
|
+
*
|
|
43
|
+
* 即:**声明了 `locale` 而 locale 服务缺席 ⇒ 装配期抛错 ⇒ 本 entry 被剔除
|
|
44
|
+
* (abdicate),静默回落到官方 `ui-workspace`。** 抛出点在**父层** `standardKit`,
|
|
45
|
+
* 不在组件内部,`sidebar.tsx` 的 `SidebarBoundary` **接不到**。
|
|
46
|
+
* 3. `sidebar.tsx` 的 `FALLBACK_T`(内置 `zh`)只在**组件仍被渲染、只是没拿到
|
|
47
|
+
* `t` prop** 时生效 —— 它**不是** locale 服务缺席的兜底:那种情况下组件根本
|
|
48
|
+
* 不会被渲染,兜底逻辑永远走不到。**探测不到 locale ≠ 有退路。**
|
|
49
|
+
* 4. 当前组合安全的原因:`dsh-web-app` 的 `cordis.patch.yml` 挂载了 `locale`,
|
|
50
|
+
* 声明因此可靠,且宿主语言切换能自动触发重渲染(`localeSeat` 按 revision 换引用)。
|
|
51
|
+
* **权衡后保留 `entry.locale` 声明。**
|
|
52
|
+
* 5. 若将来要在**无 locale** 的组合里也工作,唯一办法是**去掉 `entry.locale` 声明**,
|
|
53
|
+
* 改用 `ctx.get('locale')` 手动 `bind(LOCALE_NS)` 取得 `t`,再从 `inject()` 工厂
|
|
54
|
+
* 把 `t` 传给组件。代价:**失去语言切换的自动重渲染**(`sidebar.tsx` 里依赖 `t`
|
|
55
|
+
* 的 `useMemo` 需要另找失效信号)。
|
|
56
|
+
*/
|
|
57
|
+
import type { Context } from '@deepseek-ai/cordis';
|
|
58
|
+
export declare const name = "dsh-worktree-groups";
|
|
59
|
+
/**
|
|
60
|
+
* 硬依赖服务。
|
|
61
|
+
*
|
|
62
|
+
* **只有 `slots`**:它是注册槽位的前提,缺席时本插件确实无事可做(应当 pending)。
|
|
63
|
+
* 其余服务(`locale` / `workspaces` / `sessions` / `uiWorkspace`)一律走
|
|
64
|
+
* `ctx.get()` 惰性探测 —— 写进 `inject` 会把"可选增强"变成"启动阻塞",
|
|
65
|
+
* 而 web 启动对未激活 entry 是**硬失败**(整页白屏)。
|
|
66
|
+
*/
|
|
67
|
+
export declare const inject: string[];
|
|
68
|
+
/**
|
|
69
|
+
* 客户端半边入口。
|
|
70
|
+
*
|
|
71
|
+
* 用 `ctx.slots.inject(key, cb)` 等槽位声明就绪(**唯一可靠的时序手段**:
|
|
72
|
+
* `dsh.client.inject` 只是预取元数据,never apply sequencing,见 §B4.3),
|
|
73
|
+
* 就绪后注册本 entry。
|
|
74
|
+
*
|
|
75
|
+
* @param ctx 客户端根 Context(`inject` 保证 `slots` 已可用)。
|
|
76
|
+
*/
|
|
77
|
+
export declare function apply(ctx: Context): void;
|
|
78
|
+
//# sourceMappingURL=client.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAmClD,eAAO,MAAM,IAAI,wBAAwB,CAAA;AAEzC;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,UAAY,CAAA;AAqK/B;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAsGxC"}
|