前言¶
在 DeepSeek Harness（DSH）里开多个聊天、等智能体跑任务时，Discord 侧往往仍显示「没在干什么」。若你希望好友或自己一眼看到「正在哪个会话、是否在干活、今天用了多少 Token」，通常要靠手动改状态或另开面板，信息和真实工作状态容易脱节。dsh-discord-rich 是社区维护的 DSH 客户端插件，通过 Discord Rich Presence 把当前聊天标题、工作状态、当日 Token 与本轮计时同步到 Discord 资料卡，全程本地 IPC，无需额外命令行操作。
这是什么¶
dsh-discord-rich（GitHub：MakotoNikki/dsh-discord-rich）由 MakotoNikki 维护，分类为客户端插件。定位是：在 DSH Desktop 运行时，把「当前打开的聊天」「智能体 Working / Idle」「今日 Token 合计」「当前轮次历时」推到 Discord Rich Presence。设置与卡片文案支持英文、俄文、中文（默认英文）。许可证为 MIT；package.json 标注版本 0.3.1，依赖 Node >= 22.19.0，DSH >= 0.2.1-rc.1 且 < 0.3.0。
核心功能¶
下面介绍插件在资料中明确列出的能力。
会话与状态跟随¶
插件 Web 端挂在会话头域，向宿主报告当前打开的聊天；切换标签页后，Discord 卡片会跟随当前活动标签，而不是最后一条消息所在的会话。智能体运行中显示 Working（中文为「工作中」），等待你输入时显示 Idle（「空闲」）。
Token 与计时¶
Total tok/d（及对应语言的「今日 Token」等文案）表示当天累计 Token，不是生涯总量。Token 优先来自 DSH 内置 token meter；不可用时从 session log 读取。大图上方的计时从本轮工作开始起算，用于观察当前 turn 已持续多久。鼠标悬停大图时，可在 tooltip 中显示当前聊天的 Token（需在 Developer Portal 配置 Art Asset，见下文）。
零配置试用与自定义应用¶
默认已填入共享 Application ID，安装并重启 DSH Desktop 后即可使用，无需自建 Discord 应用。共享应用名称显示为 DeepSeekHarness；若需自定义名称、头像或素材，可在 Discord Developer Portal 创建应用，将 Application ID 填入 Settings → Discord Rich Presence 并保存，必要时完全退出 Discord 再开以清缓存。
语言¶
设置页提供 RU / EN / CN 切换，同时影响设置界面与 Discord 卡片；未选择时默认 EN。配置会写入插件 config。
隐私与架构（本地）¶
插件从 DSH 内置 session projection cache（或 native session log）读 Token，经本地 IPC 与 Discord 通信；不读取、存储或发送 Discord 账户 token，不做网络请求；向 Discord 发送的仅为活动文案与可选大图 key。宿主侧负责拼 activity 并写入 Discord IPC；无中间服务器。
安装与启用¶
先做插件包就绪，再在 DSH Desktop 里安装并验证 Discord 连接。
- 取得插件目录（含
dsh-discord-rich包内容，来源可为社区目录页或 GitHub 仓库发布物）。 - 在 DSH Desktop 打开 Plugins，将
dsh-discord-rich文件夹以 bundle 形式安装；若更倾向包安装，在该文件夹内执行打包后安装生成的.tgz：
npm pack
- 重启 DSH Desktop。
-
保持 Discord 客户端运行。支持本地 Rich Presence IPC 的客户端均可（如 Stable、PTB、Canary、Vesktop、Equicord 等）。
-
打开 Settings → Discord Rich Presence。状态点应变绿，预览应显示当前聊天。共享 Application ID 下无需自建应用即可试用。
典型用法与可选配置¶
默认使用¶
安装并重启后，保持 Discord 与 DSH 同时运行即可；无需复制命令或打开额外看板。
自定义 Application ID¶
- 在 Discord Developer Portal 创建应用。
- 从 General Information 复制 Application ID（公开 ID，不是 bot token）。
- 粘贴到 Settings → Discord Rich Presence，点 Save。
- 若仍显示旧名称，完全退出 Discord 后重新启动。
悬停显示当前聊天 Token¶
- Developer Portal 中打开 Rich Presence → Art Assets。
- 上传仓库中的
assets/icon-1024.png，key 设为dsh。 - 在插件设置 Icon & tooltip 中将 asset key 设为
dsh。 - 自定义 tooltip 留空，由插件按所选语言填入当前聊天 Token。
使用共享应用时 dsh 资源可能已存在；悬停无效果时，改用自建应用并上传资源更可靠。
语言切换¶
在设置页使用 RU / EN / CN 开关，保存后即作用于设置页与 Discord 卡片。
适用场景与注意¶
适合谁： 常在 DSH 里长时间跑智能体、又习惯开着 Discord 的开发者；需要在资料卡上展示「真实在做的会话」和当日 Token，而不想手改状态。
运行与信任： 插件随当前 DSH 进程权限运行，会读会话与 Token 统计并通过本地 IPC 写 Discord Presence。安装前请浏览 GitHub 仓库 源码与 MIT 许可证，自行判断是否适用。
环境： 满足 package.json 中的 Node 与 DSH 版本范围；Discord 需在 Activity Privacy 中允许共享检测到的活动，否则可能一直 Connecting。
排错摘要：
| 现象 | 可尝试 |
|---|---|
| Discord 无显示 | 确认 Discord 已运行并重启 DSH；设置里状态点是否为绿 |
| 显示 DeepSeekHarness | 共享应用默认名；需自定义则建自有 Application |
| 卡在 Connecting | 设置中 Reconnect；检查 Activity Privacy |
| 悬停无 tooltip | 上传 key dsh 的资产并在插件中填同一 key |
| 聊天标题不对 | 切换一次标签或等待约 15 秒刷新 |
结尾¶
dsh-discord-rich 把 DSH 的当前聊天、工作状态与 Token 指标接到 Discord Rich Presence，默认即可试用，并可按需换应用 ID、语言与大图 tooltip。插件列表与说明见 SkillHub 目录页；源码与完整排错表见 GitHub。
