dsh-capyreporter 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CapyReporter contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,60 @@
+# 🐾 CapyReporter — the capybara that reports for you
+
+**An always-on-top capybara task reporter for the DeepSeek Harness Web UI.**
+
+CapyReporter is a tiny transparent window that floats above **every** app and tab of your desktop — not just inside the page — and quietly narrates what your deepseek harness agent is doing, one step at a time, so you can focus on your other work and never miss the moment a task finishes.
+
+## 🦫 What makes it special
+
+- **Always on top, everywhere.** A true desktop overlay (transparent, frameless, click-through except on the capybara). Writes in Notepad, videos, games, other editors — she stays floating and readable. Companion to the in-page overlay for browsers without Electron.
+- **Narrates the trajectory.** Every checkpoint of a run becomes a short bubble line: `🔧 tool calls`, `💭 writing…`, `🧭 steering`, `🚀 workflow phases`, `⚠️ errors & retries`. You watch the agent think, in real time.
+- **Smart bubble that never gets in the way.**
+  - *Compact* — headline + latest status line.
+  - *Click to expand* — a scrollable history of the run's steps.
+  - *Double-click to dismiss* — she goes quiet until the next update.
+  - *Right-click → Restore bubble* — call the report back any time.
+- **Project-aware.** The bubble names the **workspace/project** the run belongs to (the same name as the sidebar), so with several sessions running you always know who's reporting.
+- **Completion alert while you're away.** `✅ Task complete — <project>` stays on the always-on-top window until you dismiss it — then one click on the capybara jumps you straight back into DeepSeek Harness. Optional desktop notification too.
+- **Make her yours.** Upload any transparent PNG in **Settings → 🐾 CapyReporter** to change the character, and scroll the mouse wheel over her to resize. Settings also lets you enable/disable her and uninstall the plugin.
+- **Persistent & local-first.** Preferences (image, size, position) live in `$DSH_HOME/capyreporter.json`; no cloud, no accounts, no telemetry.
+
+## 📦 Install
+
+**Package Manager** — once listed: *Settings → Plugin Market → search "capy" → install → refresh the page*.
+
+**CLI:**
+
+```sh
+dsh plugin --profile web add dsh-capyreporter
+```
+
+Restart `dsh web` (or just refresh the page). Requires DSH web 0.1.0-rc.6 or newer.
+
+**Electron for the always-on-top window** (optional but recommended):
+
+- If Electron is already at `%USERPROFILE%\.dsh\electron\electron.exe` (or any path in `DSH_PET_ELECTRON_PATH`), the desktop window just works.
+- Without it, CapyReporter still runs **in-page** — a transparent floating capybara inside the DeepSeek Harness page with the same bubble features.
+
+## 🎛 Control summary
+
+| Action | Result |
+| --- | --- |
+| Drag the capybara | Move her (window follows) |
+| Mouse wheel over her | Resize |
+| Single click the bubble | Expand / collapse the step log |
+| Double-click the bubble | Dismiss until the next update |
+| Left-click the capybara | Return to DeepSeek Harness |
+| Right-click the capybara | Menu: Restore bubble · Open DSH · Hide desktop pet |
+
+## 🎨 Art & licensing
+
+- Ships with the built-in capybara art. Replace it with your own transparent PNG in Settings.
+- MIT license; the capybara artwork is intended to be replaced/replaceable by the user.
+
+## 🌍 Contributing & feedback
+
+Issues and pull requests welcome. *This plugin is community code — install sources you trust.*
+
+---
+
+Made with 🧡 for the DeepSeek Harness community.

package/README.zh.md

