dsh-code-ui 1.2.0 → 1.3.0

package/README.md

@@ -99,6 +99,7 @@ npm publish
 
 | 时间 | 版本 | 修复 / 新增 |
 | --- | --- | --- |
+| 2026-09-02 | v1.3.0 | 里程碑：文件树右键操作（真实磁盘）。右键文件：打开 / 引用给 AI（整个文件）/ 复制路径 / 在资源管理器中显示 / 重命名 / 删除；右键文件夹：新建文件 / 新建文件夹 / 以此文件夹为根 / 刷新 / 复制路径 / 定位 / 重命名 / 删除（递归强确认）；空白区右键：根目录新建 / 刷新 / 更换根；新建重命名输入弹窗（Enter 确认）、危险操作确认弹窗、工作区根禁删；重命名自动同步标签页/缓冲/watcher，删除自动清理该路径下全部标签。引用体系升级：整文件引用只传绝对路径由 AI 自行读取；停靠布局下 DSH 原生输入条发送也自动附加引用指针（挂钩 submit，两布局统一）。打开文件弹窗：输入路径回车直接认定（文件夹=设为根 / 文件=打开）。右键菜单视口边界自适应、点击菜单项后自动关闭；⟳ 刷新不再折叠整棵树 |
 | 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;}
@@ -252,6 +257,8 @@ window.__ModuleLoader__.load({
       browsePath: null,
       browseEntries: [],
       ctxMenu: null,
+      nameDialog: null,
+      confirmBox: null,
       noteEditor: null,
       toast: null,
       error: null,
@@ -337,6 +344,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 +607,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 +726,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 +751,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 +883,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 +975,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 +988,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 +1028,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 +1091,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 +1114,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 +1126,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 +1160,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 +1178,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 +1187,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 +1317,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,6 +1470,8 @@ window.__ModuleLoader__.load({
         st.filePickerOpen ? h(FilePicker) : null,
         st.ctxMenu ? h(ContextMenu) : null,
         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,
       )
     }
@@ -1355,6 +1584,8 @@ window.__ModuleLoader__.load({
         st.filePickerOpen ? h(FilePicker) : null,
         st.ctxMenu ? h(ContextMenu) : null,
         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,
       )
     }

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";
 
@@ -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.0",
   "description": "Cursor 风格的 AI 代码编辑器工作台插件（DSH）：文件树、多标签页编辑、语法高亮、引用/翻译给 AI、右侧停靠/悬浮窗口双布局",
   "type": "module",
   "main": "lib/index.js",