前言¶
用 Raindrop.io 存链接的人，常见做法是打开 Raindrop 网页或客户端翻收藏夹、搜标签。要在本地开发环境里一边写 Harness、一边让 Agent 引用「我收藏过什么」，往往还要自己调 Raindrop API 或导出数据。DeepSeek Harness（DSH）支持用插件扩展侧边栏和 Agent 工具；社区目录里的 dsh-raindrop（维护者 houdinicc）把 Raindrop 库做成侧边栏仪表盘，并注册两个只读 Agent 工具，在对话里也能做聚合统计和检索。
下面介绍插件定位、能力、安装配置与使用注意。事实以 GitHub 仓库 README 为准。
这是什么¶
dsh-raindrop 是 DSH 的联网类插件：读取你在 Raindrop.io 的收藏元数据，在 DSH 中央主面板展示 KPI 与分布图，不向 Raindrop 写入。分类在 SkillHub 目录为「联网工具」；仓库当前版本为 0.1.0，许可证 MIT。
核心功能¶
侧边栏仪表盘¶
安装并配置 Token 后，侧边栏出现 Raindrop Dashboard 入口，打开后主面板包括：
- KPI：总收藏、本月新增、收藏夹数、标签数。
- 分类分布：按顶层收藏夹聚合（含子收藏夹合计），可点击跳转 Raindrop。
- 域名来源 Top：统计时排除 Raindrop 自家上传域（如
up.raindrop.io）。 - 内容类型分布：链接、文章、图片、视频、文档、音频。
- 近 12 个月新增趋势。
- 待清理：死链、无标签、重复、未分类；免费账号若 API 不提供死链/重复数据，对应卡片显示「—」，不显示为 0。
- 最近收藏：标题外链、域名、类型、标签、相对时间。
面板可手动刷新；数据默认缓存 5 分钟（见下文配置项）。
Agent 工具（只读）¶
在 enableTools 为默认 true 时，注册两个工具，均不写 Raindrop：
| 工具 | 参数 | 返回概要 |
|---|---|---|
raindrop_overview |
无 | 收藏总数、未分类、回收站、类型分布、收藏夹/标签/域名 Top、12 个月趋势、最近样本、数据可用性 |
raindrop_search |
query?、tag?、collectionId?（0 全部，-1 未分类）、limit?（1–20） |
命中书签的标题、链接、域名、类型、标签、收藏时间、摘要片段 |
数据口径¶
- 精确统计来自 Raindrop 聚合接口（如
/filters/0、/user/stats、/collections、/tags/0）。 - 域名 Top、月度趋势、最近收藏基于最近
scanPages × 50条样本，面板会标注「基于最近 N 条样本」；未分类数、各类型总数、死链/重复等仍为全库精确值（在 API 允许的前提下）。 - Raindrop 限流约 120 请求/分钟；插件请求量较少，遇 429 会按返回信息重试。
Token 与仪表盘数据经本机回环 HTTP 路由提供（/api/dsh-raindrop/status、/token、/dashboard），仅接受 127.0.0.1 / ::1 及对应 Host 校验，Token 不进入页面 DOM、日志或 Agent 上下文；持久化在 $DSH_HOME/dsh-raindrop/config.json（目录 0700、文件 0600）。
安装与启用¶
桌面版（Electron）：设置 → 插件 → 插件市场 → 搜索 dsh-raindrop → 安装。桌面 profile（desktop）由应用独占管理，dsh plugin CLI 不能操作该 profile，请用插件市场或宿主内的 plugin_manager。
命令行 / dsh web 等非 Electron profile：
dsh plugin --profile web add dsh-raindrop
本地开发可通过 Agent 调用 plugin_manager 的 install_bundle，target 指向插件目录。
安装后刷新页面，侧边栏应出现 Raindrop Dashboard。插件声明的 DSH 版本范围为 >=0.2.0-rc.1 <0.3.0，Node >=20.11。
配置 Raindrop Token¶
- 打开 https://app.raindrop.io/settings/integrations ；
- 在 For Developers 下创建应用，进入应用设置，复制 Test token（README 说明 Test token 不会过期；普通 access token 两周过期）；
- 在 DSH 面板引导页或页脚「配置 Token」粘贴并保存；页脚可随时改配或清除。
可选：在 profile 的 cordis.patch.yml 中，对 id: raindrop 的插件块覆盖 config（整体替换，字段需写全）：
| 配置 | 默认 | 说明 |
|---|---|---|
scanPages |
8 |
采样页数（每页 50 条）；0 表示完全不采样 |
cacheTtlSeconds |
300 |
缓存秒数；面板「刷新」会强制绕过 |
enableTools |
true |
是否注册上述两个 Agent 工具 |
典型用法¶
- 日常浏览：打开 Raindrop Dashboard，看分类与标签是否失衡、域名来源是否集中，用「待清理」和「最近收藏」决定补标签或删重复项。
- 对话里分析收藏：在 Harness 对话中让 Agent 调用
raindrop_overview了解库概况，或用raindrop_search按关键词、标签或collectionId拉一批书签元数据再做总结（工具只返回元数据，不代替你打开原文）。 - 调采样与缓存：库很大且域名/趋势图只需近似时，可在
cordis.patch.yml调低scanPages或缩短cacheTtlSeconds；需要最新样本时点面板刷新。
适用场景与注意¶
适合：已在 Raindrop 长期囤链接、又在 DSH 里做 Agent 开发的开发者，希望少写一层 API 胶水、在 IDE 内看统计并在 chat 里检索收藏。
注意：
- 插件以当前 DSH 进程权限运行，安装前请阅读 源码与 LICENSE，仅从可信来源安装。
- 需自行在 Raindrop 创建开发者应用并保管 Token；Token 仅存本机
config.json，但仍应视为密钥。 - 免费 Raindrop 账号部分清理类指标可能不可用，界面以「—」表示，勿误读为 0。
- 社区目录 SkillHub 插件页 与 DeepSeek / 幻方无官方从属关系，属社区生态「一切皆插件」中的一环。
结尾¶
dsh-raindrop 把 Raindrop.io 变成 DSH 侧边栏里的分析面板，并用 raindrop_overview、raindrop_search 把同一套口径延伸到 Agent 对话。安装走插件市场或 dsh plugin --profile web add dsh-raindrop，配好 Raindrop Test token 即可使用。
- 目录页：https://www.skillhub.cn/plugins/houdinicc/dsh-raindrop
- GitHub：https://github.com/houdinicc/dsh-raindrop
