@michengai/dsh-codex-pet 0.1.2 → 0.1.4

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## [0.1.4] - 2026-09-11
+
+- Restore compatibility with DSH `0.1.0-rc.8`, `0.1.1-rc.2`, `0.1.2-rc.1`, and `0.1.5-rc.1` while retaining `0.1.5-rc.2`. Adapt legacy session requests so pet notifications can answer questions and approvals on older hosts.
+
+## [0.1.3] - 2026-09-11
+
+- Support DSH Web `0.1.5-rc.2` and correct client service injection so the plugin loads with the updated host. Older DSH versions are outside the supported range.
+- Known upstream limitation: stopping before the model returns an HTTP response may produce a `turn/end` serialization error and a failure notification; stopping after streaming starts is supported.
+
 ## [0.1.2] - 2026-09-09
 
 - License original plugin code under Apache-2.0 and include LICENSE and third-party artwork NOTICE in the npm package.

package/CHANGELOG.zh-CN.md

@@ -1,5 +1,14 @@
 # 更新日志
 
+## [0.1.4] - 2026-09-11
+
+- 恢复 DSH `0.1.0-rc.8`、`0.1.1-rc.2`、`0.1.2-rc.1`、`0.1.5-rc.1` 兼容，同时保留 `0.1.5-rc.2`；适配旧版会话请求，使宠物通知可处理旧宿主的提问和审批。
+
+## [0.1.3] - 2026-09-11
+
+- 支持 DSH Web `0.1.5-rc.2`，修正客户端服务注入声明，使插件可在新版宿主加载；旧版 DSH 不在支持范围内。
+- 已知上游限制：模型尚未返回 HTTP 响应时停止任务，可能产生 `turn/end` 序列化错误并显示失败通知；已开始流式响应后的停止操作可用。
+
 ## [0.1.2] - 2026-09-09
 
 - 原创插件代码采用 Apache-2.0，npm 包包含 LICENSE 和第三方宠物素材 NOTICE。

package/README.md

@@ -1,27 +1,31 @@
 <p align="center">
-  <img src="assets/branding/dsh-codex-pet-banner.png" alt="DSH Codex Pet — a companion for your tasks" width="100%">
+  <img src="assets/branding/dsh-codex-pet-banner.png" alt="DSH Codex Pet" width="100%">
 </p>
 
 <div align="center">
 
 # DSH Codex Pet
 
-**A little companion for your DeepSeek Harness tasks.**
+**A little companion for your DeepSeek Harness tasks**
 
