在 DeepSeek Harness 的 Web 界面中开发智能体时，将本地文件内容注入模型上下文通常需要手动复制粘贴或使用额外的工具。dsh-at-file 插件简化了这一流程，它允许通过 @ 符号在工作区中选择文件，并将其内容注入提示词，而无需复制粘贴或额外的工具往返。
功能说明¶
该插件提供以下核心能力：
- 工作区文件引用：在 Web composer 中输入
@，即可列出当前工作区的文件。 - 过滤候选者：支持按文件名（basename）、路径前缀或子字符串进行筛选。
- 自动注入：选择文件后，其内容会被注入到模型上下文中，无需手动复制。
- 日志记录：注入的消息会被记录在会话日志中，并标记为
at-file来源，确保输入可重建。
安装¶
使用 DeepSeek Harness 的 CLI 安装插件。插件需要安装到 web profile：
dsh plugin --profile web add github:MisRightW/dsh-at-file
# 或者从 Git URL 安装
dsh plugin --profile web add https://github.com/MisRightW/dsh-at-file.git
# 或者从 npm 包安装
dsh plugin --profile web add dsh-at-file
注意：首次从 GitHub 安装时，pnpm 会请求允许构建包，请按提示操作。
使用步骤¶
- 在 DeepSeek Harness 的 Web GUI 中打开一个会话，并选择对应的工作区目录。
- 在 composer 输入框中输入
@。 - 在弹出的文件列表中选择文件，支持使用 basename（如
@main）、路径前缀（如@src/m）或子字符串进行过滤，使用箭头键选择，按 Enter 确认。 - 发送提示词。所有可解析的
@path令牌会在发送前被展开为注入的文件内容块；无法解析或超大的令牌将保持为普通文本。
配置项¶
Host 端通过 cordis.patch.yml 接受以下配置：
| Key | Default | Meaning |
|---|---|---|
maxFiles |
1000 | 单次列表调用返回的最大索引行数 |
maxDepth |
8 | 目录索引的最大遍历深度 |
maxBytes |
65536 | 单个文件注入的字节上限，超过则不索引 |
maxReferences |
8 | 每次预步骤展开的最大引用数 |
skipDirectories |
.git, node_modules, dist, build, out, coverage, __pycache__, .venv |
不会被索引的目录名（不区分大小写） |
差异说明¶
该插件与 DeepSeek Harness 仓库内的树内实现功能一致，但在 UI 细节上存在差异：
- 草稿芯片：不支持渲染选中的路径（树内版本支持）。
- 本地化：菜单组标题显示为原始来源名
file，而非本地化文本（树内版本支持）。 - 权限：插件以当前 DSH 进程的权限运行，请确保安装前检查源码与许可证。
生态与链接¶
该插件为社区贡献，由开发者 MisRightW 维护，遵循 MIT 许可证。其源码与文档位于 GitHub。社区目录提供了更多插件的发现与集成方式。
