dsh-at-file

DeepSeek Harness Web GUI 的 Codex 风格 @ 文件提及插件。在输入框输入 @，边输入边智能搜索工作区文件（和目录），回车附加，发送时把引用内容交给模型。

输入框:   修复 README  @README.  ← 光标处浮出文件选择器
            ┌────────────────────────────┐
            │ 📄 README.md               │
            │ 📁 docs/                   │
            └────────────────────────────┘
草稿:     修复 README @README.md    ← 可读的纯文本 token
附加条:   📄 README.md  ×           ← 输入框上方可点击的文件链接
模型:     <file path="README.md">…内容…</file>   ← 发送时注入

草稿里是纯文本 @路径 token（无芯片、不溢出）；Host 在每个 agent 的 pre-step 边界把它展开成文件内容。附加目录会递归展开其下所有文件（有界）。

安装

dsh plugin --profile web add https://github.com/omdsh-dev/dsh-at-file/archive/refs/heads/main.tar.gz

随后重启 web 服务以加载 host 半部分与新的 client bundle。插件依赖标准 web bundle 组合（ui-input-trigger 的 @ 管线、api-gateway client Remote、会话插槽），默认的 dsh web profile 均已包含。

启用开关在 设置 → File mentions（at-file settings 命名空间，由 harness 的一行 allowlist 暴露）。

配置

Host 侧可调参数在 cordis.yml 的插件行上：

- id: dsh-at-file
  name: dsh-at-file
  config:
    maxIndexedFiles: 5000      # 每个工作区索引条目数上限（到达即停止遍历并如实报告截断）
    maxFileBytes: 262144       # 单个附加文件字节上限；超限文件拒绝附加，绝不截断
    ignoreDirs: ['.git', 'node_modules']   # 遍历时跳过的目录名

对模型的影响

权限边界

• 选择器只提供会话工作区内的条目（默认跳过 .git/node_modules）。Host 把 @路径 token 解析到会话 cwd 下，绝不跟随 .. 越出工作区。内容展开在 Host 的 agent/pre-step 边界进行，仅扫描 source.kind === 'user' 的消息。
• 点击打开文件走 harness 自带的 host.openPath（本就限制在 loopback）。

开发

pnpm install            # 链接同级 dsh 仓库用于构建与测试
pnpm run check          # typecheck + 测试 + 构建
pnpm run test           # vitest（host 文件系统/mention/运行时，client 源/附加条/设置区/装配）
pnpm run build          # esbuild 构建 host/client/invariant 三份 bundle + tsc 声明文件

本仓库假设 harness 位于 ../dsh（相对本仓库），供开发期 link: 解析与测试别名使用。

已知限制

• 工作区索引按会话缓存 30 秒；此后新建的文件需等下一次菜单打开刷新。
• @路径 token 不能含空白或 @（token 语法为 @[^\s@]+）；文件名带空格时无法直接输入提及。
• 选择器分组标题显示源名（at-file），因为 slash 菜单的标题词典归 harness 所有。

License

MIT