dsh-linked-workspace 0.6.2 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.7.0 — 2026-11-09
+
+- **VSCode-like tree interaction**: single-click a folder to expand/collapse and single-click a file to open it. A single-click preview tab is replaced by the next file; double-click pins the tab so later single clicks do not overwrite it. Double-clicking a folder keeps it expanded.
+- **Terminal shortcuts in the directory toolbar**: one button opens a system terminal at the current remote directory (via `ssh`), and linked workspaces get a second button for the local directory.
+- **Keyboard shortcuts**: `Ctrl/Cmd+S` save, `Ctrl/Cmd+W` close tab, `Ctrl+Tab` / `Shift+Ctrl+Tab` cycle tabs, `Ctrl/Cmd+B` toggle the directory panel, `Ctrl/Cmd+Shift+F` file search.
+- **Unsaved-close prompt**: closing a dirty tab now offers Save / Discard / Cancel instead of silently losing edits.
+- **Auto save setting**: Settings → Connections → Editor behavior adds an auto-save switch; when enabled, edits are saved about one second after typing stops. Default remains off.
+
 ## 0.6.2 — 2026-11-05
 
 - Fixed Markdown/document JSON transport failing with a Windows GBK codec error for characters such as the superscript minus (U+207B); the Python bridge now emits UTF-8/ASCII-safe JSON and configures UTF-8 stdout.

package/README.en.md

@@ -49,18 +49,21 @@ The content panel now edits **Markdown / PDF / DOCX / XLSX / PPTX** files on bot
 ### Right-sidebar linked-workspace directory
 
 - The directory is a fixed panel at the far right of the sidebar: **remote tree on top, local tree below**, both rooted at “All files”. Plugin internals (`.local`/`.remote`) are hidden by default but can be shown with the hidden-files toggle.
-- **Single click selects, double click opens**: a single click highlights a row; double-clicking a folder expands/collapses it; double-clicking a file opens it in the content panel while the directory panel stays visible.
+- **Single click opens, double click pins**: clicking a folder expands/collapses it immediately; clicking a file opens it in the content panel, and clicking another file replaces the current unpinned preview tab. Double-click a file to pin its tab so later single clicks do not replace it; double-clicking a folder only keeps it expanded.
 - **Layout**: conversation → content panel (internal file tabs) → directory panel. The content panel shows “Open a file / Select a file from the workspace directory tree” when nothing is open. A toolbar button shows/hides the directory panel.
 - Toolbar:
   - **Tree switch**: all files / changed files / all changes (git status from remote and local sides).
   - **Search in files**: at least two characters; remote uses `find`, local walks the tree. Results are grouped by remote/local.
   - **Open options menu**: editor / system default app / copy path.
+  - **Open terminal**: the remote button in the remote tree toolbar opens the system terminal and SSHes into the current remote directory; linked workspaces also show a local button that opens a terminal in the local directory. The remote terminal uses the system `ssh` client, so it may ask for a password or host-key confirmation.
   - **Transfer**: bidirectional. Select a remote file/folder to copy it into the local `.remote/` folder; select a local file/folder to copy it to the corresponding relative remote path. Jobs run one at a time through a queue.
   - **Show/hide hidden files**: applies to both trees.
   - **Refresh**: reload roots, git status and search.
 - File-type icons for JS/TS/Python/JSON/Markdown/Shell/YAML/images/archives/config files, etc.
 - Editor: line numbers, syntax highlighting (layered rendering), theme colors, `Ctrl/Cmd+S` save, conflict prompt (reload/force save), read-only protection for binary and >2 MB files, UTF-8/LF/CRLF/line-count status bar. The embedded content panel hides the path/save header; unsaved changes show a gray dot in the file tab. Read-only tabs render the file content but cannot be edited or saved.
-- Multiple files can be open at once (up to 12 slots). Local files use the same internal editor and can be edited and saved.
+- **Shortcuts**: `Ctrl/Cmd+S` saves the current file; `Ctrl/Cmd+W` closes the current tab (with a save/discard/cancel prompt when dirty); `Ctrl+Tab` / `Shift+Ctrl+Tab` cycles tabs; `Ctrl/Cmd+B` toggles the directory panel; `Ctrl/Cmd+Shift+F` opens file search.
+- **Auto save**: enable it under Settings → Connections → Editor behavior. It saves about one second after you stop typing. When off, use `Ctrl+S`. Closing a dirty file always asks first instead of discarding silently.
+- Multiple files can be open at once (up to 12 slots). A single click opens a preview tab and replaces the current unpinned preview; double-click pins the tab; clicking the same file focuses its existing tab. Local files use the same internal editor and can be edited and saved.
 
 ### Running indicator and local skills
 
@@ -115,6 +118,10 @@ Old “Remote directories” tabs are restored after refresh through hidden lega
 
 See [CHANGELOG.md](CHANGELOG.md) for the full version history.
 
+### 0.7.0
+
+Single-click tree navigation with preview tabs and double-click pinning, remote/local terminal buttons with `cd`, VSCode-like shortcuts, unsaved-close prompts, and an auto-save switch under Settings → Connections.
+
 ### 0.6.2
 
 Fix Windows GBK JSON transport errors for Markdown characters such as the superscript minus; PDF pages now load lazily and the source PDF is cached, avoiding long loading hangs on large files.

package/README.md

@@ -50,18 +50,21 @@
 ### 右侧栏「联动工作区目录」
 
 - 面板固定在右侧栏最右边：**上方远程目录树，下方本地目录树**，两棵树根部都显示「所有文件」；本地树自动隐藏插件的 `.local`/`.remote` 内部目录。
-- **单击选中，双击打开**：单击行只选中（高亮），双击文件夹展开/折叠，双击文件在**文件内容面板**的新标签中打开；目录面板固定在最右侧，始终可见。
+- **单击打开，双击固定**：单击文件夹立即展开/折叠；单击文件直接在文件内容面板打开，再次单击其他文件会替换当前未固定的预览标签。双击文件可固定该标签，之后单击其他文件不会覆盖它；双击文件夹只保持展开。目录面板固定在最右侧，始终可见。
 - **面板布局**：目录树是右侧固定面板（带工具栏按钮开/关，不再是标签页）；会话面板与目录面板之间是文件内容面板，没有打开文件时显示「打开文件 / 从工作区目录树中选择文件」占位。
 - 工具栏（右键栏右上角）：
   - **切换文件树**：所有文件 / 已更改的文件 / 所有更改。更改列表来自远端与本地的 `git status`（分支、状态、暂存标记；删除项置灰）。
   - **在文件中搜索**：搜索框输入 ≥2 个字符后，远端用 `find`、本地用目录遍历按文件名过滤，结果分「远程目录 / 本地目录」列出。
   - **打开选项菜单**：编辑器 / 系统默认应用（把远端文件下载到临时目录后交给本机应用打开）/ 复制路径。
   - **传输按钮（双向）**：选中远端文件/文件夹时传输到本地 `.remote`；选中本地文件/文件夹时传输到远端对应相对路径（进入传输队列，一次一个任务并显示状态）。
