dsh-social-reach
只读的社交媒体触达能力,给 DeepSeek Harness 用。
三个工具,一条数据流:互联网 → DSH。没有评论、点赞、发帖、私信,连写接口都不注册。
| 工具 | 做什么 |
|---|---|
social_hot |
B站 / 知乎 / 抖音 / 微博 / 36氪 / IT之家 / 少数派 / Product Hunt / Hacker News 等 40+ 平台热榜 |
social_search |
在小红书 / B站 / V2EX / GitHub / YouTube / 雪球 / X / Reddit 等平台内搜索 |
social_read |
按链接读正文,自动按域名选渠道 |
它依赖两个外部件(都可选)
1. 热榜:DailyHotApi
聚合热榜 API,MIT,自托管,无需 Key:
docker run -d --name dailyhot -p 6688:6688 imsyy/dailyhot-api
默认地址 http://127.0.0.1:6688,用 DSH_SOCIAL_HOT_BASE 改。
2. 平台搜索:Agent Reach
统一多平台 CLI,MIT,本地运行:
uv tool install https://github.com/Panniantong/Agent-Reach/releases/latest/download/agent-reach.zip
agent-reach setup
装好后 agent-reach channels 能看到各平台可用性。命令路径不在 PATH 时用 DSH_SOCIAL_REACH_BIN 指定。
两个都不装也能用:social_search / social_read 会自动降级到 DSH 内置的 web_search / web_fetch(social_search 会加 site: 限定)。
安装
在 DeepSeek Harness 里:
插件 → 添加插件 → 输入本目录的绝对路径
或命令行:
dsh plugin --profile add /path/to/dsh-social-reach
装完重启 App。工具出现在所有 workspace 的所有会话里。
配置
| 环境变量 | 默认 | 说明 |
|---|---|---|
DSH_SOCIAL_HOT_BASE |
http://127.0.0.1:6688 |
DailyHotApi 地址 |
DSH_SOCIAL_REACH_BIN |
自动探测 | agent-reach 可执行文件路径 |
覆盖范围与取舍
| 平台 | 热榜 | 搜索 | 读正文 | 备注 |
|---|---|---|---|---|
| B站 | ✅ | ✅ | ✅ | 字幕需登录 |
| 知乎 | ✅ | 走 web_search site:zhihu.com |
✅ | 无官方搜索 CLI |
| 抖音 | ✅ | ❌ | ❌ | 只做热榜(设计取舍) |
| 小红书 | ⚠️ 关键词采样 | ✅ | ✅ | 无公开热榜,用热点关键词搜代替,结果会明确标注 |
| 微博 / 快手 / 头条 / 贴吧 | ✅ | ❌ | ❌ | 热榜免登录 |
| 36氪 / IT之家 / 少数派 / Product Hunt / HN | ✅ | ❌ | — | 科技资讯源 |
设计约束
- 只读:
lib/reach.js只导出search/read/channels三个动作,没有任何写路径。 - 不编造:单平台失败就跳过并在 notes 里说明,不补假数据。
- 不遥测:请求只发往本地 DailyHotApi 和本地 agent-reach 子进程,没有第三方上报。
- 凭据不出本机:登录态由 Agent Reach 自己管理(
~/.agent-reach/),不进模型上下文。
开发
无依赖、无构建、纯 ESM。
node --check index.js
node --check lib/reach.js
加新渠道:改 lib/channels.js 的两张表即可;social_hot 的枚举、默认值、标签都从那里派生。
本地开发流程
源码在本机 WSL(~/code-dsh/dsh-social-reach),Harness 跑在 Windows,无法从 \\wsl.localhost 路径加载插件(ESM 解析限制)。所以安装走打包产物:
# 1. WSL 里改完代码,打包到 Windows 可见目录
scripts/pack.sh
# 2. 在 Harness 里安装打印出的 spec
# plugin_manager install_bundle file:C:/.../_pkgs/dsh-social-reach-0.1.0.tgz
替换已安装的包后需要重启 Harness 才会加载新的模块代,HMR 只对新 bundle 生效。
License
MIT