内容刷取分享 ChencLi819/dsh-feed-scroll

dsh-feed-scroll

DeepSeek Harness（DSH）插件。给智能体提供内容聚合与分享能力：从 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 命令行安装（推荐）

从 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 升级与卸载

| 操作 | 步骤 |
| 升级 | 重新执行命令行安装命令；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.