dsh-haloring-status

DSH HaloRing 状态桥 — 把 DSH 的实时运行状态与回合进度写成一个轻量状态文件，供托盘指示灯、状态栏、桌面小组件等外部程序读取。

只观察宿主公开的会话事件与 Agent 状态，不读取聊天正文，也不修改会话。

Host-only：没有页面、没有工具、没有客户端注入，不改变 DSH 原有界面
零配置：装上即用，无需 token、无需端口、无需认证
跨进程友好：输出是纯文本 key=value，任何语言都能解析

它解决什么问题

DSH 暴露了 WebSocket 事件流（/api/remote.mux），但外部程序要接进去必须：

拿到一次性的 launchToken（只存在于进程内存和启动 URL 里，用户得手动粘贴）
用 token 换签名 Cookie
处理 DSH 重启后 token 失效、需要重新获取的问题

本插件把这件事提前做完，把结果落成一个文件。外部程序只需读一个本地文本文件：

%USERPROFILE%\.dsh\dsh-status.txt

无需认证、无需重连、DSH 重启自动恢复。

输出格式

version=1
state=running
priority=2
updated=1793210745187
pid=12716
detail=Agent 运行中（turn 35）
progress=44
attention=0
approvals=0
turns=1
sessions=1
completed=0
degraded=0
error=0

字段	含义
`state`	`idle` / `running` / `attention` / `degraded` / `error` / `completed` / `offline`
`priority`	数值优先级，越大越优先（`-1` 离线 ~ `5` 故障）
`updated`	Unix 毫秒时间戳。读取方据此判断心跳
`pid`	宿主进程 ID，用于识别 DSH 是否重启
`detail`	人类可读描述，可直接显示在 tooltip
`progress`	`0..100` 整数，非精确百分比，仅作"正在推进"的提示
`attention` / `approvals`	待处理审批数量
`turns` / `sessions`	活动回合数 / 存活会话数
`completed` / `degraded` / `error`	对应状态的布尔标志（`0`/`1`）

写入频率：250ms ~ 1s（状态变化时立即写，静止时 1 秒心跳）。 DSH 退出后文件停止更新，读取方按心跳超时（建议 8 秒）判为离线。

状态判定

多个状态可能同时成立，插件按固定优先级取一个输出，而不是"最后事件优先"：

故障（error/blocked） > 降级（Provider 重试/上下文压缩）>
等待授权/审批 > 运行中 > 回合完成 > 空闲

事件映射

事件	输出状态
`turn/start`	`running`
`approval/asked`（未决定）	`attention`
`approval/decided`	清除等待，回到之前状态
`llm/retry` / `llm/retry-started`	`degraded`
`assistant/attempt`（finish.reason = error）	`degraded`
`compaction/start`	`degraded`
`compaction/end`	保持降级 1.5 秒后恢复
`turn/end`（reason = completed）	`completed`（保持 1.8 秒）
`turn/end`（reason = error/blocked）	`error`
`turn/end`（reason = max-tokens）	`degraded`（10 秒）
`turn/end`（reason = aborted/interrupted）	不算等待也不算错误
无活动会话且宿主在线	`idle`

进度算法

DSH 的 step 事件语义很清晰：一次 step = 一次完整的「模型推理 → 产出工具调用 → 工具执行完毕」循环。 step 序号天然就是"已经完成了几个思考-行动循环"的精确计数。

但总步数未知——第 3 步时不知道还要几步。所以这里刻意不用线性分母：

progress = 25 + 70 × (1 - e^(-已完成step数 / 3.2))  [+8 若正在执行工具]
上限 95，只有 turn/end 才到 100

用渐近曲线，长任务会持续缓慢爬升，而不是卡在某个数字不动。

已完成 step	进度	工具执行中
0	25%	33%
1	44%	52%
2	58%	66%
3	68%	76%
4	75%	83%
5	80%	88%
10	92%	95%

各状态下的进度取值：

