@lyhue1991/dsh-soup 0.2.0 → 0.3.0

package/README.md

@@ -1,140 +1,131 @@
-# dsh-soup — DSH 项目资源管理器
-
-一个可安装的 DSH（DeepSeek Harness）插件：在会话右侧以**并列网格列**的形式提供项目文件树，与左侧工作区同款配色、同宽（默认 280px，可拖拽 264–420px）。文件「预览」在会话区新增**「预览」标签页**（原生 `conversation.view`，与 对话/轨迹 同级），采用**只读预览**：Markdown / HTML / JSON / CSV·TSV 专属渲染、图片预览、其余纯文本（不提供编辑保存）。并附带**模型吞吐徽标**（输入框正上方实时显示「正在等待模型...」与彩色 `t/s` 速率）与**GoalBar 多行展示**（把原生单行截断 GoalBar 放开为多行完整显示）。**三平台通用**（macOS / Linux / Windows）。
-
-## 功能
-
-### 文件标签页
-- **入口**：资源管理器中右键「👁 预览」或双击文件，会话头部自动出现「预览」tab（原生 `conversation.view` 槽位，`ui-trajectory` 同款注册方式，不改 DSH 源码）。
-- **多文件**：单个「文件」tab 内部子 tab 条管理多个已开文件；切走再切回内容不丢；子 tab 可单独关闭。
-- **只读预览**：不提供编辑与保存（宿主也无 `write` 动作），所见即磁盘内容，⟳ 重载刷新。
-- **Markdown 预览**：复用 DSH 客户端自带的不可信渲染器 `MarkdownText`（micromark 管线，禁不安全协议/相对链接；旧版宿主缺该模块时自动回退纯文本）。
-- **HTML 预览**：可交互沙箱 iframe（`allow-scripts/popups/forms/modals`，**不给 `allow-same-origin`**——页面脚本跑在 opaque origin，触不到 GUI 的 DOM/存储/Cookie）+ `srcdoc` 注入 + `no-referrer`。
-- **JSON 预览**：解析后 pretty-print + 轻量语法着色（键/字符串/数字/布尔/null）；解析失败回退纯文本并提示。
-- **CSV / TSV 预览**：RFC 4180 引号感知解析（内嵌逗号/换行/`""` 转义）、首行作表头（sticky）、最多预览 500 行 × 64 列并提示截断。
-- **代码语法高亮**：常见语言（js/ts/jsx/tsx、python、go、rust、java、c/cpp、c#、ruby、php、kotlin、swift、shell、yaml/toml/ini、css/scss/less、sql、xml、lua 等）复用 DSH 的 `CodeBlock`（Shiki JS 引擎，主题跟随 `--shiki-*` token），扩展名映射对齐 DSH 读卡片；语法包懒加载——首帧可能纯文本，加载完成后自动补上高亮；超 40 万字符的大文件与未知扩展名回退纯文本。
-- **PDF 预览**：整文件 base64（≤20MB）交给浏览器原生 PDF 查看器渲染——JupyterLab pdf-extension 同思路（base64 → Blob → object 嵌入，含缩放/搜索工具栏）；超限提示用系统打开。
-- **Notebook 预览（.ipynb）**：GitHub 风格静态渲染——markdown 单元走 `MarkdownText`、代码单元走 `CodeBlock` 高亮、gutter 显示执行序号；输出按 MIME 择优：image/png·jpeg·gif·svg 内联、text/html 沙箱 iframe（禁脚本）、stream/error 分别以输出块与红块 traceback 展示（剥离 ANSI）；兼容 nbformat 4 与 v3（worksheets）。读取上限放宽至 20MB（含图输出的 base64 膨胀）。
-- **会话隔离**：预览列表跟随当前会话工作目录；切换到其他项目的会话时，范围外的预览 tab 自动关闭。
-- **FIFO 上限**：同时最多 5 个预览 tab，打开第 6 个时自动关闭最早的一个（先进先出）。
-- **图片预览**：png/jpg/gif/webp/svg 等按 base64 内联展示（上限 8 MB）。
-- **二进制**：NUL 嗅探判定后只读提示；文本超过 2 MB 截断展示并提示。
-
-### 资源管理器
-- **右侧详情列（details）文件树**：与会话区真正并列（三列网格 `侧栏 | 会话 | 资源管理器`），不悬浮、不遮挡。
-- **宽度与左侧工作区完全一致**：默认 280px，拖左边缘在 264–420px 间调整（shell 自带 details 列被硬限制在 300–520px，本插件直接改写网格轨实现同宽）。
-- **切换按钮**：有 Session log 时保持在「Session log」胶囊右侧；空白新会话则在输入框上方右端显示 📁，与 workspace / preset 控件同一水平线。
-- **上传与分块**：拖入/选择多文件上传；超过 1MB 自动走分块通道（JupyterLab 同款语义：首块覆盖、后续追加），面板路径栏下方显示实时进度行（队列 n/m + 百分比），完成后短暂提示 ✓。
-- **文件类型图标**：采用 JupyterLab `ui-components` 的 filetype SVG 集（BSD-3-Clause）——notebook 橙、markdown 紫、json 黄、pdf 红、表格绿等固定品牌色，16px 渲染；未命中扩展名按「已知代码语言 → 文本编辑器图标，其余 → 空白文件」兜底。
-- **跟随会话**：默认展示当前会话工作目录（`session.header.cwd`），切换会话/工作区自动跟随；路径栏只读展示，不可跳转。
-- **文件操作**（右键菜单）：预览、用系统打开、重命名、移到废纸篓、复制完整路径、⬇ 下载到本机（菜单末项）——POST 换取一次性 2 分钟时效票据 URL；≤100MB 页面内 fetch 流式进度 + Blob 另存（进度行同上传），>100MB 浏览器原生下载（零内存，提示浏览器接管）；空白处右键可刷新。
-- **多选**：⌘/Ctrl 加选、Shift 连选；多选时批量移到废纸篓、批量拖拽移动。
-- **拖拽**：文件/文件夹拖到目录移动；系统文件拖入上传。
-- **交互**：单击选中、双击文件夹展开/收起、双击文件系统打开、⌘ 打开文件、F2/回车/Delete/Escape 等键位习惯（行内重命名选中扩展名前半段）。
-
-### 模型吞吐徽标
-- 输入框**正上方居中**显示，运行中（`llm/stream` 流期间）出现、结束后自动消失。
-- **等待阶段**：`正在等待模型...` 灰色文字，省略号 `.`→`..`→`...` 原地循环（文字不滚动）。
-- **流式阶段**：token 计数（向下箭头）+ 彩色 `xx.x t/s` 徽标（≥50 青 / ≥30 绿 / ≥15 黄 / 其余红）。
-- **数据源**：Host 包 `llm/stream` waterfall 实时统计真实 chunk/token（优先 usage 的 `outputTokens`，退化 CJK 字符估算），比浏览器端估算更准。
-
-### GoalBar 多行展示
-- 在 DSH 原生 GoalBar 基础上**仅调整展示**：把单行截断（`text-overflow: ellipsis`）放开为**多行完整显示**（`white-space: pre-wrap`），编辑控件从 `input` 改为 `textarea`。不改 DSH 源码，用 `conversation.input.dock` 槽位同 id + 更低 priority 遮蔽默认实现。
-- **数据与工具**：完全复用原生 goal projection 与原生 `create_goal` / `get_goal` / `update_goal` 工具，不替换、不遮蔽。
-- **操作按钮**：暂停 / 恢复 / 编辑 / 清除（与原生 GoalBar 一致）。
-- **轮次**：显示原生 goal projection 的 `roundsStarted/maxGoalRounds`。
-- **编辑**：点击 ✏️ 进入 textarea 编辑，`Ctrl/⌘ + Enter` 保存、`Esc` 取消。
+# dsh-soup
 
