在 DeepSeek Harness (DSH) 开发或代码审查场景中，频繁查看分支状态、未提交的更改和 PR 详情会打断对话流。dsh-project-summary 插件通过在对话窗口右上角提供悬浮概要解决此问题。它不占用整列，不替换现有右侧栏，而是作为一个轻量级面板显示分支、变更、提交和 PR 信息。
插件概况¶
- 插件名称：
dsh-project-summary - 所有者：callqh
- 分类：客户端
- 许可证：MIT
核心功能¶
该插件提供以下信息展示与交互能力：
-
项目与分支信息
显示仓库名称、当前分支、游离 HEAD，以及相对于本地 upstream 的领先/落后提交数。 -
工作区变更
显示修改文件数、增加/删除的行数。点击“变更”可打开只读的 diff 预览。 -
GitHub 拉取请求
显示当前分支关联的 PR 标题、编号、状态、目标分支和外链。在多个匹配结果中优先显示开放 PR。 -
最近提交
显示最近三条提交的短 hash、说明、作者和日期。 -
悬浮与布局
展开宽度约 296px，可收起。插件会记住收起状态，窄屏初次打开时默认收起。概要定位在对话区域，不覆盖右侧工具栏，并自动跟随 DSH 的深浅主题。 -
自动刷新
展开时每 15 秒查询本地 Git；PR 缓存 60 秒；页面不可见时暂停读取。 -
只读与降级
插件不执行提交、推送、切分支或初始化仓库。当没有 Git 仓库、没有 PR 或 GitHub CLI (gh) 不可用时，会显示相应提示。
安装与启用¶
插件通过 GitHub Release 的 tarball 安装。请在 DSH 中向 Agent 发送以下命令：
请用 plugin_manager 安装并启用这个插件 bundle：
https://github.com/callqh/dsh-project-summary/releases/download/v0.1.1/dsh-project-summary-0.1.1.tgz
安装后，打开使用 Git 仓库目录的主会话即可看到概要。
前置条件与依赖¶
- DSH 版本：初始适配版本为 DSH
0.2.0-rc.2。 - GitHub CLI：若要显示 PR 信息，需在 DSH Host 环境中安装 GitHub CLI (
gh) 并登录。插件仅查询origin指向的 GitHub.com 仓库。
安全与注意事项¶
- 只读操作：插件仅进行只读的 Git 查询，不执行任何写入操作。
- 凭据使用：安装意味着信任 Host 插件读取项目并使用现有的
gh凭据进行联网查询，但这不代表为不可信仓库提供了沙箱隔离。 - 隐私：无遥测、独立数据库或凭据存储；浏览器只传会话 ID。
- 兼容性：npm registry 暂未发布，请使用 GitHub Release tarball。
此插件为 DSH 提供了一种无需切换窗口即可监控 Git 状态的方式。更多细节可查看 GitHub 仓库 或 社区目录。