+  - **打开终端**：远程按钮位于远程目录树右上角，打开本机终端并用系统 `ssh` 直接进入当前远程目录；联动工作区还会显示本地按钮，直接打开本地目录。远程终端首次连接可能需要确认主机指纹或输入密码。
   - **显示/隐藏隐藏文件**：同时约束远程目录和本地目录；打开目录时默认显示隐藏项（包括 `.local`/`.remote`），可用按钮隐藏。
   - **刷新**：重新拉取根目录、git 状态与搜索。
 - 不同文件类型使用不同彩色图标（JS/TS/Python/JSON/Markdown/Shell/YAML/图片/压缩包/配置文件等）。
 - 编辑器：行号、语法高亮（叠层渲染）、主题配色、`Ctrl/Cmd+S` 保存、冲突提示（重新加载/强制保存）、二进制与 >2 MB 文件只读保护、UTF-8/LF/CRLF/行数状态栏；内嵌内容面板不显示文件路径/保存工具条，未保存修改在文件标签前显示灰点。
-- **多个文件同时打开**：文件内容面板内最多同时打开 12 个标签；点文件新增标签，重复点同一文件聚焦原标签；本地文件与远端文件共用内部编辑器，本地文件可编辑保存。
+- **快捷键**：`Ctrl/Cmd+S` 保存当前文件；`Ctrl/Cmd+W` 关闭当前标签（未保存时提示保存/放弃/取消）；`Ctrl+Tab` / `Shift+Ctrl+Tab` 切换标签；`Ctrl/Cmd+B` 显示/隐藏目录面板；`Ctrl/Cmd+Shift+F` 打开文件搜索。
+- **自动保存**：设置 → 连接 →「编辑器行为」中开启；停止输入约 1 秒后自动保存。关闭时使用 `Ctrl+S` 手动保存；未保存文件关闭前会弹窗，不会静默丢弃。
+- **多个文件同时打开**：文件内容面板内最多同时打开 12 个标签；单击文件打开预览标签并替换未固定的预览，双击固定标签，重复点击同一文件聚焦原标签；本地文件与远端文件共用内部编辑器，本地文件可编辑保存。
 
 ### 运行中图标 / 本地技能
 

package/docs/API.md

@@ -66,8 +66,8 @@ relative to the scope root, or absolute inside it.
 | `fs.rename` | `{ workspaceId?/linkedId?, from, to }` | `{}` |
 | `fs.delete` | `{ workspaceId?/linkedId?, path }` | `{}` |
 | `fs.home` | `{ workspaceId?/linkedId? }` | `{ home }` |
-| `settings.get` | `{}` | `{ editorTheme, editorThemeFamily, editorThemeMode, fileOpenMode }` |
-| `settings.update` | `{ editorTheme?, editorThemeFamily?, editorThemeMode?, fileOpenMode? }` | `{ editorTheme, editorThemeFamily, editorThemeMode, fileOpenMode }` |
+| `settings.get` | `{}` | `{ editorTheme, editorThemeFamily, editorThemeMode, fileOpenMode, autoSave }` |
+| `settings.update` | `{ editorTheme?, editorThemeFamily?, editorThemeMode?, fileOpenMode?, autoSave? }` | `{ editorTheme, editorThemeFamily, editorThemeMode, fileOpenMode, autoSave }` |
 | `local.browse` | `{ path? }` | `{ path, parent, home, entries: [{ name, path }] }` |
 | `local.mkdir` | `{ path, name }` | `{ path }` |
 | `linked.list` | `{}` | `{ links: LinkInfo[] }` (each link carries `running`) |
@@ -79,6 +79,7 @@ relative to the scope root, or absolute inside it.
 | `linked.syncCancel` | `{ id }` | `{ cancelled: boolean }` |
 | `local.list` | `{ path }` | `{ path, entries: [{ name, path, type, size, mtime }] }` |
 | `local.openExternal` | `{ path }` | `{ opened, path }` |
+| `terminal.open` | `{ workspaceId?/linkedId?, side: 'remote'\|'local' }` | `{ opened, side, path, host? }` |
 | `fs.openExternal` | `{ workspaceId?/linkedId?, path }` | `{ opened, localPath, size }` |
 | `localWorkspace.create` | `{ path, name? }` | `{ workspaceId, title, path }` |
 | `session.info` | `{ sessionId }` | `{ sessionId, cwd, running }` |
@@ -112,7 +113,7 @@ Under `$DSH_HOME/linked-workspace/`:
 
 - `workspaces.json` — direct remote directories (no credentials).
 - `linked.json` — linked workspaces (no credentials).
-- `settings.json` — `{ editorTheme, fileOpenMode }`.
+- `settings.json` — `{ editorTheme, editorThemeFamily, editorThemeMode, fileOpenMode, autoSave }`.
 - `known_hosts.json` — trust-on-first-use host key fingerprints.
 - Local linked directories also hold `.local/linked.json` (same binding without
   secrets) and the optional `.remote/` mirror.

package/docs/VERIFY.md

