dsh-feed-scroll

DeepSeek Harness（DSH）插件。为 agent 提供内容聚合与分享能力：从 Bilibili、知乎、掘金、贴吧、 Hacker News、少数派、IT之家、GitHub 拉取条目，读取正文、热评、字幕与视频关键帧， 并将选定条目以「封面图 + 链接」的形式发送至会话；支持按计划自动执行。

插件负责内容获取、素材准备与状态维护。分享文案由模型生成，插件不预设表达方式。

---

目录

• 1. 功能
• 2. 兼容性与依赖
• 3. 安装
• 4. 工具参考
• 5. 配置
• 6. 工作原理
• 7. 运维与故障排查
• 8. 安全与隐私
• 9. 已知限制
• 10. 开发
• 11. 许可证
• English Overview

---

1. 功能

能力	说明
内容聚合	11 个内容源，覆盖热门、排行、搜索、热搜、推荐流；auto 模式混合拉取并按兴趣权重排序
内容读取	读取正文、热评、字幕；Bilibili 支持获取视频关键帧雪碧图（10×10，供视觉模型分析）
分享素材准备	下载封面图并落盘至 QQ 发送白名单目录，返回可发送的本地路径
图片处理	任意图片直链落盘：按来源附加 Referer、按文件头识别格式、WebP 转码、等比缩放
去重与排序	记录已读条目；分享记录的标题关键词累积为兴趣画像，用于后续排序加权
计划任务	按间隔自动唤起会话执行拉取（默认每 80 分钟，10:00–23:00，每日上限 9 次）
会话保活	安装脚本调整 im-qqbot 会话超时，并提供会话恢复能力，避免推送静默失败

---

2. 兼容性与依赖

项目	要求	说明
DSH	>= 0.1.7-rc.1	见 package.json 的 dsh.engines.dsh
Node.js	>= 22.13.0	使用内置 fetch、node:zlib 等
宿主服务	tools	插件声明 inject: ['tools']，缺失时插件不生效
@tencent-connect/dsh-qqbot	>= 0.5.0（可选）	分享链路依赖其 qqbot_send_file；计划任务依赖其会话管理器
sharp	可选	用于 WebP 转码；未安装时回退为将直链交由 qqbot_send_file 处理

---

3. 安装

3.1 通过 DSH CLI 安装（推荐）

# 从 npm 安装
dsh plugin --profile web add dsh-feed-scroll

# 或从源码安装
dsh plugin --profile web add github:ChencLi819/dsh-feed-scroll

# Desktop 版
dsh plugin --profile desktop add dsh-feed-scroll

安装完成后重启 DSH，或在 profile 的 cordis.patch.yml 中修改任一配置值以触发重载。

3.2 通过仓库脚本安装

node tools/install.mjs

脚本为幂等操作，依次执行：

1. pnpm add link:<包目录>，以软链方式装入 profile；
2. 在 profile 的 dsh.profile.bundles 中登记 dsh-feed-scroll；
3. 将 im-qqbot.config.sessionIdleTimeout 由默认 30 分钟调整为 12 小时。

第 3 步为计划任务的必要前置条件。dsh-qqbot 在会话闲置超时后删除会话记录， 出站路由查询不到记录时会静默丢弃消息，导致主动推送失效。

node tools/install.mjs --check                 # 检查安装状态与配置项
node tools/install.mjs --profile-dir <path>    # 指定 profile（默认 ~/.dsh/profiles/desktop）

3.3 手动安装

在 profile 中安装包，并在 cordis.patch.yml 中注册插件：

- insert:
    - id: feed-scroll
      name: dsh-feed-scroll

3.4 升级与卸载

操作	步骤
升级	重新执行 CLI 安装命令；link: 方式安装时更新源码后重启 DSH
卸载	从 profile 的 dsh.profile.bundles 中移除 dsh-feed-scroll，并卸载依赖

---

4. 工具参考

插件注册 6 个工具。所有工具的输出均为 { text: string }。

4.1 feed_scroll

拉取内容条目，自动跳过已读项，并按兴趣权重排序。

参数	类型	默认	说明
source	string	auto	内容源 ID，取值见 6.2
query	string	—	关键词或作者名；source=bilibili-search 时必填
count	number	6	返回条数，上限 10
sort	string	totalrank	仅 bilibili-search 生效：totalrank / new / hot
mood	string	—	空格分隔的关键词，用于结果加权
include_seen	boolean	false	为 true 时包含已读条目

4.2 feed_read

读取单条内容的详情。

参数	类型	默认	说明
id	string	—	feed_scroll 返回的条目 ID，或任意 http(s) 链接
parts	string	全部	逗号分隔：text / comments / subtitles / frames
max_chars	number	1200	正文读取上限，最大 4000

4.3 feed_share

准备分享素材：下载封面图并记录分享状态。

参数	类型	默认	说明
id	string	—	条目 ID 或 http(s) 链接
comment	string	—	拟配文案，仅写入账本，不参与发送
send_image	boolean	true	为 false 时不下载封面，仅返回文本信息

返回结果包含封面图本地路径。发送动作由模型调用 qqbot_send_file 完成。

