前言¶
在 DeepSeek Harness（DSH）里做智能体或日常信息整理时，很多人会把微博、雪球当作一手来源。平台上的帖子可能被删、改可见范围或半年后不可见；每天手动刷主页也容易漏掉。Social Trace 是 DSH 社区目录里 chiinsight 维护的联网类插件，按博主做增量检查，把正文、转发原文和配图归档到本机，并支持本地检索与可选的 dsh-im 推送，和「把账号交给模型去刷」的做法是分开的：登录在插件自己的浏览器里完成，Cookie 不经过模型。
这是什么¶
Social Trace（npm 包名 dsh-social-trace，当前版本 0.1.2）的定位是：本地社交动态监控。维护者为 chiinsight，许可 MIT。它解决的核心问题是：把你关注的微博、雪球博主说过的话，按博主留在本地资料库里，便于之后搜索、导出，并在有新内容时按需提醒。
插件在 Harness 侧栏以 Web 客户端运行；资料默认落在本机，不写进插件仓库，也不默认上传云端。
核心功能¶
以下能力均来自项目 README 与 package.json 说明。
| 能力 | 说明 |
|---|---|
| 按博主监控 | 微博、雪球；每位博主可单独设置开关、检查频率和时间段 |
| 增量检查 | 定时读取新动态；关机或重启后会补查期间仍可见的内容 |
| 历史缓存 | 按日期范围回补旧动态，支持断点续传，避免重复抓取 |
| 完整留档 | 正文、转发原文、配图；按平台与博主 UID 分目录保存 |
| 本地资料库 | SQLite，外加按博主分目录的 Markdown；支持中文正文搜索 |
| 导出 | 单博主 Markdown / JSONL，正文与来源一并导出 |
| 可视化流向 | 博主 → 平台 → Social Trace → 资料库四层拓扑，便于看状态、进度与异常 |
| dsh-im 推送 | 新动态原文通知到 QQ / 微信等；多接收目标；默认关闭 |
| 本地优先 | 授权会话仅存插件目录（权限 0600）；资料库需自行放在可信磁盘 |
边界需提前知晓：采集依赖电脑唤醒且 Harness/插件在运行；已删除或超出平台可见范围的内容无法补回；雪球文章只保存标题和原文链接，不保存文章正文；当前推送为原文通知，未接入 AI 总结或在 IM 内问答。
安装与启用¶
环境要求：DeepSeek Harness 桌面版、Google Chrome，以及 Node.js 22.19 或以上（package.json 中 engines.node 为 >=22.19）。
从 npm 安装（也可在 Harness 插件管理里直接安装 dsh-social-trace）：
dsh plugin --profile desktop add dsh-social-trace
安装后完全退出并重新打开 Harness，在侧栏打开 Social Trace。
插件以当前 DSH 进程权限运行；安装前可在 GitHub 仓库 查看源码与 MIT 许可证，在 社区目录页 核对元信息。DSH 生态理念是「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
典型用法¶
按 README「快速开始」，建议顺序如下。
- 选保存位置：在「连接与设置」里选择资料库文件夹。默认目录为
~/.local/share/dsh-social-trace/，也可改为自己的路径。 - 登录平台：点「登录微博」或「登录雪球」，在独立浏览器窗口完成登录，返回后点「我已登录，继续」。
- 添加博主：粘贴微博/雪球主页链接或数字 UID，读取昵称、头像与总数，选择「从现在开始记录」或「按日期范围缓存历史」。
- 调频率：在大屏里点博主、平台或总控齿轮，设置检查频率、时间段和历史范围。
- 开推送（可选）：先在 dsh-im 里连接机器人并创建接收目标，再在 Social Trace 的 dsh-im 节点添加渠道、选择博主范围并开启自动推送。
资料库目录结构示意：
你选择的文件夹/
archive.sqlite 正文、任务、状态和消息
documents/
weibo/<UID>/ 该博主的 Markdown 与配图
xueqiu/<UID>/
登录会话单独保存在插件目录（0600），不进入资料文件夹。资料库不是加密库；需要更高保护时，请把文件夹放在加密磁盘上。
通过 dsh-im 推送¶
推送内容是新动态原文通知（博主、发布时间、正文节选、转发引用、原文链接），不是 AI 摘要。
- 默认关闭；历史缓存与开启前已存内容不会补发。
- 支持多个接收目标，各目标可单独开关；某一渠道失败不影响其他渠道。
- 机器人密钥由 dsh-im 管理，Social Trace 不重复保存。
配置入口：大屏的 dsh-im 节点，或「连接与设置」里的消息推送区域。
适用场景与注意¶
适合谁
- 需要长期留档自己关注博主的微博、雪球动态，并希望在本地做中文搜索或导出。
- 希望定时增量检查、减少手动刷主页，且不愿把平台 Cookie 交给模型。
- 已在使用 dsh-im，并希望在有新帖时把原文通知推到 QQ / 微信（可选）。
使用注意
- 平台要求登录或验证时会暂停采集，需人工处理；插件不绕过验证码、不轮换账号、不使用代理池。
- 推送只覆盖开启之后新采集的内容；失败或结果未知不会自动重发，避免重复打扰。
- 评估隐私与合规：归档内容仅限个人授权范围内使用，遵守各平台服务条款。
结尾¶
Social Trace 把微博与雪球的增量监控、历史缓存、本地 SQLite/Markdown 资料库和可选 dsh-im 通知收进一个 DSH 插件里，适合「本地留档 + 可控提醒」的需求。更多信息见社区目录 chiinsight/dsh-social-trace 与源码仓库 github.com/chiinsight/dsh-social-trace。
