dsh-observer
Manifest validSidecar 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
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/state | GET | 当前会话、最近播报、token 累计 |
/api/observer/config | GET/POST | 读 / 写配置 |
/api/observer/models | GET | 提供商与模型列表 |
/api/observer/model | GET | 某模型的思考强度选项 |
/api/observer/now | POST | 强制播报一次 |
/api/observer/ask | POST | 追问 |
/api/observer/health | GET | 健康检查 |
已知限制
- 旁路模型只能看到事件流里可见的内容(正文、推理片段、工具名与结果), 看不到主模型的隐藏状态,所以「接下来」是推断,可能不准。
- 播报有延迟:到点后要等下一个 tick(5 秒)才真正调用。
- 频率越高 token 消耗越大;30 秒档在长任务里可能到 40 万 token/时(设置里已标注)。
- 只支持 web 端。
版本
- v7.6:修窄屏下收起态卡片压住输入框/发送按钮的问题——右侧留白不足 140px 时不再硬挤在输入框右边,改为右对齐放到输入框上方;展开卡片跟随同一位置。
- 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
Versions
| Latest version | Published | Size |
|---|---|---|
| 0.7.5 | — | — |
| 0.7.6 | — | — |
Comments
Loading…
Similar plugins
by yingrui96
An always-on attention pill in the session header. One glance shows how many sessions are waiting on you — approvals, questions, and failures — and what you already declined. Its HTTP routes have no D
★ 0
MIT
JavaScript
Nov 15, 2026
dsh plugin --profile web add dsh-attention-boardby gcwarmman
A right-sidebar narrator for DeepSeek Harness that says what the agent finished, is doing, and will do next, plus a read-only explain channel, a non-interrupting steer, and a stop that reports what it
★ 0
MIT
JavaScript
Nov 18, 2026
dsh plugin --profile web add dsh-sidekick-lensby NattoCB
DSH web_search provider that follows the conversation's routed model provider — per-provider endpoint/credential/dialect table with built-in official fallback
★ 0
MIT
JavaScript
Sep 5, 2026
dsh plugin --profile web add dsh-web-search-session-follow为模型展示交付成果和下达精细微调指示的dsh desktop面板
★ 0
MIT
JavaScript
dsh plugin --profile web add dsh-plugin-middle-panelby WuHututu
Opens a temporary side conversation in the right Sidebar that reuses the host conversation UI, so answers render with the same markdown, tool steps, timing and token usage as the main thread. The side
★ 0
JavaScript
Oct 30, 2026
dsh plugin --profile web add dsh-side-chatA Codex-style right side panel for the DSH Web UI — session artifacts browser (live file tree, scan include, preview, reveal) plus a side chat that forks the current session with a model picker, human
★ 0
dsh plugin --profile web add dsh-sidepanel