前言¶
DeepSeek Harness（DSH）把能力拆成插件，會話、項目、工具調用、存儲和外部插件安裝往往分散在不同入口。要在本地快速看清「有哪些會話在跑、工作區狀態如何、核心版本能否更新、Skill 裝在哪」，通常要在多個界面或命令之間切換。dsh-homepage 在 DSH 客戶端裏增加一塊以卡片呈現的主頁表面：預覽區展示摘要，展開後進入對應功能；卡片可按需定製外觀、可見性與動效，其他插件也可註冊自己的卡片。
這是什麼¶
dsh-homepage 是維護者 AngelosZou 發佈的 客戶端 類 DSH 插件（npm 包名 dsh-homepage，當前資料中版本爲 0.1.2，MIT 許可證）。它在 DSH 側邊欄提供可組合的「主頁牆」：不同能力以模塊化卡片展示，點擊可將卡片浮於牆面上方，拖動標題可調整順序，通過 Customize 可改 artwork、可見性與 motion。社區目錄頁：https://www.skillhub.cn/plugins/AngelosZou/dsh-homepage；源碼與說明：https://github.com/AngelosZou/dsh-homepage。
核心功能¶
插件自帶十一張卡片（預覽爲 readings，展開爲完整視圖），職責如下（與 README 表格一致）：
| 卡片 | 作用 |
|---|---|
| Plugin audit | 通過會話審查指定插件的安全性；可通過審查後自動安裝，或僅返回審查報告。 |
| Sessions | 運行中、等待你處理或未讀的會話數量，並提供進入各會話的快捷方式。 |
| Projects | 各工作區的分支、髒文件數、ahead/behind、最近提交、會話數及額外 worktree。 |
| Tool usage | 工具調用次數、錯誤率、參數與輸出體量、估算 token 與時間，可按項目篩選。 |
| Token usage | 餘額與當日消耗、歷史、錢包、贈金及賬戶鏈接。 |
| Network | DSH 核心相關網絡環境變量的快速查看。 |
| Device | CPU、內存、GPU/VRAM、磁盤。 |
| DSH storage | DSH home 佔用、可 reclaim 空間、最大類別及舊日誌清理。 |
| DSH core | 與倉庫中最新核心版本對比已安裝版本，支持一鍵更新。 |
| Workspace groups | 管理側邊欄分組。 |
| Skills | 瀏覽與管理已安裝 Skill，發現並安裝社區 Skill。 |
擴展方式：任意外部插件可通過接口註冊卡片，完整說明見倉庫內 docs/card-api.md。
面向模型的 homepage 工具 可讀與卡片相同的數據；默認關閉，需在 Plugins 頁的插件設置裏手動開啓。開啓後會把工具上下文注入會話，工具可訪問每張卡片（含外部插件實現的卡片）的信息；具體卡片實現可能向 Agent 暴露其未預期的信息，啓用前應理解這一點。
數據目錄：<DSH_HOME>/storages/dsh-homepage。DSH_HOME 優先取環境變量，未設置時使用 ~/.dsh。
安裝與要求¶
推薦通過 npm 安裝到 web 配置：
dsh plugin --profile web add dsh-homepage
也可在 DSH 會話中提供本倉庫地址，由 Agent 完成安裝（以 README 原文爲準，勿自行拼接未在資料中出現的安裝命令）。
環境要求：
- Node.js >= 22.19
- DSH 0.2.x
典型用法¶
- 在 web profile 執行上述安裝命令後，在 DSH 客戶端打開主頁牆，從預覽進入各卡片對應能力（例如 DSH core 一鍵更新、Plugin audit 審查後再裝插件、Skills 管理本地與社區 Skill）。
- 點擊卡片使其浮於牆面上，拖動卡片標題調整順序；在 Customize 中設置 artwork、可見性與動效，組成個人主頁佈局。
- 若希望會話內 Agent 通過工具讀取主頁數據，在 Plugins 頁打開本插件設置並啓用
homepage工具（默認關閉）。 - 若你開發其他 DSH 插件並希望在主頁展示入口，按
docs/card-api.md註冊自定義卡片。
適用場景與注意¶
適合需要在 同一客戶端表面 彙總會話、項目、工具與 token 用量、設備與存儲、核心版本、Skills 與插件審查的 DSH 用戶；也適合希望把自家插件入口掛到主頁牆上的插件作者。
插件在 當前 DSH 進程權限 下運行，會讀取與會話、工作區、存儲、賬戶等相關的本地與配置信息；安裝與啓用 homepage 工具前，應閱讀源碼與 MIT 許可證，並理解 Plugin audit 等能力會觸發委託會話。社區目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係，並非官方應用商店。
結尾¶
dsh-homepage 把 DSH 的輔助能力收攏到可定製、可擴展的卡片主頁上，減少在多入口之間來回找狀態的操作。目錄頁：https://www.skillhub.cn/plugins/AngelosZou/dsh-homepage；GitHub：https://github.com/AngelosZou/dsh-homepage。