-[简体中文](README.zh-CN.md) · [Screenshots](#screenshots) · [Features](#features) · [Installation](#installation) · [Usage](#usage) · [Development](#development) · [Changelog](CHANGELOG.md)
+[简体中文](README.zh-CN.md) · [Changelog](CHANGELOG.md) · [Apache-2.0](LICENSE)
 
-[![DSH Web Plugin](https://img.shields.io/badge/DSH%20Web-Plugin-0f766e.svg)](https://github.com/deepseek-ai/deepseek-harness)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)
+[![npm package](https://img.shields.io/npm/v/%40michengai%2Fdsh-codex-pet.svg?label=npm%20package)](https://www.npmjs.com/package/@michengai/dsh-codex-pet)
+[![npm downloads](https://img.shields.io/npm/dt/%40michengai%2Fdsh-codex-pet.svg?label=npm%20downloads)](https://www.npmjs.com/package/@michengai/dsh-codex-pet)
+[![DSH Web Plugin](https://img.shields.io/badge/DSH%20Web-Plugin-0f766e.svg)](https://github.com/MichengAI/dsh-codex-pet)
 [![Node.js 22.19+](https://img.shields.io/badge/Node.js-22.19%2B-339933.svg?logo=node.js&logoColor=white)](https://nodejs.org/)
-[![npm](https://img.shields.io/npm/v/@michengai/dsh-codex-pet)](https://www.npmjs.com/package/@michengai/dsh-codex-pet)
 
 </div>
 
-DSH Codex Pet brings a pet library, task notifications, and a Skill-based creation flow to [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness). All nine built-in Codex pet sprite sheets ship with the plugin. Users do not need to install Codex.
+> DSH Codex Pet is a community-maintained pet plugin for DeepSeek Harness (DSH), not an official OpenAI or DeepSeek AI product.
 
 ## Features
 
+Keep a companion nearby while you work in DSH, follow task progress, and handle requests that need your attention. Choose a built-in pet or create your own with a Skill.
+
 - **Nine built-in pets**: choose a companion and adjust its size in pet settings. Assets are bundled locally.
-- **In-page companion**: the plugin displays pets within DSH Web and exposes a consumer API. External hosts own their window and IPC adapters.
+- **In-page companion**: keep a companion in DSH Web. Floating desktop pets require a desktop app with pet support.
 - **Multiple tasks at a glance**: follow running tasks, completion, errors, and requests that need your attention. An empty notification list leaves only the pet visible.
 - **Act from the notification**: open the associated task, stop its current turn, or handle supported approval, question, and plan requests.
 - **Quiet when you need it**: dismiss an individual reminder without stopping its task; collapse or restore the pet through its menu or settings.
@@ -52,7 +56,7 @@ Keep working in DSH while the pet and task notifications remain in the corner of
 
 ## DSH product ecosystem
 
-Install plugins as needed in an existing DeepSeek Harness environment. External consumers may integrate the pet API independently.
+Add plugins as needed to your existing DeepSeek Harness environment.
 
 | Plugin | What you can do |
 | --- | --- |
@@ -66,51 +70,18 @@ Install plugins as needed in an existing DeepSeek Harness environment. External
 | [Simplify](https://github.com/MichengAI/dsh-simplify) | Improve code within your Git changes |
 | [Codex Pet](https://github.com/MichengAI/dsh-codex-pet) | Keep a companion nearby and handle task notifications |
 
-## Prerequisites
-
-- DeepSeek Harness with its Web interface and the `dsh` command available.
-- Node.js **22.19 or newer** for building from source.
-- A configured image-generation tool in DSH to create custom pets.
-
 ## Installation
 
-Compatibility: the host must provide the `locale` client service and support function-valued `settings.section` labels. Local contract checks used `@deepseek-ai/cordis 4.0.2` and `@deepseek-ai/dsh-client-locale 0.1.2-rc.1`, plus the community DSH Codex UI settings implementation. These are checked component versions, not a verified minimum DSH release. Hosts without the locale service are not supported.
-
-Automatic updates use `--config.minimumReleaseAge=0` for that install command so a newly published version can be installed immediately. This bypasses pnpm’s release-age delay for the command without changing the global configuration. The package name, npm registry, and resolved version remain fixed by the server.
-
-Version 0.1.2 includes the settings, localization, npm updater, and consumer API changes described here; see the [changelog](CHANGELOG.md).
-
-The current version is **0.1.2**, available on [npm](https://www.npmjs.com/package/@michengai/dsh-codex-pet). See [GitHub Releases](https://github.com/MichengAI/dsh-codex-pet/releases) for release notes. Replace `web` below with your actual DSH profile.
-
-Run `dsh plugin --profile web add @michengai/dsh-codex-pet@latest --registry=https://registry.npmjs.org/ --ignore-scripts`, then reload DSH. The source build instructions follow.
-
-### Ask an agent to install it
-
-```text
-Install DSH Codex Pet from my local source checkout into the DSH web profile. In that checkout, run npm ci, npm run check, npm test, and npm pack. If all checks pass, install the generated michengai-dsh-codex-pet-0.1.2.tgz using dsh plugin --profile web add .\michengai-dsh-codex-pet-0.1.2.tgz --ignore-scripts. Run dsh --profile web --dump-config and confirm michengai-codex-pet is present. Explain how to reload DSH and open pet settings. Preserve existing tasks and user data.
-```
-
-### Build and install manually
-
-Run from the project root:
+Supported DeepSeek Harness versions: **`0.1.0-rc.8`, `0.1.1-rc.2`, `0.1.2-rc.1`, `0.1.5-rc.1`, and `0.1.5-rc.2`**. New compatibility is added without dropping these older releases. Make sure the `dsh` command is available. The example uses the `web` profile; replace it with your target profile.
 
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
 $OutputEncoding = [System.Text.Encoding]::UTF8
 
-npm ci
-npm run check
-npm test
-npm pack
-dsh plugin --profile web add .\michengai-dsh-codex-pet-0.1.2.tgz --ignore-scripts
-dsh --profile web --dump-config
+dsh plugin --profile web add @michengai/dsh-codex-pet@latest --registry=https://registry.npmjs.org/ --ignore-scripts
 ```
 
-Stop if any command fails. `npm pack` builds the plugin and checks that the nine sprite sheets and creation Skill are present. The generated archive includes the runtime assets.
-
-### Reloading
-
-After active tasks finish, restart the relevant DSH Web service and refresh its Web interface. A browser refresh alone does not replace an already loaded Host module.
+Restart DSH after installation, then open **Settings → Pets**.
 
 ## Usage
 
@@ -129,6 +100,8 @@ Open **Settings → Pets** (`宠物` in the current UI), or open settings from t
 
 The pet is a notification and action surface. Start new conversations and write follow-up messages in the main DSH interface.
 
+Known upstream limitation: cancelling before the model returns an HTTP response in DSH `0.1.5-rc.2` can report a non-JSON-serializable `turn/end` error, which the pet displays as a failure notification. Cancellation after streaming has started passed end-to-end validation.
+
 ### Create a custom pet
 
 1. Open pet settings, click **Create** (`创建`), and describe the companion.
@@ -136,24 +109,13 @@ The pet is a notification and action surface. Start new conversations and write
 3. Follow that task's progress. Creation uses DSH's configured model and image tools.
 4. Once the pet files are saved, refresh the pet library and select the new companion.
 
-The bundled `skills/hatch-pet/SKILL.md` is adapted for DSH and the compatible sprite-sheet format. The creation flow does not invoke the Codex CLI. A missing image tool must be resolved in DSH; opening the creation task alone does not mean a pet has been generated.
+Creating pets requires an image-generation tool configured in DSH.
 
-## Data and assets
+## Updates and uninstallation
 
-- Built-in sprite sheets: `assets/codex/`, included with the plugin.
-- Custom pets: `${DSH_HOME}\codex-pet\pets`; when `DSH_HOME` is unset, the base directory is the user's `.dsh` directory.
-- Existing Codex pets are not automatically read, moved, or migrated.
-- Uninstalling the plugin leaves custom pet files and configuration in place.
+Use **Settings → Pets → Check for updates**. If automatic installation is unavailable, copy the update command shown in the dialog. Wait for running tasks to finish, then update and restart DSH as prompted.
 
-The plugin is independently implemented and community maintained. The bundled Codex pet artwork comes from Codex; it is not original artwork by this project. This project is not an official OpenAI or DeepSeek product.
-
-Original plugin code is licensed under [Apache-2.0](LICENSE), matching the other plugins in this series. Third-party pet artwork is excluded from that license grant; see [NOTICE](NOTICE).
-
-## Plugin updates
-
-Pet settings show the running version, GitHub and issue links, and **Check for updates**. The updater queries npm and installs into the current DSH profile using the verified DSH CLI. Unsupported hosts can copy a manual update command. Wait for active tasks to finish before installing an update; reload DSH when prompted.
-
-## Uninstallation
+To uninstall:
 
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
@@ -162,57 +124,29 @@ $OutputEncoding = [System.Text.Encoding]::UTF8
 dsh plugin --profile web remove @michengai/dsh-codex-pet
 ```
 
-Reload DSH afterward. Keep your DSH data directory when switching versions.
+Custom pets are stored in `.dsh/codex-pet/pets` under your user directory by default; open the folder from pet settings. If `DSH_HOME` is set, pets are stored in its `codex-pet/pets` folder. Uninstalling keeps those files and settings.
+
+## Development checks
 
-## Development
+Development dependencies and the lockfile pin DSH `0.1.5-rc.2`. Use `npm ci` to reproduce the environment; `npm run check` also checks the plugin against official service types.
 
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
 $OutputEncoding = [System.Text.Encoding]::UTF8
-
 npm ci
+npx playwright install chromium
 npm run check
 npm test
-npm run build
+npm run smoke
+npm run test:e2e
 ```
 
-- `src/`: Host service, pet settings, animation, and task notifications.
-- `skills/`: the bundled pet creation Skill.
-- `test/`: library, creation, and notification regression tests.
-- `scripts/`: build, asset maintenance, package verification, and isolated Electron smoke checks.
-- `lib/`: generated runtime output; edit `src/` instead.
-
-There is no standalone HTML preview or native window entry. Verify the plugin inside DSH. `assets:import` is a maintainer command for updating original assets, not an installation requirement.
-
-For CodeGraph, run `codegraph init .` once, `codegraph sync .` after changes, and `codegraph status .` to check freshness. The index and local project documentation under `docs/` are excluded from Git.
-
-## Validation and current limits
-
-Type checking, 25 automated tests, the build, and controlled browser client interaction checks have passed. These cover task notifications and the creation request flow. Complete image generation, real-model task interaction and real npm updates still need end-to-end acceptance testing.
-
-## Browser smoke test
-
-After `npm ci`, run `npx playwright install chromium`, then `npm run smoke`. Playwright is a development dependency of this project. The test uses headless Chromium and a unique system temporary directory, cleaned after the test process exits. No Electron, sibling repository, `.preview`, or docs output is required.
-
-## Consumer API v1
-
-The plugin publishes `window.dshPet` in the DSH page and emits `dsh-pet-ready` / `dsh-pet-disposed`. Consumers subscribe and render independently; the plugin never imports or probes a consumer. Previous native window routes and window bridges have been removed. Existing native adapters must migrate to this contract.
-
-| Method | Contract |
-| --- | --- |
-| `getSnapshot()` | Returns a copied `{pet, config, language, notifications}` or `null` before loading/after disposal. Resolve relative pet asset URLs against the DSH page origin. |
-| `subscribe(listener)` | Receives changed snapshots or `null` on disposal; returns an unsubscribe function. Read the initial snapshot separately. |
-| `command(value)` | Executes notification commands (`open`, `stop`, `dismiss`, `restore`, `approve`, `reject`, `answer`, `sort`). Targeted commands require the current notification `id` and `token`; request answers also require `requestKey`. Validation and rejection stay in the plugin. |
-| `updateConfig(value)` | Updates pet settings through the existing validated Host API. |
-| `openSettings()` | Opens plugin settings in DSH. |
-| `acquireDisplay()` | Hides only the page overlay and returns an idempotent release function. Call release when disconnecting; the overlay returns after all consumers release. This does not change persisted visibility. |
-
-Consumers own their renderer, native window, IPC validation, and disconnect cleanup. The interface carries no native window implementation. User titles, questions, and answer options remain unchanged; the `language` field identifies the display locale.
+End-to-end tests also require pnpm on PATH (CI uses `11.25.0`). They install the local package through the official CLI and boot the full DSH Web app to test pet settings, persistence, session creation, question responses, completion and failure notifications, and cancellation. Only the external model HTTP service is replaced with a local fixture; no paid model or image generation is used. Tests use a separate `DSH_HOME` and keep logs and screenshots in the ignored `.preview/e2e-latest-*` directory without changing your everyday profile.
 
-## Automated releases
+The official type check verifies structural compatibility, not service lifecycle behavior. E2E runs as a separate CI job with a 25-minute budget; publishing requires a successful main push CI run for the exact tagged commit, including both language jobs for all five supported host versions. Wait for CI before tagging; missing, running, skipped, or failed checks block publishing. Windows Profile link errors (`EBUSY`) retry after 5 seconds within a shared 120-second startup budget; shutdown may require up to 10 additional seconds. This mitigates transient failures without claiming Windows stability. Other failures remain failures. Reports retain the locale, original failure, retry observations, and separate cleanup errors. PowerShell (`powershell.exe` on Windows, `pwsh` elsewhere) retains the latest five completed, marked runs. Unmarked historical evidence, unfinished runs, and directories containing `.keep` are preserved; pruning never follows directory links. Add `.keep` to release acceptance evidence before subsequent runs.
 
-GitHub Actions runs type checking, unit tests, Chromium smoke tests, and package validation on main pushes and pull requests. Pushing a stable version tag matching package.json (for example v0.1.2) runs publish.yml, validates the package, and publishes through npm OIDC. After npm succeeds, it extracts the matching entries from both changelogs and creates a normal Latest GitHub Release with Chinese followed by English, without tarball or checksum attachments.
+Set `DSH_PET_E2E_LOCALE` to `zh-CN` (default) or `en-US` to choose the browser language; CI tests both languages on all five supported versions. Set `DSH_PET_E2E_VERSION` to choose an older host; its complete official dependency graph is installed in isolation with exact versions. Development dependencies remain on rc.2. Set `DSH_PET_E2E_ROOT` to a separate directory named `.preview` to place isolated hosts and evidence on another volume.
 
-Before the first automated release, configure a GitHub Actions Trusted Publisher in the npm package Settings: owner MichengAI, repository dsh-codex-pet, workflow filename publish.yml, and no Environment. NPM_TOKEN is not required. The workflow cannot create this npm-side trust relationship itself.
+## License
 
-Update package.json, package-lock.json, and both changelogs before committing and pushing a new version tag. Published npm versions cannot be overwritten; fixes require a version increment. CI also supports manual workflow_dispatch runs without publishing.
+Original plugin code is licensed under [Apache License 2.0](LICENSE). Bundled pet artwork originates from OpenAI Codex and is excluded from this project's Apache-2.0 license grant; see [NOTICE](NOTICE).

package/README.zh-CN.md

@@ -1,27 +1,31 @@
 <p align="center">
-  <img src="assets/branding/dsh-codex-pet-banner.png" alt="DSH Codex Pet：任务在跑，宠物相伴" width="100%">
+  <img src="assets/branding/dsh-codex-pet-banner.png" alt="DSH Codex Pet" width="100%">
 </p>
 
 <div align="center">
 
 # DSH Codex Pet
 
-**任务在跑，宠物相伴。让 DeepSeek Harness 的任务进展触手可及。**
+**让宠物陪你处理 DeepSeek Harness 任务**
 
-[English](README.md) · [界面预览](#界面预览) · [功能概览](#功能概览) · [安装](#安装) · [使用](#使用) · [开发](#开发) · [更新日志](CHANGELOG.zh-CN.md)
+[English](README.md) · [更新日志](CHANGELOG.zh-CN.md) · [Apache-2.0](LICENSE)
 
-[![DSH Web Plugin](https://img.shields.io/badge/DSH%20Web-Plugin-0f766e.svg)](https://github.com/deepseek-ai/deepseek-harness)
+[![许可证：Apache-2.0](https://img.shields.io/badge/许可证-Apache--2.0-blue.svg)](LICENSE)
+[![npm package](https://img.shields.io/npm/v/%40michengai%2Fdsh-codex-pet.svg?label=npm%20package)](https://www.npmjs.com/package/@michengai/dsh-codex-pet)
+[![npm 下载量](https://img.shields.io/npm/dt/%40michengai%2Fdsh-codex-pet.svg?label=npm%20%E4%B8%8B%E8%BD%BD%E9%87%8F)](https://www.npmjs.com/package/@michengai/dsh-codex-pet)
+[![DSH Web Plugin](https://img.shields.io/badge/DSH%20Web-Plugin-0f766e.svg)](https://github.com/MichengAI/dsh-codex-pet)
 [![Node.js 22.19+](https://img.shields.io/badge/Node.js-22.19%2B-339933.svg?logo=node.js&logoColor=white)](https://nodejs.org/)
-[![开发预览版](https://img.shields.io/badge/Status-Development%20preview-d97706.svg)](#验证与当前边界)
 
 </div>
 
-DSH Codex Pet 为 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 提供宠物库、任务通知和基于 Skill 的宠物创建功能。全部 9 只 Codex 内置宠物图集随插件提供，使用人员无需安装 Codex。
+> DSH Codex Pet 是社区维护的 DeepSeek Harness（DSH）宠物插件，并非 OpenAI 或 DeepSeek AI 官方产品。
 
 ## 功能概览
 
+让宠物陪你处理 DSH 任务，随时查看会话进展和待处理请求。你可以选择内置宠物，也可以通过 Skill 创建自己的伙伴。
+
 - **9 只内置宠物**：在宠物设置中选择伙伴、调整大小，资源随插件本地打包。
-- **页内陪伴**：插件在 DSH Web 页面内显示宠物，并提供消费者接口；外部宿主自行适配窗口与 IPC。
+- **页内陪伴**：在 DSH 网页中陪伴工作；桌面浮窗需要使用支持宠物功能的桌面端。
 - **多会话动态**：查看运行中、完成、错误和待处理请求；没有通知时只显示宠物。
 - **就近处理任务**：从通知打开对应会话、停止当前轮次，或处理支持的审批、问题和计划请求。
 - **按需安静**：关闭单条提醒不会停止任务；通过菜单或设置收起、恢复宠物。
@@ -52,7 +56,7 @@ DSH Codex Pet 为 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-har
 
 ## DSH 产品生态
 
-为已有 DeepSeek Harness 环境按需安装插件；外部消费者可独立接入宠物接口。
+为已有 DeepSeek Harness 环境按需添加功能。
 
 | 插件 | 你可以用它做什么 |
 | --- | --- |
@@ -66,51 +70,18 @@ DSH Codex Pet 为 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-har
 | [Simplify](https://github.com/MichengAI/dsh-simplify) | 整理 Git 改动范围内的代码 |
 | [Codex Pet](https://github.com/MichengAI/dsh-codex-pet) | 宠物陪伴，查看和处理任务通知 |
 
-## 前置条件
-
-- 已安装 DeepSeek Harness，可使用 Web 界面和 `dsh` 命令。
-- 从源码构建需要 **Node.js 22.19 或更高版本**。
-- 创建自定义宠物需要在 DSH 中配置可用的图像生成工具。
-
 ## 安装
 
-兼容要求：宿主必须提供 `locale` 客户端服务，并支持函数形式的 `settings.section` 标签。本地契约核验使用 `@deepseek-ai/cordis 4.0.2`、`@deepseek-ai/dsh-client-locale 0.1.2-rc.1` 及社区 DSH Codex UI 设置实现。这些是已核验组件版本，不代表已经验证的最低 DSH 版本；不支持缺少 locale 服务的宿主。
-
-自动更新命令使用 `--config.minimumReleaseAge=0`，以便立即安装刚发布的版本；该参数仅对本次安装跳过 pnpm 的发布时间等待，不改写全局配置。包名、npm registry 和解析后的版本仍由服务端固定。
-
-v0.1.2 安装包包含本文描述的设置、本地化、npm 更新器和消费者接口改动，详见[更新日志](CHANGELOG.zh-CN.md)。
-
-当前版本为 **0.1.2**，通过 [npm](https://www.npmjs.com/package/@michengai/dsh-codex-pet) 安装；版本记录见 [GitHub Releases](https://github.com/MichengAI/dsh-codex-pet/releases)。以下命令使用 `web` profile，请按实际环境替换。
-
-执行 `dsh plugin --profile web add @michengai/dsh-codex-pet@latest --registry=https://registry.npmjs.org/ --ignore-scripts`，然后重新加载 DSH。也可按下面的步骤从源码构建。
-
-### 让 Agent 帮你安装
-
-```text
-请从我的本地源码目录将 DSH Codex Pet 安装到 DSH 的 web profile。在源码目录依次执行 npm ci、npm run check、npm test 和 npm pack。检查通过后，执行 dsh plugin --profile web add .\michengai-dsh-codex-pet-0.1.2.tgz --ignore-scripts 安装生成的包，再执行 dsh --profile web --dump-config，确认包含 michengai-codex-pet。说明如何重新加载 DSH 并打开宠物设置，保留已有任务和用户数据。
-```
-
-### 手动构建并安装
-
-在项目根目录执行：
+支持 DeepSeek Harness **`0.1.0-rc.8`、`0.1.1-rc.2`、`0.1.2-rc.1`、`0.1.5-rc.1`、`0.1.5-rc.2`**，需要可使用 `dsh` 命令。新增兼容不移除这些旧版。以下示例使用 `web` profile，请按实际环境替换。
 
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
 $OutputEncoding = [System.Text.Encoding]::UTF8
 
-npm ci
-npm run check
-npm test
-npm pack
-dsh plugin --profile web add .\michengai-dsh-codex-pet-0.1.2.tgz --ignore-scripts
-dsh --profile web --dump-config
+dsh plugin --profile web add @michengai/dsh-codex-pet@latest --registry=https://registry.npmjs.org/ --ignore-scripts
 ```
 
-任一步骤失败时先停止并解决错误。`npm pack` 会构建插件并检查 9 只图集和创建 Skill，生成的安装包包含运行所需资源。
-
-### 重新加载
-
-等待正在执行的任务结束后，重启对应 DSH Web 服务并刷新页面。仅刷新浏览器不能替换已经加载的 Host 模块。
+安装后重启 DSH，再打开 **设置 → 宠物**。
 
 ## 使用
 
@@ -129,6 +100,8 @@ dsh --profile web --dump-config
 
 宠物承担通知和待处理操作。新建会话、输入后续消息仍在 DSH 主界面完成。
 
+已知上游边界：DSH `0.1.5-rc.2` 在模型尚未返回 HTTP 响应时停止任务，可能因 `turn/end` 数据不可 JSON 序列化而上报错误，宠物会显示失败通知。已开始流式响应时的停止操作已通过端到端验证。
+
 ### 创建自定义宠物
 
 1. 打开宠物设置，点击 **创建**，描述想要的伙伴。
@@ -136,24 +109,13 @@ dsh --profile web --dump-config
 3. 在该任务中查看进展，创建使用 DSH 当前配置的模型和图像工具。
 4. 宠物文件生成并保存后，刷新宠物库并选择新伙伴。
 
-随包 `skills/hatch-pet/SKILL.md` 已针对 DSH 和兼容图集格式适配，创建流程不调用 Codex CLI。缺少生图工具时需要先完善 DSH 配置；成功打开创建任务不等于宠物已经生成。
-
-## 数据与资源
+创建宠物需要先在 DSH 中配置图像生成工具。
 
-- 内置图集：`assets/codex/`，随插件提供。
-- 自定义宠物：`${DSH_HOME}\codex-pet\pets`；未设置 `DSH_HOME` 时，以用户目录下的 `.dsh` 为基础目录。
-- 不自动读取、移动或迁移原有 Codex 宠物。
-- 卸载插件会保留自定义宠物文件和配置。
+## 更新与卸载
 
-插件代码独立实现、由社区维护。随包 Codex 宠物图集来源于 Codex，并非本项目原创素材。本项目不是 OpenAI 或 DeepSeek 官方产品。
+在 **设置 → 宠物 → 检查更新** 中更新。若当前环境不支持在线安装，可复制界面提供的更新命令。等待正在运行的任务结束后操作，完成后按提示重启 DSH。
 
-原创插件代码采用与同系列插件一致的 [Apache-2.0 许可证](LICENSE)。第三方宠物素材不属于本项目授予的许可范围，详见 [NOTICE](NOTICE)。
-
-## 插件更新
-
-宠物设置页显示当前运行版本、GitHub 和问题反馈链接，以及**检查更新**入口。更新器查询 npm，通过已验证的 DSH CLI 安装到当前 profile；npm 尚未发布时会明确提示。宿主不支持在线安装时，可复制手动更新命令。请等待任务结束后更新，并按提示重新加载 DSH。
-
-## 卸载
+卸载命令：
 
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
@@ -162,59 +124,29 @@ $OutputEncoding = [System.Text.Encoding]::UTF8
 dsh plugin --profile web remove @michengai/dsh-codex-pet
 ```
 
-完成后重新加载 DSH。切换版本时保留 DSH 数据目录。
+自定义宠物默认保存在用户目录的 `.dsh/codex-pet/pets` 下，可从宠物设置打开。设置了 `DSH_HOME` 时使用该目录下的 `codex-pet/pets`。卸载插件会保留这些文件与配置。
 
-## 开发
+## 开发验证
+
+开发依赖和锁文件固定 DSH `0.1.5-rc.2`。使用 `npm ci` 复现，`npm run check` 同时检查插件与官方服务类型的兼容性。
 
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
 $OutputEncoding = [System.Text.Encoding]::UTF8
-
 npm ci
+npx playwright install chromium
 npm run check
 npm test
-npm run build
+npm run smoke
+npm run test:e2e
 ```
 
-- `src/`：Host 服务、宠物设置、动画和任务通知。
-- `skills/`：随包宠物创建 Skill。
-- `test/`：宠物库、创建和通知回归测试。
-- `scripts/`：构建、资源维护、安装包校验和隔离 Electron smoke 检查。
-- `lib/`：生成的运行产物，修改源码应在 `src/` 中进行。
-
-项目不提供独立 HTML 预览页或原生窗口入口，请在 DSH 内验证。`assets:import` 仅供维护者更新原始资源，使用者安装时无需执行。
-
-使用 CodeGraph 时，首次运行 `codegraph init .`，修改后运行 `codegraph sync .`，通过 `codegraph status .` 检查索引新鲜度。索引与 `docs/` 下的本地项目文档均不纳入 Git。
-
-## 验证与当前边界
-
-类型检查、25 项自动化测试、构建和受控浏览器客户端交互验证已通过，覆盖任务通知和创建请求流程。完整图像生成、真实模型任务联动及真实 npm 更新仍待端到端验收。
-
-
-
-## 浏览器冒烟测试
-
-执行 `npm ci` 后，运行 `npx playwright install chromium`，再执行 `npm run smoke`。Playwright 是本项目的开发依赖，测试使用无头 Chromium 和独立系统临时目录，测试进程退出后自动清理；不需要 Electron、相邻仓库、`.preview` 或 docs 输出。
-
-## 消费者接口 v1
-
-插件在 DSH 页面提供 `window.dshPet`，发布 `dsh-pet-ready` / `dsh-pet-disposed` 事件。消费者主动订阅和展示，插件不导入或探测消费者。旧原生窗口路由与窗口桥接已移除，已有原生适配需迁移到此接口。
-
-| 方法 | 约定 |
-| --- | --- |
-| `getSnapshot()` | 返回独立副本 `{pet, config, language, notifications}`；未加载或卸载后为 `null`。宠物资源相对 URL 按 DSH 页面 origin 解析。 |
-| `subscribe(listener)` | 内容变化时通知，卸载时收到 `null`；返回退订函数。初始状态另行调用 getSnapshot。 |
-| `command(value)` | 执行通知操作：open、stop、dismiss、restore、approve、reject、answer、sort。目标操作携带当前通知 id、token；请求回答另带 requestKey。校验和拒绝由插件执行。 |
-| `updateConfig(value)` | 通过现有 Host 校验接口更新宠物设置。 |
-| `openSettings()` | 在 DSH 打开宠物设置。 |
-| `acquireDisplay()` | 暂时隐藏页内浮层，返回幂等释放函数。消费者断开时必须释放，所有接管者释放后恢复页内显示，不改持久化可见性配置。 |
-
-消费者负责自身渲染器、原生窗口、IPC 校验和断开清理；接口不携带原生窗口实现。用户标题、问题与回答选项保持原文，language 字段提供显示语言。
+端到端测试另需 PATH 中有 pnpm（CI 使用 `11.25.0`）。它通过官方 CLI 安装本地发行包、启动完整 DSH Web，验证宠物设置、持久化、创建会话、提问回传、完成与失败通知和停止任务。只有外部模型 HTTP 服务使用本地夹具，不调用付费模型或生成图片。测试使用独立 `DSH_HOME`，日志和截图保存在忽略的 `.preview/e2e-latest-*` 下，不改动日常 Profile。
 
-## 自动发布
+官方类型检查验证结构兼容性，不替代服务生命周期验证。E2E 拆为独立 CI job，限时 25 分钟；发布前必须验证标签提交对应的 main push CI 成功，且全部 5 个宿主版本的中英文 job 均通过；先等待 CI，再打标签，缺失、运行中、跳过或失败的检查都会阻止发布。Windows Profile 链接错误（`EBUSY`）在共享的 120 秒启动预算内每次等待 5 秒后重试，关闭进程最多另需 10 秒；这只缓解瞬时竞争，不代表 Windows 已稳定，其他错误直接失败。报告同时保留语言、原始失败、重试记录及独立清理错误。通过 PowerShell（Windows 使用 `powershell.exe`，其他平台使用 `pwsh`）保留最近 5 次已标记并结束的运行；未标记的历史证据、未结束运行及含 `.keep` 文件的目录不回收，清理不跟随目录链接。发布验收证据应在后续运行前添加 `.keep`。
 
-GitHub Actions 在 main 推送与 PR 上运行类型检查、单元测试、Chromium 冒烟及完整包校验。推送与 package.json 一致的正式版本标签（例如 v0.1.2）后，publish.yml 重新验证并通过 npm OIDC 发布；成功后从两份 CHANGELOG 提取对应版本内容，生成中文在前、英文在后的正式 Latest Release，不附加 tgz 或校验文件。
+可设置 `DSH_PET_E2E_LOCALE` 为 `zh-CN`（默认）或 `en-US` 选择浏览器语言，CI 对全部 5 个版本分别验证两种语言。设置 `DSH_PET_E2E_VERSION` 可选择旧版宿主，其完整官方依赖图在隔离目录内精确安装，开发依赖继续保持 rc.2。可通过 `DSH_PET_E2E_ROOT` 指向另一个名为 `.preview` 的独立目录，将测试宿主和证据放到其他磁盘。
 
-首次启用需在 npm 包 Settings 的 Trusted Publisher 中选择 GitHub Actions，填写组织/用户 MichengAI、仓库 dsh-codex-pet、工作流文件 publish.yml，Environment 留空。不需要 NPM_TOKEN。此 npm 端绑定必须完成后才能发布；本仓库工作流无法替 npm 创建该信任关系。
+## 许可证
 
-发布前同步 package.json、package-lock.json 和双语 CHANGELOG，再提交并推送新版本标签。已发布的 npm 版本不可覆盖，修复需递增版本。CI 可通过 workflow_dispatch 手动运行，不会发布包。
+原创插件代码采用 [Apache License 2.0](LICENSE)。随包宠物图集来源于 OpenAI Codex，不属于本项目授予的 Apache-2.0 许可范围，详见 [NOTICE](NOTICE)。

package/lib/client.js

@@ -37,6 +37,140 @@ __export(client_exports, {
 });
 module.exports = __toCommonJS(client_exports);
 
+// src/session-compat.ts
+function compatibleSessions(sessions) {
+  const cache = /* @__PURE__ */ new WeakMap();
+  return {
+    list: sessions.list,
+    open: (id) => sessions.open(id),
+    create: (options) => sessions.create(options),
+    binding(id) {
+      const binding = sessions.binding(id);
+      if (!binding || binding.eventSource) return binding;
+      const cached = cache.get(binding);
+      if (cached) return cached;
+      let lastSeq = -1, initialized = false;
+      let snapshot = { revision: 0, change: { kind: "replace", entries: [] } };
+      const eventSource = {
+        getSnapshot() {
+          const state = binding.session.getSnapshot();
+          if (state.openState === "cold" || state.openState === "loading") initialized = false;
+          const events = [...state.chat?.timeline.turns.values() ?? []].flatMap((turn) => [turn.start, turn.end]).filter((entry) => !!entry).sort((a, b) => a.seq - b.seq);
+          const additions = events.filter((entry) => entry.seq > lastSeq);
+          if (additions.length) {
+            lastSeq = additions.at(-1).seq;
+            snapshot = { revision: snapshot.revision + 1, change: { kind: initialized ? "append" : "replace", entries: additions.map((entry) => ({ type: "event", event: entry })) } };
+          }
+          initialized = state.openState === void 0 || state.openState === "open";
+          return snapshot;
+        },
+        subscribe: (listener) => binding.session.subscribe(listener)
+      };
+      const adapted = { ...binding, eventSource };
+      cache.set(binding, adapted);
+      return adapted;
+    }
+  };
+}
+
+// src/legacy-pending.ts
+function compatiblePending(sessions, resolveModern) {
+  const legacy = legacyPending(sessions);
+  const listeners = /* @__PURE__ */ new Set();
+  let source = legacy;
+  let off;
+  let timer;
+  const notify = () => {
+    for (const listener of listeners) listener();
+  };
+  const sync = () => {
+    const next = resolveModern() ?? legacy;
+    if (next === source && off) return;
+    off?.();
+    source = next;
+    off = listeners.size ? source.subscribe(notify) : void 0;
+    notify();
+  };
+  return {
+    getSnapshot: () => source.getSnapshot(),
+    subscribe(listener) {
+      listeners.add(listener);
+      if (!timer) {
+        sync();
+        timer = setInterval(sync, 250);
+      }
+      return () => {
+        listeners.delete(listener);
+        if (!listeners.size) {
+          clearInterval(timer);
+          timer = void 0;
+          off?.();
+          off = void 0;
+        }
+      };
+    }
+  };
+}
+function legacyPending(sessions) {
+  const listeners = /* @__PURE__ */ new Set();
+  const subscriptions = /* @__PURE__ */ new Map();
+  let snapshot = /* @__PURE__ */ new Map();
+  let offList;
+  const refresh = () => {
+    const list = sessions.list.getSnapshot();
+    for (const [id, item] of subscriptions) if (!list.byId[id] || list.byId[id].origin === "subagent") {
+      item.off();
+      subscriptions.delete(id);
+    }
+    const next = /* @__PURE__ */ new Map();
+    for (const id of list.ids) {
+      if (list.byId[id]?.origin === "subagent") continue;
+      const source = sessions.binding(id)?.session;
+      if (!source) continue;
+      if (listeners.size && subscriptions.get(id)?.source !== source) {
+        subscriptions.get(id)?.off();
+        subscriptions.set(id, { source, off: source.subscribe(refresh) });
+      }
+      const wait = source.getSnapshot().pending?.[0];
+      if (!wait) continue;
+      next.set(id, {
+        kind: wait.kind,
+        key: wait.key,
+        sessionId: wait.sessionId,
+        ...wait.payload,
+        async answer(answer) {
+          if (wait.sessionId !== id || !source.getSnapshot().pending?.includes(wait)) throw new Error("\u8BF7\u6C42\u5DF2\u7ED3\u675F\u6216\u5DF2\u66F4\u6362");
+          const normalized = wait.kind === "question" ? { answers: answer.answers.map(({ custom, ...item }) => ({ ...item, ...custom?.trim() ? { custom: custom.trim() } : {} })) } : answer;
+          const value = wait.kind === "approval" ? { sessionId: id, approvalId: wait.payload.approvalId, outcome: answer } : { sessionId: id, answer: normalized };
+          const receipt = await wait.respond({ ok: true, value });
+          if (!receipt.accepted) throw new Error(receipt.reason ?? "\u5BBF\u4E3B\u62D2\u7EDD\u54CD\u5E94");
+        }
+      });
+    }
+    snapshot = next;
+    for (const listener of listeners) listener();
+  };
+  return {
+    getSnapshot: () => snapshot,
+    subscribe(listener) {
+      listeners.add(listener);
+      if (!offList) {
+        offList = sessions.list.subscribe(refresh);
+        refresh();
+      }
+      return () => {
+        listeners.delete(listener);
+        if (!listeners.size) {
+          offList?.();
+          offList = void 0;
+          for (const item of subscriptions.values()) item.off();
+          subscriptions.clear();
+        }
+      };
+    }
+  };
+}
+
 // src/companion-api.ts
 function createCompanionProvider(handlers) {
   let snapshot = null, active = true, displays = 0, signature = "null";
@@ -759,7 +893,7 @@ function PluginUpdateHeader({ locale }) {
         zh2 ? "\u5BA0\u7269" : "Pets",
         /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("span", { className: "dcp-version", children: [
           "v",
-          "0.1.2"
+          "0.1.4"
         ] })
       ] }),
       /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("nav", { className: "dcp-project-links", children: [
@@ -1977,7 +2111,7 @@ function observePetSettingsIcon() {
 // src/client.tsx
 var import_jsx_runtime4 = require("react/jsx-runtime");
 var name = "michengai-codex-pet";
-var inject = ["slots", "sessions", "uiSession", "locale"];
+var inject = ["slots", "sessions", "locale"];
 function openSettings() {
   const trigger = document.querySelector("[data-dcu-settings-trigger]");
   if (trigger)
@@ -2150,6 +2284,11 @@ function Page({
   );
 }
 function apply(ctx) {
+  const sessions = compatibleSessions(ctx.sessions);
+  const pending = compatiblePending(sessions, () => {
+    const service = ctx.reflect ? ctx.reflect.get("uiSession") : ctx.uiSession;
+    return service?.pendingInteractions;
+  });
   ctx.slots.inject(
     "settings.section",
     () => ctx.slots.register(
@@ -2159,7 +2298,7 @@ function apply(ctx) {
         label: () => translator(ctx.locale.getSnapshot().active)("\u5BA0\u7269"),
         order: 12
       },
-      () => /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(Page, { sessions: ctx.sessions, locale: ctx.locale })
+      () => /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(Page, { sessions, locale: ctx.locale })
     )
   );
   ctx.slots.inject(
@@ -2169,8 +2308,8 @@ function apply(ctx) {
       () => /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
         Overlay,
         {
-          sessions: ctx.sessions,
-          pending: ctx.uiSession.pendingInteractions,
+          sessions,
+          pending,
           locale: ctx.locale
         }
       )

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@michengai/dsh-codex-pet",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "license": "Apache-2.0",
   "description": "独立实现的 DSH 宠物插件：Codex 原始宠物库、Skill 创建、Web 页内显示与消费者接入接口",
   "type": "module",
@@ -43,9 +43,8 @@
     "client": {
       "platform": "web",
       "inject": [
-        "@deepseek-ai/dsh-client-runtime",
-        "@deepseek-ai/dsh-client-ui-slots",
-        "@deepseek-ai/dsh-client-ui-session",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-renderer",
         "@deepseek-ai/dsh-client-locale"
       ]
     }
@@ -54,15 +53,30 @@
     "prepack": "npm run build && tsx scripts/verify-package.ts",
     "build": "node scripts/build.mjs",
     "check": "tsc --noEmit",
-    "test": "tsx --test test/*.test.ts",
+    "test": "tsx --test test/*.test.ts test/*.test.mjs",
+    "test:e2e": "node scripts/e2e-latest.mjs",
     "smoke": "npm run build && node scripts/run-smoke.cjs",
     "assets:import": "tsx scripts/import-codex.ts"
   },
   "peerDependencies": {
+    "@deepseek-ai/dsh-host-webserver": "0.1.0-rc.8 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-host-webserver": {
+      "optional": true
+    }
+  },
   "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.2",
+    "@deepseek-ai/dsh": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-api-session-controller": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-locale": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-session": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-host-webserver": "0.1.5-rc.2",
     "@electron/asar": "^3.4.1",
     "@radix-ui/react-icons": "^1.3.2",
     "@types/node": "^24.0.0",