dsh-vscode-mode 0.1.57 → 0.1.59

package/src/index.ts

@@ -3,7 +3,8 @@
  * 职责：装配 capture（tools/result 捕获 edit/write 差异）、RPC 分发（edrv.* / mcp.* / vscode.* / compat）、
  *       webServer 路由（/edrv/rpc、/edrv/assets/*、/edrv/vendor/*）、工作区旁车持久化、
  *       兼容层装配（依赖守卫 + 重复装配自诊断 + 启动日志兼容性报告）。
- * 结构：shared/（双面契约） + model/store/capture/workspace/revert/registry/rpc/routes/compat（host 模块）。
+ * 结构：shared/（双面契约） + model/store/capture/workspace/revert/registry/rpc/routes/compat（host 模块）
+ *       + log/debugLog（统一日志：bindHostLog 绑定 ctx.logger，edrv.debug 诊断文件通道）。
  * 作者 ddj 2026-08-20
  */
 import { registerRoutes } from './routes.js'
@@ -18,10 +19,12 @@ import { setupOpenSettings } from './fileOpenSettings.js'
 import { shellMenuLifecycle } from './integrate.js'
 import { disposeIndex } from './treeIndex.js'
 import { sweepTreeCache } from './paths.js'
-import { PLUGIN_NAME, buildReport } from './compat.js'
+import { buildReport } from './compat.js'
+import { bindHostLog, log } from './log.js'
 import { createLspManager } from './lsp/manager.js'
 import { createLspRpc } from './lsp/rpc.js'
 import { disposeAllServers } from './lsp/transport.js'
+import { createAiRpc } from './ai/rpc.js'
 import { installRulesSection } from './rules.js'
 import type { RpcHandlerMap } from './shared/rpc.js'
 import type { Registry } from './registry.js'
