前言¶
DeepSeek Harness (DSH) 在执行任务时，主要依据 AGENTS.md 文件来获取 Agent 的行为指令。这些指令文件通常存在于全局（~/.dsh/AGENTS.md）和本地工作区（<workspace-root>/AGENTS.md）中。当用户同时使用多个工具（如 Claude、Cursor、Aider 等）时，这些指令文件可能会散落在不同的目录下，手动管理和路由变得繁琐且容易出错。
dsh-rich-context 插件为 DSH 提供了一个可视化的指令管理界面。它位于 Skill Center 侧边栏，允许开发者直接编辑、优化并路由 Agent 实际读取的 AGENTS.md 文件。
插件简介¶
插件名称：dsh-rich-context
核心功能：管理 Agent 指令文件，支持自定义路径、跨工具目录扫描与默认源切换。
维护者：savageops
开源协议：MIT
安装与启用¶
在终端中执行以下命令安装插件：
dsh plugin --profile web add dsh-rich-context
安装完成后，需要重启 dsh web 进程。重启后，在 Skill Center 侧边栏会出现一个名为 Context 的入口。
核心功能¶
1. 侧边栏编辑面板¶
Context 面板提供两个分段标签页：
- Global：编辑全局指令文件 ~/.dsh/AGENTS.md。该文件会被注入到所有会话中。
- Workspace：从下拉列表选择工作区，编辑该工作区的根目录 AGENTS.md。
2. 自定义路径编辑¶
在面板顶部的路径栏中，点击路径文本即可跳转并编辑任意绝对路径的文件。这允许用户直接管理非标准位置的指令文件。
3. 源扫描与默认源设置¶
在 Global 标签页中，面板会自动扫描 10 个工具目录（包括 .dsh、.codex、.claude、.cursor、.aider、.gemini、.copilot、.continue 以及根目录）以查找 AGENTS.md 和 CLAUDE.md 文件。
扫描到的文件会显示行数。点击 Set as default 按钮，系统会将 ~/.dsh/AGENTS.md 创建为指向该文件的符号链接（symlink）。这使得 DSH 能够透明地读取你指定的单一工具目录下的指令文件作为默认源。点击 Reset 可恢复为普通文件。
技术架构¶
该插件采用前后端分离的架构：
- 后端：基于 Node.js，通过 /api/rich-context/* 路由处理文件扫描、读写以及符号链接管理。
- 前端：纯 DOM 实现，无 React 依赖，通过注入的方式渲染侧边栏和编辑器。
注意事项¶
- 安装后必须重启
dsh web进程，侧边栏入口才会出现。 - 使用 MIT 许可证，可自由使用和修改。
- 确保插件安装前，当前 DSH 进程的版本满足要求（
dsh >= 0.1.6-0 || >= 0.2.0-rc.0）。
