前言¶
在 DeepSeek Harness（DSH）裏，插件往往通過 dshmarket 或官方插件管理器安裝，數量一多，版本、啓停狀態和設置入口就容易分散在各處。市場負責下載與更新，但「裝完以後怎麼看、怎麼記、怎麼查問題」並沒有統一界面。下面介紹維護者 LTao96 的客戶端插件 dsh-plugin-overview：它不做安裝與卸載，只針對當前 profile 裏已經存在的依賴，提供列表、備註、分組、健康診斷、啓停和設置跳轉，並與插件市場搭配使用。
這是什麼¶
dsh-plugin-overview 是面向 DSH 已安裝插件 的本地總覽頁。源碼與說明見 GitHub，npm 包名爲 dsh-plugin-overview（當前資料中版本 0.2.1，MIT 許可）。社區目錄頁：SkillHub - LTao96/dsh-plugin-overview。
它和插件市場是分工關係：下載、升級、卸載交給 dshmarket 或 Host 插件管理器；整理、查看、診斷交給「插件總覽」。DSH 生態強調「一切皆插件」；SkillHub 等社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。
入口與數據存放¶
安裝並重啓 DSH 後，在 設置 → 插件總覽 打開（設置項 order 爲 130）。
備註、分組及分組順序保存在：
$DSH_HOME/plugin-overview/state.json
首次啓動會嘗試從舊路徑導入：
$DSH_HOME/plugin-control-center/state.json$DSH_HOME/plugin-dashboard/state.json
核心功能¶
列表與排序¶
列出當前 profile 的已安裝依賴，按總覽自身的分組順序和名稱排序。狀態與版本來自 Host 的 pluginManager 服務；安裝時間取包目錄創建時間，軟鏈接安裝會標記 ≈（pnpm 重裝或遷移可能刷新該時間，屬近似值）。
備註與 AI 總結¶
詳情面板可直接編輯備註。手動備註（source: manual）不會被 AI 覆蓋。
安裝或更新時的自動 AI 總結默認關閉。需在標題欄勾選「安裝時 AI 總結」，Host 纔會在新版本出現時向當前默認模型請求一次 {summary, group}；模型失敗時回退到包描述，不阻塞安裝。「AI 重新總結」可隨時手動觸發。
分組¶
詳情面板可新建分組並移動插件。「分組管理」支持新建、重命名、刪除；刪除分組時組內插件移到「未分組」，並標記爲手動分組，之後 AI 不會自動挪動。
詳情與啓停¶
點擊任意一行打開詳情：版本、來源、安裝時間、Loader 行、備註、啓停、打開設置，以及（匹配到主面板時）打開主面板。
狀態單元格通過 pluginManager.setBundleEnabled 啓停整個 bundle；無 bundle 行時回退到 setPluginEnabled。
健康診斷¶
「健康診斷」是隻讀的第一層靜態檢查，例如：
- 運行狀態爲 failed
- 已啓用但沒有 active 的 Loader 行
- 已安裝但不在
dsh.profile.bundles中 - 多個皮膚/背景/視覺類插件同時啓用（按包名、描述和 keywords 識別）
- 設置入口指向
settings.section臺賬中不存在的頁面
只報告問題並打開詳情，不會自動修復或卸載。
設置與主面板入口¶
「打開」在設置導航內部點擊匹配項，避免誤點其它同名按鈕；找不到時複製提示路徑（DSH 目前沒有公開的設置深鏈接 API）。
可選「收納第三方設置項」：讀取實時的 settings.section 槽位臺賬（ctx.slots.entries + ctx.slots.subscribe），列出第三方設置頁，可逐項收納或放出；切換設置頁後控制器仍生效，當前打開頁即使被收納也保持可見；關閉開關或插件銷燬時恢復。
插件搜索索引 settings.label、settings.navLabel、settings.sectionId 和設置提示。
主面板入口匹配實時的 sidebar.panellist 臺賬；少量已知面板通過 PANEL_IDS 兜底。「主側欄順序」用 CSS order 調整直連面板按鈕，順序保存在 localStorage。
安裝與啓用¶
Host 要求（來自 package.json）：Node >=20，DSH >=0.2.1-rc.1 <0.3.0-0。
官方安裝命令：
dsh plugin --profile <profile> add dsh-plugin-overview
npm 頁面：https://www.npmjs.com/package/dsh-plugin-overview
安裝後重啓 DSH，再在 設置 → 插件總覽 使用。
典型用法¶
- 安裝並重啓後打開「插件總覽」，瀏覽當前 profile 全部已裝插件。
- 對常用插件寫手動備註或建分組；需要時在標題欄開啓「安裝時 AI 總結」，或單行使用「AI 重新總結」。
- 運行「健康診斷」，按提示打開有問題的插件詳情。
- 在列表中直接啓停 bundle，或通過「打開」進入對應設置頁；若設置項過多，可開啓「收納第三方設置項」只保留需要的入口。
- 需要調整側欄直連面板順序時，使用「主側欄順序」控件（依賴
sidebar.panellist實時標籤；匹配不到時控件隱藏）。
開發驗證時，README 建議用臨時 DSH_HOME，避免污染真實 profile：
DSH_HOME=/tmp/dsh-smoke dsh plugin --profile smoke add <插件目錄絕對路徑>
DSH_HOME=/tmp/dsh-smoke dsh --profile smoke --dump-config
適用場景與注意¶
適合已經通過市場或管理器裝了不少 DSH 插件、希望在一個頁面裏備註、分組、查健康狀態並跳轉設置/主面板的用戶。它不是插件市場，也不負責安裝、升級或卸載。
插件在 DSH 進程權限下運行；安裝前請自行查看 源碼倉庫 與 MIT 許可證，確認符合你的環境與安全要求。收納設置項、AI 總結等能力會讀取 Host 提供的臺賬與模型；行爲以 README 與當前 Host 版本爲準。
結尾¶
dsh-plugin-overview 把「裝完之後」的插件管理收斂到設置裏的一個總覽頁：與市場分工明確，側重本地狀態、備註分組、只讀診斷和啓停入口。需要進一步瞭解時可查閱目錄頁 SkillHub 與 GitHub 倉庫。
