dsh-inspector

简体中文 | English

npm 包名:dsh-inspector · GitHub 仓库: CocoSgt/dsh-inspector

DeepSeek Harness(dsh)的第三方插件:在 Web 界面右侧打开一个「约束文件」面板, 按 harness 真实的载入顺序展示并管理当前会话的指引链——全局 $DSH_HOME/AGENTS.md → 项目根 → … → 会话 cwd 的每一级目录——外加四个技能根 目录的状态。面板的信息架构完全复刻官方 dsh-agent-instructions 的发现算法, 所见即模型所得。

打开位于某个项目目录中的会话后,点会话头部的「约束文件」按钮即可开关面板; 面板自动跟随当前会话的工作区目录。界面提供中英双词典,跟随宿主语言设置。

指引链模型(与 harness 一字不差)

面板展示的层级、去重与状态标注都对齐 packages/context/agent-instructions 的真实行为:

1. 全局层:$DSH_HOME/AGENTS.md(默认 ~/.dsh/AGENTS.md)。只认 AGENTS.md,对所有会话生效,永远最先载入。
2. 项目链:从会话 cwd 向上找最近含 .git 的目录作为项目根(找不到则 cwd 即根);项目根 → cwd 的每一级目录都探测 4 个候选:AGENTS.md、 CLAUDE.md(基础)与 AGENTS.local.md、CLAUDE.local.md(本地覆盖层, 惯例不入库)。存在的全部载入;同目录内去掉首尾空白后内容相同的只保留最 先的候选(面板标注「与 X 相同 · 折叠为一份」)。
3. 顺序即优先级:从全局到 cwd 由宽到专,模型被告知「更具体的指引优先」; 面板按此顺序排列并注明。字节预算超限时 harness 先省略最宽的;单文件超过 1MB 直接被忽略(面板标注「超 1MB · 不会载入」)。
4. 子目录按需注入:cwd 之下的子目录指引不预载,模型读写该子目录中的文件 时才作为「附加指引」注入——面板脚注对此有说明,不把不预载的文件混进链里。

为什么没有 hooks.json / .env / .sessions 了:hooks 桥默认不挂载且 configPath 必填无默认文件名(它是部署配置,不是项目文件);.env 与 .sessions 相对 dsh 启动目录、进程级生效,与会话工作区无关。把它们摆在 「项目文件」清单里会诱导用户创建根本不会被读取的文件,因此从面板中移除。 GEMINI.md、.cursorrules 等其它代理工具的文件 dsh 不读取,同样不在面板中。

功能

• 指引链视图:每层一张卡片,标注层级身份(全局·所有会话 / 项目根 / 当前工作目录),列出已存在的候选文件与状态徽标(本地不入库 / 重复折叠 / 超限忽略),显示最近写入时间与大小。
• 就地新建:每层卡片右上「＋ 新建」展开缺失候选(AGENTS.md 标注推荐, local 候选标注建议 gitignore),按当前界面语言预填模板,保存才落盘。模板 只预填尚不存在的文件;已存在文件的编辑不会被重新模板化。
• 编辑器脏态守卫:未保存返回时弹出「保存并返回 / 放弃修改 / 继续编辑」, 不静默丢弃;标题栏显示未保存圆点;支持 Cmd/Ctrl+S 保存;保存后提示 「更新会在会话的下一步注入」(harness 会在下一步对账并注入变更)。
• 技能目录状态:项目根 .dsh/skills、.agents/skills 与用户级 ~/.dsh/skills、~/.agents/skills 四个技能根,展示存在性与技能数 (SKILL.md 计数,限深限量扫描);技能的 SKILL.md / 平铺 .md 可就地查看与 编辑,经符号链接写入的会写穿到来源文件(设计如此)。
• 右侧浮动面板:注册在 shell.overlay(additive 列表槽);会话头部开关 注册在 conversation.session.header.utilities;切换会话自动跟随新工作区。