前言¶
DeepSeek Harness (DSH) 的核心设计理念是“一切皆插件”。在开发或调试智能体时,了解当前会话中实际生效的 Prompt、注入的上下文以及变量和工具配置,是排查问题的关键一步。dsh-system-prompt 是为此目的提供的只读插件,它不修改运行状态,而是专注于对活跃会话的 Prompt 进行静态与动态的联合检查。
插件定位¶
dsh-system-prompt 是一个只读的 DeepSeek Harness 插件。其核心职责是会话范围的提示词检查。该插件旨在解决在运行时查看“有效提示词”的需求,通过提供浏览器界面和轻量级 API,让开发者能够直观地查看当前会话的 Prompt 结构。
核心功能¶
该插件提供两个主要的浏览器交互界面:
- 对话检查标签页 (
conversation.view):优先级为 30。这是一个会话检查标签页,用于展示提示词的各个部分、运行时上下文、变量、工具以及生产者提供的消息。 - Sections 详情标签页:与
ui-trajectory的系统提示词标签页并排显示。由于上游的 trajectory 包未暴露详情标签页插槽,该插件通过有界的 DOM 桥接实现此功能。
安装¶
通过官方命令安装:
dsh plugin --profile web add github:elonnzhang/dsh-system-prompt
使用与开发¶
安装后,该仓库已提交打包好的 lib/ 目录,因此直接使用无需执行构建脚本。
若需进行本地源码开发或测试,需先执行构建:
npm run build
将检出到本地,并链接到 Harness 的 web 配置文件中,然后启动服务进行测试:
pnpm dsh plugin --profile web add link:/Users/elon/code-space/GitHub/dsh-system-prompt
pnpm dsh web --no-open --port 3080
访问 http://127.0.0.1:3080,即可查看对话检查视图以及轨迹的 System Prompt / Tools / Sections 详情流程。
技术细节¶
- 数据序列化:插件仅在
/dsh-system-prompt端点暴露session对象,且仅返回 JSON 投影。它不会序列化实时的 Context、Agent、Session、service 或 Cordis 对象。 - 所有权范围:提示词、上下文、变量和工具的所有权报告在
global/preset/agent范围内。 - 开发要求:本地开发需要显式运行
npm run build。
总结¶
该插件通过提供即时的会话 Prompt 检查和详情查看功能,降低了调试智能体时的信息获取成本。