-## 安装
+> DeepSeek Harness 本身是一大锅汤——营养丰富，但尝起来略显寡淡，不太好喝。dsh-soup 给它加上点 UI 调料，让它变得美味起来。
 
-> 需要 DSH Desktop（或支持 `dsh plugin add` 的 DSH 安装）。插件作为 profile bundle 安装。
+## 为什么叫 soup
 
-```sh
-# 安装最新版（npm 包名 @lyhue1991/dsh-soup）
-dsh plugin add @lyhue1991/dsh-soup
-```
+DSH（DeepSeek Harness）功能很强：会话、工具、轨迹、Goal 一应俱全，营养都在汤里。但 UI 上略显寡淡——文件散在终端里、预览要跳出去、模型在跑你却看不到速度、长一点的目标被截成一行省略号。
 
-或通过 DSH Desktop「设置 → 插件 → 插件市场」搜索安装。
+**dsh-soup** 不重写 DSH，而是像下厨一样给这锅汤加几样调料：
 
-安装后重启 DSH，在 Session log 右侧或空白会话输入框上方右端点击 📁 即可打开资源管理器；向任意会话发送消息即可看到吞吐徽标。
+- 🧅 **葱** —— 右侧文件树，提鲜点缀，让项目结构在会话旁长出来；
+- 🫚 **姜** —— 会话内「预览」tab，去腥增香，Markdown / 代码 / 图片 / PDF / Notebook 就地看；
+- 🧄 **蒜** —— 多行 GoalBar，味重提味，把那条总被截断的目标条熬成完整一行行；
+- 🧂 **盐** —— 输入框上方的实时 `t/s` 速率徽标，百味之首，虽小却提味，实时知道模型跑得多快。
 
-## 更新日志
+四样调料，一个插件，三平台通用（macOS / Linux / Windows）。装上之后——DSH 还是那锅汤，只是变得美味了。
 
-### 0.1.13（当前）
+![dsh-soup 界面预览：右侧文件树 + 会话内预览 tab + 速率徽标](view.jpg)
 
-- **预览标签页**：资源管理器右键「👁 预览」/双击文件，在会话区新增「预览」tab（原生 `conversation.view` 槽位，与 对话/轨迹 同级）：
-  - 宿主半区新增 `read`（文本截断读取 / 图片 base64 / NUL 二进制嗅探）动作，走 `node:fs/promises`。
-  - 单 tab 内子 tab 条管理多文件；只读预览（md/html/json/csv 渲染 + 纯文本兜底）、⟳ 重载；图片内联预览。
-  - 右键菜单第一项为「👁 预览」（标签页展示），原「🖥 用系统打开」保留为第二项。
+## 速览
 
-### 0.1.12
+| 调料 | 是什么 | 一句话 |
+| --- | --- | --- |
+| 🧅 右侧文件树 | 和左侧工作区并列的右列文件浏览器 | 提鲜点缀，结构在旁长出来 |
+| 🫚 会话内预览 | 会话区顶部新增「预览」标签页 | 去腥增香，内容就地入味 |
+| 🧄 多行 GoalBar | 不再被截断的多行目标条 | 味重提味，目标完整入味 |
+| 🧂 速率徽标 | 输入框上方的彩色 `t/s` 指示 | 百味之首，小而提味 |
 
-- **吞吐徽标状态修复**：
-  - 流式输出开始后立即显示 token 计数，不再因速率暖机窗口（0.5s）而停留在「正在等待模型...」（此前短输出全程显示等待）。
-  - 速率改为**滑动窗口瞬时值**（近 2s 采样），不再是从首 chunk 起的累计平均——中途停顿不会把 t/s 慢慢摊到个位数。
-  - 新增**停顿检测**：流中超过 2s 无新 chunk 时回到「正在等待模型...」。
+---
 
-### 0.1.11
+## 它能给你什么
 
-- **新会话入口**：有 Session log 时保留原会话头部入口；空白新会话在输入框上方、workspace / preset 控件行右端显示备用入口，不占用输入框内部空间。
+### 🧅 右侧文件树（主打 · 葱 · 提鲜点缀）
 
-### 0.1.10
+一个真正和左侧工作区并列的文件浏览器——不悬浮、不遮挡，配色与宽度都与左侧一致（默认 280px，拖左缘在 264–420px 间调整）。
 
-- **简化 Goal**：移除自定义 `create_goal` / `get_goal` / `update_goal` 工具覆盖与 token 预算桥（`goal-view` / `goal-action`），改回使用 DSH 原生 goal 工具与 goal projection。
-- **GoalBar 多行展示**：把原生单行截断 GoalBar 放开为多行完整显示（`white-space: pre-wrap`），编辑控件从 `input` 改为 `textarea`，其余（按钮、动作、主题）与原生一致。
+- **跟随会话**：自动展示当前会话的工作目录，切会话/工作区时跟着走。
+- **右键菜单**：预览、用系统打开、重命名、移到废纸篓、复制完整路径、下载到本机。
+- **多选与拖拽**：⌘/Ctrl 加选、Shift 连选；文件拖进目录即移动；系统文件拖入即上传（>1MB 自动分块，带实时进度）。
+- **类型图标**：按品牌色区分文件类型（notebook 橙、markdown 紫、json 黄、pdf 红…）。
+- **沙箱围栏**：所有文件操作只能落在你的工作区与会话目录内，越界自动拒绝。
+- **自动刷新**：每 3 秒轻量探测一次目录签名（mtime），有变化才重拉——agent 或终端里的文件增删改无需手动刷新即可出现；面板关闭且无预览时零开销；宿主不可达（如 DSH 重启中）自动指数退避（封顶 60s）。
+- **一键刷新**：顶部 ⟳ 重拉整个文件树，已展开的子目录保持展开不收起。
 
