@michengai/dsh-codex-pet 0.1.4 → 0.1.5

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## [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,10 @@
 # 更新日志
 
+## [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

@@ -100,7 +100,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 +126,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
+## Contributing
 
-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.
-
-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

@@ -100,7 +100,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 +126,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.5"
         ] })
       ] }),
       /* @__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.5",
   "license": "Apache-2.0",
   "description": "独立实现的 DSH 宠物插件：Codex 原始宠物库、Skill 创建、Web 页内显示与消费者接入接口",
   "type": "module",