🎮 HeyBox · 小黑盒论坛分区

在 DeepSeek Harness Web 会话右侧开一个小黑盒(xiaoheihe.cn)论坛分区。
形态与交互移植自 WenfuRainbow/heybox(VSCode 小黑盒插件)

---

简介

这个插件把heybox(VSCode 版)的「小黑盒论坛浏览」搬进 DSH Web 的右侧分栏 —— 让 DeepSeek 干活时, 旁边挂着一个小黑盒。小黑盒的账号态与接口都需要 Cookie 与 hkey 签名,无法从网页直连。

功能

模块	说明
📌 推荐	热门推荐信息流,滚动到底部「加载更多推荐」
📁 板块	热门板块分类(数码硬件 / 盒友杂谈 / Steam…),点板块展开帖子,支持分页加载
⭐ 收藏	本机收藏 + 服务端同步(调 /bbs/app/link/favour),列表点 ★ 取消
🔍 搜索	全站帖子搜索、分页「加载更多」、返回列表;粘贴链接或输入帖子 ID 可直接开帖
📄 帖子详情	标题/作者/话题标签/正文(JSON 富文本块:图文),图片缩放滑块(5–100%,记忆)、悬停原图预览
💬 评论	按楼层组的主评 + 子评论缩进、楼层号、IP 属地、折叠提示;自动分页拉取并去重(上限 700 条,不足时注明)
🔔 消息	登录后每 3 分钟检查回复/点赞,铃铛显示未读数,列表可跳转、全部已读
🔑 登录	粘贴浏览器 Cookie(只发给主机,存 $DSH_HOME/heybox/state.json,不下发浏览器)
◐ 主题	跟随 DSH(默认)/ 强制暗色 / 强制亮色,面板内切换
⬌ 分区	右缘贴会话列的空档,不挡聊天与输入框;可拖宽(340–780px)、Esc/「»」收起;窄窗自动收成胶囊

数据来源

完全对齐 heybox 的 src/api/client.ts + signature.ts:

• 接口:api.xiaoheihe.cn,/bbs/app/feeds(推荐)、/bbs/app/topic/categories(板块)、 /bbs/app/topic/feeds(板块帖子)、/bbs/app/link/tree(帖子树/评论)、 /bbs/app/api/general/search/v1/web(搜索)、/bbs/app/user/message(消息)、 /bbs/app/link/favour(收藏)
• 每个请求携带公共参数(os_type=web / x_client_type=web / device_id …)与 hkey / _time / nonce 签名 —— 全部在 dsh web 进程内生成,浏览器看不到也不持有 Cookie。
• 图片/头像经主机 /heybox/img 白名单代理(*.xiaoheihe.cn、*.max-c.com)。

安装

从 GitHub 安装

dsh plugin --profile web add github:plasta2steel/dsh-xiaoheihe

本地开发安装(把下面路径换成你的插件目录即可,无需构建)

dsh plugin --profile web add /path/to/dsh-xiaoheihe

装完重启 dsh web 并刷新页面,右侧即出现分区。

本地开发安装(把下面路径换成你的插件目录即可,无需构建)

dsh plugin --profile web add /path/to/dsh-xiaoheihe

装完重启 dsh web 并刷新页面,右侧即出现分区。

使用

1. 右侧出现「小黑盒 · HeyBox」分区(空间不足时先点胶囊展开)。
2. 点「登录」→ 浏览器打开 xiaoheihe.cn 并登录 → F12 → Network → 任一请求头里复制 Cookie → 粘贴。 Cookie 需含 heybox_id= / x_xhh_tokenid= / user_pkey= 之一,过期重新粘贴即可。
3. 切「推荐 / 板块 / 收藏」浏览;点帖子看正文与评论;🔍 搜索;🔔 看消息。

开发

npm run check   # node --check
npm test        # 主机纯函数单测 + 客户端加载 smoke

结构:

• lib/index.js — 主机半:签名 + 公共参数 + Cookie 态、/heybox/rpc、/heybox/state、/heybox/img、/heybox/health
• lib/client.js — 浏览器半:右侧分栏 UI(shell.overlay 席位,无构建步骤)
• cordis.patch.yml — bundle 挂载行
• tests/ — 单测与 smoke
• docs/reference-readme.md — heybox(VSCode 原版)README 摘录

致谢与免责

非官方项目,接口与交互移植自 WenfuRainbow/heybox(MIT), 仅供学习交流;数据版权归小黑盒所有。

License

MIT