# 更新日志

本文件记录 dsh-workspace 各版本的主要变化。开发中的改动先写在「未发布」下，发布时（`npm run release`）自动定稿为对应版本。

## 未发布

## 0.12.3（2026-10-12）

### SSH 连接

- 修复：远程工作区连接建立后，服务器侧断开连接（ECONNRESET）或保活超时会让整个 DSH 崩溃（宿主进程 exit 1，issue #6）。根因是 `rawDial` 握手成功后摘掉了 ssh2 Client 的 `error` 监听，已建立连接上的 `error` 无人接收成为未捕获异常。现在保留一个常驻监听只记 warn 日志（握手期错误仍由原逻辑记录并 reject，不重复记），断线回收与自动重连沿用连接池的 close / end 处理；跳板链每一跳同样受益。补回归测试 `src/ssh/connection.test.ts`。

### HTML 预览

- 修复：HTML 预览出问题时只留一片白、看不出原因。`.html` / `.htm` 预览页注入纯 ASCII 的预览探针（`src/wire/preview-probe.ts`，桌面版在 srcdoc 内联时注入，网页版由预览路由对带 `?probe=1` 的主文档按 latin1 原字节插入、相对资源不受影响；页面自带 meta CSP、svg / xhtml 不注入），把页面脚本报错、资源加载失败、加载完成但正文为空、10 秒内未完成加载回报给查看器，显示在沙箱提示条下方；沙箱里访问 localStorage / cookie 被拒（SecurityError）时提示可临时解除沙箱，未加载时提示打开开发者工具（标题栏扳手菜单或 Ctrl+Shift+I）看 Console。
- 改进：预览 iframe 的渲染决策抽成纯函数 `framePlan`（`src/client/viewers/html-frame.ts`），键同时包含 nonce 与沙箱状态（解除 / 恢复沙箱、保存、刷新都重建浏览上下文），补回归测试（探针注入位置、沙箱切换换键、预览路由注入后长度与 CSP）。
- 修复：Windows 桌面版（兼容模式页面是 `http://127.0.0.1:<端口>`）解除沙箱后，页面里 `new Worker('worker.js')`、`fetch`、动态 `import` 等运行时相对地址解析到 DSH 根目录（如 comlink 示例报 `Failed to construct 'Worker'`）。根因是桌面版一律走 srcdoc，srcdoc 文档基址是父页面地址。现在加载方式由 `frameLoadMode` 决定：http(s) 页面上网页版两种模式、桌面版解除沙箱都让 iframe 直接加载预览路由（文档基址 = 文件所在目录，同源，Worker 可用）；桌面版沙箱仍走 srcdoc 内联（不透明源的请求拿不到桌面渲染进程令牌，关闭「允许浏览器访问」时会被拒），非 http(s) 页面（dsh-app:// / file:）走 srcdoc；srcdoc 能拿到预览路由时注入 `<base href>` 指向文件目录（尽力而为，页面自带 `<base>` 时不覆盖；签发失败不报错，照常内联）。
- 改进：探针提示分类（`probeNotes`）：沙箱下报错含 `origin 'null'` / SecurityError / Worker / 内联模块导入失败 / localStorage / sessionStorage / cookie 时追加「该页面需要同源能力，请点击『临时解除沙箱』」；页面有自己的脚本但没有可见元素时改为中性说明「页面没有可见元素（内容可能由脚本弹窗或控制台输出）」，不再按故障提示（探针统计可见元素时排除 script / style 等，并回报脚本数）。沙箱 iframe 与预览路由 CSP sandbox 均含 `allow-modals`（alert / confirm / prompt 不再被静默忽略，仍无 `allow-same-origin`）。

### 右侧栏标签右键菜单与固定标签

- 新增：右侧栏标签右键菜单（宿主「关闭」之后，分隔线开头）增加「关闭左侧 / 关闭右侧 / 关闭其他 / 关闭全部」——只作用于该标签所在窗格、跳过固定标签，没有可关闭目标时禁用；以及「固定 / 取消固定」。文件类标签（插件文件查看器、宿主文档预览等 `dsh-resource://file/...` 地址）另有「复制路径」「在文件管理中显示」（文件不在当前会话工作区内或文件管理未开启时禁用；远程工作区会话不提供「在文件管理中显示」，只保留「复制路径」）。对所有停靠窗格标签生效（含宿主文件 / 浏览器 / 终端）。
- 新增：固定标签。固定后排在所在窗格最左（多个按固定先后），不显示关闭按钮（只能右键关闭）；以任何方式关闭固定标签即取消固定。打开侧边栏（或切到已展开的会话）时自动补开缺失的固定标签到记住的窗格（不存在则最左窗格；窗格只有引导页时顶替它），并恢复原来的激活标签；分屏下同一内容已在任意窗格 / 浮窗时不重复打开；拖到另一窗格后记住新窗格。终端、浏览器、SSH 终端等可开多个的标签不能固定（菜单项禁用并说明原因）。固定按会话独立保存在浏览器 `localStorage`（`dshws.sidebar-pins.v1.<会话>`），新会话不继承。
- 新增：「侧边栏」管理页开关「标签右键菜单增强与固定」（偏好 `sidebar.tabEnhance`，默认开）；关闭后撤销菜单项与隐藏关闭按钮的样式、停止补开与排序（固定记录保留）。
- 说明：排序 / 补开 / 关闭即取消固定依赖宿主右侧栏控制器的非公开字段（`adopted` 布局仓库、`placeTab`、`closeIn` / `openResourceIn` / `openTabIn`、`tabDomain`），缺失时自动降级为只提供可实现的菜单项、不抛错。预览场景：`node scripts/preview-ui.mjs tabmenu`。

### Git 侧栏

- 修复：右侧栏被拖窄时，Git 顶部页签（文件 / 改动 / 历史 / AI 改动）文字逐字折行成竖排。页签与角标改为不换行，放不下时页签栏横向滚动（隐藏滚动条，触控板横滑、普通滚轮纵向滚动自动转为横向），切换页签时激活项自动滚到可见。抽出通用类 `.dshws-tabstrip` + `useTabStrip`（`src/client/tabstrip.ts`）；任务页、AI 改动、文件标签等标题行里的分段按钮（`.dshws-side-seg`）同样改为不压缩、不换行。
- 新增：「历史」页签悬停浮窗展示完整提交说明。鼠标停在提交行约 400ms（或键盘聚焦该行）后，在行左侧（放不下时下方 / 上方，自动避让视口边界）弹出浮窗：加粗标题、作者、时间、可点击复制的短 hash，正文按 Markdown 渲染（单个换行保留），右上角可切换「渲染 / 原文」；最大宽 420px、最大高 60vh 内部滚动。移出约 150ms 后隐藏，移入浮窗时保持（可选中复制、点链接、滚动）；Esc、列表滚动即关闭，同一时间只显示一个。触屏 / 窄屏（≤640px）没有悬停，改为在展开的提交详情里点「说明」按钮打开同一浮窗。展开详情不再内嵌提交说明，只保留提交信息与改动文件。渲染做 XSS 安全处理：原始 HTML 一律转义、链接只放行 http(s) / mailto 且新窗口打开（noopener）、图片不加载改为链接，再经 `stripActiveTags` 纵深防御。
- 改进：提交说明浮窗按所在容器固定方向。右侧栏里固定显示在行的左侧（伸进主区，纵向对齐行并收进视口，极窄窗口放不下才退回下方 / 上方）；会话顶部「Git 仓库」标签页（主区）里固定显示在行的右侧（伸进详情区，放不下时退回左侧 / 下方）。`placeCommitPopover` 新增 `prefer: 'left' | 'right'` 参数，容器经 `CommitPopoverSideContext` 传入（会话顶部标签注册处提供 `'right'`）。
- 改进：移动端（≤640px 或无悬停设备）长按提交行约 500ms 弹出屏幕居中的模态弹窗查看完整说明：半透明遮罩、宽 min(92vw, 420px)、最大高 70vh 内部滚动，点遮罩 / 关闭按钮 / Esc / 手机返回键关闭；手指移动超过 10px 或列表滚动即取消，短按仍是展开 / 收起详情，长按后浏览器补发的 click 被吞掉不会误展开；长按期间屏蔽系统长按菜单与文字选中。展开详情里的「说明」按钮保留为备用入口，同样打开居中弹窗。长按逻辑抽成纯状态机 `createLongPress` + `useLongPress`（`src/client/sidebar/long-press.ts`，带单测）。
- 改进：`git log` 改用 `-z` + `%B`（完整说明放在最后一个字段，只按前 5 个字段分隔符切分），提交说明里出现 `\x1f` / `\x1e` 等控制字符也不会让字段错位；提交对象新增 `body` 字段（单条正文上限 2 万字符），远程与本机仓库同样适用。

