dsh-plugin-maoxuan-pet 0.2.3 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # CHANGELOG
 
+## 0.3.0 — 2026-11-01
+
+新能力：独立 macOS 桌宠壳——小毛从 DSH 界面里走出来，站到真正的桌面上；DSH 最小化甚至关掉界面，她都站在原地。
+
+### 桌宠壳（`desktop/`）
+- **为什么需要它**：Web 宠物是 `position:fixed` 的 DOM，永远画不出浏览器视口之外——DSH 最小化她就没。DSH 自带宠物能「跑出去」，是因为壳层进程建了第二个原生窗口（透明、置顶、跨所有 Space）。本壳用纯 Swift + 系统 WebKit（单文件约 450 行、零第三方依赖）给小毛配了同款独立窗口，进程独立于 DSH。
+- **窗口参数对照**（从 DSH Tauri 壳层二进制核实的参数 → 本壳实现）：`transparent`/`alwaysOnTop`/`visibleOnAllWorkspaces`/`skipTaskbar` → 透明无边框 `NSWindow` + `.floating` + `canJoinAllSpaces` + accessory 策略（不占 Dock、不进 Cmd-Tab）；`set_pet_input_region`/`set_pet_ignore_cursor_events` → 容器 `hitTest` 白名单矩形，矩形外鼠标事件全部穿透回桌面。
+- **数据通道**：`URLSession`（ephemeral）原生轮询既有同源路由——state 平时 20s、生成中 3s、离线 8s；`再督促`/`收起` POST 同源接口；宿主 `index.js` 零改动，Web 宠物照常并存。
+- **素材也走原生层**：WebKit 的 ATS 不认 loopback 豁免，`file://` 页面直挂 `http://127.0.0.1` 的图会被拦（只剩占位鲸），所以精灵图由 URLSession 拉取后转 data URL 注入（`window.__petSprites`）；WebKit 零网络请求，壳零磁盘写入（`nonPersistent` 数据存储 + ephemeral 会话）。
+- **交互语义与 Web 宠物一致**：红皮书卡片、新气泡自动弹出、打开 600ms 后标已读、翻书中状态、倒计时标签、`‹ ›` 回翻、Esc 收起；右键小毛 = 复位位置 / 退出；拖小毛或卡片标题栏 = 整窗移动（`screenX/screenY` 差值，无反馈回环），位置存 `UserDefaults`（suite `dsh-maoxuan-pet.window`）跨启动记忆。
+- **构建与运行**：`npm run pet:build`（swiftc 约几秒，模块缓存收进项目内）/ `npm run pet`；参数 `--origin=` / `--port=` / `--reset` / `--verbose`；详见 `desktop/README.md`。
+
+### 打包
+- `package.json` `files` 收录 `desktop/` 五个源码文件（Info.plist/README/build.sh/maoxuan-pet.swift/pet.html），源码随 npm 包分发；`desktop/build/` 构建产物（二进制 + Swift 模块缓存，约 70MB）不进包体——`.gitignore` 只拦 git 不拦 `npm pack`，files 白名单目录内的产物必须逐文件点名（0.3.0 发布前实测修正）。
+
 ## 0.2.3 — 2026-11-01
 
 首次安装修复：模型配置自动从宿主 profile 桥接进 headless 子进程，新装机基本零配置。

package/README.en.md

@@ -14,6 +14,22 @@ dsh plugin --profile web add dsh-plugin-maoxuan-pet
 Requirements: DSH `>=0.2.1-rc.2 <0.3.0`, Node `^22.19.0 || >=24.0.0`. Web shell only.
 Source install / uninstall / troubleshooting: [docs/INSTALL.md](docs/INSTALL.md).
 
