抖音投流报表 ruiyukirin/dsh-douyin-oem-touliu-report

dsh-douyin-oem-touliu-report

作者：Kirin · GitHub · MIT License

抖音本地推 OEM 投流日报 / 周报自动化插件（Douyin local-promotion OEM ad report automation for DeepSeek Harness）。

安装后自动把 douyin-oem-touliu-report 技能部署到用户技能根（~/.dsh/skills/），DSH 立即获得该技能：采集抖音来客 + 巨量本地推三源数据（客资中心 / 计划级投放 / 视频分析），计算指标，生成 A4 版式 OEM 投流日报 / 周报 docx，可选邮件通知与 Windows 定时任务。

本包为脱敏发行版：不含任何真实公司名、账号 ID、SMTP 凭据与运行时数据。上架插件市场后全球用户可一键安装。

安装

npm 发布后(推荐)
dsh plugin --profile web add dsh-douyin-oem-touliu-report

或直接从 GitHub(发布后)
dsh plugin --profile web add github:ruiyukirin/dsh-douyin-oem-touliu-report

安装完成并重启 dsh web 后，可在设置 → Plugin Market 中看到；技能出现在 agent 技能目录中（名称 douyin-oem-touliu-report）。

首次使用（三步）

1. 填业务配置：复制 ~/.dsh/skills/douyin-oem-touliu-report/config/config.example.json 为同目录下 config.json，填写公司名、advid/groupid/view_id、四个入口 URL、数据目录与报告目录。
2. 邮件通知（可选）：复制 config/.env.example 为 config/.env，填 QQ/163/Outlook SMTP 凭据与收件人。
3. 安装 Python 依赖：pip install -r requirements.txt，然后 playwright install（供 Edge 浏览器自动化）；首次运行采集用本机 Edge 登录一次抖音来客，之后复用登录态。

自由设定自动执行时间（日报 / 周报）

想让它每天自动跑？不用管理员权限，不用手动建任务。在 config.json 里加一个 schedule 节，改好时间即可：

"schedule": {
"daily_enabled": true,
"daily_time": "09:30",
"weekly_enabled": true,
"weekly_time": "10:00",
"weekly_day": "MON"
}

- daily_enabled / daily_time — 日报每天几点跑（24 小时制，如 "09:30"）
- weekly_enabled / weekly_time / weekly_day — 周报每周几几点跑（MON~SUN）
- 把某个 _enabled 改成 false 就会删掉对应任务

保存后重启 DSH（插件启动时自动同步），或手动执行一次：

powershell -ExecutionPolicy Bypass -File ~\.dsh\skills\douyin-oem-touliu-report\scripts\setup_schedule.ps1

它会自动注册两个 Windows 计划任务：OEM投流日报、OEM投流周报（任务以隐藏窗口静默运行，不弹黑窗口）。之后每次改时间，重跑一次就更新；日志在 runtime/daily.log、runtime/weekly.log。

提示：定时任务用你当前 Windows 用户身份运行，config.json 里的 data_dir / report_dir 请填绝对路径，否则任务运行时可能找不到数据目录。

运行

cd ~\.dsh\skills\douyin-oem-touliu-report
python scripts\run.py --date 2026-08-27 # 一键日报(date=报告主体日=前一日)
python scripts\weekly_report.py --week-end 2026-08-25 # 周报

数据落盘：data/（三源 xlsx）、report/（docx）、archive//（归档）、history/metrics_history.json（指标历史）。
定时任务与邮件通知的完整说明见技能内 SKILL.md「定时任务与邮件通知」一节。

工作原理

插件 index.js（apply）做三件事：

1. 部署：把包内 skills/douyin-oem-touliu-report/ 复制到 ~/.dsh/skills/（用户技能根）。这样脚本可以写 config.json、.env、data/、report/、runtime/；升级插件时只同步官方文件（SKILL.md、scripts/、模板），保留用户数据（config.json、.env、data/ 等）。
2. 注册：立即把技能注册进 ctx.skills（runtime 层，rank 250），resourceBase 指向已部署目录，模型无需等待文件系统 watcher 即可发现。
3. 同步定时任务：若 config.json 里有 schedule 节，自动调用 scripts/setup_schedule.ps1，把使用者设定的日报 / 周报执行时间注册为 Windows 计划任务（每次 DSH 启动同步一次；非 Windows 自动跳过）。

目录结构

dsh-douyin-oem-touliu-report/
├── package.json # npm bundle(dsh.bundle.patch)
├── cordis.patch.yml # 插件行 ├── index.js # 部署 + 注册逻辑 └── skills/ └── douyin-oem-touliu-report/ # 技能本体(SKILL.md + scripts + config 模板)

许可

MIT — 见 LICENSE。