4.4 grab_image

将图片直链处理为可直接发送的本地文件。

参数	类型	默认	说明
url	string	—	图片直链（http/https）
edge	number	300	长边目标像素；0 表示不缩放
referer	string	自动推断	覆盖默认 Referer（按来源域名推断）

处理流程：按来源附加 Referer → 按文件头识别真实格式 → WebP 转 JPG/PNG（含透明通道转 PNG）→ 等比缩放 → 落盘至 mediaDir。

4.5 feed_history

查询近期浏览与分享记录。

参数	类型	默认	说明
limit	number	8	返回条数
only_shared	boolean	false	为 true 时仅返回已分享条目

4.6 feed_watch

管理计划任务。

参数	类型	默认	说明
action	string	list	add / list / pause / resume / remove / diag / recover
source	string	auto	计划任务使用的内容源
query	string	—	配合 source=bilibili-search 使用的关键词
every_minutes	number	80	执行间隔（分钟），最小 30

diag 输出会话服务可见性、agent 状态、会话记录与重建可行性；recover 按代价由低到高尝试恢复会话。

---

5. 配置

默认值定义于 index.js 的 DEFAULTS。在 profile 的 cordis.patch.yml 中按需覆盖，配置为深合并：

- id: feed-scroll
  config:
    proactive:
      maxPerDay: 5
      defaultEveryMinutes: 120
      quietFrom: 9
    promptEnabled: true

配置项	类型	默认	说明
stateDir	string	~/.dsh/feed-scroll	状态目录
mediaDir	string	~/.dsh-qqbot/media	封面与图片落盘目录，须位于 qqbot 发送白名单内
proactive.enabled	boolean	true	计划任务总开关
proactive.quietFrom	number	10	允许执行的起始小时
proactive.quietTo	number	23	允许执行的结束小时
proactive.maxPerDay	number	9	每目标每日唤醒上限
proactive.minGapMinutes	number	60	两次唤醒的最小间隔（分钟）
proactive.defaultEveryMinutes	number	80	默认执行间隔（分钟）
proactive.defaultSource	string	auto	默认内容源
proactive.allGroups	boolean	true	是否自动登记 qqbot 已知的全部群会话为目标
promptEnabled	boolean	true	是否注入内置提示词段（order: 9500）
promptText	string	空	覆盖内置提示词段

---

6. 工作原理

6.1 数据流

触发（会话请求 / 计划任务）
  └─ feed_scroll   拉取条目 → 去重 → 排序
       └─ feed_read    读取正文 / 热评 / 字幕 / 关键帧
            └─ feed_share   下载封面 → 落盘 → 返回本地路径
                 └─ qqbot_send_file   发送图片消息
                      └─ 模型生成分享文案与链接

6.2 内容源

源 ID	说明
bilibili-hot	Bilibili 热门
bilibili-rank	Bilibili 排行榜
bilibili-search	Bilibili 搜索（配合 query 与 sort）
bilibili-trending	Bilibili 热搜词
zhihu-hot	知乎热榜
juejin	掘金推荐流
tieba-hot	贴吧热议
hackernews	Hacker News 头条
sspai	少数派
ithome	IT之家快讯
github	GitHub 近期新建项目
auto	混合拉取并重新排序（默认）

Bilibili 各接口的风控策略不一致（部分接口要求 Referer，部分接口附带 Referer 会返回错误码）。 实现上按多组请求头依次尝试，采用首个返回 code=0 的结果。

6.3 内容读取能力

站点	可读取内容	接口
Bilibili	简介、作者、统计、分P、标签、热评、关键帧图、字幕	view、/x/v2/reply、/x/player/videoshot、/x/player/v2
少数派	摘要、正文	/api/v1/article/info/get
Hacker News	正文、评论	Firebase /v0/item/<id>.json
掘金 / IT之家 / 贴吧	正文	HTML 正文抽取
GitHub	README	/repos/{owner}/{repo}/readme
其他网页	正文	HTML 正文抽取
知乎	不支持	未登录访问返回 403，插件如实返回失败原因

Bilibili 关键帧接口返回 10×10 雪碧图（按时间顺序排列）。插件返回图片地址，由模型调用视觉工具分析； 多数视频的字幕需登录态，未获取到时返回明确说明。

6.4 计划任务与会话保活

• 目标登记：当 agent 在某个 QQ 会话中首次使用本插件工具时，将该会话登记为推送目标。 判定依据为宿主存在 qqbot_send_file 且最后一条用户消息不含 rpcId（Web 与桌面客户端消息含 rpcId）， 以此排除非 QQ 会话。登记时记录 scope、peerId 与 replyTarget。
• 会话恢复：会话被回收或宿主重启后，通过 qqbot-sessions 服务调用 manager.getOrCreate() 从历史恢复会话。 该服务由 tools/patch-dsh-qqbot-manager.mjs 对 dsh-qqbot 打补丁后提供； 同时保留 globalThis[Symbol.for('dsh.qqbot-sessions')] 作为备用访问路径。
• 会话去重：会话 /new 后会产生新的 session ID，账本按 peer 合并，避免同一目标重复唤醒。
• 唤醒消息：使用 agent.followup({ role: 'user', id, content, source })。 role 与 id 为必填字段，缺失会导致会话日志结构不合法，后续恢复失败。

