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 倉庫。