+## Stand on the real desktop (macOS, optional)
+
+The web pet lives inside the DSH window and disappears when it is minimized — a hard browser
+sandbox boundary. `desktop/` ships a **standalone-process pet shell** (pure Swift + system
+WebKit, ~450 lines, zero dependencies): transparent, always-on-top, visible on all Spaces.
+Minimize DSH or close the window entirely — she stays. The plugin still owns the brain (the
+hourly essay reading); the shell only relocates the display.
+
+```bash
+npm run pet:build   # swiftc build, a few seconds
+npm run pet         # she stands at the bottom-right of your screen
+```
+
+Click to open the red-book card, drag to move (position is remembered), right-click for
+reset/quit. See [desktop/README.md](desktop/README.md) for details.
+
 ## Screenshot
 
 ![red-book bubble](https://raw.githubusercontent.com/yuna78/dsh-maoxuan-pet/main/docs/screenshot-hero.png)
@@ -70,7 +86,10 @@ fan-made character; not affiliated with DeepSeek.
 
 ## Known limitations
 
-- web shell only (`dsh.client.platform: web`) — no pet in the terminal / TUI;
+- web pet only (`dsh.client.platform: web`) — no pet in the terminal / TUI; on macOS use the
+  desktop shell above to leave the window;
+- the desktop shell is macOS-only (system WebKit); Windows / Linux need a Tauri 2 / Electron
+  shell — `pet.html` can be reused as-is;
 - the timer only runs while this `dsh web` process is alive; a stopped process does not catch up,
   and on restart `nextRunAt` decides whether to run once more;
 - each headless generation is a fresh session (no shared context): stable, but she "doesn't

package/README.md

@@ -1,4 +1,4 @@
-# 鲸鱼娘 · 小毛 —— 住在 DSH 右下角、每小时陪你读一篇毛选的桌宠
+# 鲸鱼娘 · 小毛 —— 每小时陪你读一篇毛选的桌宠，macOS 上还能站上真正的桌面
 
 红皮书气泡 + 四帧立绘；每条内容 = 原文引文（带来源日期）＋ 一句说给你听的督促 ＋ 一条能当天验证的启示，整条 ≤ 200 字。
 
@@ -13,6 +13,17 @@ dsh plugin --profile web add dsh-plugin-maoxuan-pet
 - 要求：DSH `>=0.2.1-rc.2 <0.3.0`、Node `^22.19.0 || >=24.0.0`，仅 Web 界面；
 - 从源码安装、卸载、排错：[docs/INSTALL.md](docs/INSTALL.md)。
 
+## 让她站上真正的桌面（macOS，可选）
+
+Web 宠物住在 DSH 界面里，界面最小化她就跟着没了——这是浏览器沙箱的硬边界。`desktop/` 目录自带一个**独立进程的桌宠壳**（纯 Swift + 系统 WebKit，约 450 行、零依赖）：透明、置顶、跨所有桌面空间，DSH 最小化甚至关掉界面她都站着；毛选的灵魂（每小时读一篇）仍由插件负责，壳只把「显示器」搬了出来。
+
+```bash
+npm run pet:build   # swiftc 编译，几秒
+npm run pet         # 她就站在屏幕右下角了
+```
+
+点她开合红皮书卡片、拖她换位置（下次还在那儿）、右键她 = 复位位置 / 退出。详见 [desktop/README.md](desktop/README.md)。
+
 ## 界面
 
 ![红皮书气泡](https://raw.githubusercontent.com/yuna78/dsh-maoxuan-pet/main/docs/screenshot-hero.png)
@@ -67,7 +78,8 @@ dsh plugin --profile web add dsh-plugin-maoxuan-pet
 
 ## 已知限制
 
-- 只支持 Web 界面（`dsh.client.platform: web`），终端 / TUI 里没有宠物；
+- Web 宠物只支持 Web 界面（`dsh.client.platform: web`），终端 / TUI 里没有宠物；macOS 想让她离开界面，用上面的桌宠壳；
+- 桌宠壳仅 macOS（系统 WebKit）；Windows / Linux 需要 Tauri 2 / Electron 起同款壳，`pet.html` 可直接复用；
 - 定时器只在这个 `dsh web` 进程活着时走；进程停了不会补跑，重启后按 `nextRunAt` 决定是否补一次；
 - headless 生成每次是独立会话（不复用上下文）：稳定，但「不记得昨天说过什么」——所以 prompt 里带最近 6 条督促来避免重复。
 

package/desktop/Info.plist

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleIdentifier</key>
+	<string>dev.yuna.dsh-maoxuan-pet.shell</string>
+	<key>CFBundleName</key>
+	<string>maoxuan-pet</string>
+	<key>CFBundlePackageType</key>
+	<string>APPL</string>
+	<!-- 透明窗要画的宿主数据走 http://127.0.0.1，必须放开 ATS -->
+	<key>NSAppTransportSecurity</key>
+	<dict>
+		<key>NSAllowsArbitraryLoads</key>
+		<true/>
+	</dict>
+	<key>NSHighResolutionCapable</key>
+	<true/>
+</dict>
+</plist>

package/desktop/README.md

@@ -0,0 +1,74 @@
+# 桌面壳：让小毛跑出 DSH 窗口（macOS）
+
+DSH 自带宠物之所以能「跑出去」，是因为它**根本不在网页里**——壳层 Rust 进程建了第二个
+原生窗口（透明、置顶、跨所有 Space）。网页（无论浏览器还是 iframe）永远画不出视口之外，
+这是浏览器沙箱的硬边界。
+
+本目录给「鲸鱼娘·小毛」配了一个**独立的原生壳**：进程独立于 DSH，DSH 主窗口最小化、
+甚至 Web 界面整个关掉，她都站在桌面上。毛选的灵魂（每小时一篇的 headless 生成）
+仍由 `index.js` 宿主插件负责，壳只是把「显示器」搬了出来。
+
+## 架构
+
+```
+┌─ DSH 宿主（照旧，什么都不用改） ─────────────┐
+│ index.js 插件：每小时 headless 读毛选 →     │
+│ GET  /api/dsh-maoxuan-pet.state             │
+│ POST /api/dsh-maoxuan-pet.generate|dismiss  │
+│ GET  /api/dsh-maoxuan-pet.asset?name=…      │
+└──────────────┬──────────────────────────────┘
+               │  URLSession 原生轮询（绕开 WKWebView 跨域）
+┌──────────────┴──────────────────────────────┐
+│ maoxuan-pet（独立 Swift 进程）               │
+│ · 透明无边框 NSWindow，.floating 置顶，      │
+│   canJoinAllSpaces（所有桌面/全屏旁可见）    │
+│ · WKWebView 渲染 pet.html（宠物+红皮书卡片） │
+│ · hitTest 白名单矩形 = 点击穿透              │
+│   （等价 dsh-tauri 的 set_pet_input_region） │
+│ · 拖拽/位置持久化/右键菜单/退出              │
+└─────────────────────────────────────────────┘
+```
+
+对照 DSH 自带宠物窗口（从壳层二进制里核实到的参数）：
+`transparent` / `alwaysOnTop` / `visibleOnAllWorkspaces` / `skipTaskbar` /
+`set_pet_input_region` / `set_pet_ignore_cursor_events` / 位置持久化到 store——
+本壳一一对应，只是把宿主从 Tauri 换成了一个几十 KB 的独立进程。
+
+## 构建与运行
+
+```sh
+npm run pet:build      # swiftc 编译（约几秒，产物 desktop/build/maoxuan-pet）
+npm run pet            # 编译并前台运行（Ctrl-C 或右键小毛→退出）
+```
+
+参数：
+
+| 参数 | 说明 |
+| --- | --- |
+| `--origin=URL` | 宿主地址，默认 `http://127.0.0.1:3081` |
+| `--port=N` | 等价 `--origin=http://127.0.0.1:N` |
+| `--reset` | 忽略保存的位置，回到屏幕右下 |
+| `--verbose` | 向 stderr 打轮询/POST/输入区日志 |
+
+无 Dock 图标、不进 Cmd-Tab（`NSActivationPolicy.accessory`）。窗口位置存在
+`UserDefaults`（suite `dsh-maoxuan-pet.window`），拖到哪儿下次就在哪儿。
+
+## 交互
+
+- **点小毛**：开合红皮书卡片；新气泡照样自动弹出、600ms 后自动标记已读——与 web 版同语义。
+- **拖小毛或卡片标题栏**：整窗移动；原地松手才算点击（>4px 判定为拖拽）。
+- **右键小毛**：复位位置 / 退出小毛。
+- **Esc**：收起卡片。
+- 宿主不在时：圆点变红、卡片内提示「连接中断，重试中…」，人继续站着。
+
+## 已知边界
+
+- 仅 macOS（用系统 WebKit，零第三方依赖）。Windows/Linux 想要同款，
+  照 `docs/` 里 dsh-tauri 的窗口参数用 Tauri 2 或 Electron 起一个同样的壳即可，
+  页面（pet.html）不用改——它只依赖 `__petState/__petSprites/__petOffline/__petActionDone`
+  几个注入点和 `webkit.messageHandlers.pet` 一个消息通道。
+- **精灵图走原生层转 data URL**：WebKit 的 ATS 不认 loopback 豁免，
+  `file://` 页面直挂 `http://127.0.0.1` 的图会被拦（表现为只剩占位鲸），
+  所以素材由 URLSession 拉取后 base64 注入，WebKit 全程零网络请求。
+- 宿主关掉后她只是「待机」并不会死——离线轮询 8s 一次，开销可忽略。
+- 本壳不上传任何东西；全部数据都来自本机 harness 端口。

package/desktop/build.sh

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+# 构建独立桌宠壳：纯 Swift + 系统 WebKit，无第三方依赖。
+# 产物：desktop/build/maoxuan-pet（单文件可执行，pet.html 同目录随行）。
+set -euo pipefail
+cd "$(dirname "$0")/.."
+
+mkdir -p desktop/build
+# 模块缓存放进项目内：系统默认缓存目录（/var/folders/.../C/clang）可能不可写
+swiftc -O \
+  -module-cache-path desktop/build/.module-cache \
+  -o desktop/build/maoxuan-pet \
+  desktop/maoxuan-pet.swift \
+  -Xlinker -sectcreate -Xlinker __TEXT -Xlinker __info_plist -Xlinker desktop/Info.plist
+cp desktop/pet.html desktop/build/pet.html
+
+echo "built: desktop/build/maoxuan-pet"
+echo "run:   ./desktop/build/maoxuan-pet [--origin=http://127.0.0.1:3081] [--reset] [--verbose]"

package/desktop/maoxuan-pet.swift

@@ -0,0 +1,418 @@
+// desktop/maoxuan-pet.swift — 「鲸鱼娘·小毛」独立桌宠壳（macOS）
+//
+// 学 dsh-tauri-pet 的原生窗口思路，但**进程独立于 DSH**：
+//   - 透明、无边框、置顶、跨所有 Space 的 NSWindow + WKWebView
+//     （对应 Tauri 的 transparent / alwaysOnTop / visibleOnAllWorkspaces / skipTaskbar）；
+//   - 点击穿透用 hitTest 白名单矩形实现（等价 dsh-tauri 的 set_pet_input_region）；
+//   - 宿主数据由本进程 URLSession 轮询（等价宠物窗口的 session stream），
+//     绕开 WKWebView 的跨域限制，页面只管渲染；
+//   - DSH 主窗口最小化甚至退出都不影响她站着——她是自己的进程。
+//
+// 用法：maoxuan-pet [--origin=http://127.0.0.1:3081 | --port=3081] [--reset] [--verbose]
+// 退出：右键小毛 → 退出小毛。
+
+import AppKit
+import WebKit
+
+// MARK: - 配置
+
+enum Shell {
+    static var origin = "http://127.0.0.1:3081"
+    static var verbose = false
+    static let statePath = "/api/dsh-maoxuan-pet.state"
+    static let generatePath = "/api/dsh-maoxuan-pet.generate"
+    static let dismissPath = "/api/dsh-maoxuan-pet.dismiss"
+    static let windowWidth: CGFloat = 640
+    static let windowHeight: CGFloat = 720
+    static let defaults = UserDefaults(suiteName: "dsh-maoxuan-pet.window")!
+
+    static func log(_ message: String) {
+        guard verbose else { return }
+        FileHandle.standardError.write(Data("[maoxuan-pet] \(message)\n".utf8))
+    }
+
+    static func jsonString(_ value: Any) -> String {
+        guard JSONSerialization.isValidJSONObject([value]),
+              let data = try? JSONSerialization.data(withJSONObject: [value]),
+              let array = String(data: data, encoding: .utf8),
+              array.count > 1 else { return "{}" }
+        return String(array.dropFirst().dropLast())
+    }
+}
+
+// MARK: - 无边框窗口要显式声明可成为 key（Escape 关卡片需要键盘事件）
+
+final class PetWindow: NSWindow {
+    override var canBecomeKey: Bool { true }
+    override var canBecomeMain: Bool { true }
+}
+
+// MARK: - 点击穿透容器：白名单矩形之外，鼠标事件全部放行给桌面
+
+final class ClickThroughView: NSView {
+    weak var webView: WKWebView?
+    /// 容器本地坐标（左下原点）；矩形之外 hitTest 返回 nil → 点击落到下层窗口。
+    var passRects: [CGRect] = []
+
+    override func hitTest(_ aPoint: NSPoint) -> NSView? {
+        let local: NSPoint
+        if let superview {
+            local = convert(aPoint, from: superview)
+        } else {
+            local = aPoint
+        }
+        for rect in passRects where rect.contains(local) {
+            return webView
+        }
+        return nil
+    }
+}
+
+// MARK: - 主控制器
+
+final class ShellController: NSObject, NSApplicationDelegate, WKNavigationDelegate, WKScriptMessageHandler {
+    private var window: PetWindow!
+    private var webView: WKWebView!
+    private var clickView: ClickThroughView!
+    private var pollItem: DispatchWorkItem?
+    /// ephemeral：无磁盘缓存/cookie，壳不写任何本地数据（也躲开 ~/Library/Caches 权限噪音）
+    private lazy var http: URLSession = URLSession(configuration: .ephemeral)
+    private var dragBaseOrigin: NSPoint?
+    private var pageReady = false
+    private var lastInterval: TimeInterval = 20
+    /// 精灵图 name → data URL：WebKit 的 ATS 会拦 file:// 页面直挂的 http 图，
+    /// 所以素材也由原生层拉取后转 base64 注入，WebKit 全程零网络请求。
+    private var spriteDataURLs: [String: String] = [:]
+    private var spritePending = Set<String>()
+
+    // MARK 生命周期
+
+    func applicationDidFinishLaunching(_ notification: Notification) {
+        let content = NSRect(x: 0, y: 0, width: Shell.windowWidth, height: Shell.windowHeight)
+        let window = PetWindow(
+            contentRect: restoredFrame() ?? defaultFrame(),
+            styleMask: [.borderless],
+            backing: .buffered,
+            defer: false
+        )
+        window.isOpaque = false
+        window.backgroundColor = .clear
+        window.hasShadow = false
+        window.level = .floating
+        window.collectionBehavior = [.canJoinAllSpaces, .fullScreenAuxiliary, .ignoresCycle]
+        window.isMovableByWindowBackground = false
+        window.acceptsMouseMovedEvents = true
+        window.isReleasedWhenClosed = false
+        window.ignoresMouseEvents = false
+
+        let container = ClickThroughView(frame: content)
+        container.wantsLayer = true
+
+        let configuration = WKWebViewConfiguration()
+        // 壳不需要任何网站数据（位置持久化走原生 UserDefaults），用一次性存储免得碰 ~/Library/WebKit
+        configuration.websiteDataStore = .nonPersistent()
+        configuration.userContentController.add(self, name: "pet")
+        // __petEnv 必须在页面脚本运行前就位（didFinish 时内联脚本早已执行完）
+        let envScript = WKUserScript(
+            source: "window.__petEnv = \(Shell.jsonString(["origin": Shell.origin]));",
+            injectionTime: .atDocumentStart,
+            forMainFrameOnly: true
+        )
+        configuration.userContentController.addUserScript(envScript)
+
+        let webView = WKWebView(frame: container.bounds, configuration: configuration)
+        webView.autoresizingMask = [.width, .height]
+        webView.navigationDelegate = self
+        // WKWebView 画透明底的两件套
+        webView.setValue(false, forKey: "drawsBackground")
+        webView.underPageBackgroundColor = .clear
+
+        container.webView = webView
+        container.addSubview(webView)
+        window.contentView = container
+
+        self.window = window
+        self.webView = webView
+        self.clickView = container
+
+        if let html = locateHTML() {
+            webView.loadFileURL(html, allowingReadAccessTo: html.deletingLastPathComponent())
+        } else {
+            FileHandle.standardError.write(Data("[maoxuan-pet] 找不到 pet.html（应与可执行文件同目录）\n".utf8))
+            NSApp.terminate(nil)
+            return
+        }
+
+        window.orderFrontRegardless()
+        FileHandle.standardError.write(Data("[maoxuan-pet] 小毛已站上桌面 — \(Shell.origin)（独立进程，DSH 最小化不影响她）\n".utf8))
+    }
+
+    func applicationWillTerminate(_ notification: Notification) {
+        persistFrame()
+    }
+
+    /// pet.html 与可执行文件同目录（build.sh 负责拷贝）。
+    private func locateHTML() -> URL? {
+        let argv0 = CommandLine.arguments.first ?? "maoxuan-pet"
+        let executable = URL(fileURLWithPath: argv0).resolvingSymlinksInPath()
+        let candidate = executable.deletingLastPathComponent().appendingPathComponent("pet.html")
+        return FileManager.default.fileExists(atPath: candidate.path) ? candidate : nil
+    }
+
+    // MARK 窗口位置
+
+    private func defaultFrame() -> NSRect {
+        let visible = NSScreen.main?.visibleFrame
+            ?? NSRect(x: 0, y: 0, width: 1440, height: 900)
+        let origin = NSPoint(
+            x: visible.maxX - Shell.windowWidth - 28,
+            y: visible.minY + 96
+        )
+        return NSRect(origin: origin, size: NSSize(width: Shell.windowWidth, height: Shell.windowHeight))
+    }
+
+    private func restoredFrame() -> NSRect? {
+        guard ProcessInfo.processInfo.arguments.contains("--reset") == false,
+              let raw = Shell.defaults.string(forKey: "frame") else { return nil }
+        let frame = NSRectFromString(raw)
+        let onScreen = NSScreen.screens.contains { $0.visibleFrame.intersects(frame) }
+        guard onScreen, frame.width > 100, frame.height > 100 else { return nil }
+        return frame
+    }
+
+    private func persistFrame() {
+        guard let window else { return }
+        Shell.defaults.set(NSStringFromRect(window.frame), forKey: "frame")
+        Shell.log("frame saved: \(NSStringFromRect(window.frame))")
+    }
+
+    private func resetFrame() {
+        Shell.defaults.removeObject(forKey: "frame")
+        let frame = defaultFrame()
+        window.setFrame(frame, display: true)
+        persistFrame()
+    }
+
+    /// 拖拽落点收敛：至少留 140pt 在可见区域内，防止拖丢。
+    private func clampedOrigin(_ origin: NSPoint) -> NSPoint {
+        let size = window.frame.size
+        let center = NSPoint(x: origin.x + size.width / 2, y: origin.y + size.height / 2)
+        let screen = NSScreen.screens.first { $0.frame.contains(center) } ?? NSScreen.main
+        let visible = screen?.visibleFrame ?? NSRect(x: 0, y: 0, width: 1440, height: 900)
+        let clampedX = min(max(origin.x, visible.minX - size.width + 140), visible.maxX - 140)
+        let clampedY = min(max(origin.y, visible.minY - size.height + 140), visible.maxY - 40)
+        return NSPoint(x: clampedX, y: clampedY)
+    }
+
+    // MARK 轮询（原生层负责全部 HTTP，页面不跨域）
+
+    private func schedulePoll(after interval: TimeInterval) {
+        pollItem?.cancel()
+        let item = DispatchWorkItem { [weak self] in self?.pollNow() }
+        pollItem = item
+        DispatchQueue.main.asyncAfter(deadline: .now() + interval, execute: item)
+    }
+
+    private func pollNow() {
+        guard let url = URL(string: Shell.origin + Shell.statePath) else { return }
+        var request = URLRequest(url: url, cachePolicy: .reloadIgnoringLocalCacheData, timeoutInterval: 8)
+        request.httpMethod = "GET"
+        http.dataTask(with: request) { [weak self] data, response, error in
+            DispatchQueue.main.async {
+                guard let self else { return }
+                if let error {
+                    Shell.log("state failed: \(error.localizedDescription)")
+                    self.evaluate("window.__petOffline && window.__petOffline();")
+                    self.schedulePoll(after: 8)
+                    return
+                }
+                if let http = response as? HTTPURLResponse, http.statusCode != 200 {
+                    Shell.log("state HTTP \(http.statusCode)")
+                    self.evaluate("window.__petOffline && window.__petOffline();")
+                    self.schedulePoll(after: 8)
+                    return
+                }
+                guard let data, let text = String(data: data, encoding: .utf8) else {
+                    self.evaluate("window.__petOffline && window.__petOffline();")
+                    self.schedulePoll(after: 8)
+                    return
+                }
+                // 生成中的话 3s 后紧跟下一条，让气泡尽快落地
+                let running = (text.contains("\"running\":true") || text.contains("\"running\" : true"))
+                self.lastInterval = running ? 3 : 20
+                self.ensureSprites(from: data)
+                self.evaluate("window.__petState && window.__petState(\(self.sanitized(text)));")
+                self.schedulePoll(after: self.lastInterval)
+            }
+        }.resume()
+    }
+
+    /// 从 state 里拿 pet.sprites，逐张原生拉取并转 data URL 注入页面（一次性，之后命中缓存）。
+    private func ensureSprites(from stateData: Data) {
+        guard let obj = try? JSONSerialization.jsonObject(with: stateData),
+              let dict = obj as? [String: Any],
+              let pet = dict["pet"] as? [String: Any],
+              let sprites = pet["sprites"] as? [String: String] else { return }
+        var newlyNeeded: [(name: String, path: String)] = []
+        for (name, path) in sprites {
+            guard spriteDataURLs[name] == nil, !spritePending.contains(name) else { continue }
+            spritePending.insert(name)
+            newlyNeeded.append((name, path))
+        }
+        guard !newlyNeeded.isEmpty else { return }
+        for entry in newlyNeeded {
+            guard let url = URL(string: Shell.origin + entry.path) else {
+                spritePending.remove(entry.name)
+                continue
+            }
+            http.dataTask(with: URLRequest(url: url, timeoutInterval: 8)) { [weak self] data, response, error in
+                DispatchQueue.main.async {
+                    guard let self else { return }
+                    self.spritePending.remove(entry.name)
+                    if let error {
+                        Shell.log("sprite \(entry.name) failed: \(error.localizedDescription)")
+                    } else if let http = response as? HTTPURLResponse, http.statusCode == 200, let data {
+                        let mime = http.mimeType ?? "image/png"
+                        self.spriteDataURLs[entry.name] = "data:\(mime);base64,\(data.base64EncodedString())"
+                        Shell.log("sprite \(entry.name) ready (\(data.count) bytes)")
+                    }
+                    self.evaluate("window.__petSprites && window.__petSprites(\(Shell.jsonString(self.spriteDataURLs)));")
+                }
+            }.resume()
+        }
+    }
+
+    /// JSON 文本直接内联为 JS 字面量；U+2028/2029 在旧解析器里会断行，换义掉。
+    private func sanitized(_ text: String) -> String {
+        text
+            .replacingOccurrences(of: "\u{2028}", with: "\\u2028")
+            .replacingOccurrences(of: "\u{2029}", with: "\\u2029")
+    }
+
+    private func evaluate(_ source: String) {
+        guard pageReady else { return }
+        webView.evaluateJavaScript(source, completionHandler: { result, error in
+            if let error { Shell.log("evaluate failed: \(error.localizedDescription)") }
+        })
+    }
+
+    // MARK POST 动作（再督促 / 收起）
+
+    private func postAction(path: String, body: String) {
+        guard let url = URL(string: Shell.origin + path) else { return }
+        var request = URLRequest(url: url, cachePolicy: .reloadIgnoringLocalCacheData, timeoutInterval: 200)
+        request.httpMethod = "POST"
+        request.setValue("application/json", forHTTPHeaderField: "content-type")
+        request.httpBody = body.data(using: .utf8)
+        Shell.log("POST \(path) \(body)")
+        http.dataTask(with: request) { [weak self] data, response, error in
+            DispatchQueue.main.async {
+                guard let self else { return }
+                if let error {
+                    Shell.log("POST failed: \(error.localizedDescription)")
+                } else if let http = (response as? HTTPURLResponse) {
+                    let bodyText = data.flatMap { String(data: $0, encoding: .utf8) } ?? ""
+                    Shell.log("POST \(path) → \(http.statusCode) \(String(bodyText.prefix(160)))")
+                }
+                self.evaluate("window.__petActionDone && window.__petActionDone();")
+                self.pollNow()
+            }
+        }.resume()
+    }
+
+    // MARK WKNavigationDelegate
+
+    func webView(_ webView: WKWebView, didFinish navigation: WKNavigation!) {
+        pageReady = true
+        pollNow()
+    }
+
+    func webView(_ webView: WKWebView, didFail navigation: WKNavigation!, withError error: Error) {
+        Shell.log("page load failed: \(error.localizedDescription)")
+    }
+
+    // MARK WKScriptMessageHandler（页面 → 原生）
+
+    func userContentController(_ userContentController: WKUserContentController, didReceive message: WKScriptMessage) {
+        guard message.name == "pet",
+              let body = message.body as? [String: Any],
+              let type = body["type"] as? String else { return }
+        switch type {
+        case "input":
+            // 页面上报的可交互矩形（CSS px，左上原点）→ 容器本地坐标（左下原点）
+            guard let rects = body["rects"] as? [[String: Any]] else { return }
+            let contentHeight = webView.bounds.height
+            let converted: [CGRect] = rects.compactMap { dict in
+                guard let x = (dict["x"] as? NSNumber)?.doubleValue,
+                      let y = (dict["y"] as? NSNumber)?.doubleValue,
+                      let w = (dict["w"] as? NSNumber)?.doubleValue,
+                      let h = (dict["h"] as? NSNumber)?.doubleValue,
+                      w > 0, h > 0 else { return nil }
+                return CGRect(x: x, y: contentHeight - (y + h), width: w, height: h)
+            }
+            clickView.passRects = converted
+            Shell.log("input rects: \(converted.count)")
+
+        case "dragstart":
+            dragBaseOrigin = window.frame.origin
+
+        case "dragto":
+            guard let base = dragBaseOrigin else { return }
+            let dx = (body["dx"] as? NSNumber)?.doubleValue ?? 0
+            let dy = (body["dy"] as? NSNumber)?.doubleValue ?? 0
+            let target = clampedOrigin(NSPoint(x: base.x + dx, y: base.y - dy))
+            window.setFrameOrigin(target)
+
+        case "dragend":
+            dragBaseOrigin = nil
+            persistFrame()
+
+        case "action":
+            let action = body["action"] as? String
+            if action == "generate" {
+                postAction(path: Shell.generatePath, body: "{}")
+            } else if action == "dismiss" {
+                let raw = body["id"] as? String ?? ""
+                let id = String(raw.filter { $0.isLetter || $0.isNumber || $0 == "-" || $0 == "_" })
+                let payload = id.isEmpty ? "{}" : "{\"id\":\"\(id)\"}"
+                postAction(path: Shell.dismissPath, body: payload)
+            }
+
+        case "config":
+            let action = body["action"] as? String
+            if action == "quit" {
+                NSApp.terminate(nil)
+            } else if action == "reset" {
+                resetFrame()
+            }
+
+        default:
+            break
+        }
+    }
+}
+
+// MARK: - 入口
+
+let arguments = ProcessInfo.processInfo.arguments
+var index = 1
+while index < arguments.count {
+    let argument = arguments[index]
+    if argument.hasPrefix("--origin=") {
+        var value = String(argument.dropFirst("--origin=".count))
+        while value.hasSuffix("/") { value.removeLast() }
+        Shell.origin = value
+    } else if argument.hasPrefix("--port=") {
+        let value = String(argument.dropFirst("--port=".count))
+        Shell.origin = "http://127.0.0.1:\(value)"
+    } else if argument == "--verbose" {
+        Shell.verbose = true
+    }
+    index += 1
+}
+
+let app = NSApplication.shared
+app.setActivationPolicy(.accessory) // 不占 Dock、不进 Cmd-Tab
+let controller = ShellController()
+app.delegate = controller
+app.run()

package/desktop/pet.html

@@ -0,0 +1,415 @@
+<!doctype html>
+<!--
+  dsh-plugin-maoxuan-pet · 桌面壳渲染页
+
+  学 dsh-tauri-pet 的窗口思路，但进程独立于 DSH：
+  宿主数据由 Swift 原生层轮询后经 window.__petState() 注入（绕开 WKWebView 跨域），
+  页面只负责画「鲸鱼娘·小毛」+ 红皮书卡片，并把可交互矩形上报给原生层做点击穿透。
+  视觉与交互语义与 client.js（web 宠物）保持一致。
+-->
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8">
+<style>
+  html,body{margin:0;padding:0;width:100%;height:100%;background:transparent;overflow:hidden}
+  body{font-family:Inter,ui-sans-serif,system-ui,-apple-system,"PingFang SC","Microsoft YaHei",sans-serif;color:#ffe9d6;font-size:13px;line-height:1.6}
+  *{box-sizing:border-box}
+  #stage{position:absolute;right:44px;bottom:56px}
+  .mp-anchor{position:relative;display:flex;flex-direction:column;align-items:center}
+  .mp-pet{position:relative;z-index:1;flex:0 0 auto;display:flex;flex-direction:column;align-items:center;cursor:grab;user-select:none;transition:transform .25s ease}
+  .mp-pet:active{cursor:grabbing}
+  .mp-pet:hover{transform:translateY(-3px)}
+  .mp-img{display:block;height:132px;width:auto;max-width:140px;object-fit:contain;filter:drop-shadow(0 10px 16px #050b14aa)}
+  .mp-img[data-talking="on"]{animation:mp-bob 1.6s ease-in-out infinite}
+  .mp-fallback{height:132px;width:100px;filter:drop-shadow(0 10px 16px #050b14aa)}
+  .mp-tag{margin-top:2px;font-size:10px;font-weight:700;letter-spacing:.06em;color:#ffe2bd;background:#5c0f0fd9;border:1px solid #ffd9a833;border-radius:999px;padding:2px 8px;white-space:nowrap;backdrop-filter:blur(8px)}
+  .mp-dot{display:inline-block;width:6px;height:6px;border-radius:50%;margin-right:5px;background:#f6cf9a;box-shadow:0 0 6px #f6cf9aaa;vertical-align:1px}
+  .mp-dot[data-off="off"]{background:#fca5a5;box-shadow:0 0 6px #fca5a5aa}
+  .mp-bubble{position:absolute;z-index:2;right:calc(100% + 12px);bottom:30px;width:340px;animation:mp-in .16s ease-out}
+  .mp-card{position:relative;max-height:min(58vh,480px);overflow-y:auto;overflow-x:hidden;overscroll-behavior:contain;scrollbar-width:thin;scrollbar-color:#f6cf9a #5f1010dd;color:#fff3e4;border:1px solid #8f1616;border-radius:12px;background:linear-gradient(155deg,#b32323 0%,#941a1a 46%,#771111 100%);box-shadow:0 22px 54px #35040466,0 0 0 1px #ffd9a814 inset}
+  .mp-card::-webkit-scrollbar{width:8px;height:8px}
+  .mp-card::-webkit-scrollbar-track{background:#5f1010cc;border-radius:8px}
+  .mp-card::-webkit-scrollbar-thumb{background:linear-gradient(180deg,#f7d9a4,#d09a3f);border-radius:8px;border:1px solid #5f1010}
+  .mp-card::-webkit-scrollbar-thumb:hover{background:linear-gradient(180deg,#ffe9c4,#e0aa4d)}
+  .mp-card::before{content:"";position:absolute;left:0;top:0;bottom:0;width:5px;border-radius:11px 0 0 11px;background:linear-gradient(180deg,#f7d9a4,#d09a3f 45%,#b8792a);opacity:.92}
+  .mp-tail{position:absolute;right:-5px;bottom:38px;width:10px;height:10px;background:#8f1616;border-right:1px solid #8f1616;border-top:1px solid #8f1616;transform:rotate(45deg)}
+  .mp-head{display:flex;align-items:center;gap:6px;padding:9px 8px 8px 14px;border-bottom:1px solid #ffd9a82e;cursor:grab}
+  .mp-head:active{cursor:grabbing}
+  .mp-state{flex:1;min-width:0;font-size:10.5px;font-weight:750;letter-spacing:.06em;color:#ffe0b6;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+  .mp-nav{border:0;background:none;color:#ffd9a8;font-size:15px;line-height:1;padding:1px 4px;cursor:pointer;border-radius:4px;opacity:.8}
+  .mp-nav:hover:not(:disabled){color:#fff8ee;opacity:1}
+  .mp-nav:disabled{opacity:.3;cursor:default}
+  .mp-close{border:0;background:none;color:#ffd9a8;font-size:16px;line-height:1;padding:2px 4px;cursor:pointer;border-radius:4px;opacity:.85}
+  .mp-close:hover{color:#fff8ee;opacity:1}
+  .mp-body{padding:10px 14px 11px 16px}
+  .mp-cite{display:flex;gap:9px;margin:0 0 8px}
+  .mp-rule{flex:0 0 auto;width:2px;border-radius:2px;background:#f6cf9a}
+  .mp-cite-main{min-width:0}
+  .mp-cite p{margin:0;font-size:13px;color:#fff8ee;white-space:pre-wrap;word-break:break-word}
+  .mp-cite[data-kind="summary"] .mp-rule{background:#f0b57a}
+  .mp-meta{display:flex;align-items:center;gap:6px;margin:0 0 8px;font-size:10px;color:#f3cfa8}
+  .mp-meta b{font-weight:750;color:#ffe0b6}
+  .mp-pua{display:flex;gap:6px;margin:0 0 8px;font-size:13.5px;font-weight:750;color:#ffe7c2;letter-spacing:.01em}
+  .mp-pua span:first-child{color:#ffcf8a;font-size:15px;line-height:1.35;font-weight:800}
+  .mp-lesson{margin:0;font-size:12.5px;color:#ffeede}
+  .mp-lesson b{color:#ffd08a;font-weight:750}
+  .mp-axis{display:inline-block;font-size:9.5px;font-weight:800;letter-spacing:.08em;padding:1px 6px;border-radius:4px;margin-right:6px;color:#5a1208;vertical-align:1px}
+  .mp-foot{display:flex;align-items:center;gap:8px;margin-top:10px;padding-top:8px;border-top:1px solid #ffd9a82a}
+  .mp-src{flex:1;min-width:0;font-size:10px;color:#f0c9a2;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+  .mp-src a{color:#f0c9a2;text-decoration:none}
+  .mp-src a:hover{color:#fff8ee;text-decoration:underline}
+  .mp-offline{color:#f3cfa8;opacity:.9}
+  .mp-btn{border:0;background:none;padding:2px 3px;color:#ffe4c7;font:inherit;font-size:11.5px;font-weight:650;cursor:pointer;white-space:nowrap;text-decoration:underline;text-decoration-thickness:1px;text-underline-offset:3px;text-decoration-color:#ffd9a84d;opacity:.92}
+  .mp-btn:hover:not(:disabled){color:#fff8ee;text-decoration-color:#ffd9a8;opacity:1}
+  .mp-btn:disabled{opacity:.5;cursor:default}
+  .mp-loading{display:flex;align-items:center;gap:7px;color:#ffe7c2;font-size:12px;padding:6px 0}
+  .mp-spin{width:12px;height:12px;border-radius:50%;border:2px solid #ffd9a83d;border-top-color:#f6cf9a;animation:mp-rot .8s linear infinite}
+  .mp-empty{margin:0 0 8px;color:#ffe7c2;font-size:12.5px}
+  .mp-warn{margin:6px 0 0;font-size:10px;color:#ffd0d0}
+  .mp-badge{position:absolute;z-index:3;top:-7px;right:-7px;min-width:17px;height:17px;border-radius:9px;background:#f6cf9a;color:#6b1206;font-size:10px;font-weight:800;line-height:17px;text-align:center;padding:0 4px;box-shadow:0 4px 10px #2b040466}
+  .mp-menu{position:absolute;z-index:9;left:0;top:100%;min-width:96px;border:1px solid #8f1616;border-radius:8px;background:#5c0f0f;box-shadow:0 10px 24px #00000055;padding:4px;animation:mp-in .12s ease-out}
+  .mp-menu button{display:block;width:100%;border:0;background:none;color:#ffe4c7;font:inherit;font-size:11.5px;text-align:left;padding:5px 8px;border-radius:5px;cursor:pointer;white-space:nowrap}
+  .mp-menu button:hover{background:#7a1616;color:#fff8ee}
+  @keyframes mp-in{from{opacity:0;transform:translateY(4px) scale(.985)}to{opacity:1;transform:none}}
+  @keyframes mp-rot{to{transform:rotate(360deg)}}
+  @keyframes mp-bob{0%,100%{transform:translateY(0)}50%{transform:translateY(-3px)}}
+  @media (prefers-reduced-motion: reduce){
+    body *{animation:none!important;transition:none!important}
+    .mp-pet:hover{transform:none}
+  }
+</style>
+</head>
+<body>
+<div id="stage">
+  <div class="mp-anchor" id="anchor">
+    <div class="mp-pet" id="pet" role="button" tabindex="0" aria-label="鲸鱼娘小毛"></div>
+  </div>
+</div>
+<script>
+'use strict';
+
+// --- 原生桥 ----------------------------------------------------------------
+const native = window.webkit?.messageHandlers?.pet;
+const send = (msg) => { try { native?.postMessage(msg); } catch { /* 桥断了就静默 */ } };
+
+// --- 状态 ------------------------------------------------------------------
+let env = Object.assign({ origin: 'http://127.0.0.1:3081' }, window.__petEnv || null);
+let state = null;          // 最近一次宿主快照
+let offline = false;       // 原生层最近一次轮询失败
+let busy = false;          // 本端触发的「再督促」进行中
+let open = false, pinned = null;
+let seen = null, autoFloor = null;
+const closedIds = new Set();
+const marked = new Set();
+let spriteKey = '';
+let cardKey = '';
+let ctxOpen = false;
+
+const AXIS_COLOR = { 客户:'#f7d9a4', 项目:'#f0b478', 组织:'#e9c887', 现金流:'#e8ac52', 决策:'#efd9b6', 自律:'#d7a76b' };
+const PET_TAG = document.getElementById('pet');
+
+/** v1 气泡（quote/thought/insight/nag/action）兼容成形。 */
+function shape(bubble) {
+  if (!bubble) return null;
+  if (bubble.cite && typeof bubble.cite.text === 'string') return bubble;
+  return {
+    ...bubble,
+    template: bubble.quote ? 'quote' : 'summary',
+    cite: { kind: bubble.quote ? 'quote' : 'summary', label: bubble.quote ? '原文' : '小毛概括', text: bubble.quote || bubble.thought || '' },
+    axis: bubble.axis || '项目',
+    pua: bubble.pua || bubble.nag || '',
+    lesson: bubble.lesson || bubble.insight || bubble.action || '',
+  };
+}
+
+const mmss = (delta) => {
+  if (!Number.isFinite(delta)) return '';
+  const total = Math.max(0, Math.round(delta / 1000));
+  const h = Math.floor(total / 3600), m = Math.floor((total % 3600) / 60);
+  return h > 0 ? `${h}h${String(m).padStart(2,'0')}m` : `${m}m`;
+};
+
+function currentSprite() {
+  const map = state?.pet?.sprites || {};
+  if (state?.running || busy) return map.read ? 'read' : 'idle';
+  if (open && current() && current().mode !== 'offline') return map.talk ? 'talk' : 'idle';
+  return 'idle';
+}
+
+/** 精灵图 data URL 表（原生层拉好注入；WebKit 的 ATS 会拦 file:// 页面直挂的 http 图）。 */
+let petSprites = null;
+
+const latest = () => shape(state?.current);
+const history = () => (state?.bubbles || []).map(shape).filter(Boolean);
+function current() {
+  const pin = pinned && history().find((b) => b.id === pinned);
+  return pin || latest() || history()[0] || null;
+}
+
+// --- 渲染：宠物本体（一次性搭好，之后只改动态位） ----------------------------
+const FALLBACK_SVG = `<svg class="mp-fallback" viewBox="0 0 104 112" role="img" aria-label="鲸鱼娘占位图">
+  <ellipse cx="52" cy="62" rx="34" ry="30" fill="#2f6fd0"/><ellipse cx="43" cy="82" rx="22" ry="14" fill="#dbeafe"/>
+  <circle cx="41" cy="55" r="5" fill="#0b1220"/><circle cx="63" cy="55" r="5" fill="#0b1220"/>
+  <circle cx="43" cy="53" r="1.6" fill="#fff"/><circle cx="65" cy="53" r="1.6" fill="#fff"/>
+  <path d="M46 68 q6 5 12 0" stroke="#0b1220" stroke-width="2" fill="none" stroke-linecap="round"/>
+  <path d="M52 24 C 74 14, 92 26, 90 44 C 82 34, 68 34, 52 40 Z" fill="#2f6fd0"/>
+  <path d="M78 6 l4 10 10 4 -10 4 -4 10 -4 -10 -10 -4 10 -4 z" fill="#ef4444"/></svg>`;
+
+PET_TAG.innerHTML = `
+  <span id="pet-visual"></span>
+  <span class="mp-badge" id="badge" aria-hidden="true" hidden></span>
+  <span class="mp-tag"><i class="mp-dot" id="dot"></i><span id="tag-label">待命中</span></span>`;
+const petVisual = document.getElementById('pet-visual');
+const badge = document.getElementById('badge');
+const dot = document.getElementById('dot');
+const tagLabel = document.getElementById('tag-label');
+
+function renderPetVisual() {
+  const name = currentSprite();
+  const src = petSprites?.[name] || null;
+  const key = src ? name : 'fallback';
+  if (key === spriteKey && petVisual.firstChild) {
+    // 只同步说话动画开关
+    const img = petVisual.querySelector('.mp-img');
+    const cur = current();
+    if (img) img.dataset.talking = open && cur && cur.mode !== 'offline' ? 'on' : 'off';
+    return;
+  }
+  spriteKey = key;
+  if (!src) { petVisual.innerHTML = FALLBACK_SVG; reportRects(); return; }
+  petVisual.innerHTML = `<img class="mp-img" alt="鲸鱼娘·小毛" draggable="false">`;
+  const img = petVisual.querySelector('.mp-img');
+  img.addEventListener('load', reportRects);
+  img.src = src;
+}
+
+// --- 渲染：红皮书卡片（key 变了才重建） --------------------------------------
+const anchor = document.getElementById('anchor');
+let cardEl = null, menuEl = null;
+
+function esc(text) {
+  return String(text ?? '').replace(/[&<>"']/g, (c) => ({ '&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;' }[c]));
+}
+
+function renderCard() {
+  const cur = current();
+  const hist = history();
+  const idx = cur ? hist.findIndex((b) => b.id === cur.id) : -1;
+  const older = idx >= 0 && idx < hist.length - 1;
+  const newer = idx > 0;
+  const running = !!(state?.running || busy);
+  const key = `${open}|${cur?.id}|${running}|${offline}|${state?.lastError?.message || ''}`;
+  if (key === cardKey && cardEl) return;
+  cardKey = key;
+  if (cardEl) { cardEl.remove(); cardEl = null; }
+  if (!open) { reportRects(); return; }
+
+  const bodyInner = running
+    ? `<div class="mp-loading"><i class="mp-spin"></i>小毛正在翻毛选…</div>`
+    : cur ? `
+      <blockquote class="mp-cite" data-kind="${esc(cur.cite?.kind || 'quote')}"><i class="mp-rule"></i>
+        <div class="mp-cite-main"><p>${cur.cite?.kind === 'summary' ? esc(cur.cite.text) : `「${esc(cur.cite.text)}」`}</p></div>
+      </blockquote>
+      <p class="mp-meta"><b>${esc(cur.cite?.label || '原文')}</b>${cur.year ? ` · ${esc(cur.year)}` : ''}</p>
+      ${cur.pua ? `<div class="mp-pua"><span aria-hidden="true">“</span><span>${esc(cur.pua)}</span></div>` : ''}
+      <p class="mp-lesson">${cur.axis ? `<span class="mp-axis" style="background:${AXIS_COLOR[cur.axis] || '#64748b'}" title="启示落点：${esc(cur.axis)}">${esc(cur.axis)}</span>` : ''}<b>启示 </b>${esc(cur.lesson)}</p>
+      <div class="mp-foot">
+        <span class="mp-src">${cur.sourceUrl ? `<a href="${esc(cur.sourceUrl)}" target="_blank" rel="noreferrer noopener">中文马克思主义文库</a>` : '内置语料'}${cur.mode === 'offline' ? ' <span class="mp-offline">· 离线摘录</span>' : ''}</span>
+        <button class="mp-btn" data-act="dismiss" aria-label="收起这条督促">收起</button>
+        <button class="mp-btn" data-act="generate" data-primary="on" aria-label="再督促我一次">再督促</button>
+      </div>`
+    : `<p class="mp-empty">${running ? '小毛正在翻第一篇毛选…' : '小毛还没读过毛选。'}</p>
+       <button class="mp-btn" data-act="generate" data-primary="on" aria-label="让小毛现在读一篇">现在读一篇</button>`;
+
+  const warn = state?.lastError
+    ? `<p class="mp-warn">上次生成没成功：${esc(String(state.lastError.message || '')).slice(0, 90)}</p>` : '';
+  const offlineWarn = offline ? `<p class="mp-warn">连接中断，重试中…</p>` : '';
+
+  const bubble = document.createElement('div');
+  bubble.className = 'mp-bubble';
+  bubble.innerHTML = `
+    <i class="mp-tail" aria-hidden="true"></i>
+    <section class="mp-card" aria-label="小毛的毛选督促">
+      <div class="mp-head" id="card-head">
+        <span class="mp-state">${cur ? `《${esc(cur.title)}》` : '鲸鱼娘·小毛'}</span>
+        ${hist.length > 1 ? `<button class="mp-nav" data-act="nav-newer" ${newer ? '' : 'disabled'} title="更新的一条" aria-label="更新的一条">‹</button>` : ''}
+        ${hist.length > 1 ? `<button class="mp-nav" data-act="nav-older" ${older ? '' : 'disabled'} title="更早的一条" aria-label="更早的一条">›</button>` : ''}
+        <button class="mp-close" data-act="close" aria-label="收起气泡">×</button>
+      </div>
+      <div class="mp-body">${bodyInner}${warn}${offlineWarn}</div>
+    </section>`;
+  anchor.appendChild(bubble);
+  cardEl = bubble;
+
+  bubble.addEventListener('click', (event) => {
+    const btn = event.target.closest('[data-act]');
+    if (!btn) return;
+    const act = btn.dataset.act;
+    if (act === 'close') { open = false; pinned = null; renderCard(); }
+    else if (act === 'nav-newer' && newer) { pinned = hist[idx - 1].id; cardKey = ''; renderCard(); }
+    else if (act === 'nav-older' && older) { pinned = hist[idx + 1].id; cardKey = ''; renderCard(); }
+    else if (act === 'dismiss') { if (cur) closedIds.add(cur.id); open = false; pinned = null; send({ type:'action', action:'dismiss', id: cur?.id || '' }); renderCard(); }
+    else if (act === 'generate' && !running) { busy = true; send({ type:'action', action:'generate' }); cardKey = ''; renderCard(); }
+  });
+
+  reportRects();
+}
+
+// --- 渲染：徽标 / 标签 / 右键菜单 -------------------------------------------
+function renderMeta() {
+  const unread = Number(state?.unread || 0);
+  badge.hidden = !(unread > 0);
+  if (unread > 0) badge.textContent = unread > 9 ? '9+' : String(unread);
+  dot.dataset.off = offline ? 'off' : 'on';
+  const countdown = state?.nextRunAt ? Date.parse(state.nextRunAt) - Date.now() : NaN;
+  tagLabel.textContent = (state?.running || busy) ? '翻书中'
+    : Number.isFinite(countdown) && countdown > 0 ? `${mmss(countdown)} 后再读` : '待命中';
+  const cur = current();
+  const visual = petVisual.querySelector('.mp-img');
+  if (visual) visual.dataset.talking = open && cur && cur.mode !== 'offline' ? 'on' : 'off';
+}
+
+function renderMenu() {
+  if (menuEl) { menuEl.remove(); menuEl = null; }
+  if (!ctxOpen) { reportRects(); return; }
+  menuEl = document.createElement('div');
+  menuEl.className = 'mp-menu';
+  menuEl.innerHTML = `<button data-mact="reset">复位位置</button><button data-mact="quit">退出小毛</button>`;
+  anchor.appendChild(menuEl);
+  menuEl.addEventListener('click', (event) => {
+    const btn = event.target.closest('[data-mact]');
+    if (!btn) return;
+    ctxOpen = false; menuEl.remove(); menuEl = null;
+    send({ type:'config', action: btn.dataset.mact });
+    reportRects();
+  });
+  reportRects();
+}
+
+function renderAll() { renderPetVisual(); renderCard(); renderMeta(); if (!open) reportRects(); }
+
+// --- 输入区上报（原生层据此做点击穿透，等价 dsh-tauri 的 input region） -------
+function reportRects() {
+  const rects = [];
+  const push = (el) => {
+    if (!el) return;
+    const r = el.getBoundingClientRect();
+    if (r.width <= 0 || r.height <= 0) return;
+    rects.push({ x: r.left - 6, y: r.top - 6, w: r.width + 12, h: r.height + 12 });
+  };
+  push(anchor);
+  push(cardEl);
+  push(menuEl);
+  send({ type:'input', rects });
+}
+
+new ResizeObserver(reportRects).observe(anchor);
+
+// --- 打开卡片 = 这条已读（与 web 宠物同语义） --------------------------------
+function markRead(cur) {
+  if (!open || !cur || cur.read) return;
+  if (marked.has(cur.id)) return;
+  marked.add(cur.id);
+  window.setTimeout(() => {
+    send({ type:'action', action:'dismiss', id: cur.id });
+    if (state) {
+      state.unread = Math.max(0, (state.unread || 0) - (state.current?.id === cur.id ? 1 : 0));
+      state.bubbles = (state.bubbles || []).map((b) => (b.id === cur.id ? { ...b, read: true } : b));
+      renderMeta();
+    }
+  }, 600);
+}
+
+// --- 交互：点击开合 / 拖动 / 键盘 --------------------------------------------
+let drag = null;
+
+anchor.addEventListener('pointerdown', (event) => {
+  if (event.button !== 0) return;
+  if (event.target.closest('.mp-menu') || event.target.closest('.mp-btn') || event.target.closest('.mp-nav') || event.target.closest('.mp-close')) return;
+  drag = { sx: event.screenX, sy: event.screenY, moved: false };
+  event.preventDefault();
+});
+
+window.addEventListener('pointermove', (event) => {
+  if (!drag) return;
+  const dx = event.screenX - drag.sx, dy = event.screenY - drag.sy;
+  if (!drag.moved && Math.abs(dx) + Math.abs(dy) > 4) {
+    drag.moved = true;
+    send({ type:'dragstart' }); // 原生层记住当前窗口位置，之后按差值绝对定位
+  }
+  if (drag.moved) send({ type:'dragto', dx, dy });
+}, { passive: true });
+
+window.addEventListener('pointerup', (event) => {
+  if (!drag) return;
+  const moved = drag.moved;
+  drag = null;
+  if (moved) { send({ type:'dragend' }); return; }
+  // 原地松手 = 点击：点宠物开合，点卡片头部不动
+  const onPet = !event.target.closest('.mp-card');
+  if (onPet) {
+    if (open) { open = false; pinned = null; }
+    else { pinned = latest()?.id || null; open = true; markRead(current()); }
+    cardKey = '';
+    renderCard(); renderMeta();
+  }
+});
+
+window.addEventListener('keydown', (event) => {
+  if (event.key === 'Escape' && open) { open = false; pinned = null; ctxOpen = false; cardKey = ''; renderCard(); renderMenu(); }
+  if ((event.key === 'Enter' || event.key === ' ') && event.target === PET_TAG) {
+    event.preventDefault();
+    open = !open; if (open) markRead(current()); cardKey = ''; renderCard();
+  }
+});
+
+anchor.addEventListener('contextmenu', (event) => {
+  event.preventDefault();
+  ctxOpen = !ctxOpen;
+  renderMenu();
+});
+
+document.addEventListener('click', (event) => {
+  if (ctxOpen && !event.target.closest('.mp-menu')) { ctxOpen = false; renderMenu(); }
+});
+
+// --- 原生层入口 --------------------------------------------------------------
+window.__petReady = () => { reportRects(); };
+window.__petSprites = (map) => {
+  petSprites = map || {};
+  spriteKey = '';
+  renderPetVisual();
+  reportRects();
+};
+window.__petState = (json) => {
+  offline = false;
+  state = json;
+  busy = false;  const fresh = latest();
+  if (fresh) {
+    const at = Date.parse(fresh.at || '') || Date.now();
+    if (autoFloor === null) autoFloor = at;
+    if (seen !== fresh.id) {
+      seen = fresh.id;
+      if (at > autoFloor && !closedIds.has(fresh.id)) {
+        autoFloor = at;
+        pinned = fresh.id;
+        open = true;
+      }
+    }
+  }
+  spriteKey = '';        // sprite 选择可能随 running/open 变化
+  cardKey = '';
+  renderAll();
+};
+window.__petOffline = () => { offline = true; busy = false; renderMeta(); renderCard(); };
+window.__petActionDone = () => { busy = false; cardKey = ''; renderCard(); renderMeta(); };
+
+// 时钟：倒计时文案每秒刷新
+window.setInterval(renderMeta, 1000);
+
+// 起手画一只（还没有数据时是占位鲸鱼 + 待命中）
+renderAll();
+send({ type:'ready' });
+</script>
+</body>
+</html>

package/docs/RELEASE.md

@@ -8,11 +8,11 @@
 | 项 | 现状（2026-11-01 核对） |
 |---|---|
 | 包名 | `dsh-plugin-maoxuan-pet`（unscoped，npm 上未占用） |
-| 版本 | `0.2.3` |
+| 版本 | `0.3.0` |
 | 代码许可 | MIT（`LICENSE`）；语料与立绘的非 MIT 声明见 `NOTICE` |
-| 打包清单 | `npm pack --dry-run` → 59 files / 1.26 MB（含 33 篇语料；0.2.1 起立绘降到 256×539，包体从 4.2 MB 降下来） |
+| 打包清单 | `npm pack --dry-run` → 64 files / 1.3 MB（含 33 篇语料 + desktop/ 5 个壳源码文件；`desktop/build/` 产物靠 files 逐文件点名排除，勿改回整目录收录） |
 | GitHub 账号 | `gh auth status` → `yuna78`（scopes 含 `repo`） |
-| npm 凭据 | **当前 `npm whoami` 返回 401，必须先 `npm login` 或换 token** |
+| npm 凭据 | `npm whoami` → `yuna78`（2026-11-01 复核有效）；发布需 2FA 一次性验证码，`npm publish --otp=<6位码>` |
 | 市场收录机制 | awesome-dsh-plugin 索引 **npm 包**（`versions[].source.type = npm`），并用 `package.json` 的 `repository.url` 关联 GitHub 仓；**没有投稿表单**，发布后由爬虫收录 |
 
 ## 1. 发布前自检（每次都跑）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-maoxuan-pet",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "description": "DSH 悬浮宠物「鲸鱼娘·小毛」：每小时读一篇毛选，给创业中的你说一句能动手的督促；内置毛选公开语料与 maoxuan-pet preset。",
   "keywords": [
     "dsh",
@@ -51,6 +51,11 @@
     "assets/",
     "corpus/",
     "skill/",
+    "desktop/Info.plist",
+    "desktop/README.md",
+    "desktop/build.sh",
+    "desktop/maoxuan-pet.swift",
+    "desktop/pet.html",
     "docs/",
     "tools/",
     "README.md",
@@ -65,7 +70,9 @@
     "test": "node verify/smoke.mjs && node verify/contract.mjs && node verify/host.test.mjs",
     "test:contract": "node verify/contract.mjs",
     "audit:corpus": "node tools/audit-corpus-coverage.mjs",
-    "prepublishOnly": "node verify/smoke.mjs && node verify/contract.mjs"
+    "prepublishOnly": "node verify/smoke.mjs && node verify/contract.mjs",
+    "pet:build": "bash desktop/build.sh",
+    "pet": "bash desktop/build.sh && ./desktop/build/maoxuan-pet"
   },
   "dsh": {
     "bundle": {