dsh-overseas-trending · 海外跨平台热文搜索

输入任意关键词（中文/英文），一次搜索 X / TikTok / YouTube 三平台热门内容，每平台 Top N 统一列表，语言优先分层，深色主题交互式 HTML 报告（卡片/表格双视图）。

dsh 插件（完整形态：原生工具 + 数据持久化 + 侧栏看板）。平台适配器模式，移植自 redfox-community 的 skills/overseas-trending-search，Python 引擎（digest.py + sources/ 共 963 行）全量重写为 Node。

⚠️ 实测要点（对上游的适配）

• TikTok searchVideo 接口已变更：需 offset + count 参数（上游脚本仅传 keyword，会报 3203「count不能为空」）——插件已适配新参数。
• 积分消耗大：YouTube 点赞/评论需逐条调 videoDetail 补全（默认补前 5 条，可调 0-20）——三平台并行采集，YouTube 详情 4 路并发 + 45s 总预算；实测三平台搜索约 25-35s，面板上有按钮倒计时与状态行提示。
• 默认值（即点即搜，不用先调参）：时间窗口 7 天、每平台 5 条、YouTube 详情 5 条、按播放量排序。
• X search 必填 searchType=Top（缺失会误报 3203）。
• TikTok 热门多为历史内容：默认已是 7 天窗口（覆盖大部分 TikTok 热门）；要更全传 days=30 或 0=不限（工具回执注明排除数）。

功能

• overseas_search 工具（agent 对话内使用）
  • search：keywords × platforms 循环采集（平台故障优雅降级，状态如实标注）→ 时间窗口过滤 → 语言分层 + 组内降序 + 每平台 Top N
  • list / get：搜索历史与补读
• 语言优先分层：中文关键词优先中文内容、英文关键词优先英文内容，其他语言兜底（字符集识别，无第三方依赖）
• 统一记录 schema：platform / title / url / author / likes / comments / views / shares / publish_time / lang
• 侧栏看板：搜索表单（平台多选/时间窗口/排序/条数/详情补全量）、平台状态统计格、历史归档、交互式 HTML 报告（上游模板：筛选 chips + 卡片/表格双视图 + 全字段）
• overseas-trending 技能：展示规范 + 积分纪律 + 平台状态转述规则

安装

dsh plugin --profile web add file:D:/dsh-research/dsh-overseas-trending

前置：dsh >= 0.2.1-rc.2；RedFox API Key（红狐 hub 获取，ak_ 开头）。

开发

npm install        # 安装依赖并构建 dist/client.js
npm test           # 单测（node --test）
npm run smoke      # 离线冒烟：假三平台服务器（降级/语言分层/时间窗口）+ 工具直调 + 面板 API 全路由
npm run dev        # 开发预览：DSH_HOME=<数据目录> node scripts/devserver.mjs 5210
npm run live       # 真实搜索：DSH_HOME=<目录> node scripts/live.mjs [关键词] ak_xxx

数据目录：$DSH_HOME/overseas-trending/（settings.json + searches//meta.json、raw.json、report.html）。

License

MIT