dsh-synapse 0.5.6 → 0.5.8

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
@@ -30,27 +30,48 @@
30
30
 
31
31
  | 你平时怎么用 DSH | 要装的 profile | 安装命令 |
32
32
  |---|---|---|
33
- | 桌面 App(DeepSeek Harness 客户端) | `desktop` | `corepack pnpm dsh plugin --profile desktop add dsh-synapse` |
34
- | 命令行 `dsh web` / 浏览器访问 | `web` | `corepack pnpm dsh plugin --profile web add dsh-synapse` |
35
- | 两种都用 | 两套各装一次 | 两条命令都执行 |
33
+ | 桌面 App(DeepSeek Harness 客户端) | `desktop` | `dsh plugin --profile desktop add dsh-synapse` |
34
+ | 命令行 `dsh web` / 浏览器访问(如果你也维护了这套) | `web` | `dsh plugin --profile web add dsh-synapse` |
36
35
 
37
36
  - 从 App 内的插件页面安装时,App 会自动装进它自己用的那套,不用管 profile。
38
- - **自检口诀:装完顶部看不到「会话地图」开关,就是装到另一套去了**,换成另一条命令再装一次即可。
37
+ - **自检口诀:装完顶部看不到「会话地图」开关,就是装到另一套去了**,把 `--profile` 换成另一套的名字再装一次即可。
39
38
  - 桌面 App 装完需要**重启 App**(Host 侧插件在启动时加载);命令行装的,重启 `dsh web` 并刷新页面。
40
39
 
40
+ `dsh` 是 DSH 运行时自带的 launcher,位于 App 安装目录的 `resources\runtime\cli\bin\dsh.cmd`。先确认它能调用:
41
+
42
+ ```powershell
43
+ dsh --version
44
+ ```
45
+
41
46
  ```powershell
42
- # 命令行方式:装好后启动
43
- corepack pnpm dsh plugin --profile web add dsh-synapse
44
- corepack pnpm dsh web
47
+ # 装进桌面 App 那套 profile
48
+ dsh plugin --profile desktop add dsh-synapse
49
+
50
+ # 需要命令行形态时(装完重启 dsh web 并刷新页面)
51
+ dsh plugin --profile web add dsh-synapse
52
+ dsh web
45
53
  ```
46
54
 
47
55
  启动后,在 DSH 顶部切换到 **会话地图**。Synapse 复用现有的 DSH Web Server,不会启动第二个应用或代理系统。
48
56
 
57
+ ## 反向代理与子路径部署
58
+
59
+ 支持部署在根目录或 `/dsh/` 等子路径下。入口、静态资源和 API 会保留 DSH 页面所在的对外目录;代理需剥掉子路径前缀,并将请求转发到 DSH 的根路由。例如:
60
+
61
+ ```nginx
62
+ location /dsh/ {
63
+ proxy_pass http://127.0.0.1:3080/;
64
+ }
65
+ ```
66
+
67
+ `proxy_pass` 的尾斜杠用于剥掉 `/dsh/` 前缀。启动时使用 `dsh web --public-url https://example.com/dsh/`,浏览器也从这个带尾斜杠的地址进入。Synapse 配置中的 `trustedHosts` 需包含对外主机名(例如 `example.com`)。无需额外添加站点根目录的 `/synapse` 跳转规则;更新插件后重启 DSH。
68
+
49
69
  ## 它解决什么问题
50
70
 
51
71
  | 能力 | 说明 |
52
72
  |---|---|
53
73
  | 对话地图 | 把连续追问、分支和不同会话放到同一张可操作的画布上。 |
74
+ | 聚焦会话 | 只显示选中会话及其派生分支;切换显示范围时保持当前镜头、缩放和卡片位置。 |
54
75
  | 保留真实分支 | 按 DSH 原生 fork 关系连接卡片,不制造另一套会话历史。 |
55
76
  | 追问更顺手 | 选中回答中的文字可直接带入新的追问;常用补充词可编辑。 |
56
77
  | 双向同步 | 在地图或 DSH 原生对话中切换会话,当前上下文保持一致。 |
@@ -59,8 +80,38 @@ corepack pnpm dsh web
59
80
  | 详情侧栏 | 点卡片在右侧展开整轮详情:完整回答、工具过程、追问 / 分支 / 打开 DSH。 |
60
81
  | 归档一致 | 归档在地图与 DSH 侧栏之间共用同一份集合,不会各记一套。 |
