dsh-vscode-mode 0.18.0 → 0.19.0

package/lib/client.rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.rules.js","names":["React"],"sources":["../src/client/paths.ts","../src/client/rulesMdc.ts","../src/client/sidebar/panels/RulesPanel.ts"],"sourcesContent":["/**\n * dsh-vscode-mode client — 浏览器端缓存键/路径统一出口（PathConst）。\n * 统一 localStorage 键前缀（各缓存模块/编辑区/搜索面板共用），避免内联散落；\n * 键带 schema 版本号，未来版本递增时经 sweepLegacyKeys 自动清旧。\n * 浏览器不涉 ~/.dsh 文件系统，这里只管键名 + shared 路由常量。\n * 作者 ddj 2026-09-01\n */\n\n/** localStorage 键前缀表（按功能隔离；与 scopeStore 作用域键拼接：工作区优先，无 cwd 回退会话）。 */\nexport const CACHE_KEY = {\n  /** 展开状态（explorerCache v1，当前使用）。 */\n  expanded: 'edrv.cache.explorer.v1.',\n  /** 目录条目 SWR 缓存（explorerEntriesCache v2，当前使用）。 */\n  entries: 'edrv.cache.entries.v2.',\n  /** 编辑区视图状态（viewStateCache v1）。 */\n  viewstate: 'edrv.cache.viewstate.v1.',\n  /** 编辑器页签/活动文件（EditorView v3：页签带 pinned 固定标记）。 */\n  editor: 'edrv.editor.v3.',\n  /** Multi-group split tree and floating window geometry. */\n  editorLayout: 'edrv.editorLayout.v1.',\n  /** 旧编辑器页签键（v2：页签为纯路径数组）——仅用于一次性回读迁移，不再写入。 */\n  editorLegacy: 'edrv.editor.v2.',\n  /** 侧边栏状态（EditorView；按布局 side/central 追加段）。 */\n  sidebar: 'edrv.sidebar.',\n  /** 搜索面板条件（SearchPanel v1）。 */\n  search: 'edrv.search.v1.',\n  /** 侧边栏提示已关闭标记（全局，无作用域）。 */\n  sideHint: 'edrv.side-hint-dismissed',\n  /** 「性能优化」页工作区栏目展开状态（workspaceFoldCache v1，全局不按会话）。 */\n  workspaceFold: 'edrv.ws-fold.v1.',\n  /** 规则面板 UI 状态（RulesPanel v1：Tab 与项目工作区选择，全局不按会话）。 */\n  rules: 'edrv.rules.v1.',\n  /** SVN 变更面板 UI 状态（SvnPanel v1：未版本控制/忽略项显示开关，按作用域隔离）。 */\n  svn: 'edrv.svn.v1.',\n  /** Markdown 预览态（EditorView v1：处于预览态的 Markdown 路径集合，按作用域隔离）。 */\n  mdPreview: 'edrv.md-preview.v1.',\n  /** 官方侧边栏「文件编辑」Tab 展开/激活态（officialSidebar v1：重启后自动回到编辑 Tab）。 */\n  editorTab: 'edrv.editor-tab.v1.',\n  /** 编辑器导航历史双栈（navStateCache v1：重启后前进/后退与当前位置仍在，按作用域隔离）。 */\n  navHistory: 'edrv.nav-history.v1.',\n} as const\n\n/** 按前缀拼作用域键（scopeStore 产出作用域；侧边栏/编辑器等需要布局段时自行拼接后传入）。 */\nexport function cacheKey(prefix: string, sessionId: string): string {\n  return prefix + sessionId\n}\n\n/** 旧版本键清理入口：未来前缀版本递增时在此登记旧前缀并清空（当前无实际旧键）。 */\nexport function sweepLegacyKeys(): void {\n  // 例：entries v2 取代 v1 时 → localStorage.removeItem('edrv.cache.entries.v1.' + sid)\n  // 当前各功能均为现役版本，无待清旧键。\n}\n","/**\n * dsh-vscode-mode client — 规则 frontmatter 纯函数（解析 + 按类型改写）。\n * 与 host parseRuleMdc/ruleTypeOf 语义对齐的浏览器端实现：编辑器类型下拉与\n * 原始 .mdc 文本域双向同步共用；纯字符串运算，禁 node/react 导入。\n * 作者 ddj 2026年09月07号\n */\n\n/** 规则生效类型（与 shared/rules.ts RuleType 一致，此处独立声明避免引入 host 依赖）。 */\nexport type RuleFmType = 'always' | 'auto' | 'manual'\n\n/** 一条 .mdc 文本的解析结果（改写 frontmatter 所需的全部上下文）。 */\nexport interface RuleFmParsed {\n  type: RuleFmType\n  description: string\n  alwaysApply: boolean\n  globs: string[]\n  enabled: boolean\n  /** 是否存在规则 frontmatter（首行 --- 且有闭合）。 */\n  hasFm: boolean\n  /** 闭合 --- 之后的正文（按 \\n 归一，与 host 解析一致）。 */\n  body: string\n  /** 已知键之外的 frontmatter 原行（如 updatedAt），改写时原样保留。 */\n  fmExtra: string[]\n  /** 原文是否带 BOM（改写后回填）。 */\n  bom: boolean\n  /** 原文 frontmatter 是否显式写了 enabled 行（改写时保持该行存在与否）。 */\n  hasEnabledLine: boolean\n}\n\n/** 类型改写入参：下拉/描述/globs 控件的最新值。 */\nexport interface RuleMetaNext {\n  type: RuleFmType\n  description: string\n  globs: string[]\n}\n\n/**\n * 去除值两侧成对引号（与 host stripQuotes 一致）。\n * @author ddj 2026年09月07号\n * @param raw 原始值\n * @returns 去引号后的值\n */\nfunction stripQuotes(raw: string): string {\n  const value = raw.trim()\n  if (value.length >= 2 && ((value.startsWith('\"') && value.endsWith('\"')) || (value.startsWith(\"'\") && value.endsWith(\"'\")))) {\n    return value.slice(1, -1)\n  }\n  return value\n}\n\n// --region 解析\n/**\n * 解析 .mdc 全文：首行 --- 且 100 行内有闭合 --- 才视为 frontmatter；\n * 已知键 description/alwaysApply/globs/enabled，其余原行进 fmExtra；永不抛错。\n * @author ddj 2026年09月07号\n * @param text 文件全文\n * @returns 解析结果\n */\nexport function parseRuleFm(text: string): RuleFmParsed {\n  const bom = text.startsWith('\\uFEFF')\n  const lines = text.replace(/^\\uFEFF/, '').split(/\\r?\\n/)\n  const none: RuleFmParsed = { type: 'manual', description: '', alwaysApply: false, globs: [], enabled: true, hasFm: false, body: text.replace(/^\\uFEFF/, ''), fmExtra: [], bom, hasEnabledLine: false }\n  if (lines[0]?.trim() !== '---') return none\n  let close = -1\n  for (let i = 1; i < lines.length && i <= 101; i++) {\n    if (lines[i].trim() === '---') { close = i; break }\n  }\n  if (close < 0) return none\n  const parsed: RuleFmParsed = { type: 'manual', description: '', alwaysApply: false, globs: [], enabled: true, hasFm: true, body: lines.slice(close + 1).join('\\n'), fmExtra: [], bom, hasEnabledLine: false }\n  for (let i = 1; i < close; i++) {\n    const match = /^([A-Za-z_-]+)[ \\t]*:[ \\t]?(.*)$/.exec(lines[i])\n    if (!match) { parsed.fmExtra.push(lines[i]); continue }\n    const [, key, raw] = match\n    if (key === 'description') parsed.description = stripQuotes(raw)\n    else if (key === 'alwaysApply') parsed.alwaysApply = stripQuotes(raw).toLowerCase() === 'true'\n    else if (key === 'enabled') { parsed.enabled = stripQuotes(raw).toLowerCase() !== 'false'; parsed.hasEnabledLine = true }\n    else if (key === 'globs') parsed.globs = parseGlobsValue(raw, lines, i, close)\n    else parsed.fmExtra.push(lines[i])\n  }\n  parsed.type = fmTypeOf(parsed)\n  return parsed\n}\n\n/**\n * 解析 globs 值：内联逗号分隔串，或空值后接 YAML 短横列表（与 host parseGlobs 一致）。\n * @author ddj 2026年09月07号\n * @param value 内联值\n * @param lines 全文行\n * @param start globs 行下标\n * @param close 闭合 --- 下标\n * @returns glob 数组\n */\nfunction parseGlobsValue(value: string, lines: string[], start: number, close: number): string[] {\n  const inline = stripQuotes(value)\n  if (inline) return inline.split(',').map((item) => stripQuotes(item)).filter(Boolean)\n  const list: string[] = []\n  for (let j = start + 1; j < close; j++) {\n    const item = /^[ \\t]*-[ \\t]*(.+)$/.exec(lines[j])\n    if (!item) break\n    list.push(stripQuotes(item[1]))\n  }\n  return list\n}\n\n/**\n * 由 frontmatter 推导类型：alwaysApply=true → 总是；有 globs → 自动；否则手动。\n * @author ddj 2026年09月07号\n * @param parsed 解析结果\n * @returns 规则类型\n */\nfunction fmTypeOf(parsed: RuleFmParsed): RuleFmType {\n  if (parsed.alwaysApply) return 'always'\n  if (parsed.globs.length) return 'auto'\n  return 'manual'\n}\n// --endregion\n\n// --region 改写\n/**\n * 按最新控件值重写 frontmatter：known 键固定顺序 + fmExtra + 闭合 --- + 原 body；\n * 无 frontmatter 且目标为手动时：有描述则新建仅含描述的 frontmatter，否则原文返回。\n * @author ddj 2026年09月07号\n * @param parsed parseRuleFm 的结果（必须来自同一文本）\n * @param next 控件最新值\n * @returns 重写后的全文\n */\nexport function applyRuleMeta(parsed: RuleFmParsed, next: RuleMetaNext): string {\n  if (!parsed.hasFm && next.type === 'manual') {\n    if (!next.description.trim()) return (parsed.bom ? '\\uFEFF' : '') + parsed.body\n    return (parsed.bom ? '\\uFEFF' : '') + ['---', 'description: ' + next.description.trim(), '---'].join('\\n') + '\\n' + parsed.body\n  }\n  const lines: string[] = ['---']\n  lines.push('description: ' + next.description.trim())\n  if (next.type === 'always') lines.push('alwaysApply: true')\n  if (next.type === 'auto') lines.push('globs: ' + next.globs.join(', '))\n  if (parsed.hasEnabledLine) lines.push('enabled: ' + (parsed.enabled ? 'true' : 'false'))\n  lines.push(...parsed.fmExtra)\n  lines.push('---')\n  return (parsed.bom ? '\\uFEFF' : '') + lines.join('\\n') + '\\n' + parsed.body\n}\n// --endregion\n","// @ts-nocheck\n/**\n * dsh-vscode-mode client — 侧边栏「规则」面板（Codebuddy 规则管理形态）。\n * 双 Tab：用户规则（~/.dsh/rules/）与项目规则（<工作区>/.dsh/rules/）；\n * 列表行 = 文件名 + 相对提示，第二行类型徽标与描述，右侧 编辑/删除 图标 + 滑动启用开关；\n * 新建/编辑 = 顶部面包屑 + 规则类型下拉（总是/自动/手动）+ 描述/globs 控件，与原始 .mdc\n * 文本域双向同步（控件改写 frontmatter，文本域回读控件），保存走 rules.save。\n * 作者 ddj 2026年09月03号（2026年09月07号 交互性调整）\n */\nimport React from 'react'\nimport { rpc } from '../../rpc.js'\nimport type { SidebarCtx } from '../types.js'\nimport { CACHE_KEY } from '../../paths.js'\nimport { parseRuleFm, applyRuleMeta } from '../../rulesMdc.js'\n\n/** 新建规则模板（frontmatter 字段与 host parseRuleMdc 对齐）。 */\nconst NEW_TEMPLATE = '---\\ndescription: \\nalwaysApply: true\\n---\\n\\n'\nconst TYPE_LABEL = { always: '总是', auto: '自动', manual: '手动' }\n/** 列表行描述的基础显示上限（字符数；宽面板下的封顶值，超出省略号）。 */\nconst DESC_MAX = 24\n/** 动态字数下限（极窄面板的保底可见字符数）。 */\nconst DESC_CAP_MIN = 8\n/** 动态字数估算：描述之外的行内固定占用 px（动作区/类型标签/徽标/间距/省略余量）。 */\nconst DESC_RESERVE_PX = 210\n/** 动态字数估算：单字符平均宽度 px（11px 字号，中英混排）。 */\nconst DESC_CHAR_PX = 10\n/** 窄面板阈值：低于此宽度隐藏路径提示（编辑界面面包屑与悬停仍有完整路径）。 */\nconst NARROW_W = 420\n\n/**\n * 读 localStorage（损坏/不可用安全）。\n * @author ddj 2026年09月03号\n * @param key 键\n * @returns 值或 null\n */\nfunction readLocal(key) {\n  try { return localStorage.getItem(key) } catch (e) { return null }\n}\n\n/**\n * 写 localStorage（不可用安全）。\n * @author ddj 2026年09月03号\n * @param key 键\n * @param value 值\n */\nfunction writeLocal(key, value) {\n  try { localStorage.setItem(key, value) } catch (e) { /* 忽略 */ }\n}\n\n/**\n * 类型徽标（总是=绿 / 自动=蓝 / 手动=灰）。\n * @author ddj 2026年09月03号\n * @param type 规则类型\n * @returns 徽标元素\n */\nfunction typeBadge(type) {\n  return React.createElement('span', { className: 'edrv-rules-type edrv-rules-type-' + type }, TYPE_LABEL[type] ?? type)\n}\n\n/**\n * 按字符上限截断列表行描述，超出以省略号收尾（上限随面板宽度动态变化；\n * 窄面板下 CSS 省略号仍会按像素提前截断，二者取更小）。\n * @author ddj 2026年09月07号\n * @param text 完整描述\n * @param cap 本帧字符上限\n * @returns 截断后的展示文本\n */\nfunction clampDesc(text, cap) {\n  const chars = Array.from(String(text ?? '')) // 按码位切分，避免把 emoji 等代理对从中间截断\n  const limit = Math.max(4, Number(cap) || DESC_MAX)\n  return chars.length > limit ? chars.slice(0, limit).join('') + '…' : chars.join('')\n}\n\n/**\n * 由面板宽度估算描述可用字符数：随宽度动态变化，并与基础上限取小、极窄时保底。\n * @author ddj 2026年09月07号\n * @param panelWidth 面板内容宽度（px）\n * @returns 本帧描述字符上限\n */\nfunction descCapOf(panelWidth) {\n  const byWidth = Math.floor((Number(panelWidth) - DESC_RESERVE_PX) / DESC_CHAR_PX)\n  return Math.max(DESC_CAP_MIN, Math.min(DESC_MAX, byWidth))\n}\n\n/**\n * 编辑图标（线性铅笔，与 DiffBox chevron 同风格：currentColor 描边装饰图）。\n * @author ddj 2026年09月07号\n * @returns 13×13 装饰性 SVG\n */\nfunction pencilIcon() {\n  return React.createElement('svg', {\n    width: 13, height: 13, viewBox: '0 0 24 24', fill: 'none', 'aria-hidden': true, focusable: false,\n  }, React.createElement('path', {\n    d: 'M17 3a2.828 2.828 0 1 1 4 4L7.5 20.5 2 22l1.5-5.5L17 3z',\n    stroke: 'currentColor', strokeWidth: 2, strokeLinecap: 'round', strokeLinejoin: 'round',\n  }))\n}\n\n/**\n * 删除图标（线性垃圾桶，风格同 pencilIcon）。\n * @author ddj 2026年09月07号\n * @returns 13×13 装饰性 SVG\n */\nfunction trashIcon() {\n  return React.createElement('svg', {\n    width: 13, height: 13, viewBox: '0 0 24 24', fill: 'none', 'aria-hidden': true, focusable: false,\n  }, React.createElement('path', {\n    d: 'M3 6h18M8 6V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2m3 0v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6h14zM10 11v6M14 11v6',\n    stroke: 'currentColor', strokeWidth: 2, strokeLinecap: 'round', strokeLinejoin: 'round',\n  }))\n}\n\n/**\n * 逗号分隔的 globs 输入串 → 数组（去空项）。\n * @author ddj 2026年09月07号\n * @param text 输入串\n * @returns glob 数组\n */\nfunction globList(text) {\n  return String(text ?? '').split(',').map((item) => item.trim()).filter(Boolean)\n}\n\n/**\n * 由控件值重建 .mdc 全文：frontmatter 按类型/描述/globs 重写，正文与其余键不动。\n * @author ddj 2026年09月07号\n * @param base 当前全文\n * @param fmType 目标类型（always/auto/manual）\n * @param desc 描述文本\n * @param globsText globs 输入串\n * @returns 重写后的全文\n */\nfunction rebuildContent(base, fmType, desc, globsText) {\n  return applyRuleMeta(parseRuleFm(base), { type: fmType, description: desc, globs: globList(globsText) })\n}\n\n// --region 列表行\n/**\n * 渲染一条规则行：左侧两行（文件名+相对提示 / 类型徽标+描述），右侧 编辑/删除 图标 + 滑动开关。\n * @author ddj 2026年09月03号\n * @param props.rule 规则元信息\n * @param props.onEdit 编辑回调\n * @param props.onRemove 删除回调\n * @param props.onToggle 开关回调\n * @returns 行元素\n */\nfunction RuleRow(props) {\n  const rule = props.rule\n  const desc = [rule.error ? '解析失败：' + rule.error : null, rule.description || (rule.type === 'auto' ? 'globs: ' + rule.globs.join(', ') : '')]\n    .filter(Boolean).join(' · ')\n  return React.createElement('div', { className: 'edrv-rules-row' + (rule.enabled ? '' : ' off') },\n    React.createElement('div', { className: 'edrv-rules-main', onClick: () => props.onEdit(rule), title: rule.absPath },\n      React.createElement('div', { className: 'edrv-rules-line1' },\n        React.createElement('span', { className: 'edrv-rules-file' }, rule.file),\n        !props.narrow ? React.createElement('span', { className: 'edrv-rules-path' }, '[' + rule.relHint + rule.file + ']') : null,\n        props.narrow && rule.scope === 'user' && rule.origin === 'legacy'\n          ? React.createElement('span', { className: 'edrv-rules-path', title: rule.absPath }, '旧目录') : null,\n        !rule.enabled ? React.createElement('span', { className: 'edrv-rules-offtag' }, '已停用') : null),\n      React.createElement('div', { className: 'edrv-rules-sub' },\n        React.createElement('span', { className: 'edrv-rules-sublabel' }, '类型:'),\n        typeBadge(rule.type),\n        desc ? React.createElement('span', { className: 'edrv-rules-desc', title: desc }, clampDesc(desc, props.descCap)) : null)),\n    React.createElement('div', { className: 'edrv-rules-actions' },\n      React.createElement('button', { className: 'edrv-rules-act', title: '编辑', onClick: () => props.onEdit(rule) }, pencilIcon()),\n      React.createElement('button', { className: 'edrv-rules-act', title: '删除', onClick: () => props.onRemove(rule) }, trashIcon()),\n      React.createElement('button', {\n        className: 'edrv-rules-switch' + (rule.enabled ? ' on' : ''), role: 'switch', 'aria-checked': rule.enabled,\n        title: rule.enabled ? '已启用（点击停用）' : '已停用（点击启用）',\n        onClick: () => props.onToggle(rule),\n      }, React.createElement('span', { className: 'edrv-rules-knob' }))))\n}\n// --endregion\n\n// --region 内嵌编辑器\n/**\n * 新建/编辑表单：面包屑头部 + 规则类型下拉/描述/globs 控件行 + 原始 .mdc 文本域 + 保存/取消。\n * @author ddj 2026年09月03号\n * @param props.form 表单状态（mode/scope/workspacePath/relHint/file/content/fmType/desc/globs/error/saving）\n * @param props.onType 类型下拉变更回调\n * @param props.onDesc 描述输入回调\n * @param props.onGlobs globs 输入回调\n * @param props.onBody 文本域编辑回调\n * @param props.onSave 保存回调\n * @param props.onCancel 取消回调\n * @returns 表单元素\n */\nfunction RuleEditor(props) {\n  const form = props.form\n  const isNew = form.mode === 'new'\n  const crumb = (form.scope === 'project' ? '项目规则' : '用户规则') + ' > ' + form.relHint + ' > ' + (form.file || '新建规则.mdc')\n  return React.createElement('div', { className: 'edrv-rules-editor' },\n    React.createElement('div', { className: 'edrv-rules-editor-head' },\n      React.createElement('span', { className: 'edrv-rules-crumb', title: crumb }, crumb),\n      React.createElement('button', { className: 'edrv-rules-act', title: '取消', onClick: props.onCancel }, '✕')),\n    React.createElement('div', { className: 'edrv-rules-editor-ctl' },\n      React.createElement('label', { className: 'edrv-rules-ctl-label' }, '规则类型'),\n      React.createElement('select', { className: 'edrv-rules-select', value: form.fmType, onChange: props.onType },\n        Object.keys(TYPE_LABEL).map((key) => React.createElement('option', { key, value: key }, TYPE_LABEL[key]))),\n      React.createElement('label', { className: 'edrv-rules-ctl-label' }, '描述'),\n      React.createElement('input', {\n        className: 'edrv-rules-input edrv-rules-desc-input', value: form.desc, spellCheck: false,\n        placeholder: isNew ? '规则用途说明（写入 frontmatter description）' : '规则用途说明', onChange: props.onDesc,\n      })),\n    form.fmType === 'auto' ? React.createElement('div', { className: 'edrv-rules-editor-ctl' },\n      React.createElement('label', { className: 'edrv-rules-ctl-label' }, 'globs'),\n      React.createElement('input', {\n        className: 'edrv-rules-input', value: form.globs, spellCheck: false,\n        placeholder: 'src/**/*.ts, *.md（逗号分隔，命中才注入）', onChange: props.onGlobs,\n      })) : null,\n    React.createElement('textarea', {\n      className: 'edrv-rules-body', spellCheck: false,\n      value: form.content,\n      onChange: props.onBody,\n    }),\n    React.createElement('div', { className: 'edrv-rules-editor-hint' },\n      '类型/描述/globs 与 frontmatter 双向同步；enabled 与其余键原样保留；无 frontmatter 的纯 markdown 视为「手动」规则'),\n    form.error ? React.createElement('div', { className: 'edrv-rules-err' }, form.error) : null,\n    React.createElement('div', { className: 'edrv-rules-editor-foot' },\n      React.createElement('button', { className: 'edrv-rules-save', disabled: form.saving, onClick: props.onSave }, form.saving ? '保存中…' : '保存')))\n}\n// --endregion\n\n/**\n * 规则面板主体。\n * @param props.ctx 面板共享上下文（notify 可选）\n */\nexport function RulesPanel(props) {\n  const ctx = props?.ctx\n  const notify = ctx?.notify ?? ((message) => {})\n  // 当前会话工作区（EditorView 从 sessions 快照注入；项目 Tab 自动匹配，不提供手动切换）\n  const cwd = ctx?.cwd ?? null\n  const [tab, setTab] = React.useState(() => (readLocal(CACHE_KEY.rules + 'tab') === 'project' ? 'project' : 'user'))\n  const [data, setData] = React.useState(null) // { user: RuleInfo[], projects: RuleProject[] }\n  const [error, setError] = React.useState('')\n  const panelRef = React.useRef(null)\n  const [panelW, setPanelW] = React.useState(0) // 面板内容宽度（ResizeObserver 跟踪；0=未测得）\n  const [form, setForm] = React.useState(null) // 编辑器表单状态；null=列表态\n  const mountedRef = React.useRef(true)\n\n  /**\n   * 当前工作区对应的项目聚合（按 ctx.cwd 自动匹配；无会话/未注册返回 null）。\n   * @returns RuleProject 或 null\n   */\n  const activeProject = () => {\n    if (!cwd) return null\n    return (data?.projects ?? []).find((p) => p.workspacePath === cwd) ?? null\n  }\n\n  /** 拉取规则总列表（rules.list）。 */\n  const load = () => {\n    rpc('rules.list', {}).then((res) => {\n      if (!mountedRef.current) return\n      if (res && res.ok) { setData(res); setError('') } else setError(res?.error ?? '读取规则失败')\n    }).catch((e) => { if (mountedRef.current) setError('读取规则异常: ' + String(e)) })\n  }\n\n  React.useEffect(() => {\n    mountedRef.current = true\n    load()\n    return () => { mountedRef.current = false }\n  }, [])\n\n  // 面板宽度跟踪：描述字数上限与窄面板模式都随宽度动态变化\n  React.useEffect(() => {\n    const el = panelRef.current\n    if (!el || typeof ResizeObserver === 'undefined') return undefined\n    const observer = new ResizeObserver(() => setPanelW(el.clientWidth))\n    observer.observe(el)\n    setPanelW(el.clientWidth)\n    return () => observer.disconnect()\n  }, [])\n\n  // 描述字数上限与窄面板模式（未测得宽度前用基础上限/完整展示）\n  const descCap = panelW > 0 ? descCapOf(panelW) : DESC_MAX\n  const narrow = panelW > 0 && panelW < NARROW_W\n\n  /**\n   * 切换 Tab（记忆到 localStorage）。\n   * @param next 目标 Tab\n   */\n  const switchTab = (next) => {\n    setTab(next)\n    writeLocal(CACHE_KEY.rules + 'tab', next)\n  }\n\n  /**\n   * 打开新建表单（按当前 Tab 决定作用域；项目规则跟随当前会话工作区）。\n   */\n  const openNew = () => {\n    const scope = tab === 'project' ? 'project' : 'user'\n    if (scope === 'project' && !cwd) { notify('当前会话没有工作区，无法新建项目规则'); return }\n    const parsed = parseRuleFm(NEW_TEMPLATE)\n    setForm({\n      mode: 'new', scope, origin: scope === 'user' ? 'current' : undefined, workspacePath: scope === 'project' ? cwd : undefined,\n      relHint: scope === 'project' ? '.dsh/rules/' : 'rules/', file: '', content: NEW_TEMPLATE,\n      fmType: parsed.type, desc: parsed.description, globs: parsed.globs.join(', '), error: '', saving: false,\n    })\n  }\n\n  /**\n   * 打开编辑表单：先拉全文，再解析 frontmatter 回填类型/描述/globs 控件。\n   * @param rule 目标规则\n   */\n  const openEdit = (rule) => {\n    rpc('rules.read', { scope: rule.scope, origin: rule.origin, workspacePath: rule.scope === 'project' ? rule.workspacePath : undefined, file: rule.file })\n      .then((res) => {\n        if (!res || !res.ok) { notify(res?.error ?? '读取规则失败'); return }\n        const parsed = parseRuleFm(res.content)\n        setForm({\n          mode: 'edit', scope: rule.scope, origin: rule.origin, workspacePath: rule.workspacePath, relHint: rule.relHint,\n          file: rule.file, content: res.content,\n          fmType: parsed.type, desc: parsed.description, globs: parsed.globs.join(', '), error: '', saving: false,\n        })\n      }).catch((e) => notify('读取规则异常: ' + String(e)))\n  }\n\n  /** 类型下拉变更：frontmatter 按新类型重写，控件同步。 */\n  const onTypeChange = (e) => {\n    const nextType = e.target.value\n    setForm((prev) => ({ ...prev, fmType: nextType, content: rebuildContent(prev.content, nextType, prev.desc, prev.globs), error: '' }))\n  }\n\n  /** 描述输入变更：同步 frontmatter description 行。 */\n  const onDescChange = (e) => {\n    const nextDesc = e.target.value\n    setForm((prev) => ({ ...prev, desc: nextDesc, content: rebuildContent(prev.content, prev.fmType, nextDesc, prev.globs), error: '' }))\n  }\n\n  /** globs 输入变更（自动规则）：同步 frontmatter globs 行。 */\n  const onGlobsChange = (e) => {\n    const nextGlobs = e.target.value\n    setForm((prev) => ({ ...prev, globs: nextGlobs, content: rebuildContent(prev.content, prev.fmType, prev.desc, nextGlobs), error: '' }))\n  }\n\n  /** 文本域直接编辑：回读 frontmatter，同步类型/描述/globs 控件（文本域是唯一真源）。 */\n  const onBodyChange = (e) => {\n    const parsed = parseRuleFm(e.target.value)\n    setForm((prev) => ({ ...prev, content: e.target.value, fmType: parsed.type, desc: parsed.description, globs: parsed.globs.join(', ') }))\n  }\n\n  /** 保存表单（rules.save；文件名非空 + 自动规则必须有 globs）。 */\n  const saveForm = () => {\n    const next = { ...form, saving: true, error: '' }\n    const file = String(form.file ?? '').trim()\n    if (!file) { setForm({ ...next, saving: false, error: '文件名不能为空' }); return }\n    if (form.fmType === 'auto' && globList(form.globs).length === 0) { setForm({ ...next, saving: false, error: '自动规则需要至少一个 glob（逗号分隔）' }); return }\n    setForm(next)\n    rpc('rules.save', { scope: form.scope, origin: form.origin, workspacePath: form.workspacePath, file, content: form.content })\n      .then((res) => {\n        if (res && res.ok) {\n          setForm(null)\n          notify('规则已保存：' + file)\n          load()\n        } else setForm((prev) => ({ ...prev, saving: false, error: res?.error ?? '保存失败' }))\n      }).catch((e) => setForm((prev) => ({ ...prev, saving: false, error: '保存异常: ' + String(e) })))\n  }\n\n  /**\n   * 删除规则（confirm 后走 rules.remove）。\n   * @param rule 目标规则\n   */\n  const removeRule = (rule) => {\n    const reveal = rule.scope === 'user' && rule.origin !== 'legacy'\n      ? '\\n若旧目录有同名规则，删除后它将重新生效。' : ''\n    if (!window.confirm('删除规则 ' + rule.absPath + '？（不可恢复）' + reveal)) return\n    rpc('rules.remove', { scope: rule.scope, origin: rule.origin, workspacePath: rule.workspacePath, file: rule.file })\n      .then((res) => {\n        if (res && res.ok) { notify('已删除：' + rule.file); load() } else notify(res?.error ?? '删除失败')\n      }).catch((e) => notify('删除异常: ' + String(e)))\n  }\n\n  /**\n   * 切换启用开关：本地乐观翻转（按 workspacePath+file 定位，失败回滚）。\n   * @param rule 目标规则（project 已注入 workspacePath）\n   */\n  const toggleRule = (rule) => {\n    const enabled = !rule.enabled\n    const applyLocal = (on) => setData((prev) => prev ? {\n      ...prev,\n      user: prev.user.map((r) => (rule.scope === 'user' && r.file === rule.file && (r.origin ?? 'current') === (rule.origin ?? 'current') ? { ...r, enabled: on } : r)),\n      projects: prev.projects.map((p) => (p.workspacePath === rule.workspacePath\n        ? { ...p, rules: p.rules.map((r) => (r.file === rule.file ? { ...r, enabled: on } : r)) }\n        : p)),\n    } : prev)\n    applyLocal(enabled)\n    rpc('rules.toggle', { scope: rule.scope, origin: rule.origin, workspacePath: rule.workspacePath, file: rule.file, enabled })\n      .then((res) => {\n        if (res && res.ok) { applyLocal(res.rule?.enabled === true); notify(res.rule?.enabled === false ? '已停用：' + rule.file : '已启用：' + rule.file) }\n        else { applyLocal(!enabled); notify(res?.error ?? '切换失败') }\n      }).catch((e) => { applyLocal(!enabled); notify('切换异常: ' + String(e)) })\n  }\n\n  /** 当前列表数据（按 Tab 取用户规则或当前工作区的项目规则）。 */\n  const rowsOf = () => {\n    if (!data) return []\n    if (tab === 'user') return data.user\n    return activeProject()?.rules ?? []\n  }\n\n  const renderTabs = () => React.createElement('div', { className: 'edrv-rules-tabs' },\n    React.createElement('button', { className: 'edrv-rules-tab' + (tab === 'user' ? ' on' : ''), onClick: () => switchTab('user') }, '用户规则'),\n    React.createElement('button', { className: 'edrv-rules-tab' + (tab === 'project' ? ' on' : ''), onClick: () => switchTab('project') }, '项目规则'),\n    React.createElement('button', { className: 'edrv-rules-new', title: '新建规则', onClick: openNew }, '＋ 新建规则'))\n\n  /** 项目 Tab 的工作区展示（不可编辑，自动跟随当前会话）。 */\n  const renderWsLine = () => {\n    if (tab !== 'project') return null\n    return React.createElement('div', { className: 'edrv-rules-ws-line', title: cwd ?? '' },\n      '工作区：' + (cwd ?? '当前会话未打开工作区'))\n  }\n\n  const renderEmpty = () => {\n    if (tab === 'project') {\n      if (!cwd) return '当前会话没有工作区，项目规则不可用（项目规则跟随会话所在工作区）'\n      if (!data?.projects?.length) return '当前 DSH 没有已注册的工作区；在目标工作区打开一次会话后再来管理'\n      if (!activeProject()) return '当前工作区未注册为 DSH workspace，暂不能管理其项目规则'\n      return '<工作区>/.dsh/rules/ 还没有规则，点击「＋ 新建规则」创建'\n    }\n    return '还没有用户规则（当前 DSH_HOME/rules/ 或旧目录 ~/.dsh/rules/），点击「＋ 新建规则」创建'\n  }\n\n  const renderBody = () => {\n    if (form) {\n      return React.createElement(RuleEditor, {\n        form, onType: onTypeChange, onDesc: onDescChange, onGlobs: onGlobsChange, onBody: onBodyChange,\n        onSave: saveForm, onCancel: () => setForm(null),\n      })\n    }\n    if (!data) return React.createElement('div', { className: 'edrv-rules-empty' }, '加载中…')\n    if (error) return React.createElement('div', { className: 'edrv-rules-err' }, error)\n    const rows = rowsOf()\n    if (!rows.length) return React.createElement('div', { className: 'edrv-rules-empty' }, renderEmpty())\n    const common = {\n      descCap,\n      narrow,\n      onEdit: (rule) => openEdit({ ...rule, workspacePath: rule.scope === 'project' ? cwd : undefined }),\n      onRemove: (rule) => removeRule({ ...rule, workspacePath: rule.scope === 'project' ? cwd : undefined }),\n      onToggle: (rule) => toggleRule({ ...rule, workspacePath: rule.scope === 'project' ? cwd : undefined }),\n    }\n    return React.createElement('div', { className: 'edrv-rules-list' },\n      rows.map((rule) => React.createElement(RuleRow, { key: rule.scope + ':' + (rule.origin ?? 'project') + ':' + rule.file, rule, ...common })))\n  }\n\n  return React.createElement('div', { className: 'edrv-rules-panel', ref: panelRef },\n    renderTabs(),\n    renderWsLine(),\n    React.createElement('div', { className: 'edrv-rules-hint' },\n      tab === 'user' ? '读取 DSH_HOME/rules/ 与 ~/.dsh/rules/；同名时当前目录优先，新建保存到当前目录' : '项目规则仅对所在工作区的会话生效（存放于 <工作区>/.dsh/rules/）'),\n    renderBody())\n}\n"],"mappings":"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"}

package/lib/index.js

@@ -3,7 +3,7 @@ import { chmod, copyFile, cp, lstat, mkdir, open, readFile, readdir, realpath, r
 import { basename, dirname, extname, isAbsolute, join, posix, relative, resolve, sep, win32 } from "node:path";
 import { chmodSync, existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, symlinkSync, unlinkSync, watch, writeFileSync } from "node:fs";
 import { fileURLToPath, pathToFileURL } from "node:url";
-import { createHash, randomUUID } from "node:crypto";
+import { createHash, createHmac, randomBytes, randomUUID, timingSafeEqual } from "node:crypto";
 import { homedir, tmpdir } from "node:os";
 import { DatabaseSync } from "node:sqlite";
 import { Buffer as Buffer$1 } from "node:buffer";
@@ -6551,13 +6551,6 @@ const PERSIST_DEBOUNCE_MS = 1e4;
 const HEAL_DEBOUNCE_MS = 3e3;
 /** cwd → 索引状态（随会话销毁清理）。 */
 const states = /* @__PURE__ */ new Map();
-/** 单调时钟：连续 put 的 ts 严格递增（同毫秒不并列，逐出/裁剪顺序可预期）。 */
-let clock = 0;
-/** 取下一时间戳（不小于真实时间且严格递增）。 */
-function nextTs() {
-	clock = Math.max(Date.now(), clock + 1);
-	return clock;
-}
 /** 条目原始值 → 合法条目（非法返回 null）。 */
 function entryOf(raw) {
 	if (!raw || typeof raw !== "object") return null;
@@ -6628,10 +6621,10 @@ function indexParse(text) {
 					type: e.type
 				});
 			}
-			if (!entries.length) continue;
+			const full = dir.full === true && entries.length === dir.entries.length;
 			dirs[rel] = {
 				ts: typeof dir.ts === "number" ? dir.ts : 0,
-				full: dir.full === true,
+				full,
 				entries
 			};
 		}
