dsh-capyreporter

dsh plugin --profile web add dsh-capyreporter

CapyReporter 🦫

[English](README.md) | 简体中文

DeepSeek Harness Web 的本地任务播报宠物：页面内悬浮水豚，以及可选的 Electron 桌面置顶窗口。

主要功能

• 使用真实 DSH 事件显示工作区、会话和简短的回复里程碑预览：气泡默认跟随助手的最新表述，不会被工具调用刷屏。推理内容默认隐藏，可在设置中开启「Report thinking」后显示；关闭后立即丢弃实时推理缓存，完成结果的预览不会保存推理内容。提示词、工具参数和工具输出始终不会展示。
• 区分成功、取消、失败、阻塞、输出上限和中断。仅进入 idle 不会误报成功。
• 子代理运行时也能直接看到：标题会显示 ⏳ 1 个运行中 · 2 个子代理 — <会话>，主会话暂时还没有回复文本时，折叠详情显示 🤖 2 个子代理运行中；子代理结束时数量减少，并转为进度里程碑。十种语言均已翻译。
• 只有主会话才会显示「Turn complete」。 子代理（subagent）完成任务不会再让父会话出现绿色完成标记：只要有主会话在运行，标题始终显示运行中的主会话；子代理的结束（✅ Subagent finished、⚠️ Subagent failed、⏹ Subagent cancelled）作为里程碑出现在详情里。只有所有主会话都结束后，主会话的结果才会占据标题。
• 并行会话各自保留结果，启动另一个任务不会抹掉之前的结果。最多保留 20 条未读结果，六小时后过期。
• 明确的「Details / Collapse」「Go to chat / 转到会话」「Mute 30 min（可配置）」按钮，气泡右上角的 × 关闭按钮，以及宠物菜单里的快捷入口：打开设置，或切换到宠物跨窗口置顶。键盘可操作，支持减少动态效果偏好。
• 十种界面语言，可在设置中随时切换（English、中文、Español、हिन्दी、العربية、Português、Русский、日本語、Français、Deutsch），默认跟随浏览器/系统语言；网页宠物与桌面伴侣同步显示，阿拉伯语自动切换为从右到左。所有语言均经过表达润色（气泡按钮、宠物菜单、设置项与桌面伴侣同样适用），不是机械直译。
• 离开页面时的通知默认关闭，需在插件设置中开启并获得浏览器授权。页面处于前台焦点时不通知；多个标签页仍可能分别发通知。
• 宠物跨窗口置顶只有在图片解码、读取活动并上报心跳后才会替代页面宠物；启动失败或失去心跳会恢复页面兜底。

安装

dsh plugin --profile web add dsh-capyreporter

0.6.27 已重新验证 DeepSeek Harness 0.2.1-alpha.1（路由、slots、客户端 bundle 分发与 agent/session 事件）。peerDependencies 只有 @deepseek-ai/cordis 与 react（由 DSH 提供给插件），不再锁定任何 DSH 包版本范围。客户端更新后刷新页面；宿主代码更新需重新激活插件或重启 DSH，仅刷新不会替换已加载的宿主模块。

宠物跨窗口置顶默认开启：未保存偏好设置的新安装会直接启动置顶宠物，以跨窗口浮层显示；选择「仅用网页宠物」即可关闭。

桌面模式需自行安装 Electron。可用 DSH_PET_ELECTRON_PATH 或 ELECTRON_PATH 指定可执行文件，也会检查 $DSH_HOME/electron/、用户 npm 安装和常见 Windows 旧安装目录。不自动下载 Electron。macOS 建议显式指定可执行文件。

宿主端口会自动识别。DSH_CAPYREP_BASE_URL 只接受精确的回环 HTTP(S) origin，不能带账号、路径或认证 token。远程域名和反向代理不是当前支持范围。独占全屏应用可能遮住置顶窗口；空白背景点击穿透，图片元素和气泡区域可交互，并非按透明像素逐点穿透。

操作

操作 · 效果

拖动宠物 · 移动，不会误确认结果或打开浏览器

Ctrl / Cmd + 滚轮 · 缩放，50–250%；普通滚轮不拦截

单击、右击或 Enter/Space · 打开控制菜单

Details / Collapse · 展开或收起日志

转到会话 · 在当前窗口打开标题所示的会话（运行中优先，否则为刚结束的）；宠物菜单同样可用（仅网页宠物）

宠物菜单 → 打开设置 · 直接跳到 DSH 设置中的 CapyReporter 分区（桌面伴侣菜单同样可用）

宠物菜单 → 启用/重试宠物置顶 · 不离开网页宠物，直接启动宠物跨窗口置顶，或在其启动失败后重试

气泡右上角 × · 关闭当前气泡（新活动会再次出现）；结束后同时确认该结果（宠物菜单仍有「忽略结果」）

拖动气泡任一边缘/角落、在角落手柄上用方向键，或 Ctrl + 滚轮 · 调整气泡尺寸（宽 260–560、高 160–720 像素），按浏览器记忆；按钮固定在气泡底部，内容过多时中间详情区滚动

拖动桌面气泡的任一边缘/角落 · 调整置顶窗口中的气泡；窗口随之变化，宠物仍固定在气泡上方

双击任一缩放手柄，或在宠物菜单选「重置气泡大小」 · 恢复默认 360 像素宽度与随内容自适应的高度

静音 30 分钟 · 仅静音气泡（默认 30 分钟），宠物和菜单仍可操作；取消静音后，即使没有新活动也会恢复显示

Restore bubble · 恢复显示，并提前结束静音

双击桌面宠物 / Open DeepSeek Harness · 打开配置的 DSH origin

Escape · 关闭菜单和详情

设置与隐私

设置 → 🐾 CapyReporter 可控制显示、宠物跨窗口置顶、大小、图片、通知、Status bubble 静音时长（10/30/60/240 分钟，默认 30）、Report thinking（默认关闭；开启后以 💭 显示当前推理作为实时里程碑）以及界面语言（Auto 加十种语言；阿拉伯语自动 RTL，桌面伴侣同步）。Auto 跟随浏览器/系统语言，不支持的语言回退为英文，选择会持久保存在宿主机。图片仅支持 PNG，最多 4 MiB，每边 1–4096 像素。替换自定义图片时也会更新缓存版本。

开关、图片和大小原子保存到 $DSH_HOME/capyreporter.json（默认 ~/.dsh）。只有该文件不存在时才读取旧 homura-pet.json；保存失败会保留之前的内存设置。页面位置单独存在浏览器 localStorage，桌面位置仅在本次运行内保留。

无遥测、云账号或外部服务。桌面气泡和通知会暴露会话名与回复预览；共享屏幕时请关闭。接口拒绝跨域浏览器请求、非回环来源和 GET 修改操作；桌面通过私有 capability 与沙箱 IPC 访问。同源检查不是对恶意本机进程的认证，也不能替代 DSH 登录。详见 [架构与安全边界](docs/architecture.md)。

「Hide pet」只是隐藏，不等于卸载。卸载请使用 DSH 插件管理器，或：

dsh plugin --profile web remove dsh-capyreporter

开发与诊断

npm ci
npm test
npm run verify
npm run test:browser
npm pack --dry-run

源码就是手写 JavaScript，无需构建。浏览器测试默认使用本机 Chrome，Electron 测试没有可执行文件时会明确跳过。全部使用临时设置和独立回环测试服务，不修改用户配置或重启当前 DSH。

[排障](docs/troubleshooting.md) · [审计及其他宠物插件经验](docs/audit.md) · [MIT](LICENSE)