### 侧边栏管理页与 dsh-better-sidebar

- 新增：「远程工作区」主页新增「侧边栏」页签（位于「连接日志」与「全局配置」之间），集中管理侧栏能力：
  - 标签开关：文件管理、Git、文件查看器、SSH 终端、任务、侧边对话，切换即时注册 / 撤下（文件管理与 Git 同时作用于会话顶部标签；关闭文件查看器后文件交还宿主查看器）。
  - 「接管 DSH『文件』侧栏」从「全局配置」迁入（偏好键不变，已有设置照常生效）。
  - 文件关联（扩展名 → 查看器 + 默认预览 / 编辑，可增删改、一键恢复默认）、忽略规则编辑（复用原 `ignore` 偏好）、大文件阈值（默认 20MB）、HTML 默认不沙箱、文件树自动刷新、自定义「打开方式」URL 模板。
  - Agent 打开工具 `open_in_sidebar` 开关与「自动打开任务页」开关（均默认开）。
  - 外观：IME 守卫、自定义 CSS（见下）。
  - 偏好统一存于宿主 `prefs.json` 的 `sidebar` 字段（新网关方法 `setSidebarPrefs`，严格校验），浏览器端经 `src/client/sidebar-prefs.ts` 读取与订阅。
- 新增：dsh-better-sidebar 状态检测与一键禁用 / 重新启用（网关 `betterSidebarStatus` / `betterSidebarSetEnabled`，经宿主 pluginManager，整个 profile 生效，界面先确认；完成后提示刷新页面）。禁用后本插件自动接管「文件」侧栏；pluginManager 不可用时引导到宿主插件页手动处理。本插件的侧栏能力已覆盖 dsh-better-sidebar，不再依赖它。
- 新增：IME 守卫（默认开）—— 输入法组字期间的按键在 document 捕获阶段停止传播，不再误触宿主 / 其他插件的快捷键（只 stopPropagation，不 preventDefault；终端与代码编辑器放行）。
- 新增：自定义 CSS —— 注入 `<style data-dshws-custom>`，输入即实时生效，插件卸载 / 重载时自动撤销。

### 文件查看器

- 新增：文件查看器统一（本机会话 + 远程会话）。
  - 右侧栏文件查看器同时认领本机文件：本机会话里的聊天文件链接、交付卡片、@ 引用都由插件查看器打开；卸载 dsh-better-sidebar 后 `absolute` 地址也有人认领。远程会话里解析不了的地址仍交还宿主。
  - 「文件管理」窄面板里的本机文件改用会话范围地址（与宿主聊天链接同一写法），同一文件不会开出两个标签。
  - 新增网关方法 `localRead` / `localReadData`：本机任意路径只读（带大小上限与 mtime；拒绝相对、UNC 与设备路径）。写入仍只走 `sftpWrite` + `local:<会话>`，限当前工作区（realpath 防逃逸）；工作区外的文件在查看器里只读。
  - 下载路由支持 `HEAD` 与单区间 `Range`（206），`inline=1` 时图片 / 音视频 / PDF 按真实类型内联（HTML、SVG 永不内联）；`host=local:*` 为本机任意路径只读。
