@wax0629/pi-manager 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wax0629
+
+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,93 @@
+# Pi Manager
+
+Pi 的本地控制面。不 fork Pi，不改项目 `.pi`。在页面里管供应商、模型和 Thinking，确认后备份并写入 `~/.pi/agent`，给普通 `pi` 命令用。
+
+## 能做什么
+
+- **供应商与账号**：新增 OpenAI 兼容中转、从本机 Pi 勾选导入、Pi 原生登录。新增时可请求上游 `/models`，勾选后再保存。
+- **模型资源库**：完整目录、Ctrl+P 循环列表、默认模型、Thinking 映射、Context 窗口。
+- **导入本机 Pi**：备份后合并写入 `~/.pi/agent` 的 `settings.json` / `models.json` / `auth.json`，可回滚。
+
+日常路径：改候选配置 → **导入本机 Pi** → 退出当前 Pi 再进。`/reload` 不会重读模型和循环列表。
+
+## 不做什么
+
+- 不 fork、不改 Pi 源码。
+- 不改用户项目里的 `.pi`。
+- 不把 refresh token 拷进 Manager。
+- 不做 Antigravity 专用 OAuth；Antigravity 当本机 OpenAI 兼容桥（`127.0.0.1:8045/v1`）。
+
+## 要求
+
+- Node 20+
+- 已安装官方 [Pi](https://github.com/badlogic/pi-mono)（`pi` 在 PATH 里）
+
+## 运行
+
+```bash
+npx @wax0629/pi-manager
+```
+
+或全局安装：
+
+```bash
+npm i -g @wax0629/pi-manager
+pi-manager
+```
+
+会起 `http://127.0.0.1:8670` 并打开浏览器。`pi-manager --help` 看 `--port` / `--host` / `--no-open`。端口已被占用时，会打开已有实例，不报崩。
+
+从源码跑（开发）：
+
+```bash
+npm start          # API  http://127.0.0.1:8670
+npm run dev:web    # UI   http://localhost:5173/
+```
+
+从源码走 CLI 时先 `npm --prefix web run build`，再 `npx pi-manager`。
+
+## 日常用法
+
+1. 打开供应商页：新增 API，或从本机 Pi 勾选导入，或登录原生渠道。
+2. 打开模型资源库：核对目录、默认模型、循环列表、Thinking。
+3. 打开「导入本机 Pi」，确认后写入 `~/.pi/agent`。
+4. 退出正在跑的 Pi，重新打开。用 `pi --list-models --offline` 核对。
+
+导坏了用同一页的 **回滚本机 Pi**。
+
+## 数据放哪
+
+| 路径 | 用途 |
+| --- | --- |
+| `~/.pi-manager/` | Manager 状态、密钥存储、导入备份 |
+| `~/.pi/agent/` | 本机 Pi 真正读取的配置 |
+
+密钥不进 `state.json`，也不在 API 响应里回显。
+
+## 开发
+
+```bash
+npm test
+npm run check
+npm --prefix web run lint
+npm --prefix web run build
+```
+
+`web/dist` 会打进 npm 包，所以跟踪在 git 里。发版前再 build 一次。
+
+设计草案仍在 `docs/`，以本 README 和当前 UI 为准。隔离 Profile 的 apply / launch / stop 后端还在，页面已拿掉，不是日常路径。
+
+## 社区
+
+这不是 Pi extension / skill / theme，**不能**进 [pi.dev/packages](https://pi.dev/packages)（那里只收 `pi install npm:` 的包）。
+
+可以发到：
+
+- Discord：https://discord.com/invite/3cU7Bz4UPx
+- GitHub Discussions（分享工具）：https://github.com/earendil-works/pi/discussions
+
+npm 包：[`@wax0629/pi-manager`](https://www.npmjs.com/package/@wax0629/pi-manager)。未 scoped 的 `pi-manager` 于 2022 年下架，没有抢回。
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@wax0629/pi-manager",
+  "version": "0.1.0",
+  "description": "Local control plane for Pi: providers, models, and live import into ~/.pi/agent.",
+  "type": "module",
+  "bin": {
+    "pi-manager": "src/cli.mjs"
+  },
+  "files": [
+    "src",
+    "web/dist/index.html",
+    "web/dist/assets",
+    "web/dist/favicon.svg",
+    "web/dist/icons.svg",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "start": "node src/server.mjs",
+    "pi-manager": "node src/cli.mjs",
+    "dev": "node --watch src/server.mjs",
+    "dev:web": "npm --prefix web run dev",
+    "build:web": "npm --prefix web run build",
+    "prepublishOnly": "npm --prefix web install && npm --prefix web run build",
+    "test": "node --test",
+    "check": "node --check src/server.mjs && node --check src/store.mjs && node --check src/profile.mjs && node --check src/gateway.mjs && node --check src/pi-auth.mjs && node --check src/pi-import.mjs && node --check src/provider-discovery.mjs && node --check src/pi-apply.mjs && node --check src/pi-native.mjs && node --check src/cli.mjs"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT",
+  "author": "wax0629",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wax0629/pi-manager.git"
+  },
+  "homepage": "https://github.com/wax0629/pi-manager",
+  "bugs": {
+    "url": "https://github.com/wax0629/pi-manager/issues"
+  },
+  "keywords": [
+    "pi",
+    "coding-agent",
+    "openai-compatible",
+    "local-first",
+    "model-management"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/cli.mjs

@@ -0,0 +1,155 @@
+#!/usr/bin/env node
+import { execFile } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const HELP = `Pi Manager — 本地控制面
+
+用法:
+  pi-manager [选项]
+
+选项:
+  --host <地址>   监听地址（默认 127.0.0.1，或 PI_MANAGER_HOST）
+  --port <端口>   监听端口（默认 8670，或 PI_MANAGER_PORT）
+  --no-open       不打开浏览器
+  -h, --help      显示帮助
+
+缺 web/dist 时先运行: npm --prefix web run build
+`;
+
+export function parseCliArgs(argv) {
+  const args = { host: undefined, port: undefined, open: true, help: false };
+  for (let i = 0; i < argv.length; i += 1) {
+    const token = argv[i];
+    if (token === "--help" || token === "-h") {
+      args.help = true;
+      continue;
+    }
+    if (token === "--no-open") {
+      args.open = false;
+      continue;
+    }
+    if (token === "--host") {
+      args.host = requireValue(argv, ++i, "--host");
+      continue;
+    }
+    if (token.startsWith("--host=")) {
+      args.host = token.slice("--host=".length);
+      continue;
+    }
+    if (token === "--port" || token === "-p") {
+      args.port = parsePort(requireValue(argv, ++i, token));
+      continue;
+    }
+    if (token.startsWith("--port=")) {
+      args.port = parsePort(token.slice("--port=".length));
+      continue;
+    }
+    throw new Error(`未知参数: ${token}`);
+  }
+  return args;
+}
+
+function requireValue(argv, index, flag) {
+  const value = argv[index];
+  if (!value || value.startsWith("-")) throw new Error(`${flag} 需要一个值`);
+  return value;
+}
+
+function parsePort(value) {
+  const port = Number(value);
+  if (!Number.isInteger(port) || port < 1 || port > 65535) {
+    throw new Error(`无效端口: ${value}`);
+  }
+  return port;
+}
+
+export function hasWebUi(publicDir) {
+  return fs.existsSync(path.join(publicDir, "index.html"));
+}
+
+export function browserCommand(url, platform = process.platform) {
+  if (platform === "darwin") return { command: "open", args: [url] };
+  if (platform === "win32") return { command: "cmd", args: ["/c", "start", "", url] };
+  return { command: "xdg-open", args: [url] };
+}
+
+export function openBrowser(url, { execFileImpl = execFile, platform = process.platform } = {}) {
+  const { command, args } = browserCommand(url, platform);
+  return new Promise((resolve, reject) => {
+    execFileImpl(command, args, (error) => error ? reject(error) : resolve());
+  });
+}
+
+export function publicUrl(host, port) {
+  const hostname = host === "0.0.0.0" ? "127.0.0.1" : host;
+  return `http://${hostname}:${port}`;
+}
+
+async function main(argv = process.argv.slice(2)) {
+  let args;
+  try {
+    args = parseCliArgs(argv);
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+    return 1;
+  }
+  if (args.help) {
+    process.stdout.write(HELP);
+    return 0;
+  }
+  if (args.host) process.env.PI_MANAGER_HOST = args.host;
+  if (args.port) process.env.PI_MANAGER_PORT = String(args.port);
+
+  const { startManagerServer, publicDir, store } = await import("./server.mjs");
+  if (!hasWebUi(publicDir)) {
+    console.error("缺少 web/dist/index.html。先运行: npm --prefix web run build");
+    process.exitCode = 1;
+    return 1;
+  }
+
+  const host = process.env.PI_MANAGER_HOST || "127.0.0.1";
+  const port = Number(process.env.PI_MANAGER_PORT || 8670);
+  const url = publicUrl(host, port);
+  let started = false;
+  try {
+    await startManagerServer({ host, port });
+    started = true;
+    const gateway = store.get().gateway;
+    console.log(`Pi Manager ${url}`);
+    console.log(`Pi gateway: http://${gateway.host}:${gateway.port}/v1`);
+  } catch (error) {
+    if (error && error.code === "EADDRINUSE") {
+      console.log(`Pi Manager 已在运行: ${url}`);
+    } else {
+      console.error(`Pi Manager 启动失败: ${error instanceof Error ? error.message : String(error)}`);
+      process.exitCode = 1;
+      return 1;
+    }
+  }
+
+  if (args.open) {
+    try {
+      await openBrowser(url);
+    } catch (error) {
+      console.error(`无法打开浏览器: ${error instanceof Error ? error.message : String(error)}`);
+      console.error(`请手动打开 ${url}`);
+    }
+  }
+
+  if (!started) return 0;
+  await new Promise(() => {});
+  return 0;
+}
+
+const isDirectRun = process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);
+if (isDirectRun) {
+  main().catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+  });
+}
+
+export { main, HELP };

package/src/defaults.mjs

@@ -0,0 +1,215 @@
+import crypto from "node:crypto";
+import path from "node:path";
+import { buildThinkingLevelMap } from "./thinking.mjs";
+
+function catalogModel(model) {
+  return {
+    ...model,
+    thinkingLevelMap: buildThinkingLevelMap(model),
+    thinkingMapSource: "provider-default",
+    thinkingMapVerified: false
+  };
+}
+
+const qiniuModels = [
+  {
+    id: "gpt-5.6-sol",
+    name: "GPT-5.6 Sol",
+    family: "GPT-5.6",
+    reasoning: true,
+    thinkingLevels: ["off", "low", "medium", "high", "xhigh"],
+    input: ["text", "image"],
+    contextWindow: 1050000,
+    maxTokens: 128000,
+    cost: { input: 5, output: 20, cacheRead: 0.5, cacheWrite: 5 }
+  },
+  {
+    id: "gpt-5.6-luna",
+    name: "GPT-5.6 Luna",
+    family: "GPT-5.6",
+    reasoning: true,
+    thinkingLevels: ["off", "low", "medium", "high", "xhigh"],
+    input: ["text", "image"],
+    contextWindow: 1050000,
+    maxTokens: 128000,
+    cost: { input: 4, output: 16, cacheRead: 0.4, cacheWrite: 4 }
+  },
+  {
+    id: "gpt-5.6-terra",
+    name: "GPT-5.6 Terra",
+    family: "GPT-5.6",
+    reasoning: true,
+    thinkingLevels: ["off", "low", "medium", "high", "xhigh"],
+    input: ["text", "image"],
+    contextWindow: 1050000,
+    maxTokens: 128000,
+    cost: { input: 4, output: 16, cacheRead: 0.4, cacheWrite: 4 }
+  },
+  {
+    id: "grok-4.6",
+    name: "Grok 4.6",
+    family: "Grok",
+    reasoning: true,
+    thinkingLevels: ["low", "medium", "high", "xhigh"],
+    input: ["text", "image"],
+    contextWindow: 500000,
+    maxTokens: 64000,
+    cost: { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3 }
+  }
+].map(catalogModel);
+
+const antigravityModels = [
+  {
+    id: "gemini-3.8-flash-tiered",
+    name: "Gemini 3.8 Flash Tiered",
+    family: "Gemini",
+    reasoning: true,
+    thinkingLevels: ["off", "low", "medium", "high"],
+    input: ["text", "image"],
+    contextWindow: 1000000,
+    maxTokens: 32000,
+    cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }
+  },
+  {
+    id: "gemini-3.1-pro-high",
+    name: "Gemini 3.1 Pro High",
+    family: "Gemini",
+    reasoning: true,
+    thinkingLevels: ["off", "low", "medium", "high"],
+    input: ["text", "image"],
+    contextWindow: 1000000,
+    maxTokens: 32000,
+    cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }
+  }
+].map(catalogModel);
+
+const codexModels = [
+  {
+    id: "gpt-5.6-luna",
+    name: "GPT-5.6 Luna",
+    family: "GPT-5.6",
+    reasoning: true,
+    thinkingLevels: ["off", "low", "medium", "high", "xhigh", "max"],
+    input: ["text", "image"],
+    contextWindow: 1050000,
+    maxTokens: 128000,
+    cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }
+  },
+  {
+    id: "gpt-5.6-sol",
+    name: "GPT-5.6 Sol",
+    family: "GPT-5.6",
+    reasoning: true,
+    thinkingLevels: ["off", "low", "medium", "high", "xhigh", "max"],
+    input: ["text", "image"],
+    contextWindow: 1050000,
+    maxTokens: 128000,
+    cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }
+  },
+  {
+    id: "gpt-5.6-terra",
+    name: "GPT-5.6 Terra",
+    family: "GPT-5.6",
+    reasoning: true,
+    thinkingLevels: ["off", "low", "medium", "high", "xhigh", "max"],
+    input: ["text", "image"],
+    contextWindow: 1050000,
+    maxTokens: 128000,
+    cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }
+  }
+].map(catalogModel);
+
+export function createSeedProviders({ projectRoot }) {
+  const bridgePath = path.join(projectRoot, "antigravity-bridge");
+  return [
+    {
+      id: "qiniu",
+      name: "七牛云",
+      kind: "openai-api",
+      baseUrl: "https://llmapi.qiniu.io/v1",
+      credentialEnv: "QINIU_API_KEY",
+      description: "OpenAI 兼容 API",
+      models: qiniuModels
+    },
+    {
+      id: "antigravity",
+      name: "Google Antigravity",
+      kind: "local-bridge",
+      baseUrl: "http://127.0.0.1:8045/v1",
+      bridgePath,
+      credentialEnv: "API_KEY",
+      description: "本地订阅桥接",
+      models: antigravityModels
+    },
+    {
+      id: "openai-codex",
+      name: "OpenAI Codex",
+      kind: "native-subscription",
+      piProvider: "openai-codex",
+      description: "Pi 原生官方订阅",
+      models: codexModels
+    }
+  ];
+}
+
+export function seedStoreProviders(store, { projectRoot } = {}) {
+  const root = projectRoot || store.get().targetProject;
+  store.update((state) => {
+    state.providers = createSeedProviders({ projectRoot: root });
+    state.active = {
+      providerId: "qiniu",
+      modelId: "gpt-5.6-luna",
+      thinking: "medium"
+    };
+    state.cycle = {
+      modelRefs: [
+        "qiniu/gpt-5.6-luna",
+        "openai-codex/gpt-5.6-luna",
+        "qiniu/gpt-5.6-sol"
+      ]
+    };
+  });
+  return store;
+}
+
+export function createDefaultState({ projectRoot }) {
+  return {
+    version: 1,
+    targetProject: projectRoot,
+    active: {
+      providerId: "",
+      modelId: "",
+      thinking: "off"
+    },
+    cycle: {
+      modelRefs: []
+    },
+    gateway: {
+      enabled: true,
+      host: "127.0.0.1",
+      port: 8675,
+      clientKey: crypto.randomBytes(24).toString("base64url")
+    },
+    providers: [],
+    runtime: {
+      profilePath: "",
+      extensionPath: "",
+      configRevision: 1,
+      appliedRevision: 0,
+      appliedSnapshot: null,
+      lastAppliedAt: null,
+      lastLaunchAt: null,
+      lastLaunchPid: null,
+      lastStopAt: null,
+      lastError: null,
+      lastLiveImportAt: null,
+      lastLiveBackupDir: "",
+      lastLiveVerify: null,
+      events: []
+    }
+  };
+}
+
+export function clone(value) {
+  return JSON.parse(JSON.stringify(value));
+}