前言¶
一個倉庫中可能同時存在 AGENTS.md、CLAUDE.md、嵌套指令、用戶全局指令以及 Claude 規則。DeepSeek Harness、Codex 和 Claude Code 對這些指令源的發現方式並不一致。這意味着同一個工作區可能會向不同的編碼智能體呈現不同的指令表面。Sightline 將這種隱藏的差異轉化爲一份緊湊的對比報告。
插件簡介¶
dsh-sightline 是一個 DeepSeek Harness(DSH)工作流插件。由 Charlie-Wang-03 維護,用於查看 DeepSeek Harness 實際加載了哪些工作區指令源,以及 Codex 和 Claude Code 會爲同一個倉庫和工作目錄加載哪些指令源。
核心功能¶
插件通過確定性規則解析並對比不同智能體的指令視圖,核心能力包括:
* 發現相關的指令源。
* 爲每個支持的智能體解析一個有效的指令表面。
* 使用確定性結構規則對比這些表面。
* 在 DSH Web ToolView 中可視化展示一致、分歧和未知狀態。
安裝與啓用¶
使用官方安裝命令添加插件:
dsh plugin --profile web add dsh-sightline@0.1.0
安裝後啓動 DSH Web 配置文件:
dsh web
使用方法¶
在一個基於 Git 倉庫的 DSH 會話中,直接調用 sightline 工具。例如:
Use sightline and tell me where the DSH, Codex, and Claude instruction views diverge.
插件會針對同一個會話根目錄和倉庫根目錄解析 DSH、Codex 和 Claude 的視圖。
工作原理與限制¶
插件通過適配器模式處理不同智能體的發現語義,對比層保持純化且與智能體無關。需要注意的是:
- 本地與只讀:Sightline 是本地優先且只讀的,不會修改指令文件,也不會向 Sightline 擁有的服務發送指令文件正文。
- 隱私邊界:完整的規範報告作爲 DSH 工具元數據保留,用於 Web ToolView 和回放,包含倉庫根目錄等信息。但模型面對的投影較窄,默認省略絕對工作區路徑和完整診斷信息。
- 兼容性:插件已驗證兼容 DeepSeek Harness
0.1.1-rc.2、Node^22.19.0 || >=24.0.0以及 pnpm11.7.0。
總結¶
dsh-sightline 提供了一種在 DeepSeek Harness 生態中排查多智能體指令不一致問題的手段。其開源協議爲 MIT,屬於社區獨立項目。
- 插件目錄: dsh-sightline
- 源碼倉庫: Charlie-Wang-03/dsh-sightline