- 新增：按扩展名分派查看器 —— 代码 = Monaco、Markdown / HTML = 增强预览、图片 / 音视频 = 原生（音视频走 Range 流，不受大小限制）、PDF / Word（docx、doc、odt）/ 表格（xlsx、xls、csv、ods）/ PPTX / 压缩包 / TIFF、HEIC = file-viewer；`.ppt`、CAD 只提供下载。超过大文件阈值（默认 20MB）的文件先提示再加载。文件关联、大文件阈值、HTML 沙箱默认值集中在 `src/client/viewers/defaults.ts`，经 `viewers/prefs.ts` 读取，可在「侧边栏」页签修改。
- 新增：直接依赖 file-viewer（`@file-viewer/core` 与 pdf / word / spreadsheet / pptx / media / archive / image 渲染器，版本锁死 3.1.2），不含 CAD 与 `.ppt`。查看器资源（ESM 分片、Worker、WASM、cMap、字体）单独构建到 `lib/assets/viewers/`，经插件 `/dsh-workspace/assets` 路由托管，离线可用、按格式懒加载（`scripts/build-viewers.mjs`；`npm run verify:viewers` 在无头浏览器里实测 PDF / CSV / ZIP / Markdown 增强）。
- 新增：Markdown 增强预览 —— 单栏「预览 / 代码」切换（与 HTML 的切换按钮一致；预览 = 渲染结果，代码 = Monaco 源码可编辑保存，切回预览即渲染未保存的草稿；默认模式按文件关联偏好，默认预览。原宽屏左右分栏实时预览已按反馈移除）；highlight.js 代码高亮、KaTeX 公式（MathML 输出）、Mermaid 图表（点击放大，滚轮缩放）全部按需加载；front matter 展示、浮动目录；选中文字出现「加入对话」，把引文写入对话输入框（宿主没有公开的插入接口，模拟粘贴实现，找不到输入框时复制到剪贴板）。仍是无脚本 iframe：增强内容在父文档离屏渲染后以静态 HTML / SVG 注入。
- 新增：HTML 预览 / 源码双模式（源码可编辑保存）；默认沙箱，可「临时解除沙箱」（本次会话对该文件有效，需确认），解除时预览路由换用不带 CSP sandbox 的独立令牌。
- 新增：`.doc` / `.dot`（Word 97-2003）在线预览 —— 不再滤掉 renderer-word 自带的 Word Binary 渲染器（`@file-viewer/doc` 3.1.2，MIT，纯 JS、无 Worker / WASM，按需分片），并将其列为精确版本的直接依赖；修复打开 .doc 时显示「.doc 格式已在支持矩阵中，但当前项目尚未装配 Word Binary renderer」。
- 新增：已装配渲染器本就支持的格式补进默认关联（不增加体积）：odp、dotm、pptm、potm、ppsm、xlt、xltm、fods、dbf。
- 变更：`.rtf` 改为按文本（Monaco）打开 —— renderer-word 的 RTF 需要额外的 rtf.js，本项目不装；压缩包内的 .rtf 同样按纯文本显示。
- 新增：file-viewer 兜底渲染器（`src/client/viewers/lazy/fallback-renderers.ts`）—— 支持矩阵里未装配的类别（`.ppt` / `.pot`、CAD、3D、电子书等，定义复用 core 格式表）统一显示「该格式不支持在线预览，请下载后用系统应用打开」（中英文跟随查看器语言）；压缩包内的代码 / Markdown 等文本类别解码为纯文本（最多 2MB，含 NUL 字节视为二进制）。压缩包内预览与自定义关联都不再出现「尚未装配 xx renderer」的集成方提示。
- 新增：分派白名单 `FILE_VIEWER_EXTS`（`src/client/viewers/dispatch.ts`，与装配的渲染器定义由单测校验一致）：用户把扩展名关联到 file-viewer、但该格式未装配时，文本类退回 Monaco，其余退回下载。
- 文档：查看器第三方声明（`lib/assets/viewers/fv/NOTICE.md`，由 `scripts/build-viewers.mjs` 生成）补充 `@file-viewer/doc`（MIT）与 heic2any 内含 libheif（LGPL-3.0）的说明；`scripts/verify-viewers-browser.mjs` 新增兜底提示 / 纯文本兜底 / 不出现「尚未装配」检查，设置 `DSHWS_DOC_FIXTURE` 时另验证 .doc 正文渲染。
- 修复：会话消息里指向**文件夹**的文件链接（以及 `dshWorkspace.openFile`、远程交付卡片「打开」等经查看器打开的地址）点击后显示「只能预览普通文件」。宿主打开前不知道目标类型，现在查看器挂载前先探测（远程 / 本机工作区内用 `sftpDirStamps`，本机工作区外用 `localList`，不新增网关方法）：是目录就用宿主标签动作 `tab.actions.openTab(文件管理, { replaceTab: true })` 在同一窗格原位替换为「文件管理」并定位 + 展开该文件夹（导航参数与 `open_in_sidebar` 文件夹分支共用 `revealParams`）；旧宿主没有标签动作时另开「文件管理」。文件夹不在标签所在会话的工作区内（或远程主机不同、文件管理未启用）时提示原因，并提供「在系统文件管理器中打开」（仅本机且宿主支持 open-in-app）与「复制路径」。探测失败（不存在 / 无权限）照常交给查看器显示原有错误；分支判断抽为纯函数 `folderAction`（`src/client/sidebar/folder-redirect.ts`，带单测）。
- 修复：链接指向**工作区根目录本身**（如工作区 `C:/TestChat/` 下的 `[TestChat](<C:/TestChat/>)`）点击后右栏报「读取失败：path is required」。根因：宿主 `fileAddressFor` 对等于工作区根的路径生成空相对路径（`dsh-resource://file/session/<id>/`），本插件 `resolveLocalAddress` 不认领空路径，地址落到宿主自带查看器，它拿空路径调用工作区读接口被拒。现在空路径 / `.` / `./` / 结尾斜杠 / 反斜杠 / 重复斜杠一律规范化，空与 `.` 视为工作区根并由本插件认领，探测为目录后只打开「文件管理」不定位；地址缺结尾 `/`（`.../session/<id>`）也能解析；远程会话链接指向远程根（`/home/ps/testdsh/`）同样定位到根。
- 修复：文件夹定位不能跳出工作区。`folderAction`、`isInsideLocal`、`revealPlan` 改为先规范化（统一分隔符、折叠 `.` / `..`、Windows 盘符段不被 `..` 弹出、Windows 不区分大小写、Linux / macOS 区分）再带 `/` 边界比较，`C:/TestChat/../TestChat2`、`C:/TestChat2` 不再被当成 `C:/TestChat` 内；`open_in_sidebar` 文件夹与 `dshWorkspace.reveal` 改用同一判断，工作区根只打开文件管理，工作区外改按地址打开、由查看器提示「不在工作区内」并提供复制路径 / 系统打开。服务端读接口的工作区限制不变。

### 文件管理（文件树）

- 新增：「文件管理」文件树增强（本机与远程会话通用）。
  - 文件名搜索：工具栏搜索按钮展开搜索框（复用 `sftpSearch`，300ms 防抖）；点文件打开并在树中定位，点目录退出搜索并展开定位。
  - 自动刷新：每 3 秒批量取展开目录的 mtime（新网关方法 `sftpDirStamps`，最多 200 个目录），变了的目录静默重载、被删的目录重载其父目录；页面隐藏或标签不在前台时暂停。「侧边栏」页签新增「文件树 → 自动刷新」开关（偏好 `sidebar.autoRefresh`，默认开）。
  - Git 状态：文件显示 M / A / D / R / U（冲突）/ ??（未跟踪）徽标并着色，含改动的目录按最严重的改动着色；非 Git 仓库静默不显示；开启自动刷新时每 10 秒或目录变化时更新，手动刷新也会更新。
  - 右键「在对话中引用」：单个文件以宿主原生 @ 引用芯片插入输入框（`slash/input-insert-reference`），目录 / 多选写入文本 `@路径`（工作区内为相对路径）；找不到输入框时复制到剪贴板。
  - 右键「打开方式」子菜单：本机会话可用系统默认应用 / 在文件管理器中显示（宿主 open-in-app）；内置 VS Code / Cursor / Zed（远程文件走 `vscode-remote/ssh-remote+user@host`、`zed://ssh/...`）；自定义 URL 模板（偏好 `sidebar.openWith`，变量 `{path}` `{host}` `{user}` `{port}`，在「侧边栏」页签编辑）。桌面版经新网关方法 `openExternalUrl` 由宿主调用系统 URL 处理程序（不经 shell），只放行内置编辑器协议、http(s) 与已保存模板的协议，`file:` / `javascript:` / `ms-*` 等一律拒绝。
  - 拖放上传：把文件 / 文件夹拖到目录行（上传到该目录）、文件行（其所在目录）或空白处（根目录），文件夹保留目录结构（含空目录），同名时询问覆盖；窄屏不提供拖放。
  - 多选：Ctrl/⌘ 点选、Shift 连选，Esc 或「取消选择」清空；多选右键为批量菜单：复制相对 / 绝对路径、在对话中引用、压缩并下载、删除（确认框写明数量，已被选中目录包含的子项不重复删除）。
  - 压缩并下载 ZIP：新 HTTP 路由 `POST /dsh-workspace/sftp/archive`（遍历并检查上限，返回一次性令牌）+ `GET /dsh-workspace/sftp/archive?token=`（流式输出），远程经 SFTP 读流、本机限会话工作区内；上限 10000 个文件 / 2GB，超限在下载开始前报错；符号链接不打包。ZIP 写入器为自带的最小实现（deflate + 数据描述符 + UTF-8 文件名，`src/sftp/zip.ts`），未引入新依赖。
  - 右键菜单支持子菜单（悬停或点击展开，放不下时向左翻）。

### Git 仓库

- 新增：「Git 仓库」侧栏新增「AI 改动」页签（本机与远程会话通用），列出模型在本会话里写入 / 编辑 / 删除过的文件。
  - 「本轮 / 全部会话」两档切换（本轮 = 最近一个轮次），每个文件带操作类型（W 写入 / E 编辑 / D 删除）与操作次数；页签与右侧栏「Git 仓库」标题上显示本轮改动文件数角标。
  - 数据来源：新网关方法 `aiChanges` 在宿主读会话事件（运行中的会话读 `sessions.get(id).snapshotEvents()`，冷会话只读打开 `sessionPersistence`），折叠 `tool/call` + `tool/result`：识别 write / create / edit / str_replace_editor / upload_to_remote，以及 bash / pwsh 里的 `rm`、`Remove-Item`、`del` 等删除命令（带通配、变量的参数不计）；结果报错的调用剔除。远程会话按远程工作区规则换算路径（本机路径不计），本机会话相对 cwd 解析。
  - 点开文件：远程会话优先与「本会话第一次改它之前」的原文对比（远程写入工具存下的基线，新网关方法 `aiChangeBase`）；否则在 git 仓库内相对 HEAD 对比（新增 diff 目标 `head`：最近提交 → 工作区）；仓库外或非 git 目录直接打开文件。非 git 目录也显示该页签。