@@ -0,0 +1,60 @@
+# 🐾 CapyReporter — 替你盯梢的水豚小报
+
+**一个永远置顶的 「水豚小报」：为 DeepSeek Harness Web UI 实时播报任务进度的桌面宠物。**
+
+CapyReporter 是一个小小的透明窗口，悬浮在**你桌面上的每一个应用与标签页之上**——不止于网页内部。它会在 agent 工作的每一个关键节点轻声播报，让你安心处理手头的事，绝不错过任务完成的瞬间。
+
+## 🦫 亮点
+
+- **真正的全局置顶。** 透明、无边框、除水豚本体外点击穿透。用记事本、看视频、玩游戏、写代码——她就静静浮在那里，大小字都看得清。Windows 上由 Electron 桌面窗口实现，未安装 Electron 时自动回落到页面内悬浮。
+- **播报运行轨迹。** 每到一个检查点，气泡就更新一行：`🔧 工具调用`、`💭 思考中…`、`🧭 调度/干预`、`🚀 工作流阶段`、`⚠️ 报错与重试`——实时看着你的 agent「思考」。
+- **智能气泡，不挡视线。**
+  - *紧凑模式*：标题 + 最新状态一行。
+  - *单击展开*：滚动查看本次运行的步骤历史。
+  - *双击隐藏*：水豚安静下来，直到下一条更新。
+  - *右键 → 恢复气泡*：随时找回小报。
+- **认得到项目的名字。** 气泡直接显示运行所属的**工作区/项目名**（与左侧边栏一致）。多会话并行时，你一眼就知道是谁在汇报。
+- **离开时也不错过完成。** `✅ 任务完成 — <项目名>` 会一直留在置顶窗口上，点击水豚一键回到 DeepSeek Harness；还可选桌面通知。
+- **完全可自定义。** 在 **设置 → 🐾 CapyReporter** 上传任意透明 PNG 换掉形象；在水豚身上滚动鼠标滚轮即可调整大小。设置里也能一键开启/关闭、卸载插件。
+- **持久且本地优先。** 偏好（形象、大小、位置）存于 `$DSH_HOME/capyreporter.json`；无云、无账号、无遥测。
+
+## 📦 安装
+
+**插件市场**（上架后）：*设置 → 插件市场 → 搜索「capy」→ 安装 → 刷新页面*。
+
+**命令行：**
+
+```sh
+dsh plugin --profile web add dsh-capyreporter
+```
+
+然后重启 `dsh web`（或直接刷新页面）。需要 DSH web 0.1.0-rc.6 或更新版本。
+
+**为置顶窗口准备的 Electron（可选，推荐）：**
+
+- 若 Electron 已存在于 `%USERPROFILE%\.dsh\electron\electron.exe`（或 `DSH_PET_ELECTRON_PATH` 指向的任意路径），桌面窗口开箱即用；
+- 没有的话，CapyReporter 仍会在 **页面内** 工作——一个悬浮在 DeepSeek Harness 页面上的透明水豚，气泡功能一个不少。
+
+## 🎛 操作一览
+
+| 操作 | 效果 |
+| --- | --- |
+| 拖动水豚 | 移动（窗口跟随） |
+| 在水豚上滚轮 | 缩放 |
+| 单击气泡 | 展开 / 收起步骤日志 |
+| 双击气泡 | 隐藏，直到下一条更新 |
+| 左键点击水豚 | 回到 DeepSeek Harness |
+| 右键点击水豚 | 菜单：恢复气泡 · 打开 DSH · 隐藏桌面宠物 |
+
+## 🎨 美术与许可
+
+- 内置默认水豚形象，可随时在设置中用你自己的透明 PNG 替换。
+- MIT 许可；默认水豚形象刻意设计为「可替换」，换图无任何限制。
+
+## 🌍 贡献与反馈
+
+欢迎提 Issue 与 PR。*本插件为社区作品——请只安装你信任的来源。*
+
+---
+
+为 DeepSeek Harness 社区而作 🧡

package/cordis.patch.yml

@@ -0,0 +1,6 @@
+# dsh-capyreporter bundle patch — mounts the persistent CapyReporter desktop-pet plugin.
+# The host half is lib/index.js (exported as a Cordis plugin); the package.json
+# "dsh.client" declaration makes the browser half available at /plugins/dsh-capyreporter/client.js.
+- insert:
+    - id: capyreporter
+      name: 'dsh-capyreporter'