前言¶
DeepSeek Harness (DSH) 采用「一切皆插件」的架构设计。当需要在 Discord 公会中管理 AI 会话时，直接使用 Discord 原生功能往往难以复用 DSH 的会话管理与模型调度能力。@addozhang/dsh-discord 是一个 Discord-first 适配器，它将 DSH 会话挂载到你的 Discord 公会中。插件由 addozhang 维护，允许用户通过 Discord 的 Mention 触发会话，并在 Discord 界面中流式查看结果、进行审批与控制，无需额外进程。
核心功能¶
该插件将 DSH 的核心能力映射到 Discord 命令与交互组件上：
- Mention 驱动的会话：在绑定的频道中发送
@bot <task>，会自动锚定一个线程并创建 DSH 会话。支持图片上传，模型将自动处理图片内容。 - 流式渲染：提供打字指示器，回答内容原地编辑，工具活动行实时展示，长文本分段展示。
- 审批与提问：DSH 的审批与提问以按钮、下拉菜单或文本模态框形式呈现。点击权属于发起者或线程拥有者，支持过期自动失效。
- 会话控制：提供
/steer、/stop、/queue list|remove等命令控制会话流转。 - 模型与权限管理：通过
/model select交互式选择模型，或使用/permission show/set切换权限预设。 - 双语支持：界面内置中英文切换，适配 DSH 的语言偏好。
- 安全加固：采用“拒绝优先”的授权策略，双重抑制提及，提交机制为“最多一次”且保留未知状态的恢复逻辑。
安装与启用¶
插件作为 DSH 插件挂载到 dsh web 配置文件。请确保安装前已安装 dsh CLI 并运行 web profile。
- 安装插件：
使用 CLI 安装插件包到当前 profile：
dsh plugin --profile web add @addozhang/dsh-discord
重启 `dsh web` 并刷新浏览器。`dsh plugin` 会自动处理配置的合并。
-
版本兼容性：
插件有稳定版与 Next 版，需与 DSH CLI 版本严格匹配，不可混用：插件行 插件版本 DSH CLI 版本 stable 0.5.0 0.1.7-rc.1 next >=0.6.0-rc.1 0.2.0-rc.2 若 CLI 与插件版本不匹配，插件将在启动时被禁用并报错。
-
配置：
在 DSH 的设置卡片中配置 Discord Token、允许的 Guild ID（公会给定）、成员权限白名单及语言偏好。所有 Token 存储在 Host 凭证服务中，不进入日志或设置文件。
典型用法¶
通过 Discord 命令与交互操作 DSH 会话：
- 启动任务：
@bot <task> - 会话控制：
/steer,/stop,/queue list|remove - 项目与会话绑定：
/project bind|list|info,/session resume - 清理操作：
/guild forget - 模型选择：
/model show,/model select - 权限切换：
/permission show,/permission set - 权限集配置：
/permission show / set（需 Host 权限）
适用场景与注意¶
- 运行环境：插件依赖 Node.js
^22.19.0 || >=24.0.0。 - Discord 配置：必须创建 Discord Bot 应用，并在开发者门户中启用 MESSAGE CONTENT 特权网关意图。
- 架构说明：会话状态保留在 DSH 中，持久化绑定存储在 Profile 的存储域中。
- 权限控制：插件内置显式的 Guild 允许名单，名单外的请求会被直接忽略。
- 生态背景：本插件为社区维护项目，与 DeepSeek 或官方应用商店无官方从属关系。
结尾¶
@addozhang/dsh-discord 通过将 DSH 的会话管理与 Discord 的即时通讯结合，为 Discord 用户提供了标准化的 AI 交互入口。如需查看完整文档或源码，可访问社区目录或GitHub 仓库。
