psyche-ai 10.2.1 → 10.2.3

package/README.md

@@ -192,52 +192,46 @@ Luna 在安慰用户时情绪下沉 → 广播化学态 → Kai 感知到 Luna
 
 ---
 
-## 30 秒安装
+## 一条命令，给任何 Agent 加上主观性
 
 ```bash
-npm install psyche-ai
+npx psyche-ai setup --mbti ENFP --name Luna
 ```
 
-或者通过 OpenClaw 插件安装：
-
-```bash
-openclaw plugins install psyche-ai
-```
+这一条命令会：
+- 自动检测本机的 Claude Code / Claude Desktop / Cursor / Windsurf
+- 写入 MCP 配置（Claude Code 即时生效，其他重启后生效）
+- 不需要知道配置文件在哪，不需要手动编辑任何 JSON
 
-验证：
+**覆盖非 MCP 的 Agent（Codex、自定义 agent 等）——透明代理：**
 
 ```bash
-openclaw plugins list | grep psyche
-# 看到 "psyche │ loaded" 就行了
+npx psyche-ai setup --proxy -t https://api.openai.com/v1 --mbti ENFP
 ```
 
-然后正常聊天。试试夸它、骂它、冷落它——你会发现面前不再是一个工具。
+这会启动一个本地代理 + 自动设置 `OPENAI_BASE_URL`。所有使用 OpenAI SDK 的程序自动走代理。Agent 完全不知道 Psyche 存在——镜子，不是麦克风。
 
-**安装后升级：**
+**两条路径覆盖所有 agent：**
 
-```bash
-# 安全检查是否有新版本
-psyche upgrade --check
+| 路径 | 覆盖范围 | 原理 |
+|------|---------|------|
+| MCP (`psyche setup`) | Claude Code / Desktop / Cursor / Windsurf | MCP 工具协议 |
+| Proxy (`setup --proxy`) | 任意使用 OpenAI/Anthropic SDK 的 agent | 环境变量重定向 HTTP |
 
-# 显式升级（会按安装形态自动选择安全路径）
-psyche upgrade
+**验证是否生效：**
 
-# 如需确认 npm 最新版
-npm view psyche-ai version
+```bash
+npx psyche-ai probe --json
+# ok: true, processInputCalled: true → 在用了
 ```
 
-- npm 管理的安装会后台安全检查更新，必要时才尝试自动升级。
-- `git` 工作树和本地路径安装不会偷偷改你的代码；脏工作树只会提示手动命令。
-- OpenClaw 如果是从当前仓库本地加载，升级后记得重启 gateway 以载入新的 `dist/`。
-
-## 透明代理（推荐：任意 LLM 一行接入）
+**升级：**
 
 ```bash
-psyche-proxy --target https://api.openai.com/v1 --name Luna --mbti ENFP
+npx psyche-ai upgrade --check   # 检查
+npx psyche-ai upgrade           # 升级
 ```
 
-然后把客户端的 API 地址改成 `http://localhost:3340/v1`。Agent 获得持续主观性，但完全不知道 Psyche 存在。Psyche 像内分泌系统一样在后台观测行为、注入偏置——镜子，不是麦克风。
-
 ## 给本机其他 Agent 的真实验收
 
 如果另一个 agent 声称“已经在用 Psyche”，不要接受口头解释，直接让它跑：

package/dist/cli.js

@@ -15,7 +15,7 @@
 //   psyche upgrade [--check]
 //   psyche probe [--json]
 //   psyche profiles [--json] [--mbti TYPE]
-//   psyche setup [--name NAME] [--mbti TYPE] [--locale LOCALE] [--dry-run]
+//   psyche setup [--name NAME] [--mbti TYPE] [--locale LOCALE] [--proxy --target URL] [--dry-run]
 // ============================================================
 import { resolve, join } from "node:path";
 import { homedir } from "node:os";
@@ -510,66 +510,130 @@ async function fileExists(path) {
         return false;
     }
 }