- 变更：Git 文件列表整行可点 —— 「历史」提交详情的改动文件（原来只能点到文字）、「改动」页（含查看分支时的改动 / 比较列表）与「AI 改动」页，点击行内任意位置打开 diff；行带悬停高亮与手型光标，可键盘操作（`role="button"`、Tab 聚焦、Enter / Space 打开），行内的暂存 / 丢弃等按钮不触发整行点击（`src/client/sidebar/row-activate.ts`）。
- 新增：Git 对比视图对疑似密钥打码（只作用于显示，暂存 / 提交 / 写回仍是真实内容）：常见令牌前缀（sk-、ghp_、github_pat_、AKIA、xoxb- 等）、PEM 私钥正文、`.env` 风格 `KEY=VALUE` 中名称含 SECRET / TOKEN / KEY / PASSWORD 的值、YAML / JSON 的 password / apiKey 等字段、行内 `password=` / `token=` / `secret=`、URL 里的口令、Bearer 凭据；保留首尾少量字符。命中时标题下出现「已打码 · 显示原文」开关，可临时显示原文，换一个 diff 自动恢复打码（`src/client/sidebar/redact.ts`）。

### 任务页、侧边对话

- 新增：右侧栏「任务」页（kind `dshws-tasks`，出现在右侧栏引导列表，受「侧边栏」页签的「任务」开关控制），范围是当前会话所在的任务树（沿父链找到根 + 全部子代理）：
  - 后台任务：经宿主 `ctx.jobs` 列出任务树内的后台任务（进行中在前，带类型、时长、退出码 / 结束详情），展开看实时输出（`observe`，不移动模型的 `job_output` 读取游标；输出缺口 / 流中断有提示），运行中的任务可终止（两击确认，3 秒内有效）。页签不可见时停止 watch。
  - 子代理：树视图 / 拓扑图视图（自绘分层 DAG + SVG，不引入布局库）切换并记住选择；数据来自会话投影 `subagentCatalog`，节点显示运行状态、正在执行的工具 / 最近文本、本轮工具次数；点击在侧栏打开子代理对话（宿主 `subagentchat` 资源），「↗」在主区打开，树根回到主会话。
  - 子代理实时活动摘要：新网关方法 `tasksSubagentLive`（`subagents.listDescendants` + 各会话 `snapshotEvents()` 尾部折叠）；工作流 run：新网关方法 `tasksWorkflowRuns`（折叠任务树各会话的 `tool-workflow/*` 四种事件，并合并 `session/event` 实时镜像；冷树根只读打开持久化日志），页签可见时每 3 秒轮询。
  - 团队看板：读 Lead 会话投影 `agentTeam`（成员 + 待办 / 进行中 / 已完成三列），新建 / 完成 / 重新打开 / 删除（两击确认）经新网关方法 `teamsTaskCreate` / `teamsTaskUpdate` 代表 Lead 调 `agentTeams.createTask` / `updateTask`；revision 过期提示「已被其他成员修改」，Lead 不在运行 / 不是 Lead / 实验层缺失分别提示。
  - 自动打开：新子代理或新后台任务出现时，若「自动打开任务页」开启、视口宽于 640px，打开任务页（只观察显示中的会话；切到老会话不触发；每个新对象只触发一次）。
  - 宿主内部对象（subagents / agentTeams / agents / 会话事件 / `session/event`）统一封装在 `src/host-internal/`，只做结构探测；缺失时网关返回不可用、页面对应区块显示「当前 DSH 版本不支持」或隐藏，不影响插件加载。
- 新增：侧边对话（右侧栏标签 kind `dshws-sidechat`，受「侧边栏」页签的「侧边对话」开关控制）。
  - 会话页头工具区新增「侧边对话」按钮，右侧栏引导列表新增入口：经宿主 `ctx.sessions.fork` 分叉当前会话（复制到最近一个已完成轮次），改名为 `Side: <父会话标题前 20 字>`，在侧栏新窗格打开。子会话是普通会话，也会出现在左侧会话列表；空会话 / 子代理会话不显示按钮。
  - 嵌入方式照搬宿主子代理查看器：资源协议 `dshws-sidechat`（`sessions.retain` 持有引用）+ 自声明子插槽 `dshws.sidechat.conversation` + `SessionProvider` + `conversation.content`（embedded，固定「对话」视图）；输入框、消息流、停止 / 排队均为宿主原生组件。会话已删除时提示并可移除记录。
  - 侧边对话边界：嵌入视图上方提示条说明「历史只作参考、回答不回主对话」；分叉后把边界说明预填进新会话的输入框草稿（宿主按会话持久化的草稿），用户接着写问题发送即带上边界，不额外开模型轮次、不改动会话。
  - 线程列表：从引导入口打开时显示当前会话的侧边对话（标题、创建时间、在侧栏打开 / 在主区打开 / 删除），已删除的会话不列出。来源记录存于宿主偏好 `sidebar.sidechats`（父 → 子 + 时间，最多 200 条，严格校验）。
- 变更：线程列表的「移除记录」改为「删除」，同时从左侧工作区移除该会话：先确认（说明会一并移除左侧会话、记录不可恢复）→ 调宿主 `ctx.uiWorkspace.archiveSession`（与左侧会话列表的移除同一接口；DSH 没有公开的会话删除接口，宿主侧效果是归档，可在「已归档」里找回）→ 关闭各会话侧栏里已打开的该侧边对话标签 → 移除记录。会话仍在运行时宿主拒绝（`workspace/session-active`），与左侧列表一样再确认一次「停止并删除」（`stopActivity`）；宿主失败时显示错误并保留记录。会话已不存在时嵌入页仍提供「移除记录」。
- 修复：会话第一轮进行中点「侧边对话」报 `session/fork-unavailable: ... has no completed turn to fork from`（宿主摘要 `blank` 在轮次开始时就变 false，但分叉要求至少一个已完成轮次）。现在遇到该错误改为友好提示「本轮结束后即可创建侧边对话」，并在该会话运行期间禁用页头按钮与线程页「新建侧边对话」，轮次结束（`running` 变 false）后自动恢复；其他错误仍原样显示。
- 修复：任务页反复自动弹出、手动关闭后还一直弹。根因是每个新子代理 / 新后台任务都调用 `sidebarRight.openTab('dshws-tasks', { revealIfOpened: true })`，而宿主对页面标签的 openTab 总会展开侧栏并激活已有标签，插件又不记录用户的关闭；另外切会话时子代理目录未到达就以空集建基线，随后到达的老子代理（无创建时间）被当成新的，名册里的无主任务 / 孙代理也会触发，去重只存在内存里，插件重挂即丢。现在：
  - 去重键 = 会话 id + 对象 id，持久到 sessionStorage（`dshws.tasksAutoOpen`），订阅回调、会话切换、插件重挂、刷新都不重复触发；
  - 尊重手动关闭：经宿主 `registerCloseHandler('dshws-tasks')` 监听关闭（不可用时以 `tabsIn` 检测「曾自动打开、之后消失」兜底），该会话不再自动打开（刷新后保持），用户手动打开任务页后恢复；
  - 任务页已在该会话侧栏里（含非激活、侧栏收起）时完全不调用 openTab，不再抢焦点；
  - 只算当前会话直接产生的对象：它目录里的直接子代理、owner 为它的后台任务；子代理目录到达前不建基线；
  - 管理页「自动打开任务页」说明补充「已打开时不切换标签；手动关闭后本会话不再自动打开」。
