dsh-sidebar-recent 0.0.0-stage → 1.0.0

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/README.md CHANGED
@@ -1,3 +1,71 @@
1
- # Temporary Holding Version
1
+ # Sidebar Recent · 侧栏最近会话
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ 为 **DeepSeek Harness (DSH)** 侧栏提供「项目 + 最近」双栏会话浏览器:既能按项目分组翻会话,也能按最近使用时间从上到下(新 → 旧)一眼扫到全部会话。
4
+
5
+ > 这是一个 DSH Client 插件,通过 `sidebar.workspaces` 槽位接管侧栏会话浏览区。停用插件即恢复 DSH 原生浏览器,不修改安装目录、不改动任何官方文件。
6
+
7
+ ## 功能
8
+
9
+ - **项目栏**:按项目分组(工作区 / 工作区树 / 单列表三种视图),组内按最近更新或手动排序,可折叠,可拖拽调整高度。
10
+ - **最近栏**:跨所有项目 + 未分组会话,按 `updatedAt` 倒序排列,右侧显示相对时间(刚刚 / N 分钟 / N 小时 / N 天 / 日期)。
11
+ - **双向定位**:在任一栏点击会话,另一栏自动展开对应分组并平滑滚动到该行。
12
+ - **搜索**:按名称检索会话(含历史消息片段),带防抖与中止请求。
13
+ - **会话操作**:打开、分叉、重命名、归档 / 取消归档、置顶 / 取消置顶、复制 Session ID。
14
+ - **项目管理**:新建会话、重命名、删除工作区、添加工作区目录。
15
+ - **状态指示**:进行中显示旋转圆环,需要用户交互时显示橙色问号圆环,有未读完成时显示小蓝点(会话获焦后自动消失)。
16
+ - **外观**:字号三级独立调节(区块标题 / 项目文件夹 / 会话,8–22px 连续可调)、面板背景三态(毛玻璃 / 与侧栏融合 / 增强对比)、状态标识左右可切换、中文 / English。
17
+
18
+ ## 安装
19
+
20
+ 在 DSH 中把本包作为 bundle 安装:
21
+
22
+ ```
23
+ plugin_manager action: install_bundle
24
+ target: <本包解压后的绝对路径> 或 dsh-sidebar-recent(已发布到 registry 时)
25
+ ```
26
+
27
+ 安装后 DSH 会通过 HMR 激活,无需重启。
28
+
29
+ 也可以直接指向 `.tgz`:
30
+
31
+ ```
32
+ plugin_manager action: install_bundle
33
+ target: C:\path\to\dsh-sidebar-recent-1.0.0.tgz
34
+ ```
35
+
36
+ ## 卸载 / 恢复原生
37
+
38
+ ```
39
+ plugin_manager action: set_plugin
40
+ target: dsh-sidebar-recent
41
+ enabled: false
42
+ ```
43
+
44
+ 停用后 DSH 原生工作区浏览器立即回到原位(插件以 `priority: -100` 抢占槽位,官方注册始终存活)。
45
+
46
+ ## 配置
47
+
48
+ 所有设置存于浏览器 `localStorage`:
49
+
50
+ | 键 | 说明 |
51
+ | --- | --- |
52
+ | `dsh.sidebar-recent.view.v8` | 当前视图配置(JSON) |
53
+ | `dsh.sidebar-recent.view.v8.backup` | 上一次写入前的自动备份 |
54
+
55
+ 视图配置项:`groupBy`、`orderBy`、`archivedFilter`、`expanded`、`wsCollapsed`、`recentCollapsed`、`fontSection`、`fontGroup`、`fontRow`、`panelStyle`、`indicatorSide`、`wsRatio`。
56
+
57
+ 外观参数在侧栏右上角的「视图选项」菜单里调整,改动即时保存。
58
+
59
+ ## 兼容性
60
+
61
+ - DSH Desktop / Web(`dsh.client.platform: web`)。
62
+ - 依赖槽位:`sidebar.workspaces`(`single`),并以 `children` 声明 `sidebar.workspaces.directoryFlow`、`sidebar.workspaces.session.menu.item`、`sidebar.workspaces.session.row.action`、`sidebar.session.row.leading`、`sidebar.session.row.hover`,与官方 ui-workspace 的槽位契约保持一致。
63
+ - 使用主题 token(`--dsw-alias-*`)着色,浅色 / 深色主题均可读;菜单底色按用户指定固定为 `#FCFDFD`。
64
+
65
+ ## 隐私
66
+
67
+ 纯前端插件:不联网、不上报、不读写项目文件。会话数据全部来自 DSH 客户端已有的服务与快照。
68
+
69
+ ## 许可
70
+
71
+ MIT