前言¶
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 檢查和詳情查看功能,降低了調試智能體時的信息獲取成本。