Zum Hauptinhalt springen
A

dsh-observer

akiyuki1130/dsh-observer

Sidecar model narrates the main conversation's progress in a floating panel or an Observer tab, without touching the main session. Its HTTP routes have no DSH access check, so a web page open in your browser could call them.

Installation

dsh plugin --profile web add github:akiyuki1130/dsh-observer

README

dsh-observer · 旁路观察者

用另一个模型在悬浮窗里实时播报主对话的进度:刚做了什么、接下来要做什么、有没有卡住。 它只读会话事件流,不向主会话注入任何消息,不干涉主对话。

它解决什么问题

DSH 的模型在长任务里会连续调用几十次工具,界面上只有「Deep diving…」。 你只能等,不知道它干到哪了、是不是卡住了。

dsh-observer 在宿主侧订阅 session/event,按你设定的频率把最近的进展交给一个旁路模型, 生成一段中文播报,显示在页面左下角的悬浮窗里。你还可以直接在悬浮窗里追问它。

功能

  • 两种入口:
    • 「观察」栏:对话区顶部 tab(Chat / 观察 / 文件 / Context),整栏展示播报、追问与设置。
    • 悬浮窗:默认在对话区左下角(输入框上方),可拖动、可收起成小胶囊;位置记在 localStorage。
  • 悬浮窗开关:设置里可关掉悬浮窗(只留「观察」栏);移动端另有独立开关,默认关,窄屏默认不显示悬浮窗。
  • 移动端适配:窄屏自动变成贴底全宽卡片;打开「观察」栏时悬浮窗自动让位。
  • 模型可选:
    • 已有提供商:下拉选 provider / model / 思考强度(low / medium / high / xhigh / max,取决于模型)。
    • 自定义端点:填 baseURL + API Key + 模型 ID(OpenAI 兼容 /chat/completions)。
  • 频率可选:永不 / 30 / 60 / 120 / 180 / 300 / 600 秒,每档都标注预计 token 消耗;「永不」= 只保留手动播报。
  • 立即播报:窗口内一键「立即播报当前状况」,不用等下一个周期。
  • 追问输入框:问它「主对话现在怎么样了」「卡住了吗」,它基于事件流回答。
  • thinking 开关:默认开。开启后旁路模型能看到主模型最近的推理片段,判断「接下来」更准。
  • 深色 / 浅色主题:全部使用 DSH 主题 token,跟随宿主切换。
  • 远端可用:不依赖 loopback、不额外加鉴权,反向代理后面照常工作。

安装

# 1. 把插件目录放到任意位置,例如 /data/dsh/home/nya/dsh-observer
# 2. 装进 profile
dsh plugin --profile web add /data/dsh/home/nya/dsh-observer
# 3. 重启 DSH(新 bundle 有时可热加载,但重启最稳)

或者用 plugin_manager 工具:

plugin_manager action=install_bundle target=/data/dsh/home/nya/dsh-observer

安装后刷新页面,左下角会出现「● 旁路观察」胶囊。

配置

首次使用点开胶囊 → ⚙ 设置:

项说明
模型来源「已有提供商」或「自定义端点」
提供商 / 模型来自 ctx.llm.listProviders() / listModels()
思考强度来自 ctx.llm.resolveModel() 的 reasoning.efforts
播报频率永不 / 30–600 秒,附预计 token/时
读取主对话思考默认开;关掉后只读正文与工具调用
启用播报总开关;关掉后仍可手动 ↻
显示悬浮窗默认开;关掉后只保留「观察」栏
移动端显示悬浮窗默认关;窄屏默认不显示悬浮窗

设置面板里的改动必须点「保存」才生效,未保存时底部会显示「未保存」。

配置存在 $DSH_HOME/observer/config.json,自定义端点的 API Key 存在 $DSH_HOME/observer/secret.json(0600)。不会写 profile 的 cordis.patch.yml。

工作原理

主会话 ──session/event──▶ 宿主侧 observer 插件
                              │  按频率取最近 N 条事件(正文/推理/工具调用/工具结果)
                              ▼
                        ctx.llm.stream({ provider, model, ... })  ← 旁路模型
                              │
                              ▼
                        /api/observer/state  ← 浏览器轮询(2s)
                              │
                              ▼
                        悬浮窗渲染
  • 只在主会话 running 时自动播报;回合结束后不再打扰。
  • 跳过 origin === 'subagent' 的子代理会话。
  • 旁路调用带 45 秒超时;失败只记录错误,不影响主会话。
  • 追问走 /api/observer/ask,同样只读事件流。

HTTP 接口