-### 0.1.8
+### 🫚 会话内文件预览（主打 · 姜 · 去腥增香）
 
-### 0.1.7
+双击文件、或右键「👁 预览」，会话区顶部就会新增一个**「预览」标签页**，和「对话 / 轨迹」同级——看文件不用跳出当前会话。
 
-- **速度徽标稳定化**：徽标贴附 Deep diving 状态行（DOM 注入 + MutationObserver），使用 `-webkit-text-fill-color` + `important` 修复 `background-clip: text` 渐变对子元素颜色的影响；已挂载快路径避免重复扫描；徽标始终跟随 Deep diving 的 15s 计时。
+- **多文件子标签**：单个「预览」tab 内用子标签条管理多个文件，切走再切回内容不丢；最多同时开 5 个，超出按先进先出挤掉最早的。
+- **只读预览**（⟳ 可重载，不提供编辑/保存），按类型自动选渲染方式：
+  - **Markdown**：渲染为富文本（复用 DSH 聊天同款渲染器）。
+  - **HTML**：可交互沙箱（脚本被隔离，碰不到 GUI 的 DOM/存储）。
+  - **JSON**：格式化 + 语法着色。
+  - **CSV / TSV**：表格视图（引号感知、首行作表头、最多 500 行 × 64 列）。
+  - **代码**：常见语言语法高亮（Shiki，主题跟随 DSH 明暗）。
+  - **PDF**：浏览器原生查看器（≤20MB，含缩放/搜索）。
+  - **Notebook（.ipynb）**：GitHub 风格静态渲染（代码高亮 + 图片/输出内联）。
+  - **图片**：png/jpg/gif/webp/svg 等内联展示（≤8MB）。
+  - **其余**：二进制给出提示，超大文本截断为纯文本。
+- **跟随会话**：切到别的项目时，范围外的预览自动关闭。
+- **自动重读**：正在看的文件被外部（agent / 编辑器）修改时，预览内容几秒内自动更新，无需手动点「⟳ 重载」。
 
-### 0.1.5
+### 🧄 多行 GoalBar（附赠 · 蒜 · 味重提味）
 
-- **跨平台**：`move` / `create` / `upload` 改用 `node:fs/promises`（macOS / Linux / Windows 通用，消除 shell 命令依赖与注入面）；`open` / `trash` 按平台分支选命令（见下方「平台」表）。
-- **模型吞吐徽标**：输入框正上方显示「正在等待模型...」（省略号 1→2→3 循环）与彩色 `t/s` 徽标，数据来自 `llm/stream` 真实流。
+把 DSH 原生那条总是被截断成一行、末尾 `…` 的 GoalBar，放开成**多行完整显示**，编辑控件也从单行 `input` 换成 `textarea`。
 
-### 0.1.3
+- **数据与工具完全复用原生**：goal 的增删改查仍走 DSH 原生 `create_goal` / `get_goal` / `update_goal`，不替换、不遮蔽数据。
+- **操作一致**：暂停 / 恢复 / 编辑 / 清除按钮与原生 GoalBar 相同；编辑时 `Ctrl/⌘ + Enter` 保存、`Esc` 取消。
+- **不改 DSH 源码**：以更低优先级遮蔽默认实现，主题跟随桌面明暗。
 
-- 修复 details 插槽注册优先级，确保文件树面板正确显示在右侧详情列。
-- 修复浏览器半区的布局实例引用，供文件树面板的布局操作正常使用。
+### 🧂 模型实时速率徽标（附赠 · 盐 · 百味之首）
 
-## 开发
+输入框正上方的一枚小徽标，模型生成时出现、结束自动消失——让你对「现在到底在等还是在跑、跑得多快」有直观感受。
+
+- **等待阶段**：灰色「正在等待模型...」（省略号 1→2→3 原地循环）。
+- **流式阶段**：token 计数 + 彩色 `t/s` 速率（≥50 青 / ≥30 绿 / ≥15 黄 / 其余红）。
+- **数据可信**：来自模型真实流（不是浏览器端估算）；用近 2 秒滑动窗口算瞬时速率，中途停顿会回到等待态，不会被摊成个位数。
+
+---
+
+## 安装
+
+> 需要 DSH Desktop（或任何支持 `dsh plugin add` 的 DSH 安装）。
 
 ```sh
-git clone https://github.com/lyhue1991/dsh-soup.git
-cd dsh-soup
-# 纯 JS 产物，无需构建：
-#   lib/index.js  —— 宿主半区（webServer 路由 /api/dsh-soup，含 llm/stream 统计）
-#   lib/client.js —— 浏览器半区（__ModuleLoader__ 工厂，内联 CSS）
+dsh plugin add @lyhue1991/dsh-soup
 ```
 
-`cordis.patch.yml` 在组合中插入一行 `ui-dsh-soup`，`dsh.bundle.patch` 指向它；`dsh.client.inject` 声明浏览器半区依赖的客户端包。
+或在 DSH Desktop「设置 → 插件 → 插件市场」搜索 **dsh-soup** 安装。安装后**重启 DSH** 即可生效。
 
-## 实现说明
+## 上手
 
