@lyhue1991/dsh-soup 0.5.9 → 0.5.10

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.
Files changed (2) hide show
  1. package/README.md +23 -28
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,32 +1,24 @@
1
1
  # dsh-soup
2
2
 
3
- > DeepSeek Harness 本身是一大锅汤——营养丰富,但尝起来略显寡淡,不太好喝。dsh-soup 给它加上点 UI 调料,让它变得美味起来。
3
+ > DeepSeek Harness 本身是一大锅汤——营养丰富,但口味平淡。dsh-soup 给它加上点 UI 调料,让它变得美味起来。
4
4
 
5
5
  ## 为什么叫 soup
6
6
 
7
- DSH(DeepSeek Harness)功能很强:会话、工具、轨迹、Goal 一应俱全,营养都在汤里。但 UI 上略显寡淡——文件散在终端里、预览要跳出去、模型在跑你却看不到速度、长一点的目标被截成一行省略号。
7
+ DSH(DeepSeek Harness)功能很强:会话、工具、轨迹、Goal 一应俱全,营养都在汤里。
8
+
9
+ 但 UI 上略显平淡 —— 默认的右边侧栏不支持文件上传下载、文件预览铺在侧栏不在中间不够自然、模型在跑你却看不到实时速度、长一点的目标被截成一行省略号。
8
10
 
9
11
  **dsh-soup** 不重写 DSH,而是像下厨一样给这锅汤加几样调料:
10
12
 
11
- - 🧅 **葱** —— 右侧文件树,提鲜点缀,让项目结构在会话旁长出来;
12
- - 🫚 **姜** —— 会话内「预览」tab,去腥增香,Markdown / 代码 / 图片 / PDF / Notebook 就地看;
13
+ - 🧅 **葱** —— JupyterLab风格的右侧文件树,提供 文件上传,下载,删除,系统打开等常用操作。
14
+ - 🫚 **姜** —— 会话中间「预览」tab,支持 Markdown / HTML / 图片 / PDF 等常见格式预览,代码等常见文本格式还可编辑。
13
15
  - 🧄 **蒜** —— 多行 GoalBar,味重提味,把那条总被截断的目标条熬成完整一行行;
14
- - 🧂 **盐** —— 输入框上方的实时 `t/s` 速率徽标,百味之首,虽小却提味,实时知道模型跑得多快。
16
+ - 🧂 **盐** —— 顶部的实时 `t/s` 速率徽标,百味之首,虽小却提味,实时知道模型跑得多快。开车有了仪表盘,推背感立马就上来了。
15
17
 
16
18
  四样调料,一个插件,三平台通用(macOS / Linux / Windows)。装上之后——DSH 还是那锅汤,只是变得美味了。
17
19
 
18
20
  ![dsh-soup 界面预览:右侧文件树 + 会话内预览 tab + 速率徽标](view.jpg)
19
21
 
20
- ## 速览
21
-
22
- | 调料 | 是什么 | 一句话 |
23
- | --- | --- | --- |
24
- | 🧅 右侧文件树 | 和左侧工作区并列的右列文件浏览器 | 提鲜点缀,结构在旁长出来 |
25
- | 🫚 会话内预览 | 会话区顶部新增「预览」标签页 | 去腥增香,内容就地入味 |
26
- | 🧄 多行 GoalBar | 不再被截断的多行目标条 | 味重提味,目标完整入味 |
27
- | 🧂 速率徽标 | 输入框上方的彩色 `t/s` 指示 | 百味之首,小而提味 |
28
-
29
- ---
30
22
 
31
23
  ## 它能给你什么
32
24
 
@@ -35,7 +27,7 @@ DSH(DeepSeek Harness)功能很强:会话、工具、轨迹、Goal 一应
35
27
  一个真正和左侧工作区并列的文件浏览器——不悬浮、不遮挡,配色与宽度都与左侧一致(默认 360px,拖左缘在 300–520px 间调整)。
36
28
 
37
29
  - **跟随会话**:自动展示当前会话的工作目录,切会话/工作区时跟着走。
38
- - **右键菜单**:预览、用系统打开、重命名、移到废纸篓、复制完整路径、下载到本机。
30
+ - **右键菜单**:预览、用系统打开、重命名、移到废纸篓、复制路径、下载;目录多出新建文件、新建文件夹、上传。
39
31
  - **多选与拖拽**:⌘/Ctrl 加选、Shift 连选;文件拖进目录即移动;系统文件拖入即上传(>1MB 自动分块,带实时进度)。
40
32
  - **类型图标**:按品牌色区分文件类型(notebook 橙、markdown 紫、json 黄、pdf 红…)。
41
33
  - **沙箱围栏**:所有文件操作只能落在你的工作区与会话目录内,越界自动拒绝。
@@ -73,11 +65,12 @@ DSH(DeepSeek Harness)功能很强:会话、工具、轨迹、Goal 一应
73
65
 
74
66
  ### 🧂 模型实时速率徽标(附赠 · 盐 · 百味之首)
75
67
 
76
- 输入框正上方的一枚小徽标,模型生成时出现、结束自动消失——让你对「现在到底在等还是在跑、跑得多快」有直观感受。
68
+ 会话头部、Agent 预设标签右侧的一枚小徽标,模型生成时出现、结束自动消失——让你对「现在到底在等还是在跑、跑得多快」有直观感受。
77
69
 