路径方法说明
/api/observer/stateGET当前会话、最近播报、token 累计
/api/observer/configGET/POST读 / 写配置
/api/observer/modelsGET提供商与模型列表
/api/observer/modelGET某模型的思考强度选项
/api/observer/nowPOST强制播报一次
/api/observer/askPOST追问
/api/observer/healthGET健康检查

已知限制

  • 旁路模型只能看到事件流里可见的内容(正文、推理片段、工具名与结果), 看不到主模型的隐藏状态,所以「接下来」是推断,可能不准。
  • 播报有延迟:到点后要等下一个 tick(5 秒)才真正调用。
  • 频率越高 token 消耗越大;30 秒档在长任务里可能到 40 万 token/时(设置里已标注)。
  • 只支持 web 端。

版本

  • v1:宿主事件采集 + 旁路调用 + HTTP 接口 + 悬浮窗骨架,端到端跑通。
  • v2:修定位(贴输入框)、修拖拽吞点击、设置面板、深色模式按钮对比度、token 统计。
  • v3:播报块视觉、空状态、胶囊 hover、展开卡片高度夹紧、移动端复测。
  • v4:code-reviewer 修复(失败指数退避、resolveModelInfo、abort 判定、/now 错误反馈、SSRF 校验、并发互斥、长回合收尾播报);ux-reviewer 修复(移动端不再盖住输入框、拖拽夹紧在视口内、胶囊改为可键盘操作的 button + Esc 关闭、浅色三级灰改二级灰、深色 Toggle/Segmented 对比度、hover 规则从 inline 挪到 CSS、触控目标 ≥32px、焦点环、滚动渐隐、设置面板单头部)。
  • v5:装进主 profile 并远端验证;主 profile 配置改为 deepseek-account。
  • v6:新增「观察」栏(conversation.view,order 26)、悬浮窗开关(默认开)、移动端悬浮窗开关(默认关)、频率「永不」、窗口内「立即播报当前状况」;模型来源二选一改为必须保存才生效(未保存提示);观察栏打开时悬浮窗自动隐藏。
  • v7:修会话切换串播报(宿主不再回退「最近活跃会话」+ 客户端请求序号/会话 id 双重校验,丢弃过期响应);默认频率改为「永不」;横屏(≥900px)「观察」栏改两栏布局(左播报+操作、右追问+示例问题),竖屏与悬浮窗保持单栏;新增播报历史(最近 10 条,可回看)、暂停/继续、复制播报。
  • v7.5:收起态从「细横条」改成贴在输入框右侧的小卡片——宽度自适应右侧留白(最宽 240px)、文字自动换行最多 3 行、与输入框底边对齐;展开卡片右对齐到同一位置。移动端改为输入框上方居中的 320px 卡片。
  • v7.4:修收起态胶囊被 font: inherit 覆盖成 16px 的问题(实际渲染一直偏大);胶囊改为 11px 字号、3px/9px 内边距、6px 状态点、最大宽 240,整体更细更小。展开卡片恢复原字号(13px 正文 / 11px 次要 / 12.5px 标题按钮,宽 380)。
  • v7.3:悬浮窗字号再收一档(正文 11px、次要信息 10px、标题/按钮 11px、行高 1.5),卡片宽度 380→340;「观察」栏保持原字号。
  • v7.2:悬浮窗字号整体收一档(正文 13→12、次要信息 11→10.5、标题/按钮 12.5→12,设置面板同步),「观察」栏保持原字号。
  • v7.1 UX 修复:历史列表加「收起历史」退出路径;移动端胶囊上移到输入框上方、不再遮挡状态行;「观察」栏按视口高度夹紧(720p 下保存按钮不再被输入框盖住);设置面板限宽 560 居中;窄屏也显示示例问题(横向滚动);按钮 hover 改用 inset 阴影(不再被内联样式压过);错误码映射成人话并带「重试」;追问回答可清除;发送/保存改用宿主同款蓝色 button-info-fill;宽屏底部行对齐、footer 通栏;暂停态圆点改灰;触控目标 ≥24px;设置描述不再孤字换行;分段控件选中态加描边+加粗;设置面板保持底部锚定不再跳到顶部;深色卡片阴影单独调;追问加载态文案;播报区 aria-live、输入框 aria-label。
  • v7 审查修复:阻断「改自定义端点 URL 把已存密钥发到新地址」的外泄链(换 URL 未填新 key 时清空旧 key 并提示);路由注册失败回滚;切会话不再清空配置;历史回看改用稳定时间戳;拖拽加位移阈值;清除密钥不再顺带保存草稿;tab 激活状态改用模块标志;/models 并发 + 超时;/ask 长度上限;413 不再断连;token 统计计入缓存读写;ask/narrate 互斥;会话 Map 淘汰兜底;zIndex 降到 1100;卸载时清理注入样式。

License

MIT

Ähnliche Plugins