heybox

Readme

<p align="center">
  <img src="https://img.shields.io/badge/version-0.3.8-blue" alt="version" />
  <img src="https://img.shields.io/badge/license-MIT-green" alt="license" />
  <img src="https://img.shields.io/badge/platform-DSH%20Web-blueviolet" alt="platform" />
  <img src="https://img.shields.io/badge/type-web%20client%20plugin-ff69b4" alt="type" />
</p>

<h1 align="center">🎮 HeyBox · 小黑盒论坛分区</h1>

<p align="center">
  <b>在 DeepSeek Harness Web 会话右侧开一个小黑盒(xiaoheihe.cn)论坛分区。</b><br/>
  形态与交互移植自 <a href="https://github.com/WenfuRainbow/heybox">WenfuRainbow/heybox</a>(VSCode 小黑盒插件)
</p>

---

## 简介

这个插件把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 安装**

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

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

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

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

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

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

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

## 使用

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

## 开发

```bash
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](https://github.com/WenfuRainbow/heybox)(MIT),
仅供学习交流;数据版权归小黑盒所有。

## License

MIT