dsh-file-tree
DSH 原生右侧栏文件面板：工作区文件树 + 就地预览（文本/图片）+ 一键 @文件 引用到输入框
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:jackchen13755/dsh-file-tree#1bac80156836369bd5f5a2e13ad2f25cde550433File Tree 以 dsh-file-tree 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DSH 原生右侧栏里的文件面板 —— 工作区文件树、就地预览（文本 / 图片）、按文件名搜索，以及一键 @文件 引用到输入框。
会话 → 右侧栏 → 「+ 新标签页」 → 文件面板
侧栏的文件树本来是 dsh-better-sidebar 接管的，但在 DSH 0.1.6-alpha.2 上它的文件行点击是静默空操作（实测：真实鼠标点击后不新增标签、无提示、无报错；切换会话再切回也不会补开）。修它等于改第三方编译产物，且它下次更新就被覆盖。
所以这个插件从零走官方扩展点，不接管任何布局：
| 面 | 用的接口 |
|---|---|
| 标签类型 | ctx.sidebarRightTabs.register({ id, kind, title, guide }) |
| 标签体 | ctx.slots.register 挂 sidebar.right.pane.tab（key = 类型 id） |
| 文件读取 | ctx.webServer.register({ kind: 'prefix' }) 一条会话级路由 |
| 会话工作区 | ctx.sessions.get(id).header.cwd |
@文件 | 产品自带的 mention 文法（纯文本 @path / @"path with spaces"） |
| 打开文件 | dsh-resource://file/session/<id>/<path> 地址 → 官方预览标签 |
| 图标 / 着色 | 产品的 FileTypeIcon / CodeBlock（ui-primitives，惰性加载） |
文件树：懒加载（每展开一个目录才读一次），官方彩色文件类型图标（产品的 FileTypeIcon，按路径自动分类）、缩进导轨、目录 ▸/▾、右侧文件大小；操作按钮悬停才出现（▤ 行内预览 / ＠ 引用 / ⧉ 复制路径）；.git、node_modules、dist 等噪音目录不列入；符号链接仅当真实解析仍在工作区内才显示。
打开文件（按类型自动分流）：
dsh-resource://file/session/<id>/<path> 地址交给侧栏控制器，等价于会话里点文件链接），带完整语法着色（实测 12 种 token 颜色 + CodeMirror 行号槽）<img> + data URL，SVG 也按图片渲染；SVG 还多一个「↗ 源码」按钮切到官方文本视图）▤ → 任意文件在本面板预览：文本用产品自带的 CodeBlock（shiki 着色 + 行号 + 复制按钮），图片内联（≤3MB），二进制/超大文件明确说明原因sessionStorage）：切到别的标签再切回来，树还是你离开时那样搜索：顶部输入框按文件名搜索（250ms 防抖、广度优先、跳过噪音目录、上限 200 命中），结果显示所在目录与大小，Esc 清空。
@文件 引用：
＠，或预览头部的「＠ 引用」@"my file.txt"data-composer-text-ref），不是一坨纯文本⧉ 复制绝对路径dsh plugin --profile web add github:jackchen13755/dsh-file-tree
# 本地源码（开发用）
dsh plugin --profile web add link:/path/to/dsh-file-tree
装完硬刷新浏览器（Cmd/Ctrl+Shift+R）。
写在 profile 的 cordis.patch.yml 行内（都有默认值）：
- insert:
- id: file-tree
name: 'dsh-file-tree'
config:
readLimitBytes: 524288 # 文本预览上限（1KB–8MB）
imageLimitBytes: 3145728 # 图片预览上限（0–16MB）
listLimit: 2000 # 单目录条目上限
searchLimit: 200 # 搜索命中上限
403。sessionId + 工作区相对路径；宿主从会话存储解析工作目录，再 realpath 规范化后做包含性校验 —— ../、绝对路径 /etc/hosts、指向工作区外的符号链接全部拒绝（集成测试逐条断言）。<img> 触发不到任何操作。零依赖离线构建（不需要 npm install）：
bash scripts/build.sh # host 半 tsc → lib/；client 半 tsc + 自写 CJS 内联 → lib/client.js
node scripts/smoke-client.mjs # 浏览器半冒烟：按 ModuleLoader 契约加载并断言注册
类型来自真实 DSH 安装（脚本自动探测 $DSH_HOME/profiles/*、$DSH_CHECKOUT、npx 缓存，可用 DSH_CHECKOUT= 指定）。
src/index.ts host 插件体：配置 + 挂路由
src/host/files.ts 目录列举 / 预览读取 / 有界搜索（含路径包含性校验）
src/host/fence.ts loopback + sessionId → 工作目录
src/host/routes.ts POST /dsh-file-tree/{context,list,read,search}
src/client/index.ts 注册「文件面板」标签类型 + 标签体插槽
src/client/panel.ts 面板 UI（树 / 预览 / 搜索）
src/client/reference.ts @文件 文法与插入输入框
选型依据（为什么必须走原生标签而不是自建列）：docs/why-native-tabs.md。
＠ 插入后输入框出现 @<相对路径> 且被渲染为引用芯片、点文件行在标签页用官方预览打开（12 种 token 颜色 + 行号）、行内 ▤ 预览同样着色、控制台 0 报错。dsh >= 0.1.5-rc.1。↻ 刷新。CodeBlock 提供（未自带高亮器）；若某个组合里产品没提供 ui-primitives，会自动降级为无着色的行号 <pre>。MIT