Seryta/dsh-file-mention

README excerpt

dsh-file-mention — 文件路径引用 DSH(DeepSeek Harness)Web GUI 插件:在输入框里用 @ (或 /file 命令)模糊搜索 会话工作区(cwd)下的文件路径,pick 后插入 @相对路径 引用随消息发出。 Agent 自带本地文件工具,按路径自行读取或操作(查、改、测试、移动)—— 不把文件内容灌进上下文 (引用自读语义,与内容注入型插件不同)。 用法 @ 内联触发 (推荐): 1. 输入 @ 即弹出工作区 浅层条目 菜单(开头或空格后输入 @ 触发, 与 TUI 惯例一致);继续输入路径片段(如 @src/butt )自然过滤; 2. 候选菜单「file」分组列出匹配的 文件与目录 (最多 20 条,带路径副标题); 3. 键盘选中后按 Enter 或 Tab 补全 当前高亮项(鼠标点击同样生效)。 补全遵循文件系统惯例:文件补全为 @file (空格结束);目录补全为 @dir/ —— 确认空目录 才补空格结束, 有子内容(或未确认)则不加空格 , 光标停在斜杠后继续输入子路径浏览;想提前结束目录浏览,手动输一个 空格即可(token 遇空白断开)。 /file 命令 ( @ 触发异常的备用入口): 1. 输入 /file 后 直接接路径片段 (如 /fileAGENTS ,无空格——harness 的 trigger 检测在 token 含空格时失效); 2. pick 后同样插入 @相对路径 。 示例: 请修复 @src/main.go 里的空指针 → agent 按 src/main.go 定位并操作。 功能特性 - 附件条 dock :composer 上方实时显示 draft 中所有 @路径 引用 (📁/📄 图标 + 去重), × 精确删除该引用(引用自读语义下点击打开由 agent 按路径自行完成); - 引用装饰(lexicon) :纯单词形态的文件名(如 LICENSE / Makefile )在被 引用时由管线高亮装饰,与其他引用(技能/命令)同视觉;含 . / / 的路径 引用受管线 token 语法( [@/][\w-]+ )限制不参与装饰(官方机制,如实降级); - 空查询浅层菜单 :只输入 @ 也弹出工作区顶层条目(BFS 遍历天然浅层 优先),无需先想路径片段; - warm 预热 :打开会话即后台预热该工作区的索引(官方 warm 钩子),输入 @ 时几乎零延迟弹菜单(命中服务端 30s 缓存),无 1.5s 首查等待; - 搜索排名 :子序列模糊匹配(打错中间字母也能命中)+ basename 命中加权 + 浅层优先(深度轻微惩罚);同等匹配质量下目录略优先; - 目录候选 :目录与文件同列(📁/📄 图标区分),pick 目录插入 @dir/ 尾斜杠引用;目录按"是否有子…

Category