@@ -37,21 +40,27 @@ export const inject = ['sessions', 'fs', 'webServer', 'loader', 'tools', 'worksp
  * @param config 插件配置（可选 imageDir 覆盖图标目录）
  */
 export function apply(ctx: Ctx, config?: unknown): void {
+  // 统一日志出口：全部 host 日志经 ctx.logger（缺失时回退 console），此后任何模块 log.* 即生效
+  bindHostLog(ctx)
   const registry: Registry = new Map()
   const searcher = newSearcher(ctx)
   const contentSearcher = newContentSearcher(ctx)
-  /** LSP 服务器管理器（语言智能：跳转/引用/大纲）。 */
-  const lspManager = createLspManager((line) => ctx.logger?.debug?.('[' + name + '] ' + line))
+  /** LSP 服务器管理器（语言智能：跳转/引用/大纲；诊断行带模块内前缀如 [lsp-manager]）。 */
+  const lspManager = createLspManager((line) => log.debug(line))
   /** 兼容性警告收集（route 护栏等写入，启动日志一并输出）。 */
   const warnings: string[] = []
-  setupOpenSettings(ctx, config, () => {})
+  /** 设置状态（fileOpenTool + AI 补全配置读写；settings 不可用时内存态降级）。 */
+  const openSettings = setupOpenSettings(ctx, config, () => {})
   /** LSP 配置为配置值模式：插件组合配置 + 会话内运行时覆盖（原 settings section 命名空间不合法，见 lsp/config.ts）。 */
   /** 规则注入 section（~/.dsh/rules 与 <工作区>/.dsh/rules；旧版 DSH 无 systemPrompt 时静默降级）。 */
   const rulesInstalled = installRulesSection(ctx)
-  if (!rulesInstalled) ctx.logger?.warn?.('[' + name + '] 未检测到 systemPrompt 服务，规则仅可管理不注入')
+  if (!rulesInstalled) log.warn('未检测到 systemPrompt 服务，规则仅可管理不注入')
   /** LSP RPC 与会话清理（一次性创建，tracker 状态跨请求保留）。 */
   const lspRpc = createLspRpc({ ctx, pluginConfig: config, manager: lspManager })
   const lspHandlers: Partial<RpcHandlerMap> = lspRpc.handlers
+  /** AI 内联补全 RPC（settings 状态桥接 + llm 惰性获取）。 */
+  const aiRpc = createAiRpc({ ctx, settings: openSettings })
+  const aiHandlers: Partial<RpcHandlerMap> = aiRpc.handlers
 
   ctx.on('tools/result', (exec: unknown, result: unknown) => {
     void captureToolResult(ctx, registry, exec, result)
@@ -70,7 +79,7 @@ export function apply(ctx: Ctx, config?: unknown): void {
     if (typeof sid === 'string') lspRpc.disposeSession(sid)
   })
 
-  registerRoutes(ctx, config, (method, args) => handleRpc(ctx, registry, method, args, searcher, contentSearcher, lspHandlers), (warning) => warnings.push(warning))
+  registerRoutes(ctx, config, (method, args) => handleRpc(ctx, registry, method, args, searcher, contentSearcher, lspHandlers, aiHandlers), (warning) => warnings.push(warning))
   installIsolation(ctx)
   // 系统集成生命周期：启动自动恢复右键菜单注册（marker 存在时）；插件卸载/reload 清理注册痕迹
   ctx.effect(() => shellMenuLifecycle(ctx))
@@ -83,7 +92,7 @@ export function apply(ctx: Ctx, config?: unknown): void {
     disposeAllServers()
   })
 
-  ctx.logger?.info?.('[' + name + '] 编辑差异审查已装配（/edrv/rpc 路由就绪，项目 MCP 隔离已启用，语言服务器 LSP 已接入，规则注入' + (rulesInstalled ? '已接入' : '未接入') + '）')
+  log.info('编辑差异审查已装配（/edrv/rpc 路由就绪，项目 MCP 隔离已启用，语言服务器 LSP 已接入，规则注入' + (rulesInstalled ? '已接入' : '未接入') + '）')
 }
 
 /**
@@ -96,16 +105,14 @@ async function logCompatSummary(ctx: Ctx, warnings: string[]): Promise<void> {
   try {
     const report = await buildReport(ctx)
     for (const warning of warnings) report.warnings.push(warning)
-    const logger = ctx.logger
-    if (!logger?.info) return
     const dsh = report.dshVersion ? 'DSH ' + report.dshVersion : 'DSH 未探测'
-    const head = '[' + PLUGIN_NAME + '] 兼容性：' + dsh + ' · ' + report.external.length + ' 项外部适配 / ' + report.guards.length + ' 项护栏 / ' + (report.adapters?.length ?? 0) + ' 项版本适配'
+    const head = '兼容性：' + dsh + ' · ' + report.external.length + ' 项外部适配 / ' + report.guards.length + ' 项护栏 / ' + (report.adapters?.length ?? 0) + ' 项版本适配'
     if (report.warnings.length) {
-      logger.warn?.(head + '，警告 ' + report.warnings.length + ' 条：' + report.warnings.join('；'))
+      log.warn(head + '，警告 ' + report.warnings.length + ' 条：' + report.warnings.join('；'))
     } else {
-      logger.info?.(head + '，无警告')
+      log.info(head + '，无警告')
     }
   } catch (error) {
-    ctx.logger?.warn?.('[' + PLUGIN_NAME + '] 兼容性报告生成失败：' + String(error))
+    log.warn('兼容性报告生成失败：' + String(error))
   }
 }

package/src/log.ts

@@ -0,0 +1,19 @@
+/**
+ * dsh-vscode-mode host — 日志单例（全 host 面唯一日志入口）。
+ * 默认 console 出口；apply() 首行调 bindHostLog(ctx) 切到 ctx.logger（缺失回退 console）。
+ * 用法：`import { log } from './log.js'` → `log.debug/info/warn/error(msg)`；子域用 `log.child('scope')`。
+ * 作者 ddj 2026-09-08
+ */
+import { createLogger, ctxLogSink } from './shared/logger.js'
+
+/** host 面插件日志单例（格式/级别语义见 shared/logger.ts 头注释）。 */
+export const log = createLogger()
+
+/**
+ * 装配期绑定 host 日志出口：ctx.logger 可用时全部日志转经 DSH 日志系统。
+ * @author ddj 2026年09月08号
+ * @param ctx DSH host 上下文（logger 服务缺失时保持 console 出口）
+ */
+export function bindHostLog(ctx: unknown): void {
+  log.bind(ctxLogSink(ctx))
+}

package/src/mcpIsolation.ts

@@ -8,6 +8,7 @@ import { LEGACY_PROJECT_PREFIX, entryHash, isProjectEntryId } from './compat.js'
 import { entriesOf } from './mcp.js'
 import { hashWorkspace } from './mcpProject.js'
 import type { Ctx } from './store.js'
+import { log } from './log.js'
 
 const UNKNOWN_PROJECT = '__unknown_project__'
 
@@ -83,7 +84,7 @@ function syncAgent(ctx: Ctx, state: AgentState, agent: any, tools: ToolProjects)
     try {
       state.dispose = agent.ctx.tools.restrict({ deny: denied })
     } catch (error) {
-      ctx.logger?.warn?.('[dsh-vscode-mode] MCP agent restriction failed: ' + String(error))
+      log.warn('MCP agent restriction failed: ' + String(error))
       return
     }
   }

package/src/rpc.ts

@@ -43,84 +43,16 @@ import { findProfileDir, readDevForm, setDevForm } from './devForm.js'
 import { normalizeRel } from './tree.js'
 import { invalidateIndex, listDirCached } from './treeIndex.js'
 import { revealInExplorer } from './reveal.js'
