Перейти к основному содержимому
F

dsh-ganleme

from-wh/dsh-ganleme

干了么:各工作区 git 提交统计与日报/周报/月报生成

Установка

dsh plugin --profile web add github:from-wh/dsh-ganleme

README

干了么 (Git Pulse)

DeepSeek Harness 插件:统计各工作区和项目目录的 git 提交次数与变更行数,一键生成日报、周报、月报。

功能

  • 侧边栏入口,全页 Dashboard:按仓库展示提交次数、新增/删除行数、活跃作者、提交明细
  • 时间范围:今天、昨天、本周(周一起)、本月,或自定义日期范围(最晚到今天,最长 366 天),附「近 7 天 / 近 30 天 / 上周 / 上月」快捷选项
  • 「全部人 / 只看我」:按 git 邮箱归属(不区分大小写,可配置多个邮箱),同名的同事不会算进你的日报
  • 报告:日报、周报、月报、自定义区间报告;纯文本(直接贴进公司系统的文本框)或 Markdown;默认只统计自己的提交。选中「昨天」时生成昨日日报
  • 报告风格四档:工作清单(只留做了什么,去掉 fix:/feat: 前缀、时间和行数)、简洁(工作清单 + 每个仓库的提交次数)、标准(加时间、分支、统计行)、详细(全部信息,含作者、时间、分支、行数);风格之上还可以逐项勾选去前缀、行数、时间、作者,并切换序号写法
  • 每条提交展示多少可选 20 / 50 / 全部
  • 项目源:工具栏 📁+ 打开系统目录选择框,把 Harness 工作区之外的项目加入统计
  • 5 套皮肤,可上传单张背景图或导入整个文件夹作为背景库,每天随机一张
  • 标题下根据今天的提交量给出夸奖或吐槽,同一组台词用完前不重复
  • AI 润色:把生成的报告交给模型改写措辞,三档力度可选,结果可手动修改后再应用;原报告始终保留
  • 自动更新:右上角下载图标在有新版本时高亮,点击后重装最新版

报告风格

风格内容
工作清单日期、一句总览(只要提交数和仓库数)、按仓库列出做了什么。没有类型前缀、时间、作者、行数
简洁工作清单 + 每个仓库的提交次数,总览里带行数
标准加回统计范围、章节标题、每仓库统计行、提交时间和分支
详细全部信息:作者、时间、分支、行数

风格只是默认组合,可以逐项开关:去掉 fix:/perf: 前缀、显示变更行数、显示提交时间、显示提交人。显示提交人在「只看我」下也会生效。

格式只需设置一次

第一次点「生成日报/周报/月报」时,会先弹出格式设置:风格、序号、条数、高级开关、纯文本/Markdown、统计范围一次选完,右侧实时预览样例效果。点「保存并生成」后这套格式就存下来,以后每次生成直接沿用,不再询问。

想改格式:报告窗口右上角的齿轮,或工具栏右侧的齿轮按钮,随时再次打开设置。改了保存后,当前打开的报告会立即按新格式重新渲染。选择的风格和条数会记住,下次打开沿用。

序号写法

纯文本格式下,每条提交前面的标记可选:- 横线、• 圆点、1. 数字、1)括号、无序号。默认:工作清单用横线,其余风格用数字。

  • 编号在每个仓库里从 1 重新开始;仓库名本身不带编号,数字只属于下面的条目
  • 只有一个仓库有条目时不显示仓库标题,条目直接顶格,读起来就是一份清单
  • Markdown 只认 1. 和 -,选了其他标记会退回横线

去掉前缀时只认真正的类型标签(conventional commits 的 feat/fix/perf… 和常见的 修复:/新增: 等),所以 API: add endpoint 这类会原样保留。

AI 润色

报告窗口里的「AI 润色」把当前报告交给模型改写措辞。三档力度:

力度效果
润色条目保留分仓库结构和每条清单,只把每条改通顺(最安全)
合并成段把同一仓库的条目合成一段连贯的话
精简成句每个仓库压成一句话概括

语气可选简洁专业 / 汇报口吻 / 朴实自然,还能补充一句额外要求(例如「面向技术负责人,突出架构改动」)。

数字守卫:改写结果里出现原文没有的数字就会被拒绝,并指出是哪个数字;你手动修改后的文本同样要过这一关。原文永不丢失:应用后窗口顶部有「原文 / 润色后」切换。

不会发生的事:不重新统计、不改动任何数字、不虚构没做过的工作。提示词内置且可见,也可以在面板里临时修改(只对本次生效)。

模型:默认使用当前对话正在用的模型;也可以在配置里用 polishProvider / polishModel 固定一个更便宜的模型。部署里没有模型服务时,这个入口不会出现。

统计口径

  • 按作者时间计日期:提交算在写代码的那天。rebase、amend、cherry-pick 不改作者时间,所以不会把旧工作算成今天,也不会让它从日报里消失
  • 统计所有本地分支:没合并的功能分支上的工作也会出现;同一个提交在多个分支上只算一次
  • 不计 merge 提交:merge 不是新写的代码
  • 读取的提交数达到 commitLimit 时,仓库卡片标注「可能不完整」

以上都可以在配置里调整,见下表。

安装

在 DeepSeek Harness 的「插件」页添加市场索引:

https://raw.githubusercontent.com/From-WH/dsh-ganleme/main/index.json

然后在「发现」页一键安装;也可以直接安装 npm 包 dsh-ganleme。

配置

在插件详情页配置:

字段默认说明
extraRoots[]额外统计的目录;也可以用工具栏 📁+ 添加
scanDepth1在目录下向下找仓库的层数(1–3)
excludedPaths[]排除的目录,支持 ~ 和符号链接
myEmails[]你的所有 git 邮箱(工作、个人),不区分大小写;不填则用各仓库的 user.email
myEmail / myName''旧的单个身份设置,仍然有效
allBranchestrue统计所有本地分支;关掉则只看当前分支
includeMergesfalse是否统计 merge 提交
commitLimit5000每个仓库每次最多读取的提交数
gitConcurrency6同时读取的仓库数
cacheMs60000统计结果缓存时长(毫秒)
polishProvider''润色用的模型提供商;留空跟随当前对话
polishModel''润色用的模型;留空跟随当前对话
polishLevelitems默认改写力度:items / paragraph / summary
polishToneplain默认语气:plain / report / natural
polishMaxTokens2000单次润色的输出上限(token)
updatePackagedsh-ganleme自动更新检查的 npm 包名;留空则关闭
updateRegistryhttps://registry.npmjs.org/版本检查使用的 registry

自动更新说明

  • 更新时先卸载再安装新版本;新版本安装失败时会重新装回旧版本,并在页面上显示失败原因
  • 从本地目录链接安装(link:)的开发版本不会被自动更新覆盖
  • Harness 默认有发布冷却期(minimumReleaseAge),刚发布的版本可能暂时装不上,页面会显示原因,稍后再试即可
  • 没有插件管理服务的部署里,下载图标不显示

开发

npm test

单元测试在 test/*.test.mjs;test/cordis.integration.mjs 用本机 DeepSeek Harness 自带的 Cordis 加载插件,验证依赖注入,没装 Harness 时自动跳过。

License

MIT

Похожие плагины