@harness-mix/cli 0.1.9 → 0.1.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harness-mix/cli",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "license": "Apache-2.0",
   "description": "Harness Mix native Codex UI bridge for Codex, Pi, Claude Code, DeepSeek Harness, Antigravity, CodeBuddy, Kiro CLI, Cursor CLI and other native coding harnesses.",
   "keywords": [
@@ -82,7 +82,8 @@
     "test:docs": "node scripts/docs-command-test.cjs",
     "typecheck:native-ui": "tsc -b src/native-ui/shared-contracts/tsconfig.json src/native-ui/desktop-control/tsconfig.json src/native-ui/renderer-extension/tsconfig.json --pretty false",
     "test:native-ui": "vitest run --config vitest.config.mjs",
-    "test:ci": "npm run test:docs && npm run check && npm run typecheck:native-ui && npm run test:native-ui && npm run test:core-all && npm run test:native-protocol && npm run test:native-compatibility && npm run test:platform",
+    "test:ci": "npm run test:docs && npm run check && npm run typecheck:native-ui && npm run test:native-ui && npm run test:core-all && npm run test:native-protocol && npm run test:native-compatibility && npm run test:platform && npm run test:pets",
+    "test:pets": "node scripts/pets-test.cjs",
     "test:storage-verification": "node scripts/storage-verification-test.cjs",
     "test:collaboration": "node scripts/collaboration-test.cjs",
     "test:switch-harness": "node scripts/switch-harness-test.cjs",
@@ -178,11 +179,11 @@
     "zod": "4.4.3"
   },
   "optionalDependencies": {
-    "@harness-mix/native-win32-x64": "0.1.6",
-    "@harness-mix/native-win32-arm64": "0.1.6",
-    "@harness-mix/native-darwin-x64": "0.1.6",
-    "@harness-mix/native-darwin-arm64": "0.1.6",
-    "@harness-mix/native-linux-x64": "0.1.6",
-    "@harness-mix/native-linux-arm64": "0.1.6"
+    "@harness-mix/native-win32-x64": "0.1.9",
+    "@harness-mix/native-win32-arm64": "0.1.9",
+    "@harness-mix/native-darwin-x64": "0.1.9",
+    "@harness-mix/native-darwin-arm64": "0.1.9",
+    "@harness-mix/native-linux-x64": "0.1.9",
+    "@harness-mix/native-linux-arm64": "0.1.9"
   }
 }

package/scripts/native-config-test.cjs

@@ -3,6 +3,7 @@ const fs = require('node:fs');
 const os = require('node:os');
 const path = require('node:path');
 const { nativeEnvironment, nativePaths, saveNativeSettings } = require('../src/main/native/config');