-- **宿主↔浏览器桥梁**：永久插件（profile bundle）不经过 dynamic runner，没有 `harness.handle`/`host.call`；宿主用 `webServer.register({ kind: 'exact', path: '/api/dsh-soup', handler })` 注册同源 HTTP 路由，浏览器用 `fetch` POST JSON 调用（`{ action, args }` 分派）。
-- **动作**：`root` / `sessionCwd` / `list` / `open` / `trash` / `move` / `create` / `upload` / `download` / `speed-status`（返回 `{ phase, tokens, tps, ttft }`）。
-- **跨平台**：`move` / `create` / `upload` 直接用 `node:fs/promises`（`rename`/`mkdir`/`writeFile`），mac/Linux/Windows 通用、无 shell 注入面；仅 `open` / `trash` 这类「唤起系统」的动作按 `process.platform` 分支选命令（见下表）。
-- **吞吐统计**：`ctx.on('llm/stream', ...)` 包装 waterfall，按会话（`sessionId`/`agent.id`/`meta` 探测）维护 `{ phase: waiting|streaming|done, tokens, tps, ttft }`；首 chunk 到达标记 streaming（TTFT），结束后 4s 清除；`speed-status` 查询时按流开始累计秒数算平均 t/s（0.5s 暖机）。等待态文字用主题 token `--dsw-alias-label-caption`（与 shell 计时同款灰）。
-- **宽度接管**：MutationObserver 监听 shell 框架的 `grid-template-columns`，把 details 轨改写为插件宽度（264–420px），并在 shell 重渲染后保持；`[data-side="details"]` 隐藏 shell 自带手柄，改用面板左缘自定义拖拽手柄。
-- **主题**：全部使用 DSH 主题 token（`--dsw-specific-sidebar-fill`、`--dsw-alias-*` 等），跟随桌面明暗配色。
+- **打开文件树**：点击 Session log 右侧的 📁；空白新会话则在输入框上方右端找 📁。
+- **预览文件**：在文件树里双击文件，或右键选「👁 预览」。
+- **看速率**：向任意会话发一条消息，输入框上方即出现徽标。
+- **多行 GoalBar**：创建 goal 后自动以多行展示。
+
+## 更新日志
 
-## 安全模型
+- **0.3.0（当前）** —
+  - **Markdown 预览渲染相对路径图片**：`![x](view.jpg)` 经同源 `/api/dsh-soup/img` 端点内联加载（confine 围栏 + 仅图片类型 + 拒跨站）。
+  - **自动刷新**：资源管理器与预览页每 3 秒轻量探测目录/文件签名（mtime），变了才重拉；面板关闭且无预览时零开销；宿主不可达时指数退避（封顶 60s）。
+  - **顶部 ⟳ 刷新按钮**：重拉整棵树并保持已展开子目录不收起；空白右键「刷新」项同步升级为同一枚图标。
+  - **工具栏按钮升级**：头部 ⟳/⬆/✕ 与预览「重载」对齐 JupyterLab 设计（26px 触达区 + SVG 图标，BSD-3 引用）；修复关闭按钮渲染异常。
+- **0.2.0** — 改名 `dsh-tree → dsh-soup`（npm 包 `@lyhue1991/dsh-soup`）。
+- **0.1.18** — 下载进度行 + 完成通知自动消失。
+- **0.1.17** — 大文件流式下载（一次性票据 URL + 流式发送），替代 base64-over-JSON，任意大小零内存放大。
+- **0.1.16** — 下载菜单项 + 复制完整路径修复 + 目录展开态图标。
+- **0.1.15** — 只读文件预览系统：会话区新增「预览」tab（md/html/json/csv·tsv 渲染 + 图片/PDF/Notebook/代码高亮 + 纯文本兜底）；宿主新增 `read` 动作；路由安全加固。
+- **0.1.12** — 吞吐徽标状态修复：流式即显 token 计数、滑动窗口瞬时 `t/s`、停顿检测回等待态。
+- **0.1.11** — 空白新会话入口（输入框上方右端 📁）。
+- **0.1.10** — GoalBar 改用原生 goal 工具 + 多行展示（textarea）。
+- **0.1.7** — 速度徽标稳定化（贴附 Deep diving 状态行）。
+- **0.1.5** — 跨平台：文件核心走 `node:fs`；新增模型吞吐徽标。
+- **0.1.3** — 修复 details 插槽优先级与布局实例引用。
 
-- **请求门**：`/api/dsh-soup` 仅接受 POST；带 `Origin` 时必须与 `Host` 同源（挡跨站 CSRF 与 DNS rebinding），且强制 `x-dsh-soup: 1` 自定义头 + `content-type: application/json`——自定义头迫使浏览器先走 CORS preflight，而本路由永不返回 CORS 头，恶意网页无法用 `text/plain` 简单请求盲打写操作。非浏览器本地工具（无 Origin）不受影响。
-- **路径围栏**：除 `list` 走沙箱 `fs.resolve` 外，所有具名文件操作（`read`/`move`/`trash`/`open`/`create`/`upload`）先经 `confine()`：realpath 解析后必须落在「workspace 根 ∪ 所有已知会话 cwd」子树内（请求可携带 sessionId，供新会话注册滞后时直查其 cwd 兜底；list/read/download 遇竞态 403 自动重试），越界返回 403。realpath 解析可防符号链接逃逸，且容忍目标末级尚不存在（新建/上传/移动目的地）。已知残留：confine 与实际操作之间存在理论上的 TOCTOU 窗口（符号链接竞态），Node 可移植 API 无法根除。
-- **文件名校验**：`create` 与 `upload` 的 `name` 一律拒绝 `.`、`..`、路径分隔符与 NUL，杜绝 `../` 穿越。
+## 开发
 
-## 平台
+纯 JS 产物，无需构建：
 
-| 平台 | 系统打开 (`open`) | 移到废纸篓 (`trash`) | 移动/新建/上传 |
-| --- | --- | --- | --- |
-| macOS | `/usr/bin/open` | Finder `osascript` | `node:fs` |
-| Linux | `xdg-open` | `gio trash`（回退 `trash-cli`） | `node:fs` |
-| Windows | `cmd /c start` | PowerShell `Shell.Application`（回收站） | `node:fs` |
+- `lib/index.js` — 宿主半区（注册 `/api/dsh-soup` 文件操作路由 + `llm/stream` 速率统计）。
+- `lib/client.js` — 浏览器半区（右侧文件树面板 + 预览 tab + 速率徽标 + 多行 GoalBar，内联 CSS）。
+- `cordis.patch.yml` — 在组合中插入 `ui-dsh-soup`。
 
-> 文件核心（浏览/移动/新建/上传）三平台完全一致；仅「系统打开」与「移到废纸篓」依赖各平台自带工具，这是 VS Code / Electron 等所有应用的标准做法。
+```sh
+git clone https://github.com/lyhue1991/dsh-soup.git
+cd dsh-soup
+```
 
 ## 许可证
 

package/lib/client.js