- 不提供：底部 dock（输入框上方的终端 / 后台任务 / Git 改动面板，方案 3.9）—— 按用户决定取消，开发中的实现、页头开合按钮、「侧边栏」页签的「底部 dock」开关与偏好 `sidebar.tabs.dock` 均已删除。已有 `prefs.json` 里残留的 `tabs.dock` 读取时被忽略、下次保存不再写出；升级后仍开着的旧页面提交该键也不会让整次保存被拒。Git 标签的导航参数 `aiOpen`（打开某文件的 AI 改动 diff）保留。

### 终端

- 新增：远程工作区会话里，右侧栏引导页的「新建终端」卡片改开插件 SSH 终端（连到当前工作区主机、初始目录为远程工作区路径），卡片显示「终端（SSH · 主机名）」，下拉菜单只有 SSH 一项，不显示 Ctrl+` 提示。本机会话完全保持 DSH 自带终端：插件以更低 priority 占用宿主同一插槽 key，但 inject 转调宿主卡片条目的 inject、locale 用宿主命名空间，本机会话里直接渲染宿主卡片组件本身（Shell 列表仍由宿主服务端发现）；宿主卡片重注册时跟着重注册，渲染异常时宿主插槽自动回退到宿主卡片。
  - 「侧边栏」页签新增开关「远程工作区使用插件 SSH 终端」（偏好 `sidebar.remoteSshTerminal`，默认开）；关闭（或关闭「SSH 终端」标签）后撤销接管，全部回到宿主行为。
  - 接管生效时，引导页不再单独显示插件的「SSH 终端」卡片（「新建终端」已自适应：本机 = 宿主终端、远程 = 插件 SSH）；关闭接管后恢复显示，远程会话仍有入口。实现为偏好变化时重注册 `dsh-workspace:ssh` 标签类型（带 / 不带 guide），标签类型本身始终保留；已打开的 SSH 标签不受影响（宿主不会因类型重注册关闭标签，正文按不变的类型 id 渲染）。
  - 未覆盖：Ctrl+` 快捷键与其他直接打开宿主 `terminal` 标签的入口仍开宿主终端（宿主快捷键注册表不允许同 id 覆盖、无按会话优先级；「打开后再替换」会先创建本机 PTY，已评估放弃）。
  - 「SSH 终端」标签支持导航参数 `{ hostId?, cwd?, title? }`：有 `hostId` 连指定主机，否则连当前远程工作区；本机会话未指定主机时仍提示「不是远程工作区」。
  - 预览：`node scripts/preview-ui.mjs terminal` 执行 DSH 安装目录里的宿主卡片原码，对照宿主原版 / 本机会话接管后（像素一致）/ 远程会话卡片与下拉菜单。

### 对外打开入口

- 新增：Agent 工具 `open_in_sidebar`（参数 `target` 必填：绝对路径 / 相对会话 cwd 的路径 / http(s) 网址，`title` 可选），在调用方会话的右侧栏打开文件（插件查看器）、文件夹（「文件管理」中定位并展开）或网页（宿主浏览器标签）。
  - 本机会话与远程会话都注册（受「侧边栏」页签的开关控制，切换即时生效，无需重开会话）；远程会话里路径按远程根解析并经 SFTP 区分文件 / 文件夹，盘符 / UNC 仍是本机，macOS / Linux 上根外的 `/` 开头路径按「本机存在且远端不存在」判为本机。返回值与 dsh-better-sidebar 的 `sidebar_open` 一致，远程目标另带 `remoteHost`。
  - 在 Agent 作用域遮蔽 dsh-better-sidebar 的 `sidebar_open`（优先从工具清单中去掉，去不掉时以同一实现同名遮蔽；dsh-better-sidebar 不存在时不做任何事）。
  - 打开在浏览器端执行：工具卡片（`tool.call.toolview`）看到调用由进行中变为成功时打开，按 callId 去重（内存 + sessionStorage），历史重放不会重复打开；**只在当前显示该会话的页面里生效**。卡片显示打开的类型与目标，可「再次打开」。
- 新增：浏览器端客户端服务 `dshWorkspace`（`ctx.provide`，供其他插件使用）：`openFile(path, { line?, mode?: 'preview' | 'edit', sessionId? })`、`openTab('files' | 'git' | 'ssh' | 'tasks' | 'sidechat')`、`reveal(path)`，返回是否已交给侧栏。文件查看器支持 `line`（跳到该行并切到代码视图）与 `mode` 导航参数。

### 文档

- 文档：README（中英）移除「侧边栏依赖 dsh-better-sidebar」的过时说明，新增「侧边栏」章节与「与 dsh-better-sidebar 的关系」；GitHub Release 说明不再要求先装 dsh-better-sidebar；`cordis.patch.yml`、客户端入口注释与需求文档 / 开发计划中按 better-sidebar 设计的描述改为现状（宿主原生右栏）。

## 0.12.2（2026-10-09）

- 新增：Git 对比视图默认折叠未改动的部分（与 VS Code 一致，只显示改动及上下 3 行，折叠处可点开）；标题栏「展开全部」开关可显示完整文件。
- 新增：代码编辑器右侧默认显示缩略图（minimap），底部状态栏的「缩略图」开关可关闭。两项开关都记在本机，并在所有打开的编辑器间同步。

## 0.12.1（2026-10-08）

- 修复：远程会话的 `read` 每次只返回一行，传 `limit` 也会报 `limit must be less than or equal to 1`。原因是取默认行数时误读了 `offset` 说明里的 `Defaults to 1.`；现在只读 `limit` 自己的默认值，读不到就用 2000。（#3，感谢 @slj1935024637）

## 0.12.0（2026-09-30）

- 新增：远程会话的 Agent 工具 `upload_to_remote`，把对话里的图片 / 文件（用户粘贴的，或 `generate_image`、`read_image` 等工具产生的）上传到远程工作区。只在远程会话注册，本地会话的工具清单不变。
  - 来源：只接受 `attachment_id`（`sha256:…`），并且必须是本会话里出现过的附件。附件经 DSH 附件服务读取，写入生效前核对内容哈希等于 id。**不接受任何本机路径**，这个工具不能被用来把本机文件外传到远端。
  - 来源里的生图结果：只认 `generate_image` / `edit_image` / `get_image_generation_task` 这三个工具结果里的 `meta.images`，其他工具结果里的同名字段不算，防止被伪造的引用扩大范围。图片在写入时才读取。
  - 目标：只接受相对工作区根的路径，拒绝绝对路径、`..`、`~`、反斜杠、以 `/.` 结尾的写法、控制字符（含 C1），以及双向控制符、零宽字符等会让显示与实际不一致的字符。
    - 在远端用 SFTP `realpath` 按真实路径校验，工作区内的目录链接允许，指向工作区外的一律拒绝。
    - 目标本身是符号链接时拒绝，不跟随。
    - 临时文件独占创建（O_EXCL）后再改名，改名前与写完后各复核一次；临时文件名里的原文件名按字节截断，不会超过 255 字节上限。
    - 覆盖时优先原子改名；只有服务端不支持该扩展时才退化为「删旧 + 改名」，权限不足等真实失败直接报错，不会丢掉原文件（远程编辑器保存也一并修正）。
  - 受保护位置：任意层级的 `.git/`、`.ssh/`、`.gnupg/`、`.husky/`，以及 `authorized_keys`、`.envrc`；远端家目录下紧接的点文件和点目录（`.bashrc`、`.config/autostart/…`），按真实路径判断，工作区根是家目录本身还是它的上级（`/home`、`/`）都拦得住。
  - 新建文件不带可执行位（请求 0644，实际权限再受远端 umask 约束）；覆盖会替换整个文件，原文件的属主和权限不保留。默认不覆盖（需显式 `overwrite`）。单文件上限 100 MB。
  - 同一会话的上传串行执行；排队中的调用可以被中止；前一个上传卡住超过 10 分钟后，不再挡住后面的上传。
  - 上传成功后才把覆盖前的原内容存入改动前存档（与 write / edit 共用）。上传后对该文件的「已读」登记同时覆盖模型原来的写法和真实位置。
  - 每次调用（包括被拒绝的）都写一条连接日志，不含文件内容；日志里的外部输入经过转义并截断，不能伪造出新的一行。
  - 注意：DSH 保存图片附件时会做归一化，传到远端的是 DSH 存档的那一版，不一定和原始文件逐字节相同。
