dsh-agentic-pet 0.3.0 → 0.3.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 beyondgjc
+
+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

@@ -1,50 +1,56 @@
----
-description: "The dsh desktop pet: an agentic pet plugin that serves the pet renderer over the web composition, drives it from in-process dsh events, and answers approvals and questions from the desktop."
-kind: "package-bundle"
----
-
-# dsh-agentic-pet
-
-English | [中文](README.zh.md)
-
-## Summary
-
-`dsh-agentic-pet` is a desktop-pet plugin for the [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) ecosystem: the pet lives on your desktop as a transparent always-on-top window, follows your agent sessions (idle / thinking / working / error), races the web GUI to answer approvals and user questions (first answer wins), collects a per-pet touch-affection ledger, and exposes expressive tools (`pet_say`, `pet_do`, `pet_digest`, `pet_interactions`, `pet_state`) so the model can speak and act through the pet. Multiple pet implementations can run side by side — a directory registry (`~/.dsh/pet-http.d/`) discovers every live pet and routes state, interactions, and ledgers per pet.
-
-The pet itself is a dumb display with zero dsh knowledge. Everything that understands the runtime — event convergence, interaction waterfalls, multi-pet routing, the model tools — lives in the plugin's driver, and the pet only implements a small local HTTP control interface. Any pet implementation that speaks the same HTTP contract can be adopted without changing this plugin.
-
-## What's in this repo
-
-| Path | What it is |
-|---|---|
-| `src/` | The plugin (Cordis bundle): `/pet` route, event driver, registry, `PetService` seam, model tools, settings-page routes |
-| `client/` | The desktop sidebar settings page (client half) |
-| `carrier/` | The Electron carrier **build artifacts** shipped with the package (`lib/`, `dist-renderer/`) |
-| `carrier-src/` | The carrier **sources** (mirrored from the dev upstream; media assets live in [dsh-pet-assets](https://github.com/beyondgjc/dsh-pet-assets)) |
-| `vendor/typert-plugin/` | Vendored typert decorator plugin used by the packaging config |
-| `tests/` | Vitest specs (pure-function coverage of the registry routing and the `/status` field-matrix normalization) |
-
-## Install
-
-From the DeepSeek Harness desktop app's plugin page, or:
-
-```bash
-dsh plugin --profile <name> add dsh-agentic-pet
-```
-
-The animation media ship as a separate package, `dsh-agentic-pet-assets`, and are pulled in automatically as a dependency.
-
-## Development
-
-The TypeScript build still runs inside the dsh monorepo workspace (the bundled `@deepseek-ai/dsh-*` deps are not published to npm). The flow:
-
-1. In the monorepo: `pnpm run build` (plugin `lib/`) and `pnpm --filter @deepseek-ai/dsh-pet run build` (carrier `lib/` + `dist-renderer/`).
-2. Here: `scripts\sync-from-monorepo.cmd` — mirrors sources and build outputs into this repo.
-3. Commit here, then `npm publish` (assets package first; see [dsh-pet-assets/PUBLISH.md](../dsh-pet-assets/PUBLISH.md) for the release manual).
-
-Tests: `npx vitest run tests/registry-service.spec.ts` runs self-contained (needs only `cordis` and `vitest`); the full suite including `tests/pet-app.spec.ts` runs in the monorepo workspace.
-
-## Documentation
-
-- Control-plane contract (the frozen consumer API every pet implementation speaks): see the multi-pet guide in the project documentation.
-- Known limitations and design notes live in the repo wiki and the project's engineering docs.
+---
+description: "The dsh desktop pet: an agentic pet plugin that serves the pet renderer over the web composition, drives it from in-process dsh events, and answers approvals and questions from the desktop."
+kind: "package-bundle"
+---
+
+# dsh-agentic-pet
+
+English | [中文](README.zh.md)
+
+## Summary
+
+`dsh-agentic-pet` is a desktop-pet plugin for the [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) ecosystem: the pet lives on your desktop as a transparent always-on-top window, follows your agent sessions (idle / thinking / working / error), races the web GUI to answer approvals and user questions (first answer wins), collects a per-pet touch-affection ledger, and exposes expressive tools (`pet_say`, `pet_do`, `pet_digest`, `pet_interactions`, `pet_state`) so the model can speak and act through the pet. Multiple pet implementations can run side by side — a directory registry (`~/.dsh/pet-http.d/`) discovers every live pet and routes state, interactions, and ledgers per pet.
+
+The pet itself is a dumb display with zero dsh knowledge. Everything that understands the runtime — event convergence, interaction waterfalls, multi-pet routing, the model tools — lives in the plugin's driver, and the pet only implements a small local HTTP control interface. Any pet implementation that speaks the same HTTP contract can be adopted without changing this plugin.
+
+## What's in this repo
+
+| Path | What it is |
+|---|---|
+| `src/` | The plugin (Cordis bundle): `/pet` route, event driver, registry, `PetService` seam, model tools, settings-page routes |
+| `client/` | The desktop sidebar settings page (client half) |
+| `carrier/` | The Electron carrier **build artifacts** shipped with the package (`lib/`, `dist-renderer/`) |
+| `carrier-src/` | The carrier **sources** (mirrored from the dev upstream; media assets live in [dsh-pet-assets](https://github.com/beyondgjc/dsh-pet-assets)) |
+| `vendor/typert-plugin/` | Vendored typert decorator plugin used by the packaging config |
+| `tests/` | Vitest specs (pure-function coverage of the registry routing and the `/status` field-matrix normalization) |
+
+## Install
+
+From the DeepSeek Harness desktop app's plugin page, or:
+
+```bash
+dsh plugin --profile <name> add dsh-agentic-pet
+```
+
+The animation media ship as a separate package, `dsh-agentic-pet-assets`, and are pulled in automatically as a dependency.
+
+## Development
+
+The TypeScript build still runs inside the dsh monorepo workspace (the bundled `@deepseek-ai/dsh-*` deps are not published to npm). The flow:
+
+1. In the monorepo: `pnpm run build` (plugin `lib/`) and `pnpm --filter @deepseek-ai/dsh-pet run build` (carrier `lib/` + `dist-renderer/`).
+2. Here: `scripts\sync-from-monorepo.cmd` — mirrors sources and build outputs into this repo.
+3. Commit here, then `npm publish` (assets package first; see [dsh-pet-assets/PUBLISH.md](../dsh-pet-assets/PUBLISH.md) for the release manual).
+
+Tests: `npx vitest run tests/registry-service.spec.ts` runs self-contained (needs only `cordis` and `vitest`); the full suite including `tests/pet-app.spec.ts` runs in the monorepo workspace.
+
+## Documentation
+
+- Control-plane contract (the frozen consumer API every pet implementation speaks): see the multi-pet guide in the project documentation.
+- Known limitations and design notes live in the repo wiki and the project's engineering docs.
+
+
+## Credits & Licensing
+
+- This project is a derivative of [PC2005-cloud/dsh-pet](https://github.com/PC2005-cloud/dsh-pet) — the upstream dsh-pet plugin by PC2005-cloud. Plugin code is licensed MIT.
+- The character artwork (the "大肥鱼" whale-girl character under `carrier/assets` and `dsh-agentic-pet-assets`) is licensed **CC BY-NC-SA 4.0** (attribution · non-commercial · share-alike) by its original author — [original statement](https://www.bilibili.com/opus/1247156596114456581). Non-commercial use only; artwork derivatives must be shared under the same license.

package/README.zh.md

@@ -1,50 +1,56 @@
----
-description: "dsh 桌面宠物：经由 web 组合层伺服宠物页面、由进程内 dsh 事件驱动、可从桌面应答审批与提问的 agentic 宠物插件。"
-kind: "package-bundle"
----
-
-# dsh-agentic-pet
-
-[English](README.md) | 中文
-
-## 简介
-
-`dsh-agentic-pet` 是 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 生态的桌面宠物插件：宠物以透明置顶窗常驻桌面，跟随 agent 会话状态（idle / thinking / working / error），与 web 界面竞速应答审批与提问（先答者赢），维护每宠独立的触摸好感账本，并向模型暴露表达工具（`pet_say`、`pet_do`、`pet_digest`、`pet_interactions`、`pet_state`）——模型可以借宠物说话、做动作、感知被触摸。多只宠物实现可以并存：目录注册表（`~/.dsh/pet-http.d/`）发现全部在线宠物，状态、交互、账本按宠路由。
-
-宠物本身是零 DSH 知识的纯显示端。理解运行时的一切——事件收敛、交互瀑布、多宠路由、模型工具——都在插件的 driver 里，宠物只实现一个小型本地 HTTP 控制接口。任何讲同一 HTTP 契约的宠物实现都能被采纳，插件零改动。
-
-## 仓库结构
-
-| 路径 | 内容 |
-|---|---|
-| `src/` | 插件（Cordis bundle）：`/pet` 路由、事件 driver、注册表、`PetService` 接缝、模型工具、设置页路由 |
-| `client/` | 桌面侧边栏设置页（client 半边） |
-| `carrier/` | 随包分发的 Electron 载体**构建产物**（`lib/`、`dist-renderer/`） |
-| `carrier-src/` | 载体**源码**（自开发上游镜像；素材在 [dsh-pet-assets](https://github.com/beyondgjc/dsh-pet-assets)） |
-| `vendor/typert-plugin/` | 打包配置使用的 typert 装饰器插件（vendored） |
-| `tests/` | Vitest 用例（注册表路由与 `/status` 字段矩阵的纯函数覆盖） |
-
-## 安装
-
-在 DeepSeek Harness 桌面端插件页安装，或：
-
-```bash
-dsh plugin --profile <name> add dsh-agentic-pet
-```
-
-动画素材以独立包 `dsh-agentic-pet-assets` 分发，作为依赖自动带入。
-
-## 开发
-
-TypeScript 构建仍在 dsh monorepo workspace 内进行（被打包的 `@deepseek-ai/dsh-*` 依赖未发布 npm）。流程：
-
-1. monorepo 内：`pnpm run build`（插件 `lib/`）与 `pnpm --filter @deepseek-ai/dsh-pet run build`（载体 `lib/` + `dist-renderer/`）。
-2. 本仓库：`scripts\sync-from-monorepo.cmd`——把源码与构建产物镜像进本仓库。
-3. 本仓库提交，然后 `npm publish`（先素材包后插件包；发布手册见 [dsh-pet-assets/PUBLISH.md](../dsh-pet-assets/PUBLISH.md)）。
-
-测试：`npx vitest run tests/registry-service.spec.ts` 自持可跑（只需 `cordis` 与 `vitest`）；含 `tests/pet-app.spec.ts` 的全量测试在 monorepo workspace 内跑。
-
-## 文档
-
-- 控制面契约（所有宠物实现共同讲述的冻结消费方 API）见项目文档的多宠指南。
-- 已知边界与设计笔记见仓库 wiki 与项目工程文档。
+---
+description: "dsh 桌面宠物：经由 web 组合层伺服宠物页面、由进程内 dsh 事件驱动、可从桌面应答审批与提问的 agentic 宠物插件。"
+kind: "package-bundle"
+---
+
+# dsh-agentic-pet
+
+[English](README.md) | 中文
+
+## 简介
+
+`dsh-agentic-pet` 是 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 生态的桌面宠物插件：宠物以透明置顶窗常驻桌面，跟随 agent 会话状态（idle / thinking / working / error），与 web 界面竞速应答审批与提问（先答者赢），维护每宠独立的触摸好感账本，并向模型暴露表达工具（`pet_say`、`pet_do`、`pet_digest`、`pet_interactions`、`pet_state`）——模型可以借宠物说话、做动作、感知被触摸。多只宠物实现可以并存：目录注册表（`~/.dsh/pet-http.d/`）发现全部在线宠物，状态、交互、账本按宠路由。
+
+宠物本身是零 DSH 知识的纯显示端。理解运行时的一切——事件收敛、交互瀑布、多宠路由、模型工具——都在插件的 driver 里，宠物只实现一个小型本地 HTTP 控制接口。任何讲同一 HTTP 契约的宠物实现都能被采纳，插件零改动。
+
+## 仓库结构
+
+| 路径 | 内容 |
+|---|---|
+| `src/` | 插件（Cordis bundle）：`/pet` 路由、事件 driver、注册表、`PetService` 接缝、模型工具、设置页路由 |
+| `client/` | 桌面侧边栏设置页（client 半边） |
+| `carrier/` | 随包分发的 Electron 载体**构建产物**（`lib/`、`dist-renderer/`） |
+| `carrier-src/` | 载体**源码**（自开发上游镜像；素材在 [dsh-pet-assets](https://github.com/beyondgjc/dsh-pet-assets)） |
+| `vendor/typert-plugin/` | 打包配置使用的 typert 装饰器插件（vendored） |
+| `tests/` | Vitest 用例（注册表路由与 `/status` 字段矩阵的纯函数覆盖） |
+
+## 安装
+
+在 DeepSeek Harness 桌面端插件页安装，或：
+
+```bash
+dsh plugin --profile <name> add dsh-agentic-pet
+```
+
+动画素材以独立包 `dsh-agentic-pet-assets` 分发，作为依赖自动带入。
+
+## 开发
+
+TypeScript 构建仍在 dsh monorepo workspace 内进行（被打包的 `@deepseek-ai/dsh-*` 依赖未发布 npm）。流程：
+
+1. monorepo 内：`pnpm run build`（插件 `lib/`）与 `pnpm --filter @deepseek-ai/dsh-pet run build`（载体 `lib/` + `dist-renderer/`）。
+2. 本仓库：`scripts\sync-from-monorepo.cmd`——把源码与构建产物镜像进本仓库。
+3. 本仓库提交，然后 `npm publish`（先素材包后插件包；发布手册见 [dsh-pet-assets/PUBLISH.md](../dsh-pet-assets/PUBLISH.md)）。
+
+测试：`npx vitest run tests/registry-service.spec.ts` 自持可跑（只需 `cordis` 与 `vitest`）；含 `tests/pet-app.spec.ts` 的全量测试在 monorepo workspace 内跑。
+
+## 文档
+
+- 控制面契约（所有宠物实现共同讲述的冻结消费方 API）见项目文档的多宠指南。
+- 已知边界与设计笔记见仓库 wiki 与项目工程文档。
+
+
+## 致谢与授权
+
+- 本项目基于 [PC2005-cloud/dsh-pet](https://github.com/PC2005-cloud/dsh-pet) 衍生（上游 dsh-pet 插件，作者 PC2005-cloud）。插件代码以 MIT 许可发布。
+- 角色形象（"大肥鱼"鲸鱼娘，见 `carrier/assets` 与 `dsh-agentic-pet-assets`）的形象授权为 **CC BY-NC-SA 4.0**（署名 · 非商业 · 相同方式共享），[原作者声明](https://www.bilibili.com/opus/1247156596114456581)。仅限非商业使用；形象衍生须以相同方式共享。

package/lib/index.js

@@ -2,7 +2,7 @@ import { i as installPetDriver, n as installPetService } from "./service-Vj-lLpI
 import { createRequire } from "node:module";
 import { spawn } from "node:child_process";
 import { createHash } from "node:crypto";
-import { existsSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import { mkdir, readFile, unlink, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { dirname, extname, join, normalize, resolve, sep } from "node:path";
@@ -535,6 +535,17 @@ function apply(ctx) {
 			const candidate = String(require("electron"));
 			if (existsSync(candidate)) return candidate;
 		} catch {}
+		try {
+			let dir = dirname(fileURLToPath(import.meta.url));
+			for (let i = 0; i < 8; i += 1) {
+				const pkgDir = join(dir, "node_modules", "electron");
+				const binary = join(pkgDir, "dist", readFileSync(join(pkgDir, "path.txt"), "utf8").trim());
+				if (existsSync(binary)) return binary;
+				const parent = dirname(dir);
+				if (parent === dir) break;
+				dir = parent;
+			}
+		} catch {}
 		return process.versions.electron !== void 0 ? process.execPath : void 0;
 	};
 	const spawnPetCarrier = (url) => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-agentic-pet",
   "description": "The pet-surface bundle: serves the desktop pet renderer over the web composition, turning dsh into a surface the desktop pet attaches to as an authenticated client",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "publishConfig": {
     "access": "public"
   },