前言¶
一个仓库中可能同时存在 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