-import { DEBUG_LOG, debugLogFile, dshHome, pluginLogRoot } from './paths.js'
+import { dshHome } from './paths.js'
+import { debugRecord } from './debugLog.js'
 import { markActiveSessions, moveOutSessions, planMoveOut, purgeArchive, restoreSession, scanSessionInventory, sessionsArchiveRoot, sessionSizeOf, sidecarSummaryOf } from './perf.js'
 import { patchHasPerfConfig, patchInsertPerfConfig, patchRemovePerfConfig, perfConfigBlock } from './perfPatch.js'
 
-/** cwd → 内存缓冲：行数组 + 累计字节数 + 待触发 flush 定时器（攒批落盘，避免每条日志全文件读改写）。 */
-const debugBuffers = new Map<string, { lines: string[]; len: number; timer: ReturnType<typeof setTimeout> | null }>()
-/** cwd → Promise 链：串行化 debug 日志落盘（fs read+write 非原子，避免并发丢行）。 */
-const debugWriteQueues = new Map<string, Promise<void>>()
-/** debug 日志单文件上限：超限截断保留尾部，防文件无限增长拖慢每次追加。 */
-const DEBUG_LOG_CAP = 512 * 1024
-/** debug 日志批量缓冲上限：攒满即落盘（一次读改写），上限内不逐条写文件。 */
-const DEBUG_BUF_CAP = 32 * 1024
-/** debug 日志空闲 flush 延迟：缓冲未满时，静默一段时间后落盘一次。 */
-const DEBUG_FLUSH_IDLE_MS = 1000
 /** cwd → 上次 stale 自动清理时间：全量轮询（EditorView/DiffBadge/Dock 各自 5s）节流，避免每轮都读文件算指纹。 */
 const staleCheckedAt = new Map<string, number>()
 /** stale 自动清理最小间隔。 */
 const STALE_CHECK_MIN_MS = 10_000
 
