前言¶

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