状态	progress
`running`	25 → 95（按 step 推进）
`attention`	25（冻结，表示卡住但没失败）
`degraded`	50（冻结，表示有进展但不顺）
`completed`	100
`error`	100
`idle`	0

起始值取 25 而非 0，让读取方一眼就能看出"在工作"，而不是分不清"刚启动"和"没动静"。

安装

dsh plugin --profile <你的profile> add github:<你的用户名>/<仓库名>

或本地安装：

dsh plugin --profile desktop add "file:<路径>/dsh-haloring-status"

安装后重启 DSH 一次以加载宿主插件。

验证：

Get-Content "$env:USERPROFILE\.dsh\dsh-status.txt"

应该看到内容且每秒更新。

开发时的坑

DSH 会把插件复制到 ~/.dsh/profiles/<profile>/node_modules/ 并从那里加载。 修改插件源码后，两处都要同步，否则改动不生效：

源：    ~/.dsh/plugins/dsh-haloring-status/
加载：  ~/.dsh/profiles/<profile>/node_modules/dsh-haloring-status/

改完还需要重启 DSH。

卸载

dsh plugin --profile <profile> remove dsh-haloring-status

读取示例

PowerShell

$f = "$env:USERPROFILE\.dsh\dsh-status.txt"
$c = Get-Content $f -Raw
if($c -match 'state=(\w+)'){ $state = $Matches[1] }
if($c -match 'progress=(\d+)'){ $progress = [int]$Matches[1] }
if($c -match 'updated=(\d+)'){
    $age = (Get-Date) - [DateTimeOffset]::FromUnixTimeMilliseconds([long]$Matches[1]).LocalDateTime
    if($age.TotalSeconds -gt 8){ $state = 'offline' }
}

Node.js

import fs from 'node:fs';
import os from 'node:os';
import path from 'node:path';

const file = path.join(os.homedir(), '.dsh', 'dsh-status.txt');
const text = fs.readFileSync(file, 'utf8');
const fields = Object.fromEntries(
  text.split('\n').map(l => l.trim()).filter(Boolean)
      .map(l => { const i = l.indexOf('='); return [l.slice(0, i), l.slice(i + 1)]; })
);
console.log(fields.state, fields.progress);

Python

from pathlib import Path
import os

file = Path(os.environ['USERPROFILE']) / '.dsh' / 'dsh-status.txt'
fields = dict(
    line.split('=', 1)
    for line in file.read_text(encoding='utf-8').splitlines()
    if '=' in line
)
print(fields['state'], fields['progress'])

配置

插件没有用户可配置项。常量都在 index.js 顶部：

const PROGRESS = {
  base: 25,      // turn 开始时的起始进度
  cap: 95,       // 未结束前的上限
  toolBonus: 8,  // 工具执行中的额外加成
  decay: 3.2,    // 渐近速度（越小越快逼近上限）
};

输出路径可通过环境变量 DSH_HOME 覆盖，默认 ~/.dsh。

实现说明

Host-only bundle：inject = ['sessions', 'agents']，只读不写
每 300ms 轮询 ctx.sessions.list()，增量读取 session.eventAt(i)（按 seq 推进，不重复处理）
用 ctx.agents.get(sessionId)?.status === 'running' 兜底识别运行中的 Agent
会话消失时清理对应的 lastSeq / activeTurns / pendingApprovals
所有定时器都 unref()，不会阻止宿主退出
写入失败（如主目录只读）静默忽略，不会拖垮 Harness

已知限制

进度不精确：总步数未知，只能给渐进提示，不承诺准确百分比
单文件单状态：多个会话同时运行时，取"最高优先级 + 第一个活动会话"的合成结果，不区分会话
不响应审批：本插件只观察，审批仍需你在 DSH 界面里处理
Windows 优先：路径处理用 os.homedir()，理论上跨平台，但仅在 Windows 11 上验证过

许可证

GPL-3.0

dsh-haloring-status

DSH HaloRing 状态桥 — 把 DSH 的实时运行状态与回合进度写成一个轻量状态文件，供托盘指示灯、状态栏、桌面小组件等外部程序读取。

