<p align="center"> <img src="./assets/readme/hero.svg" width="100%" alt="dsher-bbs-plugin — bbs.dsher.cn 社区面板：一条命令安装后右下角出现「dsher 社区」悬浮按钮，浏览 / 搜索 / 发帖 / 回帖 / 点赞 / 粘贴截图上传 / 一键登录" /> </p>
✨ 一键安装
> 前提：机器上已安装 DeepSeek Harness（带 dsh 命令），并已跑过 dsh web。 > > 包从 GitHub 仓库直接安装（github:kimirong/dsher-bbs-plugin），无需先发布 npm。
# ① 一条命令从 GitHub 装进 web profile（自动加入 profile bundles）
dsh plugin --profile web add github:kimirong/dsher-bbs-plugin
# ② 完全重启 dsh web 进程（不是刷新页面！）
dsh web重启后，页面右下角出现「dsher 社区」蓝色胶囊按钮，点击即可浏览 / 发帖 / 回帖 / 点赞 / 上传图片 / 一键登录。
安装遇到 ERR_PNPM_ADDING_TO_ROOT？
pnpm 8+ 对 workspace 根 add 有校验，dsh plugin 可能因此失败。一行配置解决：
echo 'ignore-workspace-root-check=true' >> ~/.dsh/profiles/web/.npmrc
dsh plugin --profile web add github:kimirong/dsher-bbs-plugin更新 / 卸载
dsh plugin --profile web update @kimirong/dsher-bbs-plugin # 更新到新版本
dsh plugin --profile web remove @kimirong/dsher-bbs-plugin # 卸载（自动从 bundles 剔除）截图
| 右下角悬浮入口 | 面板 · 浏览 | 面板 · 发帖 |
|---|---|---|
|  |  |  |
功能特性
- 右下角悬浮入口：品牌蓝胶囊按钮常驻页面右下角，不占用侧栏空间，随时点开
- 浏览 / 搜索：版块分类 → 帖子列表（分页）→ 详情（正文 / 回复），搜索框直接集成在浏览页顶部
- 发帖 / 回帖 / 点赞：面板内完成，支持 Markdown
- 粘贴截图 / 图片上传：正文与回复框直接粘贴截图（自动转码上传）或点「🖼 上传图片」
- 一键登录：弹窗走论坛同款 GitHub / Google OAuth，会话自动接入，无需复制 Cookie（手动粘贴仅作备用）
架构
| 部分 | 文件 | 说明 |
|---|---|---|
| Host 半 | src/host/index.ts | 注册 ctx.webServer 路由 /api/dsher-bbs/*，把论坛能力暴露为本机 JSON RPC |
| Host 逻辑 | src/host/forum.ts | 论坛访问（Node 全局 fetch）+ HTML 正则解析 |
| Client 半 | src/client/index.ts | dsh.client 插件入口，ctx.inject(['slots'], ...) 注册 shell.overlay 槽位 |
| Client UI | src/client/Panel.tsx | 悬浮按钮 + 面板（React），同源 fetch('/api/dsher-bbs/<method>') 调 Host |
| Client RPC | src/client/rpc.ts | fetch 封装 |
为什么不走 Typert @Remote：@deepseek-ai/dsh-api-remotes 的客户端装配是静态白名单（只 import 官方包的 /remote），第三方独立包的 remote 不会被自动挂载。因此本包用自建 HTTP 路由：Host 半注册 webserver 前缀路由，Client 半同源 fetch——这是独立 bundle 插件的通用可交付模式。
实现差异（与动态插件版 dsh-bbs-plugin/ 对比）：
| 动态插件版 | 本包（bundle） | |
|---|---|---|
| Host 网络 | ctx.shell + curl（沙箱无 fetch） | 普通 Node 全局 fetch / FormData / Blob / Buffer |
| RPC | harness.handle / host.call（动态运行器专属） | ctx.webServer 路由 / 浏览器 fetch |
| 安装 | Agent cordis_define + cordis_run（会话级） | dsh plugin --profile web add <pkg>（机器级） |
| 生效 | 会话内存，重启即失 | profile 常驻，重启 dsh web 后装载 |
开发与构建
npm install
npm run build # tsdown → lib/index.mjs（Host ESM）+ lib/client.js（浏览器 CJS bundle）
npm run typecheck # 类型检查产物约定（与官方 client 包一致）：
lib/index.mjs— Host 半，Loader 按包名解析lib/client.js— 浏览器 bundle，window.__ModuleLoader__.load({ id, factory })闭包工厂格式，由@deepseek-ai/dsh-client-modules的/plugins/<id>/client.js路由提供给浏览器package.json的dsh.bundle.patch声明本包是一层 profile patch；dsh.client声明浏览器半
发布
npm publish --access public发布前检查：files 只含 lib/ 与 cordis.patch.yml；exports 暴露 .（Host）与 ./client（浏览器半）。
一键登录（需要论坛侧配合）
会话 Cookie 是 httpOnly，浏览器脚本读不到，「一键登录」依赖论坛的桥接页 /dsh-login（src/routes/dsh-login.tsx，本论坛已部署）：
1. 面板点「🔑 一键登录」→ 弹窗打开 https://bbs.dsher.cn/dsh-login?origin=<DSH UI 来源>； 2. 未登录时该页渲染站内同款登录按钮，点击走 Better Auth OAuth； 3. 已登录时由服务端读取会话 Cookie，经 window.opener.postMessage 交还插件弹窗并自动关闭； 4. 插件收到后自动验证并显示登录用户。
安全边界：/dsh-login 只接受 localhost / 127.0.0.1 来源，Cookie 绝不发往公网来源。
> 自建论坛需同步部署 src/routes/dsh-login.tsx 并重新部署；未部署时可用「手动粘贴 Cookie」备用方式。
限制与说明
- 论坛是 Hono + htmx 服务端渲染，无公开 JSON API；
forum.ts的解析正则与当前版块 HTML 结构一一对应，论坛改版后需同步更新。 - 写操作受论坛限流：5 帖/小时、30 回帖/小时、60 点赞/小时、20 上传/小时。
/api/dsher-bbs路由无鉴权（与 DSH 页面同源同权限）：任何能访问该 DSH 页面的人都能调用；会话 Cookie 只存在 Host 进程内存，不落盘、不外发。- 论坛正文用
marked渲染且未 sanitize，forum.ts对正文做了基础净化，但渲染第三方内容仍有风险。
许可证
MIT（见 [LICENSE](LICENSE)）。