在 DSH 系統中,插件、技能、預設和規範是分散的實體。管理它們通常需要頻繁切換上下文。dsh-asset-manager 插件提供了一個集中視圖,將所有這些資產收集到一個面板中。它統一了 DSHComponent 數據模型,掃描真實數據,並提供了一套管理生命週期(啓用/停用/刪除)的功能,同時內置了安全機制。
安裝¶
使用命令行安裝插件:
dsh plugin --profile web add github:butingxz/dsh-asset-manager
入口¶
插件提供兩個訪問入口:
- 會話視圖頁籤「系統總覽」:左側樹形導航 + 右側卡片表格。
- 會話頭部右側按鈕:直達主面板。
核心功能¶
- 資產概覽:提供 4 張統計卡,分別顯示總數、啓用中、已停用和可更新數量。
- 資產瀏覽:支持分類樹導航、狀態篩選以及名稱/描述的模糊搜索。
- 組件操作:使用滑動開關啓用或停用組件;支持本地路徑縮略圖和一鍵複製。
- 詳細信息:點擊行展開詳情,包括直白介紹、用法示例、來源鏈以及位置與時間信息。
- 刪除保護:刪除操作需通過 Modal 輸入組件全名進行二次確認;刪除前自動備份到
workspace/.dsh-asset-backups;內置保護機制防止刪除官方@deepseek-ai/*組件或系統規範。 - 版本更新:真實查詢 npmmirror 最新版本(帶超時和緩存),可更新項顯示升級選項。
- UI/UX:包含骨架屏加載、操作 Loading 防重複點擊以及 Toast 錯誤處理。
API¶
GET /@dsh-external/dsh-asset-manager/api/assets:獲取資產列表(含緩存更新信息)。POST /@dsh-external/dsh-asset-manager/api/refresh-updates:觸發更新檢測。POST /@dsh-external/dsh-asset-manager/api/disable|enable|delete:執行組件操作。
對話工具:_dsh_external_dsh_asset_manager_status(資產概況速覽)。
構建與注入¶
在本地開發時:
bash scripts/build.sh # 構建 host + client
dev_inject_plugin <本目錄> # 首次注入 / 大改後重注入
dev_reload_package dsh-asset-manager # 小改熱重載(若報 duplicate route:先 dev_clear_routes /@dsh-external/dsh-asset-manager)
注意:Client 改動需刷新瀏覽器頁面生效(未開 dev:web 監聽時)。
依賴¶
插件依賴以下包:
@deepseek-ai/dsh-client-ui-slots@deepseek-ai/dsh-llm@deepseek-ai/dsh-toolscordisschemastery
結尾¶
該插件爲 DSH 開發者提供了一個管理資產和監控狀態的集中中心。查看 GitHub 倉庫 瞭解更多或貢獻。