前言¶
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。
