dsh-vscode-mode 0.1.47 → 0.1.48

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.1.47",
+  "version": "0.1.48",
   "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（文件页签/QuickOpen/状态栏，可驻 dsh-better-sidebar 侧边栏与对话同屏）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚）+ 语言服务器（LSP）智能（跳转定义/引用/hover/大纲 + VSIX 扩展市场安装），状态持久化到工作区旁车",
   "keywords": [
     "dsh",

package/src/client/addToConversation.ts

@@ -15,6 +15,21 @@ export interface RefRange {
 /** 引用动作的返回状态。 */
 export type AddOutcome = 'ok' | 'busy' | 'unavailable'
 
+/** 引用外观类型：文件/文件夹（DSH reference source 均支持）。 */
+export type RefAppearance = 'file' | 'folder'
+
+/** 把追加引用结果映射为可读文案（ok 用 okText；busy 提示已降级纯文本；unavailable 提示不可用）。
+ * @author ddj 2026年09月03号
+ * @param outcome 追加结果状态
+ * @param okText 成功文案（如「已添加文件引用」/「已添加文件夹引用」）
+ * @returns 状态栏/通知用文案
+ */
+export function statusOfAdd(outcome: AddOutcome, okText: string): string {
+  if (outcome === 'ok') return okText
+  if (outcome === 'busy') return okText + '（输入框忙，已降级纯文本）'
+  return '无法添加到对话（无会话或输入框不可用）'
+}
+
 /** DSH reference source 名（dsh-client-ui-reference 注册的 @file/@session 统一源）。 */
 const REF_SOURCE = 'reference'
 
@@ -61,11 +76,17 @@ export function refOf(mention: string, range: RefRange | undefined): string {
     : `${mention} L${range.startLine}-${range.endLine}`
 }
 
-/** 构造 DSH 文件引用插入载荷（source=reference，发送序列化为 mention(+range) 文本）。 */
+/** 构造 DSH 文件引用插入载荷（source=reference，发送序列化为 mention(+range) 文本）。
+ * @param path 目标路径（相对 cwd 或绝对）
+ * @param cwd 会话工作区目录（可选）
+ * @param range 行区间（可选）
+ * @param appearance 引用外观：'file'（默认）| 'folder'
+ */
 export function buildFileRef(
   path: string,
   cwd: string | undefined,
   range?: RefRange,
+  appearance: RefAppearance = 'file',
 ): { reference: ReferenceInsertLike; mention: string } {
   const mention = mentionOf(path, cwd)
   return {
@@ -74,7 +95,7 @@ export function buildFileRef(
       source: REF_SOURCE,
       ref: refOf(mention, range),
       label: labelOf(path, range),
-      appearance: 'file',
+      appearance,
       clipboardText: mention,
     },
   }
@@ -85,7 +106,6 @@ export interface InputLike {
   state: { getSnapshot: () => { draft: string; draftRev: number } }
   insertReference: (ref: ReferenceInsertLike, span: TokenSpanLike) => boolean
   setDraft: (text: string) => void
-  notify: (level: 'info' | 'error', text: string) => void
 }
 
 /** ReferenceInsert 结构形状（与 dsh-client-ui-input-trigger 类型一致）。 */
@@ -111,8 +131,13 @@ export interface CtxLike {
 
 /** 注入器产物：给 EditorView 用的动作集合。 */
 export interface AddToConversation {
-  /** 追加文件引用 chip（@path [Lstart-end]）；忙态自动降级纯文本。 */
-  appendReference(sessionId: string | undefined, path: string, range?: RefRange): Promise<AddOutcome>
+  /** 追加文件/文件夹引用 chip（@path [Lstart-end]）；忙态自动降级纯文本。 */
+  appendReference(
+    sessionId: string | undefined,
+    path: string,
+    range?: RefRange,
+    appearance?: RefAppearance,
+  ): Promise<AddOutcome>
 }
 
 /**
@@ -161,16 +186,6 @@ function cwdOf(ctx: CtxLike, sessionId: string | undefined): string | undefined
   }
 }
 
-/** 写入成功后的 composer 内联提示（门面可用时；失败静默）。
- * @author ddj 2026年08月25号 */
-function notify(input: InputLike, text: string): void {
-  try {
-    input.notify?.('info', text)
-  } catch {
-    /* 提示失败忽略 */
-  }
-}
-
 /** 输入门面插入引用（拦截异常视作未应用，走降级）。
  * @author ddj 2026年08月25号 */
 function safeInsert(input: InputLike, reference: ReferenceInsertLike, span: TokenSpanLike): boolean {
@@ -188,22 +203,20 @@ function safeInsert(input: InputLike, reference: ReferenceInsertLike, span: Toke
  * @returns 动作集
  */
 export function createAddToConversation(ctx: CtxLike): AddToConversation {
-  const appendReference: AddToConversation['appendReference'] = async (sessionId, path, range) => {
+  const appendReference: AddToConversation['appendReference'] = async (sessionId, path, range, appearance) => {
     const input = inputFor(ctx, sessionId)
     if (!input) return 'unavailable'
     const cur = draftCursor(input)
     if (!cur) return 'unavailable'
-    const { reference, mention } = buildFileRef(path, cwdOf(ctx, sessionId), range)
+    const { reference, mention } = buildFileRef(path, cwdOf(ctx, sessionId), range, appearance)
     const span: TokenSpanLike = { start: cur.draft.length, end: cur.draft.length, draftRev: cur.draftRev }
     const ok = safeInsert(input, reference, span)
     if (!ok) {
       // 忙态（adjudicating/submitting）或 CAS 失败：降级纯文本追加，保证动作有落点。
       const gap = cur.draft.length > 0 && !/\s$/.test(cur.draft) ? ' ' : ''
       input.setDraft(cur.draft + gap + mention + ' ')
-      notify(input, '已添加文件引用 ' + mention)
       return 'busy'
     }
-    notify(input, '已添加文件引用 ' + mention)
     return 'ok'
   }
 

package/src/client/sidebar/menuItems.ts

@@ -1,10 +1,12 @@
 /**
  * dsh-vscode-mode client — 文件管理右键菜单内置项。
- * 首个内置项：「在文件浏览器中打开」（文件→OS Explorer 定位选中、目录→打开目录）。
+ * 内置项：「在文件浏览器中打开」（文件→OS Explorer 定位选中、目录→打开目录）；
+ * 「添加引用到对话」（文件/文件夹引用注入当前会话对话输入框）。
  * 反馈统一走 ctx.notify（由 EditorView 提供，落到编辑区路径栏状态）。
- * 作者 ddj 2026-08-27
+ * 作者 ddj 2026-08-27 / 2026-09-03
  */
 import { revealInExplorer } from '../fileReveal.js'
+import { statusOfAdd } from '../addToConversation.js'
 import type { TreeMenuItem } from './contextMenu.js'
 
 /**
@@ -24,5 +26,24 @@ export function createDefaultFileMenuItems(): TreeMenuItem[] {
         })
       },
     },
+    {
+      id: 'add-to-conversation',
+      label: '添加引用到对话',
+      order: 1,
+      // 排除根目录空白区（path==='' 无意义）、无会话、动作集缺失时隐藏
+      visible: (target, ctx) => Boolean(target.path && ctx.sessionId && ctx.addToConversation),
+      run: (target, ctx) => {
+        const isDir = target.type === 'directory'
+        const add = ctx.addToConversation
+        if (!add) {
+          ctx.notify?.('添加到对话不可用')
+          return
+        }
+        const okText = isDir ? '已添加文件夹引用' : '已添加文件引用'
+        void add.appendReference(ctx.sessionId, target.path, undefined, isDir ? 'folder' : 'file').then((outcome) => {
+          ctx.notify?.(statusOfAdd(outcome, okText))
+        })
+      },
+    },
   ]
 }

package/src/client/sidebar/panels/FileExplorer.ts

@@ -11,7 +11,6 @@
 import React from 'react'
 import { rpc } from '../../rpc.js'
 import { ContextMenu } from '../../ui/ContextMenu.js'
-import { rowMenuPosition } from '../../ui/menuPosition.js'
 import { buildTreeMenu } from '../contextMenu.js'
 import { explorerLoad, explorerSave } from '../../state/explorerCache.js'
 import { entriesCacheGet, entriesCacheIsFresh, entriesCachePut } from '../../state/explorerEntriesCache.js'
@@ -219,9 +218,8 @@ export function FileExplorer(props) {
       onContextMenu: (ev) => {
         ev.preventDefault()
         ev.stopPropagation()
-        const rect = ev.currentTarget?.getBoundingClientRect?.()
-        const position = rowMenuPosition(rect, ev.clientX, ev.clientY)
-        setMenu({ x: position.left, y: position.top, target: { path: e.path, type: e.type } })
+        // 菜单左上角对齐鼠标点击位置（视口坐标，ContextMenu 内再做 viewport clamp）
+        setMenu({ x: ev.clientX, y: ev.clientY, target: { path: e.path, type: e.type } })
       },
     },
       React.createElement('span', { className: 'edrv-tree-chev' },

package/src/client/sidebar/types.ts

@@ -4,6 +4,7 @@
  * 作者 ddj 2026-08-26
  */
 import type { OutlineSourceRegistry } from '../outline/types.js'
+import type { AddToConversation } from '../addToConversation.js'
 import type { TreeMenuRegistry } from './contextMenu.js'
 
 /** 面板可用的共享上下文（由 SidebarView 从 EditorView 注入，面板不直碰其内部）。 */
@@ -25,6 +26,8 @@ export interface SidebarCtx {
   outlineSources?: OutlineSourceRegistry
   /** 文件右键菜单项注册表（公开 provide 为 edrvFileContextMenuItems；文件管理面板构建菜单用）。 */
   fileMenuItems?: TreeMenuRegistry
+  /** 「添加到对话」动作集（文件/文件夹引用注入对话输入框；缺省时菜单项降级提示）。 */
+  addToConversation?: AddToConversation
   /** 面板动作反馈（如右键菜单操作结果 → 编辑区路径栏状态）。 */
   notify?: (message: string) => void
 }

package/src/client/ui/EditorView.ts

@@ -24,6 +24,7 @@ import { setSidePending, SIDEBAR_INSTALL_CMD } from '../sidebarBridge.js'
 import { upsertViewState, viewStatesLoad, viewStatesSave } from '../state/viewStateCache.js'
 import { bindingsOf, chordOf, matchEvent, useKeybindingsVersion } from '../keybindings.js'
 import { createNavHistory } from '../navHistory.js'
+import { statusOfAdd } from '../addToConversation.js'
 import { CACHE_KEY } from '../paths.js'
 import { bindLspEditor, runGoToDefinition, runFindReferences, hideReferencesOverlay } from '../monaco/lsp/providers.js'
 import { bindLspUnderline } from '../monaco/lsp/underline.js'
@@ -1119,15 +1120,7 @@ export function EditorView(props) {
     setTabMenu(null)
   }
 
-  /** 把「添加到对话」返回状态映射为状态栏文案。
-   * @author ddj 2026年08月25号 */
-  const statusOfAdd = (outcome, okText) => {
-    if (outcome === 'ok') return okText
-    if (outcome === 'busy') return okText + '（输入框忙，已降级纯文本）'
-    return '无法添加到对话（无会话或输入框不可用）'
-  }
-
-  /** 添加文件/选中区引用到对话（异步，状态栏反馈）。 */
+  /** 添加文件/选中区引用到对话（异步，状态栏反馈；状态文案走共享 statusOfAdd）。 */
   const addRefToChat = (path, range) => {
     if (!path) { setStatus('无活动文件'); return }
     if (!addToConversation) { setStatus('添加到对话不可用'); return }
@@ -1406,6 +1399,7 @@ export function EditorView(props) {
     editor: () => editorRef.current,
     outlineSources: props.outlineSources,
     fileMenuItems: props.fileMenuItems,
+    addToConversation,
     notify: (message) => setStatus(message),
   }
 

package/src/client/ui/menuPosition.ts

@@ -1,7 +1,7 @@
 /**
  * dsh-vscode-mode client — 右键菜单 viewport 定位纯函数。
- * 将目标行锚点与视口边界计算从 React 渲染层拆出，便于复用和单测。
- * 作者 ddj 2026-08-28
+ * 将视口边界 clamp 从 React 渲染层拆出，便于复用和单测。
+ * 作者 ddj 2026-08-28 / 2026-09-03
  */
 
 export interface MenuPosition {
@@ -9,13 +9,6 @@ export interface MenuPosition {
   top: number
 }
 
-export interface MenuAnchorRect {
-  top: number
-  right: number
-  width: number
-  height: number
-}
-
 /**
  * 将菜单坐标限制在 viewport 内。
  * @author ddj 2026年08月28号
@@ -42,22 +35,3 @@ export function clampMenuPosition(
     top: Math.max(4, Math.min(y, maxTop)),
   }
 }
-
-/**
- * 将文件树行右键菜单锚定到目标行右侧；无法测量时回退到鼠标坐标。
- * @author ddj 2026年08月28号
- * @param rect 目标行的布局矩形
- * @param fallbackX 鼠标 viewport x 坐标
- * @param fallbackY 鼠标 viewport y 坐标
- * @returns 菜单初始位置
- */
-export function rowMenuPosition(
-  rect: MenuAnchorRect | null | undefined,
-  fallbackX: number,
-  fallbackY: number,
-): MenuPosition {
-  if (!rect || rect.width <= 0 || rect.height <= 0) {
-    return { left: fallbackX, top: fallbackY }
-  }
-  return { left: rect.right + 4, top: rect.top }
-}