只观察宿主公开的会话事件与 Agent 状态，不读取聊天正文，也不修改会话。

Host-only：没有页面、没有工具、没有客户端注入，不改变 DSH 原有界面
零配置：装上即用，无需 token、无需端口、无需认证
跨进程友好：输出是纯文本 key=value，任何语言都能解析

它解决什么问题

DSH 暴露了 WebSocket 事件流（/api/remote.mux），但外部程序要接进去必须：

拿到一次性的 launchToken（只存在于进程内存和启动 URL 里，用户得手动粘贴）
用 token 换签名 Cookie
处理 DSH 重启后 token 失效、需要重新获取的问题

本插件把这件事提前做完，把结果落成一个文件。外部程序只需读一个本地文本文件：

%USERPROFILE%\.dsh\dsh-status.txt

无需认证、无需重连、DSH 重启自动恢复。

输出格式

version=1
state=running
priority=2
updated=1793210745187
pid=12716
detail=Agent 运行中（turn 35）
progress=44
attention=0
approvals=0
turns=1
sessions=1
completed=0
degraded=0
error=0

字段	含义
`state`	`idle` / `running` / `attention` / `degraded` / `error` / `completed` / `offline`
`priority`	数值优先级，越大越优先（`-1` 离线 ~ `5` 故障）
`updated`	Unix 毫秒时间戳。读取方据此判断心跳
`pid`	宿主进程 ID，用于识别 DSH 是否重启
`detail`	人类可读描述，可直接显示在 tooltip
`progress`	`0..100` 整数，非精确百分比，仅作"正在推进"的提示
`attention` / `approvals`	待处理审批数量
`turns` / `sessions`	活动回合数 / 存活会话数
`completed` / `degraded` / `error`	对应状态的布尔标志（`0`/`1`）

写入频率：250ms ~ 1s（状态变化时立即写，静止时 1 秒心跳）。 DSH 退出后文件停止更新，读取方按心跳超时（建议 8 秒）判为离线。

状态判定

多个状态可能同时成立，插件按固定优先级取一个输出，而不是"最后事件优先"：

故障（error/blocked） > 降级（Provider 重试/上下文压缩）>
等待授权/审批 > 运行中 > 回合完成 > 空闲

事件映射

事件	输出状态
`turn/start`	`running`
`approval/asked`（未决定）	`attention`
`approval/decided`	清除等待，回到之前状态
`llm/retry` / `llm/retry-started`	`degraded`
`assistant/attempt`（finish.reason = error）	`degraded`
`compaction/start`	`degraded`
`compaction/end`	保持降级 1.5 秒后恢复
`turn/end`（reason = completed）	`completed`（保持 1.8 秒）
`turn/end`（reason = error/blocked）	`error`
`turn/end`（reason = max-tokens）	`degraded`（10 秒）
`turn/end`（reason = aborted/interrupted）	不算等待也不算错误
无活动会话且宿主在线	`idle`

进度算法

但总步数未知——第 3 步时不知道还要几步。所以这里刻意不用线性分母：

progress = 25 + 70 × (1 - e^(-已完成step数 / 3.2))  [+8 若正在执行工具]
上限 95，只有 turn/end 才到 100

用渐近曲线，长任务会持续缓慢爬升，而不是卡在某个数字不动。

已完成 step	进度	工具执行中
0	25%	33%
1	44%	52%
2	58%	66%
3	68%	76%
4	75%	83%
5	80%	88%
10	92%	95%

各状态下的进度取值：

状态	progress
`running`	25 → 95（按 step 推进）
`attention`	25（冻结，表示卡住但没失败）
`degraded`	50（冻结，表示有进展但不顺）
`completed`	100
`error`	100
`idle`	0

起始值取 25 而非 0，让读取方一眼就能看出"在工作"，而不是分不清"刚启动"和"没动静"。

安装

dsh plugin --profile <你的profile> add github:<你的用户名>/<仓库名>

或本地安装：

