mimetics-dsh-weekly-report

装上后，在 Harness 对话框说一句「帮我生成本周周报」，就能拿到固定四模块的 Markdown 周报 （〖本周完成〗〖进行中〗〖风险与阻塞〗〖下周计划〗）——由 generate_weekly_report 工具驱动内置流水线生成。

---

安装

dsh plugin --profile web add mimetics-dsh-weekly-report

从 GitHub 直装（等价写法）：

dsh plugin --profile web add github:mimetics-ai/mimetics-dsh-weekly-report

安装后重启 dsh web，然后在对话框里直接说：

帮我生成本周周报，素材是：本周把登录页崩溃修完了，数据看板还在联调……

验证已挂载（二选一）：

1. 设置 → 插件：应能看到 mimetics-dsh-weekly-report；
2. 打开调试日志（安装后设置环境变量 WEEKLY_REPORT_DEBUG=1 再启动 dsh web），启动日志会打印：

[weekly-report] generate_weekly_report 已注册 | plugin v1.3.0 | pipeline v1.1.2 | projectRoot=… | python=…

---

它做什么

• 把散素材收成一份周报：工作记录 / 聊天摘录 / Jira 工单 / Excel 表 / 会议纪要 / 日志，可混着给；
• 合并同类项：同一件事在不同来源出现多次时合并为一条，并在诊断里说明合并依据；
• 区分状态：自动分到〖本周完成〗〖进行中〗〖风险与阻塞〗〖下周计划〗四个固定模块；
• 冲突不擅自取舍：跨来源状态矛盾、或同一对象报了不同数值时，归入〖风险与阻塞〗并写明冲突点；
• 绝不编造：数值/日期一律取自素材原文；缺数据的条目不做估算，只在诊断里提示。

工具入参

参数	类型	必填	说明
materials	string[]	✅	素材列表。每项可以是文件绝对路径（.md/.txt/.csv/.xlsx），也可以是素材原文文本，两者可混用
outPath	string	✖	额外输出路径，把 Markdown 另存一份（目录自动创建）

输出示例

〖本周完成〗
- 修复登录页在 iOS 上的崩溃问题，回归通过
- 数据看板优化，覆盖 3 个核心指标
〖进行中〗
- 对账模块重构，已提测
〖风险与阻塞〗
- ⚠️ 数值冲突：跨素材数值不一致（3 条规则 / 5 条规则），完成风控规则配置，覆盖 3 条规则
〖下周计划〗
- 待确认

---

权限与风险（Clear risk）

项	说明
运行依赖	本机需有 Python 3.9+（实测 3.13 / 3.15）。插件通过 execFile 调用 Python 运行内置流水线；未找到解释器时会给出明确的配置指引
文件读写	只读写包内流水线目录与插件自己的临时目录；若你在配置里显式给出 projectRoot，则读写该目录下的 src/、config/
网络	无任何网络请求；不上传素材、不调用外部服务、无遥测
数据	素材只在本地进程间传递，产出物由你自行决定保存位置
权限	仅注册一个工具 generate_weekly_report，不申请额外系统权限、不执行生命周期脚本

配置

在 profile 的插件配置里可覆盖（一般无需配置，装上即用）：

配置键	环境变量	默认值	说明
pythonPath	WEEKLY_REPORT_PYTHON	依次探测 PATH 上的 python / python3 / py	Python 解释器：绝对路径或命令名
projectRoot	WEEKLY_REPORT_PROJECT_ROOT	包内 pipeline/ 目录	流水线根目录（含 src/pipeline.py 与 pipeline/config/config.json）
timeoutMs	—	120000	单次调用超时
—	WEEKLY_REPORT_DEBUG	未设置	设为 1 打印挂载与版本日志

兼容性

• DSH：0.2.0-rc.2 实测通过。peer 依赖：@deepseek-ai/cordis ~4.0.4、@deepseek-ai/dsh-tools 0.2.0-rc.2。 ⚠️ DSH 处于开发者预览，官方明确会有破坏性变更；升级 dsh 后请核对本段与包的版本。
• Node：>= 20.11（实测 22.x）。
• 平台：Windows 实测；macOS / Linux 未验证（代码不依赖平台专有 API，理论上可用）。
• Python：3.9+；仅用标准库，不需要 pip install 任何东西。

排障

现象	处理
启动日志没有 [weekly-report]	确认已安装且 WEEKLY_REPORT_DEBUG=1；用 dsh plugin --profile web list 核对
未找到可用的 Python 解释器	显式配置 pythonPath，或设置 WEEKLY_REPORT_PYTHON
未找到周报流水线入口	你的 projectRoot 配置指向了不含 src/pipeline.py 的目录；清掉该配置即回落到包内流水线
报 素材文件不存在	这是预期行为：路径类入参若不存在会直接失败，而不是把路径当文本产出一份假周报
中文输出乱码	不应出现（插件强制 PYTHONIOENCODING=utf-8）

---

开发

见 docs/DEVELOPMENT.md（本地加载方式、源码结构、构建与自测）。

许可与声明

• 许可证：MIT
• 主体：广州永摹纪智能科技有限公司
• 声明：本项目是社区插件，非 DeepSeek 官方项目；遵循 DeepSeek Harness 插件规范 （导出 apply(ctx)，通过 dsh.bundle.patch 声明 bundle）。问题请在本仓库提 issue。