DSH-Guild
把「社区」装进 DSH —— 在 DeepSeek Harness 里直接和同好聊天、提问求助、发通知，社区内容与你的 Agent 工作区不再割裂。
一个面向 DSH 用户的类 Discord 社区插件：注册一个社区账号后，就可以在 DSH 面板里自建或加入社区，实时聊天、贴图传文件、@ 提醒、管理成员，全程不需要跳出 DSH。
同样的模型也适用于团队内部沟通、兴趣小组或课程答疑 —— 只要有 DSH，就能当社区客户端用。
使用场景
每个场景一份完整文档：社区与频道怎么建、角色权限怎么勾、日常运营动作怎么做。
应用截图
应用截图-公告
应用截图-全员
应用截图-菜单
应用截图-角色
应用截图-权限
功能清单
账号与身份
社区
频道
角色与权限
讨论组（话题）
消息
实时与未读
邀请与站内信
分享
安装插件
把插件装进你自己的 DSH profile 即可。
前置条件：
- Node ≥ 20
- 已安装 pnpm
npx @deepseek-ai/dsh。
安装到 profile
# 从 npm 装进 web profile（推荐）
npx @deepseek-ai/dsh plugin --profile web add dsh-guild
# 启动 DSH Web
npx @deepseek-ai/dsh web
也可以直接从 GitHub 装最新源码：
npx @deepseek-ai/dsh plugin --profile web add github:seolhw/dsh-guild
代理设置（可选）
Server 地址为 https://dsh-guild-api.huiwang.fun ，部署在 Cloudflare 上，国内直连可能不稳定；在代理工具里让这个域名走代理即可。
浏览器打开 https://dsh-guild-api.huiwang.fun/healthz 能返回 JSON，即说明链路已通。
首次使用
- 启动后侧栏底部出现 DSH-Guild（社区） 入口，即安装成功。
- 在面板内用邮箱注册账号，查收 6 位验证码完成验证，然后创建或加入社区。
升级与卸载
npx @deepseek-ai/dsh plugin --profile web update dsh-guild # 升级到 npm 最新版
npx @deepseek-ai/dsh plugin --profile web remove dsh-guild # 卸载（同时从 dsh.profile.bundles 移除）
想在本仓库里边改边跑（热重载、watch 打包），或者想自己托管 Server，见下面的「更多文档」。
架构一览
flowchart LR
subgraph A["用户 A 的 DSH（本地）"]
UI["DSH-Guild 聊天面板（client）"]
HOST["DSH-Guild host<br/>本地配置 / 克隆会话"]
UI <--> HOST
end
subgraph C["Cloudflare（Server）"]
API["Worker<br/>REST + WebSocket"]
DO["Durable Object<br/>每频道实时广播"]
D1[("D1<br/>用户 / 社区 / 频道 / 消息 / 邀请")]
R2[("R2<br/>附件 / 分享包")]
API --> DO
API <--> D1
API <--> R2
end
UI -- "WSS + REST（Bearer）" --> API
- client（浏览器）：聊天界面、WebSocket 实时连接、附件直传、站内信。
- host（Node.js）：保存 serverUrl / token 等本地设置；读本机 DSH 会话并打包成分享包，也能把分享包还原成本地会话。
- server（Cloudflare）：唯一的数据中心——REST + WebSocket API、每频道一个 Durable Object 做实时扇出、D1 存业务数据、R2 存附件与分享包；完全自包含，可按 自部署 Server 自己托管一个。
插件设置（DSH 设置页）
| 键 | 默认 | 说明 |
|---|
serverUrl | https://dsh-guild-api.huiwang.fun | Server 地址；自托管就改成自己的域名 |
handle | "" | 当前账号用户名（登录后自动写入） |
token | ""（secret） | 会话令牌，登录后自动写入 |
autoReconnect | true | WebSocket 断线自动重连 |
share.maxSizeMb | 50 | 会话分享包体积上限 |
首次启动会把默认的 serverUrl 写进 DSH 的 settings 文档（$DSH_HOME/settings.yaml 的 guild 段），之后它就以这份配置为准：
guild:
serverUrl: https://dsh-guild-api.huiwang.fun
想连别的后端（自托管 / 本地 Server），在 DSH 设置页的插件设置里改，或直接改上面这个文件 —— 不用改代码，改过的值不会被启动流程覆盖。本地开发另有 BETTER_AUTH_URL 环境变量作为临时覆盖（见 参与开发），它只影响当次进程、不写进 settings 文档。
Server 环境变量
Server 端的 BETTER_AUTH_SECRET / BETTER_AUTH_URL / RESEND_API_KEY / ADMIN_TOKEN 与业务限额，见 自部署 Server。
更多文档
| 文档 | 内容 |
|---|
| 场景一：插件作者管理社区 | 建社区 / 配频道 / 建「维护者」角色、发版公告与置顶、内测群、封禁与所有权转让 |
| 场景二：团队内部协作 | 私密社区 + 邀请、角色分层、讨论组与搜索、分享会话给同事复现 |
| 场景三：会话分享广场 | 公开广场的规则与频道设计、策展人角色、精选置顶、分享 / 克隆的注意事项 |
| 参与开发 | 仓库结构、本地跑通全栈（pnpm build / pnpm dev / pnpm dev:server）、overlay 加载机制、常用命令与提交约定 |
| 自部署 Server | 把 Server（Hono Worker + D1 + R2 + Durable Object）部署到自己的 Cloudflare 账号；环境变量、发信配置与官方社区种子 |
License
MIT
