在 DeepSeek Harness (DSH) 的开发场景中，Agent 工作流与社区沟通往往处于割裂状态。DSH-Guild 插件旨在解决这个问题，它将 Discord 式的社区功能直接集成到 DSH 面板内，支持实时聊天、@ 提醒、文件传输、权限管理以及 DSH 会话分享，让社区内容与你的 Agent 工作区融为一体。
功能概览¶
DSH-Guild 提供了一套完整的社区运营与协作能力：
- 账号与身份：支持邮箱注册（6 位验证码）、密码登录、忘记密码重置（面板内直接完成）、修改用户名与头像。
- 社区管理：支持创建/加入公开或私有社区，通过邀请码加入；提供公开社区发现与搜索功能；支持官方社区种子；提供成员管理（踢人、封禁、转让所有权）及社区删除功能。
- 频道体系：支持三种频道类型（文字、公告、话题）。公告频道默认全员只读；话题频道支持 24 小时无人回复自动归档。
- 权限与角色：采用 Discord 式的角色模型，支持自定义角色、细粒度权限位（查看频道、发送消息、管理等）以及频道权限覆盖。
- 讨论组：支持在频道下创建私密或公开讨论组，支持设置进入密码。
- 消息交互：支持消息编辑/删除/置顶、表情回应、搜索（支持时间范围筛选）。支持粘贴/拖拽上传附件。
- 实时与状态：基于 WebSocket 的实时连接，支持断线重连、输入状态显示、在线人数统计与聚合、已读状态上报与提及提醒。
- 协作与分享：支持邀请成员（站内信+邮件）、分享 DSH 会话（打包分享）、会话克隆。
安装与启用¶
在使用前，请确保环境满足以下要求：Node.js ≥ 20、已安装 pnpm 以及 npx @deepseek-ai/dsh。
- 安装插件：
npx @deepseek-ai/dsh plugin --profile web add dsh-guild@0.0.3
- 启动 DSH Web：
npx @deepseek-ai/dsh web
- 配置代理（可选）：
Server 默认部署在 Cloudflare（地址：https://dsh-guild-api.huiwang.fun）。国内用户建议在代理工具中将该域名走代理，以确保连接稳定。
启动后，在 DSH 侧栏底部会出现 DSH-Guild（社区） 入口。首次使用时，需在面板内通过邮箱注册并完成验证码验证，随后即可创建或加入社区。
典型用法¶
- 插件作者管理社区：用于发布插件更新公告、收集用户反馈、分流技术讨论。
- 团队/小组内部协作：将沟通与 DSH 会话上下文放在一起，便于协作。
- 会话分享广场：创建公开社区，运营会话分享广场，允许用户克隆 DSH 会话。
配置与限制¶
DSH-Guild 的核心服务运行在 Cloudflare，客户端（浏览器）与主机（Node.js）通过 REST API 和 WebSocket 通信。
在 DSH 设置页的插件配置中，可调整以下参数：
* serverUrl：默认为 https://dsh-guild-api.huiwang.fun，自托管时可修改。
* autoReconnect：WebSocket 断线自动重连（默认开启）。
* share.maxSizeMb：会话分享包体积上限（默认 50MB）。
使用限制：
* 每个用户自建社区与加入社区的上限均为 20 个。
* 自建社区受每 24 小时 5 个的滚动频率限制。
生态背景¶
DSH 理念是「一切皆插件」，社区目录是独立站点。本插件由第三方开发者 seolhw 维护，遵循 MIT 许可证。
