前言¶
在 DeepSeek Harness（DSH）裏做智能體或固定工作流時，經常需要在每次新會話裏重複同一段「總要求」：角色邊界、輸出格式、禁止事項等。把這些寫進單個會話的 system 段，換會話或刷新後往往要再貼一遍；若只靠臨時粘貼，也不便於團隊或個人長期保持一致。
DSH 的 profile 與插件體系允許在組合層擴展行爲，但官方並未內置一個面向 Web 的、可持久編輯的全局指令入口。社區維護的 dsh-global-prompt 針對這一點：在 設置 → 全局提示詞 提供開關與文本框，把固定指令寫入對應 profile 的配置，並在組裝提示詞時按規則注入。下面介紹它是什麼、如何安裝，以及使用時需要留意的範圍與限制。
這是什麼¶
dsh-global-prompt 是 DeepSeek Harness 的社區全局提示詞插件：通過 Web 設置保存跨會話的固定指令，依賴官方 ConfigForms 與 profile patch 持久化，屬於當前 pinned 開發快照的預覽交付（插件包版本 0.2.0）。維護者爲 Humengjiu，採用 MIT 協議；未經 DeepSeek 官方收錄，與 SkillHub 社區目錄同屬獨立生態，不等同於官方應用商店。
一句話定位：在一個開關、一段文本的前提下，讓安裝該組合包的 web profile 在每次組裝時讀取實時配置，並在合適位置貢獻字面意義上的全局提示內容。
核心功能¶
設置界面與持久化¶
安裝後可在 DSH Web 側欄進入 設置 → 全局提示詞。界面包含：
- 啓用開關；
- 固定指令文本框。
配置通過官方實時 ConfigForms 保存到該 profile 的 cordis.patch.yml。Web 場景下默認路徑爲 $DSH_HOME/profiles/web/cordis.patch.yml。服務端會對過期的編輯版本做衝突檢查；保存失敗會提示，當前頁草稿保留並可重試。遠端連接或只讀狀態下不會向 Host 寫入。
首次安裝默認啓用插件條目；若從舊包更新，官方會保留原有啓用狀態。若設置入口未出現，可在側欄 插件 中啓用 dsh-global-prompt 並按提示重啓。
功能默認值：開關關閉、文本爲空。
對提示詞組裝的影響¶
當開關打開且文本非空白時，user:global-prompt 在 deployment persona prefix 之後貢獻原文；關閉、清空或僅空白時不貢獻任何內容。
文本中的 {{variable}} 等形式會按字面保留，不會作爲 DSH 插值表達式執行。每次組裝讀取當前實時配置；修改會通知提示詞消費者，無需重啓插件。
內容會增加模型輸入 token，修改會改變 KV-cache 前綴。作用範圍限於安裝了該組合包的 profile 內的會話。官方聲明的「完整 system prompt 覆蓋其他 section」規則仍然有效。
兼容與驗證範圍¶
| 插件版本 | 已驗證的 dsh |
|---|---|
| 0.2.0 | 官方發佈版 0.2.1-alpha.2（tag dsh-v0.2.1-alpha.2，提交 d743267388641bc76f17c45ce8b4c231aed1d32c） |
| 0.1.0 | 原開發分支快照，見 歷史預覽版 |
README 說明：已在 Windows 上對官方 npm 發佈包完成 Web 安裝與網頁操作驗證；桌面應用使用相同 Web 插件協議，但尚未單獨做桌面安裝驗收。未進行真實模型 API 調用、桌面應用安裝或移動端驗收。插件未發佈到 npm，當前通過 GitHub 預覽包（如 v0.2.0）交付。
安裝與啓用¶
先做環境確認，再安裝預覽包，最後重啓並在設置裏編輯。
1. 確認 dsh 版本¶
目標版本爲 0.2.1-alpha.2，與插件 0.2.0 的 peer 聲明一致。
2. 獲取安裝包¶
從 GitHub Releases 下載 dsh-global-prompt-0.2.0.tgz（見 v0.2.0 發佈頁）。也可在 DSH 社區插件安裝界面使用該預覽包的下載 URL。
安裝包自帶 profile 組合層，會自動註冊 global-prompt 條目；無需修改 dsh 源碼，也不需要舊版 --patch global-prompt.patch.yml。
3. 安裝到 web profile¶
在終端執行（路徑改爲本機絕對路徑；含空格請加引號）：
dsh plugin --profile web add /absolute/path/dsh-global-prompt-0.2.0.tgz
4. 重啓並使用設置¶
重新啓動 dsh Web，打開 設置 → 全局提示詞，打開開關後輸入固定指令，等待保存完成。
從 0.1.0 升級¶
舊版使用獨立的 settings.yaml 命名空間；新版改用官方 volatile Config 與 profile patch。升級時請保留舊文件、停止使用舊版啓動覆蓋文件，再安裝新版組合包。不覆蓋原文件的遷移步驟與工具見倉庫內 升級指南 及 scripts/migrate-settings.mjs（pnpm run migrate）。
典型用法¶
下面是可以直接復現的最小流程（與 README 一致）：
- 安裝並重啓 Web 後進入 設置 → 全局提示詞。
- 打開啓用開關。
- 在文本框寫入希望每次會話都生效的固定說明（例如統一回復語言、代碼風格或禁止泄露的上下文類型）。
- 等待 ConfigForms 保存成功；若衝突或失敗，按提示重試，草稿會保留。
- 新開或繼續該 web profile 下的會話，觀察組裝結果是否包含對應段落（需在啓用且非空白時纔會貢獻
user:global-prompt）。
無需在每條消息裏重複粘貼同一段總要求；修改文本後下次組裝即讀取新配置，不必重啓插件。
適用場景與注意¶
適合誰
- 主要在 DSH Web（
--profile web）上工作、且 dsh 版本已對齊 0.2.1-alpha.2 的開發者。 - 需要在同一 profile 內跨會話保持一段字面固定的全局指令，並願意通過官方設置頁與
cordis.patch.yml管理配置的人。
使用前請知悉
- 插件以當前 dsh 進程權限運行；安裝前應自行查看 GitHub 源碼、LICENSE 與 NOTICE。實現源於 Humengjiu 對上游 harness 的 原始 PR 思路，社區包獨立維護。
- 全局文本會進入模型輸入並影響 token 與 KV-cache 前綴；不宜寫入過長或頻繁變更的大段內容。當前實現每次文本變化單獨排隊保存，尚未防抖。
- 未來 dsh 版本可能變更插件 API；本包在 README 中聲明瞭準確版本要求，一般無需額外兼容性豁免配置。
- 若依賴「完整 system prompt 覆蓋其他 section」的官方行爲，需理解全局段仍受該規則約束，不能假設覆蓋一切 section。
鏈接與來源¶
- 社區目錄頁：https://www.skillhub.cn/plugins/Humengjiu/dsh-global-prompt
- 倉庫與說明：https://github.com/Humengjiu/dsh-global-prompt
- 驗證細節：https://github.com/Humengjiu/dsh-global-prompt/blob/main/docs/validation.md
dsh-global-prompt 把「跨會話固定指令」收斂爲一個開關和一段可持久化的文本，並掛到官方 Web 設置與 profile patch 上；在版本對齊的前提下，適合作爲 web profile 的全局提示詞補充，而不是替代 dsh 自帶的 system 與 deployment 語義。安裝前核對 dsh 與預覽包版本，並在插件側欄確認啓用即可開始編輯。
