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