- 新增：远程会话里 `present` 支持远程文件，交付卡片和收尾正文里的文件链接会在侧栏打开远程预览。
  - 原因：宿主的 `present` 用本机文件系统检查路径，远程路径一律报 file not found，卡片出不来。
  - 做法：在远程会话里接管 `present`，在远端检查文件存在、是普通文件、不是符号链接；工具成功返回后，按宿主格式追加 `deliverables/presented` 事件（核对版本 0.2.0-rc.2），卡片界面完全复用宿主的。
  - 路径统一记为规范化后的远程绝对路径；相对路径和照抄占位目录的路径都会换算过去。
  - 一次调用里全部是本机文件时（如生图后复制到本机的预览图），交回宿主原实现；本机与远程混在一起时报错，提示分两次调用。
    - Windows 宿主：盘符 / UNC 路径是本机文件。macOS / Linux 宿主：`/` 开头又不在远程工作区根下的路径，本机存在且远端不存在时按本机文件处理（例如 `/Users/me/pic.png`）。
    - 插件写入的交付事件给每个文件加上 `remoteHost` 标记，▾ 菜单的服务端查询以它为准，与 present 时的判断保持一致。
  - 卡片右侧 ▾ 菜单对远程文件改为：菜单里的应用只有「侧栏预览」（默认），「打开」会在侧栏打开远程预览；「显示文件位置」会打开插件的「文件管理」，逐级展开到该文件，高亮并滚动到它所在的行（路径含隐藏目录时自动显示隐藏文件）。之前这两项都会报「无法在文件管理器中显示」。
    - 实现：▾ 控件直接调用全局 `fetch('api/present.open?…')`，宿主没有可替换的回调，所以在浏览器端包装 `fetch`，只处理这一个路径、并且只处理远程工作区会话里的远程文件。
    - 其余请求，包括本地会话的，以及远程会话里交付的本机文件，一律原样交给宿主；查询失败也交还宿主。
    - 新增网关方法 `presentedFile`：按「会话 + 事件序号 + 文件下标」读交付事件，判断该文件是不是远程文件、远程路径是什么。
    - 文件不在工作区根下，或当前显示的会话属于别的工作区时，「显示文件位置」返回宿主的「没有可用的主机路径」提示，而不是假装成功。
    - 接管了 DSH「文件」侧栏时，定位到接管的那个标签，不会出现两个文件树。
    - 标签重新挂载（切换会话后回来）时不会重复执行定位。
    - `fetch` 包装全局只装一层，插件热更新时不会层层叠加。
    - 菜单里「显示文件位置」及执行后的提示文字来自宿主，实际行为是在插件「文件管理」里定位，文字对不上属于宿主控件的限制。

## 0.11.1（2026-09-30）

- 修复：「添加工作区」弹窗里在连不上与连得上的主机之间来回切换会卡住，连带正常主机与状态轮询一起排队直到超时。
  - 原因：连不上的主机每次请求要挂约 107 秒（5 次 × 20 秒握手超时重试），切走后请求也不会撤回；挂着的请求占满浏览器对同一地址的并发连接（HTTP/1.1 每个来源 6 个），后面的请求全部排队。
  - 主机连不上（拒绝连接、不可达、域名解析失败、握手超时）不再重试：拒绝连接立即失败，不可达最多等一次握手超时（默认 20 秒）；连接中途断开仍按原策略重试。
  - 弹窗里同一台主机的家目录请求复用进行中的那一次，成功后记住，来回切换不再重复发请求。
  - 页面状态轮询：上一次还没返回就不再发新的，不再在排队时越堆越多。
  - 「新建终端」不再因为一台主机正在连接而整个禁用。

## 0.11.0（2026-09-30）

- 新增：全局配置里的「更新」卡片。
  - 检查更新：先直连 GitHub（`releases/latest` API，失败时改读发布页跳转地址），再不通回退 npm 官方源（`registry.npmjs.org`，不用同步滞后的 npmmirror）。
  - 下载并更新：安装包下载到 `~/.dsh/workspaces/updates/`，按发布页的 sha256（npm 来源用 sha512 integrity）校验，再检查包名、版本与插件声明，然后交给 DSH 插件管理器安装。
    - 安装不先卸载：先卸载会把插件自身的后端停掉，后续安装就没人执行了。
    - 安装包文件名每次带时间戳，避免宿主报 `ambiguous-install`。
  - 上传离线包：上传 `.tgz` 后先检查，显示版本、大小、sha256，以及相对当前版本是新、同版还是降级；确认后才安装。
  - 安装完成后提示重启：桌面版提供「立即重启 DSH」按钮，其他环境提示手动重启。
  - 未打包的开发构建不检查更新；GitHub 访问频率受限时有提示。
- 升级完成后提示重启：在全局配置里看着安装完成时弹窗「升级完成」（桌面版可直接「立即重启 DSH」或「稍后重启」，网页版提示手动完全退出再打开）；更新卡片顶部常驻醒目的待重启提示条（刷新页面后仍在），直到重启加载新版本
- 修复：在「远程工作区」页面安装新版本后，宿主会重载插件的浏览器端代码、把页面关回会话，「升级完成」提示随之丢失，要手动再进来才看到。现在开始安装时在浏览器里留下标记，重载后自动回到全局配置并弹出重启提示（弹过即清，30 分钟后失效；后台已是新版本时静默清除）
- 新增：「远程文件」「远程 Git」改名为「文件管理」「Git 仓库」，并支持本地工作区。
  - 本地会话直接读写本机文件、执行本机 git。
  - 根目录由宿主按会话 cwd 推导，浏览器只传会话 id。
  - 路径限定在工作区内（含同仓库的其他 git 工作目录）；词法检查后再做 realpath 校验，拒绝经符号链接或目录联接逃出工作区。
  - 按用户决定，本地写操作不受 DSH 会话沙箱策略限制。
- 新增：文件树右键菜单补齐新建文件、新建文件夹、上传到此处、下载、删除（远程与本地都有）；名称输入与删除确认改用侧栏内浮层（桌面版不支持 `window.prompt`）。
- 新增：接管 DSH 自带的「文件」侧栏（kind `files`，含 Ctrl/⌘+P），改开「文件管理」。
  - 在全局配置里可以开关，默认开启。
  - 若已被其他插件（如 better-sidebar）接管则不抢，只在全局配置里提示去关闭它的「文件」标签；关闭后自动接管，无需刷新。
