dsh-project-summary
DeepSeek Harness 的紧凑浮动式 Git 项目摘要：分支、变更、提交和 GitHub 拉取请求。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:callqh/dsh-project-summary#10696ed2d255b1c40c4bcdd942fdb94ea9221423
Project Summary 以 dsh-project-summary 发布，当前版本为 0.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
在 DeepSeek Harness 对话窗口中，用一张悬浮卡片查看分支、变更、提交和 PR。
简体中文 · English
一个第三方、只读的 DSH 插件。概要悬浮在当前对话区域的右上角，不占用整列、不替换现有右侧栏。侧栏打开、关闭或调整宽度时，卡片跟随对话区域移动；背景、文字和边框直接继承 DSH 客户端的深浅主题。
初始适配版本：DSH
0.2.0-rc.2。实际集成基于 macOS 桌面版；其他 DSH 版本和 Windows 尚未验证。开发测试可在 Linux CI 中运行。本项目与 DeepSeek / OpenAI 无官方关联，界面文案目前为中文。
| 深色主题 · 右侧栏已打开 | 浅色主题 · 右侧栏已打开 |
|---|---|
| 深色悬浮项目概要 | 浅色悬浮项目概要 |
以上为组件演示截图，使用模拟布局、主题变量和虚构仓库 / PR 数据，不是真实会话截图。实际内容来自当前项目。
前往 GitHub Releases，下载：
dsh-project-summary-0.1.1.tgz
发布包已包含 Host 与 Client 构建产物，无需允许运行安装脚本。
在 DSH 中向 Agent 发送：
请用 plugin_manager 安装并启用这个插件 bundle：
https://github.com/callqh/dsh-project-summary/releases/download/v0.1.1/dsh-project-summary-0.1.1.tgz
如果你已经下载到本地，也可以提供 tarball 的绝对路径。对应工具参数示例：
{
"action": "install_bundle",
"target": "https://github.com/callqh/dsh-project-summary/releases/download/v0.1.1/dsh-project-summary-0.1.1.tgz",
"enabled": true
}
这是 DSH 工具参数，不是终端命令。根据当前权限设置，DSH 可能要求批准。安装和启用会影响当前 profile 下的所有会话。
按插件管理器返回的结果操作：
applied：刷新当前 DSH 页面，让新的 Client bundle 加载。restart-required：退出并重新打开 DSH，仅刷新页面可能仍然使用旧版本。打开使用 Git 仓库目录的主会话即可看到概要。插件没有额外必填配置，不会修改 DSH 原有侧栏。
npm registry 暂未发布；请使用 GitHub Release tarball，不要直接运行
npm install dsh-project-summary。
本地分支、变更与提交只需要 git。PR 查询额外需要安装 GitHub CLI，并在 DSH Host 所使用的环境中完成登录：
gh auth login
gh auth status
插件只查询 origin 指向的 GitHub.com 仓库，支持 HTTPS、git@github.com: 和 ssh://git@github.com/ 地址。支持开放、已合并和已关闭 PR；多个匹配结果中优先选开放 PR。暂不支持 GitLab、GitHub Enterprise 或自定义远程名称。
缺少 gh、未登录、权限不足或网络不可用时，PR 区域显示提示，不影响本地 Git 信息。插件不会触发登录，也不会读取或展示 token。
| 内容 | 口径 |
|---|---|
| 当前项目 | 已载入主会话的 Host 工作目录；沿父目录查找 Git 仓库 |
| 变更行数 | 相对 HEAD 的最终工作区内容，包含已暂存和未暂存修改；不是本次 AI 回合的修改量 |
| 未跟踪文件 | 仅显示名称，不读取内容、不计行数；未跟踪目录按 Git --untracked-files=normal 的汇总显示 |
| 尚无提交 | 显示已暂存修改；提交记录为空 |
| 二进制文件 | 单独计数，不按文本行统计 |
| 领先 / 落后 | 对比本地已知 upstream；不会自动 fetch，无 upstream 时为 0 |
| Diff 预览 | 已跟踪文件，最多 100,000 字符；不含未跟踪文件内容 |
| 大仓库 | 单次命令最多 8 秒、输出最多 2 MB，超限时提示失败 |
| 刷新 | 本地概要有 4 秒短缓存；PR 最多每分钟查询一次，手动刷新同样遵守 PR 缓存 |
完整说明与私密漏洞报告方式见 安全策略。请勿将真实 token、私有仓库内容或未脱敏日志提交到公开 Issue。
安装后没有卡片？ 先检查是否已启用，是否需要重启，是否处于已有工作目录的主会话。设置页不会展示卡片；不兼容 DSH 版本可能缺少所需的 Slot 或布局标记。
打开右侧栏会挡住概要吗？ 概要根据对话区域的实际边界定位，不按整个窗口的右边缘定位。它不占用整列；狭窄窗口可收起卡片。
切换系统主题没有变化？ 卡片跟随的是 DSH 当前主题，不是独立监听系统主题。当 DSH 选择「跟随系统」时，概要也随 DSH 一起切换。
为什么没有关联 PR？ 检查 origin 是否为 GitHub.com、当前分支是否有 PR，以及 DSH Host 环境中的 gh auth status。PR 缓存最多保留一分钟。
怎么停用 / 卸载？ 通过 DSH 插件管理器对 dsh-project-summary 执行 set_bundle（enabled: false）或 remove_bundle。按返回结果刷新或重启。
需要 Node.js 22.18+ 和 Git，无需另一个 DSH 项目提供依赖：
git clone https://github.com/callqh/dsh-project-summary.git
cd dsh-project-summary
npm ci --ignore-scripts
npm run check
npx playwright install chromium
npm run test:ui
npm pack --ignore-scripts
npm run check 包含类型检查、构建、Git 测试和发布包检查。UI 测试使用模拟 RPC / 主题 / 布局，不启动新的 DSH 服务、不改动用户 profile。源代码及预构建产物均在仓库中。
欢迎提交 Issue 或 Pull Request。目录结构和贡献规范见 CONTRIBUTING.md，版本记录见 CHANGELOG.md。
MIT © 2026 callqh。可以使用、修改和再分发；请保留许可证声明。