dsh-code-ui 1.2.0 → 1.3.1

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 / 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,21 +102,14 @@ 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.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

@@ -123,13 +123,18 @@ window.__ModuleLoader__.load({
       .cdex-btn-ghost{border:1px solid var(--dsw-alias-border-l1,#3e3e42);background:var(--dsw-alias-bg-layer-2,#3c3c3c);color:var(--dsw-alias-label-primary,#cccccc);border-radius:4px;padding:3px 8px;cursor:pointer;font-size:12px;}
       .cdex-btn-ghost:hover{background:var(--dsw-alias-bg-layer-1,#4a4a4a);}
       .cdex-menu-backdrop{position:fixed;inset:0;z-index:10001;pointer-events:auto;}
-      .cdex-menu{position:fixed;z-index:10002;background:var(--dsw-alias-bg-overlay,#252526);border:1px solid var(--dsw-alias-border-l2,#454545);border-radius:6px;padding:4px;min-width:180px;box-shadow:0 8px 24px rgba(0,0,0,.5);}
+      .cdex-menu{position:fixed;z-index:10002;background:var(--dsw-alias-bg-overlay,#252526);border:1px solid var(--dsw-alias-border-l2,#454545);border-radius:6px;padding:4px;min-width:180px;box-shadow:0 8px 24px rgba(0,0,0,.5);max-height:calc(100vh - 24px);overflow-y:auto;}
       .cdex-menu-item{display:flex;gap:8px;align-items:center;padding:7px 10px;border-radius:4px;cursor:pointer;font-size:13px;color:var(--dsw-alias-label-primary,#d4d4d4);}
       .cdex-menu-item:hover{background:var(--cdex-accent-bg,#0f1115);color:var(--cdex-accent-fg,#ffffff);}
       .cdex-modal{position:fixed;inset:0;background:rgba(0,0,0,.55);display:flex;align-items:center;justify-content:center;z-index:10002;pointer-events:auto;}
       .cdex-modal-box{background:var(--dsw-alias-bg-overlay,#252526);border:1px solid var(--dsw-alias-border-l2,#454545);border-radius:8px;padding:16px;width:560px;max-width:92vw;}
       .cdex-modal-title{font-weight:600;margin-bottom:10px;color:var(--dsw-alias-label-primary,#e8e8e8);word-break:break-all;}
       .cdex-textarea2{width:100%;min-height:150px;background:var(--dsw-alias-bg-base,#1e1e1e);color:var(--dsw-alias-label-primary,#d4d4d4);border:1px solid var(--dsw-alias-border-l1,#3e3e42);border-radius:4px;padding:8px;font-family:inherit;font-size:13px;resize:vertical;box-sizing:border-box;}
+      .cdex-input{width:100%;background:var(--dsw-alias-bg-base,#1e1e1e);color:var(--dsw-alias-label-primary,#d4d4d4);border:1px solid var(--dsw-alias-border-l1,#3e3e42);border-radius:4px;padding:8px 10px;font-family:inherit;font-size:13px;box-sizing:border-box;outline:none;}
+      .cdex-input:focus{border-color:var(--dsw-alias-label-dimmed,#6a6a70);}
+      .cdex-confirm-msg{color:var(--dsw-alias-label-primary,#d4d4d4);font-size:13px;line-height:1.6;white-space:pre-wrap;word-break:break-word;}
+      .cdex-btn-danger{background:var(--dsw-alias-state-error-primary,#f14c4c);color:#ffffff;border-color:transparent;}
+      .cdex-btn-danger:hover{opacity:.9;}
       .cdex-modal-actions{display:flex;justify-content:flex-end;gap:8px;margin-top:12px;}
       .cdex-ref{background:var(--dsw-alias-bg-layer-1,#2d2d2d);border:1px solid var(--dsw-alias-border-l1,#3e3e42);border-radius:6px;padding:8px;margin-bottom:8px;}
       .cdex-ref-head{display:flex;align-items:center;gap:6px;margin-bottom:6px;font-size:12px;}
@@ -137,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);}
@@ -252,8 +259,12 @@ window.__ModuleLoader__.load({
       browsePath: null,
       browseEntries: [],
       ctxMenu: null,
+      nameDialog: null,
+      confirmBox: null,
       noteEditor: null,
       toast: null,
+      toastKeep: false,
+      toastPos: null,
       error: null,
     }
     const listeners = new Set()
@@ -270,10 +281,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 ============ */
@@ -337,6 +393,7 @@ window.__ModuleLoader__.load({
       if (r.lineStart && r.lineEnd) {
         return name + '(' + r.lineStart + '-' + r.lineEnd + ')'
       }
+      if (!r.lineStart && r.kind === 'cite') return name + '(整文件)'
       return name
     }
     function parentPath(p) {
@@ -599,9 +656,8 @@ window.__ModuleLoader__.load({
         emit()
         await toggleExpand(store.rootPath)
       } else {
-        const node = store.nodes[store.rootPath]
-        if (node) { node.loaded = false; node.children = []; node.expanded = true }
-        await toggleExpand(store.rootPath)
+        // 修复：刷新不再折叠整棵树，只重载根目录（子目录展开状态保留在 store.nodes）
+        await reloadDir(store.rootPath)
       }
     }
     async function toggleExpand(path) {
@@ -719,7 +775,14 @@ window.__ModuleLoader__.load({
       const text = full.slice(start, end)
       const lineStart = full.slice(0, start).split('\n').length
       const lineEnd = full.slice(0, end).split('\n').length
-      store.ctxMenu = { x: e.clientX, y: e.clientY, sel: { text, lineStart, lineEnd, path: store.activePath, language: langOf(store.activePath) } }
+      const sel = { text, lineStart, lineEnd, path: store.activePath, language: langOf(store.activePath) }
+      store.ctxMenu = { x: e.clientX, y: e.clientY, items: [
+        { icon: '📋', label: '复制', act: () => { copyText(sel.text); showToast('已复制'); closeMenu() } },
+        { icon: '📥', label: '粘贴到备注', act: () => { pasteToNote(sel); closeMenu() } },
+        { icon: '📝', label: '添加备注', act: () => { openNoteEditor(sel); closeMenu() } },
+        { icon: '🌐', label: '翻译', act: () => { doTranslate(sel); closeMenu() } },
+        { icon: '🔗', label: '引用（给 AI）', act: () => { doCite(sel); closeMenu() } },
+      ] }
       emit()
     }
     function closeMenu() { store.ctxMenu = null; emit() }
@@ -737,6 +800,113 @@ window.__ModuleLoader__.load({
       store.noteEditor = { path: sel.path, lineStart: sel.lineStart, lineEnd: sel.lineEnd, note: '' }
       emit()
     }
+    // —— 文件树右键：磁盘操作（真实文件系统，经 host RPC） ——
+    function joinPath(dir, name) {
+      const sep = String(dir).includes('\\') ? '\\' : '/'
+      return String(dir).replace(/[\\/]+$/, '') + sep + name
+    }
+    // 重载单个目录节点（保持展开状态，不折叠整个树）
+    async function reloadDir(path) {
+      const n = store.nodes[path]
+      if (!n || !n.isDir) return
+      n.loaded = false
+      n.children = []
+      n.expanded = true
+      n.loading = true; emit()
+      const res = await callHost('list-dir', { path })
+      n.loading = false; n.loaded = true
+      if (res && res.error) { store.error = res.error; emit(); return }
+      const entries = (res && res.entries) || []
+      n.children = entries.map((e) => { store.nodes[e.path] = e; return e.path })
+      emit()
+    }
+    // 整文件引用：只给 AI 绝对路径，AI 用自己的读取工具打开
+    async function citeWholeFile(path) {
+      const ref = await callHost('add-reference', { path: path, language: langOf(path), lineStart: null, lineEnd: null, text: '', kind: 'cite' })
+      if (ref && ref.reference) { store.references.push(ref.reference); emit() }
+      showToast('已引用整个文件：' + baseName(path) + '（AI 将自行读取）')
+    }
+    // 重命名后同步标签页/缓冲/激活路径/watcher
+    function renameTabSync(fromPath, toPath) {
+      const affected = store.tabs.filter((t) => t.path === fromPath)
+      affected.forEach((t) => { t.path = toPath; t.name = baseName(toPath) })
+      if (toPath in store.buffers === false && fromPath in store.buffers) {
+        store.buffers[toPath] = store.buffers[fromPath]
+        store.savedContent[toPath] = store.savedContent[fromPath]
+        store.dirty[toPath] = store.dirty[fromPath]
+        store.externalChanged[toPath] = false
+      }
+      delete store.buffers[fromPath]; delete store.savedContent[fromPath]; delete store.dirty[fromPath]; delete store.externalChanged[fromPath]
+      if (store.activePath === fromPath) store.activePath = toPath
+      callHost('unwatch-file', { path: fromPath }).then(() => {})
+      if (affected.length > 0) callHost('watch-file', { path: toPath }).then(() => {})
+    }
+    // 删除后清理：关掉该路径（及其目录下）所有打开的标签
+    function closeTabsUnder(path) {
+      const sep = String(path).includes('\\') ? '\\' : '/'
+      const prefix = String(path).replace(/[\\/]+$/, '') + sep
+      store.tabs.filter((t) => t.path === path || t.path.indexOf(prefix) === 0)
+        .map((t) => t.path).forEach((p) => closeTab(p))
+    }
+    async function doRename(path, isDir) {
+      const parent = parentPath(path)
+      store.nameDialog = { mode: 'rename', path: path, dir: parent, isDir: !!isDir, curName: baseName(path) }
+      emit()
+    }
+    async function doDelete(path, isDir) {
+      store.confirmBox = {
+        msg: isDir
+          ? '确定删除文件夹「' + baseName(path) + '」吗？\n其中所有内容（含子目录）都会被永久删除。'
+          : '确定删除文件「' + baseName(path) + '」吗？',
+        danger: true,
+        onOk: async () => {
+          const res = await callHost('fs-delete', { path: path, recursive: !!isDir })
+          if (res && res.error) { showToast('删除失败：' + res.error); return }
+          closeTabsUnder(path)
+          const parent = parentPath(path)
+          if (parent && store.nodes[parent]) await reloadDir(parent)
+          else await refresh()
+          showToast('已删除：' + baseName(path))
+        },
+      }
+      emit()
+    }
+    // 文件树节点右键菜单
+    function openNodeMenu(e, node) {
+      e.preventDefault(); e.stopPropagation()
+      const items = []
+      if (node.isDir) {
+        items.push({ icon: '📄', label: '新建文件', act: () => { store.nameDialog = { mode: 'newfile', dir: node.path }; emit() } })
+        items.push({ icon: '🗂', label: '新建文件夹', act: () => { store.nameDialog = { mode: 'newdir', dir: node.path }; emit() } })
+        items.push({ icon: '🏠', label: '以此文件夹为根', act: () => setWorkspaceRoot(node.path) })
+        items.push({ icon: '⟳', label: '刷新', act: () => reloadDir(node.path) })
+      } else {
+        items.push({ icon: '📄', label: '打开', act: () => openFile(node.path) })
+        items.push({ icon: '🔗', label: '引用给 AI（整个文件）', act: () => citeWholeFile(node.path) })
+      }
+      items.push({ icon: '📋', label: '复制路径', act: () => { copyText(node.path); showToast('已复制路径：' + node.path) } })
+      items.push({ icon: '📂', label: '在资源管理器中显示', act: () => callHost('fs-reveal', { path: node.path }).then((r) => { if (r && r.error) showToast('失败：' + r.error) }) })
+      items.push({ icon: '✏️', label: '重命名', act: () => doRename(node.path, node.isDir) })
+      const isRoot = node.path === store.rootPath
+      items.push({ icon: '🗑', label: isRoot ? '删除（工作区根）' : (node.isDir ? '删除文件夹…' : '删除'), act: () => {
+        if (isRoot) { showToast('工作区根目录不能在树里删除；请先更换根目录'); return }
+        doDelete(node.path, node.isDir)
+      } })
+      store.ctxMenu = { x: e.clientX, y: e.clientY, items: items }
+      emit()
+    }
+    // 文件树空白区右键
+    function openTreeBlankMenu(e) {
+      e.preventDefault()
+      if (!store.rootPath) return
+      store.ctxMenu = { x: e.clientX, y: e.clientY, items: [
+        { icon: '📄', label: '新建文件（根目录）', act: () => { store.nameDialog = { mode: 'newfile', dir: store.rootPath }; emit() } },
+        { icon: '🗂', label: '新建文件夹（根目录）', act: () => { store.nameDialog = { mode: 'newdir', dir: store.rootPath }; emit() } },
+        { icon: '⟳', label: '刷新', act: () => refresh() },
+        { icon: '🗃', label: '更换工作区根', act: () => openFilePicker() },
+      ] }
+      emit()
+    }
     async function pasteToNote(sel) {
       let clip = ''
       try {
@@ -762,16 +932,28 @@ window.__ModuleLoader__.load({
     function buildSendPayload(draft) {
       // 引用文本不再粘贴进消息（明面上不展示）：引用统一存 host 端，AI 通过 get_referenced_snippets
       // 工具读取；消息里只附一行「标签级」指针，让 AI 知道有引用可读。
+      // 整文件引用（无行号）：直接给出绝对路径，AI 用自己的读取工具打开。
       const text = draft || ''
+      if (text.indexOf('[code UI] 已标记') >= 0) return text // 幂等：已带指针不重复附加
       const citeRefs = store.references.filter((r) => r.kind === 'cite')
       const trRefs = store.references.filter((r) => r.kind === 'translate')
+      const codeRefs = citeRefs.filter((r) => r.lineStart)
+      const fileRefs = citeRefs.filter((r) => !r.lineStart)
       const parts = []
-      if (citeRefs.length > 0) parts.push(citeRefs.length + ' 段代码引用')
+      if (codeRefs.length > 0) parts.push(codeRefs.length + ' 段代码引用')
+      if (fileRefs.length > 0) parts.push(fileRefs.length + ' 个文件引用')
       if (trRefs.length > 0) parts.push(trRefs.length + ' 条翻译请求')
       if (parts.length === 0) return text
+      let ptr = '[code UI] 已标记 ' + parts.join('、') + '。'
+      if (fileRefs.length > 0) {
+        ptr += '\n文件引用（整个文件，请用你的文件读取工具打开以下绝对路径）：\n'
+          + fileRefs.map((r) => '- ' + r.path).join('\n')
+      }
+      if (codeRefs.length > 0 || trRefs.length > 0) {
+        ptr += '\n（代码/翻译引用内容未粘贴在消息里，请调用 get_referenced_snippets 工具读取）。'
+      }
       const sep = text.trim() ? '\n\n' : ''
-      return text + sep + '[code UI] 已标记 ' + parts.join('、')
-        + '（引用内容未粘贴在消息里，请调用 get_referenced_snippets 工具读取）。'
+      return text + sep + ptr
     }
 
     /* ============ §6 Pointer 处理层（窗口拖拽 / 缩放 / 模式条移动） ============ */
@@ -842,6 +1024,7 @@ window.__ModuleLoader__.load({
     }
 
     /* ============ §7 组件层（V.* 命名空间） ============ */
+    let selfSending = false // AiInput 副本自己发送时置位，让挂钩的 submit 不重复附加指针
     function InputBridge(props) {
       const useInput = props.useInput
       const inputState = typeof useInput === 'function' ? useInput((s) => s) : undefined
@@ -854,6 +1037,27 @@ window.__ModuleLoader__.load({
         }
         emit()
       })
+      // 挂钩 DSH 原生输入条的发送：存在引用时把指针附进草稿再发（整文件=绝对路径）。
+      // actions 对象「每会话一个稳定身份」，补丁安全；卸载/换会话时还原原方法。
+      React.useEffect(() => {
+        if (!inputActions || typeof inputActions.submit !== 'function') return
+        if (inputActions.__cdexPatched) return
+        const orig = inputActions.submit
+        inputActions.__cdexPatched = true
+        inputActions.submit = function () {
+          try {
+            const hasRefs = store.references.length > 0
+            const draft = store.inputDraft || ''
+            if (hasRefs && !selfSending && draft.indexOf('[code UI]') < 0) {
+              inputActions.setDraft(buildSendPayload(draft))
+            }
+          } catch (e) {}
+          return orig.apply(inputActions, arguments)
+        }
+        return () => {
+          try { inputActions.submit = orig; delete inputActions.__cdexPatched } catch (e) {}
+        }
+      }, [inputActions])
       return null
     }
     function AiInput() {
@@ -873,8 +1077,11 @@ window.__ModuleLoader__.load({
         const text = taEl.value
         if (!text.trim() && refs.length === 0) return
         const payload = buildSendPayload(text)
-        st.inputActions.setDraft(payload)
-        st.inputActions.submit()
+        selfSending = true
+        try {
+          st.inputActions.setDraft(payload)
+          st.inputActions.submit()
+        } finally { selfSending = false }
         taEl.value = ''
       }
       return h('div', { className: 'cdex-aiinput-wrap' },
@@ -933,7 +1140,8 @@ window.__ModuleLoader__.load({
           if (!p) return
           callHost('stat-path', { path: p }).then((res) => {
             if (!res || res.error) { showToast('无法访问该路径：' + ((res && res.error) || '未知错误')); return }
-            if (res.isDir) { browseDir(res.path || p) }
+            // 手动输入 + 回车 = 直接认定：目录设为工作区根，文件直接打开
+            if (res.isDir) { setWorkspaceRoot(res.path || p) }
             else if (res.isFile) { pickFile(res.path || p) }
             // 兼容回退：宿主 isDir 字段缺失但路径确实存在时，按目录尝试浏览（list-dir 对非目录会给出真实错误）
             else if (res.exists) { browseDir(p) }
@@ -955,7 +1163,7 @@ window.__ModuleLoader__.load({
           ),
           h('div', { className: 'cdex-fp-bar' },
             h('button', { className: 'cdex-btn-ghost', onClick: goUp, title: '上级目录' }, '↑'),
-            h('input', { className: 'cdex-fp-input', defaultValue: curDir || '', placeholder: '输入绝对路径后回车跳转', onKeyDown: goTo }),
+            h('input', { className: 'cdex-fp-input', defaultValue: curDir || '', placeholder: '输入路径后回车：文件夹=设为根，文件=打开', onKeyDown: goTo }),
           ),
           h('div', { className: 'cdex-fp-list' },
             dirs.map((d) => h('div', { className: 'cdex-fp-item', key: d.path, onClick: () => browseDir(d.path) },
@@ -967,7 +1175,7 @@ window.__ModuleLoader__.load({
             dirs.length === 0 && files.length === 0 ? h('div', { className: 'cdex-empty' }, st.error ? String(st.error) : '空目录') : null,
           ),
           h('div', { className: 'cdex-fp-actions' },
-            h('span', { className: 'cdex-fp-hint' }, '浏览到目标文件夹后，点「以此文件夹为根」'),
+            h('span', { className: 'cdex-fp-hint' }, '输入路径回车即认定：文件夹设为根、文件直接打开；点条目仅浏览，此时用右下按钮确认'),
             h('button', { className: 'cdex-btn-ghost', onClick: close }, '取消'),
             h('button', { className: 'cdex-btn', onClick: confirm, disabled: !curDir }, '以此文件夹为根'),
           ),
@@ -1001,7 +1209,7 @@ window.__ModuleLoader__.load({
       const cls = 'cdex-node' + (st.activePath === node.path ? ' active' : '')
       const children = node.isDir && node.expanded ? (node.children || []).map((c) => h(TreeNode, { key: c, path: c, depth: props.depth + 1 })) : null
       return h('div', null,
-        h('div', { className: cls, style: style, onClick: () => { node.isDir ? toggleExpand(node.path) : openFile(node.path) } },
+        h('div', { className: cls, style: style, onClick: () => { node.isDir ? toggleExpand(node.path) : openFile(node.path) }, onContextMenu: (e) => openNodeMenu(e, node) },
           node.isDir ? h('span', { className: 'cdex-arrow' }, node.expanded ? '▾' : '▸') : h('span', { className: 'cdex-arrow' }, ''),
           h('span', { className: node.isDir ? 'cdex-folder' : 'cdex-file' }, node.isDir ? '📁 ' : '📄 ', node.name),
         ),
@@ -1019,7 +1227,7 @@ window.__ModuleLoader__.load({
             h('button', { className: 'cdex-btn-ghost', onClick: () => { store.sidebarCollapsed = true; emit() }, title: '收起侧栏' }, '«'),
           ),
         ),
-        h('div', { className: 'cdex-tree' },
+        h('div', { className: 'cdex-tree', onContextMenu: (e) => { if (!e.target.closest || !e.target.closest('.cdex-node')) openTreeBlankMenu(e) } },
           st.error ? h('div', { className: 'cdex-error' }, String(st.error)) : null,
           st.rootPath ? h(TreeNode, { path: st.rootPath, depth: 0 }) : h('div', { className: 'cdex-empty' }, '正在加载目录…'),
         ),
@@ -1028,10 +1236,10 @@ window.__ModuleLoader__.load({
     function RefItem(r) {
       return h('div', { className: 'cdex-ref', key: r.id },
         h('div', { className: 'cdex-ref-head' },
-          h('span', { className: 'cdex-ref-path' }, r.path, r.lineStart ? (' :' + r.lineStart + '-' + r.lineEnd) : ''),
+          h('span', { className: 'cdex-ref-path' }, r.path, r.lineStart ? (' :' + r.lineStart + '-' + r.lineEnd) : (r.kind === 'cite' ? ' （整个文件）' : '')),
           h('button', { className: 'cdex-btn-ghost', onClick: () => delReference(r.id) }, '✕'),
         ),
-        h('div', { className: 'cdex-ref-code' }, r.text.slice(0, 500)),
+        h('div', { className: 'cdex-ref-code' }, r.text ? r.text.slice(0, 500) : '（AI 将按绝对路径自行读取整个文件）'),
       )
     }
     function ReferencesView() {
@@ -1158,22 +1366,90 @@ window.__ModuleLoader__.load({
       const st = useStore()
       const m = st.ctxMenu
       if (!m) return null
-      const sel = m.sel
-      const items = [
-        { icon: '📋', label: '复制', act: () => { copyText(sel.text); showToast('已复制'); closeMenu() } },
-        { icon: '📥', label: '粘贴到备注', act: () => { pasteToNote(sel); closeMenu() } },
-        { icon: '📝', label: '添加备注', act: () => { openNoteEditor(sel); closeMenu() } },
-        { icon: '🌐', label: '翻译', act: () => { doTranslate(sel); closeMenu() } },
-        { icon: '🔗', label: '引用（给 AI）', act: () => { doCite(sel); closeMenu() } },
-      ]
+      const items = m.items || []
+      // 视口边界自适应：菜单在点击点放不下时收进视口（底部/右侧溢出钳位），
+      // 避免在最后一行右键时菜单被浏览器底边截断
+      const ITEM_H = 33
+      const estH = items.length * ITEM_H + 10
+      const estW = 230
+      let mx = m.x, my = m.y
+      try {
+        const vw = (typeof window !== 'undefined' && window.innerWidth) || 1200
+        const vh = (typeof window !== 'undefined' && window.innerHeight) || 800
+        if (my + estH > vh - 8) my = Math.max(8, vh - estH - 8)
+        if (mx + estW > vw - 8) mx = Math.max(8, vw - estW - 8)
+      } catch (e) {}
       return h('div', { className: 'cdex-menu-backdrop', onClick: closeMenu },
-        h('div', { className: 'cdex-menu', style: { left: m.x, top: m.y }, onClick: (e) => e.stopPropagation() },
-          items.map((it, i) => h('div', { key: i, className: 'cdex-menu-item', onClick: it.act },
+        h('div', { className: 'cdex-menu', style: { left: mx, top: my }, onClick: (e) => e.stopPropagation() },
+          items.map((it, i) => h('div', { key: i, className: 'cdex-menu-item', onClick: () => { try { it.act() } finally { closeMenu() } } },
             h('span', null, it.icon), h('span', null, it.label),
           )),
         ),
       )
     }
+    let nameInputEl = null
+    // 新建文件/文件夹、重命名 的输入弹窗（Enter 确认 / Esc 取消）
+    function NameDialog() {
+      const st = useStore()
+      const d = st.nameDialog
+      if (!d) return null
+      const close = () => { st.nameDialog = null; nameInputEl = null; emit() }
+      const titles = { newfile: '新建文件', newdir: '新建文件夹', rename: d.isDir ? '重命名文件夹' : '重命名文件' }
+      const confirm = async () => {
+        const name = (nameInputEl && nameInputEl.value || '').trim()
+        if (!name) { showToast('请输入名称'); return }
+        if (name.indexOf('/') >= 0 || name.indexOf('\\') >= 0) { showToast('名称不能包含路径分隔符'); return }
+        if (d.mode === 'rename') {
+          const to = joinPath(d.dir, name)
+          const res = await callHost('fs-rename', { from: d.path, to: to })
+          if (res && res.error) { showToast('重命名失败：' + res.error); close(); return }
+          renameTabSync(d.path, to)
+          if (store.nodes[d.dir]) await reloadDir(d.dir)
+          else await refresh()
+          showToast('已重命名为：' + name)
+        } else {
+          const full = joinPath(d.dir, name)
+          const res = await callHost(d.mode === 'newfile' ? 'fs-createfile' : 'fs-mkdir', { path: full })
+          if (res && res.error) { showToast('创建失败：' + res.error); close(); return }
+          if (store.nodes[d.dir]) await reloadDir(d.dir)
+          else await refresh()
+          if (d.mode === 'newfile') await openFile(full)
+          showToast('已创建：' + name)
+        }
+        close()
+      }
+      React.useEffect(() => {
+        if (nameInputEl) { try { nameInputEl.focus(); nameInputEl.select() } catch (e) {} }
+      }, [])
+      return h('div', { className: 'cdex-modal', onClick: close },
+        h('div', { className: 'cdex-modal-box', onClick: (e) => e.stopPropagation() },
+          h('div', { className: 'cdex-modal-title' }, titles[d.mode] || '输入名称', h('span', { style: { color: '#9d9d9d', fontWeight: 400 } }, ' — ', d.mode === 'rename' ? d.dir : d.dir || '')),
+          h('input', { className: 'cdex-input', ref: (el) => { nameInputEl = el }, defaultValue: d.curName || '', placeholder: d.mode === 'rename' ? '输入新名称' : (d.mode === 'newfile' ? '例如 utils.js' : '例如 components'), onKeyDown: (e) => { if (e.key === 'Enter') { e.preventDefault(); confirm() } if (e.key === 'Escape') { e.preventDefault(); close() } } }),
+          h('div', { className: 'cdex-modal-actions' },
+            h('button', { className: 'cdex-btn-ghost', onClick: close }, '取消'),
+            h('button', { className: 'cdex-btn', onClick: confirm }, d.mode === 'rename' ? '重命名' : '创建'),
+          ),
+        ),
+      )
+    }
+    // 危险操作确认弹窗（删除等）
+    function ConfirmBox() {
+      const st = useStore()
+      const d = st.confirmBox
+      if (!d) return null
+      const close = () => { st.confirmBox = null; emit() }
+      const ok = async () => { const fn = d.onOk; close(); if (typeof fn === 'function') { try { await fn() } catch (e) {} } }
+      return h('div', { className: 'cdex-modal', onClick: close },
+        h('div', { className: 'cdex-modal-box', onClick: (e) => e.stopPropagation() },
+          h('div', { className: 'cdex-modal-title' }, '⚠ 确认操作'),
+          h('div', { className: 'cdex-confirm-msg' }, d.msg),
+          h('div', { className: 'cdex-modal-actions' },
+            h('button', { className: 'cdex-btn-ghost', onClick: close }, '取消'),
+            h('button', { className: 'cdex-btn cdex-btn-danger', onClick: ok }, '确定'),
+          ),
+        ),
+      )
+    }
     let noteTa = null
     function NoteEditor() {
       const st = useStore()
@@ -1243,7 +1519,9 @@ window.__ModuleLoader__.load({
         st.filePickerOpen ? h(FilePicker) : null,
         st.ctxMenu ? h(ContextMenu) : null,
         st.noteEditor ? h(NoteEditor) : null,
-        st.toast ? h('div', { className: 'cdex-toast' }, st.toast.msg) : null,
+        st.nameDialog ? h(NameDialog) : null,
+        st.confirmBox ? h(ConfirmBox) : null,
+        st.toast ? h(Toast) : null,
       )
     }
 
@@ -1355,7 +1633,9 @@ window.__ModuleLoader__.load({
         st.filePickerOpen ? h(FilePicker) : null,
         st.ctxMenu ? h(ContextMenu) : null,
         st.noteEditor ? h(NoteEditor) : null,
-        st.toast ? h('div', { className: 'cdex-toast' }, st.toast.msg) : null,
+        st.nameDialog ? h(NameDialog) : null,
+        st.confirmBox ? h(ConfirmBox) : null,
+        st.toast ? h(Toast) : null,
       )
     }
 
@@ -1464,8 +1744,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)
@@ -1486,36 +1765,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 持久化；成功后立即换一种切换按钮
@@ -1597,6 +1886,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)
@@ -1652,37 +1943,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' },
@@ -1712,14 +1991,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

@@ -7,7 +7,7 @@ import { defineTool } from "@deepseek-ai/dsh-tools";
 import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
 import z from "@deepseek-ai/schemastery";
 import { spawn } from "node:child_process";
-import { existsSync, readFileSync, watch } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, watch, writeFileSync } from "node:fs";
 import { dirname, isAbsolute, join } from "node:path";
 import { fileURLToPath } from "node:url";
 
@@ -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"),
+  // 界面模式：native(隐藏编辑器,默认——新装不自动占屏,由 ⌨ 按钮唤出) / codeui(显示编辑器)
+  uiMode: z.string().default("native"),
   // 切换按钮样式：header(会话头 ⌨ 按钮,默认) / bar(悬浮模式条)
   toggle: z.string().default("header"),
 });
 // 解析后的当前值：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: "header" };
 // settings 服务引用（「启用/禁用」开关写入用；由 installSelfSettings 捕获）
 let settingsServiceRef = null;
 function installSelfSettings(ctx) {
@@ -473,6 +473,74 @@ function rpcHandler(ctx) {
         return ok({ events: events });
       }
 
+      // —— 文件树磁盘操作（真实文件系统，右键菜单用） ——
+      if (endpoint === "fs-mkdir") {
+        if (!args.path) return ok({ error: "no-path" });
+        try {
+          mkdirSync(args.path, { recursive: true });
+          return ok({ ok: true, path: args.path });
+        } catch (err) {
+          return ok({ error: "创建目录失败：" + ((err && err.message) || String(err)) });
+        }
+      }
+
+      if (endpoint === "fs-createfile") {
+        if (!args.path) return ok({ error: "no-path" });
+        if (existsSync(args.path)) return ok({ error: "已存在同名文件/目录" });
+        try {
+          writeSuppress.set(args.path, Date.now() + 1500);
+          writeFileSync(args.path, "", "utf8");
+          return ok({ ok: true, path: args.path });
+        } catch (err) {
+          return ok({ error: "创建文件失败：" + ((err && err.message) || String(err)) });
+        }
+      }
+
+      if (endpoint === "fs-rename") {
+        if (!args.from || !args.to) return ok({ error: "需要 from 与 to 路径" });
+        if (!existsSync(args.from)) return ok({ error: "源路径不存在" });
+        if (existsSync(args.to)) return ok({ error: "目标已存在同名文件/目录" });
+        try {
+          // 若重命名的正是被监听的文件：停掉旧 watcher（客户端重开时会按新路径重新 watch）
+          unwatchFilePath(args.from);
+          writeSuppress.set(args.from, Date.now() + 1500);
+          renameSync(args.from, args.to);
+          return ok({ ok: true, from: args.from, to: args.to });
+        } catch (err) {
+          return ok({ error: "重命名失败：" + ((err && err.message) || String(err)) });
+        }
+      }
+
+      if (endpoint === "fs-delete") {
+        if (!args.path) return ok({ error: "no-path" });
+        if (!existsSync(args.path)) return ok({ error: "路径不存在" });
+        try {
+          // 被监听的文件被删除：停 watcher + 抑制回声事件
+          if (fileWatchers.has(args.path)) unwatchFilePath(args.path);
+          writeSuppress.set(args.path, Date.now() + 1500);
+          rmSync(args.path, { recursive: !!args.recursive, force: false });
+          return ok({ ok: true });
+        } catch (err) {
+          return ok({ error: "删除失败：" + ((err && err.message) || String(err)) });
+        }
+      }
+
+      if (endpoint === "fs-reveal") {
+        if (!args.path) return ok({ error: "no-path" });
+        try {
+          if (process.platform === "win32") {
+            spawn("explorer", ["/select," + args.path], { detached: true, stdio: "ignore" }).unref();
+          } else if (process.platform === "darwin") {
+            spawn("open", ["-R", args.path], { detached: true, stdio: "ignore" }).unref();
+          } else {
+            spawn("xdg-open", [dirname(args.path)], { detached: true, stdio: "ignore" }).unref();
+          }
+          return ok({ ok: true });
+        } catch (err) {
+          return ok({ error: "打开文件管理器失败：" + ((err && err.message) || String(err)) });
+        }
+      }
+
       if (endpoint === "add-reference") {
         const id = "r" + (idSeq++);
         const ref = {
@@ -691,7 +759,7 @@ function registerSnippetsTool(tools) {
     defineTool({
       name: "get_referenced_snippets",
       description:
-        "读取用户在代码编辑器中通过「引用/翻译」标记的代码片段（含文件路径、行号、语言与内容），供 AI 直接使用。当用户在对话框提到「我引用的代码」「翻译我引用的内容」时调用。",
+        "读取用户在代码编辑器中通过「引用/翻译」标记的代码片段（含文件路径、行号、语言与内容），供 AI 直接使用。文件树右键「引用给 AI」标记的整文件引用只含绝对路径，请用你自己的文件读取工具打开。当用户在对话框提到「我引用的代码」「翻译我引用的内容」时调用。",
       parameters: {
         kind: { type: "string", description: "筛选类型：cite(代码引用) / translate(翻译请求) / all(全部，默认)。" },
       },
@@ -702,10 +770,14 @@ function registerSnippetsTool(tools) {
           const refs = Array.isArray(v.references) ? v.references : [];
           if (refs.length === 0) return [{ type: "text", text: "当前没有已标记的代码片段。" }];
           const parts = refs.map((r) => {
-            const label = r.kind === "translate" ? "翻译请求" : "代码引用";
-            const loc = (r.path || "") + (r.lineStart ? ":" + r.lineStart + "-" + r.lineEnd : "");
+            const whole = !r.lineStart;
+            const label = r.kind === "translate" ? "翻译请求" : whole ? "文件引用" : "代码引用";
+            const loc = (r.path || "") + (whole ? "（整个文件）" : ":" + r.lineStart + "-" + r.lineEnd);
             const lang = r.language ? " [" + r.language + "]" : "";
-            return "【" + label + "】" + loc + lang + "\n" + (r.text || "");
+            const body = whole
+              ? "整个文件的引用：请用你的文件读取工具打开上述绝对路径自行读取。"
+              : (r.text || "");
+            return "【" + label + "】" + loc + lang + "\n" + body;
           });
           return [{ type: "text", text: "共 " + refs.length + " 条标记：\n\n" + parts.join("\n\n") }];
         },

package/package.json

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