前言¶

DSH Web 提供了構建智能體的工作流環境。在開發過程中，維護一套清晰的上下文規則（如角色定義、工具使用說明）至關重要。該插件在聊天輸入框上方提供 Dock 控件，允許用戶按全局或工作區維護可勾選的上下文規則，並實時注入到會話的系統提示中。

核心功能¶

輸入框上方 Dock 常駐「動態AGENTS.md」下拉按鈕，始終可見並顯示已勾選數量徽標。面板分爲「全局」與「當前工作區」兩組，支持勾選、全選/取消全選、新增、刪除（二次確認）、查看完整內容。

規則庫分爲兩級管理：
- 全局規則庫：位於 ~/.dsh/dynamic-agents.json，所有工作區共享規則定義，不含勾選狀態。
- 工作區規則庫：位於 <工作區>/.dsh/dynamic-agents.json，存儲該工作區的規則、勾選狀態與會話解鎖狀態。

全局規則的勾選狀態由工作區文件控制（全局規則 ID 帶 g- 前綴），不同工作區可各自勾選不同的全局規則。新增規則需填寫名稱與內容，保存後即注入會話系統提示，無需重啓。勾選內容按「全局在前、工作區在後」順序合併注入，格式爲 ## 規則名 + 規則內容。

會話已有聊天記錄後，控件進入鎖定態，勾選、新增、刪除均不可操作，解鎖需二次確認以保持會話系統提示緩存命中率。

安裝與啓用¶

前置要求：本機需安裝 dsh 與 pnpm。

安裝插件：

dsh plugin --profile web add "git+https://github.com/hw-cola/dsh-dynamic-agents.git"

安裝後請重啓 dsh web（讓插件的 cordis 補丁層生效）並刷新瀏覽器頁面。

使用示例¶

1. 管理上下文：在輸入框上方 Dock 的「動態AGENTS.md」下拉按鈕中選擇或取消勾選上下文規則，面板會顯示當前已勾選數量。
2. 新增規則：點擊新增按鈕，填寫規則名稱與內容後保存，規則立即生效。
3. 快速管理：在面板中使用全選/取消全選功能快速管理規則。
4. 查看詳情：點擊查看完整內容可查看所有可用規則。
5. 鎖定與解鎖：會話首個回合開始前會等待配置加載完成。會話開始後控件鎖定，需解鎖才能修改配置。

注意事項與兼容性¶

• 數據清理：卸載不會自動刪除數據文件（全局規則庫與工作區規則庫需手動清理）。
• 版本兼容：插件在 DSH 0.1.7-rc.1 上開發測試，大版本升級後需檢查適配版本。
• 加載時機：會話首個回合開始前會等待配置加載完成，避免首回合漏注入。
• 運行環境：插件在手機端同樣可用，面板支持自適應定位。

結語¶

該插件通過可視化的方式解決了 DSH Web 中上下文規則管理的繁瑣問題，實現了全局與工作區的規則隔離與靈活注入。更多細節可參考 GitHub 倉庫。