+const { isCodexTaskEnvironment, readLiveHostInstance } = require('../src/main/native/launcher');
 
 const directory = fs.mkdtempSync(path.join(os.tmpdir(), 'harness-mix-config-'));
 try {
@@ -18,8 +19,37 @@ try {
   assert.equal(nativeEnvironment({ CODEXHOST_DATA_DIR: directory, CODEXHOST_PI_COMMAND: 'D:\\other\\pi.cmd' }).CODEXHOST_PI_COMMAND,
     'D:\\other\\pi.cmd', 'Explicit environment takes priority');
   for (const file of Object.values(nativePaths())) assert.ok(fs.statSync(file).isFile(), file);
+  const runtimeDirectory = path.join(directory, 'runtime');
+  fs.mkdirSync(runtimeDirectory, { recursive: true });
+  const instanceFile = path.join(runtimeDirectory, 'instance.json');
+  fs.writeFileSync(instanceFile, JSON.stringify({
+    pid: 4242,
+    beatAt: 1_000_000,
+    mode: 'native-host',
+  }));
+  assert.deepEqual(
+    readLiveHostInstance(directory, { now: 1_010_000, isPidAlive: pid => pid === 4242 }),
+    { pid: 4242, beatAt: 1_000_000, mode: 'native-host' },
+    'A live Host makes repeated npm start idempotent',
+  );
+  assert.equal(
+    readLiveHostInstance(directory, { now: 1_020_000, isPidAlive: () => true }),
+    null,
+    'A stale Host heartbeat does not block a real launch',
+  );
+  assert.equal(
+    readLiveHostInstance(directory, { now: 1_010_000, isPidAlive: () => false }),
+    null,
+    'A dead Host PID does not block a real launch',
+  );
+  assert.equal(isCodexTaskEnvironment({ CODEX_THREAD_ID: 'thread-1' }), true);
+  assert.equal(isCodexTaskEnvironment({ CODEX_SESSION_ID: 'session-1' }), true);
+  assert.equal(
+    isCodexTaskEnvironment({ CODEX_INTERNAL_ORIGINATOR_OVERRIDE: 'Codex Desktop' }),
+    true,
+  );
+  assert.equal(isCodexTaskEnvironment({}), false);
   console.log('Native configuration, AppX environment recovery, credential exclusion and packaged resources passed');
 } finally {
-  fs.rmSync(path.join(directory, 'harness-mix-settings.json'), { force: true });
-  fs.rmdirSync(directory);
+  fs.rmSync(directory, { recursive: true, force: true });
 }

package/scripts/native-ui-smoke.cjs

@@ -22,7 +22,7 @@ app.whenReady().then(async () => {
     lifecycle.dispose();
     return pageIds;
   })()`);
-  assert.deepEqual(liveSettingsPages, ['connections', 'accounts', 'mcp', 'skills', 'session-import', 'storage', 'skins', 'updates', 'about']);
+  assert.deepEqual(liveSettingsPages, ['connections', 'accounts', 'mcp', 'skills', 'session-import', 'storage', 'skins', 'pets', 'updates', 'about']);
   const { NativeProtocol } = require('../src/main/native/protocol');
   const nativeThreads = ['pi', 'claude', 'dsh', 'antigravity'].map((harnessId, index) => ({ id: 'sidebar-' + index, harnessId, model: { id: 'model-' + index, provider: 'native' }, options: {} }));
   const protocol = new NativeProtocol({ threads: nativeThreads, getThread: id => nativeThreads.find(thread => thread.id === id), subscribe: () => () => {}, core: { subscribe: () => () => {} }, describe: async () => ({}), getCapabilities: () => ({}) }, () => {});
@@ -212,6 +212,36 @@ app.whenReady().then(async () => {
   assert.match(skinShowcase.logoBackground, /data:image\/webp/);
   assert.match(skinShowcase.polaroidBackground, /data:image\/webp/);
   fs.writeFileSync(path.join(out, 'skin-miku-full.png'), (await win.webContents.capturePage()).toPNG());
+  await win.setSize(1024, 716);
+  const responsiveHome = await win.webContents.executeJavaScript(`(async () => {
+    document.body.innerHTML = '<div id="root"><aside class="app-shell-left-panel"></aside><main class="main-surface" data-app-shell-main-surface="default"><div data-app-shell-main-content-top-fade="full-bleed"></div><header data-pip-obstacle="app-shell-header"><div data-testid="app-shell-header-context-menu-surface"><div data-app-shell-page-header="true"><div data-app-shell-header-toolbar="true"><div class="thread-title-surface"><div>新任务</div></div><button class="header-action" aria-label="聊天操作" aria-haspopup="menu" data-state="open">...</button></div></div></div></header><div role="main" style="container-type:size;container-name:home-main-content;width:100%;height:100%;display:flex;flex-direction:column"><section class="_Hero_smoke_2"><h1 data-feature="game-source">你想让我们在 harness-mix 中构建什么？</h1></section><section class="[--thread-content-max-width:42rem]"><div data-composer-placement="home" class="composer-surface-chrome">随心输入<table><tbody><tr><td>响应式验证</td></tr></tbody></table></div></section></div></main></div>';
+    const fixtureStyle = document.createElement('style');
+    fixtureStyle.textContent = 'html,body,#root{width:100%;height:100%;margin:0}#root{display:flex}.app-shell-left-panel{flex:0 0 240px}.main-surface{position:relative;min-width:0;flex:1}.main-surface>header{position:absolute;z-index:2;width:100%;height:44px}.main-surface>header>div{display:flex;justify-content:space-between;padding:8px 12px}._Hero_smoke_2{display:flex;flex:0 0 44%;align-items:flex-end;justify-content:center;min-block-size:260px;padding-bottom:32px}h1{font-size:32px}.\\[--thread-content-max-width\\:42rem\\]{width:var(--thread-content-max-width);max-width:100%;margin:auto}.composer-surface-chrome{padding:24px}';
+    document.head.append(fixtureStyle);
+    NativeUI.applyRendererSkin('miku-488137', document);
+    await new Promise(resolve => setTimeout(resolve, 100));
+    const hero = getComputedStyle(document.querySelector('._Hero_smoke_2'));
+    const heading = getComputedStyle(document.querySelector('[data-feature="game-source"]'));
+    const header = getComputedStyle(document.querySelector('[data-pip-obstacle="app-shell-header"]'));
+    const headerAction = getComputedStyle(document.querySelector('.header-action'));
+    const titleSurface = getComputedStyle(document.querySelector('.thread-title-surface'));
+    const topFade = getComputedStyle(document.querySelector('[data-app-shell-main-content-top-fade]'));
+    const table = getComputedStyle(document.querySelector('table'));
+    return { flexBasis:hero.flexBasis, minBlockSize:parseFloat(hero.minBlockSize), fontSize:parseFloat(heading.fontSize), headerBackground:header.backgroundColor, headerActionBackground:headerAction.backgroundColor, titleBackground:titleSurface.backgroundColor, topFadeImage:topFade.backgroundImage, topFadeOpacity:topFade.opacity, tableBackground:table.backgroundColor };
+  })()`);
+  assert.equal(responsiveHome.flexBasis, 'auto');
+  assert.ok(responsiveHome.minBlockSize <= 200, `responsive hero remained too tall: ${responsiveHome.minBlockSize}px`);
+  assert.ok(responsiveHome.fontSize <= 28, `responsive heading remained too large: ${responsiveHome.fontSize}px`);
+  assert.equal(responsiveHome.headerBackground, 'rgba(0, 0, 0, 0)');
+  assert.equal(responsiveHome.headerActionBackground, 'rgba(0, 0, 0, 0)');
+  assert.equal(responsiveHome.titleBackground, 'rgba(0, 0, 0, 0)');
+  assert.equal(responsiveHome.topFadeImage, 'none');
+  assert.equal(responsiveHome.topFadeOpacity, '0');
+  assert.notEqual(responsiveHome.tableBackground, 'rgba(0, 0, 0, 0)');
+  fs.writeFileSync(path.join(out, 'skin-responsive-home.png'), (await win.webContents.capturePage()).toPNG());
+  await win.setSize(1920, 1000);
+  const wideThreadWidth = await win.webContents.executeJavaScript(`(() => getComputedStyle(document.querySelector('[class*="thread-content-max-width"]')).getPropertyValue('--thread-content-max-width').trim())()`);
+  assert.match(wideThreadWidth, /72rem/);
   await win.setSize(1020, 716);
   const readableConversation = await win.webContents.executeJavaScript(`(async () => {
     document.body.innerHTML = '<div id="root"><aside class="app-shell-left-panel"><button aria-haspopup="menu" aria-label="Open Codex menu"><span>Codex</span></button><nav><strong>新建任务</strong><span>Pull Request</span><span>定时任务</span><span>插件</span><small>项目</small><span>snipaste-pro</span><span>harness-mix</span><span class="active" data-app-action-sidebar-thread-active="true">查找换肤界面差异原因</span></nav><footer>Harness Mix</footer></aside><main class="main-surface chat" data-app-shell-main-surface="default"><header>查找换肤界面差异原因</header><div class="chat-scroll"><article data-local-conversation-final-assistant><div data-response-annotation-conversation><small>用时 19秒</small><p>是的，准确说是修改了 Codex UI 的运行时表现层。</p><p>它会：</p><ul><li>注入 CSS、替换颜色变量和背景图。</li><li>把部分原生面板变成半透明。</li><li>增加 Logo、拍立得等纯视觉装饰。</li><li>保留原有按钮、输入框、会话和交互逻辑。</li></ul><p>它不会修改 Codex 的安装包、模型调用、账号、权限或会话归属。</p></div></article></div><section class="composer-surface-chrome"><div>随心输入</div><footer>＋　完全访问 <span>GPT-5.6 Sol　↑</span></footer></section></main></div>';
@@ -229,9 +259,9 @@ app.whenReady().then(async () => {
   assert.equal(readableConversation.radius, '18px');
   fs.writeFileSync(path.join(out, 'skin-conversation-readable.png'), (await win.webContents.capturePage()).toPNG());
   const darkSurfaceResult = await win.webContents.executeJavaScript(`(async () => {
-    document.body.innerHTML = '<div id="root"><aside class="app-shell-left-panel"><button aria-haspopup="menu" aria-label="Open Codex menu"><span>Codex</span></button><nav><strong>新对话</strong><span>Pull Request</span><span>定时任务</span><span>插件</span><small>项目</small><span class="active" data-app-action-sidebar-thread-active="true">暗色皮肤全界面适配</span></nav></aside><main class="main-surface dark-fixture" data-app-shell-main-surface="default"><header>暗色皮肤全界面适配</header><article data-response-annotation-conversation><p>正文、工具状态、评审卡和输入区都需要保持清晰。</p><section class="review-card"><div>已编辑 3 个文件</div><button class="review-action">审核</button><button class="review-row">src/settings/skin-runtime.ts</button><button class="review-row">scripts/native-ui-smoke.cjs</button></section></article><section class="composer-real" data-composer-layout="multiline"><input placeholder="随心输入"><button>完全访问</button><button>GPT-5.6 Sol</button></section></main></div>';
+    document.body.innerHTML = '<div id="root"><aside class="app-shell-left-panel"><button aria-haspopup="menu" aria-label="Open Codex menu"><span>Codex</span></button><nav><strong>新对话</strong><span>Pull Request</span><span>定时任务</span><span>插件</span><small>项目</small><span class="active" data-app-action-sidebar-thread-active="true">暗色皮肤全界面适配</span></nav></aside><main class="main-surface dark-fixture" data-app-shell-main-surface="default"><header>暗色皮肤全界面适配</header><div data-user-message-bubble="true"><div data-markdown-text-tone="user-message"><p data-markdown-han-text="true">暗色皮肤里的用户消息必须清晰可读。</p></div></div><article data-response-annotation-conversation><p>正文、工具状态、评审卡和输入区都需要保持清晰。</p><section class="review-card"><div>已编辑 3 个文件</div><button class="review-action">审核</button><button class="review-row">src/settings/skin-runtime.ts</button><button class="review-row">scripts/native-ui-smoke.cjs</button></section></article><section class="composer-real" data-composer-layout="multiline"><input placeholder="随心输入"><button>完全访问</button><button>GPT-5.6 Sol</button></section></main></div>';
     const darkFixtureStyle = document.createElement('style');
-    darkFixtureStyle.textContent = 'html,body,#root{width:100%;height:100%;margin:0}.dark-fixture{position:relative;display:block;padding:24px}.dark-fixture>header{padding:12px 0}.dark-fixture article{max-width:700px;margin:80px auto}.review-card{margin-top:24px;padding:14px;border:1px solid var(--color-token-border-default);border-radius:12px;background:color-mix(in srgb,var(--color-surface-elevated-secondary) 50%,transparent)}.review-card button{color:var(--color-text-primary)}.review-action{float:right;background:var(--color-background-primary-soft-alpha)}.review-row{display:block;width:100%;margin-top:10px;padding:10px;text-align:left;border:0;background:color-mix(in srgb,var(--color-surface) 70%,transparent)}.composer-real{position:absolute;right:24px;bottom:16px;left:24px;padding:18px;border-radius:20px;background:color-mix(in srgb,var(--color-surface-elevated-secondary) 86%,transparent)}.composer-real input{width:70%;padding:8px;color:var(--color-text-primary);background:transparent;border:0}.composer-real button{margin-left:8px;color:var(--color-text-secondary);background:transparent;border:0}';
+    darkFixtureStyle.textContent = 'html,body,#root{width:100%;height:100%;margin:0}.dark-fixture{position:relative;display:block;padding:24px}.dark-fixture>header{padding:12px 0}.dark-fixture>[data-user-message-bubble]{max-width:520px;margin:24px 0 0 auto;padding:12px 16px;border-radius:16px}.dark-fixture article{max-width:700px;margin:60px auto}.review-card{margin-top:24px;padding:14px;border:1px solid var(--color-token-border-default);border-radius:12px;background:color-mix(in srgb,var(--color-surface-elevated-secondary) 50%,transparent)}.review-card button{color:var(--color-text-primary)}.review-action{float:right;background:var(--color-background-primary-soft-alpha)}.review-row{display:block;width:100%;margin-top:10px;padding:10px;text-align:left;border:0;background:color-mix(in srgb,var(--color-surface) 70%,transparent)}.composer-real{position:absolute;right:24px;bottom:16px;left:24px;padding:18px;border-radius:20px;background:color-mix(in srgb,var(--color-surface-elevated-secondary) 86%,transparent)}.composer-real input{width:70%;padding:8px;color:var(--color-text-primary);background:transparent;border:0}.composer-real button{margin-left:8px;color:var(--color-text-secondary);background:transparent;border:0}';
     document.head.append(darkFixtureStyle);
     NativeUI.applyRendererSkin('dragonball-nimbus', document);
     await new Promise(resolve => setTimeout(resolve, 50));
@@ -242,8 +272,10 @@ app.whenReady().then(async () => {
     const review = getComputedStyle(document.querySelector('.review-card'));
     const row = getComputedStyle(document.querySelector('.review-row'));
     const composer = getComputedStyle(document.querySelector('.composer-real'));
+    const userBubble = getComputedStyle(document.querySelector('[data-user-message-bubble]'));
+    const userText = getComputedStyle(document.querySelector('[data-markdown-text-tone="user-message"]'));
     const after = { buttons:document.querySelectorAll('button').length, inputs:document.querySelectorAll('input').length };
-    return { before, after, active:document.documentElement.getAttribute('data-harness-mix-skin'), lightReviewBackground, reviewBackground:review.backgroundColor, rowBackground:row.backgroundColor, composerBackground:composer.backgroundColor, color:review.color };
+    return { before, after, active:document.documentElement.getAttribute('data-harness-mix-skin'), lightReviewBackground, reviewBackground:review.backgroundColor, rowBackground:row.backgroundColor, composerBackground:composer.backgroundColor, color:review.color, userBubbleColor:userBubble.color, userTextColor:userText.color, userBubbleBackground:userBubble.backgroundColor };
   })()`);
   assert.deepEqual(darkSurfaceResult.after, darkSurfaceResult.before);
   assert.equal(darkSurfaceResult.active, 'genshin-night');
@@ -252,6 +284,9 @@ app.whenReady().then(async () => {
   assert.doesNotMatch(darkSurfaceResult.rowBackground, /255, 255, 255/);
   assert.doesNotMatch(darkSurfaceResult.composerBackground, /255, 255, 255/);
   assert.equal(darkSurfaceResult.color, 'rgb(240, 230, 200)');
+  assert.equal(darkSurfaceResult.userBubbleColor, 'rgb(240, 230, 200)');
+  assert.equal(darkSurfaceResult.userTextColor, 'rgb(240, 230, 200)');
+  assert.notEqual(darkSurfaceResult.userBubbleBackground, 'rgba(0, 0, 0, 0)');
   fs.writeFileSync(path.join(out, 'skin-dark-all-surfaces.png'), (await win.webContents.capturePage()).toPNG());
   win.destroy();
   console.log('PASS: real Electron native picker, graphical Harness handoff, official Account/Usage, sharded Storage metrics, live About version and all project Harness/model SVGs load');

package/scripts/pets-test.cjs

@@ -0,0 +1,146 @@
+'use strict';
+
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+const { createPetMarket, readAsarHeader } = require('../src/main/native/pets');
+
+function buildSyntheticAsar(targetPath, petName, blobContent) {
+  const tree = {
+    files: {
+      webview: {
+        files: {
+          assets: {
+            files: {
+              [`${petName}-spritesheet-v1-0123456789abcdef.webp`]: {
+                size: blobContent.length,
+                offset: '0',
+              },
+            },
+          },
+        },
+      },
+    },
+  };
+  const jsonBuf = Buffer.from(JSON.stringify(tree), 'utf8');
+  const jsonLen = jsonBuf.length;
+  const padLen = (4 - (jsonLen % 4)) % 4;
+  const pickleSize = 8 + jsonLen + padLen;
+  const head = Buffer.alloc(16);
+  head.writeUInt32LE(4, 0);
+  head.writeUInt32LE(pickleSize, 4);
+  head.writeUInt32LE(jsonLen + 4, 8);
+  head.writeUInt32LE(jsonLen, 12);
+  const asarBuf = Buffer.concat([head, jsonBuf, Buffer.alloc(padLen), blobContent]);
+  fs.writeFileSync(targetPath, asarBuf);
+}
+
+(async () => {
+  const testRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'harness-mix-pets-test-'));
+  const fakeAsarDir = path.join(testRoot, 'resources');
+  fs.mkdirSync(fakeAsarDir, { recursive: true });
+  const fakeAsarPath = path.join(fakeAsarDir, 'app.asar');
+  const fakeCodexBin = path.join(fakeAsarDir, 'codex.exe');
+  fs.writeFileSync(fakeCodexBin, '');
+
+  const fakeSpriteBlob = Buffer.from('RIFF....WEBPVP8 ...fake-sprite-data...', 'utf8');
+  buildSyntheticAsar(fakeAsarPath, 'synthetic-buddy', fakeSpriteBlob);
+
+  const petsDir = path.join(testRoot, 'installed-pets');
+  fs.mkdirSync(petsDir, { recursive: true });
+
+  const env = {
+    CODEXHOST_STOCK_CODEX_PATH: fakeCodexBin,
+    HARNESS_MIX_PETS_DIR: petsDir,
+  };
+
+  try {
+    // 1. Verify readAsarHeader
+    const asarInfo = readAsarHeader(fakeAsarPath);
+    assert.ok(asarInfo.blobBase > 16, 'asar blobBase should be past header');
+    const assetFiles = asarInfo.tree?.files?.webview?.files?.assets?.files;
+    assert.ok(assetFiles && typeof assetFiles === 'object', 'asset tree found');
+
+    // 2. Test createPetMarket catalog()
+    const market = createPetMarket({ env });
+    const catalog = market.catalog();
+    assert.equal(catalog.officialAvailable, true, 'synthetic asar should be available');
+    assert.equal(catalog.petsDir, petsDir, 'petsDir matches env override');
+
+    const officialPet = catalog.data.find(p => p.id === 'synthetic-buddy');
+    assert.ok(officialPet, 'synthetic-buddy should be present in catalog');
+    assert.equal(officialPet.source, 'official');
+    assert.equal(officialPet.installed, false);
+    assert.equal(officialPet.displayName, 'Synthetic Buddy');
+
+    // Curated community pets should also be listed
+    const curatedSample = catalog.data.find(p => p.id === 'komi-shouko-pixel');
+    assert.ok(curatedSample, 'curated community pet komi-shouko-pixel should be present');
+    assert.equal(curatedSample.installed, false);
+
+    // 3. Test preview() for official pet
+    const previewRes = market.preview({ id: 'synthetic-buddy' });
+    assert.equal(previewRes.id, 'synthetic-buddy');
+    assert.equal(previewRes.mime, 'image/webp');
+    const previewBuf = Buffer.from(previewRes.dataBase64, 'base64');
+    assert.equal(previewBuf.toString('utf8'), fakeSpriteBlob.toString('utf8'), 'preview base64 should match sprite blob');
+
+    // Invalid pet id checks
+    assert.throws(() => market.preview({ id: '../bad-pet' }), /Invalid pet id/);
+    assert.throws(() => market.preview({ id: 'non-existent-pet' }), /Unknown pet/);
+
+    // 4. Test install() of official pet
+    const installRes = await market.install({ id: 'synthetic-buddy' });
+    assert.equal(installRes.id, 'synthetic-buddy');
+    assert.equal(installRes.installed, true);
+    assert.equal(installRes.alreadyInstalled, false);
+
+    const installedDir = path.join(petsDir, 'synthetic-buddy');
+    assert.ok(fs.existsSync(installedDir), 'pet directory created');
+    const petJsonPath = path.join(installedDir, 'pet.json');
+    const petSpritePath = path.join(installedDir, 'spritesheet.webp');
+    assert.ok(fs.existsSync(petJsonPath), 'pet.json exists');
+    assert.ok(fs.existsSync(petSpritePath), 'spritesheet.webp exists');
+
+    const meta = JSON.parse(fs.readFileSync(petJsonPath, 'utf8'));
+    assert.equal(meta.id, 'synthetic-buddy');
+    assert.equal(meta.displayName, 'Synthetic Buddy');
+    assert.equal(meta.spritesheetPath, 'spritesheet.webp');
+
+    // Installing again should be a no-op returning alreadyInstalled: true
+    const reinstallRes = await market.install({ id: 'synthetic-buddy' });
+    assert.equal(reinstallRes.alreadyInstalled, true);
+
+    // Catalog should now reflect installed: true
+    const updatedCatalog = market.catalog();
+    const installedEntry = updatedCatalog.data.find(p => p.id === 'synthetic-buddy');
+    assert.ok(installedEntry, 'installed pet present');
+    assert.equal(installedEntry.installed, true);
+    assert.equal(installedEntry.source, 'installed');
+
+    // 5. Test community() fallback and search
+    const communityRes = await market.community({ search: 'komi' });
+    assert.ok(communityRes.total >= 1);
+    assert.equal(communityRes.data[0].id, 'komi-shouko-pixel');
+
+    // 6. Test uninstall()
+    const uninstallRes = market.uninstall({ id: 'synthetic-buddy' });
+    assert.equal(uninstallRes.id, 'synthetic-buddy');
+    assert.equal(uninstallRes.removed, true);
+    assert.ok(!fs.existsSync(installedDir), 'pet directory should be deleted');
+
+    // Calling uninstall again should return removed: false
+    const uninstallAgain = market.uninstall({ id: 'synthetic-buddy' });
+    assert.equal(uninstallAgain.removed, false);
+
+    // Catalog after uninstall reflects installed: false
+    const catalogAfterUninstall = market.catalog();
+    const uninstalledEntry = catalogAfterUninstall.data.find(p => p.id === 'synthetic-buddy');
+    assert.equal(uninstalledEntry.installed, false);
+
+    console.log('Pets market native tests passed successfully!');
+  } finally {
+    fs.rmSync(testRoot, { recursive: true, force: true });
+  }
+})();

package/src/main/native/launcher.js

@@ -13,6 +13,37 @@ const {
 } = require('./compatibility');
 
 const REPO_ROOT = path.resolve(__dirname, '../../..');
+const LIVE_HOST_HEARTBEAT_MS = 15000;
+
+function isCodexTaskEnvironment(env = process.env) {
+  return Boolean(
+    env.CODEX_THREAD_ID ||
+    env.CODEX_SESSION_ID ||
+    env.CODEX_INTERNAL_ORIGINATOR_OVERRIDE === 'Codex Desktop'
+  );
+}
+
+function readLiveHostInstance(dataDir, {
+  now = Date.now(),
+  isPidAlive = pidAlive,
+  maxAgeMs = LIVE_HOST_HEARTBEAT_MS,
+} = {}) {
+  try {
+    const instance = JSON.parse(fs.readFileSync(path.join(dataDir, 'runtime', 'instance.json'), 'utf8'));
+    const age = now - Number(instance.beatAt || 0);
+    if (
+      instance.mode !== 'native-host' ||
+      !Number.isInteger(instance.pid) ||
+      instance.pid <= 0 ||
+      age < 0 ||
+      age > maxAgeMs ||
+      !isPidAlive(instance.pid)
+    ) return null;
+    return instance;
+  } catch {
+    return null;
+  }
+}
 
 function cacheCodexRuntime(resources, cache) {
   fs.mkdirSync(cache, { recursive: true });
@@ -100,9 +131,12 @@ async function freePort() {
 async function launch(args = []) {
   const root = REPO_ROOT;
   const flags = new Set(args);
-  const unknown = args.filter(arg => !['--check', '--update', '--no-update'].includes(arg));
+  const unknown = args.filter(arg => !['--check', '--update', '--no-update', '--restart'].includes(arg));
   if (unknown.length) throw new Error('Unsupported Launcher arguments');
   const dataDir = nativeEnvironment().CODEXHOST_DATA_DIR;
+  if (!flags.has('--check') && isCodexTaskEnvironment()) {
+    throw new Error('拒绝从 Codex 任务内部启动或重启 Harness Mix：这会终止当前 Codex Desktop 和正在执行的任务。请在 Codex 外部终端运行 Start-Codex.cmd 或 npm start。');
+  }
   if (flags.has('--update')) {
     const outcome = await runUpdateFlow({
       root, dataDir, mode: 'apply',
@@ -113,6 +147,13 @@ async function launch(args = []) {
     }
     return;
   }
+  if (!flags.has('--check') && !flags.has('--restart')) {
+    const live = readLiveHostInstance(dataDir);
+    if (live) {
+      console.log(`[Harness Mix] 已在运行（Host PID ${live.pid}）；不会重启当前 Codex Desktop。需要显式重启时使用 npm start -- --restart。`);
+      return;
+    }
+  }
   const installation = await inspect();
   const compatibility = installation.version === 'unknown'
     ? { state: 'unverified', desktopVersion: 'unknown', evidence: null }
@@ -185,4 +226,10 @@ async function launch(args = []) {
   controller.on('exit', () => clearTimeout(bootTimer));
   return controller;
 }
-module.exports = { inspect, launch, cacheCodexRuntime };
+module.exports = {
+  inspect,
+  launch,
+  cacheCodexRuntime,
+  isCodexTaskEnvironment,
+  readLiveHostInstance,
+};

package/src/main/native/pets.js

@@ -75,6 +75,107 @@ function assetEntries(header) {
   return files && typeof files === 'object' ? files : {};
 }
 
+const CURATED_COMMUNITY_PETS = [
+  {
+    id: 'komi-shouko-pixel',
+    displayName: '古见硝子·像素Q版',
+    description: 'Pixel chibi Komi Shouko with long purple-black hair, a navy school uniform and shy gestures. Unofficial fan art.',
+    spriteVersionNumber: 2,
+    spritesheetUrl: 'https://codex-pets.net/assets/pets/v/1789522011437/komi-shouko-pixel/spritesheet.webp',
+    previewUrl: 'https://codex-pets.net/assets/pets/v/1789522011437/komi-shouko-pixel/preview.webp',
+    posterUrl: 'https://codex-pets.net/assets/pets/v/1789522011437/komi-shouko-pixel/poster.webp',
+    source: 'community',
+  },
+  {
+    id: 'rush',
+    displayName: 'Rush',
+    description: 'A confident training companion who meets every task with energy, focus, and a friendly smile.',
+    spriteVersionNumber: 2,
+    spritesheetUrl: 'https://codex-pets.net/assets/pets/v/1789517766302/rush/spritesheet.webp',
+    previewUrl: 'https://codex-pets.net/assets/pets/v/1789517766302/rush/preview.webp',
+    posterUrl: 'https://codex-pets.net/assets/pets/v/1789517766302/rush/poster.webp',
+    source: 'community',
+  },
+  {
+    id: 'itasca',
+    displayName: 'Itasca',
+    description: 'A cute cat with a larger-than-life personality who loves nothing more than attention, going outside, and his little toy worm.',
+    spriteVersionNumber: 2,
+    spritesheetUrl: 'https://codex-pets.net/assets/pets/v/1789484963415/itasca/spritesheet.webp',
+    previewUrl: 'https://codex-pets.net/assets/pets/v/1789484963415/itasca/preview.webp',
+    posterUrl: 'https://codex-pets.net/assets/pets/v/1789484963415/itasca/poster.webp',
+    source: 'community',
+  },
+  {
+    id: 'milk-mochi-soft',
+    displayName: 'Milk Mochi (牛奶麻薯)',
+    description: '말랑하게 걷고, 키보드로 일하고, 서류를 읽는 작은 우유떡 친구.',
+    spriteVersionNumber: 2,
+    spritesheetUrl: 'https://codex-pets.net/assets/pets/v/1789458022939/milk-mochi-soft/spritesheet.webp',
+    previewUrl: 'https://codex-pets.net/assets/pets/v/1789458022939/milk-mochi-soft/preview.webp',
+    posterUrl: 'https://codex-pets.net/assets/pets/v/1789458022939/milk-mochi-soft/poster.webp',
+    source: 'community',
+  },
+  {
+    id: 'yuanyuan',
+    displayName: 'Yuanyuan (圆圆)',
+    description: 'A black-and-white Jack Russell puppy with a red collar.',
+    spriteVersionNumber: 1,
+    spritesheetUrl: 'https://codex-pets.net/assets/pets/v/1789465085706/yuanyuan/spritesheet.webp',
+    previewUrl: 'https://codex-pets.net/assets/pets/v/1789465085706/yuanyuan/preview.webp',
+    posterUrl: 'https://codex-pets.net/assets/pets/v/1789465085706/yuanyuan/poster.webp',
+    source: 'community',
+  },
+  {
+    id: 'jaehyun-next-door',
+    displayName: 'Jaehyun Next Door',
+    description: 'An unofficial, fan-made desktop companion inspired by BOYNEXTDOOR Myung Jaehyun.',
+    spriteVersionNumber: 2,
+    spritesheetUrl: 'https://codex-pets.net/assets/pets/v/1789469671052/jaehyun-next-door/spritesheet.webp',
+    previewUrl: 'https://codex-pets.net/assets/pets/v/1789469671052/jaehyun-next-door/preview.webp',
+    posterUrl: 'https://codex-pets.net/assets/pets/v/1789469671052/jaehyun-next-door/poster.webp',
+    source: 'community',
+  },
+  {
+    id: 'iu-beside-you',
+    displayName: 'IU Beside You',
+    description: 'An unofficial, fan-made desktop companion inspired by IU.',
+    spriteVersionNumber: 2,
+    spritesheetUrl: 'https://codex-pets.net/assets/pets/v/1789469620585/iu-beside-you/spritesheet.webp',
+    previewUrl: 'https://codex-pets.net/assets/pets/v/1789469620585/iu-beside-you/preview.webp',
+    posterUrl: 'https://codex-pets.net/assets/pets/v/1789469620585/iu-beside-you/poster.webp',
+    source: 'community',
+  },
+  {
+    id: 'haaap',
+    displayName: 'Haaap',
+    description: '작업 중 바람을 계속 빨아들이는 분홍색 펫. 일반 동작 9개.',
+    spriteVersionNumber: 1,
+    spritesheetUrl: 'https://codex-pets.net/assets/pets/v/1789453516001/haaap/spritesheet.webp',
+    previewUrl: 'https://codex-pets.net/assets/pets/v/1789453516001/haaap/preview.webp',
+    posterUrl: 'https://codex-pets.net/assets/pets/v/1789453516001/haaap/poster.webp',
+    source: 'community',
+  },
+];
+
+function getProxyDispatcher(env = process.env) {
+  const proxy = env.HTTPS_PROXY || env.HTTP_PROXY || env.ALL_PROXY;
+  if (!proxy) return undefined;
+  try {
+    const { ProxyAgent } = require('undici');
+    return new ProxyAgent(proxy);
+  } catch {
+    return undefined;
+  }
+}
+
+async function fetchWithProxy(url, options = {}, env = process.env) {
+  const dispatcher = getProxyDispatcher(env);
+  const opts = { ...options };
+  if (dispatcher) opts.dispatcher = dispatcher;
+  return fetch(url, opts);
+}
+
 function createPetMarket({ env = process.env } = {}) {
   const headerCache = new Map(); // asarPath -> { mtimeMs, header }
   const previewCache = new Map(); // cacheKey -> { mime, dataBase64 }
@@ -130,6 +231,7 @@ function createPetMarket({ env = process.env } = {}) {
         displayName: typeof meta.displayName === 'string' && meta.displayName ? meta.displayName : titleCase(entry.name),
         description: typeof meta.description === 'string' ? meta.description : '',
         source: 'installed',
+        spriteVersionNumber: meta.spriteVersionNumber || 1,
         spritesheet: { name: spritesheet },
       });
     }
@@ -145,6 +247,7 @@ function createPetMarket({ env = process.env } = {}) {
       const data = [
         ...installed,
         ...official.pets.filter(pet => !installedIds.has(pet.id)).map(pet => ({ ...pet, installed: false })),
+        ...CURATED_COMMUNITY_PETS.filter(pet => !installedIds.has(pet.id) && !official.pets.some(o => o.id === pet.id)).map(pet => ({ ...pet, installed: false })),
       ];
       for (const pet of data) pet.installed = pet.installed ?? installedIds.has(pet.id);
       return {
@@ -154,6 +257,47 @@ function createPetMarket({ env = process.env } = {}) {
       };
     },
 
+    async community({ page = 1, pageSize = 24, sort = 'trending', search = '' } = {}) {
+      const installed = installedPets();
+      const installedIds = new Set(installed.map(p => p.id));
+      const queryParams = new URLSearchParams({
+        page: String(page),
+        pageSize: String(pageSize),
+        sort: String(sort || 'trending'),
+      });
+      if (search && String(search).trim()) queryParams.set('search', String(search).trim());
+      const apiUrl = `https://codex-pets.net/api/pets?${queryParams.toString()}`;
+      try {
+        const res = await fetchWithProxy(apiUrl, { signal: AbortSignal.timeout(8000) }, env);
+        if (!res.ok) throw new Error(`HTTP ${res.status}`);
+        const json = await res.json();
+        const pets = (json.pets || []).map(p => ({
+          id: p.id,
+          displayName: p.displayName || p.id,
+          description: p.description || '',
+          source: 'community',
+          spriteVersionNumber: p.spriteVersionNumber || 1,
+          spritesheetUrl: p.spritesheetUrl,
+          previewUrl: p.previewUrl,
+          posterUrl: p.posterUrl,
+          downloadUrl: p.downloadUrl,
+          installed: installedIds.has(p.id),
+        }));
+        return { data: pets, total: json.total || pets.length, source: 'online' };
+      } catch {
+        let filtered = CURATED_COMMUNITY_PETS;
+        if (search && String(search).trim()) {
+          const q = String(search).trim().toLowerCase();
+          filtered = filtered.filter(p => p.id.toLowerCase().includes(q) || p.displayName.toLowerCase().includes(q) || p.description.toLowerCase().includes(q));
+        }
+        return {
+          data: filtered.map(p => ({ ...p, installed: installedIds.has(p.id) })),
+          total: filtered.length,
+          source: 'curated-fallback',
+        };
+      }
+    },
+
     preview({ id } = {}) {
       if (!PET_ID_PATTERN.test(String(id || ''))) throw new Error('Invalid pet id');
       const cached = previewCache.get(id);
@@ -184,34 +328,51 @@ function createPetMarket({ env = process.env } = {}) {
       return result;
     },
 
-    install({ id } = {}) {
+    async install({ id, displayName, description, spritesheetUrl, spriteVersionNumber } = {}) {
       if (!PET_ID_PATTERN.test(String(id || ''))) throw new Error('Invalid pet id');
-      const official = officialPets();
-      const pet = official.pets.find(entry => entry.id === id);
-      if (!pet) throw new Error(official.asarPath ? `桌宠 ${id} 不在官方预载目录中` : '未找到 Codex Desktop 安装，无法获取官方桌宠');
       const targetDir = path.join(petsDirectory(env), id);
       const petJsonPath = path.join(targetDir, 'pet.json');
       const spritesheetPath = path.join(targetDir, 'spritesheet.webp');
       if (fs.existsSync(petJsonPath) && fs.existsSync(spritesheetPath)) {
         return { id, path: targetDir, installed: true, alreadyInstalled: true };
       }
-      const fd = fs.openSync(official.asarPath, 'r');
+
+      const curated = CURATED_COMMUNITY_PETS.find(p => p.id === id);
+      const targetUrl = spritesheetUrl || curated?.spritesheetUrl;
+      const targetName = displayName || curated?.displayName || titleCase(id);
+      const targetDesc = description !== undefined ? description : (curated?.description || '');
+      const targetVer = spriteVersionNumber || curated?.spriteVersionNumber || 1;
+
       let buffer;
-      try {
-        buffer = Buffer.alloc(pet.spritesheet.size);
-        const position = official.header.blobBase + Number(pet.spritesheet.offset);
-        if (fs.readSync(fd, buffer, 0, pet.spritesheet.size, position) !== pet.spritesheet.size) {
-          throw new Error('Spritesheet truncated');
+      if (targetUrl) {
+        const res = await fetchWithProxy(targetUrl, { signal: AbortSignal.timeout(30000) }, env);
+        if (!res.ok) throw new Error(`Download failed (${res.status})`);
+        const arrayBuf = await res.arrayBuffer();
+        buffer = Buffer.from(arrayBuf);
+      } else {
+        const official = officialPets();
+        const pet = official.pets.find(entry => entry.id === id);
+        if (!pet) throw new Error(official.asarPath ? `桌宠 ${id} 不在官方预载目录中` : '未找到 Codex Desktop 安装，无法获取官方桌宠');
+        const fd = fs.openSync(official.asarPath, 'r');
+        try {
+          buffer = Buffer.alloc(pet.spritesheet.size);
+          const position = official.header.blobBase + Number(pet.spritesheet.offset);
+          if (fs.readSync(fd, buffer, 0, pet.spritesheet.size, position) !== pet.spritesheet.size) {
+            throw new Error('Spritesheet truncated');
+          }
+        } finally {
+          fs.closeSync(fd);
         }
-      } finally {
-        fs.closeSync(fd);
       }
+
+      if (buffer.length > MAX_SPRITESHEET_BYTES) throw new Error('Spritesheet too large');
       fs.mkdirSync(targetDir, { recursive: true });
       fs.writeFileSync(spritesheetPath, buffer);
       fs.writeFileSync(petJsonPath, `${JSON.stringify({
         id,
-        displayName: pet.displayName,
-        description: pet.description,
+        displayName: targetName,
+        description: targetDesc,
+        spriteVersionNumber: targetVer,
         spritesheetPath: 'spritesheet.webp',
       }, null, 2)}\n`);
       previewCache.delete(id);
@@ -231,4 +392,4 @@ function createPetMarket({ env = process.env } = {}) {
   };
 }
 
-module.exports = { createPetMarket, petsDirectory, resolveAsarPath, readAsarHeader };
+module.exports = { createPetMarket, petsDirectory, resolveAsarPath, readAsarHeader, CURATED_COMMUNITY_PETS };