前言¶
在 DSH 里让智能体查 Discord 历史、搜关键词、归档频道，常见做法是自建 bot、手抄 User Token，或写一堆零散脚本。bot 要申请权限且很多只读场景并不需要发消息；手抄 token 容易过期、也不适合多账号切换。dsh-discord 是社区维护的 DSH Desktop 插件，把 29 个只读工具打包进 Harness，凭证优先从浏览器登录态读取，不必单独跑浏览器自动化。
下面介绍它是什么、能做什么、如何安装，以及使用时需要知道的边界。
这是什么¶
- 名称与维护：
dsh-discord，维护者 wuyaomin248-stack。 - 分类：社区目录归类为「联网工具」；当前 GitHub 星标为 0（以仓库页面为准）。
- 版本与许可：README 标注版本 0.5.5，许可证 MIT。
- 定位：DSH Desktop 的 Discord 只读工具集——不发消息、不改在线状态、不需要 bot；token 可直接从 Edge / Chrome / Brave 的登录态解析，也支持
DISCORD_TOKEN环境变量。
插件以当前 DSH 进程权限运行，安装前建议自行查看 源码 与 LICENSE。DeepSeek Harness 社区插件目录在 skillhub.cn，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
账号与凭证¶
| 能力 | 工具 | 说明 |
|---|---|---|
| 枚举并验证本机可用账号 | discord_accounts |
逐个验证，返回 valid: true 表示可用 |
| 多账号切换 | discord_use |
进程内生效 |
| 诊断 token 权限 | discord_capabilities |
403 与其他错误分开报告 |
凭证顺序：优先 DISCORD_TOKEN（多个可用逗号或空格分隔）；未设置时从浏览器 User Data 下 Local Storage/leveldb 复制到临时目录再解析（浏览器运行时目录被锁）。匹配 24位ID.6位.27位 与 mfa.xxx 形态，且只在内容含 discord 的文件里搜索。缓存 token 全部 401 时会自动重扫。输出里 token 会打码；默认不落盘、不开 logTokens。
服务器、频道与消息¶
| 工具 | 用途 |
|---|---|
discord_servers |
账号所在服务器列表 |
discord_guild_info |
规模、boost、特性、验证等级 |
discord_invite |
解析邀请链接（不加群） |
discord_channels / discord_channel_info |
频道结构与单频道详情 |
discord_messages |
读频道消息（翻页 + since/until） |
discord_context |
某条消息前后文（?around=） |
discord_reactions |
表情回应汇总与点击者 |
discord_pins |
置顶消息 |
discord_events |
服务器计划活动 |
discord_me_in_guild |
自己在服务器内的昵称、角色、入服时间与禁言状态 |
搜索、过滤与归档¶
| 工具 | 用途 |
|---|---|
discord_search |
服务端搜索：关键词、作者、频道、时间、附件类型、置顶、NSFW |
discord_filter |
本地正则/关键词翻历史 |
discord_search_guild |
跨频道在同一服务器内找同一词 |
discord_export |
搜索结果导出为按频道分组的 Markdown |
discord_archive |
整频道归档（翻页拉全量，不靠搜索命中） |
服务端搜索每页 25 条；discord_archive 每页 100 条串行，默认 maxMessages 1000。
收件箱、成员、角色与论坛¶
| 工具 | 用途 |
|---|---|
discord_mentions |
提及当前用户的消息（收件箱） |
discord_user |
用户资料、徽章、可见简介与互关服务器等 |
discord_dms |
私信频道 |
discord_members |
找成员（403 时降级为从消息作者收集） |
discord_roles |
角色与权限位 |
discord_threads |
论坛帖子（单频道或全服扫） |
附件、角色卡与插件判型¶
| 工具 | 用途 |
|---|---|
discord_download |
下载附件，带角色卡/插件判型 |
discord_card |
从卡频道随机抽一张验证过的真卡 |
discord_plugins / discord_plugin |
列插件频道或论坛帖；随机抽验证过的真插件 |
判型逻辑：discord_download / discord_card / discord_plugin 会检查 PNG 的 tEXt、JSON 里的 chara / ccv3，或 zip 内 manifest.json + index.js 等，返回 { ok, kind, name, spec, ... }，失败时 why 说明原因。细节见仓库 docs/NOTES.md。
输出整理¶
原始 Discord JSON 经 compactMessage 处理：用户/频道/表情/时间戳标记可读、embed 与交互组件保留、搜索命中项带 hit: true 并附带上下文、帖子频道名会补齐缓存。
安装与启用¶
官方 README 给出的安装方式如下（不要用未在文档出现的 dsh plugin add 类命令替代）。
1、克隆到 Desktop profile 的 node_modules：
git clone https://github.com/wuyaomin248-stack/dsh-discord.git \
~/.dsh/profiles/desktop/node_modules/dsh-discord
2、编辑 profiles/desktop/package.json，两处都要加（缺一不加载）：
"dependencies": { "dsh-discord": "^0.5.5" }
"dsh.profile.bundles": [ "dsh-discord" ]
3、重启 DSH。
4、验证：调用一次 discord_accounts，能列出 valid: true 即表示通路正常。装包路径、依赖 junction、token 来源等见仓库 INSTALL.md。
插件要求 Node >=20，DSH 引擎 >=0.1.7-rc.1（见 package.json 中 dsh.engines）。
典型用法¶
下列示例来自 README「常用姿势」，可在 Harness 中按工具名与参数调用。
在指定服务器里搜关键词或过滤最近消息：
discord_search(guildId, query="X")
discord_search(guildId, query="X", since="2026-10-19")
discord_search(guildId, authorId="<id>")
discord_search(guildId, query="", has="link")
discord_search(guildId, query="", pinned=true)
discord_search(guildId, query="关键词", includeNsfw=true)
收件箱、频道内正则、上下文与归档：
discord_mentions(limit=10)
discord_filter(channel="<频道ID>", pattern="https?://github\\S+", regex=true)
discord_context(channelId, messageId, limit=6)
discord_archive(channel="<帖子ID>", maxMessages=500)
discord_card(keyword="古风")
discord_export 生成带作者、时间、embed 与附件链接的 Markdown；discord_download 下载附件，重名自动加序号，返回中含 CDN 的 expiresAt（约 24 小时）。
适用场景与注意¶
适合谁：需要在 DSH 对话或工作流里只读查阅 Discord——搜历史、拉上下文、导出/归档、下附件并区分角色卡与插件、看多账号收件箱——且希望 token 从已有浏览器登录态或环境变量取得，而不是维护 bot。
已知限制（摘自 README）：
- 完全只读；发消息不在插件范围内。
discord_members无法依赖普通 token 拉完整成员列表（GUILD_MEMBERS403），会降级为从最近消息作者收集。discord_threads的onlyActive常因guilds/{id}/threads/active仅 bot 可用而得到 0 条。- 无权限频道在
discord_search_guild中会记入forbiddenChannels并继续扫描。 - token 可能因 IP 变动或改密码失效；浏览器重新登录后插件可再次抓取。
安全：token 等同账号完全控制权。插件仅在内存中使用，默认不打日志；使用前请确认你信任插件源码与运行环境。
结尾¶
dsh-discord 把 Discord 只读检索、归档、上下文与附件判型收敛为 29 个 Harness 工具，并处理 token 获取与消息可读化。需要安装细节或实现笔记时，可看仓库 README、INSTALL.md 与 CHANGELOG.md。
