plasta2steel/dsh-xiaoheihe

🎮 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
麻省理工学院