前言¶
写周报时，素材往往散落在聊天记录、工单、表格和会议纪要里。手工整理要合并重复条目、区分「已完成 / 进行中 / 风险 / 下周计划」，还要避免把不同来源里矛盾的数字写进正文。DeepSeek Harness（DSH）支持通过工具插件扩展对话能力；mimetics-dsh-weekly-report 由社区维护者 mimetics-ai 发布，归类为模型推理相关插件，在 Harness 对话框里用自然语言触发内置流水线，输出固定四模块的 Markdown 周报。
这是什么¶
mimetics-dsh-weekly-report 是 DSH 工具插件：安装并重启 dsh web 后，在对话框说「帮我生成本周周报」即可。实际由工具 generate_weekly_report 驱动包内 Python 流水线，把散素材收成一份结构固定的周报，无需单独搭服务或改 Harness 核心。
插件在 dsh-plugin.org 有收录；源码与说明见 GitHub 仓库。许可证为 MIT，主体为广州永摹纪智能科技有限公司；属社区插件，非 DeepSeek 官方项目。
核心功能¶
下面介绍 README 中已说明的行为，均可对照仓库文档核对。
素材形态
- 工作记录、聊天摘录、Jira 工单、Excel、会议纪要、日志等可混着给；
- 工具入参
materials为字符串数组：每项可以是.md/.txt/.csv/.xlsx的文件绝对路径，也可以是原文文本，两者可混用。
整理规则
- 同一件事在多来源出现时会合并，并在诊断里说明合并依据；
- 自动归入四个固定模块：〖本周完成〗、〖进行中〗、〖风险与阻塞〗、〖下周计划〗；
- 跨来源状态矛盾或同一对象数值不一致时，归入〖风险与阻塞〗并写明冲突点，不擅自取舍；
- 数值与日期只取自素材原文；缺数据不做估算，仅在诊断里提示。
输出
- 默认在对话中返回 Markdown；可选参数
outPath将结果另存到指定路径（目录会自动创建）。
输出形态示例（摘自 README）：
〖本周完成〗
- 修复登录页在 iOS 上的崩溃问题，回归通过
- 数据看板优化，覆盖 3 个核心指标
〖进行中〗
- 对账模块重构，已提测
〖风险与阻塞〗
- ⚠️ 数值冲突：跨素材数值不一致（3 条规则 / 5 条规则），完成风控规则配置，覆盖 3 条规则
〖下周计划〗
- 待确认
运行方式与安全边界
- 本机需 Python 3.9+（README 写明实测 3.13 / 3.15）；插件通过
execFile调用 Python 跑内置流水线，仅用标准库，不需要pip install； - 无网络请求：不上传素材、不调用外部服务、无遥测；
- 文件读写限于包内流水线目录与插件临时目录；若在配置中显式设置
projectRoot，则读写该目录下的src/、config/； - 仅注册工具
generate_weekly_report，不申请额外系统权限。
安装与启用¶
在 DSH 的 web profile 下安装（命令来自 README）：
dsh plugin --profile web add mimetics-dsh-weekly-report
从 GitHub 直装的等价写法：
dsh plugin --profile web add github:mimetics-ai/mimetics-dsh-weekly-report
安装后重启 dsh web。验证是否挂载可二选一：
- 设置 → 插件：应能看到
mimetics-dsh-weekly-report； - 设置环境变量
WEEKLY_REPORT_DEBUG=1再启动dsh web，启动日志应出现类似：
[weekly-report] generate_weekly_report 已注册 | plugin v1.3.0 | pipeline v1.1.2 | projectRoot=… | python=…
也可用 dsh plugin --profile web list 核对插件列表。
可选配置（profile 插件配置或环境变量，一般无需改）：
| 配置键 | 环境变量 | 默认值 | 说明 |
|---|---|---|---|
pythonPath |
WEEKLY_REPORT_PYTHON |
PATH 上 python / python3 / py |
Python 解释器 |
projectRoot |
WEEKLY_REPORT_PROJECT_ROOT |
包内 pipeline/ |
流水线根目录 |
timeoutMs |
— | 120000 |
单次调用超时 |
| — | WEEKLY_REPORT_DEBUG |
未设置 | 设为 1 打印挂载与版本日志 |
兼容性（README 原文）
- DSH：
0.2.0-rc.2实测通过；DSH 处于开发者预览，升级后请核对文档与包版本； - Node：
>= 20.11（实测 22.x）； - 平台：Windows 实测；macOS / Linux 未验证，代码不依赖平台专有 API。
典型用法¶
重启 dsh web 后，在对话框直接描述需求并附上素材，例如：
帮我生成本周周报，素材是：本周把登录页崩溃修完了，数据看板还在联调……
若要通过工具显式调用，入参为：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
materials |
string[] |
是 | 文件路径或原文，可混用 |
outPath |
string |
否 | 额外 Markdown 输出路径 |
路径类入参若文件不存在会直接失败，不会把路径当文本生成假周报——README 将其标为预期行为。
适用场景与注意¶
适合谁
- 已在用 DSH web profile、希望用对话或工具把多来源工作记录收成固定格式周报的团队或个人；
- 需要在本地处理素材、且能接受本机安装 Python 3.9+ 的环境。
使用前请知悉
- 插件以当前 dsh 进程权限运行；安装前建议阅读仓库源码与 MIT 许可证，确认符合你的合规要求；
- 社区插件目录 skillhub.cn / dsh-plugin.org 与 DeepSeek / 幻方无官方从属关系，并非官方应用商店；
- 排障可参考 README：未找到 Python 时配置
pythonPath或WEEKLY_REPORT_PYTHON；projectRoot指错目录时清掉配置可回落包内流水线；启动无[weekly-report]时检查安装与WEEKLY_REPORT_DEBUG=1。
结尾¶
mimetics-dsh-weekly-report 把「散素材 → 四模块 Markdown 周报」做成装上即用的 DSH 工具：一句「帮我生成本周周报」即可触发，合并与冲突处理有明确规则，且全程本地、无外网。目录页：https://www.skillhub.cn/plugins/mimetics-ai/mimetics-dsh-weekly-report；仓库：https://github.com/mimetics-ai/mimetics-dsh-weekly-report。
