psyche-ai 10.2.2 → 10.2.4

package/README.md

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

package/dist/cli.js

@@ -522,7 +522,38 @@ async function cmdSetup(opts) {
     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;
         const dir = resolve(t.configPath, "..");
         if (!(await fileExists(dir)))
             continue;
@@ -547,7 +578,7 @@ async function cmdSetup(opts) {
         }
         await mkdir(dir, { recursive: true });
         await writeFile(t.configPath, JSON.stringify(cfg, null, 2) + "\n", "utf-8");
-        console.log(`  ✓ ${t.name}`);
+        console.log(`  ✓ ${t.name} (restart to activate)`);
         actions++;
     }
     // ── 2. Proxy + env var ────────────────────────────────
@@ -602,7 +633,7 @@ async function cmdSetup(opts) {
         console.log("  Nothing to do. All targets already configured.");
     }
     else if (!dryRun) {
-        console.log("\nDone. Restart MCP clients to activate. Proxy is running.");
+        console.log("\nDone. Claude Code is live. Other MCP clients need restart.");
     }
 }
 function usage() {
@@ -653,11 +684,12 @@ Examples:
   psyche profiles
   psyche profiles --mbti ENFP
 
-  # Auto-configure all MCP clients
-  psyche setup --mbti ENFP --name Luna
+  # Auto-configure all MCP clients (one command, done)
+  psyche setup
+  psyche setup --name Luna
 
   # Universal proxy — works with any agent using OpenAI SDK
-  psyche setup --proxy -t https://api.openai.com/v1 --mbti ENFP
+  psyche setup --proxy -t https://api.openai.com/v1
 
   # Check for new package versions without applying them
   psyche upgrade --check

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "psyche-ai",
-  "version": "10.2.2",
+  "version": "10.2.4",
   "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.2.2",
+  "version": "10.2.4",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "psyche-ai",
-      "version": "10.2.2",
+      "version": "10.2.4",
       "transport": {
         "type": "stdio"
       },