deepseekplugins

DeepSeek Harness plugin

dsher-bbs-plugin

bbs.dsher.cn 社区面板 — DSH Web 的正式 bundle 插件（npm 安装形态）：右下角悬浮入口 + 浏览/搜索/发帖/回帖/点赞/图片上传 + 一键登录

UI Enhancements
Jump to install

Source facts

Repository
kimirong/dsher-bbs-plugin
Latest update
Aug 17, 2026
Category
UI Enhancements
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/kimirong/dsher-bbs-plugin
Plugin: dsher-bbs-plugin
Author: kimirong

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

<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 剔除）

截图

右下角悬浮入口面板 · 浏览面板 · 发帖
![右下角悬浮入口](screenshots/01-home-fab.png)![面板·浏览](screenshots/02-panel-browse.png)![面板·发帖](screenshots/03-panel-compose.png)

功能特性

  • 右下角悬浮入口：品牌蓝胶囊按钮常驻页面右下角，不占用侧栏空间，随时点开
  • 浏览 / 搜索：版块分类 → 帖子列表（分页）→ 详情（正文 / 回复），搜索框直接集成在浏览页顶部
  • 发帖 / 回帖 / 点赞：面板内完成，支持 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.tsdsh.client 插件入口，ctx.inject(['slots'], ...) 注册 shell.overlay 槽位
Client UIsrc/client/Panel.tsx悬浮按钮 + 面板（React），同源 fetch('/api/dsher-bbs/<method>') 调 Host
Client RPCsrc/client/rpc.tsfetch 封装

为什么不走 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
RPCharness.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)）。

Back to searchOpen GitHub repository

More related plugins

View category