@michengai/dsh-codex-pet 0.1.4 → 0.1.6

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## [0.1.6] - 2026-09-16
+
+- Add compatibility with DSH `0.1.6-alpha.1` without dropping the existing supported hosts. Pin development types and the default e2e host to this release.
+
+## [0.1.5] - 2026-09-12
+
+- Keep the pet in a global Web overlay across pages while preserving interaction and letting clicks pass through empty areas.
+- Showing the pet on Codex UI settings pages requires Codex UI 1.1.3 or later. The pet still works independently without Codex UI.
+
 ## [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.

package/CHANGELOG.zh-CN.md

@@ -1,5 +1,14 @@
 # 更新日志
 
+## [0.1.6] - 2026-09-16
+
+- 新增 DSH `0.1.6-alpha.1` 兼容，不移除已支持的旧宿主。开发类型检查和默认端到端宿主固定到该版本。
+
+## [0.1.5] - 2026-09-12
+
+- 宠物改为在整个 Web 页面内悬浮，切换页面时保留显示和交互，空白区域不阻挡页面操作。
+- 在 Codex UI 设置页显示宠物需要同时升级 Codex UI 至 1.1.3 或更新版本；未安装 Codex UI 时仍可独立使用。
+
 ## [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`；适配旧版会话请求，使宠物通知可处理旧宿主的提问和审批。

package/README.md

@@ -56,23 +56,25 @@ Keep working in DSH while the pet and task notifications remain in the corner of
 
 ## DSH product ecosystem
 