78
70
  - **等待阶段**:灰色「正在等待模型...」(省略号 1→2→3 原地循环)。
79
71
  - **流式阶段**:token 计数 + 彩色 `t/s` 速率(≥50 青 / ≥30 绿 / ≥15 黄 / 其余红)。
80
72
  - **数据可信**:来自模型真实流(不是浏览器端估算);用近 2 秒滑动窗口算瞬时速率,中途停顿会回到等待态,不会被摊成个位数。
73
+ - **只看当前会话**:徽标只呈现当前会话的输出速率;后台任务或别的会话在跑,不会串到当前会话的徽标上。
81
74
 
82
75
  ---
83
76
 
@@ -95,27 +88,29 @@ dsh plugin add @lyhue1991/dsh-soup
95
88
 
96
89
  - **打开文件树**:点击 Session log 右侧的 📁;空白新会话则在输入框上方右端找 📁。
97
90
  - **预览文件**:在文件树里双击文件,或右键选「👁 预览」。
98
- - **看速率**:向任意会话发一条消息,输入框上方即出现徽标。
91
+ - **看速率**:向任意会话发一条消息,顶部状态栏即出现徽标。
99
92
  - **多行 GoalBar**:创建 goal 后自动以多行展示。
100
93
 
101
- ## 更新日志
102
-
103
- - **0.4.x** — Seti 图标字体(60 种字形覆盖 122 种扩展名)+ 空会话预览浮层(最大化/还原)+ 微信文章兼容 + 文本上限 8 MB + 关闭按钮尺寸修复 + 预览路径 rtl 修复 + i18n 语言适配 + 预览纯阅读模式 + 内部分区重排 + 预览头部冻结 + details 宽度对齐宿主合同。
104
- - **0.3.x** — Markdown 相对路径图片内联渲染 + 自动刷新(3s mtime 探测 + 指数退避)+ JupyterLab 风格工具栏图标。
105
- - **0.2.0** — 改名 `dsh-tree` → `dsh-soup`。
106
- - **0.1.x** — 只读文件预览系统(md/html/json/csv/pdf/notebook/图片/代码高亮)、大文件流式下载、多行 GoalBar、模型吞吐徽标、空白新会话入口、跨平台 node:fs 文件核心。
107
-
108
94
  ## 开发
109
95
 
110
- 纯 JS 产物,无需构建:
96
+ 宿主半区纯 JS;浏览器半区由 esbuild 打包(产物 `lib/client.js` 勿手编)。需要 Node ≥ 22。
111
97
 
112
- - `lib/index.js` — 宿主半区(注册 `/api/dsh-soup` 文件操作路由 + `llm/stream` 速率统计)。
113
- - `lib/client.js` — 浏览器半区(右侧文件树面板 + 预览 tab + 速率徽标 + 多行 GoalBar,内联 CSS)。
98
+ - `lib/index.js` — 宿主入口:注册 `/api/dsh-soup` 路由(文件操作 + 速率查询),组装各供给器。
99
+ - `lib/client/` — 浏览器半区模块(文件树、预览、速率徽标、多行 GoalBar、i18n、样式等)。
100
+ - `lib/host/` — 宿主半区模块(路径围栏、文件读写、资源路由、速率跟踪、系统打开)。
101
+ - `lib/client.js` — 打包产物(`npm run build` 生成)。
114
102
  - `cordis.patch.yml` — 在组合中插入 `ui-dsh-soup`。
103
+ - `skills/debug-dsh-plugin/` — DSH 插件调试技能(CDP 探针、安全重启脚本)。
115
104
 
116
105
  ```sh
117
106
  git clone https://github.com/lyhue1991/dsh-soup.git
118
107
  cd dsh-soup
108
+ npm install
109
+ ```
110
+
111
+ ```sh
112
+ npm run build # esbuild 打包 lib/client.entry.js → lib/client.js
113
+ npm test # build + node --test(客户端静态断言/渲染测试 + 宿主 RPC 冒烟)
119
114
  ```
120
115
 
121
116
  ## 许可证
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@lyhue1991/dsh-soup",
3
3
  "description": "DSH 项目资源管理器:右侧 details 列文件树(并列网格、宽度对齐宿主 details 合同 300-520px),有 Session log 时在其右侧、空白新会话在输入框上方右端提供 📁 切换按钮;支持多选、双击展开/打开、右键菜单(打开/系统打开/重命名/废纸篓/新建/复制路径)、拖拽移动、上传。文件「打开」在会话区新增「文件」标签页(原生 conversation.view,与对话/轨迹同级):文本可编辑 ⌘S 保存、图片预览、二进制提示。附带模型吞吐徽标:输入框正上方显示「正在等待模型...」与彩色 t/s 徽标(数据来自 llm/stream 真实流)。附带 GoalBar 多行展示:把原生单行截断 GoalBar 放开为多行完整显示,编辑用 textarea,工具与数据仍走原生 goal。",
4
- "version": "0.5.9",
4
+ "version": "0.5.10",
5
5
  "type": "module",
6
6
  "main": "lib/index.js",
7
7
  "scripts": {