-async function cmdSetup(name, mbti, locale, dryRun) {
-    const targets = getMCPTargets();
-    const psycheEntry = {
-        command: "npx",
-        args: ["-y", "psyche-mcp"],
-        env: {
-            ...(name ? { PSYCHE_NAME: name } : {}),
-            ...(mbti ? { PSYCHE_MBTI: mbti.toUpperCase() } : {}),
-            ...(locale ? { PSYCHE_LOCALE: locale } : {}),
-        },
-    };
-    let configured = 0;
-    let skipped = 0;
-    for (const target of targets) {
-        // Check if the config file's parent directory exists (= client is installed)
-        const configDir = resolve(target.configPath, "..");
-        if (!(await fileExists(configDir)))
+async function cmdSetup(opts) {
+    const { name, mbti, locale, proxy, target, port, dryRun } = opts;
+    const env = {};
+    if (name)
+        env.PSYCHE_NAME = name;
+    if (mbti)
+        env.PSYCHE_MBTI = mbti.toUpperCase();
+    if (locale)
+        env.PSYCHE_LOCALE = locale;
+    let actions = 0;
+    // ── 1. MCP clients ────────────────────────────────────
+    const mcpEntry = { command: "npx", args: ["-y", "psyche-mcp"], env };
+    const { execFileSync } = await import("node:child_process");
+    // Claude Code — use `claude mcp add` for hot-reload (no restart needed)
+    let claudeCodeDone = false;
+    try {
+        const out = execFileSync("claude", ["mcp", "list"], { encoding: "utf-8", timeout: 5000 });
+        if (out.includes("psyche")) {
+            console.log("  ✓ Claude Code — already configured");
+            claudeCodeDone = true;
+        }
+        else if (dryRun) {
+            console.log("  → Claude Code — would configure via `claude mcp add`");
+            claudeCodeDone = true;
+            actions++;
+        }
+        else {
+            const addArgs = ["mcp", "add", "psyche", "-e", "PSYCHE_LOCALE=" + (locale || "zh")];
+            if (name)
+                addArgs.push("-e", "PSYCHE_NAME=" + name);
+            if (mbti)
+                addArgs.push("-e", "PSYCHE_MBTI=" + mbti.toUpperCase());
+            addArgs.push("--", "npx", "-y", "psyche-mcp");
+            execFileSync("claude", addArgs, { encoding: "utf-8", timeout: 10000 });
+            console.log("  ✓ Claude Code — configured (live, no restart needed)");
+            claudeCodeDone = true;
+            actions++;
+        }
+    }
+    catch { /* claude CLI not available, fall through to JSON method */ }
+    // Other clients — edit config JSON
+    for (const t of getMCPTargets()) {
+        if (claudeCodeDone && t.name === "Claude Code")
             continue;
-        // Read existing config or start fresh
-        let config = {};
-        if (await fileExists(target.configPath)) {
+        const dir = resolve(t.configPath, "..");
+        if (!(await fileExists(dir)))
+            continue;
+        let cfg = {};
+        if (await fileExists(t.configPath)) {
             try {
-                config = JSON.parse(await readFile(target.configPath, "utf-8"));
-            }
-            catch {
-                config = {};
+                cfg = JSON.parse(await readFile(t.configPath, "utf-8"));
             }
+            catch { /* fresh */ }
         }
-        // Check if already configured
-        const servers = config[target.mcpKey] ?? {};
+        const servers = cfg[t.mcpKey] ?? {};
         if (servers["psyche"]) {
-            console.log(`  ✓ ${target.name} — already configured`);
-            skipped++;
+            console.log(`  ✓ ${t.name} — already configured`);
             continue;
         }
-        // Add psyche entry
-        servers["psyche"] = psycheEntry;
-        config[target.mcpKey] = servers;
+        servers["psyche"] = mcpEntry;
+        cfg[t.mcpKey] = servers;
         if (dryRun) {
-            console.log(`  → ${target.name} — would write to ${target.configPath}`);
-            configured++;
+            console.log(`  → ${t.name} — would configure`);
+            actions++;
             continue;
         }
-        // Write config
-        await mkdir(configDir, { recursive: true });
-        await writeFile(target.configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
-        console.log(`  ✓ ${target.name} — configured (${target.configPath})`);
-        configured++;
-    }
-    if (configured === 0 && skipped === 0) {
-        console.log("  No MCP clients detected. Install Claude Desktop, Cursor, or Claude Code first.");
-        console.log("  Or run psyche-proxy for universal LLM proxy integration.");
-        return;
+        await mkdir(dir, { recursive: true });
+        await writeFile(t.configPath, JSON.stringify(cfg, null, 2) + "\n", "utf-8");
+        console.log(`  ✓ ${t.name} (restart to activate)`);
+        actions++;
+    }
+    // ── 2. Proxy + env var ────────────────────────────────
+    if (proxy && target) {
+        const proxyUrl = `http://127.0.0.1:${port}/v1`;
+        const shell = process.env.SHELL ?? "/bin/zsh";
+        const rcFile = shell.includes("zsh") ? join(homedir(), ".zshrc")
+            : shell.includes("bash") ? join(homedir(), ".bashrc")
+                : null;
+        // Determine which env var to set based on target URL
+        const envVar = target.includes("anthropic") ? "ANTHROPIC_BASE_URL" : "OPENAI_BASE_URL";
+        const exportLine = `export ${envVar}="${proxyUrl}" # psyche-proxy`;
+        // Build proxy launch command
+        const proxyArgs = [`-t`, target, `-p`, String(port)];
+        if (name)
+            proxyArgs.push(`-n`, name);
+        if (mbti)
+            proxyArgs.push(`--mbti`, mbti.toUpperCase());
+        if (locale)
+            proxyArgs.push(`-l`, locale);
+        const launchCmd = `npx psyche-proxy ${proxyArgs.join(" ")}`;
+        if (dryRun) {
+            console.log(`  → proxy — would start: ${launchCmd}`);
+            if (rcFile)
+                console.log(`  → shell — would append to ${rcFile}: ${exportLine}`);
+            actions++;
+        }
+        else {
+            // Append env var to shell rc (idempotent)
+            if (rcFile) {
+                const rc = await fileExists(rcFile) ? await readFile(rcFile, "utf-8") : "";
+                if (!rc.includes("# psyche-proxy")) {
+                    await writeFile(rcFile, rc + (rc.endsWith("\n") ? "" : "\n") + exportLine + "\n", "utf-8");
+                    console.log(`  ✓ ${envVar} → ${proxyUrl} (${rcFile})`);
+                }
+                else {
+                    console.log(`  ✓ shell env — already configured`);
+                }
+            }
+            // Start proxy in background
+            const { spawn } = await import("node:child_process");
+            const child = spawn("npx", ["-y", "psyche-proxy", ...proxyArgs], {
+                detached: true, stdio: "ignore",
+            });
+            child.unref();
+            console.log(`  ✓ proxy — pid ${child.pid} → ${target}`);
+            actions++;
+        }
     }
-    console.log("");
-    if (configured > 0 && !dryRun) {
-        console.log(`Done. Restart your MCP client${configured > 1 ? "s" : ""} to activate Psyche.`);
+    // ── Summary ───────────────────────────────────────────
+    if (actions === 0) {
+        console.log("  Nothing to do. All targets already configured.");
     }
-    if (configured > 0 && dryRun) {
-        console.log(`Dry run complete. Run without --dry-run to apply.`);
+    else if (!dryRun) {
+        console.log("\nDone. Claude Code is live. Other MCP clients need restart.");
     }
 }
 function usage() {
@@ -587,6 +651,7 @@ Usage:
   psyche intensity              Show info about personality intensity config
   psyche reset <dir> [--full]
   psyche diagnose <dir> [--github]   Run health checks & show diagnostic report
+  psyche setup [--proxy -t URL] [-n NAME] [--mbti TYPE]  Auto-configure MCP + proxy
   psyche upgrade [--check]           Check/apply package updates safely
   psyche probe [--json]              Verify the runtime is truly callable
   psyche profiles [--mbti TYPE] [--json]
@@ -619,6 +684,12 @@ Examples:
   psyche profiles
   psyche profiles --mbti ENFP
 
+  # Auto-configure all MCP clients
+  psyche setup --mbti ENFP --name Luna
+
+  # Universal proxy — works with any agent using OpenAI SDK
+  psyche setup --proxy -t https://api.openai.com/v1 --mbti ENFP
+
   # Check for new package versions without applying them
   psyche upgrade --check
 
@@ -782,12 +853,23 @@ async function main() {
                         name: { type: "string", short: "n" },
                         mbti: { type: "string" },
                         locale: { type: "string", short: "l" },
+                        proxy: { type: "boolean", default: false },
+                        target: { type: "string", short: "t" },
+                        port: { type: "string", short: "p" },
                         "dry-run": { type: "boolean", default: false },
                     },
                     allowPositionals: true,
                 });
                 console.log("\npsyche setup — auto-configuring MCP clients\n");
-                await cmdSetup(values.name ?? "", values.mbti ?? "", values.locale ?? "", values["dry-run"] ?? false);
+                await cmdSetup({
+                    name: values.name ?? "",
+                    mbti: values.mbti ?? "",
+                    locale: values.locale ?? "",
+                    proxy: values.proxy ?? false,
+                    target: values.target ?? "",
+                    port: parseInt(values.port ?? "3340", 10),
+                    dryRun: values["dry-run"] ?? false,
+                });
                 break;
             }
             default:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "psyche-ai",
-  "version": "10.2.1",
+  "version": "10.2.3",
   "description": "AI-first subjectivity kernel for agents with continuous appraisal, relation dynamics, and adaptive reply loops",
   "mcpName": "io.github.Shangri-la-0428/psyche-ai",
   "type": "module",

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/Shangri-la-0428/oasyce_psyche",
     "source": "github"
   },
-  "version": "10.1.1",
+  "version": "10.2.3",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "psyche-ai",
-      "version": "10.1.1",
+      "version": "10.2.3",
       "transport": {
         "type": "stdio"
       },