-Add plugins as needed to your existing DeepSeek Harness environment.
+For a desktop workbench, download [DSH Codex Desktop](https://github.com/MichengAI/dsh-codex-desktop/releases). Existing [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) installations can add plugins as needed by following each project's README. Below are 11 first-party plugins; consult the corresponding desktop release notes and bundled catalog for what that version includes.
 
 | Plugin | What you can do |
 | --- | --- |
-| [Codex UI](https://github.com/MichengAI/dsh-codex-ui) | Organize projects and conversations and navigate tasks |
-| [IM Connect](https://github.com/MichengAI/dsh-im-connect) | Send tasks and receive replies through messaging platforms |
-| [Automation](https://github.com/MichengAI/dsh-automation) | Schedule tasks and review their runs |
+| [Codex UI](https://github.com/MichengAI/dsh-codex-ui) | Organize projects and conversations, search tasks, and navigate chat turns |
+| [Agency Agents](https://github.com/MichengAI/dsh-agency-agents) | Choose and summon specialists for your task |
 | [Skills Manager](https://github.com/MichengAI/dsh-skills-manager) | Find, enable, create, and import local skills |
-| [Archive Manager](https://github.com/MichengAI/dsh-archive-manager) | Search, restore, and manage archived conversations |
-| [Agency Agents](https://github.com/MichengAI/dsh-agency-agents) | Choose specialists for a task |
-| [BTW](https://github.com/MichengAI/dsh-btw) | Ask side questions in the current context |
-| [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 |
+| [Archive Manager](https://github.com/MichengAI/dsh-archive-manager) | Search, restore, or clean up archived conversations |
+| [IM Connect](https://github.com/MichengAI/dsh-im-connect) | Send tasks and receive replies through messaging platforms |
+| [Automation](https://github.com/MichengAI/dsh-automation) | Schedule tasks and review each run |
+| [BTW](https://github.com/MichengAI/dsh-btw) | Ask side questions without interrupting the main task |
+| [Simplify](https://github.com/MichengAI/dsh-simplify) | Use `/simplify` to improve code within your Git changes |
+| [PUA](https://github.com/MichengAI/dsh-pua) | Guide the Agent to try new approaches after failures, investigate causes, and verify results before completion |
+| [Code Review](https://github.com/MichengAI/dsh-code-review) | Use `/review` to request an independent Agent code review and receive the report in the current conversation |
+| [Codex Pet](https://github.com/MichengAI/dsh-codex-pet) | View conversation notifications and respond to tool approvals and questions through a desktop pet |
 
 ## Installation
 
-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.
+Supported DeepSeek Harness versions: **`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`, and `0.1.6-alpha.1`**. 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
@@ -100,7 +102,7 @@ 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.
+Known issue: in DSH `0.1.5-rc.2`, stopping a task before the model starts responding may cause the pet to show a failure notification.
 
 ### Create a custom pet
 
@@ -126,26 +128,9 @@ dsh plugin --profile web remove @michengai/dsh-codex-pet
 
 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 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 smoke
-npm run test:e2e
-```
-
-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.
-
-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.
+## Contributing
 
-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.
+See the [development and validation guide (Chinese)](https://github.com/MichengAI/dsh-codex-pet/blob/main/CONTRIBUTING.md) for local development, testing, and release procedures.
 
 ## License
 

package/README.zh-CN.md

@@ -56,23 +56,25 @@
 
 ## DSH 产品生态
 
-为已有 DeepSeek Harness 环境按需添加功能。
+想使用桌面工作台，可下载 [DSH Codex Desktop](https://github.com/MichengAI/dsh-codex-desktop/releases)；已有 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 环境，可按各项目 README 按需安装。以下列出 11 个自研插件；桌面端实际随附范围以对应版本的发行说明和内置清单为准。
 
 | 插件 | 你可以用它做什么 |
 | --- | --- |
-| [Codex UI](https://github.com/MichengAI/dsh-codex-ui) | 整理项目与会话，导航任务 |
+| [Codex UI](https://github.com/MichengAI/dsh-codex-ui) | 整理项目与会话、搜索任务、跳转对话轮次 |
+| [Agency Agents](https://github.com/MichengAI/dsh-agency-agents) | 按任务选择并召唤专业角色 |
+| [Skills Manager](https://github.com/MichengAI/dsh-skills-manager) | 统一查找、启停、创建和导入本机技能 |
+| [Archive Manager](https://github.com/MichengAI/dsh-archive-manager) | 搜索、恢复或清理已归档会话 |
 | [IM Connect](https://github.com/MichengAI/dsh-im-connect) | 从消息平台下任务、收回复 |
-| [Automation](https://github.com/MichengAI/dsh-automation) | 按计划执行任务，查看运行结果 |
-| [Skills Manager](https://github.com/MichengAI/dsh-skills-manager) | 查找、启停、创建和导入本机技能 |
-| [Archive Manager](https://github.com/MichengAI/dsh-archive-manager) | 搜索、恢复和管理已归档会话 |
-| [Agency Agents](https://github.com/MichengAI/dsh-agency-agents) | 为任务选择专业角色 |
-| [BTW](https://github.com/MichengAI/dsh-btw) | 在当前上下文中临时旁问 |
-| [Simplify](https://github.com/MichengAI/dsh-simplify) | 整理 Git 改动范围内的代码 |
-| [Codex Pet](https://github.com/MichengAI/dsh-codex-pet) | 宠物陪伴，查看和处理任务通知 |
+| [Automation](https://github.com/MichengAI/dsh-automation) | 按计划执行任务，查看每次运行的结果 |
+| [BTW](https://github.com/MichengAI/dsh-btw) | 在当前上下文中临时旁问，不打断主任务 |
+| [Simplify](https://github.com/MichengAI/dsh-simplify) | 用 `/simplify` 整理 Git 改动范围内的代码 |
+| [PUA](https://github.com/MichengAI/dsh-pua) | 引导 Agent 在失败时换方法、查原因，并在完成前验证结果 |
+| [Code Review](https://github.com/MichengAI/dsh-code-review) | 用 `/review` 发起独立 Agent 代码审查，在当前会话接收报告 |
+| [Codex Pet](https://github.com/MichengAI/dsh-codex-pet) | 通过桌面宠物查看会话提醒、处理工具审批和问题回答 |
 
 ## 安装
 
-支持 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，请按实际环境替换。
+支持 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`、`0.1.6-alpha.1`**，需要可使用 `dsh` 命令。新增兼容不移除这些旧版。以下示例使用 `web` profile，请按实际环境替换。
 
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
@@ -100,7 +102,7 @@ dsh plugin --profile web add @michengai/dsh-codex-pet@latest --registry=https://
 
 宠物承担通知和待处理操作。新建会话、输入后续消息仍在 DSH 主界面完成。
 
-已知上游边界：DSH `0.1.5-rc.2` 在模型尚未返回 HTTP 响应时停止任务，可能因 `turn/end` 数据不可 JSON 序列化而上报错误，宠物会显示失败通知。已开始流式响应时的停止操作已通过端到端验证。
+已知问题：在 DSH `0.1.5-rc.2` 中，若模型尚未开始响应就停止任务，宠物可能显示失败通知。
 
 ### 创建自定义宠物
 
@@ -126,26 +128,9 @@ dsh plugin --profile web remove @michengai/dsh-codex-pet
 
 自定义宠物默认保存在用户目录的 `.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 smoke
-npm run test:e2e
-```
-
-端到端测试另需 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`。
-
-可设置 `DSH_PET_E2E_LOCALE` 为 `zh-CN`（默认）或 `en-US` 选择浏览器语言，CI 对全部 5 个版本分别验证两种语言。设置 `DSH_PET_E2E_VERSION` 可选择旧版宿主，其完整官方依赖图在隔离目录内精确安装，开发依赖继续保持 rc.2。可通过 `DSH_PET_E2E_ROOT` 指向另一个名为 `.preview` 的独立目录，将测试宿主和证据放到其他磁盘。
+本地开发、测试与发布流程见 [开发与验证指南](https://github.com/MichengAI/dsh-codex-pet/blob/main/CONTRIBUTING.md)。
 
 ## 许可证
 

package/lib/client.js

@@ -337,7 +337,7 @@ function translator(language) {
 }
 
 // src/client.tsx
-var import_react6 = require("react");
+var import_react7 = require("react");
 
 // src/library-store.ts
 function createLibraryStore(request2) {
@@ -893,7 +893,7 @@ function PluginUpdateHeader({ locale }) {
         zh2 ? "\u5BA0\u7269" : "Pets",
         /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("span", { className: "dcp-version", children: [
           "v",
-          "0.1.4"
+          "0.1.6"
         ] })
       ] }),
       /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("nav", { className: "dcp-project-links", children: [
@@ -2108,6 +2108,22 @@ function observePetSettingsIcon() {
   return () => observer.disconnect();
 }
 
+// src/global-overlay.tsx
+var import_react6 = require("react");
+var import_react_dom = require("react-dom");
+function GlobalOverlay({ children }) {
+  const [container, setContainer] = (0, import_react6.useState)(null);
+  (0, import_react6.useEffect)(() => {
+    const element = document.createElement("div");
+    element.setAttribute("data-dsh-pet-overlay", "");
+    element.style.cssText = "position:fixed;inset:0;z-index:2147483000;pointer-events:none";
+    document.body.append(element);
+    setContainer(element);
+    return () => element.remove();
+  }, []);
+  return container ? (0, import_react_dom.createPortal)(children, container) : null;
+}
+
 // src/client.tsx
 var import_jsx_runtime4 = require("react/jsx-runtime");
 var name = "michengai-codex-pet";
@@ -2131,23 +2147,23 @@ function Overlay({
 }) {
   const controller = usePetController(locale);
   const t = translator(controller.language);
-  const settingsDialog = (0, import_react6.useRef)(null);
-  (0, import_react6.useEffect)(() => {
+  const settingsDialog = (0, import_react7.useRef)(null);
+  (0, import_react7.useEffect)(() => {
     const show = () => {
       if (!settingsDialog.current?.open) settingsDialog.current?.showModal();
     };
     window.addEventListener("dcp-open-settings", show);
     return () => window.removeEventListener("dcp-open-settings", show);
   }, []);
-  const [state, setState] = (0, import_react6.useState)({
+  const [state, setState] = (0, import_react7.useState)({
     items: [],
     activity: IDLE,
     hidden: 0
   });
-  const notifications = (0, import_react6.useRef)(
+  const notifications = (0, import_react7.useRef)(
     null
   );
-  (0, import_react6.useEffect)(() => {
+  (0, import_react7.useEffect)(() => {
     const engine = createNotifications(sessions, pending, setState);
     notifications.current = engine;
     return () => {
@@ -2155,7 +2171,7 @@ function Overlay({
       engine.dispose();
     };
   }, [sessions, pending]);
-  (0, import_react6.useEffect)(observePetSettingsIcon, []);
+  (0, import_react7.useEffect)(observePetSettingsIcon, []);
   const command = async (value) => {
     const engine = notifications.current;
     if (!engine) throw new Error("\u4F1A\u8BDD\u670D\u52A1\u5C1A\u672A\u5C31\u7EEA");
@@ -2165,17 +2181,17 @@ function Overlay({
     }
     await engine.command(value);
   };
-  const [externalDisplay, setExternalDisplay] = (0, import_react6.useState)(false);
-  const actions = (0, import_react6.useRef)({
+  const [externalDisplay, setExternalDisplay] = (0, import_react7.useState)(false);
+  const actions = (0, import_react7.useRef)({
     command,
     updateConfig: controller.update,
     openSettings
   });
   actions.current = { command, updateConfig: controller.update, openSettings };
-  const provider = (0, import_react6.useRef)(
+  const provider = (0, import_react7.useRef)(
     null
   );
-  (0, import_react6.useEffect)(() => {
+  (0, import_react7.useEffect)(() => {
     const value = createCompanionProvider({
       command: (command2) => actions.current.command(command2),
       updateConfig: (config) => actions.current.updateConfig(config),
@@ -2192,7 +2208,7 @@ function Overlay({
       window.dispatchEvent(new Event("dsh-pet-disposed"));
     };
   }, []);
-  (0, import_react6.useEffect)(() => {
+  (0, import_react7.useEffect)(() => {
     const library = controller.library;
     provider.current?.publish(
       library ? {
@@ -2224,6 +2240,7 @@ function Overlay({
         className: "dcp dcp-dialog",
         "aria-label": t("\u5BA0\u7269\u8BBE\u7F6E"),
         style: {
+          pointerEvents: "auto",
           width: "min(800px, calc(100vw - 32px))",
           maxHeight: "85vh",
           overflow: "auto"
@@ -2305,14 +2322,14 @@ function apply(ctx) {
     "shell.overlay",
     () => ctx.slots.register(
       { name: "shell.overlay", id: "michengai-codex-pet", order: 100 },
-      () => /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+      () => /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(GlobalOverlay, { children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
         Overlay,
         {
           sessions,
           pending,
           locale: ctx.locale
         }
-      )
+      ) })
     )
   );
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@michengai/dsh-codex-pet",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "license": "Apache-2.0",
   "description": "独立实现的 DSH 宠物插件：Codex 原始宠物库、Skill 创建、Web 页内显示与消费者接入接口",
   "type": "module",
@@ -59,7 +59,7 @@
     "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",
+    "@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 || 0.1.6-alpha.1",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },
@@ -70,13 +70,13 @@
   },
   "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",
+    "@deepseek-ai/dsh": "0.1.6-alpha.1",
+    "@deepseek-ai/dsh-api-session-controller": "0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-locale": "0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-session": "0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.6-alpha.1",
+    "@deepseek-ai/dsh-host-webserver": "0.1.6-alpha.1",
     "@electron/asar": "^3.4.1",
     "@radix-ui/react-icons": "^1.3.2",
     "@types/node": "^24.0.0",