@@ -53,8 +53,9 @@ window.__ModuleLoader__.load({
       '.expl-head{display:flex;align-items:center;justify-content:space-between;gap:8px;padding:12px 14px;border-bottom:1px solid var(--dsw-alias-border-l1);flex:none;}' +
       '.expl-title{font-weight:600;color:var(--dsw-alias-label-primary);white-space:nowrap;font-size:14px;}' +
       '.expl-head-btns{display:flex;gap:2px;flex-wrap:nowrap;}' +
-      '.expl-btn{background:transparent;border:none;color:var(--dsw-alias-label-secondary);font-size:15px;cursor:pointer;padding:3px 7px;border-radius:8px;}' +
+      '.expl-btn{width:26px;height:26px;display:flex;align-items:center;justify-content:center;background:transparent;border:none;color:var(--dsw-alias-label-secondary);font-size:15px;cursor:pointer;padding:0;border-radius:8px;flex:none;}' +
       '.expl-btn:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary);}' +
+      '.expl-btn svg{width:16px;height:16px;display:block;}' +
       '.expl-path{font-size:11px;color:var(--dsw-alias-label-secondary);padding:7px 14px;border-bottom:1px solid var(--dsw-alias-border-l1);white-space:nowrap;overflow:hidden;text-overflow:ellipsis;direction:rtl;text-align:left;flex:none;cursor:default;}' +
       '.expl-error{color:var(--dsw-alias-state-error-primary);padding:6px 14px;font-size:12px;border-bottom:1px solid var(--dsw-alias-border-l1);flex:none;}' +
       '.expl-notice{color:var(--dsw-alias-state-success-primary);padding:6px 14px;font-size:12px;border-bottom:1px solid var(--dsw-alias-border-l1);flex:none;}' +
@@ -78,7 +79,8 @@ window.__ModuleLoader__.load({
       '.expl-muted{color:var(--dsw-alias-label-tertiary);padding:4px 14px;font-size:12px;}' +
       '.expl-menu-mask{position:fixed;inset:0;z-index:1980;}' +
       '.expl-menu{position:fixed;z-index:1990;min-width:172px;background:var(--dsw-specific-menu);border:1px solid var(--dsw-alias-border-inverted);border-radius:12px;padding:4px;box-shadow:var(--dsw-shadow-lv3);pointer-events:auto;}' +
-      '.expl-menu-item{display:block;width:100%;text-align:left;background:transparent;border:none;color:var(--dsw-alias-label-primary);font-size:13px;padding:6px 10px;border-radius:8px;cursor:pointer;line-height:1.4;}' +
+      '.expl-menu-item{display:flex;align-items:center;gap:7px;width:100%;text-align:left;background:transparent;border:none;color:var(--dsw-alias-label-primary);font-size:13px;padding:6px 10px;border-radius:8px;cursor:pointer;line-height:1.4;}' +
+      '.expl-menu-ico{flex:none;display:inline-flex;align-items:center;}.expl-menu-ico svg{width:14px;height:14px;display:block;}' +
       '.expl-menu-item:hover{background:var(--dsw-alias-interactive-bg-hover);}' +
       '.expl-danger{color:var(--dsw-alias-state-error-primary);} .expl-menu-item.expl-danger:hover{background:var(--dsw-alias-interactive-bg-hover-danger);}' +
       '.expl-menu-sep{height:1px;margin:4px 6px;background:var(--dsw-alias-border-l1);}' +
@@ -97,6 +99,14 @@ window.__ModuleLoader__.load({
       document.head.appendChild(tag)
     }
 
+    // ------------------------------------------------------------------
+    // 工具栏图标：取自 JupyterLab ui-components（BSD-3-Clause，与文件类型
+    // 图标同源的引用方式），fill 改为 currentColor 以跟随 DSH 主题 token。
+    // 注意：只引入刷新图标——ICON_CLOSE / ICON_UPLOAD 与 GoalBar 段的
+    // 同名 React 元素常量冲突（var 提升覆盖），字符样式反而更稳。
+    // ------------------------------------------------------------------
+    var ICON_REFRESH = '<svg xmlns="http://www.w3.org/2000/svg" width="16" viewBox="0 0 18 18"><path fill="currentColor" d="M9 13.5c-2.49 0-4.5-2.01-4.5-4.5S6.51 4.5 9 4.5c1.24 0 2.36.52 3.17 1.33L10 8h5V3l-1.76 1.76A6 6 0 0 0 9 3C5.69 3 3.01 5.69 3.01 9S5.69 15 9 15a5.98 5.98 0 0 0 5.9-5h-1.52c-.46 2-2.24 3.5-4.38 3.5"/></svg>'
+
     // GoalBar 多行版：沿用 DSH 原生 GoalBar 的结构和主题，仅放开单行截断。
     // 布局分两行：head 行（图标 + 相位标签 + 操作按钮），body 行（objective 多行）。
     var GOAL_CSS =
@@ -137,8 +147,9 @@ window.__ModuleLoader__.load({
       '.dfv-body{flex:1;min-height:0;display:flex;flex-direction:column;background:var(--dsw-alias-bg-layer-1);}' +
       '.dfv-toolbar{display:flex;align-items:center;gap:8px;flex:none;padding:6px 12px;border-bottom:1px solid var(--dsw-alias-border-l1);font-size:11px;color:var(--dsw-alias-label-secondary);}' +
       '.dfv-toolbar-path{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;direction:rtl;text-align:left;font-family:var(--ds-font-family-code);}' +
-      '.dfv-btn{flex:none;background:transparent;border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-primary);font-size:11px;line-height:1;padding:4px 9px;border-radius:7px;cursor:pointer;}' +
+      '.dfv-btn{flex:none;display:inline-flex;align-items:center;gap:5px;height:26px;box-sizing:border-box;background:transparent;border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-primary);font-size:12px;line-height:1;padding:0 10px;border-radius:7px;cursor:pointer;}' +
       '.dfv-btn:hover{background:var(--dsw-alias-interactive-bg-hover);}' +
+      '.dfv-btn svg{width:14px;height:14px;display:block;flex:none;}' +
       '.dfv-error{padding:8px 14px;font-size:12px;color:var(--dsw-alias-state-error-primary);flex:none;}' +
       '.dfv-muted{padding:24px 14px;font-size:13px;color:var(--dsw-alias-label-tertiary);text-align:center;}' +
       '.dfv-cap{padding:5px 14px;font-size:11px;color:var(--dsw-alias-label-caption);border-bottom:1px solid var(--dsw-alias-border-l1);flex:none;}' +
@@ -281,6 +292,7 @@ window.__ModuleLoader__.load({
       var cwd = await defaultCwd(sessionId, cwdHint)
       // 会话切换：预览列表按新 cwd 裁剪（范围外自动关闭），并清掉上一路径的旧错误横幅
       var files = pruneFilesToScope(state.files, cwd)
+      lastMtimes = {} // 换了目录，旧 mtime 基线全部作废（首轮 tick 重建基线）
       setState({ cwd: cwd, selected: new Set(), renaming: null, newItem: null, menu: null, error: '', notice: '', files: files })
       var items = await loadDir(cwd)
       if (items) setState({ error: '', tree: items })
@@ -292,6 +304,150 @@ window.__ModuleLoader__.load({
       if (items) setState({ error: '', tree: items })
     }
 
+    // ------------------------------------------------------------------
+    // 自动刷新：低频轮询宿主 mtime 探测（3s 一次），签名变了才真正重拉。
+    // watch 范围 = 当前 cwd + 已展开目录 + 打开的预览文件；面板关闭且无
+    // 预览时整个 tick 直接返回（零请求）。不做文件 watcher——fs.watch
+    // 递归语义跨平台不一致且大工作区开销高，stat 几个路径便宜得多。
+    // ------------------------------------------------------------------
+    var AUTO_REFRESH_MS = 3000
+    var AUTO_WATCH_MAX = 64
+    var lastMtimes = {}   // path -> {m,s,d}|null；undefined = 尚无基线（首轮只建基线不触发）
+    var autoTicking = false
+
+    function collectWatchPaths() {
+      var paths = []
+      if (state.cwd) paths.push(state.cwd)
+      var walk = function (nodes) {
+        for (var i = 0; i < nodes.length; i++) {
+          var n = nodes[i]
+          if (n.type === 'directory' && n.children != null) {
+            paths.push(n.path)
+            if (n.open && n.children.length) walk(n.children)
+          }
+        }
+      }
+      walk(state.tree)
+      for (var j = 0; j < state.files.list.length; j++) {
+        var e = state.files.list[j]
+        if (e.path && paths.indexOf(e.path) < 0) paths.push(e.path)
+      }
+      return paths.slice(0, AUTO_WATCH_MAX)
+    }
+
+    /** 预览文件在磁盘上变了：静默重读该 entry（不动激活状态、不闪 tab）。 */
+    async function silentReloadEntry(entry) {
+      var res = await rpc('read', { path: entry.path, sessionId: activeSessionId })
+      if (!res || !res.ok) return
+      entry.kind = res.kind
+      entry.size = res.size || 0
+      if (res.kind === 'text') { entry.content = res.content; entry.truncated = !!res.truncated }
+      else if (res.kind === 'image') { entry.dataUrl = 'data:' + res.mime + ';base64,' + res.data }
+      else if (res.kind === 'pdf') { entry.data = res.data }
+      setFiles({ list: state.files.list.slice() })
+    }
+
+    /** 已展开目录的子项变了：重拉该目录（保持展开态）。 */
+    async function reloadDirNode(node) {
+      var items = await loadDir(node.path)
+      if (items) items.forEach(function (c) { c.parent = node })
+      node.children = items || []
+      node.open = true
+      setState({ tree: state.tree })
+    }
+
+    /**
+     * 探一轮。返回 'idle'（本轮没发请求）/ true（探测成功）/ false（请求失败）。
+     * 只有真正发出去且失败的请求才累积退避；空闲不累积——面板重开时本就有
+     * 一次全量 loadDir，无需为"关着的时候宿主是否恢复"操心。
+     */
+    async function autoRefreshTick() {
+      if (autoTicking) return 'idle'
+      if (!state.open && state.files.list.length === 0) return 'idle'
+      // 用户正在操作（重命名/新建/右键菜单）时跳过本轮，避免打断输入
+      if (state.renaming || state.newItem || state.menu) return 'idle'
+      var paths = collectWatchPaths()
+      if (!paths.length) return 'idle'
+      autoTicking = true
+      try {
+        var res = await rpc('mtime', { paths: paths })
+        if (!res || !res.ok) return false
+        var mtimes = res.mtimes || {}
+        var dirtyDirs = []
+        var dirtyFiles = []
+        for (var i = 0; i < paths.length; i++) {
+          var p = paths[i]
+          var now = Object.prototype.hasOwnProperty.call(mtimes, p) ? mtimes[p] : null
+          var prev = Object.prototype.hasOwnProperty.call(lastMtimes, p) ? lastMtimes[p] : undefined
+          lastMtimes[p] = now
+          if (prev === undefined || prev === null || now === null) continue
+          if (now.m === prev.m && now.s === prev.s) continue
+          if (now.d) dirtyDirs.push(p)
+          else dirtyFiles.push(p)
+        }
+        for (var d = 0; d < dirtyDirs.length; d++) {
+          var dp = dirtyDirs[d]
+          if (dp === state.cwd) { await refresh(); continue }
+          var node = findNode(state.tree, dp)
+          if (node && node.children != null) await reloadDirNode(node)
+        }
+        for (var f = 0; f < dirtyFiles.length; f++) {
+          var entry = findFileEntry(dirtyFiles[f])
+          if (entry && entry.loaded) await silentReloadEntry(entry)
+        }
+        return true
+      } finally {
+        autoTicking = false
+      }
+    }
+
+    // 失败退避：宿主不可达（DSH 重启中 / 插件重载 / 断连）时别每 3s 硬打——
+    // 指数退避 3s→6s→12s→24s→48s，封顶 60s；一旦成功回到 3s。
+    // （JupyterLab FileBrowserModel 的 Poll 同思路：backoff + max 封顶。）
+    // 实现：1s 固定心跳 + 「到期才探测」，而不是变间隔定时器——宿主提供的
+    // timer 服务可 dispose，测试环境（interval 为 no-op mock）也不会挂住进程。
+    var AUTO_HEARTBEAT_MS = 1000
+    var AUTO_BACKOFF_MAX_MS = 60000
+    var autoFailCount = 0
+    var autoLastProbeAt = 0
+
+    function autoDelayMs() {
+      if (autoFailCount <= 0) return AUTO_REFRESH_MS
+      return Math.min(AUTO_REFRESH_MS * Math.pow(2, autoFailCount), AUTO_BACKOFF_MAX_MS)
+    }
+
+    function autoHeartbeat() {
+      var now = Date.now()
+      if (now - autoLastProbeAt < autoDelayMs()) return
+      autoLastProbeAt = now
+      autoRefreshTick().then(function (outcome) {
+        if (outcome === false) autoFailCount++
+        else autoFailCount = 0
+      })
+    }
+
+    /** 手动刷新：重拉根目录，已展开的子目录逐个重拉、保持展开不收起。 */
+    async function refreshAll() {
+      if (!state.cwd) return
+      var expanded = []
+      var walk = function (nodes) {
+        for (var i = 0; i < nodes.length; i++) {
+          var n = nodes[i]
+          if (n.type === 'directory' && n.children != null) {
+            if (n.path !== state.cwd) expanded.push({ path: n.path, open: !!n.open })
+            if (n.open && n.children.length) walk(n.children)
+          }
+        }
+      }
+      walk(state.tree)
+      await refresh()
+      for (var j = 0; j < expanded.length; j++) {
+        if (!expanded[j].open) continue
+        var node = findNode(state.tree, expanded[j].path)
+        if (node) await reloadDirNode(node)
+      }
+    }
+
     async function toggleNode(node) {
       if (node.type !== 'directory') return
       if (node.children == null) {
@@ -951,7 +1107,7 @@ window.__ModuleLoader__.load({
       } else {
         items.push({ key: 'newfile', label: '📄 新建文件', onClick: function () { startNew(state.cwd, false) } })
         items.push({ key: 'newfolder', label: '📁 新建文件夹', onClick: function () { startNew(state.cwd, true) } })
-        items.push({ key: 'refresh', label: '⟳ 刷新', onClick: refresh, separatorAfter: true })
+        items.push({ key: 'refresh', label: [create('span', { className: 'expl-menu-ico', dangerouslySetInnerHTML: { __html: ICON_REFRESH } }), '刷新'], onClick: refresh, separatorAfter: true })
         if (state.selected.size > 0) items.push({ key: 'none', label: '取消选择', onClick: function () { setState({ selected: new Set(), lastIndex: null }) } })
       }
       return items
@@ -1100,13 +1256,46 @@ window.__ModuleLoader__.load({
     var CSV_MAX_ROWS = 500
     var CSV_MAX_COLS = 64
 
+    // ------------------------------------------------------------------
+    // Markdown 相对图片 → dsh-soup 同源 img 端点绝对 URL。
+    // 预览 markdown 时，DSH 的 MarkdownText 渲染器「禁相对链接/相对资源」，
+    // `![x](view.jpg)` 这类相对路径图片会被直接丢弃。因此把 src 改写成
+    // 本插件同名端点（GET /api/dsh-soup/img）的同源绝对地址，交给 <img>
+    // 从磁盘内联加载。绝对（http/https/data 等）与根相对路径放行不处理。
+    // ------------------------------------------------------------------
+    var MD_IMG_RE = /!\[([^\]]*)\]\(([^)\s]+)(?:\s+["'][^"']*["'])?\)/g
+    function posixResolve(dir, rel) {
+      var combined = (String(dir || '/').replace(/\/+$/, '') || '/') + '/' + String(rel)
+      var out = []
+      combined.split('/').forEach(function (seg) {
+        if (seg === '' || seg === '.') return
+        if (seg === '..') { if (out.length) out.pop(); return }
+        out.push(seg)
+      })
+      return '/' + out.join('/')
+    }
+    function imgUrl(absPath) {
+      return hostBase() + '/api/dsh-soup/img?p=' + encodeURIComponent(absPath)
+    }
+    function absolutizeMarkdownImages(text, baseDir) {
+      if (!text) return text
+      var dir = baseDir || '/'
+      return text.replace(MD_IMG_RE, function (m0, alt, src) {
+        var s = String(src || '').trim()
+        if (/^(?:[a-z][a-z0-9+.-]*:|#|\/)/i.test(s)) return m0
+        return '![' + alt + '](' + imgUrl(posixResolve(dir, s)) + ')'
+      })
+    }
+
     function MarkdownPreview(props) {
+      var text = props.text
       if (MarkdownText) {
+        var md = props.baseDir ? absolutizeMarkdownImages(text, props.baseDir) : text
         return create('div', { className: 'dfv-md-wrap' },
-          create('div', { className: 'dfv-md' }, create(MarkdownText, { text: props.text })))
+          create('div', { className: 'dfv-md' }, create(MarkdownText, { text: md })))
       }
       // 回退：宿主缺 ui-primitives 时按纯文本展示
-      return create('pre', { className: 'dfv-code' }, props.text)
+      return create('pre', { className: 'dfv-code' }, text)
     }
 
     function HtmlPreview(props) {
@@ -1358,7 +1547,7 @@ window.__ModuleLoader__.load({
       // 文本类：按扩展名选预览渲染器（纯只读，无编辑）
       var pk = previewKind(entry.path)
       var view = null
-      if (pk === 'markdown') view = create(MarkdownPreview, { text: entry.content })
+      if (pk === 'markdown') view = create(MarkdownPreview, { text: entry.content, baseDir: parentOf(entry.path) })
       else if (pk === 'html') view = create(HtmlPreview, { text: entry.content, title: entry.name })
       else if (pk === 'json') view = create(JsonPreview, { text: entry.content })
       else if (pk === 'notebook') view = create(NotebookPreview, { text: entry.content })
@@ -1420,7 +1609,10 @@ window.__ModuleLoader__.load({
               className: 'dfv-btn',
               title: '从磁盘重新读取（刷新预览）',
               onClick: function () { reloadFile(active.path) },
-            }, '⟳ 重载') : null,
+            },
+              create('span', { className: 'expl-icon', dangerouslySetInnerHTML: { __html: ICON_REFRESH } }),
+              '重载',
+            ) : null,
           ),
           create(FileContent, { key: active.path, entry: active }),
         )
@@ -1585,9 +1777,21 @@ window.__ModuleLoader__.load({
         create('div', { className: 'expl-head' },
           create('span', { className: 'expl-title' }, '📁 资源管理器'),
           create('div', { className: 'expl-head-btns' },
-            create('button', { className: 'expl-btn', onClick: function () { if (uploadInputEl) uploadInputEl.click() }, title: '上传文件' }, '⬆'),
             create('button', {
               className: 'expl-btn',
+              onClick: function () { refreshAll() },
+              title: '刷新（保持已展开目录）',
+              'aria-label': '刷新',
+            }, create('span', { className: 'expl-icon', dangerouslySetInnerHTML: { __html: ICON_REFRESH } })),
+            create('button', {
+              className: 'expl-btn',
+              onClick: function () { if (uploadInputEl) uploadInputEl.click() },
+              title: '上传文件',
+              'aria-label': '上传文件',
+            }, '⬆'),
+            create('button', {
+              className: 'expl-btn',
+              style: { fontSize: '18px' },
               onClick: function (event) {
                 try { layout.closeDetails() } catch (e) {}
                 setHeroDetailsWidth(event.currentTarget, 0)
@@ -2026,6 +2230,12 @@ window.__ModuleLoader__.load({
       var sessions = ctx.sessions
       var remoteGoals = ctx.remote.goals
       var disposers = []
+      // 自动刷新心跳：1s 固定心跳 + 到期才探测（基础 3s；宿主不可达时指数退避，封顶 60s）。
+      // 面板关且无预览时 tick 内直接返回（零请求）；首个 tick 只建基线。
+      if (timerRef && typeof timerRef.interval === 'function') {
+        var stopAuto = timerRef.interval(function () { autoHeartbeat() }, AUTO_HEARTBEAT_MS)
+        disposers.push(function () { try { stopAuto() } catch (e) {} })
+      }
       slots.inject('conversation.session.header.utilities', function () {
         disposers.push(slots.register(
           { name: 'conversation.session.header.utilities', id: 'dsh-soup-toggle', order: 10, label: '资源管理器' },

package/lib/index.js

@@ -533,6 +533,65 @@ export function apply(ctx) {
     'dsh-soup: streaming download route',
   )
 
+  /**
+   * 图片内联端点：GET /api/dsh-soup/img?p=<路径>。
+   * 浏览器端 Markdown 预览会把「相对路径图片」改写为这里的绝对 URL，
+   * 由 <img> 内联加载真实图片字节（JupyterLab md 图片同思路）。只读、无
+   * Content-Disposition（内联显示而非下载）。
+   * 安全模型：confine 围栏（只读工作区/会话目录）+ 仅图片类型 + 大小上限 +
+   * 不返回任何 CORS 头 + 拒绝跨站（Sec-Fetch-Site: cross-site 与不同源 Origin）。
+   * 注意 <img> 只能确认「是否 200/404」，无法读取像素，跨站利用面很小。
+   */
+  async function imageHandler(req, res) {
+    try {
+      const site = String(req.headers['sec-fetch-site'] || '')
+      if (site === 'cross-site') {
+        writeJson(res, 403, { ok: false, error: '跨站图片请求已拒绝' })
+        return
+      }
+      const origin = req.headers.origin
+      if (typeof origin === 'string' && origin !== '') {
+        let originHost = ''
+        try { originHost = new URL(origin).host } catch { originHost = '' }
+        const host = typeof req.headers.host === 'string' ? req.headers.host : ''
+        if (!originHost || originHost !== host) {
+          writeJson(res, 403, { ok: false, error: '跨源图片请求已拒绝' })
+          return
+        }
+      }
+      let p = ''
+      try { p = new URL(req.url || '/img?', 'http://local').searchParams.get('p') || '' } catch { p = '' }
+      if (!p) { writeJson(res, 400, { ok: false, error: '缺少图片路径' }); return }
+      const rp = await confine(p, '图片路径')
+      const mime = IMAGE_MIME[extOf(rp)]
+      if (!mime) { writeJson(res, 415, { ok: false, error: '不是可预览的图片类型' }); return }
+      let st
+      try { st = await stat(rp) } catch { writeJson(res, 404, { ok: false, error: '图片不可读' }); return }
+      if (st.isDirectory() || st.size > IMAGE_MAX_BYTES) {
+        writeJson(res, 413, { ok: false, error: '图片过大或目标为目录' }); return
+      }
+      const fh = await openFile(rp, 'r')
+      let buf
+      try {
+        buf = Buffer.alloc(st.size)
+        await fh.read(buf, 0, st.size, 0)
+      } finally { await fh.close() }
+      res.writeHead(200, {
+        'content-type': mime,
+        'content-length': String(st.size),
+        'cache-control': 'no-store',
+      })
+      res.end(buf)
+    } catch (err) {
+      if (!res.headersSent) writeJson(res, (err && err.statusCode) || 500, { ok: false, error: String((err && err.message) || err) })
+      else res.end()
+    }
+  }
+  ctx.effect(
+    () => ctx.webServer.register({ kind: 'exact', path: '/api/dsh-soup/img', handler: imageHandler }),
+    'dsh-soup: inline image route',
+  )
+
   /** 统一路由 dispatch：每个 action 返回可 JSON 序列化的结果。 */
   async function handleAction(body) {
     const action = body && body.action
@@ -657,6 +716,25 @@ export function apply(ctx) {
         downloadTickets.set(token, { path: rp, name: path.basename(rp), exp: Date.now() + 120000 })
         return { ok: true, name: path.basename(rp), size: dst.size, url: `/api/dsh-soup/dl?t=${token}` }
       }
+      case 'mtime': {
+        // 轻量变更探测：对一批路径返回 mtime(+size/目录标志)，供浏览器端
+        // 低频轮询比较、变了才真正重拉——避免引入跨平台文件 watcher。
+        // 上限 64 个路径；越界/不可达的路径返回 null（客户端视为消失）。
+        const paths = Array.isArray(args && args.paths) ? args.paths.slice(0, 64) : []
+        const mtimes = {}
+        for (const raw of paths) {
+          const p = String(raw || '')
+          if (!p) continue
+          try {
+            const rp = await confine(p, '探测路径', sessionIdArg)
+            const st = await stat(rp)
+            mtimes[p] = st.isDirectory() ? { m: st.mtimeMs, d: 1 } : { m: st.mtimeMs, s: st.size }
+          } catch {
+            mtimes[p] = null
+          }
+        }
+        return { ok: true, mtimes }
+      }
       case 'speed-status': {
         const sid = args && args.sessionId ? String(args.sessionId) : ''
         return { ok: true, ...speedStatus(sid) }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lyhue1991/dsh-soup",
   "description": "DSH 项目资源管理器：右侧 details 列文件树（并列网格、宽度与左侧工作区一致 264-420px），有 Session log 时在其右侧、空白新会话在输入框上方右端提供 📁 切换按钮；支持多选、双击展开/打开、右键菜单（打开/系统打开/重命名/废纸篓/新建/复制路径）、拖拽移动、上传。文件「打开」在会话区新增「文件」标签页（原生 conversation.view，与对话/轨迹同级）：文本可编辑 ⌘S 保存、图片预览、二进制提示。附带模型吞吐徽标：输入框正上方显示「正在等待模型...」与彩色 t/s 徽标（数据来自 llm/stream 真实流）。附带 GoalBar 多行展示：把原生单行截断 GoalBar 放开为多行完整显示，编辑用 textarea，工具与数据仍走原生 goal。",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "main": "lib/index.js",
   "exports": {