前言¶
在 DSH（DeepSeek Harness）里做项目时，周报往往要对照 git log 手工整理：按天归类、再写成 Markdown，重复且容易漏项。社区插件 深鲸周报（npm 包名 @deepwhale-cn/dsh-weekly-report，GitHub 仓库 feely0208/dsh-weekly-report）面向这类场景：读取指定仓库在时间范围内的提交记录，输出按天分组的周报 Markdown 骨架，便于在此基础上补全说明与汇报。下面介绍其定位、能力与安装用法。
这是什么¶
深鲸周报 是 DSH 生态中的工作流类插件（社区目录：feely0208/dsh-weekly-report），由维护者 feely0208 发布；package 作者信息为温州深鲸智能科技有限公司。一句话定位：从 git 提交记录自动生成按天分组的周报 Markdown 骨架。它不替代人工写总结，而是把「按日期的提交清单」先搭好结构。
核心功能¶
依据项目 README 与 package 描述，已核实能力如下：
- CLI：在本地对指定目录执行 git 历史查询，按
--since限定时间范围，生成 Markdown（可指定--out输出文件）。 - Web 面板：安装 web profile 后，侧栏出现「深鲸周报」入口；面板为只读，不修改仓库内容。
- 输出形态：周报为 Markdown 骨架，提交按天分组，便于后续编辑成正式周报。
运行环境要求（来自 package.json）：Node >=18，DSH 版本 >=0.1.0-rc.6 且 <0.3.0；当前插件版本 0.1.0，许可证 MIT。
安装与启用¶
官方安装命令（README 原文，web 侧栏需 --profile web）：
dsh plugin --profile web add @deepwhale-cn/dsh-weekly-report
安装后可通过命令行 dsh-weekly-report 与侧栏「深鲸周报」使用（CLI 入口对应 bin/cli.mjs）。
典型用法¶
README 给出的可复现示例：
dsh-weekly-report --input ./repo --since '7 days ago'
dsh-weekly-report --input ./repo --since '2026-10-20' --out 周报.md
第一条：对 ./repo 目录，取最近 7 天的提交并生成骨架（输出方式以 CLI 默认为准）。第二条：从固定日期起算范围，并将结果写入 周报.md。--input 指向含 git 历史的项目路径；--since 支持相对时间（如 '7 days ago'）或日期字符串。
适用场景与注意¶
适合谁：需要在固定周期内汇总开发进展、且进展主要落在 git 提交上的团队或个人；希望先得到按天划分的 Markdown 提纲，再写「本周重点 / 风险 / 下周计划」等叙述部分。
使用注意：
- 插件以当前 DSH 进程权限运行，能访问的路径与 git 仓库范围取决于你的环境与
--input；安装前应阅读 GitHub 源码 与 LICENSE，确认符合团队安全与合规要求。 - 生成内容为骨架，提交信息质量取决于 commit message 习惯；面板只读，不会改仓库。
- DSH 社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系；插件归属以仓库与 npm 包
@deepwhale-cn/dsh-weekly-report为准。
结尾¶
深鲸周报把「翻 log、按天分组、起稿 Markdown」收成一条命令或侧栏只读视图，适合作为 DSH 工作流里写周报的前一步。进一步了解可访问社区目录页 skillhub.cn/plugins/feely0208/dsh-weekly-report 与 GitHub 仓库 github.com/feely0208/dsh-weekly-report。
