前言¶

DeepSeek Harness (DSH) 采用插件化架构，旨在通过组合工具解决代码工程问题。面对大型代码库，传统的全局搜索或文件读取往往效率低下或导致上下文溢出。dsh-fovea 插件提供了一种“视界聚焦”的仓库智能方案：将代码库编译为带权重的类型化图，并在模型关注的区域提供高精度信息，在非关注区域保持低成本。

核心能力¶

该插件提供以下核心功能：

• 仓库概览与定位：fovea_sketch 用于不熟悉仓库的初期工作，强调生产锚点和结构枢纽，同时压缩测试和远端区域；fovea_focus 将焦点置于符号、路由、概念或文件上，揭示其语义邻域；fovea_dwell 在不重复已披露周边的情况下扩大当前焦点范围（默认扩散系数为 2）；fovea_impact 在跨文件变更前，根据因果路径对文件的“冲击半径”和审查顺序进行排序。
• 交互与同步：当 ctx.commands 存在时注册 /fovea 命令，提供 status、reset、sketch、focus、dwell、impact 等命令；当 ctx.skills 存在时注册 fovea skill；提供静默基线校准，并在仓库结构发生显著漂移时记录引导信息。

安装与前置条件¶

在安装前，请确保环境满足以下依赖要求：

• Node.js ^22.19.0 || >=24.0.0
• pnpm 11.20.0
• DeepSeek Harness 服务版本 0.1.0-rc.6
• Cordis ^4.0.1
• Git（用于跟踪文件发现、基线影响和共同变更历史）

安装命令如下：

pnpm dlx @monotykamary/dsh@0.1.0-rc.7 plugin --profile web add dsh-fovea

典型工作流¶

推荐的调用顺序如下：

1. 在不熟悉的仓库开始工作时，使用 fovea_sketch 强调生产锚点和结构枢纽。
2. 使用 fovea_focus 作用于最具体的任务名词（可配合 path、language、kind 过滤器）。
3. 使用原生 grep 或文件读取工具精确检查建议的窗口。
4. 如果初始邻域过窄，使用 fovea_dwell 扩大焦点。
5. 在完成跨文件变更前，使用 fovea_impact 评估后果。

命令行交互示例：

/fovea status
/fovea focus <query>
/fovea dwell [factor]
/fovea impact [files...]

注意事项¶

• 不替代原生工具：Fovea 旨在决定“在哪里”以及“为什么”，随后仍需使用原生 grep 或精确文件读取来检查选定的源码。
• 配置容错：未知的配置键会导致插件加载失败。
• 子进程环境：远程子进程提供程序无法执行宿主包的二进制文件。在该执行环境中安装 ast-grep 或设置 FOVEA_AST_GREP 为该提供程序可见的路径。

生态与链接¶

dsh-fovea 是 DeepSeek Harness 生态的一部分，由 monotykamary 维护，采用 MIT 许可证。

• 插件目录：https://www.skillhub.cn/plugins/monotykamary/dsh-fovea
• 源码地址：https://github.com/monotykamary/dsh-fovea