- 升级后只刷新了页面、DSH 后台仍是旧版本时，本地工作区的「文件管理」「Git 仓库」直接提示完全重启 DSH，不再报「主机不存在：local:…」
- 「文件管理」「Git 仓库」的左侧列表与右侧预览各自滚动：会话顶部标签的宿主视图区高度随内容增长，原来列表与预览会被外层会话容器一起滚动；现在面板高度钉成可视高度（扣除上方内容与输入框），宽屏两列各自滚动
- 文件树、改动列表（含查看分支的改动、与当前分支比较）改为虚拟滚动：只渲染可见区附近的行，5000 个文件 / 3000 条改动实测只渲染约 40 行；分区标题（已暂存 / 更改 / 未跟踪）滚动时吸顶
- 重构：远程 Git 的执行方式改为「参数数组 + 执行器」（远程 = 逐个单引号转义后经 SSH，本地 = 直接起 git 进程、不经 shell）。
  - 所有 git 命令统一加 `-c core.fsmonitor=false`，防止恶意仓库借 fsmonitor 执行命令。
  - 新增用本机 sh 代替 SSH 的执行器测试。

## 0.10.1（2026-09-30）

- 修复：宿主目录选择能力为 native（macOS 桌面版，只能弹系统对话框）时，「添加工作区」的本机一栏直接显示 `directory-picker/unavailable ... serves "native"` 报错。现在改由插件宿主端自己列本机目录（新增远程方法 `localList` / `localMkdir`，Node fs 实现，只列子目录），macOS 上也能应用内浏览、新建文件夹；「使用系统对话框…」按钮仍保留（取用顺序与官方 native picker 一致）
- 修复：桌面版远程文件侧栏的 HTML / Markdown 预览白屏或报 `Browser access is disabled`。桌面版本机 Web 服务只放行 DSH 自身页面来源的请求，而预览 iframe 刻意不带 `allow-same-origin`（远程 HTML 不可信），它的请求拿不到放行令牌。桌面版改为 srcdoc 预览：页面里的相对样式表 / 脚本 / 图片 / CSS `url()` 与 `@import` 经新增的远程方法 `sftpReadData` 取回后内联（单个资源上限 8 MB），iframe 仍是不透明来源；网页版保持原来的预览路由。已知限制：脚本运行时 fetch / 动态加载的相对资源不可用
- 修复：Monaco 编辑器样式丢失时（macOS 反馈：代码行乱飘、多出一个原生输入框）不会自己恢复——monaco.js 只执行一次，样式标签被移除后就再也不注入。现在构建产物把 CSS 全文存到 `window.__dshwsMonacoCss`，每次创建编辑器 / 对比视图前核对并补回（也兼容挂在 Shadow DOM 里的情况）
- 桌面版预览内联增加兜底：`sftpReadData` 失败（典型是宿主端仍为旧版本、新方法 404）时，样式表 / 脚本 / SVG 退回用 `sftpRead` 按文本读取，页面不再整页丢样式；仍失败的资源在预览上方提示（含「请用 ⌘Q 完全退出」），不再静默
- DSH NEXT（页面为 `dsh-app://app`）适配：HTTP 请求（上传 / 下载 / 预览路由 / 图片）保持页面同源的相对地址——NEXT 只给主框架的同源请求附渲染进程令牌，直连 `streamBaseUrl` 的 http 地址会被拒（`Browser access is disabled`）；WebSocket 仍走 `streamBaseUrl`。下载在自定义协议页面上改为 fetch 取回再存盘（`<a download>` 是导航请求，拿不到令牌），失败时弹出原因
- 编辑器创建后自检隐藏输入框的定位，样式未生效时在控制台输出定位信息（样式标签数量 / 长度、是否 Shadow DOM、UA 等）；补样式时改用编辑器所在文档
- 信任围栏：回环主机名视为同一族（`localhost` / `127.x` / `[::1]` 互访放行，含 `sec-fetch-site: cross-site`），外站与局域网规则不变
- 插件宿主端还是旧版本（升级后只刷新了页面）时，「添加工作区」不再显示 `transport failure ... HTTP 404`，改为提示完全重启 DSH
- Windows：原子写的改名步骤遇到杀毒 / 索引占用（EPERM / EACCES / EBUSY）时退避重试约 0.6 秒，失败则清理临时文件；自动解锁的 DPAPI 调用改用 `%SystemRoot%` 下 PowerShell 的绝对路径，被系统策略（AppLocker / 受限语言模式）拦截时给出可读原因
- macOS：本机路径比较不区分大小写（APFS 默认不区分），与 Windows 一致
- 跨平台修正（macOS / Linux）：
  - 远程工作区路径映射：占位目录在 macOS / Linux 上本身以 `/` 开头，原先会被当成远程路径原样发给远端（Agent 工具与侧栏打开文件都受影响）；现在先判断是否位于占位目录下（宿主端同时比较字面路径与 realpath），客户端比较键只在 Windows 风格路径上忽略大小写
  - 私钥路径支持 `~/.ssh/...`（原先 readFileSync 不认 `~`），中文占位提示同步改为 `~/.ssh/id_ed25519`
  - 终端：macOS 搜索改为 ⌘F（Ctrl+F 留给 readline / vim / less），Option 当 Meta（Alt+B/F/D 按词移动）；Ctrl+Shift+C / V 补 `preventDefault`，修复 Chromium 上粘贴两次；右键菜单的快捷键提示按平台显示
  - 保险箱、known-hosts、绑定、终端记录、偏好文件以 0600 写入、数据目录 0700 创建（macOS / Linux 原先是 0644 / 0755，明文字段对同机其他用户可读）
  - ssh-agent 认证在 Windows 上回退到 OpenSSH 命名管道；Windows 保留名判定补上带扩展名的情况（`aux.api` 等）
- 「添加工作区」目录浏览的错误改为横幅样式：标题说明哪个目录/操作失败，不可读时给出可能原因，原始报错折叠在「详情」里（可选中复制），带「重试」与关闭；进不去的子目录不再影响当前列表
- Windows 卷根的系统保留目录（`System Volume Information`、`$RECYCLE.BIN` 等）按隐藏处理——部分磁盘 / 网盘挂载（如 115 网盘）不会给它们打隐藏属性，点进去会报 `EINVAL ... readdir`
- 修复：115 网盘等挂载盘上的**空文件夹**打不开（报 `EINVAL: invalid argument, readdir`）。这类驱动对空目录的枚举直接返回失败（cmd `dir` 显示 File Not Found），现在遇到该错误时先列上一级确认目录存在，存在就按空文件夹显示，可以正常选作工作区
- 终端 WebSocket 地址改为优先使用宿主注入的 `__DSH_TRANSPORT__.streamBaseUrl`（与宿主自身流通道一致），不再只看页面地址——针对 macOS 桌面版终端一直「连接中断，正在重连」而 SFTP 正常的反馈；首次断开时在控制台输出目标地址，服务端拒绝终端连接的日志补上 Origin / Sec-Fetch-Site 便于排查

## 0.10.0（2026-09-29）

