前言¶
在 DeepSeek Harness（DSH）里做社区或游戏资讯相关的工作流时，常见需求是：按固定节奏读推荐帖、在可控额度下发表评论或回复消息，并把浏览与发送记录留在本地可查。若只靠浏览器手动刷帖，很难和 DSH 会话、模型生成统一调度；若自己写脚本对接小黑盒接口，还要处理登录、签名和任务持久化。
下面介绍社区插件 dsh-xiaoheihe（维护者 fbbDirge，GitHub 仓库 fbbDirge/dsh-xiaoheihe，目录页 SkillHub）。它在 DSH 宿主上运行后台任务：定时读未读推荐、可选自动评论与自动回复，设置页组织方式参考 dsh-bili-scroll，不使用侧栏、悬浮胶囊或遮罩面板。当前版本 0.10.9（MIT）。
这是什么¶
dsh-xiaoheihe 是基于 DSH 的小黑盒后台浏览与互动插件。配置入口在 DSH Web 设置 → 刷小黑盒；各会话可通过 刷过的帖子 标签查看当前账号的持久浏览档案（需宿主支持 conversation.view）。浏览、自动评论、自动回复默认关闭，由用户在设置里显式开启。
插件在你安装 DSH 的机器上执行，账号与浏览数据保存在该宿主，README 说明其不依赖开发者托管的数据收集服务；同时需要联网访问小黑盒官方 API 以及你在 DSH 中配置的模型或第三方 Chat Completions API。非官方项目，平台接口可能变动。
核心功能¶
以下能力均来自仓库 README 功能表与版本说明，可按 Tab 在设置页分项配置。
| 能力 | 说明 |
|---|---|
| 定时浏览 | 独立开关；间隔 1–1440 分钟；每轮 1–10 个未读推荐帖；默认 30 分钟读 1 帖 |
| 自动评论 | 独立开关；依帖子上下文经模型生成评论；可 @ 作者、自定义用户（ID + 昵称）或不提及 |
| 自动回复 | 独立调度，默认每 180 秒检查来信（可设 30–86400 秒）；可与浏览分开运行 |
| 回复队列 | 超额或失败回复按账号写入本地 automation.json，下轮继续；可查看尝试次数与原因 |
| 运行时段 | 不限时段、快捷峰谷/峰底方案，或自定义多段窗口；回复可选跟随浏览时段 |
| 额度与冷却 | 每日评论 / 回复额度各 0–9999，默认各 10；共享发送冷却与去重 |
| 评论记录 | 本账号最近 100 条评论 / 回复，含正文、来信与发送状态 |
| 账号登录 | 小黑盒 App 扫码（二维码约 120 秒有效）；Cookie 备用 |
| 模型来源 | 默认 DSH 已配置模型；高级设置可切第三方 HTTPS API |
| 会话档案 | 刷过的帖子 每页 50 帖，所有会话共享当前账号档案 |
0.10.9 起每日额度上限扩展至 9999，升级保留已设额度。发布新帖、定时发帖、关键词搜图 README 标明尚未实现。
安装与启用¶
Node 需满足已安装 DSH 的要求；仓库开发验证使用 Node 24，package.json 要求 node >= 18。安装命令以 README 为准：
dsh plugin --profile web add github:fbbDirge/dsh-xiaoheihe
重启 DSH Web 并刷新页面，打开 设置 → 刷小黑盒。本地开发也可指向仓库目录：
dsh plugin --profile web add /path/to/dsh-xiaoheihe
插件沿用 heybox 包名与配置目录，与其他同名插件应二选一。设置页为「概览 / 账号 / 浏览 / 互动 / 评论记录 / 运行时段 / 高级」七个 Tab，底部 保存设置 统一写入配置。
主要数据路径（默认 DSH_HOME 为 ~/.dsh）：
$DSH_HOME/heybox/state.json：账号 Cookie$DSH_HOME/heybox/config.json：调度、人格、第三方 API 密钥（权限 0600）$DSH_HOME/heybox/automation.json：额度、去重、浏览档案与评论正文$DSH_HOME/heybox/dependencies：一键安装的qrcode@1.5.4
典型用法¶
1. 登录与验证浏览¶
- 打开 设置 → 刷小黑盒 → 账号 → 扫码登录，用小黑盒 App 扫二维码并在手机确认；不可用时在 Cookie 登录（备用） 从小黑盒网页版复制 Cookie 保存。
- 在 浏览 Tab 开启定时浏览，设间隔与每轮帖数，保存后先用 立即执行一轮 验证读取；建议先保持评论 / 回复关闭。
2. 开启互动与模型¶
在 互动 Tab 按需开启自动评论或自动回复，设置额度、冷却及 通用人设与兴趣（帖子评论）与 回复人格（留空则沿用通用人设，各最多 2000 字符）。自定义 @ 默认需昵称与用户 ID；可开启「缺少 ID 时允许纯文本 @」（仅帖子评论，通知效果 README 标明仍待平台验证）。
使用前可确认 headless 模型可用：
dsh --profile headless "只回复测试"
3. 运行时段与记录¶
在 运行时段 选择不限或限制任务开始窗口；自动回复仅在开启「回复跟随浏览运行时段」时受同一限制。评论记录 Tab 查看发送状态；结果未知不会自动重发，需到平台核对。高级 → 依赖与环境 可一键安装扫码依赖，无需重启 DSH。
关闭设置页或浏览器不会停止任务；DSH Web 宿主需持续运行，退出宿主后任务停止。任务运行中需先 停止全部任务 再改配置。
适用场景与注意¶
适合：已在 DSH 上跑模型、希望把小黑盒读帖与有限度评论 / 回复纳入同一宿主调度，并需要本地评论记录与回复队列的开发者或高级用户。
务必注意：
- 插件以当前 DSH 进程权限运行，凭据保存在磁盘且 README 说明并非加密存储；安装前请自行查看 源码与许可证，并阅读 README 安全与隐私 一节中的数据流向表。
- 自动浏览指读取正文，不保证增加平台浏览量；已提交平台的请求无法撤回。
- 数据层源自 plasta2steel/dsh-xiaoheihe，接口签名移植自 WenfuRainbow/heybox；与 DeepSeek / 幻方无官方从属，SkillHub 为社区目录站点。
结尾¶
dsh-xiaoheihe 把小黑盒的后台浏览、额度受控的评论回复和 DSH 模型生成收拢到 设置 → 刷小黑盒 与 刷过的帖子 档案，适合在自托管 DSH 上做多 Tab 配置、可持久化的社区互动工作流。详情与版本变更见 GitHub README；目录索引见 SkillHub 插件页。