6.5 状态与文件

路径	内容
~/.dsh/feed-scroll/state.json	账本：已读、近期、已分享、兴趣画像、推送目标
<mediaDir>/feed-*.jpg	封面图缓存
<mediaDir>/grab-*.jpg	grab_image 落盘图片
~/.dsh-qqbot/model-prefs.json	只读：qqbot:<appId>:<scope>:<peerId> 与会话 ID 的映射
~/.dsh/qqbot-sessions.log	只读：补丁加载标记

---

7. 运维与故障排查

node tools/fake-host.mjs        # 端到端自检（模拟宿主，覆盖全部工具）
node tools/smoke.mjs --cover    # 内容源连通性与封面下载
node tools/test-grab.mjs        # 图片处理链路
node tools/probe-tools.mjs      # 校验运行中的宿主是否已加载插件
node tools/install.mjs --check  # 安装状态与配置项检查

现象	可能原因	处理
工具未出现在工具表中	插件未安装或未重载	检查 profile 的 bundles 与 cordis.patch.yml，重启 DSH
计划任务未触发	会话已被回收；补丁未加载	执行 feed_watch action=diag 定位；action=recover 修复；确认补丁脚本已执行
分享无封面图	目标站点无封面或下载失败	预期降级，仅发送文本与链接
图片发送失败	mediaDir 不在 qqbot 发送白名单内	将 mediaDir 指向白名单目录
WebP 未转码	profile 未安装 sharp	安装 sharp，或接受回退至 qqbot_send_file 处理
内容源请求超时	当前网络环境不可达	更换 source；部分站点在特定网络环境下不可用
修改源码后未生效	热重载存在延迟；ESM 模块缓存	重启 DSH；feed_watch action=diag 输出 rev 可用于确认运行版本

会话日志结构异常时（缺少 id/role 的消息事件），可使用 tools/repair-session-log.mjs 修复：

node tools/repair-session-log.mjs <session.v4.jsonl.zstd>          # 预演
node tools/repair-session-log.mjs <session.v4.jsonl.zstd> --apply  # 写回（自动备份）

---

8. 安全与隐私

• 网络访问：仅访问上述站点的公开接口。不向第三方服务发送本地文件、会话内容或凭据。
• 凭据：本插件不使用任何 API Key。
• 数据落盘：状态文件与图片缓存；账本不记录会话正文。
• 本地读取：为确定推送目标，读取 dsh-qqbot 的会话记录与映射文件，不修改其内容。
• 主动消息：向群会话主动发送消息受 QQ 平台权限控制，需群管理员开启机器人主动发言权限。

---

9. 已知限制

• 知乎正文读取不可用（需登录态），插件返回明确失败信息而非占位内容。
• 不提供视频与音频下载及语音识别能力。
• 计划任务依赖 dsh-qqbot 的会话保活机制与配套补丁；该补丁在 dsh-qqbot 升级后需重新执行。
• 部分站点（V2EX、Reddit、RSSHub、linux.do 等）在部分网络环境下不可达，未纳入默认内容源。
• 微博接口返回 403；Bilibili 作者空间接口受 WBI 风控限制，作者更新通过搜索接口的 sort=new 实现。

---

10. 开发

10.1 目录结构

index.js                插件入口：工具注册、提示词段、计划任务
lib/sources.js          内容源、混合拉取、兴趣加权、链接反查
lib/read.js             内容读取与正文抽取
lib/store.js            账本读写（原子写入）
lib/card.js             封面图下载与落盘
lib/grab.js             图片处理（Referer、格式识别、转码、缩放）
lib/http.js             HTTP 封装（UA、超时、重试、风控页识别）
lib/text.js             文本处理（去标签、截断、格式化、关键词提取）
tools/                  安装、补丁、自检与诊断脚本
locale/{zh,en}.json     插件市场展示信息

10.2 本地验证

node tools/fake-host.mjs --no-network   # 不依赖网络的接线验证
node tools/smoke.mjs --cover            # 内容源与封面链路
node tools/test-grab.mjs                # 图片处理链路

提交前请确保上述脚本通过。

---

11. 许可证

MIT

---

English Overview

dsh-feed-scroll is a DeepSeek Harness plugin that aggregates content from Bilibili, Zhihu, Juejin, Tieba, Hacker News, SSPAI, ITHome and GitHub, and shares selected items to a chat session as a cover image plus link. The plugin prepares media and maintains state; the accompanying text is generated by the model.

It registers six tools — feed_scroll, feed_read, feed_share, grab_image, feed_history and feed_watch — and supports scheduled execution (default: every 80 minutes, 10:00–23:00, up to 9 runs per day). Requirements: DSH >= 0.1.7-rc.1, Node.js >= 22.13.0, and optionally @tencent-connect/dsh-qqbot >= 0.5.0 for the sharing path.

dsh plugin --profile web add github:ChencLi819/dsh-feed-scroll

Licensed under the MIT License.