@@ -6650,11 +6643,12 @@ function trimPersist(data, maxDirs = 400, maxEntries = PERSIST_DIR_ENTRIES) {
 	const sorted = Object.entries(data.dirs).sort((a, b) => b[1].ts - a[1].ts);
 	for (const [rel, dir] of sorted) {
 		if (Object.keys(dirs).length >= maxDirs) break;
-		const full = dir.entries.length <= maxEntries;
+		const truncated = dir.entries.length > maxEntries;
+		const full = dir.full && !truncated;
 		dirs[rel] = {
 			ts: dir.ts,
 			full,
-			entries: full ? dir.entries : dir.entries.slice(0, maxEntries)
+			entries: truncated ? dir.entries.slice(0, maxEntries) : dir.entries
 		};
 	}
 	return {
@@ -6663,7 +6657,7 @@ function trimPersist(data, maxDirs = 400, maxEntries = PERSIST_DIR_ENTRIES) {
 		dirs
 	};
 }
-/** 取（或建）某 cwd 的索引状态，并惰性加载落盘快照（合并：文件 ts 更新才采纳）。 */
+/** 取（或建）某 cwd 的索引状态并惰性加载快照；加载期间真实列取优先，不被旧快照覆盖。 */
 function ensureState(ctx, cwd) {
 	const existing = states.get(cwd);
 	if (existing) return existing;
@@ -6676,6 +6670,7 @@ function ensureState(ctx, cwd) {
 			dirs: {}
 		},
 		stale: /* @__PURE__ */ new Set(),
+		lru: /* @__PURE__ */ new Map(),
 		dirty: false,
 		persistTimer: null,
 		healTimer: null,
@@ -6703,44 +6698,68 @@ async function loadIndex(state) {
 	try {
 		const parsed = indexParse(await readFile(treeCacheFile(state.cwd), "utf8"));
 		if (!parsed) return;
-		for (const [rel, dir] of Object.entries(parsed.dirs)) {
-			const cur = state.data.dirs[rel];
-			if (!cur || dir.ts > cur.ts) state.data.dirs[rel] = dir;
+		const snapshots = Object.entries(parsed.dirs).sort((a, b) => a[1].ts - b[1].ts);
+		for (const [rel, dir] of snapshots) {
+			if (state.data.dirs[rel]) continue;
+			state.data.dirs[rel] = dir;
+			touchDir(state, rel);
 		}
 		if (parsed.root && !state.data.root) state.data.root = parsed.root;
 	} catch (error) {} finally {
 		state.loading = false;
 	}
 }
-/** 命中：新鲜且未失效 → 条目（并刷新 ts 保活）；否则 null。 */
+/**
+* @private
+* @author ddj 2026年10月22号
+* @description 更新运行时访问顺序，超限时同步清理目录及失效标记。
+* @param state 工作区索引状态
+* @param rel 本次访问的相对目录
+*/
+function touchDir(state, rel) {
+	state.lru.delete(rel);
+	state.lru.set(rel, true);
+	if (state.lru.size <= 2e3) return;
+	const oldest = state.lru.keys().next().value;
+	if (oldest === void 0) return;
+	state.lru.delete(oldest);
+	state.stale.delete(oldest);
+	delete state.data.dirs[oldest];
+}
+/**
+* @public
+* @author ddj 2026年10月22号
+* @description 完整、新鲜且未失效才命中；访问仅更新 LRU，不续期硬 TTL。
+* @param cwd 工作区根
+* @param rel 相对目录
+* @returns 完整条目，或未命中时的 null
+*/
 function hitIndex(cwd, rel) {
 	const state = states.get(cwd);
 	if (!state) return null;
 	const dir = state.data.dirs[rel];
-	if (!dir || state.stale.has(rel)) return null;
-	const now = Date.now();
-	if (now - dir.ts > 6e4) return null;
-	dir.ts = now;
+	if (!dir || !dir.full || state.stale.has(rel)) return null;
+	if (Date.now() - dir.ts >= 6e4) return null;
+	touchDir(state, rel);
 	return dir.entries;
 }
-/** 更新某目录条目：写内存 + 打脏 + 防抖落盘；stale 撤销。 */
+/**
+* @public
+* @author ddj 2026年10月22号
+* @description 保存完整实列结果与确认时间，更新 LRU、撤销 stale 并防抖落盘。
+* @param ctx 工作区上下文
+* @param cwd 工作区根
+* @param rel 相对目录
+* @param entries 完整实列条目
+*/
 function putIndex(ctx, cwd, rel, entries) {
 	const state = ensureState(ctx, cwd);
-	const dirs = state.data.dirs;
-	if (!dirs[rel] && Object.keys(dirs).length >= 2e3) {
-		let oldest = rel;
-		let oldestTs = Infinity;
-		for (const [k, v] of Object.entries(dirs)) if (v.ts < oldestTs) {
-			oldestTs = v.ts;
-			oldest = k;
-		}
-		delete dirs[oldest];
-	}
-	dirs[rel] = {
-		ts: nextTs(),
-		full: entries.length <= PERSIST_DIR_ENTRIES,
+	state.data.dirs[rel] = {
+		ts: Date.now(),
+		full: true,
 		entries
 	};
+	touchDir(state, rel);
 	state.stale.delete(rel);
 	state.dirty = true;
 	schedulePersist(state);
@@ -6805,6 +6824,7 @@ function disposeIndex(cwd) {
 		state.healTimer = null;
 	}
 	if (state.dirty) persistNow(state);
+	state.lru.clear();
 	states.delete(cwd);
 }
 /** 错误 → 用户文案（DirListError 用自身 message，其余带上下文）。 */
@@ -6857,6 +6877,7 @@ async function listDirCached(ctx, cwd, rel, force) {
 			if (error instanceof DirListError && error.code === "not-found") {
 				if (state.data.dirs[rel]) {
 					delete state.data.dirs[rel];
+					state.lru.delete(rel);
 					state.dirty = true;
 					schedulePersist(state);
 				}
@@ -11959,7 +11980,140 @@ function settingsDocPath(configuredPath, requestedPath, platform = process.platf
 	}
 }
 //#endregion
+//#region src/shared/textPages.ts
+/** Bounded, read-only text paging protocol. @author ddj 2026年10月22号 */
+const TEXT_PAGE_BYTES = 262144;
+//#endregion
+//#region src/textPages.ts
+/**
+* Create a Host-owned pager with process-local authenticated cursors.
+* @public @author ddj 2026年10月22号
+* @returns A bounded reader requiring an independently authorized range capability.
+*/
+function createTextPages() {
+	const secret = randomBytes(32);
+	/** @private @author ddj 2026年10月22号 @param payload Authenticated state. @returns Signed cursor. */
+	function signCursor(payload) {
+		const body = Buffer.from(JSON.stringify(payload)).toString("base64url");
+		return body + "." + createHmac("sha256", secret).update(body).digest("base64url");
+	}
+	/** @private @author ddj 2026年10月22号 @param token Untrusted cursor. @returns Verified state or null. */
+	function parseCursor(token) {
+		if (typeof token !== "string" || token.length > 8192) return null;
+		const parts = token.split(".");
+		if (parts.length !== 2 || !/^[A-Za-z0-9_-]+$/.test(parts[0])) return null;
+		const signature = Buffer.from(parts[1], "base64url");
+		const expected = createHmac("sha256", secret).update(parts[0]).digest();
+		if (signature.length !== expected.length || !timingSafeEqual(signature, expected)) return null;
+		try {
+			const payload = JSON.parse(Buffer.from(parts[0], "base64url").toString("utf8"));
+			if (typeof payload.identity !== "string" || typeof payload.version !== "string" || typeof payload.sessionId !== "string" || typeof payload.path !== "string" || typeof payload.pendingCR !== "boolean" || !Number.isSafeInteger(payload.offset) || payload.offset <= 0) return null;
+			return payload;
+		} catch {
+			return null;
+		}
+	}
+	/**
+	* Read at most 256 KiB, validating freshness before and after IO.
+	* @public @author ddj 2026年10月22号
+	* @param source Authorized range capability; absent means unsupported.
+	* @param args Request identity and optional signed cursor.
+	* @returns Strict UTF-8 text or an explicit fail-closed result; never partial success on mutation.
+	*/
+	async function readTextPage(source, args) {
+		if (!source) return failure("unsupported", "Host does not expose authorized range reads");
+		const cursor = args.cursor === void 0 ? void 0 : parseCursor(args.cursor);
+		if (cursor === null || cursor && (cursor.identity !== source.identity || cursor.sessionId !== (args.sessionId ?? "") || cursor.path !== args.path)) return failure("invalid-cursor", "Cursor does not belong to this file and session");
+		try {
+			const before = await source.stat();
+			if (!before || before.type !== "file" || typeof before.version !== "string" || !Number.isSafeInteger(before.size) || before.size < 0) return failure("unsupported", "Regular file size and opaque version are required");
+			if (cursor && (cursor.version !== before.version || cursor.offset >= before.size)) return failure("stale", "File changed; restart text preview");
+			const offset = cursor?.offset ?? 0;
+			const length = Math.min(TEXT_PAGE_BYTES, before.size - offset);
+			const bytes = await source.readRange(offset, length);
+			const after = await source.stat();
+			if (!after || after.version !== before.version || after.size !== before.size || after.type !== "file") return failure("stale", "File changed during text read");
+			if (!(bytes instanceof Uint8Array) || bytes.byteLength !== length) return failure("read-failed", "Range reader returned an incomplete or oversized page");
+			return decodePage(bytes, before, offset, cursor?.pendingCR ?? false, args, source.identity, signCursor);
+		} catch (error) {
+			return failure("read-failed", String(error));
+		}
+	}
+	return readTextPage;
+}
+/** @private @author ddj 2026年10月22号 @param reason Failure discriminator. @param error User-visible error. @returns Failure result. */
+function failure(reason, error) {
+	return {
+		ok: false,
+		reason,
+		error
+	};
+}
+/**
+* Keep an incomplete final UTF-8 sequence for a bounded re-read on the next page.
+* @private @author ddj 2026年10月22号
+* @param bytes Raw page. @returns Complete prefix length; invalid sequences remain for fatal decoding.
+*/
+function utf8Prefix(bytes) {
+	let start = bytes.length - 1;
+	while (start >= 0 && (bytes[start] & 192) === 128) start--;
+	if (start < 0) return bytes.length;
+	const lead = bytes[start];
+	let width = 1;
+	if (lead >= 194 && lead <= 223) width = 2;
+	else if (lead >= 224 && lead <= 239) width = 3;
+	else if (lead >= 240 && lead <= 244) width = 4;
+	return bytes.length - start < width ? start : bytes.length;
+}
+/**
+* Decode one page preserving original line endings without buffering a long line.
+* @private @author ddj 2026年10月22号
+* @param bytes Raw page. @param info File snapshot. @param offset Current offset.
+* @param pendingCR Previous trailing CR. @param args Request identity. @param identity Authorized target identity.
+* @param signCursor Host cursor signer. @returns Page or strict decoding failure.
+*/
+function decodePage(bytes, info, offset, pendingCR, args, identity, signCursor) {
+	const consumed = offset + bytes.length === info.size ? bytes.length : utf8Prefix(bytes);
+	let text;
+	try {
+		text = new TextDecoder("utf-8", {
+			fatal: true,
+			ignoreBOM: true
+		}).decode(bytes.subarray(0, consumed));
+	} catch {
+		return failure("not-text", "File is not valid UTF-8");
+	}
+	if (text.includes("\0")) return failure("not-text", "Binary text preview is unsupported");
+	if (offset === 0 && text.startsWith("")) text = text.slice(1);
+	if (pendingCR) text = "\r" + text;
+	const nextOffset = offset + consumed;
+	const eof = nextOffset === info.size;
+	const trailingCR = !eof && text.endsWith("\r");
+	if (trailingCR) text = text.slice(0, -1);
+	const nextCursor = eof ? null : signCursor({
+		identity,
+		sessionId: args.sessionId ?? "",
+		path: args.path,
+		version: info.version,
+		offset: nextOffset,
+		pendingCR: trailingCR
+	});
+	return {
+		ok: true,
+		text,
+		version: info.version,
+		offset: nextOffset,
+		size: info.size,
+		eof,
+		nextCursor,
+		encoding: "utf-8",
+		partialLine: !eof && !/[\r\n]$/.test(text)
+	};
+}
+//#endregion
 //#region src/rpc.ts
+/** Process-local cursor signer; reads must stay on the Host filesystem capability. */
+const readTextPage = createTextPages();
 /** cwd → 上次 stale 自动清理时间：全量轮询（EditorView/DiffBadge/Dock 各自 5s）节流，避免每轮都读文件算指纹。 */
 const staleCheckedAt = /* @__PURE__ */ new Map();
 /** stale 自动清理最小间隔。 */
@@ -12049,7 +12203,10 @@ async function readTargetOf(ctx, sc, path) {
 			err: "文件不存在",
 			resolvedPath: fs.processPath(target)
 		};
-		if ((info.size ?? 0) > 33554432) return { err: "文件过大（>32MB），不支持整文件预览" };
+		if ((info.size ?? 0) > 33554432) return {
+			err: "文件过大（>32MB），不支持整文件预览",
+			code: "file-too-large"
+		};
 		return {
 			target,
 			fs,
@@ -12066,13 +12223,11 @@ async function readTargetOf(ctx, sc, path) {
 * @returns { ok:false } 形态载荷
 */
 function targetErrOf(prep) {
-	return prep.resolvedPath !== void 0 ? {
+	return {
 		ok: false,
 		error: prep.err,
-		resolvedPath: prep.resolvedPath
-	} : {
-		ok: false,
-		error: prep.err
+		...prep.resolvedPath !== void 0 ? { resolvedPath: prep.resolvedPath } : {},
+		...prep.code ? { code: prep.code } : {}
 	};
 }
 /**
@@ -12601,6 +12756,44 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 				results: await applyDecisions(ctx, sc.session, sc.cwd, bucket, Array.isArray(args.items) ? args.items : [])
 			};
 		},
+		/** @author ddj 2026年10月22号 @param args Read-only request. @returns Bounded official range read, or unsupported on older providers; never bypasses Host IO. */
+		"edrv.textPage": async (args) => {
+			const sc = await requireSession(ctx, args.sessionId);
+			if ("err" in sc) return {
+				ok: false,
+				error: sc.err,
+				reason: "read-failed"
+			};
+			try {
+				const target = await resolveTarget(ctx, sc.session, args.path);
+				const fs = ctx.get("fs");
+				if (typeof fs?.readByteRange !== "function" || typeof fs.stat !== "function") return readTextPage(void 0, args);
+				const targetKey = typeof target === "string" ? target : target.targetKey;
+				if (typeof targetKey !== "string") return readTextPage(void 0, args);
+				/** @author ddj 2026年10月22号 @returns Provider metadata used for before/after freshness checks. */
+				function statPage() {
+					return fs.stat(target);
+				}
+				/** @author ddj 2026年10月22号 @param offset Verified cursor position. @param length Bounded byte count. @returns Bytes through the official provider only. */
+				function readRange(offset, length) {
+					return fs.readByteRange(target, {
+						offset,
+						length
+					});
+				}
+				return readTextPage({
+					identity: JSON.stringify([sc.cwd, targetKey]),
+					stat: statPage,
+					readRange
+				}, args);
+			} catch (error) {
+				return {
+					ok: false,
+					error: "读取失败：" + String(error),
+					reason: "read-failed"
+				};
+			}
+		},
 		"edrv.read": async (args) => {
 			const settingsTarget = settingsTargetOf(ctx, args.path);
 			if (settingsTarget && args.encoding !== "base64") try {
@@ -12665,7 +12858,8 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 				}
 				if ((prep.info.size ?? 0) > 8388608) return {
 					ok: false,
-					error: "文件过大（>8MB），不支持整文件预览"
+					error: "文件过大（>8MB），不支持整文件预览",
+					code: "file-too-large"
 				};
 				const content = await prep.fs.readText(prep.target);
 				return {