-/**
- * 调试日志入队：先攒内存缓冲（行 + 字节数），满 DEBUG_BUF_CAP 立即落盘，
- * 否则空闲 DEBUG_FLUSH_IDLE_MS 后落盘；落盘 = 读旧文件 + 追加整批 + 超限截断 + 一次写入。
- * @author ddj 2026年08月26号 / 2026年09月01号
- * @param ctx DSH 上下文
- * @param cwd 工作区（日志按 cwd hash 存 ~/.dsh/dsh-vscode-mode/logs/）
- * @param line 单条日志文本（不含换行）
- */
-function enqueueDebug(ctx: Ctx, cwd: string, line: string): void {
-  const st = debugBuffers.get(cwd) ?? { lines: [], len: 0, timer: null }
-  st.lines.push(line)
-  st.len += line.length
-  const flush = () => {
-    st.timer = null
-    const batch = st.lines
-    st.lines = []
-    st.len = 0
-    void flushDebug(cwd, batch)
-  }
-  if (st.len >= DEBUG_BUF_CAP) {
-    if (st.timer) clearTimeout(st.timer)
-    flush()
-  } else if (!st.timer) {
-    st.timer = setTimeout(flush, DEBUG_FLUSH_IDLE_MS)
-  }
-  debugBuffers.set(cwd, st)
-}
-
-/** cwd → 已清理旧工作区 debug 日志标记（一次性）。 */
-const debugLegacyCleaned = new Set<string>()
-
-/**
- * 批量落盘一条 debug 日志缓冲：读旧文件 → 追加 → 超上限截断保留尾部 → 一次写回。
- * 串行链保证同一 cwd 的读改写不交错丢行；写失败静默忽略（调试日志不阻塞业务）。
- * @author ddj 2026年08月26号 / 2026年09月01号
- * @param cwd 工作区（日志落 ~/.dsh/dsh-vscode-mode/logs/debug.<cwdHash>.log）
- * @param batch 本批日志行
- */
-function flushDebug(cwd: string, batch: string[]): Promise<void> {
-  const prev = debugWriteQueues.get(cwd) ?? Promise.resolve()
-  const task = prev.then(async () => {
-    try {
-      await mkdir(pluginLogRoot(), { recursive: true })
-      const target = debugLogFile(cwd)
-      const old = await readFile(target, 'utf8').catch(() => '')
-      const appended = old + batch.map((l) => new Date().toISOString() + ' ' + l + '\n').join('')
-      const next = appended.length > DEBUG_LOG_CAP ? appended.slice(-Math.floor(DEBUG_LOG_CAP / 2)) : appended
-      await writeFile(target, next, 'utf8')
-      // 迁移后一次性清理旧工作区 debug 日志（best-effort）
-      if (!debugLegacyCleaned.has(cwd)) {
-        debugLegacyCleaned.add(cwd)
-        await rm(join(cwd, DEBUG_LOG), { force: true }).catch(() => {})
-      }
-    } catch (e) { /* 写日志失败忽略 */ }
-  })
-  debugWriteQueues.set(cwd, task)
-  return task
-}
-
 /** 记录 → 客户端视图（不含 before 全文，仅长度）。 */
 function recView(record: DiffRecord): RecordView {
   return {
@@ -268,10 +200,13 @@ export function buildHandlers(
   searcher = newSearcher(ctx),
   contentSearcher = newContentSearcher(ctx),
   lspHandlers?: Partial<RpcHandlerMap>,
+  aiHandlers?: Partial<RpcHandlerMap>,
 ): RpcHandlerMap {
   return {
     // edrv.lsp.* 由 createLspRpc 一次性提供（tracker 跨请求保留），这里并入。
     ...((lspHandlers ?? {}) as RpcHandlerMap),
+    // edrv.ai.* 由 createAiRpc 提供（AI 内联补全/模型目录/配置读写），这里并入。
+    ...((aiHandlers ?? {}) as RpcHandlerMap),
     'edrv.list': async (args) => {
       const sc = await requireSession(ctx, args.sessionId)
       if ('err' in sc) return { ok: false, error: sc.err }
@@ -478,13 +413,11 @@ export function buildHandlers(
       return { ok: true, path: args.path, batch: batch ?? null }
     },
     'edrv.debug': async (args) => {
-      // 诊断日志：client 上报 → 内存缓冲批量落盘 .dsh-edit-review-debug.log（console 不一定落盘，文件可靠）。
-      // 只出现在调试开关开启时（client dbg 默认关），终端仍逐条打印便于实时观察。
+      // 诊断日志：client 上报 → debugLog 模块缓冲批量落盘 ~/.dsh/dsh-vscode-mode/logs/
+      // （console 不一定落盘，文件可靠）。只出现在调试开关开启时（client dbg 默认关）。
       const sc = await requireSession(ctx, args.sessionId)
       if ('err' in sc) return { ok: false, error: sc.err }
-      const text = String(args.text ?? '')
-      enqueueDebug(ctx, sc.cwd, text)
-      console.error('[edrv-debug] ' + text)
+      debugRecord(ctx, sc.cwd, String(args.text ?? ''))
       return { ok: true }
     },
     'edrv.searchFiles': async (args) => {
@@ -852,8 +785,9 @@ export async function handleRpc<M extends RpcMethod>(
   searcher = newSearcher(ctx),
   contentSearcher = newContentSearcher(ctx),
   lspHandlers?: Partial<RpcHandlerMap>,
+  aiHandlers?: Partial<RpcHandlerMap>,
 ): Promise<RpcResult<M>> {
-  const handlers = buildHandlers(ctx, registry, searcher, contentSearcher, lspHandlers)
+  const handlers = buildHandlers(ctx, registry, searcher, contentSearcher, lspHandlers, aiHandlers)
   const handler = handlers[method]
   if (!handler) return { ok: false, error: '未知方法: ' + String(method) } as RpcResult<M>
   return handler(args)

package/src/shared/ai.ts

@@ -0,0 +1,158 @@
+/**
+ * dsh-vscode-mode shared — AI 内联补全契约与纯函数（双面，禁 node/react）。
+ * 只放"过 RPC 的载荷形状"与无副作用变换：窗口裁剪、prompt 拼装、输出清理。
+ * host 与语言模型之间的流式交互在 host 侧 src/ai/inline.ts。
+ * 作者 ddj
+ */
+
+/** 上下文窗口：前缀字符上限（含未保存编辑的当前文档）。 */
+export const AI_PREFIX_MAX = 2000
+/** 上下文窗口：后缀字符上限（光标之后不参与补全语义的部分）。 */
+export const AI_SUFFIX_MAX = 500
+/** 触发门槛：前缀至少 4 个字符才请求（省掉空转调用）。 */
+export const AI_MIN_PREFIX = 4
+/** 单次补全输出上限（token 预算 + 行数双约束，早停兜底）。 */
+export const AI_MAX_TOKENS = 120
+/** 输出行数上限：超过即截断（ghost text 太长不可用）。 */
+export const AI_MAX_LINES = 3
+/** 流式早停：已收字符数达到该值即 abort（省尾部延迟）。 */
+export const AI_EARLY_STOP_CHARS = 300
+/** 补全请求超时（毫秒）：codebuddy CLI 网关实测 TTFT 3.5~8.4s 抖动（debug 实证），
+ *  12s 内无任何 token 即放弃；token 一到仍按行数/字符早停。 */
+export const AI_TIMEOUT_MS = 12000
+
+/** client → host 的补全请求载荷。 */
+export interface AiInlineRequest {
+  /** 当前文档工作区相对路径（语言提示用）。 */
+  path: string
+  /** 光标前文本（client 已裁剪到 AI_PREFIX_MAX）。 */
+  prefix: string
+  /** 光标后文本（client 已裁剪到 AI_SUFFIX_MAX）。 */
+  suffix: string
+}
+
+/** host → client 的补全结果（text 为空 = 无建议）。 */
+export interface AiInlineResult {
+  /** 建议插入文本（已清理：剥围栏/截行数/去重复）。 */
+  text: string
+  /** 失败原因（ok:false 或 text 为空时的诊断文案，供状态栏展示）。 */
+  note?: string
+}
+
+/** 模型目录条目（含该模型的思考档位元数据）。 */
+export interface AiModelEntry {
+  provider: string
+  model: string
+  name: string
+  /** 无 reasoning 元数据 = 空数组（UI 隐藏档位选择器）。 */
+  efforts: Array<{ id: string; name: string }>
+  /** 模型默认档位 id（无则空）。 */
+  defaultEffort: string
+}
+
+/** 模型目录视图（edrv.ai.models 载荷）。 */
+export interface AiDirectoryView {
+  providers: Array<{ id: string; name: string; models: AiModelEntry[] }>
+  /** 目录不可用原因（llm 服务缺失等；ok:false 时亦有 error，此为软降级说明）。 */
+  note?: string
+}
+
+/** AI 补全配置视图（edrv.ai.configGet 载荷）。 */
+export interface AiConfigView {
+  enabled: boolean
+  /** 空 = 自动选首个 provider/model。 */
+  provider: string
+  /** 空 = 自动选该 provider 首个模型。 */
+  model: string
+  /** 空 = 跟随模型默认（请求不携带 reasoningEffort）。 */
+  effort: string
+}
+
+/** AI 补全配置更新载荷（edrv.ai.configUpdate）。 */
+export interface AiConfigPatch {
+  enabled?: boolean
+  provider?: string
+  model?: string
+  /** 空 = 清除（跟随默认）。 */
+  effort?: string
+}
+
+/**
+ * 按 AI_PREFIX_MAX/AI_SUFFIX_MAX 裁剪前后缀（client 侧发请求前调用）。
+ * @author ddj
+ * @param prefix 光标前全文
+ * @param suffix 光标后全文
+ * @returns 裁剪后的窗口
+ */
+export function trimInlineWindow(prefix: string, suffix: string): { prefix: string; suffix: string } {
+  const pre = typeof prefix === 'string' ? prefix : ''
+  const suf = typeof suffix === 'string' ? suffix : ''
+  return {
+    prefix: pre.length > AI_PREFIX_MAX ? pre.slice(pre.length - AI_PREFIX_MAX) : pre,
+    suffix: suf.length > AI_SUFFIX_MAX ? suf.slice(0, AI_SUFFIX_MAX) : suf,
+  }
+}
+
+/**
+ * 是否值得发起补全请求：前缀达标且非纯空白（空行/行首不请求）。
+ * @author ddj
+ * @param prefix 光标前文本
+ * @returns 是否可请求
+ */
+export function inlineWorth(prefix: string): boolean {
+  const pre = typeof prefix === 'string' ? prefix : ''
+  if (pre.length < AI_MIN_PREFIX) return false
+  // 只拦"整体无内容"（纯空白）；结尾空白（如 `local a = `）是最自然的补全触发
+  // 形态，必须放行——原尾字符守卫把这类场景全数拦截（debug 实证 H4）
+  return pre.trim().length > 0
+}
+
+/**
+ * 拼装补全 user 消息文本：语言/文件名 + 前缀 + 补全点标记 + 后缀。
+ * host 侧与单测共用，保证请求形状一致。
+ * @author ddj
+ * @param req 补全请求（已裁剪）
+ * @returns 用户消息文本
+ */
+export function buildInlinePrompt(req: AiInlineRequest): string {
+  const name = String(req.path || '').split(/[\\/]/).pop() || 'untitled'
+  return [
+    '文件：' + name,
+    '现有代码（光标位于 <CURSOR> 标记处）：',
+    req.prefix + '<CURSOR>' + req.suffix,
+  ].join('\n')
+}
+
+/** 补全 system 提示词：硬约束输出形态（只给插入文本）。 */
+export const AI_INLINE_SYSTEM =
+  '你是代码自动补全引擎。只输出应插入 <CURSOR> 处的代码文本：' +
+  '禁止任何解释、注释性语句、markdown 代码围栏或对原文的复述；' +
+  '最多 ' + AI_MAX_LINES + ' 行，从光标处自然衔接前文，不要重复前缀已有内容；' +
+  '无法给出高置信度补全时输出空文本。'
+
+/**
+ * 清理模型输出：剥 markdown 围栏、剥对 <CURSOR> 标记的复述、按行数截断、去首尾空行。
+ * 产出空文本的判定也在这里（纯函数，单测覆盖）。
+ * @author ddj
+ * @param raw 模型原始输出
+ * @param prefix 请求时的前缀（复述检测）
+ * @returns 清理后的插入文本（可能为空串）
+ */
+export function cleanInlineText(raw: string, prefix: string): string {
+  let text = typeof raw === 'string' ? raw : ''
+  if (!text) return ''
+  // markdown 围栏剥离（```lang … ``` 或 ```…```）
+  const fenced = /^```[^\n]*\n([\s\S]*?)\n?```$/.exec(text.trim())
+  if (fenced) text = fenced[1] ?? ''
+  // 模型复述了标记本身：取标记之后的部分
+  const cursorAt = text.indexOf('<CURSOR>')
+  if (cursorAt >= 0) text = text.slice(cursorAt + '<CURSOR>'.length)
+  // 整体就是前缀结尾片段的复述：剥掉（防"从行首重抄一遍"类退化输出）
+  const tailPrefix = prefix.length > 0 ? prefix.slice(-40) : ''
+  if (tailPrefix && text.startsWith(tailPrefix)) text = text.slice(tailPrefix.length)
+  // 行数截断 + 行尾空白清理
+  const lines = text.split('\n').slice(0, AI_MAX_LINES).map((l) => l.replace(/\s+$/, ''))
+  while (lines.length > 0 && lines[0] === '') lines.shift()
+  while (lines.length > 0 && lines[lines.length - 1] === '') lines.pop()
+  return lines.join('\n')
+}

package/src/shared/diff.ts

@@ -53,6 +53,24 @@ export function isNoopHunk(hunk: Hunk | null | undefined): boolean {
   return !!hunk && hunk.oldText !== null && hunk.oldText === hunk.newText
 }
 
+/**
+ * 差异比较口径归一化：剥离 UTF-8 BOM、统一 CRLF 为 LF。
+ * 背景：外部工具（pwsh/编辑器）可能改变 BOM/行尾，导致 after 指纹与 hunk
+ * 定位在内容语义未变的情况下误报 conflict，把待确认修改从 UI 排除。
+ * @author ddj 2026年09月09号
+ */
+export function normalizeForCompare(text: string): string {
+  return text.replace(/^\uFEFF/, '').replace(/\r\n/g, '\n')
+}
+
+/** 归一化一个 hunk 的两侧文本（与 normalizeForCompare 同口径）。 */
+export function normalizeHunk(hunk: Hunk): Hunk {
+  return {
+    oldText: hunk.oldText === null ? null : normalizeForCompare(hunk.oldText),
+    newText: normalizeForCompare(hunk.newText),
+  }
+}
+
 /** splitLines 的空文本语义：真实空文件没有一行变更内容。 */
 export function splitLines(text: string): string[] {
   return text.length ? text.split('\n') : []

package/src/shared/logger.ts

@@ -0,0 +1,114 @@
+/**
+ * dsh-vscode-mode — 统一日志核心（双面共享，平台中立）。
+ * 输出规范：
+ * - 格式：`[dsh-vscode-mode][:scope] 消息`；前缀只在模块内部拼接，业务代码禁止手写前缀
+ * - 级别语义：debug=诊断明细 / info=装配与路由里程碑 / warn=降级与兼容回退 / error=失败
+ * - 出口：host 面经 bindHostLog(ctx) 绑定 ctx.logger（缺失回退 console）；client 面固定 console
+ * - 诊断文件通道（edrv.debug → ~/.dsh/dsh-vscode-mode/logs/）见 debugLog.ts，与本模块前缀共用
+ * 新增日志一律 `import { log } from '../log.js'`（client 为 './log.js'）后调 log.debug/info/warn/error；
+ * 子域日志用 log.child('scope')，禁止另起 console。
+ * 作者 ddj 2026-09-08
+ */
+
+/** 插件统一日志前缀（与包安装名一致）。 */
+export const LOG_PREFIX = '[dsh-vscode-mode]'
+
+/** 日志级别（与 console 方法名对齐）。 */
+export type LoggerLevel = 'debug' | 'info' | 'warn' | 'error'
+
+/** 日志出口：接收拼好前缀的整行（host 面接 ctx.logger，client 面接 console）。 */
+export type LoggerSink = (level: LoggerLevel, line: string) => void
+
+/** 默认级别到 console 方法名的映射。 */
+const CONSOLE_METHODS: Record<LoggerLevel, string> = { debug: 'debug', info: 'info', warn: 'warn', error: 'error' }
+
+/**
+ * 默认出口：console（级别直映方法；方法缺失时静默丢弃，不抛错）。
+ * @author ddj 2026年09月08号
+ * @returns console 出口
+ */
+export function consoleSink(): LoggerSink {
+  return (level, line) => {
+    const emit = (console as unknown as Record<string, unknown>)[CONSOLE_METHODS[level]]
+    if (typeof emit === 'function') (emit as (message: string) => void).call(console, line)
+  }
+}
+
+/**
+ * DSH host 出口工厂：转接 ctx.logger（方法级可选调用，缺服务/缺方法回退 console）。
+ * @author ddj 2026年09月08号
+ * @param ctx DSH host 上下文
+ * @returns 日志出口
+ */
+export function ctxLogSink(ctx: unknown): LoggerSink {
+  const base = consoleSink()
+  return (level, line) => {
+    const logger = (ctx as { logger?: Record<string, unknown> } | null | undefined)?.logger
+    const emit = logger?.[level]
+    if (typeof emit === 'function') (emit as (message: string) => void).call(logger, line)
+    else base(level, line)
+  }
+}
+
+/**
+ * 拼一行日志：`[dsh-vscode-mode][:scope] 消息`（scope 为空省略冒号段）。
+ * @author ddj 2026年09月08号
+ * @param scope 子域（可空）
+ * @param message 消息文本
+ * @returns 整行文本
+ */
+export function formatLine(scope: string, message: string): string {
+  const text = String(message)
+  return scope ? LOG_PREFIX + ':' + scope + ' ' + text : LOG_PREFIX + ' ' + text
+}
+
+/** 日志器实例（四级别统一入口 + 换出口/派生子域）。 */
+export interface PluginLogger {
+  debug(message: string): void
+  info(message: string): void
+  warn(message: string): void
+  error(message: string): void
+  /** 更换出口（同一实例树共享，host 装配期绑定 ctx.logger 用；client 单例不调用）。 */
+  bind(sink: LoggerSink): void
+  /** 派生带子域前缀的新实例（共享出口，如 log.child('debug') → `[dsh-vscode-mode:debug]`）。 */
+  child(scope: string): PluginLogger
+}
+
+/** 实例树共享的出口状态（bind 换出口对整棵树生效）。 */
+interface SinkState {
+  sink: LoggerSink
+}
+
+/**
+ * 日志器工厂（内部）：emit 时读共享出口状态，保证父 bind 后子实例跟随。
+ * @author ddj 2026年09月08号
+ * @param state 共享出口状态
+ * @param scope 子域文本（可空）
+ * @returns 日志器
+ */
+function makeLogger(state: SinkState, scope: string): PluginLogger {
+  const emit = (level: LoggerLevel, message: string): void => state.sink(level, formatLine(scope, message))
+  return {
+    debug: (message) => emit('debug', message),
+    info: (message) => emit('info', message),
+    warn: (message) => emit('warn', message),
+    error: (message) => emit('error', message),
+    bind(next: LoggerSink): void {
+      state.sink = next
+    },
+    child(next: string): PluginLogger {
+      return makeLogger(state, scope ? scope + '.' + next : next)
+    },
+  }
+}
+
+/**
+ * 创建插件日志器（默认 console 出口；host 面单例由 bindHostLog 换到 ctx.logger）。
+ * @author ddj 2026年09月08号
+ * @param sink 初始出口（缺省 console）
+ * @param scope 初始子域（业务方一般经 child 派生，不直接传）
+ * @returns 日志器
+ */
+export function createLogger(sink: LoggerSink = consoleSink(), scope = ''): PluginLogger {
+  return makeLogger({ sink }, scope)
+}

package/src/shared/rpc.ts

@@ -17,6 +17,7 @@ import type { CompatReport, DevFormInfo } from './compat.js'
 import type { ShellIntegrationStatus, UnityListPayload, UnityProjectEntry } from './integration.js'
 import type { RuleInfo, RuleProject, RuleRefInput, RuleSaveInput } from './rules.js'
 import type { LspEnvInstallState, LspExtInfo, LspExtUpdate, LspHover, LspLocation, LspMarketItem, LspPosition, LspSemanticTokens, LspServerStatus, LspSymbol } from './lsp.js'
+import type { AiConfigPatch, AiConfigView, AiDirectoryView, AiInlineRequest, AiInlineResult } from './ai.js'
 
 /** webServer 精确路由。 */
 export const RPC_PATH = '/edrv/rpc'
@@ -216,6 +217,10 @@ export interface RpcRequestMap {
   'edrv.lsp.ext.update': { id: string }
   'edrv.lsp.ext.updates': {}
   'edrv.lsp.ext.market': { query: string; size?: number }
+  'edrv.ai.inline': AiInlineRequest
+  'edrv.ai.models': { force?: boolean }
+  'edrv.ai.configGet': {}
+  'edrv.ai.configUpdate': AiConfigPatch
   'edrv.perf.inventory': { sessionId?: string }
   'edrv.perf.sessionSize': { sessionId?: string; cwd: string }
   'edrv.perf.movePlan': { workspaceKey?: string; sessionIds?: string[]; minBytes?: number; olderThanDays?: number }
@@ -300,6 +305,10 @@ export interface RpcOkMap {
   'edrv.lsp.ext.update': { extension: LspExtInfo; updated: boolean }
   'edrv.lsp.ext.updates': { updates: LspExtUpdate[] }
   'edrv.lsp.ext.market': { extensions: LspMarketItem[] }
+  'edrv.ai.inline': AiInlineResult
+  'edrv.ai.models': AiDirectoryView
+  'edrv.ai.configGet': AiConfigView
+  'edrv.ai.configUpdate': AiConfigView
   'edrv.perf.inventory': { workspaces: PerfWorkspace[]; sessions: PerfSession[]; totals: PerfTotals; activeIds: string[] }
   'edrv.perf.sessionSize': { bytes: number; exists: boolean }
   'edrv.perf.movePlan': { items: PerfMoveItem[]; reclaimedBytes: number }

package/src/store.ts

@@ -5,9 +5,10 @@
  */
 import type { ArchiveBatch, ArchiveData, DiffRecord, SidecarData } from './shared/types.js'
 import type { ReadState } from './shared/diff.js'
-import { fingerprint, isNoopHunk, locateHunks, preciseHunk } from './shared/diff.js'
+import { fingerprint, isNoopHunk, locateHunks, normalizeForCompare, normalizeHunk, preciseHunk } from './shared/diff.js'
 import { archiveEntryFor, groupByBatch, normalizeRecord } from './model.js'
 import { SIDECAR, SIDECAR_ARCHIVE } from './paths.js'
+import { log } from './log.js'
 
 export { SIDECAR, SIDECAR_ARCHIVE }
 export const READ_CAP = 8 * 1024 * 1024
@@ -100,7 +101,7 @@ export async function saveBucket(ctx: Ctx, cwd: string, recsMap: Map<string, Dif
     existing.updatedAt = new Date().toISOString()
     await fs.writeText(target, JSON.stringify(existing), void 0, void 0, policyOf(ctx, session))
   } catch (error) {
-    console.error('edrv saveBucket failed', error)
+    log.error('saveBucket failed: ' + String(error))
   }
 }
 
@@ -146,7 +147,10 @@ export async function recordIsStale(ctx: Ctx, session: Session, cache: Map<strin
   if (!pending.length) return true
   const currentFingerprint = fingerprint(state.content)
   if (rec.afterFingerprint && currentFingerprint === rec.afterFingerprint) { rec.conflict = false; return false }
-  const locations = locateHunks(state.content, pending.map((item) => item.hunk!))
+  // 归一化口径对比：外部工具可能改变 BOM/行尾，内容语义未变不应判冲突
+  const normalizedContent = normalizeForCompare(state.content)
+  if (rec.after != null && fingerprint(normalizeForCompare(rec.after)) === fingerprint(normalizedContent)) { rec.conflict = false; return false }
+  const locations = locateHunks(normalizedContent, pending.map((item) => normalizeHunk(item.hunk!)))
   if (locations.some((location) => location.matched)) { rec.conflict = false; return false }
   rec.conflict = true
   return false
@@ -221,7 +225,7 @@ export async function appendArchiveEntries(ctx: Ctx, cwd: string, entries: Array
     const data: ArchiveData = { version: 1, updatedAt: new Date().toISOString(), batches: existing }
     await fs.writeText(target, JSON.stringify(data), void 0, void 0, policyOf(ctx, session))
   } catch (error) {
-    console.error('edrv appendArchiveEntries failed', error)
+    log.error('appendArchiveEntries failed: ' + String(error))
   }
 }
 

package/src/workspace.ts

@@ -5,6 +5,7 @@
  */
 import type { Ctx, Session } from './store.js'
 import { policyOf } from './store.js'
+import { log } from './log.js'
 
 /** 文件清单缓存 TTL 与扫描上限（避免大工作区反复全量扫描）。 */
 const FILE_INDEX_TTL = 60_000
@@ -60,7 +61,7 @@ export async function listWorkspaceFiles(ctx: Ctx, session: Session, cwd: string
       await run(['/bin/sh', '-c', cmd])
     }
   } catch (error) {
-    console.error('edrv scan failed', error)
+    log.error('scan failed: ' + String(error))
     return null
   }
   const files = lines.slice(0, SCAN_CAP)