DeepSeek Harness (DSH) 的核心理念是“一切皆插件”，通过插件可以快速扩展智能体的联网与数据处理能力。在本地推业务中，整理客资、投放计划与视频分析数据往往需要跨平台复制粘贴，耗时且容易出错。下面介绍 dsh-douyin-oem-touliu-report 插件，它用于解决 OEM 投流日报与周报的自动化生成问题。
插件信息¶
- 名称：dsh-douyin-oem-touliu-report
- 作者：ruiyukirin
- 分类：联网工具
- 许可：MIT
核心功能¶
安装后，该插件会自动将 douyin-oem-touliu-report 技能部署到用户技能根目录（~/.dsh/skills/），DSH 立即获得该技能。其核心能力包括：
- 数据采集：采集抖音来客与巨量本地推的三源数据，包括客资中心、计划级投放与视频分析。
- 报告生成：计算关键指标，生成 A4 版式的 OEM 投流日报或周报（docx 格式）。
- 自动化支持：支持可选的邮件通知与 Windows 定时任务。
安装与启用¶
使用官方插件市场安装：
dsh plugin --profile web add dsh-douyin-oem-touliu-report
安装完成后，重启 dsh web，在设置 → Plugin Market 中确认插件已显示，技能目录中会出现 douyin-oem-touliu-report 目录。
配置与运行¶
1. 业务配置¶
复制配置模板并填写业务信息：
# 复制示例配置
cp ~/.dsh/skills/douyin-oem-touliu-report/config/config.example.json ~/.dsh/skills/douyin-oem-touliu-report/config.json
在 config.json 中填写以下内容：
* 公司名：企业标识。
* 账号 ID：advid、groupid、view_id。
* 入口 URL：四个数据入口地址。
* 路径：数据目录与报告目录（建议使用绝对路径）。
2. 邮件通知（可选）¶
若需自动发送报告，需配置 SMTP：
cp ~/.dsh/skills/douyin-oem-touliu-report/config/.env.example ~/.dsh/skills/douyin-oem-touliu-report/config/.env
在 config/.env 中填写 QQ/163/Outlook 的 SMTP 凭据与收件人邮箱。
3. 环境依赖¶
安装 Python 依赖并配置浏览器驱动：
pip install -r requirements.txt
playwright install
首次运行需使用本机 Edge 浏览器登录抖音来客以获取登录态，后续运行可复用。
4. 手动运行¶
在技能目录下执行：
cd ~/.dsh/skills/douyin-oem-touliu-report
python scripts\run.py --date 2026-08-27 # 生成指定日期的日报（默认为前一日）
自动化配置¶
在 config.json 中添加 schedule 节，可设置日报或周报的自动执行时间：
"schedule": {
"daily_enabled": true,
"daily_time": "09:30",
"weekly_enabled": true,
"weekly_time": "10:00",
"weekly_day": "MON"
}
保存后重启 DSH 或执行 setup_schedule.ps1，系统会自动注册 Windows 计划任务。任务以当前 Windows 用户身份静默运行，日志位于 runtime/ 目录。
注意事项¶
- 脱敏发行：本包为脱敏版本，不包含任何真实公司名、账号 ID、SMTP 凭据与运行时数据，安装后需自行配置。
- 权限与路径：定时任务使用当前 Windows 用户身份运行，
config.json中的data_dir和report_dir必须填写绝对路径，否则任务可能因找不到目录而失败。 - 全球可用：该插件为开源发行版，全球用户可一键安装。
总结¶
该插件通过自动化脚本解决了抖音本地推 OEM 业务中繁琐的数据整理工作。对于需要定期输出结构化报告的开发者或运营人员，它提供了从数据采集到报告落地的全流程工具。更多细节与源码，可参考 GitHub 仓库。
