前言¶

Agent 在 DSH 中會調用工具並加載技能，決定其行爲的上下文往往不在對話界面裏。人設是什麼、系統提示詞拼接了哪些段落、啓用了哪些工具、哪些技能會被加載，這些內容會影響任務結果、權限和消耗。

預設工坊 · Preset Workshop 用於爲 DeepSeek Harness 管理人設、系統提示詞、工具與技能，並預覽請求組成。它適合需要按任務維護不同 Agent 配置的 DSH 使用者。

預設工坊由 Zai-G 維護，倉庫標識爲 Zai-G/dsh-preset-workshop。當前公開版本爲 v0.1.0，目標宿主爲 DeepSeek Harness 0.2.0-rc.2。

下面介紹安裝、典型用法與使用邊界。

這是什麼¶

預設工坊是一個 DSH 預設工作臺。它將常見配置集中管理：預設方案、人設、系統段、工具使用指令、工具、工具描述、技能、預覽、導入導出與預設回退。

它會把名稱和描述同步到 DSH 原生預設，並在 DSH 原生選擇器中使用。

它依賴宿主掛載的預設服務。使用 dsh web 或官方桌面端打開工作臺；官方 headless／SDK／ACP 默認未掛載本插件依賴的預設服務，不屬於適用入口。

核心功能¶

預設方案¶

可新建、重命名、編輯描述、啓停、刪除與恢復默認預設。名稱和描述同步到 DSH 原生預設。

人設與系統提示詞¶

可編輯人設，查看實際變量。可編輯、開關與排序宿主暴露的系統段，並添加自定義內容。

工具使用指令¶

可對工具使用指令進行整組排序與開關，並逐段編輯。

工具¶

支持默認八項工具按需開關，動態發現官方與第三方工具，重型能力按包選擇。

工具描述¶

可在 JSON 彈窗中編輯工具描述，保護調用名、參數類型、必填項與約束，並明確提示錯誤。

技能¶

可逐項綁定、全開或全不開技能，並查看來源路徑、診斷、描述、正文和加載後的補充。

掃描¶

啓動時完整掃描一次，跟隨來源晚註冊更新；支持手動掃描與可選定時掃描。

預覽¶

可預覽工具與技能、簡化提示詞、實際權限策略；支持選擇會話或指定目錄求值。

導入導出¶

支持導入導出 JSON / YAML，可導出當前或全部；處理名稱或 ID 重複時的覆蓋或修改。

會話預設回退¶

停用或刪除預設前檢查引用並遷移，保留消息歷史；失敗保留原預設。

安裝與啓用¶

安裝與更新由宿主管理，請勿手寫 profile 配置。

在 DSH 對話中，請 Agent 使用宿主 plugin_manager（Creator 模式）執行安裝：

{
  "action": "install_bundle",
  "target": "dsh-preset-workshop"
}

命令行等價命令如下：

dsh plugin --profile <profile> add dsh-preset-workshop

安裝後檢查 application: applied 或 restart-required。顯示已應用時，打開“設置 → 預設工坊”；顯示需要重啓時，先按宿主提示重啓，再進入設置。

典型用法¶

下面以新建一個預設方案爲例。

1、新建方案：填寫名稱和 ID。ID 創建後不可改；名稱與描述可隨時調整。

2、編寫人設：可寫入宿主註冊的 {{cwd}}、{{model}}、{{provider}} 等變量，並在變量區查看實際值。$ENV 文本不會自動替換。

3、組合能力：選擇工具、系統段與技能以精簡能力。綁定技能時會聯動開啓可用的 skill 工具，仍可手動關閉。

4、檢查預覽：查看啓用能力與最終提示詞。默認讀取當前打開的會話環境；沒有會話時採用宿主的新會話默認權限。

5、保存並使用：點擊“保存方案”保存全部草稿；提示詞區“保存”只保存提示詞；工具描述彈窗只保存該項。再在 DSH 原生選擇器中選用預設。

適用場景與注意¶

適合需要查看請求組成、精簡工具與技能、維護多個預設方案的 DSH 使用者。

使用注意：

• 權限與審批由 DSH 和來源插件執行；預設工坊不能保證模型行爲或第三方插件安全，也不能替代判斷、備份和賬單核對。
• 修改提示詞、工具描述或技能會影響 Agent 的判斷與操作；保存、取消和恢復默認無法撤銷已經發生的操作。
• 工具僅展示頂層描述，完整 schema 仍進入實際請求；token 按字符數估算，不是計費賬單。
• 代理層追加的壓縮指令沒有暴露 DSH 讀取／覆蓋接口，不能預覽、編輯或排序該層。
• 卸載前應先遷移引用本插件預設的會話，再使用 plugin_manager 的 remove_bundle；直接卸載可能導致這些歷史會話無法恢復。
• 安裝前請檢查 MIT 許可；如需要評估源碼，可查看 GitHub 倉庫。
• 本插件按 MIT 許可的“現狀”提供，作者不對使用造成的損失承擔責任。

鏈接¶

• GitHub：https://github.com/Zai-G/dsh-preset-workshop