dsh plugin --profile desktop add "file:<路径>/dsh-haloring-status"

安装后重启 DSH 一次以加载宿主插件。

验证：

Get-Content "$env:USERPROFILE\.dsh\dsh-status.txt"

应该看到内容且每秒更新。

开发时的坑

DSH 会把插件复制到 ~/.dsh/profiles/<profile>/node_modules/ 并从那里加载。 修改插件源码后，两处都要同步，否则改动不生效：

源：    ~/.dsh/plugins/dsh-haloring-status/
加载：  ~/.dsh/profiles/<profile>/node_modules/dsh-haloring-status/

改完还需要重启 DSH。

卸载

dsh plugin --profile <profile> remove dsh-haloring-status

读取示例

PowerShell

$f = "$env:USERPROFILE\.dsh\dsh-status.txt"
$c = Get-Content $f -Raw
if($c -match 'state=(\w+)'){ $state = $Matches[1] }
if($c -match 'progress=(\d+)'){ $progress = [int]$Matches[1] }
if($c -match 'updated=(\d+)'){
    $age = (Get-Date) - [DateTimeOffset]::FromUnixTimeMilliseconds([long]$Matches[1]).LocalDateTime
    if($age.TotalSeconds -gt 8){ $state = 'offline' }
}

Node.js

import fs from 'node:fs';
import os from 'node:os';
import path from 'node:path';

const file = path.join(os.homedir(), '.dsh', 'dsh-status.txt');
const text = fs.readFileSync(file, 'utf8');
const fields = Object.fromEntries(
  text.split('\n').map(l => l.trim()).filter(Boolean)
      .map(l => { const i = l.indexOf('='); return [l.slice(0, i), l.slice(i + 1)]; })
);
console.log(fields.state, fields.progress);

Python

from pathlib import Path
import os

file = Path(os.environ['USERPROFILE']) / '.dsh' / 'dsh-status.txt'
fields = dict(
    line.split('=', 1)
    for line in file.read_text(encoding='utf-8').splitlines()
    if '=' in line
)
print(fields['state'], fields['progress'])

配置

插件没有用户可配置项。常量都在 index.js 顶部：

const PROGRESS = {
  base: 25,      // turn 开始时的起始进度
  cap: 95,       // 未结束前的上限
  toolBonus: 8,  // 工具执行中的额外加成
  decay: 3.2,    // 渐近速度（越小越快逼近上限）
};

输出路径可通过环境变量 DSH_HOME 覆盖，默认 ~/.dsh。

实现说明

Host-only bundle：inject = ['sessions', 'agents']，只读不写
每 300ms 轮询 ctx.sessions.list()，增量读取 session.eventAt(i)（按 seq 推进，不重复处理）
用 ctx.agents.get(sessionId)?.status === 'running' 兜底识别运行中的 Agent
会话消失时清理对应的 lastSeq / activeTurns / pendingApprovals
所有定时器都 unref()，不会阻止宿主退出
写入失败（如主目录只读）静默忽略，不会拖垮 Harness

已知限制

进度不精确：总步数未知，只能给渐进提示，不承诺准确百分比
单文件单状态：多个会话同时运行时，取"最高优先级 + 第一个活动会话"的合成结果，不区分会话
不响应审批：本插件只观察，审批仍需你在 DSH 界面里处理
Windows 优先：路径处理用 os.homedir()，理论上跨平台，但仅在 Windows 11 上验证过

许可证

GPL-3.0

DeeepMind/dsh-haloring-status

dsh-haloring-status

它解决什么问题

输出格式

状态判定

事件映射

进度算法

安装

开发时的坑

卸载

读取示例

PowerShell

Node.js

Python

配置

实现说明

已知限制

相关项目

许可证

Community comments

DeeepMind/dsh-haloring-status

dsh-haloring-status

它解决什么问题

输出格式

状态判定

事件映射

进度算法

安装

开发时的坑

卸载

读取示例

PowerShell

Node.js

Python

配置

实现说明

已知限制

相关项目

许可证

Community comments