61
82
 
83
+ ## 聚焦会话与折叠
84
+
85
+ 地图默认显示**全工作区**。在左侧选中会话后,点击右上角**聚焦会话**,只显示该会话的全部轮次及其派生分支。侧栏仍保留所有会话;在聚焦模式中点击侧栏另一会话,会切换聚焦对象。点击地图中的分支卡片会同步 DSH 当前会话并打开详情,保留当前聚焦范围。
86
+
87
+ **全工作区 / 聚焦会话**只切换卡片和连线的显隐,保持当前镜头、缩放和卡片坐标。聚焦期间拖动画布或缩放后,返回全工作区也沿用当前视角;需要居中时可以单独点击**定位**。
88
+
89
+ 点击卡片右侧的 **−**,隐藏它的全部子卡片及后代,当前卡片保留;已折叠的子卡片也会一起隐藏。点击 **+** 再展开,子卡片原有的折叠状态和手动位置保留。
90
+
62
91
  ## 最近更新
63
92
 
93
+ **0.5.8 · 2026-11-22**
94
+
95
+ - 新增「全工作区 / 聚焦会话」显示范围切换,支持选中会话及其递归派生分支,改善会话过多时的阅读体验([#36](https://github.com/liangmianya/dsh-synapse/issues/36))。
96
+ - 切换显示范围只改变卡片和连线的显隐,保持当前视角与缩放;退出聚焦时不跳回此前的镜头。
97
+ - 修复嵌套折叠:父卡片收起时,已经折叠的子卡片及其后代也会隐藏,展开后保留子卡片自己的折叠状态。
98
+ - 补充聚焦范围、分支选择、嵌套折叠、镜头保持和工作区切换的行为测试,替换依赖代码写法的定位断言。
99
+
100
+ - 大地图按当前视野分区域加载卡片,移出视野后释放内容;缩小到概览时使用短预览,减少长会话的渲染和内存开销。
101
+ - 正文与 Markdown 缓存按容量限制回收,正文请求限制并发、分批加载;切换视图或隐藏地图时取消不再需要的加载,避免持续积累历史内容。
102
+ - 完整对话详情按每页 40 条消息浏览,默认打开最新一页;从历史卡片进入时定位到对应页面。工具过程默认折叠,展开后按需查看。
103
+ - 修正真实对话的轮次识别:一张卡片对应用户的一次真实提问及其回复,系统注入和工具步骤不会增加轮次。缺少来源字段的历史及导入消息继续兼容。
104
+ - 支持 `/dsh/` 等反向代理子路径,入口、静态资源和 API 保留对外路径前缀,配置方式见上方部署说明。
105
+ - 对话详情页统一消息、标题和操作区样式;卡片更新保留节点、输入和选中文字,流式回复合并更新,拖拽期间暂停刷新卡片。
106
+ - 清理固定样式、图标路径和旧渲染调用位置的测试断言,保留实际交互、分支、正文加载和内存限制检查;修复测试环境缺失的缓存模块与浏览器依赖。
107
+ - 移除临时侧栏调试面板、日志采集请求和相关埋点。
108
+
109
+ 升级后重启 DSH,会按原始会话日志的事件编号修复旧地图索引,并在首次修复前保留 `workspaces.json.projection-v2-backup`。真实消息标识、线程关系、颜色和手动位置保留;日志缺失、损坏或超出读取上限时保留旧记录,之后可在日志恢复后重启重试。
110
+
111
+ **0.5.7**
112
+
113
+ - 更新安装指南,使用 DSH 运行时自带的 `dsh plugin` 命令,并说明桌面 App 与命令行 profile 的区别。
114
+
64
115
  **0.5.6**
65
116
 
66
117
  - 顶部开关可拖动、记忆位置(按浏览器)、双击复位、方向键微调,并保证不会被拖到屏幕外。
@@ -102,6 +153,8 @@ corepack pnpm run build
102
153
  corepack pnpm test
103
154
  ```
104
155
 
156
+ 测试保存在源码的 `test/` 目录中,供开发和 GitHub CI 验证;该目录不包含在 npm 插件发布包中,日常运行插件不会执行测试。测试关注实际行为和资源边界,避免固定内部实现方式而限制后续优化。
157
+
105
158
  完整的贡献、CI/CD 和发布流程见[开发与发布指南](docs/development.md)。
106
159
 
107
160
  ## 许可证