- 移动端/窄屏适配：新增 `useNarrow()`（主区按视口宽度判断）与 `@media (max-width: 640px)` 样式段——主机列表不再换行、改为整卡左右滑动；页签横向滚动；页面内边距与头部收紧（简介在窄屏隐藏）
- 「上锁」与「更多」（改主密码 / 导出 / 导入）从头部移到「全局配置」页签新增的「保险箱」区，头部只留标题
- 远程文件在窄屏改为自适应单列；点文件后的预览/编辑改成全屏浮层（带关闭按钮，未保存修改仍会确认），不再占用右侧一列；浮层以本页为定位上下文（`absolute`，不再压住宿主网页版头部），并在窄屏隐藏编辑器顶部的「大小 · 权限 · 修改时间」一行
- 隐藏 Monaco 在 iPad / 触屏 UA 下自带的悬浮键盘按钮（`iPadShowKeyboard`，点了不会按预期唤出输入法）
- 「新建/编辑主机」表单去掉「SSH Agent」认证方式（旧数据在表单里按「密码」展示，底层类型与存储保留；`vault/store.ts` 的四个 switch 顺带补 `default` 兜底），并修正窄屏表单单列排布
- 「添加工作区」弹窗：窄屏改单列并收紧高度预算（左栏限高、底栏竖排），避免输入框与按钮被挤出屏幕
- 接管「添加工作区」的优先级由 -200 降到 -1000，注册回调加 try/catch 与「head 是否为自己」自检——针对网页端被 dsh-bridge 抢占弹窗的问题（dsh-bridge 用 -10、dsh-remote 用 -100，宿主规则是 priority 最小者渲染）
- 修复：公网访问时「添加工作区」仍弹出 dsh-bridge 的弹窗。根因有两条：① 动态包的 priority 会被宿主运行器改写成页内递减计数，-1000 不生效——改为「不是 head 就重注册」直到压过 dsh-bridge，并订阅插槽变化随时抢回；② dsh-bridge 在 document 捕获阶段按按钮文字截走点击（`stopImmediatePropagation`），宿主根本不会打开插槽——改为在更早的 window 捕获阶段临时中和按钮的 aria-label，事件照常交给宿主（仅在开启接管时生效，见 `workspace/bridge-compat.ts`）
- 修复：移动端「添加工作区」进入盘符后目录列表无法滚动、只显示前几行（窄屏单列用的 grid + 自适应高度让列表拿不到有限高度）——改为固定高度的纵向 flex，目录列表独立滚动
- 修复：手机上点左侧「远程工作区」进入本页时，抽屉图标收成窄栏但抽屉容器仍然打开（装了 dsh-bridge 时抽屉容器由它的 `body.dsh-drawer-open` 控制）——收起时两边一起收
- 手机上从抽屉里点「添加工作区」打开弹窗后，自动收起抽屉（同样同时收宿主与 dsh-bridge 两侧）

## 0.9.1（2026-09-29）

- 修复：浏览器 bundle 注册到 `window.__ModuleLoader__` 的 id 仍写死旧包名，宿主 `dsh-client-modules` 按包名核对不通过（`loaded without registering "<id>"`），会让 DSH Desktop 直接启动失败（0.8.0 / 0.9.0 都受影响）；现改为从 `package.json` 现读包名，并补冒烟断言 `ModuleLoader 注册 id = 包名` 兜住这类改名漏改

## 0.9.0（2026-09-29）

- 适配 DSH 0.2.0-rc.1 内核：`peerDependencies` 里 `@deepseek-ai/dsh-*` 的范围由 `^0.1.5-rc.2` 改为 `^0.1.5-rc.2 || ^0.2.0-rc.1`（旧内核仍可安装；0.2.x 内核不再被宿主判定为不兼容而禁用插件）
- 开发依赖（`@deepseek-ai/*`）同步升到 0.2.0-rc.1，README 的依赖表注明同时兼容 0.1.x / 0.2.x

## 0.8.0（2026-09-29）

- 包名由 `dsh-workspace` 改为 `@yh4922/dsh-workspace`（npm 上原名已被他人占用）；`cordis.patch.yml` 里 insert 的 name 必须与包名一致（否则插件加载不到），远程清单的身份名 `PACKAGE` 也一并对齐
- 发布流程新增发布到 npm（`registry.npmjs.org`，`publishConfig.access=public`），并在 GitHub Release 额外上传固定文件名 `dsh-workspace.tgz` 供不带版本号的安装地址使用
- 安装说明改为不带版本号：主推 `dsh plugin add @yh4922/dsh-workspace`，补充升级方式与旧包名迁移说明

## 0.7.7（2026-09-29）

首个公开发布版本。以下为自 0.7.2 以来的变化，更早的版本仅为本地开发版本。

- 远程工作区页面新增「全局配置」页签：接管「添加工作区」、自动解锁两个开关移到这里（标题栏只保留上锁 / 更多）
- 「全局配置」里新增「关于」：版本、作者、许可证，以及仓库、更新日志、版本发布、使用说明、问题反馈的链接
- 修复：「接管添加工作区」开关被撑变形、挤出可视区，且开关旁没有文字说明
- 远程文件、远程 Git 在宽屏分栏时，左侧列表宽度可拖动调整：最小 240px、右侧至少保留 320px；双击恢复默认，按面板分别记住
- 远程文件 / 远程 Git 的复制提示改为浮窗，不再插在列表顶部造成抖动
- 添加工作区弹窗：远程主机按分组树形展示；选中主机显示「连接中」、不阻塞界面、失败可重试；「此电脑」「远程主机」可展开收起
- 修复：远程工作区页面被宽内容撑开

## 0.7.2

- 远程文件树、Git「文件」页与改动列表加右键菜单（重命名 / 复制 / 粘贴 / 复制路径 / 暂存 / 放弃等）
- 修复：Agent 运行时远程 Git 面板反复刷新、关掉右侧预览

## 0.7.1

- 主机 / 分组弹窗加宽；分组表单精简为名称 + 父级分组；分组下拉支持筛选与新建
- 主机可拖到分组里换分组

## 0.7.0

- 重做「添加工作区」弹窗：左侧本机快捷位置、盘符与远程主机，右侧目录浏览（上一级、面包屑、路径输入）
- 接管开关即时生效，不用刷新

## 0.6.x

- 0.6.4：远程 Git 统一为 文件 / 改动 / 历史 三个页签
- 0.6.3：分支切换移到顶部下拉（筛选、刷新、一行式提示）
- 0.6.2：可为每个会话设置默认查看的分支
- 0.6.1：远程文件 / 远程 Git 界面样式优化（统一图标、状态徽标、分叉图引用胶囊）
- 0.6.0：保险箱「在本机记住」自动解锁（Windows 使用 DPAPI）

## 0.5.x

- 0.5.4：改动页自动刷新；diff 可「查看源文件」
- 0.5.3：检出在另一个 git 工作目录的分支可直接修改与提交；修复会话顶部标签不出现
- 0.5.2：修复 diff 左右 / 上下切换、右侧内容不更新
- 0.5.1：查看分支时可编辑与提交（未检出分支经临时索引提交）
- 0.5.0：远程文件 / 远程 Git 自适应分栏；会话顶部新增「远程文件」「远程 Git」标签

## 0.4.x

- 0.4.1：分支改为只读查看（不检出）
- 0.4.0：远程 Git 面板：改动、diff、分支、带分叉图的历史

## 0.3.x

- 0.3.1：Markdown 预览；离线安装脚本自动关闭 DSH
- 0.3.0：远程工作区右侧栏：远程文件查看编辑、远程文件树、SSH 终端；HTML 预览

## 0.2.x

- 0.2.1：修复远程会话的 write 写到了本机
- 0.2.0：远程工作区绑定、Agent 远程工具（read / write / edit / glob / grep / bash）、添加工作区弹窗

## 0.1.x

- 主机与分组管理、凭据保险箱、SSH 连接池（跳板、代理、指纹校验）、交互式终端、SFTP 文件浏览、Monaco 编辑器