@@ -71,18 +71,22 @@ Host code (lib/) reloads live with `plugin_manager set_plugin include:linked-wor
 1. 会话标题栏「打开右侧边栏」→「+」→「联动工作区目录」；旧标签页刷新后标题也会自动改成该名字。
 2. 面板：右侧固定目录面板包含**上方「远程目录」、下方「本地目录」**；工具栏的面板按钮可开/关整个目录面板。中间是文件内容面板；未打开文件时显示「打开文件 / 从工作区目录树中选择文件」。本地树默认隐藏 `.local`/`.remote`，开「显示隐藏文件」后可见。
 3. 展开工作区 → 目录树懒加载；文件行有按类型区分的彩色图标（.py/.ts/.json/.md/.png 等）。
-4. **单击**文件/文件夹只选中（高亮，不打开）；**双击**文件夹展开/折叠，**双击**文件在中间的文件内容面板新标签中打开；目录面板保持最右侧可见。本地文件标签不显示图标，并且可在内容面板中编辑保存。
+4. **单击**文件夹立即展开/折叠；**单击**文件在中间内容面板打开；单击另一个文件会替换未固定的预览标签。**双击**文件固定标签，之后单击其他文件不会覆盖；双击文件夹保持展开。目录面板保持最右侧可见。本地文件标签不显示图标，并且可在内容面板中编辑保存。
 5. 工具栏「切换文件树」：所有文件 / 已更改的文件 / 所有更改；远端仓库（如 nsl-wp）应列出 `git status` 修改与未跟踪文件，本地非 git 目录提示「该目录不是 Git 仓库」。
 6. 工具栏「在文件中搜索」：输入 `paradis` → 结果按「远程目录/本地目录」分组，点击结果打开文件；清空/关闭后回到原树。
 7. 工具栏「打开选项菜单」：编辑器 / 系统默认应用（远端文件下载到临时目录并用本机默认应用打开）/ 复制路径（剪贴板得到远端绝对路径）。
 8. 刷新按钮：目录、git 状态与搜索重新加载。
-9. **多标签**：依次点开两个远端文件 → 出现两个独立文件标签，目录标签仍在；重复点同一文件聚焦原标签；关闭一个标签后其槽位可复用（最多 12 个）。
-10. **传输按钮**：在树中选中远端文件/文件夹（行高亮），点工具栏传输按钮 → `.remote/` 出现对应文件；右键「队列」可看到排队/传输中/完成状态。
-11. **显示隐藏文件**：打开目录时默认显示 `.git`、`.gitignore`、`.local`/`.remote` 等隐藏项；点眼睛按钮可隐藏，再点恢复。目录面板默认开启。
-12. **右键菜单**：文件/文件夹/根节点右击 → 传输、下载到默认文件夹、队列、打开、用记事本编辑、复制、粘贴、复制路径、重命名、删除、更改权限、新建（文件夹/文件）、属性；在远端与本地两侧各验证一次重命名/删除/新建/属性。
-14. **运行中图标**：在该联动工作区的会话里发起一轮对话，运行期间左侧工作区的链环图标应变蓝；结束后（约 5 秒内）恢复原色。
-15. **本地技能**：在联动工作区会话里让模型列出本地技能（或调用 `linked_skills` list/read）；应能读到本机 `~/.dsh/skills` / `<local>/.dsh/skills` 下的 SKILL.md，且无需在远端安装；`skills.list` API 返回非空。
-16. 编辑器：内部内容面板不显示路径/保存头部（Ctrl+S 保存）；修改未保存时文件标签名前出现灰色圆点；行号、语法高亮（字符串/注释/关键字有颜色）、主题配色、
+9. **多标签/固定**：单击文件 A → 预览标签；单击文件 B → A 被替换为 B；双击 B → B 固定；再单击文件 C → B 保留且新增 C 标签。重复点击已打开文件聚焦原标签；关闭一个标签后其槽位可复用（最多 12 个）。
+10. **关闭未保存文件**：修改文件但不保存（关闭自动保存时），点标签上的 × → 出现「保存 / 放弃 / 取消」；点取消留在编辑器，点放弃关闭，点保存先写盘再关闭。
+11. **快捷键**：`Ctrl+S` 保存；`Ctrl+W` 关闭当前标签（未保存时弹窗）；`Ctrl+Tab` / `Shift+Ctrl+Tab` 切换标签；`Ctrl+B` 显示/隐藏目录面板；`Ctrl+Shift+F` 打开文件搜索。
+12. **终端按钮**：远程树工具栏的终端按钮打开外部终端并自动 `cd` 到当前远程根目录；联动工作区的本地按钮打开本地终端并 `cd` 到本地目录。远程终端需使用系统 `ssh`，首次可能要求确认主机指纹/输入密码。
+13. **自动保存**：设置 → 连接 →「编辑器行为」开启自动保存 → 修改文件后停止输入约 1 秒应自动写盘、灰点消失；关闭自动保存后再修改，不应自动写盘，`Ctrl+S` 才保存。设置重载后开关状态保持。
+14. **传输按钮**：在树中选中远端文件/文件夹（行高亮），点工具栏传输按钮 → `.remote/` 出现对应文件；右键「队列」可看到排队/传输中/完成状态。
+15. **显示隐藏文件**：打开目录时默认显示 `.git`、`.gitignore`、`.local`/`.remote` 等隐藏项；点眼睛按钮可隐藏，再点恢复。目录面板默认开启。
+16. **右键菜单**：文件/文件夹/根节点右击 → 传输、下载到默认文件夹、队列、打开、用记事本编辑、复制、粘贴、复制路径、重命名、删除、更改权限、新建（文件夹/文件）、属性；在远端与本地两侧各验证一次重命名/删除/新建/属性。
+17. **运行中图标**：在该联动工作区的会话里发起一轮对话，运行期间左侧工作区的链环图标应变蓝；结束后（约 5 秒内）恢复原色。
+18. **本地技能**：在联动工作区会话里让模型列出本地技能（或调用 `linked_skills` list/read）；应能读到本机 `~/.dsh/skills` / `<local>/.dsh/skills` 下的 SKILL.md，且无需在远端安装；`skills.list` API 返回非空。
+19. 编辑器：内部内容面板不显示路径/保存头部（Ctrl+S 保存）；修改未保存时文件标签名前出现灰色圆点；行号、语法高亮（字符串/注释/关键字有颜色）、主题配色、
    远端并发修改 → 冲突提示（重新加载/强制保存）、二进制/大文件只读；底部状态栏完整可见（不再被视口裁切）。
 
 ## 联动会话（模型工具）

package/lib/client.js

@@ -2148,6 +2148,26 @@ function fileIconSpec(name, isDir) {
       openWithSystem: '系统默认应用',
       openWithCopy: '复制路径',
       openModeSaved: '打开方式已保存',
+      autoSaveTitle: '自动保存',
+      autoSaveHint: '编辑停顿约 1 秒后自动保存；关闭后请按 Ctrl+S 手动保存。',
+      autoSaveLabel: '开启自动保存',
+      autoSaveSaved: '自动保存设置已保存',
+      shortcutTitle: '常用快捷键',
+      shortcutHint: '与 VS Code 类似的默认快捷键；macOS 上把 Ctrl 换成 ⌘。',
+      shortcutSave: '保存当前文件',
+      shortcutClose: '关闭当前文件',
+      shortcutSwitch: '切换文件标签',
+      shortcutDirectory: '显示/隐藏目录面板',
+      shortcutSearch: '在文件中搜索',
+      terminalRemote: '打开远程终端',
+      terminalLocal: '打开本地终端',
+      terminalOpened: '已打开终端',
+      terminalOpenFailed: '打开终端失败',
+      dirtyCloseTitle: '文件尚未保存',
+      dirtyCloseMessage: '「{{name}}」有未保存的修改。关闭前要保存吗？',
+      dirtyCloseSave: '保存并关闭',
+      dirtyCloseDiscard: '不保存关闭',
+      saveFailed: '保存失败，文件未关闭',
       noChanges: '没有检测到更改',
       notGitRepo: '该目录不是 Git 仓库',
       changesRemote: '远端更改',
@@ -2438,6 +2458,26 @@ function fileIconSpec(name, isDir) {
       openWithSystem: 'System default app',
       openWithCopy: 'Copy path',
       openModeSaved: 'Open mode saved',
+      autoSaveTitle: 'Auto save',
+      autoSaveHint: 'Saves about one second after you stop typing. When off, press Ctrl+S to save.',
+      autoSaveLabel: 'Enable auto save',
+      autoSaveSaved: 'Auto-save setting saved',
+      shortcutTitle: 'Keyboard shortcuts',
+      shortcutHint: 'VS Code-like defaults; use ⌘ instead of Ctrl on macOS.',
+      shortcutSave: 'Save the current file',
+      shortcutClose: 'Close the current file',
+      shortcutSwitch: 'Switch file tabs',
+      shortcutDirectory: 'Show/hide the directory pane',
+      shortcutSearch: 'Search in files',
+      terminalRemote: 'Open remote terminal',
+      terminalLocal: 'Open local terminal',
+      terminalOpened: 'Terminal opened',
+      terminalOpenFailed: 'Could not open terminal',
+      dirtyCloseTitle: 'Unsaved changes',
+      dirtyCloseMessage: '“{{name}}” has unsaved changes. Save before closing?',
+      dirtyCloseSave: 'Save and close',
+      dirtyCloseDiscard: 'Close without saving',
+      saveFailed: 'Save failed; the file was left open',
       noChanges: 'No changes detected',
       notGitRepo: 'Not a Git repository',
       changesRemote: 'Remote changes',
@@ -2718,7 +2758,7 @@ function fileIconSpec(name, isDir) {
     };
 
     var runtimeSettings = {
-      value: { editorTheme: DEFAULT_THEME_ID, editorThemeFamily: DEFAULT_THEME_FAMILY, editorThemeMode: 'system', appThemeDark: false, fileOpenMode: 'editor' },
+      value: { editorTheme: DEFAULT_THEME_ID, editorThemeFamily: DEFAULT_THEME_FAMILY, editorThemeMode: 'system', appThemeDark: false, fileOpenMode: 'editor', autoSave: false },
       loaded: false,
       loading: null,
       listeners: new Set(),
@@ -2741,7 +2781,7 @@ function fileIconSpec(name, isDir) {
           runtimeSettings.loading = null;
           var openMode = settings && (settings.fileOpenMode === 'system' || settings.fileOpenMode === 'copy') ? settings.fileOpenMode : 'editor';
           var mode = settings && (settings.editorThemeMode === 'light' || settings.editorThemeMode === 'dark') ? settings.editorThemeMode : 'system';
-          runtimeSettings.apply({ editorTheme: settings && settings.editorTheme ? settings.editorTheme : DEFAULT_THEME_ID, editorThemeFamily: themeFamilyFor(settings), editorThemeMode: mode, fileOpenMode: openMode });
+          runtimeSettings.apply({ editorTheme: settings && settings.editorTheme ? settings.editorTheme : DEFAULT_THEME_ID, editorThemeFamily: themeFamilyFor(settings), editorThemeMode: mode, fileOpenMode: openMode, autoSave: Boolean(settings && settings.autoSave) });
           return runtimeSettings.value;
         }).catch(function () {
           runtimeSettings.loaded = true;
@@ -2764,6 +2804,13 @@ function fileIconSpec(name, isDir) {
           return runtimeSettings.value;
         });
       },
+      saveAutoSave: function (enabled) {
+        return apiCall('settings.update', { autoSave: Boolean(enabled) }).then(function (settings) {
+          runtimeSettings.loaded = true;
+          runtimeSettings.apply({ autoSave: Boolean(settings && settings.autoSave) });
+          return runtimeSettings.value;
+        });
+      },
     };
 
     function themeFamilyFor(settings) {
@@ -2968,6 +3015,10 @@ function fileIconSpec(name, isDir) {
       '.rw-option-title{display:flex;align-items:center;gap:8px;font-size:13px;line-height:20px;font-weight:600}',
       '.rw-option-desc{font-size:11.5px;line-height:17px;color:var(--dsw-alias-label-tertiary)}',
       '.rw-warn-box{padding:8px 10px;border-radius:8px;border:1px solid color-mix(in srgb,var(--dsw-alias-state-warn-primary) 45%,transparent);background:color-mix(in srgb,var(--dsw-alias-state-warn-primary) 8%,var(--dsw-alias-bg-layer-1));font-size:12px;line-height:18px}',
+      '.rw-setting-row{display:flex;align-items:center;gap:10px;padding:10px 12px;border:1px solid var(--dsw-alias-border-l1);border-radius:9px;background:var(--dsw-alias-bg-layer-1)}',
+      '.rw-shortcut-grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(220px,1fr));gap:4px 16px}',
+      '.rw-shortcut-row{display:flex;align-items:center;gap:10px;min-height:28px;font-size:12px;color:var(--dsw-alias-label-secondary)}',
+      '.rw-kbd{display:inline-flex;align-items:center;justify-content:center;min-width:64px;padding:2px 7px;border:1px solid var(--dsw-alias-border-l2);border-bottom-width:2px;border-radius:5px;background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary);font:11px/16px ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;white-space:nowrap}',
       '@media (max-width:720px){.rw-theme-grid{grid-template-columns:repeat(auto-fill,minmax(132px,1fr))}.rw-pair{grid-template-columns:minmax(0,1fr)}}',
       '.rw-linked-toolbar{display:flex;align-items:center;gap:6px;padding:6px 8px;border-bottom:1px solid var(--dsw-alias-border-l1);min-width:0;position:relative;z-index:5}',
       '.rw-menu-wrap{position:relative}',
@@ -3184,6 +3235,12 @@ function fileIconSpec(name, isDir) {
         h('circle', { key: 'd', cx: 4.6, cy: 11.3, r: 0.8, fill: 'currentColor' }),
       ]);
     }
+    function IconTerminal(size) {
+      return svg(size || 14, [
+        h('rect', { key: 'a', x: 1.8, y: 2.4, width: 12.4, height: 11.2, rx: 1.8, stroke: 'currentColor', strokeWidth: 1.25 }),
+        h('path', { key: 'b', d: 'm4.4 6 2.1 2-2.1 2M8.2 10h3.3', stroke: 'currentColor', strokeWidth: 1.3, strokeLinecap: 'round', strokeLinejoin: 'round' }),
+      ]);
+    }
     function IconEye(size) {
       return svg(size || 14, [
         h('path', { key: 'a', d: 'M1.6 8s2.4-4.1 6.4-4.1S14.4 8 14.4 8 12 12.1 8 12.1 1.6 8 1.6 8Z', stroke: 'currentColor', strokeWidth: 1.25, strokeLinejoin: 'round' }),
@@ -3750,11 +3807,11 @@ function fileIconSpec(name, isDir) {
       }, [dirty, baseTitle]);
 
       function saveFile(force) {
-        if (readOnly || !load.file || load.file.binary || load.file.tooLarge || save.saving) return;
+        if (readOnly || !load.file || load.file.binary || load.file.tooLarge || save.saving) return Promise.resolve(false);
         setSave({ saving: true, conflict: false, error: '', ok: false });
         var payload = local ? { path: filePath, content: content } : Object.assign({ path: filePath, content: content }, params);
         if (!force && load.file && typeof load.file.mtime === 'number') payload.expectedMtime = load.file.mtime;
-        apiCall(local ? 'local.write' : 'fs.write', payload).then(function (result) {
+        return apiCall(local ? 'local.write' : 'fs.write', payload).then(function (result) {
           setLoad(function (previous) {
             if (!previous.file) return previous;
             return { loading: false, error: null, file: Object.assign({}, previous.file, { mtime: result.mtime, size: result.size }) };
@@ -3764,15 +3821,33 @@ function fileIconSpec(name, isDir) {
           setTimeout(function () {
             setSave(function (previous) { return previous.ok ? { saving: false, conflict: false, error: '', ok: false } : previous; });
           }, 2200);
+          return true;
         }).catch(function (error) {
           if (error && error.code === 'CONFLICT') {
             setSave({ saving: false, conflict: true, error: '', ok: false });
           } else {
             setSave({ saving: false, conflict: false, error: messageOf(error, t, locale), ok: false });
           }
+          return false;
         });
       }
 
+      var saveRef = useRef(null);
+      saveRef.current = saveFile;
+      useEffect(function () {
+        var notify = props.onSaveReady;
+        if (typeof notify === 'function') notify(function () { return saveRef.current(false); });
+        return function () {
+          if (typeof notify === 'function') notify(null);
+        };
+      }, [filePath, local]);
+
+      useEffect(function () {
+        if (!settings.autoSave || !dirty || !editable || save.saving || save.conflict) return undefined;
+        var timer = setTimeout(function () { saveRef.current(false); }, 900);
+        return function () { clearTimeout(timer); };
+      }, [content, dirty, settings.autoSave, editable, save.saving, save.conflict]);
+
       useEffect(function () {
         if (props.visible === false) return undefined;
         function onKey(event) {
@@ -4056,6 +4131,7 @@ function fileIconSpec(name, isDir) {
         state: { entries: cache.entries },
         load: load,
         onSelect: props.onSelect,
+        onPin: props.onPin,
         onSelectPath: props.onSelectPath,
         onContextMenu: props.onContextMenu,
         selectedPath: props.selectedPath || '',
@@ -4142,6 +4218,20 @@ function fileIconSpec(name, isDir) {
                     });
                   })))
               : null),
+          h('button', {
+            type: 'button',
+            className: 'rw-icon-btn',
+            title: t('terminalRemote'),
+            onClick: function () { props.onOpenTerminal('remote'); },
+          }, IconTerminal(14)),
+          props.localEnabled
+            ? h('button', {
+              type: 'button',
+              className: 'rw-icon-btn',
+              title: t('terminalLocal'),
+              onClick: function () { props.onOpenTerminal('local'); },
+            }, IconTerminal(14))
+            : null,
           h('button', {
             type: 'button',
             className: 'rw-icon-btn' + (props.directoryOpen ? ' is-on' : ''),
@@ -4388,6 +4478,9 @@ function fileIconSpec(name, isDir) {
         h('div', { className: 'rw-dialog-message' }, props.message),
         h('div', { className: 'rw-dialog-actions' },
           h('button', { type: 'button', className: 'rw-btn rw-btn-sm', onClick: props.onClose }, props.t('cancel')),
+          props.secondaryLabel
+            ? h('button', { type: 'button', className: 'rw-btn rw-btn-sm rw-btn-primary', onClick: props.onSecondary }, props.secondaryLabel)
+            : null,
           h('button', { type: 'button', className: 'rw-btn rw-btn-sm rw-btn-danger', onClick: props.onConfirm }, props.confirmLabel)));
     }
 
@@ -4426,6 +4519,7 @@ function fileIconSpec(name, isDir) {
       var path = props.path;
       var local = props.local === true;
       var onSaved = props.onSaved;
+      var settings = useRuntimeSettings();
       var kind = documentKindOf(path);
       var stateRef = useState({
         loading: true, error: '', data: null, text: '', dirty: false, saving: false,
@@ -4465,7 +4559,7 @@ function fileIconSpec(name, isDir) {
       }, [state.dirty]);
 
       function save() {
-        if (state.saving) return;
+        if (state.saving) return Promise.resolve(false);
         patch({ saving: true, error: '', notice: '' });
         var data = {};
         if (kind === 'markdown') data = { text: state.text };
@@ -4479,15 +4573,49 @@ function fileIconSpec(name, isDir) {
             deleted: Object.keys(state.deleted).filter(function (index) { return state.deleted[index]; }).map(Number),
           };
         }
-        apiCall('docs.write', params({ data: data, expectedMtime: state.data ? state.data.mtime : undefined })).then(function () {
-          patch({ saving: false, dirty: false, notice: t('saved') });
+        return apiCall('docs.write', params({ data: data, expectedMtime: state.data ? state.data.mtime : undefined })).then(function (result) {
+          patch({
+            saving: false,
+            dirty: false,
+            notice: t('saved'),
+            data: state.data ? Object.assign({}, state.data, { mtime: result.mtime, size: result.size }) : state.data,
+          });
           if (onSaved) onSaved();
-          load();
+          return true;
         }).catch(function (error) {
           patch({ saving: false, error: messageOf(error, t, locale) });
+          return false;
         });
       }
 
+      var saveRef = useRef(null);
+      saveRef.current = save;
+      useEffect(function () {
+        var notify = props.onSaveReady;
+        if (typeof notify === 'function') notify(function () { return saveRef.current(); });
+        return function () {
+          if (typeof notify === 'function') notify(null);
+        };
+      }, [path, local]);
+
+      useEffect(function () {
+        if (props.visible === false) return undefined;
+        function onKey(event) {
+          var mod = event.ctrlKey || event.metaKey;
+          if (!mod || String(event.key || '').toLowerCase() !== 's') return;
+          event.preventDefault();
+          saveRef.current();
+        }
+        window.addEventListener('keydown', onKey, true);
+        return function () { window.removeEventListener('keydown', onKey, true); };
+      }, [props.visible]);
+
+      useEffect(function () {
+        if (!settings.autoSave || !state.dirty || state.saving) return undefined;
+        var timer = setTimeout(function () { saveRef.current(); }, 900);
+        return function () { clearTimeout(timer); };
+      }, [settings.autoSave, state.dirty, state.saving, state.text, state.data, state.updates, state.pptxUpdates, state.rotations, state.deleted]);
+
       function showPreview() {
         var next = !state.preview;
         patch({ preview: next, previewLoading: next && !state.html });
@@ -4835,6 +4963,7 @@ function fileIconSpec(name, isDir) {
       var fileDirtyState = useState({});
       var fileDirty = fileDirtyState[0];
       var setFileDirty = fileDirtyState[1];
+      var saveHandlersRef = useRef({});
       var directoryTabId = props.tab && props.tab.id;
 
       useEffect(function () {
@@ -4917,7 +5046,25 @@ function fileIconSpec(name, isDir) {
         });
       }
 
-      function openByMode(side, filePath) {
+      function openTerminal(side) {
+        if (!selected) return;
+        var request = { side: side };
+        if (selected.kind === 'linked') request.linkedId = selected.id;
+        else request.workspaceId = selected.id;
+        apiCall('terminal.open', request).then(function () {
+          showNotice('success', t('terminalOpened'));
+        }).catch(function (error) {
+          showNotice('error', t('terminalOpenFailed') + '：' + messageOf(error, t, locale));
+        });
+      }
+
+      function pinByMode(side, filePath) {
+        var mode = settings.fileOpenMode || 'editor';
+        if (mode !== 'editor') return;
+        openByMode(side, filePath, { pinned: true, preview: false });
+      }
+
+      function openByMode(side, filePath, options) {
         if (!selected || !filePath) return;
         var openMode = settings.fileOpenMode || 'editor';
         if (openMode === 'copy') {
@@ -4936,14 +5083,34 @@ function fileIconSpec(name, isDir) {
           });
           return;
         }
-        openInternalFile(side, filePath);
+        openInternalFile(side, filePath, options || { pinned: true });
       }
 
-      function openInternalFile(side, filePath) {
+      function openInternalFile(side, filePath, options) {
+        var opts = options || { pinned: true };
         var key = side + ':' + (side === 'remote' ? scopeKeyOf(scopeRef) : 'local') + ':' + filePath;
         setOpenFiles(function (previous) {
-          if (previous.some(function (file) { return file.key === key; })) return previous;
-          return previous.concat([{ key: key, side: side, path: filePath, name: basename(filePath) }]);
+          var existing = previous.filter(function (file) { return file.key === key; })[0];
+          if (existing) {
+            if (opts.pinned && !existing.pinned) {
+              return previous.map(function (file) { return file.key === key ? Object.assign({}, file, { pinned: true }) : file; });
+            }
+            return previous;
+          }
+          if (opts.preview === true) {
+            var activeIndex = -1;
+            previous.forEach(function (file, index) { if (file.key === activeFileKey) activeIndex = index; });
+            if (activeIndex >= 0) {
+              var active = previous[activeIndex];
+              if (!active.pinned && !fileDirty[active.key]) {
+                var replaced = previous.slice();
+                replaced[activeIndex] = { key: key, side: side, path: filePath, name: basename(filePath), pinned: false };
+                setFileDirty(function (dirtyMap) { var copy = Object.assign({}, dirtyMap); delete copy[active.key]; return copy; });
+                return replaced;
+              }
+            }
+          }
+          return previous.concat([{ key: key, side: side, path: filePath, name: basename(filePath), pinned: Boolean(opts.pinned) }]);
         });
         setActiveFileKey(key);
         setDirectoryOpen(true);
@@ -4953,11 +5120,67 @@ function fileIconSpec(name, isDir) {
         setOpenFiles(function (previous) {
           var next = previous.filter(function (file) { return file.key !== key; });
           setFileDirty(function (dirtyMap) { var copy = Object.assign({}, dirtyMap); delete copy[key]; return copy; });
+          delete saveHandlersRef.current[key];
           if (activeFileKey === key) setActiveFileKey(next.length > 0 ? next[next.length - 1].key : '');
           return next;
         });
       }
 
+      function requestCloseInternalFile(key) {
+        if (!fileDirty[key]) { closeInternalFile(key); return; }
+        var file = openFiles.filter(function (entry) { return entry.key === key; })[0];
+        setDialog({ kind: 'closeDirty', key: key, name: file ? file.name : '' });
+      }
+
+      function saveAndCloseInternalFile(key) {
+        var handler = saveHandlersRef.current[key];
+        setDialog(null);
+        if (!handler) { closeInternalFile(key); return; }
+        handler().then(function (ok) {
+          if (ok) closeInternalFile(key);
+          else showNotice('error', t('saveFailed'));
+        });
+      }
+
+      useEffect(function () {
+        function onKey(event) {
+          var mod = event.ctrlKey || event.metaKey;
+          if (!mod) return;
+          var key = String(event.key || '').toLowerCase();
+          if (key === 'w') {
+            if (!activeFileKey) return;
+            event.preventDefault();
+            event.stopPropagation();
+            requestCloseInternalFile(activeFileKey);
+            return;
+          }
+          if (key === 'tab') {
+            if (openFiles.length < 2) return;
+            event.preventDefault();
+            event.stopPropagation();
+            var index = -1;
+            openFiles.forEach(function (file, i) { if (file.key === activeFileKey) index = i; });
+            var step = event.shiftKey ? -1 : 1;
+            var nextIndex = (index + step + openFiles.length) % openFiles.length;
+            setActiveFileKey(openFiles[nextIndex].key);
+            return;
+          }
+          if (key === 'b') {
+            event.preventDefault();
+            event.stopPropagation();
+            setDirectoryOpen(function (open) { return !open; });
+            return;
+          }
+          if (key === 'f' && event.shiftKey) {
+            event.preventDefault();
+            event.stopPropagation();
+            setSearchOpen(true);
+          }
+        }
+        window.addEventListener('keydown', onKey, true);
+        return function () { window.removeEventListener('keydown', onKey, true); };
+      }, [activeFileKey, openFiles, directoryOpen]);
+
       function closeContextMenu() { setCtxMenu(null); }
 
       function openContextMenu(side, info) {
@@ -5227,6 +5450,18 @@ function fileIconSpec(name, isDir) {
             onConfirm: function () { setDialog(null); confirmDelete(dialog); },
           });
         }
+        if (dialog.kind === 'closeDirty') {
+          return h(ConfirmDialog, {
+            t: t,
+            title: t('dirtyCloseTitle'),
+            message: t('dirtyCloseMessage', { name: dialog.name }),
+            secondaryLabel: t('dirtyCloseSave'),
+            confirmLabel: t('dirtyCloseDiscard'),
+            onClose: function () { setDialog(null); },
+            onSecondary: function () { saveAndCloseInternalFile(dialog.key); },
+            onConfirm: function () { setDialog(null); closeInternalFile(dialog.key); },
+          });
+        }
         return h(PromptDialog, {
           t: t,
           title: dialog.title,
@@ -5340,7 +5575,8 @@ function fileIconSpec(name, isDir) {
             showHidden: showHidden,
             selectedPath: selectedEntry && selectedEntry.side === 'remote' ? selectedEntry.path : '',
             onSelectPath: function (info) { setSelectedEntry(Object.assign({ side: 'remote' }, info)); },
-            onSelect: function (filePath) { openByMode('remote', filePath); },
+            onSelect: function (filePath) { openByMode('remote', filePath, { pinned: false, preview: true }); },
+            onPin: function (filePath) { pinByMode('remote', filePath); },
             onContextMenu: function (info) { setSelectedEntry(Object.assign({ side: 'remote' }, info)); openContextMenu('remote', info); },
           })),
           selected.kind === 'linked'
@@ -5360,7 +5596,8 @@ function fileIconSpec(name, isDir) {
               showHidden: showHidden,
               selectedPath: selectedEntry && selectedEntry.side === 'local' ? selectedEntry.path : '',
               onSelectPath: function (info) { setSelectedEntry(Object.assign({ side: 'local' }, info)); },
-              onSelect: function (filePath) { openByMode('local', filePath); },
+              onSelect: function (filePath) { openByMode('local', filePath, { pinned: false, preview: true }); },
+              onPin: function (filePath) { pinByMode('local', filePath); },
               refreshTick: localTick,
               onContextMenu: function (info) { setSelectedEntry(Object.assign({ side: 'local' }, info)); openContextMenu('local', info); },
             }))
@@ -5377,6 +5614,10 @@ function fileIconSpec(name, isDir) {
             path: activeFile.path,
             local: activeFile.side === 'local',
             onSaved: refreshTree,
+            onSaveReady: function (handler) {
+              if (handler) saveHandlersRef.current[activeFile.key] = handler;
+              else delete saveHandlersRef.current[activeFile.key];
+            },
             onDirtyChange: function (dirty) {
               setFileDirty(function (previous) {
                 if (Boolean(previous[activeFile.key]) === Boolean(dirty)) return previous;
@@ -5393,6 +5634,10 @@ function fileIconSpec(name, isDir) {
           local: activeFile.side === 'local',
           readOnly: remoteOnly,
           hideHeader: true,
+          onSaveReady: function (handler) {
+            if (handler) saveHandlersRef.current[activeFile.key] = handler;
+            else delete saveHandlersRef.current[activeFile.key];
+          },
           onDirtyChange: function (dirty) {
             setFileDirty(function (previous) {
               if (Boolean(previous[activeFile.key]) === Boolean(dirty)) return previous;
@@ -5416,6 +5661,8 @@ function fileIconSpec(name, isDir) {
           openMode: settings.fileOpenMode || 'editor',
           directoryOpen: directoryOpen,
           onToggleDirectory: function () { setDirectoryOpen(!directoryOpen); },
+          onOpenTerminal: openTerminal,
+          localEnabled: !remoteOnly && selected.kind === 'linked',
           showHidden: showHidden,
           onToggleHidden: function () { setShowHidden(!showHidden); },
           transferEnabled: !remoteOnly && Boolean(selectedEntry),
@@ -5474,7 +5721,7 @@ function fileIconSpec(name, isDir) {
                     h('span', { className: 'rw-file-tab-name' }, file.name),
                     h('button', {
                       type: 'button', className: 'rw-file-tab-close', title: t('closeFile'),
-                      onClick: function (event) { event.stopPropagation(); closeInternalFile(file.key); },
+                      onClick: function (event) { event.stopPropagation(); requestCloseInternalFile(file.key); },
                     }, IconClose(10)));
                 }))
               : null,
@@ -5535,6 +5782,7 @@ function fileIconSpec(name, isDir) {
       var toggle = props.toggle;
       var state = props.state;
       var onSelect = props.onSelect;
+      var onPin = props.onPin;
       var onSelectPath = props.onSelectPath;
       var onContextMenu = props.onContextMenu;
       var selectedPath = props.selectedPath;
@@ -5572,6 +5820,7 @@ function fileIconSpec(name, isDir) {
                 state: state,
                 load: props.load,
                 onSelect: onSelect,
+                onPin: onPin,
                 onSelectPath: onSelectPath,
                 onContextMenu: onContextMenu,
                 selectedPath: selectedPath,
@@ -5584,10 +5833,11 @@ function fileIconSpec(name, isDir) {
                 className: 'rw-row' + (active ? ' is-active' : ''),
                 style: { paddingLeft: 6 + (depth + 1) * 12 },
                 title: child.path,
-                onClick: function () {
+                onClick: function (event) {
                   if (onSelectPath) onSelectPath({ path: child.path, name: child.name, isDir: false });
+                  if (event.detail !== 2) onSelect(child.path);
                 },
-                onDoubleClick: function () { onSelect(child.path); },
+                onDoubleClick: function () { if (onPin) onPin(child.path); },
                 onContextMenu: function (event) {
                   if (!onContextMenu) return;
                   event.preventDefault();
@@ -5610,10 +5860,10 @@ function fileIconSpec(name, isDir) {
           className: 'rw-row' + (selectedPath === path ? ' is-active' : ''),
           style: { paddingLeft: 6 + depth * 12 },
           title: path,
-          onClick: function () {
+          onClick: function (event) {
             if (onSelectPath) onSelectPath({ path: path, name: name, isDir: true });
+            if (event.detail !== 2) toggle(path);
           },
-          onDoubleClick: function () { toggle(path); },
           onContextMenu: function (event) {
             if (!onContextMenu) return;
             event.preventDefault();
@@ -6408,6 +6658,61 @@ function fileIconSpec(name, isDir) {
           : null);
     }
 
+    function EditorSettingsGroup(props) {
+      var t = props.t;
+      var locale = props.locale;
+      var settings = useRuntimeSettings();
+      var state = useState({ saving: false, message: null });
+      var local = state[0];
+      var setLocal = state[1];
+      var shortcuts = [
+        ['Ctrl+S', t('shortcutSave')],
+        ['Ctrl+W', t('shortcutClose')],
+        ['Ctrl+Tab', t('shortcutSwitch')],
+        ['Ctrl+B', t('shortcutDirectory')],
+        ['Ctrl+Shift+F', t('shortcutSearch')],
+      ];
+
+      function toggleAutoSave(next) {
+        if (local.saving) return;
+        setLocal({ saving: true, message: null });
+        runtimeSettings.saveAutoSave(next).then(function () {
+          setLocal({ saving: false, message: { kind: 'success', text: t('autoSaveSaved') } });
+          bus.emit();
+        }).catch(function (error) {
+          setLocal({ saving: false, message: { kind: 'error', text: messageOf(error, t, locale) } });
+        });
+      }
+
+      return h('div', { className: 'rw-group' },
+        h('div', { className: 'rw-group-head' },
+          h('span', { className: 'rw-group-title' }, t('autoSaveTitle')),
+          h('span', { className: 'rw-group-hint' }, t('autoSaveHint'))),
+        h('div', { className: 'rw-setting-row' },
+          h(Switch, {
+            checked: Boolean(settings.autoSave),
+            onChange: toggleAutoSave,
+            label: t('autoSaveLabel'),
+            text: t('autoSaveLabel'),
+          }),
+          local.saving ? Spinner(12) : null),
+        h('div', { className: 'rw-group-head', style: { marginTop: 14 } },
+          h('span', { className: 'rw-group-title' }, t('shortcutTitle')),
+          h('span', { className: 'rw-group-hint' }, t('shortcutHint'))),
+        h('div', { className: 'rw-shortcut-grid' },
+          shortcuts.map(function (item) {
+            return h('div', { key: item[0], className: 'rw-shortcut-row' },
+              h('kbd', { className: 'rw-kbd' }, item[0]),
+              h('span', null, item[1]));
+          })),
+        local.message
+          ? h(Banner, {
+            kind: local.message.kind === 'success' ? 'success' : 'error',
+            onClose: function () { setLocal({ saving: false, message: null }); },
+          }, local.message.text)
+          : null);
+    }
+
     function ConnectionsPage(props) {
       var ctx = props.ctx;
       var locale = useLocale(ctx);
@@ -6449,6 +6754,7 @@ function fileIconSpec(name, isDir) {
             }, adding === 'remote' ? IconClose(13) : IconServer(13), t('addRemoteDir')))),
         !sidebarAvailable ? h(Banner, { kind: 'warn' }, t('needsSidebar')) : null,
         h(ThemeGroup, { t: t, locale: locale }),
+        h(EditorSettingsGroup, { t: t, locale: locale }),
         adding !== ''
           ? h(AddWorkspaceFlow, {
             ctx: ctx, t: t, locale: locale, initialMode: adding, lockedMode: adding,

package/lib/index.js

@@ -34,7 +34,7 @@ export const inject = ['webServer', 'tools', 'systemPrompt', 'workingDirectory']
 
 const DATA_VERSION = 1
 const SETTINGS_VERSION = 1
-const SETTINGS_DEFAULTS = Object.freeze({ editorTheme: 'github-light', editorThemeFamily: 'github', editorThemeMode: 'system', fileOpenMode: 'editor' })
+const SETTINGS_DEFAULTS = Object.freeze({ editorTheme: 'github-light', editorThemeFamily: 'github', editorThemeMode: 'system', fileOpenMode: 'editor', autoSave: false })
 const EDITOR_THEME_FAMILIES = new Set(['github', 'solarized', 'one', 'dracula', 'monokai', 'nord', 'vscode', 'xcode', 'catppuccin'])
 const THEME_FAMILY_OF = (id) => {
   const value = String(id || '')
@@ -183,6 +183,85 @@ function openWithSystem(targetPath) {
   }
 }
 
+/** Spawn a detached console process and report whether the executable started. */
+function launchDetached(command, args, extra = {}) {
+  return new Promise((resolveLaunch) => {
+    let child
+    try {
+      child = spawn(command, args, { detached: true, stdio: 'ignore', ...extra })
+    } catch {
+      resolveLaunch(false)
+      return
+    }
+    let settled = false
+    child.once('error', () => {
+      if (settled) return
+      settled = true
+      resolveLaunch(false)
+    })
+    child.once('spawn', () => {
+      if (settled) return
+      settled = true
+      try { child.unref() } catch { /* already detached */ }
+      resolveLaunch(true)
+    })
+  })
+}
+
+function quotePosix(text) {
+  return `'${String(text).replace(/'/g, `'\\''`)}'`
+}
+
+function quotePowerShell(text) {
+  return `'${String(text).replace(/'/g, "''")}'`
+}
+
+function quoteAppleScript(text) {
+  return `"${String(text).replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`
+}
+
+function remoteTerminalCommand(remotePath) {
+  return `cd ${quotePosix(remotePath)} && exec bash -l`
+}
+
+function sshTarget(host, username) {
+  return `${username || ''}@${host}`
+}
+
+/** Open a local terminal whose working directory is `dir`. */
+async function openLocalTerminal(dir) {
+  if (process.platform === 'win32') {
+    if (await launchDetached('wt.exe', ['-d', dir], { windowsHide: false })) return true
+    const script = `Set-Location -LiteralPath ${quotePowerShell(dir)}`
+    return launchDetached('powershell.exe', ['-NoLogo', '-NoExit', '-Command', script], { windowsHide: false })
+  }
+  if (process.platform === 'darwin') {
+    return launchDetached('open', ['-a', 'Terminal', dir])
+  }
+  if (await launchDetached('x-terminal-emulator', [`--working-directory=${dir}`])) return true
+  return launchDetached('gnome-terminal', [`--working-directory=${dir}`])
+}
+
+/** Open a terminal that SSHes into `host` and cd's to `remotePath`. */
+async function openRemoteTerminal(host, port, username, remotePath) {
+  const target = sshTarget(host, username)
+  const command = remoteTerminalCommand(remotePath)
+  if (!username) return false
+  if (process.platform === 'win32') {
+    const sshArgs = ['-p', String(port || 22), '-t', `${username}@${host}`, command]
+    if (await launchDetached('wt.exe', ['new-tab', '--', 'ssh.exe', ...sshArgs], { windowsHide: false })) return true
+    const script = `& ssh.exe -p ${Number(port) || 22} -t ${quotePowerShell(`${username}@${host}`)} ${quotePowerShell(command)}`
+    return launchDetached('powershell.exe', ['-NoLogo', '-NoExit', '-Command', script], { windowsHide: false })
+  }
+  if (process.platform === 'darwin') {
+    const line = `ssh -p ${Number(port) || 22} -t ${target} ${command}`
+    return launchDetached('osascript', ['-e', `tell application "Terminal" to do script ${quoteAppleScript(line)}`])
+  }
+  const sshArgs = ['-p', String(port || 22), '-t', target, command]
+  if (await launchDetached('x-terminal-emulator', ['-e', 'ssh', ...sshArgs])) return true
+  return launchDetached('gnome-terminal', ['--', 'ssh', ...sshArgs])
+}
+
 function readJsonFile(file, fallback) {
   try {
     return JSON.parse(readFileSync(file, 'utf8'))
@@ -336,6 +415,9 @@ class SettingsStore {
     if (settings && typeof settings === 'object' && FILE_OPEN_MODES.has(settings.fileOpenMode)) {
       this.value.fileOpenMode = settings.fileOpenMode
     }
+    if (settings && typeof settings === 'object' && typeof settings.autoSave === 'boolean') {
+      this.value.autoSave = settings.autoSave
+    }
     if (settings && typeof settings === 'object' && settings.themeExplicit === true) {
       this.themeExplicit = true
     }
@@ -388,6 +470,10 @@ class SettingsStore {
       if (!FILE_OPEN_MODES.has(patch.fileOpenMode)) throw new ApiError('BAD_REQUEST', '文件打开方式无效')
       this.value.fileOpenMode = patch.fileOpenMode
     }
+    if (patch && typeof patch === 'object' && patch.autoSave !== undefined) {
+      if (typeof patch.autoSave !== 'boolean') throw new ApiError('BAD_REQUEST', '自动保存设置无效')
+      this.value.autoSave = patch.autoSave
+    }
     writeJsonAtomic(this.file, { version: SETTINGS_VERSION, settings: { ...this.value, themeExplicit: this.themeExplicit === true } })
     return this.get()
   }
@@ -2279,6 +2365,35 @@ export function apply(ctx) {
       return { opened: true, localPath, size: read.data.length }
     },
 
+    async 'terminal.open'(params = {}) {
+      const side = params.side === 'local' ? 'local' : 'remote'
+      const testMode = process.env.DSH_LINKED_WORKSPACE_NO_TERMINAL === '1'
+      const scope = await requireScope(params)
+      const snapshot = scope.kind === 'linked' ? (scope.record.hostSnapshot || {}) : (scope.workspace.hostSnapshot || {})
+      if (side === 'local') {
+        if (scope.kind !== 'linked') throw new ApiError('BAD_REQUEST', '该工作区没有本地目录')
+        const target = scope.record.localPath
+        let info
+        try {
+          info = await fsStat(target)
+        } catch (error) {
+          throw mapLocalFsError(error)
+        }
+        if (!info.isDirectory()) throw new ApiError('FS_NOT_DIR', '本地目录不存在')
+        if (testMode) return { opened: true, side, path: target, test: true }
+        if (!(await openLocalTerminal(target))) throw new ApiError('INTERNAL', '无法启动本地终端')
+        return { opened: true, side, path: target }
+      }
+      const stat = await scope.remote.stat(scope.root)
+      if (stat.type !== 'dir') throw new ApiError('FS_NOT_DIR', '远程目录不存在')
+      if (!snapshot.host || !snapshot.username) throw new ApiError('AUTH_FAILED', '缺少 SSH 主机或用户名，无法打开终端')
+      if (testMode) return { opened: true, side, path: scope.root, host: snapshot.host, test: true }
+      if (!(await openRemoteTerminal(snapshot.host, snapshot.port, snapshot.username, scope.root))) {
+        throw new ApiError('INTERNAL', '无法启动远程终端（找不到可用的终端程序）')
+      }
+      return { opened: true, side, path: scope.root, host: snapshot.host }
+    },
+
     async 'session.info'(params = {}) {
       const sessionId = typeof params.sessionId === 'string' ? params.sessionId.trim() : ''
       if (sessionId === '') throw new ApiError('BAD_REQUEST', 'sessionId is required')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-linked-workspace",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "description": "Linked local ⇄ remote workspaces and SSH-backed remote directories for DeepSeek Harness: theme-aware split editor, file-type icons, and an agent tool that edits remote files directly.",
   "type": "module",
   "main": "lib/index.js",