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)。
首次使用(三步)
- 填业务配置:复制
~/.dsh/skills/douyin-oem-touliu-report/config/config.example.json
为同目录下 config.json,填写公司名、advid/groupid/view_id、四个入口 URL、数据目录与报告目录。
- 邮件通知(可选):复制
config/.env.example 为 config/.env,填 QQ/163/Outlook SMTP 凭据与收件人。
- 安装 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/<date>/(归档)、history/metrics_history.json(指标历史)。
定时任务与邮件通知的完整说明见技能内 SKILL.md「定时任务与邮件通知」一节。
工作原理
插件 index.js(apply)做三件事:
- 部署:把包内
skills/douyin-oem-touliu-report/ 复制到 ~/.dsh/skills/(用户技能根)。这样脚本可以写 config.json、.env、data/、report/、runtime/;升级插件时只同步官方文件(SKILL.md、scripts/、模板),保留用户数据(config.json、.env、data/ 等)。
- 注册:立即把技能注册进
ctx.skills(runtime 层,rank 250),resourceBase 指向已部署目录,模型无需等待文件系统 watcher 即可发现。
- 同步定时任务:若
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。
