dsh-file-mention

Codex 式 @ 文件引用，DeepSeek Harness (DSH) Web 插件。

三个能力，全部挂在官方扩展点上，不改动 DSH 任何内置包。输入框的 ↑/↓ 输入历史 已拆分为独立插件 dsh-input-history（发送落库 localStorage 全局环、同步召回），本插件不再包含历史逻辑：

功能	说明
@ 文件/文件夹提及	输入框敲 @ 弹出工作区文件与文件夹菜单（git 索引优先、嵌套 git 仓库递归展开、fzf 风格模糊过滤）；菜单行显示文件名/文件夹名主标题（文件夹带 /）+ 全路径小字副标题，宽度与输入框一致；选中插入纯文本 @token 相对路径 ——token 整体着色（无胶囊宽度上限），路径明文随行，模型零搜索直达文件；文件夹引用注入 kind="directory"
token/胶囊点击预览	点击输入框内的着色 token 或会话气泡里的灰色胶囊，直接在右侧 better-sidebar 编辑器打开该文件预览（未安装时回退系统默认打开方式）；pick 的 token 精确解析，手输 token 在 stem 唯一时也可解析
菜单样式覆盖	注入一段 scoped CSS（:has([data-source="file"])），只影响文件组菜单：满宽 + 两行布局；其他 trigger 菜单（斜杠命令、子代理）保持内建尺寸

安装

dsh plugin --profile web add /path/to/dsh-file-mention

dsh.bundle.patch 声明会让 CLI 自动把本包追加进 profile 的 bundles（宿主半随之挂载）。然后重启 DSH 桌面应用并刷新页面。零运行时依赖，无 peer / 构建要求。

卸载：dsh plugin --profile web remove dsh-file-mention。

开发迭代：改完代码运行 scripts/deploy.sh（同步 lib 到 profile 安装目录）后重启。

架构

┌ composer (ui-conversation, 不改) ─────────────────────────────┐
│ @ 触发 → inputTriggers 管线 → 本插件 source "file"            │
│   candidates: host files.index + dirs 合并模糊评分              │
│               行 = name(文件名/文件夹名，文件夹带 /)           │
│                    + description(全路径副标题)                 │
│   onPick    → insert-text → "@token rel/path "（无占位/无胶囊）│
│   lexicon   → 文件 + 文件夹全部可着色 token → 平台 scanTextRefs │
│   subscribeLexicon → 索引落定后通知管线重扫（着色及时生效）    │
│   发送      → 草稿即文本，chip-free 跳过序列化直落 sink       │
│ token/胶囊点击（捕获）→ pick 登记 / 唯一 stem 反解 → 绝对路径   │
│   → betterSidebar.openFile → 回退 workspaces.openPath          │
│ 菜单 CSS    → :has([data-source="file"]) 满宽 + 两行行布局    │
└──────────────────────────────────────────────────────────────┘
                       │ /file-mention/api (POST JSON, 浏览器信任围栏)
┌ host 半 ────────────┴────────────────────────────────────────┐
│ files.index  git ls-files --cached --others --exclude-standard │
│              嵌套 git 仓库条目（dir/）递归展开（同上限/深度界）  │
│              目录 roll = 文件祖先推导 + 嵌入式仓库 dir/ 条目    │
│              （失败/非 git → opendir walk 兜底，含空目录，     │
│                TTL 10s 缓存）                                  │
│ files.read   遗留接口（纯文本模式不再调用；保留供测试覆盖）    │
└──────────────────────────────────────────────────────────────┘

• 客户端 bundle 以 window.__ModuleLoader__.load 约定注册，不 require 任何模块（纯逻辑，无 React），规避 externals 漂移，无需打包器。
• 菜单渲染、键盘仲裁、IME 守卫、纯文本装饰（mark.textRef 着色）、气泡 refChip 投影全部由 DSH 内建管线承担。
• 与 @subagent、@cordis 两个 @ 源共存（组名 file，order 2）。

引用格式（宿主侧注入，dsh-at-file 同款）

选中文件插入干净纯文本提及 @token （token = 去扩展名文件名）；发送后的处理全部在宿主侧 agent/pre-step 边界完成：

• 宿主扫描发出的用户消息里的 @token，按「pick 注册（精确）→ 索引唯一 stem」解析，stat 校验存在后，注入一条独立的引用消息给模型：

<workspace-reference path="lbk-flutter-common/modules/fiat/lib/screens/otc/home/otc_home_tab_page.dart" kind="file" />

• 文件夹同样可引用：目录与文件共享同一索引与 token 语法（src/app/ → @app），选中或手输命中后注入 <workspace-reference path="lib/" kind="directory" />（目录 path 保留尾部 /）；token/胶囊点击预览对目录走系统打开方式（跳过 better-sidebar 编辑器）

…