dsh-code-ui 1.3.0 → 1.3.2

package/README.md

@@ -2,13 +2,31 @@
 
 在 DeepSeek Harness（DSH）里的 **Cursor 风格 AI 代码编辑器**插件：文件树、多标签页编辑、语法高亮、引用/翻译给 AI。
 
-它把 Cursor 那种「边看代码、边跟 AI 对话」的体验搬进 DSH：一个带活动栏、文件树、多标签页编辑器的代码工作区。**v1.2.0 起支持两种布局**：右侧停靠（code UI 固定占屏幕右侧、与聊天并排，默认）或悬浮窗口（可拖拽浮动窗口，内嵌 AI 输入框），插件卡片里可随时切换。
+它把 Cursor 那种「边看代码、边跟 AI 对话」的体验搬进 DSH：一个带活动栏、文件树、多标签页编辑器的代码工作区。**v1.2.0 起支持两种布局**：右侧停靠（code UI 固定占屏幕右侧、与聊天并排，默认布局）或悬浮窗口（可拖拽浮动窗口，内嵌 AI 输入框），插件卡片里可随时切换。
+
+## 界面一览
+
+**右侧停靠布局（默认布局）**——对话与 code UI 左右并排，边聊边看代码：
+
+![右侧停靠布局：对话与 code UI 左右并排](https://github.com/soGoodayo/dsh-code-ui/raw/main/image/%E4%B8%8A%E4%B8%8B%E6%96%87%E4%B8%8EcodeUI%20%E5%B7%A6%E5%8F%B3%E5%B8%83%E5%B1%80.png)
+
+**悬浮窗口布局**——可拖拽、可缩放的浮动编辑器窗口，内嵌 AI 输入框：
+
+![悬浮窗口布局](https://github.com/soGoodayo/dsh-code-ui/raw/main/image/%E6%82%AC%E6%B5%AE%E5%B8%83%E5%B1%80.png)
+
+**两种切换按钮（插件卡片「切换按钮」可选）**——点击在 code UI 与 dsh UI（DSH 原生界面）之间切换，与布局任意组合：
+
+| 会话头按钮 | 悬浮模式条（默认，可拖动） |
+| :---: | :---: |
+| ![会话头 ⌨ code UI 按钮](https://github.com/soGoodayo/dsh-code-ui/raw/main/image/%E4%BC%9A%E8%AF%9D%E5%A4%B4%E6%8C%89%E9%92%AE.png) | ![悬浮模式条](https://github.com/soGoodayo/dsh-code-ui/raw/main/image/%E6%82%AC%E6%B5%AE%E6%8C%89%E9%92%AE.png) |
+
+> 📍 **所有配置都在：设置 → 插件 → 插件列表 → dsh-code-ui 的配置卡片**——编辑器界面（右侧停靠 / 悬浮窗口 / 隐藏）、编辑器主题、切换按钮、启用开关、检查更新，切换即时生效并持久化保存。
 
 ## 功能
 
-- **双布局可选**：右侧停靠（默认，与聊天并排） / 悬浮窗口（可拖拽缩放），插件卡片切换、即时生效
-- **切换按钮可选**：会话头 `⌨ code UI` 按钮（默认） / 悬浮模式条，与布局任意组合
-- **界面模式可持久化**：code UI / dsh UI（隐藏编辑器回归原生界面），所有入口切换均同步记忆
+- **双布局可选**：右侧停靠（默认布局，与聊天并排） / 悬浮窗口（可拖拽缩放），插件卡片切换、即时生效
+- **切换按钮可选**：悬浮模式条（默认，可拖动） / 会话头 `⌨ code UI` 按钮，与布局任意组合
+- **界面模式可持久化**：code UI / dsh UI（**默认隐藏**，不自动占屏，入口按钮随时唤回），所有入口切换均同步记忆
 - **Cursor 风格工作区**：活动栏 + 文件树侧边栏 + 多标签页编辑器 + 状态栏
 - **侧栏收起与调宽**：« 按钮 / 📁 三态 / 拖到最窄自动收起，» 把手展开，右缘拖拽调宽
 - **停靠面板拖宽**：左缘手柄实时调整面板宽度，DSH 界面自动跟随
@@ -24,7 +42,7 @@
 - **内嵌 AI 输入框**（悬浮布局）：直接输入、`Ctrl+Enter` 发送；发送时不粘贴引用正文，只附一行引用指针，内容由 AI 调用 `get_referenced_snippets` 工具读取
 - **主题四态**：跟随 DSH（默认）/ 跟随系统 / 浅色 / 深色，插件卡片切换
 - **以此文件夹为根**：文件浏览器里可选任意目录作为工作区根
-- **检查更新 / 一键更新**：设置 → 插件 → 插件配置 中的 dsh-code-ui 卡片，支持在线检查 npm 新版本并一键更新；未发布/开发期可填本地 `.tgz` 路径安装（pnpm 流式进度展示，失败自动归类给出建议，完成后提示重启 DSH 生效）
+- **检查更新 / 一键更新**：设置 → 插件 → 插件列表 → dsh-code-ui 的配置卡片，支持在线检查 npm 新版本并一键更新；未发布/开发期可填本地 `.tgz` 路径安装（pnpm 流式进度展示，失败自动归类给出建议，完成后提示重启 DSH 生效）
 
 ## 安装
 
@@ -34,7 +52,7 @@
 dsh plugin --profile web add dsh-code-ui
 ```
 
-安装完成后重启 DSH，会话标题栏出现 `⌨ code UI` 按钮，点击即可打开右侧停靠的编辑器（默认）；也可在插件卡片改为悬浮窗口布局与悬浮模式条切换。
+安装完成后重启 DSH，编辑器**默认隐藏**（dsh UI，不自动占屏）；页面顶部出现可拖动的**悬浮模式条**（默认切换按钮），点 `code UI` 即可打开编辑器——默认布局为右侧停靠、默认根目录为**当前会话的工作区**，想换会话头 ⌨ 按钮或悬浮窗口，到 **设置 → 插件 → 插件列表 → dsh-code-ui** 的配置卡片里切换。
 
 或手动安装：
 
@@ -84,22 +102,15 @@ dsh-code-ui/
 - `lib/client.js`：改编辑器 UI 布局、配色（`styles` 模板串里的 CSS）、或新增右键菜单项
 - 引用/备注数据存模块内存（运行期有效，重启清空）
 
-## 发布
-
-```bash
-npm publish --dry-run
-npm publish
-```
-
-发布前确认 `name` 未被占用，必要时改为 scope 如 `@yourname/dsh-code-ui`。
-
 ## 更新日志
 
 > 约定：每次版本升级在本节顶部追加一行（时间 | 版本 | 修复/新增内容）。
 
 | 时间 | 版本 | 修复 / 新增 |
 | --- | --- | --- |
-| 2026-09-02 | v1.3.0 | 里程碑：文件树右键操作（真实磁盘）。右键文件：打开 / 引用给 AI（整个文件）/ 复制路径 / 在资源管理器中显示 / 重命名 / 删除；右键文件夹：新建文件 / 新建文件夹 / 以此文件夹为根 / 刷新 / 复制路径 / 定位 / 重命名 / 删除（递归强确认）；空白区右键：根目录新建 / 刷新 / 更换根；新建重命名输入弹窗（Enter 确认）、危险操作确认弹窗、工作区根禁删；重命名自动同步标签页/缓冲/watcher，删除自动清理该路径下全部标签。引用体系升级：整文件引用只传绝对路径由 AI 自行读取；停靠布局下 DSH 原生输入条发送也自动附加引用指针（挂钩 submit，两布局统一）。打开文件弹窗：输入路径回车直接认定（文件夹=设为根 / 文件=打开）。右键菜单视口边界自适应、点击菜单项后自动关闭；⟳ 刷新不再折叠整棵树 |
+| 2026-09-02 | v1.3.2 | 调整：**切换按钮默认改为悬浮模式条**（原会话头 ⌨ 按钮，已保存选择的用户不受影响）；**文件树默认根跟随当前会话的工作区目录**——打开编辑器即定位到当前对话的项目根，会话切换自动换根（有未保存文件时暂不跟随并提示，保存后点 ⟳ 即切换）；手动「以此文件夹为根」后不再自动跟随 |
+| 2026-09-02 | v1.3.1 | 调整：安装后编辑器**默认隐藏**（dsh UI，新装不自动占屏，⌨ / 模式条随时唤回），布局默认仍为右侧停靠；配置卡片「编辑器界面」三态说明与 README 措辞同步。新增：一键更新 / 本地包更新成功后按钮文案临时变为「需重启 DSH 生效」（置灰防误点）；README 增加「界面一览」（双布局与两种切换按钮截图）并明确配置入口路径（设置 → 插件 → 插件列表 → dsh-code-ui） |
+| 2026-09-02 | v1.3.0 | 新增：文件树右键操作（真实磁盘）。右键文件：打开 / 引用给 AI（整个文件）/ 复制路径 / 在资源管理器中显示 / 重命名 / 删除；右键文件夹：新建文件 / 新建文件夹 / 以此文件夹为根 / 刷新 / 复制路径 / 定位 / 重命名 / 删除（递归强确认）；空白区右键：根目录新建 / 刷新 / 更换根；新建重命名输入弹窗（Enter 确认）、危险操作确认弹窗、工作区根禁删；重命名自动同步标签页/缓冲/watcher，删除自动清理该路径下全部标签。引用体系升级：整文件引用只传绝对路径由 AI 自行读取；停靠布局下 DSH 原生输入条发送也自动附加引用指针（挂钩 submit，两布局统一）。配置卡片：「布局模式 × 界面模式」合并为三态「编辑器界面」（右侧停靠/悬浮窗口/隐藏 dsh UI，隐藏时记住布局）。打开文件弹窗：输入路径回车直接认定（文件夹=设为根 / 文件=打开）。提示条移至顶部居中、可拖拽自定位置（⠿ 把手）。右键菜单视口边界自适应、点击菜单项后自动关闭；⟳ 刷新不再折叠整棵树 |
 | 2026-09-02 | v1.2.0 | 里程碑：双布局与全面可配置。新增右侧停靠布局（code UI 固定占右侧、DSH 界面推到左侧并排，Cursor 式；左缘拖拽实时调宽，壳层帧用 [data-slot=root] 语义属性定位 + 内联 margin-right 推挤）；插件卡片新增「布局模式」（右侧停靠=默认 / 悬浮窗口）、「界面模式」（code UI / dsh UI，状态持久化、所有入口同步记忆）、「切换按钮」（会话头 ⌨ 按钮=默认 / 悬浮模式条，与布局任意组合），全部即时生效 + 持久化；文件树侧栏可收起（« / 📁 三态 / 拖窄收起）+ » 展开把手 + 右缘拖宽；侧栏标题不折行；停靠面板去投影；界面文案更名（Code UI→code UI、原始风格-ui→dsh UI）；悬浮布局也获得侧栏收起/调宽能力 |
 | 2026-09-02 | v1.2.0-beta.1 | 里程碑：右侧停靠模式（feature/native-layout 分支）--会话头「⌨ Code UI」开关按钮，Code UI 固定占右侧、DSH 界面推到左侧并排（Cursor 式布局）；左缘拖拽实时调宽；文件树侧栏可收起（« 按钮 / 📁 三态 / 拖到最窄松手收起）+ » 展开把手 + 右缘拖拽调宽；侧栏标题不折行；移除停靠面板投影。推挤采用 [data-slot=root] 语义属性 + 内联 margin-right，不依赖哈希类名 |
 | 2026-09-01 | v1.1.10 | 调整：底部状态栏不再用反色按钮样式，改用输入框同款背景（bg-overlay）+ 次要文字色 + 顶部分隔线，深浅色模式下均与编辑器融为一体 |

package/lib/client.js

@@ -142,7 +142,9 @@ window.__ModuleLoader__.load({
       .cdex-ref-code{background:var(--dsw-alias-bg-base,#1e1e1e);border-radius:4px;padding:6px;font-family:Consolas,monospace;font-size:12px;white-space:pre-wrap;word-break:break-all;color:var(--dsw-alias-label-primary,#d4d4d4);max-height:140px;overflow:auto;}
       .cdex-section{color:var(--dsw-alias-label-secondary,#8a8a8a);font-size:11px;text-transform:uppercase;letter-spacing:.05em;margin:12px 0 6px;}
       .cdex-hint{color:var(--dsw-alias-label-secondary,#8a8a8a);font-size:12px;margin-top:12px;line-height:1.6;}
-      .cdex-toast{position:fixed;z-index:10003;bottom:36px;left:50%;transform:translateX(-50%);background:var(--cdex-accent-bg,#0f1115);color:var(--cdex-accent-fg,#ffffff);padding:9px 16px;border-radius:6px;box-shadow:0 4px 16px rgba(0,0,0,.4);max-width:80vw;}
+      .cdex-toast{position:fixed;z-index:10003;top:36px;left:50%;transform:translateX(-50%);background:var(--cdex-accent-bg,#0f1115);color:var(--cdex-accent-fg,#ffffff);padding:9px 16px;border-radius:6px;box-shadow:0 4px 16px rgba(0,0,0,.4);max-width:80vw;cursor:grab;user-select:none;touch-action:none;}
+      .cdex-toast.placed{transform:none;cursor:grabbing;}
+      .cdex-toast-grip{margin-right:8px;opacity:.55;font-size:12px;letter-spacing:-1px;}
       .cdex-resize{position:absolute;right:0;bottom:0;width:18px;height:18px;cursor:nwse-resize;z-index:10;}
       .cdex-resize::after{content:'';position:absolute;right:4px;bottom:4px;width:8px;height:8px;border-right:2px solid var(--dsw-alias-label-secondary,#7f849c);border-bottom:2px solid var(--dsw-alias-label-secondary,#7f849c);}
       .cdex-aiinput-wrap{position:relative;padding:10px 14px 16px;background:transparent;border-top:1px solid var(--dsw-alias-border-l1,#3e3e42);}
@@ -261,6 +263,11 @@ window.__ModuleLoader__.load({
       confirmBox: null,
       noteEditor: null,
       toast: null,
+      toastKeep: false,
+      toastPos: null,
+      sessionId: null,     // 当前会话 id（InputBridge 从 slot kit 捕获）：文件树默认根跟随当前会话
+      rootIsAuto: true,    // 根是否为自动跟随（用户「以此文件夹为根」后置 false，不再跟随）
+      rootSessionId: null, // 当前自动根来自哪个会话（落后于 sessionId 时触发重新解析）
       error: null,
     }
     const listeners = new Set()
@@ -277,10 +284,55 @@ window.__ModuleLoader__.load({
 
     function showToast(msg) {
       store.toast = { msg }
+      store.toastKeep = false
       emit()
+      scheduleToastHide(2800)
+    }
+    // 提示自动消失；正在被拖拽（toastKeep）时顺延，松手后短暂展示再消失
+    function scheduleToastHide(ms) {
       if (timer && typeof timer.timeout === 'function') {
-        timer.timeout(() => { store.toast = null; emit() }, 2800)
+        timer.timeout(() => {
+          if (store.toastKeep) { scheduleToastHide(600); return }
+          store.toast = null; emit()
+        }, ms)
+      }
+    }
+    // 提示条拖拽：按住移动自定义位置（默认顶部居中，拖过之后记住位置，防止挡内容）
+    function onToastPointerDown(e) {
+      e.preventDefault()
+      const el = e.currentTarget
+      const rect = el.getBoundingClientRect()
+      const base = store.toastPos || { x: rect.left, y: rect.top }
+      const px = e.clientX, py = e.clientY
+      store.toastKeep = true
+      try { el.setPointerCapture(e.pointerId) } catch (err) {}
+      function move(ev) {
+        const vw = (typeof window !== 'undefined' && window.innerWidth) || 1200
+        const vh = (typeof window !== 'undefined' && window.innerHeight) || 800
+        store.toastPos = {
+          x: Math.max(4, Math.min(base.x + (ev.clientX - px), vw - rect.width - 4)),
+          y: Math.max(4, Math.min(base.y + (ev.clientY - py), vh - rect.height - 4)),
+        }
+        emit()
+      }
+      function up() {
+        store.toastKeep = false
+        el.removeEventListener('pointermove', move)
+        el.removeEventListener('pointerup', up)
+        el.removeEventListener('pointercancel', up)
       }
+      el.addEventListener('pointermove', move)
+      el.addEventListener('pointerup', up)
+      el.addEventListener('pointercancel', up)
+    }
+    function Toast() {
+      const st = useStore()
+      if (!st.toast) return null
+      const style = st.toastPos ? { left: st.toastPos.x, top: st.toastPos.y } : null
+      return h('div', { className: 'cdex-toast' + (st.toastPos ? ' placed' : ''), style: style, title: '按住可拖动位置（不再挡内容）', onPointerDown: onToastPointerDown },
+        h('span', { className: 'cdex-toast-grip' }, '⠿'),
+        st.toast.msg,
+      )
     }
 
     /* ============ 编辑器主题四态：dsh(默认,跟随 DSH 宿主外观) / system(跟随 OS) / light / dark ============ */
@@ -564,7 +616,7 @@ window.__ModuleLoader__.load({
       emit()
       const start = store.browsePath || store.rootPath || null
       if (start) { browseDir(start); return }
-      callHost('get-root').then((r) => {
+      callHost('get-root', store.sessionId ? { sessionId: store.sessionId } : {}).then((r) => {
         if (r && r.root) { browseDir(r.root) }
         else { store.error = '未定位到工作区根，请在输入框粘贴目录或文件路径后回车'; emit() }
       })
@@ -578,7 +630,13 @@ window.__ModuleLoader__.load({
       if (!path) return
       const res = await callHost('set-root', { path })
       if (res && res.error) { showToast('设置失败：' + res.error); return }
-      const newRoot = (res && res.root) ? res.root : path
+      store.rootIsAuto = false // 用户显式选择：此后不再跟随会话切换
+      store.rootSessionId = null
+      await applyRoot((res && res.root) ? res.root : path)
+      showToast('工作区根目录：' + store.rootPath)
+    }
+    // 换根并整体重置文件树/标签页/缓冲（自动跟随与手动设置共用）
+    async function applyRoot(newRoot) {
       store.rootPath = newRoot
       store.nodes = {}
       store.tabs = []
@@ -593,19 +651,18 @@ window.__ModuleLoader__.load({
       store.filePickerOpen = false
       emit()
       await toggleExpand(newRoot)
-      showToast('工作区根目录：' + newRoot)
     }
     // —— 文件树 ——
     async function refresh() {
       store.error = null
-      if (!store.rootPath) {
-        const r = await callHost('get-root')
-        store.rootPath = (r && r.root) || null
-        if (!store.rootPath) { store.error = '未找到工作区根目录'; emit(); return }
-        store.nodes = {}
-        store.nodes[store.rootPath] = { name: baseName(store.rootPath), path: store.rootPath, isDir: true, children: [], expanded: true, loaded: false }
-        emit()
-        await toggleExpand(store.rootPath)
+      const sid = store.sessionId
+      // 自动根模式：首次无根、或会话已切换（rootSessionId 落后）都重新解析当前会话的工作区
+      if (!store.rootPath || (store.rootIsAuto && sid && sid !== store.rootSessionId)) {
+        const r = await callHost('get-root', sid ? { sessionId: sid } : {})
+        const root = (r && r.root) || null
+        if (!root) { store.error = '未找到工作区根目录'; emit(); return }
+        await applyRoot(root)
+        store.rootSessionId = sid
       } else {
         // 修复：刷新不再折叠整棵树，只重载根目录（子目录展开状态保留在 store.nodes）
         await reloadDir(store.rootPath)
@@ -986,6 +1043,15 @@ window.__ModuleLoader__.load({
           store.inputDraft = inputState.draft
           store.inputPhase = inputState.phase
         }
+        // 捕获当前会话 id：文件树默认根跟随当前会话的工作区目录
+        if (props.sessionId && props.sessionId !== store.sessionId) {
+          store.sessionId = props.sessionId
+          if (store.rootIsAuto) {
+            const hasDirty = Object.keys(store.dirty || {}).some((k) => store.dirty[k])
+            if (hasDirty) showToast('会话已切换：有未保存文件，工作区暂不跟随（保存后点 ⟳ 刷新即可）')
+            else refresh()
+          }
+        }
         emit()
       })
       // 挂钩 DSH 原生输入条的发送：存在引用时把指针附进草稿再发（整文件=绝对路径）。
@@ -1472,7 +1538,7 @@ window.__ModuleLoader__.load({
         st.noteEditor ? h(NoteEditor) : null,
         st.nameDialog ? h(NameDialog) : null,
         st.confirmBox ? h(ConfirmBox) : null,
-        st.toast ? h('div', { className: 'cdex-toast' }, st.toast.msg) : null,
+        st.toast ? h(Toast) : null,
       )
     }
 
@@ -1586,7 +1652,7 @@ window.__ModuleLoader__.load({
         st.noteEditor ? h(NoteEditor) : null,
         st.nameDialog ? h(NameDialog) : null,
         st.confirmBox ? h(ConfirmBox) : null,
-        st.toast ? h('div', { className: 'cdex-toast' }, st.toast.msg) : null,
+        st.toast ? h(Toast) : null,
       )
     }
 
@@ -1595,7 +1661,7 @@ window.__ModuleLoader__.load({
     // get-self 失败 / 字段缺失（旧 host）时绝不隐藏编辑器，只有明确 enabled===false 才不挂载。
     let unmountEditorFns = null
     let layoutMode = 'dock'    // dock(右侧停靠,默认) / float(悬浮窗口)：编辑器以哪种布局呈现
-    let toggleStyle = 'header' // header(会话头 ⌨ 按钮,默认) / bar(悬浮模式条)：用哪种按钮切换界面
+    let toggleStyle = 'bar'    // bar(悬浮模式条,默认) / header(会话头 ⌨ 按钮)：用哪种按钮切换界面
     function mountEditor() {
       if (unmountEditorFns) return
       const disposers = []
@@ -1669,13 +1735,14 @@ window.__ModuleLoader__.load({
       if (v) mountEditor()
       else unmountEditor()
     }
-    // 启动时先查开关/主题/布局/界面模式/切换按钮再挂载（RPC 失败 = 全默认：启用+跟随DSH+停靠+显示+会话头按钮）
+    // 启动时先查开关/主题/布局/界面模式/切换按钮再挂载（新装默认：启用+跟随DSH+停靠+隐藏+悬浮模式条；
+    // RPC 失败回退到「可见+会话头按钮」保证可发现性）
     callHost('get-self').then((r) => {
       if (r && !r.error) {
         setThemeMode(r.theme)
         layoutMode = (r.layout === 'float') ? 'float' : 'dock'
-        toggleStyle = (r.toggle === 'bar') ? 'bar' : 'header'
-        applyUiMode(r.uiMode === 'native' ? 'native' : 'codeui')
+        toggleStyle = (r.toggle === 'header') ? 'header' : 'bar'
+        applyUiMode(r.uiMode === 'codeui' ? 'codeui' : 'native')
         applyEnabled(!(r.enabled === false))
       } else {
         setThemeMode('dsh')
@@ -1695,8 +1762,7 @@ window.__ModuleLoader__.load({
       const [localPath, setLocalPath] = React.useState('')
       const [enabling, setEnabling] = React.useState(false)
       const [theming, setTheming] = React.useState(false)
-      const [layouting, setLayouting] = React.useState(false)
-      const [uiModeing, setUiModeing] = React.useState(false)
+      const [uishing, setUishing] = React.useState(false)
       const [toggling, setToggling] = React.useState(false)
       const lastPayloadRef = React.useRef(null)
       const pollDisposeRef = React.useRef(null)
@@ -1717,36 +1783,46 @@ window.__ModuleLoader__.load({
         })
       }
 
-      // 布局模式：写 host settings 持久化；成功后立即卸载旧挂载、按新模式重挂
-      function setLayout(m) {
-        if (!self || layouting) return
-        setLayouting(true)
-        callHost('set-layout', { layout: m }).then((r) => {
-          setLayouting(false)
-          if (r && !r.error) {
-            setSelf(Object.assign({}, self, { layout: m }))
-            applyLayout(m)
-            showToast('布局已切换：' + (m === 'dock' ? '右侧停靠' : '悬浮窗口'))
-          } else {
-            showToast('切换失败：' + ((r && r.error) || '未知错误'))
-          }
-        })
-      }
-
-      // 界面模式：写 host settings 持久化；成功后立即显示/隐藏编辑器（按当前布局）
-      function setUiMode(m) {
-        if (!self || uiModeing) return
-        setUiModeing(true)
-        callHost('set-uimode', { uiMode: m }).then((r) => {
-          setUiModeing(false)
-          if (r && !r.error) {
-            setSelf(Object.assign({}, self, { uiMode: m }))
-            applyUiMode(m)
-            showToast('界面已切换：' + (m === 'codeui' ? 'code UI' : 'dsh UI'))
-          } else {
-            showToast('切换失败：' + ((r && r.error) || '未知错误'))
-          }
-        })
+      // 编辑器界面（三态，合并原「布局模式 × 界面模式」）：
+      // dock=右侧停靠 / float=悬浮窗口 / hidden=隐藏(dsh UI，内部记住当前布局，切回原样恢复)
+      function setUiShape(v) {
+        if (!self || uishing) return
+        const curLayout = (self.layout === 'float') ? 'float' : 'dock'
+        const curHidden = self.uiMode === 'native'
+        if (v === 'hidden') {
+          if (curHidden) return
+          setUishing(true)
+          callHost('set-uimode', { uiMode: 'native' }).then((r) => {
+            setUishing(false)
+            if (r && !r.error) {
+              setSelf(Object.assign({}, self, { uiMode: 'native' }))
+              applyUiMode('native')
+              showToast('编辑器已隐藏（dsh UI）')
+            } else { showToast('切换失败：' + ((r && r.error) || '未知错误')) }
+          })
+          return
+        }
+        const needLayout = curLayout !== v
+        const needShow = curHidden
+        if (!needLayout && !needShow) return
+        setUishing(true)
+        const next = Object.assign({}, self, { layout: v, uiMode: 'codeui' })
+        const step = () => {
+          callHost('set-uimode', { uiMode: 'codeui' }).then((r2) => {
+            setUishing(false)
+            if (r2 && !r2.error) {
+              setSelf(next)
+              applyUiMode('codeui')
+              showToast('编辑器界面：' + (v === 'dock' ? '右侧停靠' : '悬浮窗口'))
+            } else { showToast('切换失败：' + ((r2 && r2.error) || '未知错误')) }
+          })
+        }
+        if (needLayout) {
+          callHost('set-layout', { layout: v }).then((r1) => {
+            if (r1 && !r1.error) { applyLayout(v); step() }
+            else { setUishing(false); showToast('切换失败：' + ((r1 && r1.error) || '未知错误')) }
+          })
+        } else { step() }
       }
 
       // 切换按钮样式：写 host settings 持久化；成功后立即换一种切换按钮
@@ -1828,6 +1904,8 @@ window.__ModuleLoader__.load({
 
       const cur = (self && self.version) || (chk && chk.current) || '?'
       const started = !!(run && !run.done)
+      // 更新已成功、等待重启：更新类按钮文案临时改为「需重启 DSH 生效」，用户一眼可见
+      const updated = !!(run && run.done && run.ok)
       let checkLine = null
       if (chk && chk.checking) checkLine = h('p', { className: 'cdx-pc-note' }, '检查中…')
       else if (chk && chk.error) checkLine = h('p', { className: 'cdx-pc-err' }, chk.error)
@@ -1883,37 +1961,25 @@ window.__ModuleLoader__.load({
             ),
             h('p', { className: 'cdx-pc-note' }, '「跟随 DSH」随 DSH 整体外观（默认）；「跟随系统」随操作系统浅色/深色实时切换；浅色/深色为强制指定。切换立即生效，仅作用于编辑器界面，选择持久化保存。'),
           ),
-          // 字段：布局模式
+          // 字段：编辑器界面（三态，合并原「布局模式 × 界面模式」）
           h('div', { className: 'cdx-pc-field' },
             h('div', { className: 'cdx-pc-head' },
-              h('span', { className: 'cdx-pc-label' }, '布局模式'),
+              h('span', { className: 'cdx-pc-label' }, '编辑器界面'),
               h('span', { className: 'cdx-pc-head' },
-                ['dock', 'float'].map((m) => h('button', {
-                  key: m,
-                  type: 'button',
-                  className: 'cdx-pc-btn ' + (((self && self.layout) || 'dock') === m ? 'cdx-pc-btn-primary' : 'cdx-pc-btn-outline'),
-                  disabled: !self || layouting,
-                  onClick: () => setLayout(m),
-                }, m === 'dock' ? '右侧停靠' : '悬浮窗口')),
-              ),
-            ),
-            h('p', { className: 'cdx-pc-note' }, '「右侧停靠」code UI 固定占屏幕右侧、与聊天并排，会话头 ⌨ 按钮开关（默认）；「悬浮窗口」为可拖拽的浮动编辑器窗口，盖住页面、含自带输入框。切换即时生效，选择持久化保存。'),
-          ),
-          // 字段：界面模式
-          h('div', { className: 'cdx-pc-field' },
-            h('div', { className: 'cdx-pc-head' },
-              h('span', { className: 'cdx-pc-label' }, '界面模式'),
-              h('span', { className: 'cdx-pc-head' },
-                ['codeui', 'native'].map((m) => h('button', {
-                  key: m,
-                  type: 'button',
-                  className: 'cdx-pc-btn ' + (((self && self.uiMode) || 'codeui') === m ? 'cdx-pc-btn-primary' : 'cdx-pc-btn-outline'),
-                  disabled: !self || uiModeing,
-                  onClick: () => setUiMode(m),
-                }, m === 'codeui' ? 'code UI' : 'dsh UI')),
+                (function () {
+                  const curLayout = ((self && self.layout) === 'float') ? 'float' : 'dock'
+                  const cur = (self && self.uiMode) === 'native' ? 'hidden' : curLayout
+                  return ['dock', 'float', 'hidden'].map((m) => h('button', {
+                    key: m,
+                    type: 'button',
+                    className: 'cdx-pc-btn ' + (cur === m ? 'cdx-pc-btn-primary' : 'cdx-pc-btn-outline'),
+                    disabled: !self || uishing,
+                    onClick: () => setUiShape(m),
+                  }, m === 'dock' ? '右侧停靠' : m === 'float' ? '悬浮窗口' : '隐藏（dsh UI）'))
+                })(),
               ),
             ),
-            h('p', { className: 'cdx-pc-note' }, '「code UI」显示编辑器界面（默认）；「dsh UI」隐藏编辑器、回归 DSH 原生界面（入口按钮保留，随时切回）。悬浮模式条 / ⌨ / ✕ / ↩ 的每次切换都会同步到此处，选择持久化保存。'),
+            h('p', { className: 'cdx-pc-note' }, '「隐藏（dsh UI）」为默认：新装不自动占屏，⌨ / 模式条 / ✕ 随时唤回，隐藏期间记住当前布局、切回原样恢复；「右侧停靠」code UI 固定占屏幕右侧、与聊天并排（默认布局）；「悬浮窗口」为可拖拽的浮动编辑器窗口、含自带输入框。切换即时生效，持久化保存。'),
           ),
           // 字段：切换按钮
           h('div', { className: 'cdx-pc-field' },
@@ -1923,13 +1989,13 @@ window.__ModuleLoader__.load({
                 ['header', 'bar'].map((m) => h('button', {
                   key: m,
                   type: 'button',
-                  className: 'cdx-pc-btn ' + (((self && self.toggle) || 'header') === m ? 'cdx-pc-btn-primary' : 'cdx-pc-btn-outline'),
+                  className: 'cdx-pc-btn ' + (((self && self.toggle) || 'bar') === m ? 'cdx-pc-btn-primary' : 'cdx-pc-btn-outline'),
                   disabled: !self || toggling,
                   onClick: () => setToggle(m),
                 }, m === 'header' ? '会话头按钮' : '悬浮模式条')),
               ),
             ),
-            h('p', { className: 'cdx-pc-note' }, '选择用哪种按钮在 code UI 与dsh UI 之间切换：「会话头按钮」在会话标题栏显示 ⌨ code UI（默认）；「悬浮模式条」为屏幕上方可拖动的横条（code UI / dsh UI 两键）。与布局模式无关，可任意组合，选择持久化保存。'),
+            h('p', { className: 'cdx-pc-note' }, '选择用哪种按钮在 code UI 与 dsh UI 之间切换：「悬浮模式条」为屏幕上方可拖动的横条（code UI / dsh UI 两键，默认）；「会话头按钮」在会话标题栏显示 ⌨ code UI。与布局模式无关，可任意组合，选择持久化保存。'),
           ),
           // 字段一：在线检查更新
           h('div', { className: 'cdx-pc-field' },
@@ -1943,14 +2009,14 @@ window.__ModuleLoader__.load({
           chk && chk.updateAvailable ? h('div', { className: 'cdx-pc-field' },
             h('div', { className: 'cdx-pc-head' },
               h('span', { className: 'cdx-pc-label' }, h('span', { className: 'cdx-pc-new' }, '🆕 有新版本：v' + chk.current + ' -> v' + chk.latest)),
-              h('button', { type: 'button', className: 'cdx-pc-btn cdx-pc-btn-primary', disabled: started, onClick: () => startUpdate({ source: 'registry', version: chk.latest }) }, '一键更新到 v' + chk.latest),
+              h('button', { type: 'button', className: 'cdx-pc-btn ' + (updated ? 'cdx-pc-btn-outline' : 'cdx-pc-btn-primary'), disabled: started || updated, onClick: () => startUpdate({ source: 'registry', version: chk.latest }) }, updated ? '需重启 DSH 生效' : '一键更新到 v' + chk.latest),
             ),
           ) : null,
           // 字段三：本地包更新
           h('div', { className: 'cdx-pc-field' },
             h('div', { className: 'cdx-pc-head' },
               h('span', { className: 'cdx-pc-label' }, '本地包更新（开发期 / 未发布时）'),
-              h('button', { type: 'button', className: 'cdx-pc-btn cdx-pc-btn-outline', disabled: started || !localPath.trim(), onClick: () => startUpdate({ source: 'local', path: localPath.trim() }) }, '安装本地包'),
+              h('button', { type: 'button', className: 'cdx-pc-btn ' + (updated ? 'cdx-pc-btn-outline' : 'cdx-pc-btn-outline'), disabled: started || updated || !localPath.trim(), onClick: () => startUpdate({ source: 'local', path: localPath.trim() }) }, updated ? '需重启 DSH 生效' : '安装本地包'),
             ),
             h('div', { className: 'cdx-pc-head' },
               h('input', {

package/lib/index.js

@@ -100,13 +100,13 @@ const CodeUiSettingsSchema = z.object({
   theme: z.string().default("dsh"),
   // 布局模式：dock(右侧停靠,默认) / float(悬浮窗口)
   layout: z.string().default("dock"),
-  // 界面模式：codeui(显示编辑器,默认) / native(原始风格-ui，仅留入口按钮)
-  uiMode: z.string().default("codeui"),
-  // 切换按钮样式：header(会话头 ⌨ 按钮,默认) / bar(悬浮模式条)
-  toggle: z.string().default("header"),
+  // 界面模式：native(隐藏编辑器,默认——新装不自动占屏,由 ⌨ 按钮唤出) / codeui(显示编辑器)
+  uiMode: z.string().default("native"),
+  // 切换按钮样式：bar(悬浮模式条,默认) / header(会话头 ⌨ 按钮)
+  toggle: z.string().default("bar"),
 });
 // 解析后的当前值：settings 服务未挂载/未写入时保持默认
-const selfSettings = { updateRegistry: REGISTRY_DEFAULT, enabled: true, theme: "dsh", layout: "dock", uiMode: "codeui", toggle: "header" };
+const selfSettings = { updateRegistry: REGISTRY_DEFAULT, enabled: true, theme: "dsh", layout: "dock", uiMode: "native", toggle: "bar" };
 // settings 服务引用（「启用/禁用」开关写入用；由 installSelfSettings 捕获）
 let settingsServiceRef = null;
 function installSelfSettings(ctx) {
@@ -349,13 +349,9 @@ function unwatchAllFiles() {
 
 function rpcHandler(ctx) {
   const fs = ctx.get("fs");
-  let currentRootRef = detectWorkspaceRoot(ctx);
+  let currentRootRef = detectWorkspaceRoot(ctx); // 最近一次解析的根：list-dir 的兜底
+  let manualRootRef = null; // 用户「以此文件夹为根」的显式选择：一旦设置不再跟随会话
 
-  // 每次 get-root 动态回读会话工作区根，避免一次缓存导致拿不到当前项目目录
-  function baseRoot() {
-    if (currentRootRef) return currentRootRef;
-    return detectWorkspaceRoot(ctx);
-  }
   function detectWorkspaceRoot(_ctx) {
     // 1) 当前会话的真实工作区根(项目根)：优先取正在发起调用的 agent 的 session cwd。
     //    sandboxPolicy.workspaceRoot 只是「部署回退根」，常是 DSH 进程 cwd 而非项目目录。
@@ -388,13 +384,29 @@ function rpcHandler(ctx) {
       const args = payload && typeof payload === "object" ? payload : {};
 
       if (endpoint === "get-root") {
-        const root = baseRoot();
+        // 优先级：手动设置的根 > 浏览器上报的当前会话 cwd（agent/session id 共享，agents.get 可查）
+        // > initiator 会话 cwd（agent 驱动中）> 部署回退根 > 进程 cwd
+        let root = manualRootRef;
+        if (!root && args.sessionId) {
+          const agentsSvc = ctx.get("agents");
+          if (agentsSvc) {
+            try {
+              const a = agentsSvc.get(String(args.sessionId));
+              if (a && a.session && a.session.header && a.session.header.cwd) {
+                root = a.session.header.cwd;
+              }
+            } catch (_) {}
+          }
+        }
+        if (!root) root = detectWorkspaceRoot(ctx);
+        if (root) currentRootRef = root;
         return ok({ root });
       }
 
       if (endpoint === "set-root") {
         if (!args.path) return ok({ error: "no-path" });
-        currentRootRef = String(args.path);
+        manualRootRef = String(args.path);
+        currentRootRef = manualRootRef;
         return ok({ root: currentRootRef });
       }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-code-ui",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "Cursor 风格的 AI 代码编辑器工作台插件（DSH）：文件树、多标签页编辑、语法高亮、引用/翻译给 AI、右侧停靠/悬浮窗口双布局",
   "type": "module",
   "main": "lib/index.js",