dsh-code-server-app 0.2.14 → 0.3.6

package/assets/extensions/dshcs-editor-bridge/lib/bridge-client.js

@@ -0,0 +1,241 @@
+// dshcs-editor-bridge / lib/bridge-client.js —— 纯逻辑:读配置、与 host 同步
+//
+// 这个文件**不 require('vscode')**,所以能在没有 VS Code 的环境里单测
+// (scripts/test-bridge-extension.mjs 就是这么用的)。与编辑器交互的部分在
+// lib/context-model.js(纯数据投影)与 extension.js(glue)里。
+//
+// 三条通道里属于扩展的两条:
+//   1. 读 `<extensionsDir>/.dshcs-bridge/bridge.json` —— host 写,扩展**每次请求前重读**
+//      (host 重启会让端口与令牌轮换,而 IDE 进程可能被 adopt 继续活着,env 方案跟不上);
+//   2. `POST /api/code-server/bridge/sync?since=N` —— **一趟来回同时做两件事**:
+//      把编辑器状态(活动文件/脏缓冲区/诊断)推给 host,并取回 host 推来的 agent 改动提示。
+//      为什么合并:扩展宿主里没有 HTTP 服务器,host 反向请求不到它,状态只能由扩展推上来;
+//      而轮询本来就在跑,合并成一个请求就省掉了第二个定时器与一次往返。
+//      带着 x-dshcs-bridge-token 头。
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+/** 与 host 侧 lib/bridge.mjs 的常量保持一致(改动必须两边同步;scripts/test-bridge-extension.mjs
+ *  里有一条一致性断言,会把两边的字面量放在一起比)。 */
+const BRIDGE_DIRNAME = '.dshcs-bridge';
+const BRIDGE_FILENAME = 'bridge.json';
+const TOKEN_HEADER = 'x-dshcs-bridge-token';
+const STATE_FILENAME = 'extension-state.json';
+const REQUEST_TIMEOUT_MS = 3000;
+/** 轮询间隔:host 侧事件只是"去看一眼这个文件"的提示,600ms 足够且几乎无开销。 */
+const POLL_INTERVAL_MS = 600;
+/** 宿主配置重读间隔(令牌/端口轮换后最多这么久恢复)。 */
+const CONFIG_REREAD_MS = 5000;
+
+
+const TOKEN_RE = /^[0-9A-Za-z_-]{16,128}$/;
+
+/** 桥配置路径;`extensionsDir` 可由调用方给(测试用),默认从 __dirname 反推。 */
+function bridgeFile(extensionsDir) {
+  const dir = extensionsDir ?? path.resolve(__dirname, '..', '..');
+  return path.join(dir, BRIDGE_DIRNAME, BRIDGE_FILENAME);
+}
+
+/** 扩展自己的小状态文件(since 游标),与桥配置同目录。 */
+function stateFile(extensionsDir) {
+  const dir = extensionsDir ?? path.resolve(__dirname, '..', '..');
+  return path.join(dir, BRIDGE_DIRNAME, STATE_FILENAME);
+}
+
+/**
+ * 读桥配置。
+ * @returns {{url: string, token: string, pid: number|null}|null} null = 未配置/格式不对 → 休眠
+ */
+function readBridgeConfig(extensionsDir) {
+  try {
+    const raw = JSON.parse(fs.readFileSync(bridgeFile(extensionsDir), 'utf8'));
+    if (raw === null || typeof raw !== 'object') return null;
+    if (typeof raw.url !== 'string' || !/^http:\/\/(127\.0\.0\.1|localhost|\[::1\]):\d+$/.test(raw.url)) return null;
+    if (!TOKEN_RE.test(String(raw.token))) return null;
+    return { url: raw.url, token: String(raw.token), pid: Number.isSafeInteger(raw.pid) ? raw.pid : null };
+  } catch {
+    return null;
+  }
+}
+
+/** 读回上次的轮询游标(实例没换才有意义)。 */
+function readState(extensionsDir) {
+  try {
+    const raw = JSON.parse(fs.readFileSync(stateFile(extensionsDir), 'utf8'));
+    if (raw === null || typeof raw !== 'object') return { since: 0, pid: null };
+    return {
+      since: Number.isSafeInteger(raw.since) && raw.since > 0 ? raw.since : 0,
+      pid: Number.isSafeInteger(raw.pid) ? raw.pid : null,
+    };
+  } catch {
+    return { since: 0, pid: null };
+  }
+}
+
+/** 写回轮询游标(best-effort:写不进去只影响"重复收到一次提示",不影响正确性)。 */
+function writeState(extensionsDir, state) {
+  try {
+    fs.mkdirSync(path.dirname(stateFile(extensionsDir)), { recursive: true });
+    fs.writeFileSync(stateFile(extensionsDir), JSON.stringify(state), 'utf8');
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/** host 侧拒绝时的统一错误(带 status,便于区分 401/503/403)。 */
+class BridgeError extends Error {
+  constructor(message, status) {
+    super(message);
+    this.name = 'BridgeError';
+    this.status = status;
+  }
+}
+
+/**
+ * 造一个桥客户端。
+ *
+ * @param {{extensionsDir?: string, fetchImpl?: Function, now?: Function}} [options]
+ *        `fetchImpl` / `now` 可注入,便于单测(默认用 Node 18+ 的全局 fetch)。
+ */
+function createClient(options) {
+  const extensionsDir = options && options.extensionsDir !== undefined ? options.extensionsDir : undefined;
+  const fetchImpl = (options && options.fetchImpl) || ((...args) => fetch(...args));
+  /** 当前配置(null = 休眠)。 */
+  let config = null;
+  /** 上次读配置的时间(避免每 600ms 都碰磁盘)。 */
+  let configReadAt = 0;
+  let since = (options && Number.isSafeInteger(options.since)) ? options.since : 0;
+
+  /** 重读配置(必要时指定强制)。返回当前配置。 */
+  function refreshConfig(force) {
+    const now = (options && options.now ? options.now() : Date.now());
+    if (!force && config !== null && now - configReadAt < CONFIG_REREAD_MS) return config;
+    configReadAt = now;
+    const next = readBridgeConfig(extensionsDir);
+    if (next !== null && config !== null && next.url !== config.url) {
+      // 端口/实例变了:游标失去意义(旧实例的事件不该在新实例上重放)。
+      since = 0;
+    }
+    if (next !== null && config !== null && next.pid !== config.pid) since = 0;
+    config = next;
+    return config;
+  }
+
+  /** 一次带鉴权的请求;非 2xx 抛 BridgeError(带 status)。 */
+  async function request(route, init) {
+    const current = refreshConfig(true);
+    if (current === null) throw new BridgeError('编辑器桥未配置(休眠中)', 0);
+    const headers = Object.assign({ [TOKEN_HEADER]: current.token }, (init && init.headers) || {});
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+    let response;
+    try {
+      response = await fetchImpl(current.url + route, Object.assign({}, init, { headers, signal: controller.signal }));
+    } catch (error) {
+      throw new BridgeError(`无法连接宿主:${error && error.message ? error.message : String(error)}`, 0);
+    } finally {
+      clearTimeout(timer);
+    }
+    const text = await response.text();
+    let body = null;
+    try {
+      body = text === '' ? null : JSON.parse(text);
+    } catch {
+      body = null;
+    }
+    if (!response.ok) {
+      const reason = body !== null && typeof body.error === 'string' ? body.error : `HTTP ${response.status}`;
+      throw new BridgeError(reason, response.status);
+    }
+    return body;
+  }
+
+  return {
+    /** 当前配置(null = 休眠)。 */
+    get config() {
+      return config;
+    },
+    /** 当前轮询游标。 */
+    get cursor() {
+      return since;
+    },
+    /** 是否处于休眠(未配置)。 */
+    isDormant() {
+      return refreshConfig(false) === null;
+    },
+    /** 强制重读配置(实例切换、状态栏刷新时用)。 */
+    refresh() {
+      return refreshConfig(true);
+    },
+    /** 轻量探活:host 端点是否可达(不碰编辑器)。 */
+    async health() {
+      return request('/api/code-server/bridge/health');
+    },
+    /**
+     * **一趟来回:上报编辑器状态 + 取回待处理事件。**
+     *
+     * 上报失败/过期都不影响编辑器:失败只返回 `{ok:false}`,由调用方决定记日志还是静默。
+     * 游标只在拿到事件后推进,所以丢一次响应大不了下次重放。
+     *
+     * @param {{context: object, diagnostics: object[]}} payload 由 context-model 投影出来的状态
+     * @returns {Promise<{ok: boolean, events?: object[], error?: string, status?: number}>}
+     */
+    async sync(payload) {
+      if (refreshConfig(false) === null) return { ok: false, error: 'dormant', status: 0 };
+      try {
+        const body = await request(`/api/code-server/bridge/sync?since=${since}`, {
+          method: 'POST',
+          headers: { 'content-type': 'application/json' },
+          body: JSON.stringify(payload),
+        });
+        const events = body !== null && Array.isArray(body.events) ? body.events : [];
+        for (const event of events) {
+          if (Number.isSafeInteger(event.seq) && event.seq > since) since = event.seq;
+        }
+        return { ok: true, events };
+      } catch (error) {
+        return { ok: false, error: error.message, status: error.status };
+      }
+    },
+    /** 把"选中内容 + 问题"投给 DSH 的当前会话。 */
+    async ask(payload) {
+      return request('/api/code-server/bridge/ask', {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify(payload),
+      });
+    },
+    /** 把游标落盘(实例重启后不重复播报旧事件)。 */
+    persist() {
+      return writeState(extensionsDir, { since, pid: config === null ? null : config.pid });
+    },
+    /** 从磁盘恢复游标(实例没换才生效)。 */
+    restore() {
+      const saved = readState(extensionsDir);
+      if (config !== null && saved.pid === config.pid) since = saved.since;
+      else since = 0;
+      return since;
+    },
+  };
+}
+
+module.exports = {
+  BRIDGE_DIRNAME,
+  BRIDGE_FILENAME,
+  TOKEN_HEADER,
+  STATE_FILENAME,
+  POLL_INTERVAL_MS,
+  CONFIG_REREAD_MS,
+  REQUEST_TIMEOUT_MS,
+  BridgeError,
+  bridgeFile,
+  stateFile,
+  readBridgeConfig,
+  readState,
+  writeState,
+  createClient,
+};

package/assets/extensions/dshcs-editor-bridge/lib/context-model.js

@@ -0,0 +1,204 @@
+// dshcs-editor-bridge / lib/context-model.js —— 纯逻辑:把编辑器快照投影成桥的响应
+//
+// **不 require('vscode')**:入参是已经拍平的纯数据(见 createProjector 的文档),
+// 这样 scripts/test-bridge-extension.mjs 能在没有 VS Code 的环境里直接验投影规则。
+//
+// 投影规则里每一条都对应一个真实坑:
+//   - **未保存缓冲区才是重点**:磁盘内容 ≠ 用户所见,agent 按磁盘文件改就会把人家的编辑冲掉,
+//     所以 dirty 文档必须在 /context 里出现,并且带上"未保存行数"的量级。
+//   - **无标题文档没有路径**:用 `untitled:<n>` 占位,且**不接受**它作为 diagnostics 的 file 入参
+//     (那条路径在磁盘上不存在,按它去查只会得到空结果,不如直说)。
+//   - **诊断必须收敛在工作区内**:workspaceFolder 之外的诊断(比如 node_modules 里的、
+//     或另一个根目录的)对当前任务没有意义,而且会把响应撑爆。
+//   - **一切有界**:诊断按严重度排序后截断;选中文本截断。上限在这里,不在 host —— 扩展才是
+//     唯一知道真实规模的一方。
+
+'use strict';
+
+/** 选中文本 / 单条诊断 message 的截断上限。 */
+const MAX_SELECTION_CHARS = 8000;
+const MAX_MESSAGE_CHARS = 500;
+/** 默认返回的诊断条数上限(host 侧工具最多要 200)。 */
+const MAX_DIAGNOSTICS = 200;
+/** /context 里按文件聚合的问题条数上限。 */
+const MAX_PROBLEM_SUMMARIES = 30;
+
+/** 严重度排序权重(小的在前):error → warning → info → hint。 */
+const SEVERITY_RANK = { error: 0, warning: 1, info: 2, hint: 3 };
+
+/** 把 VS Code 的 DiagnosticSeverity 数值化名转成字符串(调用方给数值也行)。 */
+function severityName(severity) {
+  if (typeof severity === 'string') {
+    const lower = severity.toLowerCase();
+    return SEVERITY_RANK[lower] === undefined ? 'info' : lower;
+  }
+  switch (severity) {
+    case 0: return 'error';
+    case 1: return 'warning';
+    case 2: return 'info';
+    case 3: return 'hint';
+    default: return 'info';
+  }
+}
+
+function truncate(text, limit) {
+  if (typeof text !== 'string') return '';
+  return text.length > limit ? `${text.slice(0, limit)}…(已截断)` : text;
+}
+
+/**
+ * 拍平一条诊断。
+ *
+ * @param {{path: string|null, name: string, line: number, column: number, severity: unknown,
+ *          message: string, source?: string, code?: string|number}} raw 1 基行列
+ */
+function normalizeDiagnostic(raw) {
+  const diagnostic = {
+    path: typeof raw.path === 'string' && raw.path !== '' ? raw.path : (raw.name ?? '(无路径)'),
+    line: Number.isSafeInteger(raw.line) && raw.line > 0 ? raw.line : 1,
+    column: Number.isSafeInteger(raw.column) && raw.column > 0 ? raw.column : 1,
+    severity: severityName(raw.severity),
+    message: truncate(typeof raw.message === 'string' ? raw.message : '', MAX_MESSAGE_CHARS),
+  };
+  if (typeof raw.source === 'string' && raw.source !== '') diagnostic.source = raw.source;
+  if (raw.code !== undefined && raw.code !== null && raw.code !== '') diagnostic.code = String(raw.code);
+  return diagnostic;
+}
+
+/**
+ * 排序 + 截断诊断。
+ * 排序键:严重度 → 文件 → 行(稳定且与用户看 Problems 面板的顺序接近)。
+ */
+function sortDiagnostics(items, limit) {
+  const cap = Number.isSafeInteger(limit) && limit > 0 ? Math.min(limit, MAX_DIAGNOSTICS) : MAX_DIAGNOSTICS;
+  const sorted = items.slice().sort((a, b) => {
+    const bySeverity = SEVERITY_RANK[a.severity] - SEVERITY_RANK[b.severity];
+    if (bySeverity !== 0) return bySeverity;
+    if (a.path !== b.path) return a.path < b.path ? -1 : 1;
+    return a.line - b.line;
+  });
+  return { diagnostics: sorted.slice(0, cap), total: sorted.length, truncated: sorted.length > cap };
+}
+
+/**
+ * 造一个"快照 → 响应"的投影器。
+ *
+ * @param {(path: string) => boolean} isInWorkspace 该绝对路径是否落在某个工作区文件夹内
+ */
+function createProjector(isInWorkspace) {
+  const inWorkspace = typeof isInWorkspace === 'function' ? isInWorkspace : () => true;
+
+  /**
+   * 只保留工作区内的诊断(raw 形态:`{uriPath, items: [{line, column, severity, message, source, code}]}`)。
+   */
+  function filterDiagnostics(rawDiagnostics) {
+    const out = [];
+    for (const group of Array.isArray(rawDiagnostics) ? rawDiagnostics : []) {
+      if (group === null || typeof group.path !== 'string' || group.path === '') continue;
+      if (!inWorkspace(group.path)) continue;
+      for (const item of Array.isArray(group.items) ? group.items : []) {
+        out.push(normalizeDiagnostic(Object.assign({ path: group.path }, item)));
+      }
+    }
+    return out;
+  }
+
+  /**
+   * 组 /diagnostics 的响应。
+   * @param {object} input `{diagnostics, file?, severity?, limit?}`
+   */
+  function diagnostics(input) {
+    let items = filterDiagnostics(input.diagnostics);
+    if (typeof input.file === 'string' && input.file !== '') {
+      if (input.file.startsWith('untitled:')) {
+        return { available: true, diagnostics: [], total: 0, truncated: false, note: '未保存的新文件没有磁盘路径,无法按文件查诊断' };
+      }
+      items = items.filter((item) => item.path === input.file);
+    }
+    if (typeof input.severity === 'string' && SEVERITY_RANK[input.severity] !== undefined) {
+      const floor = SEVERITY_RANK[input.severity];
+      items = items.filter((item) => SEVERITY_RANK[item.severity] <= floor);
+    }
+    const sorted = sortDiagnostics(items, input.limit);
+    return {
+      available: true,
+      diagnostics: sorted.diagnostics,
+      total: sorted.total,
+      truncated: sorted.truncated,
+    };
+  }
+
+  /**
+   * 组 /context 的响应。
+   * @param {object} input `{active, documents, diagnostics}`
+   *   - `active`: `null` 或 `{path, name, language, dirty, selection: {startLine, startColumn, endLine, endColumn}|null, selectedText?}`
+   *   - `documents`: `[{path, name, dirty, unsavedLines, untitled}]`
+   *   - `diagnostics`: 同 `diagnostics()` 的入参
+   */
+  function context(input) {
+    const notes = [];
+    const active = input.active === null || input.active === undefined
+      ? null
+      : (() => {
+        const item = {
+          path: input.active.path ?? null,
+          name: input.active.name ?? null,
+          language: input.active.language ?? null,
+          dirty: input.active.dirty === true,
+          selection: input.active.selection ?? null,
+        };
+        if (typeof input.active.selectedText === 'string' && input.active.selectedText !== '') {
+          const raw = input.active.selectedText;
+          item.selectedText = raw.length > MAX_SELECTION_CHARS ? `${raw.slice(0, MAX_SELECTION_CHARS)}\n…(已截断)` : raw;
+          if (raw.length > MAX_SELECTION_CHARS) notes.push('选中文本已截断');
+        }
+        return item;
+      })();
+
+    const dirtyBuffers = (Array.isArray(input.documents) ? input.documents : [])
+      .filter((doc) => doc !== null && doc.dirty === true)
+      .map((doc) => ({
+        path: doc.path ?? null,
+        name: doc.name ?? null,
+        unsavedLines: Number.isSafeInteger(doc.unsavedLines) ? doc.unsavedLines : null,
+        untitled: doc.untitled === true,
+      }));
+
+    // 问题面板按文件聚合(只算工作区内的):给模型一个"哪里有问题"的量级,细节按需再查。
+    const all = filterDiagnostics(input.diagnostics);
+    const byFile = new Map();
+    for (const item of all) {
+      const current = byFile.get(item.path);
+      if (current === undefined) byFile.set(item.path, item);
+      else if (SEVERITY_RANK[item.severity] < SEVERITY_RANK[current.severity]) byFile.set(item.path, item);
+    }
+    const problems = [...byFile.values()]
+      .sort((a, b) => SEVERITY_RANK[a.severity] - SEVERITY_RANK[b.severity] || (a.path < b.path ? -1 : 1))
+      .slice(0, MAX_PROBLEM_SUMMARIES)
+      .map((item) => ({ path: item.path, line: item.line, severity: item.severity, message: item.message }));
+    if (byFile.size > MAX_PROBLEM_SUMMARIES) notes.push(`问题面板仅列出前 ${MAX_PROBLEM_SUMMARIES} 个文件(共 ${byFile.size} 个)`);
+
+    return {
+      available: true,
+      active,
+      dirtyBuffers,
+      problems,
+      diagnosticCount: all.length,
+      truncated: notes.join(';'),
+    };
+  }
+
+  return { context, diagnostics, filterDiagnostics };
+}
+
+module.exports = {
+  MAX_SELECTION_CHARS,
+  MAX_MESSAGE_CHARS,
+  MAX_DIAGNOSTICS,
+  MAX_PROBLEM_SUMMARIES,
+  SEVERITY_RANK,
+  severityName,
+  normalizeDiagnostic,
+  sortDiagnostics,
+  createProjector,
+};

package/assets/extensions/dshcs-editor-bridge/lib/diff-model.js

@@ -0,0 +1,123 @@
+// dshcs-editor-bridge / lib/diff-model.js —— 纯逻辑:agent 改动 → 编辑器侧审阅决策
+//
+// **不 require('vscode')**:入参是纯文本,所以能单测。
+//
+// 端到端这条链路是这样走的(每一步都有理由,别随手简化):
+//
+//   host: `ctx.on('tools/result')` 看到写类工具(exec.name + exec.arguments)
+//     → 推一条 {kind:'agent-edit', path} 进环形缓冲(只播"去看一眼",不播数据)
+//   ext : 轮询拿到事件
+//     → **立刻**取该文档当前文本作 old 侧:此时 VS Code 的磁盘 watcher 还没把新内容灌进缓冲区,
+//       所以缓冲区里拿到的正是"改动前"的内容(时序敏感,不能先 await 别的)
+//     → 再用 workspace.fs 读磁盘作 new 侧
+//     → old === new ⇒ 不打扰用户(agent 写的和盘上一样,缓冲区本来就没差别)
+//     → 不同 ⇒ 开 diff tab;若该文档 isDirty,弹一条非模态告警(绝不自动覆盖用户的未保存改动)
+//
+// 为什么要缓存"上次见过的内容":文件没在编辑器里打开时缓冲区取不到 old 侧,只能靠上次轮询时
+// 记下的内容。缓存有界(超出丢最旧),因为它的用途只是 diff,不是版本控制。
+
+'use strict';
+
+/** 缓存条目上限(每个条目是一份完整文件文本 —— 不能无界)。 */
+const CACHE_MAX = 64;
+
+/**
+ * 判据:这次改动值不值得开 diff。
+ *
+ * 只有"文本确实不同"才值得。空文件 ↔ 空文件、或 agent 写回了一模一样的内容,都不该打扰用户。
+ *
+ * `added` / `removed` 在**只有一侧**时是 `null` 而不是猜出来的数字:没有 old 侧就无从知道
+ * "新增了几行"(新文件的所有行都是新增,但那只对新建文件成立;覆盖写不是)——
+ * 报个 0 或报个全文行数都会误导用户与模型。null 让调用方只显示"有变化"。
+ *
+ * @param {string|null} oldText 改动前(缓冲区/缓存)
+ * @param {string|null} newText 改动后(磁盘)
+ * @returns {{show: boolean, reason: string, added: number|null, removed: number|null}}
+ */
+function describeChange(oldText, newText) {
+  const oldStr = typeof oldText === 'string' ? oldText : null;
+  const newStr = typeof newText === 'string' ? newText : null;
+  if (oldStr === null && newStr === null) return { show: false, reason: '两侧都不可读', added: null, removed: null };
+  if (oldStr === null) return { show: newStr !== '', reason: '没有改动前的内容', added: null, removed: null };
+  if (newStr === null) return { show: oldStr !== '', reason: '文件已被删除', added: null, removed: null };
+  if (oldStr === newStr) return { show: false, reason: '内容未变化', added: 0, removed: 0 };
+  const stats = lineStats(oldStr, newStr);
+  return { show: true, reason: '内容有变化', added: stats.added, removed: stats.removed };
+}
+
+/** 行数(空串算 0 行)。 */
+function countLines(text) {
+  if (typeof text !== 'string' || text === '') return 0;
+  return text.split(/\r\n|\r|\n/).length;
+}
+
+/**
+ * 极简行级统计(不是完整 diff —— 只用来给用户一句"±N 行"的量级,完整 diff 由 VS Code 渲染)。
+ * 用"最长公共前后缀裁剪"来近似:裁剪后剩下的行数就是改动规模。
+ */
+function lineStats(oldText, newText) {
+  const a = oldText.split(/\r\n|\r|\n/);
+  const b = newText.split(/\r\n|\r|\n/);
+  let head = 0;
+  while (head < a.length && head < b.length && a[head] === b[head]) head += 1;
+  let tail = 0;
+  while (tail < a.length - head && tail < b.length - head && a[a.length - 1 - tail] === b[b.length - 1 - tail]) tail += 1;
+  return { removed: a.length - head - tail, added: b.length - head - tail };
+}
+
+/**
+ * 有界 LRU 文本缓存(键 = 绝对路径)。
+ */
+function createDiffCache(max) {
+  const cap = Number.isSafeInteger(max) && max > 0 ? max : CACHE_MAX;
+  /** @type {Map<string, {text: string, at: number}>} */
+  const store = new Map();
+
+  function touch(key) {
+    const value = store.get(key);
+    if (value === undefined) return undefined;
+    store.delete(key);
+    store.set(key, value);
+    return value;
+  }
+
+  return {
+    /** 记下"现在这个文件长这样"。 */
+    remember(key, text, at) {
+      if (typeof key !== 'string' || key === '' || typeof text !== 'string') return false;
+      store.delete(key);
+      store.set(key, { text, at: Number.isFinite(at) ? at : 0 });
+      while (store.size > cap) {
+        const oldest = store.keys().next();
+        if (oldest.done === true) break;
+        store.delete(oldest.value);
+      }
+      return true;
+    },
+    /** 取上次见过的内容(命中会把它挪到最新)。 */
+    recall(key) {
+      const value = touch(key);
+      return value === undefined ? null : value.text;
+    },
+    has(key) {
+      return store.has(key);
+    },
+    get size() {
+      return store.size;
+    },
+    clear() {
+      store.clear();
+    },
+    keys() {
+      return [...store.keys()];
+    },
+  };
+}
+
+module.exports = {
+  CACHE_MAX,
+  describeChange,
+  countLines,
+  lineStats,
+  createDiffCache,
+};

package/assets/extensions/dshcs-editor-bridge/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "dshcs-editor-bridge",
+  "displayName": "DSH Editor Bridge",
+  "description": "只读地把编辑器状态(未保存缓冲区、诊断、活动选区)提供给 DSH,并让编辑器里的动作驱动 DSH 会话。由 dsh-code-server-app 插件安装,可禁用。",
+  "version": "0.1.0",
+  "publisher": "dsh-code-server-app",
+  "license": "MIT",
+  "private": true,
+  "engines": {
+    "vscode": "^1.90.0"
+  },
+  "categories": [
+    "Other"
+  ],
+  "activationEvents": [
+    "*"
+  ],
+  "main": "./extension.js",
+  "contributes": {
+    "commands": [
+      {
+        "command": "dsh-code-server.askAboutSelection",
+        "title": "DSH: 针对选中内容提问",
+        "category": "DSH"
+      },
+      {
+        "command": "dsh-code-server.askAboutFile",
+        "title": "DSH: 针对当前文件提问",
+        "category": "DSH"
+      },
+      {
+        "command": "dsh-code-server.showBridgeLog",
+        "title": "DSH: 显示编辑器桥日志",
+        "category": "DSH"
+      }
+    ],
+    "menus": {
+      "editor/context": [
+        {
+          "command": "dsh-code-server.askAboutSelection",
+          "when": "editorHasSelection",
+          "group": "dsh@1"
+        },
+        {
+          "command": "dsh-code-server.askAboutFile",
+          "group": "dsh@2"
+        }
+      ]
+    }
+  },
+  "capabilities": {
+    "untrustedWorkspaces": {
+      "supported": true,
+      "description": "本扩展只向本机 DSH 读取/上报编辑器状态,不修改工作区文件。"
+    },
+    "virtualWorkspaces": true
+  }
+}

package/cordis.patch.yml

@@ -30,7 +30,21 @@
         locale: ''
         # 启动就绪探测超时(ms)。
         readyTimeoutMs: 60000
-        # 注:后台常驻(keepResident,默认 true)与认领范围(fileOpenScope,默认 session)由
+        #
+        # ---- 编辑器桥(0.3.0,默认开) ----
+        # 树内扩展 dshcs-editor-bridge 与 host 之间的**只读**通道(见 lib/bridge.mjs 顶部的
+        # 通道说明与安全不变量):
+        #   agent 侧:editor_context / editor_diagnostics 两个工具,拿到未保存缓冲区、语言服务器
+        #             诊断、活动选区 —— 这些只有编辑器知道;
+        #   编辑器侧:「问 DSH」右键命令把选区投进当前会话;agent 改文件后开原生 diff 审阅,
+        #             缓冲区有未保存改动时只告警、绝不覆盖。
+        # 关掉它 = 不写 bridge.json、不注册工具、扩展休眠。也可在设置文档里改实时的
+        # `code-server.editorBridge`(改完即时生效,无需重启)。
+        # 已知范围:`serve: dsh`(管道模式,无独立端口)下不支持桥 → 自动禁用,不影响其它功能。
+        editorBridge: true
+        # 注:「认领类型」(claimExtensions,默认把 markdown/html/图片/PDF 留给 DSH 自带预览)与
+        # 「打开即全屏」(fullscreenOnOpen)、「后台常驻」(keepResident)由
         # "设置 → 插件 → Code Server"卡片控制,持久化于官方 settings 域(命名空间 code-server),
-        # 卡片修改即时生效。服务方式(serve)没有卡片行:改这里的 config.serve 或设置文档。
+        # 卡片修改即时生效。服务方式(serve)与编辑器桥(editorBridge)没有卡片行:
+        # 改这里或设置文档(code-server.serve / code-server.editorBridge)。
         # 另:不再兼容旧版 DSH(无 sidebarRightTabs/sidebarRight 服务),旧版上仅给设置页提示。