dsh-discord-richpresence - 将 DSH 交互状态镜像到本地 Discord

在 DeepSeek Harness (DSH) 的开发或调试过程中，开发者通常需要通过日志或界面查看 agent 的运行状态。如果能在本地有一个持续的后台状态指示，会更有助于监控进程。dsh-discord-richpresence 插件正是为此设计，它将 DSH 的交互状态实时镜像到本地 Discord 客户端的 Rich Presence 上，且只推送模糊的、可自定义的状态文案。

插件定位¶

这是一个宿主侧的后台插件。安装后，它会注入到 DSH 的启动流程中，随 DSH 一起常驻运行，无托盘图标、无界面、无窗口。它不读取工作区内容，仅响应 DSH 的粗粒度生命周期信号。

核心功能¶

插件监听运行中 DSH 的粗粒度活动信号，并将其映射到 Discord 状态：

信号监听：监听并推送以下信号：
- 用户消息进入 agent 收件箱
- agent 正在运行（思考 / 流式输出）
- 模型工具正在执行
- 创建了新会话 / 分支
- 无活动
丰富模式（可选）：在设置中开启后，插件会推送带实时数据的状态，例如：
- Token 数量
- 思考时长
- 当前思考步数
- 注：丰富模式的数据始终关联你当前正在交互的会话（即最后一条真实输入所在的会话）。
隐私保护：插件绝不读取工作区内容（如消息正文、文件路径、工具输入输出），只响应生命周期信号并推送配置好的状态字符串。
兼容性：兼容 Harness 0.1.1-rc.1 及以上版本。

安装¶

在 DSH 的检出目录或 profile 下执行以下命令：

dsh plugin --profile web add https://github.com/0QwQ0/dsh-discord-richpresence/releases/latest/download/dsh-discord-richpresence.tgz

安装并重启 DSH 后，状态会自动出现在 Discord 个人资料上（Discord Application ID 已预置，无需配置）。

配置与使用¶

1. 基础状态配置¶

所有配置位于 bundle patch (cordis.patch.yml) 的 config 下。你可以通过修改 statuses 列表来自定义状态文案。

config:
  clientId: '1540732930127691807'         # 已预置，通常无需修改
  details: 'DeepSeek Harness'             # 可选：第二行文字
  largeImage: ''                          # 可选：Discord 大图资产 key
  statuses:                               # 可编辑的状态列表，按阶段分组
    userInput:
      - 正在指挥大肥鱼干活
      - 正在给大肥鱼喂 token
    agentWorking:
      - 正在与大肥鱼一起 Brainstorming
      - 正在听大肥鱼讲解 Project
    tools:
      - 正在提交改动意见
    forking:
      - 正在创建大肥鱼记忆切片
    idle:
      - 大肥鱼待命
  randomize: false                        # true 时随机选取，否则轮流
  minIntervalMs: 5000                     # 两次推送之间的最小间隔
  reconnectMs: 15000                      # Discord 断线重连的轮询间隔

2. 启用丰富模式¶

丰富模式不属于 patch 配置，而是在 DSH 界面中开启：

在 DSH 界面中进入 设置 → 通用设置。
找到 Rich Presence 丰富状态 开关并开启。

开启后，插件会根据实时数据（如 token 数、思考时长）智能随机推送状态，每个状态在 Discord 上至少展示 8 秒。

注意事项¶

环境要求：必须本地运行 Discord 桌面客户端（Rich Presence 走本地 IPC 端点）。
卸载残留：卸载插件后，settings.yaml 中可能会残留 discord-richpresence: 配置段。虽然这不会影响运行，但若需彻底恢复，可手动删除该段配置。

结语¶

dsh-discord-richpresence 为 DSH 用户提供了一个轻量级的、基于本地 Discord 的状态监控方案。它不侵入工作区内容，仅通过粗粒度信号反馈 agent 的生命周期状态，适合需要在后台保持状态可见的开发或演示场景。

仓库地址: https://github.com/0QwQ0/dsh-discord-richpresence
许可证: MIT