nai-xiaolong-codex-pet 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andonis75
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,91 @@
+# 奶小龙 Codex 桌宠
+
+奶小龙是一个给 Codex Desktop 用的自定义桌宠。它会出现在 Codex 的 Pets 功能里，根据 Codex 的空闲、等待、工作、审查、失败等状态切换动作。
+
+![奶小龙预览](preview.png)
+
+它不是独立桌宠软件，需要先安装 Codex Desktop。
+
+## 安装
+
+### 方式一：npx
+
+如果你安装了 Node.js，可以直接运行：
+
+```bash
+npx nai-xiaolong-codex-pet install
+```
+
+然后打开 Codex：
+
+```text
+Settings -> Appearance -> Pets -> Refresh -> Select 奶小龙 -> Wake Pet
+```
+
+### 方式二：下载 zip
+
+下载 Release 里的 `nai-xiaolong-codex-pet-v1.0.0.zip`，解压后在 PowerShell 里运行：
+
+```powershell
+powershell -ExecutionPolicy Bypass -File .\install.ps1
+```
+
+然后打开 Codex：
+
+```text
+Settings -> Appearance -> Pets -> Refresh -> Select 奶小龙 -> Wake Pet
+```
+
+中文界面一般是：
+
+```text
+设置 -> 外观 -> Pets -> 刷新 -> 选择 奶小龙 -> Wake Pet
+```
+
+## 更新
+
+下载新版 Release，重新运行 `install.ps1` 即可。脚本会在覆盖前保留旧版本备份。
+
+## 卸载
+
+如果是用 npx 安装的，可以运行：
+
+```bash
+npx nai-xiaolong-codex-pet uninstall
+```
+
+在解压目录运行：
+
+```powershell
+powershell -ExecutionPolicy Bypass -File .\uninstall.ps1
+```
+
+脚本会把已安装目录移动为备份，不会删除你的其他 Codex 文件。
+
+## 文件结构
+
+```text
+pet/
+  pet.json
+  spritesheet.webp
+install.ps1
+uninstall.ps1
+README.md
+```
+
+## 兼容性
+
+当前宠物包遵循 Codex Desktop 自定义宠物图集格式：
+
+- 图集尺寸：`1536x1872`
+- 网格：`8 列 x 9 行`
+- 单格：`192x208`
+- 背景：透明
+
+## 说明
+
+如果安装后没有看到奶小龙，先重启 Codex，或在 Pets 设置页点击 Refresh。
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+
+const petId = "nai-xiaolong";
+const displayName = "奶小龙";
+const packageRoot = path.resolve(__dirname, "..");
+const sourceDir = path.join(packageRoot, "pet");
+const targetRoot = path.join(os.homedir(), ".codex", "pets");
+const targetDir = path.join(targetRoot, petId);
+
+function usage() {
+  console.log(`奶小龙 Codex Pet
+
+Usage:
+  npx nai-xiaolong-codex-pet install
+  npx nai-xiaolong-codex-pet uninstall
+
+After install:
+  Codex -> Settings -> Appearance -> Pets -> Refresh -> Select ${displayName} -> Wake Pet
+`);
+}
+
+function copyDir(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+function removeDir(dir) {
+  fs.rmSync(dir, { recursive: true, force: true });
+}
+
+function timestamp() {
+  const d = new Date();
+  const pad = (n) => String(n).padStart(2, "0");
+  return [
+    d.getFullYear(),
+    pad(d.getMonth() + 1),
+    pad(d.getDate()),
+    "-",
+    pad(d.getHours()),
+    pad(d.getMinutes()),
+    pad(d.getSeconds()),
+  ].join("");
+}
+
+function ensureSource() {
+  for (const file of ["pet.json", "spritesheet.webp"]) {
+    const filePath = path.join(sourceDir, file);
+    if (!fs.existsSync(filePath)) {
+      throw new Error(`Missing package asset: ${filePath}`);
+    }
+  }
+}
+
+function install() {
+  ensureSource();
+  fs.mkdirSync(targetRoot, { recursive: true });
+
+  if (fs.existsSync(targetDir)) {
+    const backupDir = `${targetDir}.backup-${timestamp()}`;
+    fs.cpSync(targetDir, backupDir, { recursive: true });
+    removeDir(targetDir);
+    console.log(`Existing installation backed up to: ${backupDir}`);
+  }
+
+  copyDir(sourceDir, targetDir);
+  console.log(`Installed ${displayName} Codex pet.`);
+  console.log(`Path: ${targetDir}`);
+  console.log("");
+  console.log("Next:");
+  console.log(`1. Restart Codex, or open Settings -> Appearance -> Pets and click Refresh.`);
+  console.log(`2. Select ${displayName}.`);
+  console.log("3. Click Wake Pet.");
+}
+
+function uninstall() {
+  if (!fs.existsSync(targetDir)) {
+    console.log(`${displayName} is not installed at: ${targetDir}`);
+    return;
+  }
+  const removedDir = `${targetDir}.removed-${timestamp()}`;
+  fs.renameSync(targetDir, removedDir);
+  console.log(`Removed ${displayName} Codex pet.`);
+  console.log(`Backup kept at: ${removedDir}`);
+  console.log("Restart Codex or refresh the Pets settings page.");
+}
+
+function main() {
+  const command = process.argv[2] || "install";
+  if (command === "install") {
+    install();
+    return;
+  }
+  if (command === "uninstall" || command === "remove") {
+    uninstall();
+    return;
+  }
+  if (command === "help" || command === "--help" || command === "-h") {
+    usage();
+    return;
+  }
+  console.error(`Unknown command: ${command}`);
+  usage();
+  process.exitCode = 1;
+}
+
+try {
+  main();
+} catch (error) {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exitCode = 1;
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "nai-xiaolong-codex-pet",
+  "version": "1.0.0",
+  "description": "Codex desktop pet: 奶小龙",
+  "license": "MIT",
+  "author": "Andonis75",
+  "type": "commonjs",
+  "bin": {
+    "nai-xiaolong-codex-pet": "bin/cli.js"
+  },
+  "files": [
+    "bin",
+    "pet",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Andonis75/nai-xiaolong-codex-pet.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Andonis75/nai-xiaolong-codex-pet/issues"
+  },
+  "homepage": "https://github.com/Andonis75/nai-xiaolong-codex-pet#readme",
+  "keywords": [
+    "codex",
+    "codex-pet",
+    "desktop-pet",
+    "pet",
+    "nai-xiaolong"
+  ],
+  "scripts": {
+    "pack:check": "npm pack --dry-run"
+  }
+}

package/pet/pet.json

@@ -0,0 +1,6 @@
+{
+  "id": "nai-xiaolong",
+  "displayName": "\u5976\u5c0f\u9f99",
+  "description": "\u4e00\u53ea\u5976\u9ec4\u8272\u7684 Codex \u684c\u9762\u5c0f\u9f99\u5ba0\u7269\u3002",
+  "spritesheetPath": "spritesheet.webp"
+}