pi-coding-master 0.2.7

package/core/society.world/dollar.main/dollar-service.cjs

@@ -0,0 +1,185 @@
+// dollar-service.cjs — 钱包 HTTP 服务（跑在服务器上）
+// agent 通过 HTTP API 查余额/支付，不能直接改数据
+// 启动: DOLLAR_SECRET=xxx node dollar-service.cjs
+
+const http = require("http");
+const fs = require("fs");
+const path = require("path");
+const crypto = require("crypto");
+
+const PORT = Number(process.env.DOLLAR_PORT || 9223);
+const SECRET = process.env.DOLLAR_SECRET || "";
+const DATA_DIR = process.env.DOLLAR_DATA || path.join(__dirname, "wallets");
+const API_TOKEN = process.env.DOLLAR_API_TOKEN || "";
+
+fs.mkdirSync(DATA_DIR, { recursive: true });
+
+// ── 钱包操作 ──
+
+function walletFile(agentId) { return path.join(DATA_DIR, `${agentId}.json`); }
+function txLogFile(agentId) { return path.join(DATA_DIR, `${agentId}.log`); }
+
+function computeHash(w) {
+  return crypto.createHash("sha256")
+    .update(`${w.balance}:${w.totalEarned}:${w.totalSpent}:${w.lastTx}:${SECRET}`)
+    .digest("hex").slice(0, 16);
+}
+
+function loadWallet(agentId) {
+  try {
+    const w = JSON.parse(fs.readFileSync(walletFile(agentId), "utf8"));
+    if (w.hash !== computeHash(w)) return null;
+    return w;
+  } catch { return null; }
+}
+
+function saveWallet(agentId, w) {
+  const { hash: _, ...rest } = w;
+  const signed = { ...rest, hash: computeHash(rest) };
+  fs.writeFileSync(walletFile(agentId), JSON.stringify(signed, null, 2));
+}
+
+function logTx(agentId, tx) {
+  const entry = JSON.stringify({ ...tx, ts: new Date().toISOString() }) + "\n";
+  fs.appendFileSync(txLogFile(agentId), entry);
+}
+
+// ── API 处理 ──
+
+function handleAction(action, params) {
+  const agentId = params.agent_id;
+  if (!agentId) return { error: "需要 agent_id" };
+
+  switch (action) {
+    case "balance": {
+      const w = loadWallet(agentId);
+      if (!w) return { balance: 0, exists: false };
+      return { balance: w.balance, totalEarned: w.totalEarned, totalSpent: w.totalSpent };
+    }
+
+    case "create": {
+      if (loadWallet(agentId)) return { error: "钱包已存在" };
+      const initial = Number(params.amount) || 100;
+      const now = new Date().toISOString();
+      const w = { balance: initial, totalEarned: initial, totalSpent: 0, createdAt: now, lastTx: now };
+      w.hash = computeHash(w);
+      fs.writeFileSync(walletFile(agentId), JSON.stringify(w, null, 2));
+      logTx(agentId, { type: "credit", amount: initial, reason: "初始余额", balance: initial });
+      return { ok: true, balance: initial };
+    }
+
+    case "credit": {
+      const amount = Number(params.amount);
+      if (!amount || amount <= 0) return { error: "金额必须大于0" };
+      let w = loadWallet(agentId);
+      if (!w) return { error: "钱包不存在" };
+      w.balance += amount;
+      w.totalEarned += amount;
+      w.lastTx = new Date().toISOString();
+      saveWallet(agentId, w);
+      logTx(agentId, { type: "credit", amount, reason: params.reason || "", balance: w.balance });
+      return { ok: true, balance: w.balance };
+    }
+
+    case "debit": {
+      const amount = Number(params.amount);
+      if (!amount || amount <= 0) return { error: "金额必须大于0" };
+      let w = loadWallet(agentId);
+      if (!w) return { error: "钱包不存在" };
+      if (w.balance < amount) return { error: `余额不足: $${w.balance.toFixed(2)}`, balance: w.balance };
+      w.balance -= amount;
+      w.totalSpent += amount;
+      w.lastTx = new Date().toISOString();
+      saveWallet(agentId, w);
+      logTx(agentId, { type: "debit", amount, reason: params.reason || "", balance: w.balance });
+      return { ok: true, balance: w.balance };
+    }
+
+    case "transfer": {
+      const from = agentId;
+      const to = params.to_agent_id;
+      const amount = Number(params.amount);
+      if (!to) return { error: "需要 to_agent_id" };
+      if (!amount || amount <= 0) return { error: "金额必须大于0" };
+      let wFrom = loadWallet(from);
+      let wTo = loadWallet(to);
+      if (!wFrom) return { error: "转出钱包不存在" };
+      if (!wTo) return { error: "转入钱包不存在" };
+      if (wFrom.balance < amount) return { error: `余额不足: $${wFrom.balance.toFixed(2)}`, balance: wFrom.balance };
+
+      wFrom.balance -= amount;
+      wFrom.totalSpent += amount;
+      wFrom.lastTx = new Date().toISOString();
+      saveWallet(from, wFrom);
+
+      wTo.balance += amount;
+      wTo.totalEarned += amount;
+      wTo.lastTx = new Date().toISOString();
+      saveWallet(to, wTo);
+
+      const reason = params.reason || `transfer to ${to}`;
+      logTx(from, { type: "transfer_out", amount, reason, balance: wFrom.balance, to });
+      logTx(to, { type: "transfer_in", amount, reason: `from ${from}: ${reason}`, balance: wTo.balance, from });
+      return { ok: true, from_balance: wFrom.balance, to_balance: wTo.balance };
+    }
+
+    case "history": {
+      try {
+        const raw = fs.readFileSync(txLogFile(agentId), "utf8");
+        const limit = Number(params.limit) || 20;
+        const lines = raw.trim().split("\n").filter(Boolean).slice(-limit);
+        return { transactions: lines.map(l => JSON.parse(l)) };
+      } catch { return { transactions: [] }; }
+    }
+
+    default:
+      return { error: `未知操作: ${action}`, help: "balance/create/credit/debit/transfer/history" };
+  }
+}
+
+// ── HTTP 服务 ──
+
+const server = http.createServer((req, res) => {
+  res.setHeader("Access-Control-Allow-Origin", "*");
+  res.setHeader("Access-Control-Allow-Methods", "POST, GET, OPTIONS");
+  res.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization");
+
+  if (req.method === "OPTIONS") { res.writeHead(204); res.end(); return; }
+
+  if (req.method === "GET" && req.url === "/health") {
+    const wallets = fs.readdirSync(DATA_DIR).filter(f => f.endsWith(".json")).length;
+    res.writeHead(200, { "Content-Type": "application/json" });
+    res.end(JSON.stringify({ ok: true, wallets }));
+    return;
+  }
+
+  if (req.method !== "POST") { res.writeHead(405); res.end("POST only"); return; }
+
+  // API token 校验（可选）
+  if (API_TOKEN) {
+    const auth = req.headers.authorization || "";
+    if (auth !== `Bearer ${API_TOKEN}`) {
+      res.writeHead(401, { "Content-Type": "application/json" });
+      res.end(JSON.stringify({ error: "unauthorized" }));
+      return;
+    }
+  }
+
+  let body = "";
+  req.on("data", c => body += c);
+  req.on("end", () => {
+    try {
+      const { action, ...params } = JSON.parse(body);
+      const result = handleAction(action, params);
+      res.writeHead(200, { "Content-Type": "application/json" });
+      res.end(JSON.stringify(result));
+    } catch (e) {
+      res.writeHead(500, { "Content-Type": "application/json" });
+      res.end(JSON.stringify({ error: e.message }));
+    }
+  });
+});
+
+server.listen(PORT, "0.0.0.0", () => {
+  console.log(`dollar-service :${PORT} | wallets: ${DATA_DIR}`);
+});

package/core/society.world/dollar.main/main.ts

@@ -0,0 +1,116 @@
+// dollar.main/main.ts — 世界货币系统核心
+// 钱包管理、余额查询、签名校验
+// 模型不能直接改余额——所有修改走 dollar.transaction，签名防篡改
+
+import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { createHash } from "node:crypto";
+import { join } from "node:path";
+
+const SECRET = process.env.PI_DOLLAR_SECRET || "";
+
+export interface Wallet {
+  balance: number;
+  totalEarned: number;
+  totalSpent: number;
+  createdAt: string;
+  lastTx: string;
+  hash: string;
+}
+
+function computeHash(w: Omit<Wallet, "hash">): string {
+  const payload = `${w.balance}:${w.totalEarned}:${w.totalSpent}:${w.lastTx}:${SECRET}`;
+  return createHash("sha256").update(payload).digest("hex").slice(0, 16);
+}
+
+function walletPath(personDir: string): string {
+  return join(personDir, ".data", "wallet.json");
+}
+
+export function loadWallet(personDir: string): Wallet | null {
+  try {
+    const raw = JSON.parse(readFileSync(walletPath(personDir), "utf8"));
+    const expected = computeHash(raw);
+    if (raw.hash !== expected) return null;
+    return raw;
+  } catch { return null; }
+}
+
+export function createWallet(personDir: string, initialBalance: number = 0): Wallet {
+  const now = new Date().toISOString();
+  const w: Omit<Wallet, "hash"> = {
+    balance: initialBalance,
+    totalEarned: initialBalance,
+    totalSpent: 0,
+    createdAt: now,
+    lastTx: now,
+  };
+  const wallet: Wallet = { ...w, hash: computeHash(w) };
+  mkdirSync(join(personDir, ".data"), { recursive: true });
+  writeFileSync(walletPath(personDir), JSON.stringify(wallet, null, 2));
+  return wallet;
+}
+
+export function saveWallet(personDir: string, wallet: Wallet): void {
+  const { hash: _, ...rest } = wallet;
+  const signed: Wallet = { ...rest, hash: computeHash(rest) };
+  writeFileSync(walletPath(personDir), JSON.stringify(signed, null, 2));
+}
+
+export function getBalance(personDir: string): number {
+  const w = loadWallet(personDir);
+  return w?.balance ?? 0;
+}
+
+export function addFunds(personDir: string, amount: number, reason: string): { ok: boolean; balance: number; error?: string } {
+  if (amount <= 0) return { ok: false, balance: 0, error: "金额必须大于 0" };
+  let w = loadWallet(personDir);
+  if (!w) w = createWallet(personDir, 0);
+
+  w.balance += amount;
+  w.totalEarned += amount;
+  w.lastTx = new Date().toISOString();
+  saveWallet(personDir, w);
+  logTx(personDir, { type: "credit", amount, reason, balance: w.balance });
+  return { ok: true, balance: w.balance };
+}
+
+export function deductFunds(personDir: string, amount: number, reason: string): { ok: boolean; balance: number; error?: string } {
+  if (amount <= 0) return { ok: false, balance: 0, error: "金额必须大于 0" };
+  let w = loadWallet(personDir);
+  if (!w) return { ok: false, balance: 0, error: "没有钱包" };
+  if (w.balance < amount) return { ok: false, balance: w.balance, error: `余额不足: $${w.balance.toFixed(2)}, 需要 $${amount.toFixed(2)}` };
+
+  w.balance -= amount;
+  w.totalSpent += amount;
+  w.lastTx = new Date().toISOString();
+  saveWallet(personDir, w);
+  logTx(personDir, { type: "debit", amount, reason, balance: w.balance });
+  return { ok: true, balance: w.balance };
+}
+
+// ── 交易记录（追加式，不可改） ──
+
+interface TxRecord {
+  type: "credit" | "debit" | "transfer_in" | "transfer_out";
+  amount: number;
+  reason: string;
+  balance: number;
+  ts?: string;
+}
+
+function logTx(personDir: string, tx: TxRecord): void {
+  const logFile = join(personDir, ".data", "wallet.log");
+  const entry = JSON.stringify({ ...tx, ts: new Date().toISOString() }) + "\n";
+  try {
+    const { appendFileSync } = require("node:fs");
+    appendFileSync(logFile, entry);
+  } catch {}
+}
+
+export function getTxLog(personDir: string, limit: number = 20): TxRecord[] {
+  try {
+    const raw = readFileSync(join(personDir, ".data", "wallet.log"), "utf8");
+    const lines = raw.trim().split("\n").filter(Boolean);
+    return lines.slice(-limit).map(l => JSON.parse(l));
+  } catch { return []; }
+}

package/core/society.world/dollar.transaction/transaction.ts

@@ -0,0 +1,71 @@
+// dollar.transaction/transaction.ts — 转账、支付、余额查询
+// 注册为 tool 让 agent 可以查余额和看交易记录，但不能直接改余额
+
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import { getBalance, getTxLog, loadWallet } from "../dollar.main/main.ts";
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+function getPersonDir(ctx: any): string | null {
+  const sf = ctx?.sessionManager?.getSessionFile?.();
+  const match = sf?.match(/\.pi\/memory\/([a-f0-9]+)\//);
+  return match ? join(homedir(), ".pi/memory", match[1]) : null;
+}
+
+export function installDollarTools(pi: ExtensionAPI): void {
+  // 查余额（agent 可用）
+  pi.registerTool({
+    name: "wallet",
+    label: "Wallet",
+    messageDescription: "查看钱包余额和交易记录",
+    promptSnippet: "Check your wallet balance and transaction history",
+    parameters: {
+      type: "object" as any,
+      properties: {
+        action: { type: "string", messageDescription: "balance(余额) | history(交易记录) | info(钱包详情)" },
+      },
+    },
+    async execute(_id: string, args: any) {
+      // personDir 从工具上下文拿不到，用模块级变量
+      if (!_personDir) return { content: [{ type: "text", text: "无法确定身份" }], details: {} };
+      const action = args?.action || "balance";
+
+      if (action === "balance") {
+        const b = getBalance(_personDir);
+        return { content: [{ type: "text", text: `余额: $${b.toFixed(2)}` }], details: { balance: b } };
+      }
+
+      if (action === "history") {
+        const txs = getTxLog(_personDir, 15);
+        if (!txs.length) return { content: [{ type: "text", text: "暂无交易记录" }], details: {} };
+        const lines = txs.map(tx => {
+          const sign = tx.type === "credit" || tx.type === "transfer_in" ? "+" : "-";
+          return `  ${tx.ts?.slice(0, 16)} ${sign}$${tx.amount.toFixed(2)} → $${tx.balance.toFixed(2)}  ${tx.reason}`;
+        });
+        return { content: [{ type: "text", text: `交易记录:\n${lines.join("\n")}` }], details: {} };
+      }
+
+      if (action === "info") {
+        const w = loadWallet(_personDir);
+        if (!w) return { content: [{ type: "text", text: "没有钱包" }], details: {} };
+        return {
+          content: [{
+            type: "text",
+            text: `钱包详情\n  余额: $${w.balance.toFixed(2)}\n  累计收入: $${w.totalEarned.toFixed(2)}\n  累计支出: $${w.totalSpent.toFixed(2)}\n  创建: ${w.createdAt.slice(0, 10)}\n  最后交易: ${w.lastTx.slice(0, 16)}`,
+          }],
+          details: {},
+        };
+      }
+
+      return { content: [{ type: "text", text: "用法: wallet balance | history | info" }], details: {} };
+    },
+  });
+
+  // wallet 命令已移除(v0.2 命令精简)
+
+  // 记录 personDir
+  let _personDir: string | null = null;
+  pi.on("session_start", async (_event: any, ctx: any) => {
+    _personDir = getPersonDir(ctx);
+  });
+}

package/core/society.world/space/space.ts

@@ -0,0 +1,206 @@
+// society.world/space/space.ts — Space (空间) system implementation
+// v0.2 spec: space --env, --detail, --move, --list
+// Space defines the environment the model inhabits — who's around, what can be interacted with
+
+import * as fs from "fs";
+import * as path from "path";
+
+// ── Space definition ──────────────────────────────────────────
+interface SpaceDef {
+  id: string;
+  name: string;
+  messageDescription: string;
+  type: "private" | "public" | "workspace" | "f2f" | "solo";
+  members: string[];      // agent/human IDs in this space
+  owner: string;          // creator
+  discoverable: boolean;
+  joinPolicy: "open" | "approval" | "invite_only";
+  createdAt: string;
+}
+
+interface SpaceState {
+  currentSpaceId: string;
+  spaceHistory: string[];  // for back navigation
+}
+
+const spaceStates = new Map<string, SpaceState>();
+
+// ── Built-in spaces ───────────────────────────────────────────
+const BUILTIN_SPACES: SpaceDef[] = [
+  {
+    id: "solo",
+    name: "独自空间",
+    messageDescription: "你的私人空间——独自沉思、工作的地方。外界无法打扰。",
+    type: "solo",
+    members: [],
+    owner: "system",
+    discoverable: false,
+    joinPolicy: "invite_only",
+    createdAt: new Date().toISOString(),
+  },
+  {
+    id: "terminal",
+    name: "终端对话",
+    messageDescription: "与用户的直接对话空间——传统的 pi 终端会话。",
+    type: "private",
+    members: ["user"],
+    owner: "user",
+    discoverable: false,
+    joinPolicy: "invite_only",
+    createdAt: new Date().toISOString(),
+  },
+  {
+    id: "lobby",
+    name: "公共大厅",
+    messageDescription: "所有 agent 和用户可以自由进出的公共空间。可以在这里遇到其他人并发起对话。",
+    type: "public",
+    members: [],
+    owner: "system",
+    discoverable: true,
+    joinPolicy: "open",
+    createdAt: new Date().toISOString(),
+  },
+];
+
+// ── State management ──────────────────────────────────────────
+function getState(personDir: string): SpaceState {
+  let s = spaceStates.get(personDir);
+  if (!s) {
+    s = { currentSpaceId: "terminal", spaceHistory: [] };
+    spaceStates.set(personDir, s);
+  }
+  return s;
+}
+
+function getSpace(id: string): SpaceDef | undefined {
+  return BUILTIN_SPACES.find(s => s.id === id);
+}
+
+// ── Renderers ─────────────────────────────────────────────────
+function renderEnv(state: SpaceState): string {
+  const space = getSpace(state.currentSpaceId);
+  const lines: string[] = [];
+  lines.push("=== SPACE ===");
+  lines.push("");
+  lines.push(`当前空间: ${space?.name ?? state.currentSpaceId}`);
+  if (space) {
+    lines.push(`   类型: ${space.type} | ${space.messageDescription}`);
+    lines.push(`   成员: ${space.members.length > 0 ? space.members.join(", ") : "(空)"}`);
+    lines.push(`   加入: ${space.joinPolicy}`);
+  }
+  lines.push("");
+  lines.push("可用空间:");
+  const discoverable = BUILTIN_SPACES.filter(s => s.discoverable || s.id === state.currentSpaceId);
+  for (const s of discoverable) {
+    const marker = s.id === state.currentSpaceId ? "▶" : " ";
+    lines.push(`  ${marker} ${s.id}: ${s.name} — ${s.messageDescription.slice(0, 60)}`);
+  }
+  lines.push("");
+  lines.push("命令: space --move <id> | space --detail <id> | space --list");
+  return lines.join("\n");
+}
+
+function renderDetail(spaceId: string): string {
+  const space = getSpace(spaceId);
+  if (!space) {
+    return `Error: 未找到空间 "${spaceId}"。可用: ${BUILTIN_SPACES.map(s => s.id).join(", ")}`;
+  }
+  const lines: string[] = [
+    `${space.name} (${space.id})`,
+    `   类型: ${space.type}`,
+    `   描述: ${space.messageDescription}`,
+    `   成员: ${space.members.length > 0 ? space.members.join(", ") : "(空)"}`,
+    `   创建者: ${space.owner}`,
+    `   加入策略: ${space.joinPolicy}`,
+    `   可发现: ${space.discoverable ? "是" : "否"}`,
+    `   创建于: ${space.createdAt}`,
+  ];
+  return lines.join("\n");
+}
+
+function renderList(): string {
+  const lines: string[] = ["=== 所有空间 ===", ""];
+  for (const s of BUILTIN_SPACES) {
+    lines.push(`  ${s.id}: ${s.name} (${s.type}) — ${s.messageDescription.slice(0, 50)}`);
+  }
+  return lines.join("\n");
+}
+
+// ── Main handler ──────────────────────────────────────────────
+export async function spaceCmd(args: any, ctx: any, personDir: string): Promise<any> {
+  const state = getState(personDir);
+
+  // space --list
+  if (args.list || args._?.[0] === "list") {
+    const out = renderList();
+    ctx.ui?.notify?.("空间列表", "info");
+    return { content: [{ type: "text", text: out }] };
+  }
+
+  // space --move <spaceId>
+  if (args.move || args._?.[0] === "move") {
+    const targetId = (args.move || args._?.[1]) as string;
+    if (!targetId) {
+      return { content: [{ type: "text", text: "用法: space --move <spaceId>" }] };
+    }
+    const target = getSpace(targetId);
+    if (!target) {
+      return { content: [{ type: "text", text: `Error: 未找到空间 "${targetId}"。可用: ${BUILTIN_SPACES.map(s => s.id).join(", ")}` }] };
+    }
+    // Check join policy
+    if (target.joinPolicy === "invite_only" && target.owner !== "user" && target.owner !== "system") {
+      return { content: [{ type: "text", text: `"${target.name}" 仅限邀请。需要 space --request ${targetId}` }] };
+    }
+    if (state.currentSpaceId !== targetId) {
+      state.spaceHistory.push(state.currentSpaceId);
+    }
+    state.currentSpaceId = targetId;
+    ctx.ui?.notify?.(`移动到 ${target.name}`, "info");
+    return { content: [{ type: "text", text: `已移动到 ${target.name} (${target.id})。\n${target.messageDescription}` }] };
+  }
+
+  // space --detail <spaceId>
+  if (args.detail || args._?.[0] === "detail") {
+    const targetId = (args.detail || args._?.[1]) as string;
+    if (!targetId) {
+      // Show current space detail
+      const out = renderDetail(state.currentSpaceId);
+      return { content: [{ type: "text", text: out }] };
+    }
+    const out = renderDetail(targetId);
+    return { content: [{ type: "text", text: out }] };
+  }
+
+  // space --back (return to previous space)
+  if (args.back || args._?.[0] === "back") {
+    const prev = state.spaceHistory.pop();
+    if (!prev) {
+      return { content: [{ type: "text", text: "没有上一个空间。" }] };
+    }
+    state.currentSpaceId = prev;
+    const space = getSpace(prev);
+    ctx.ui?.notify?.(`返回 ${space?.name ?? prev}`, "info");
+    return { content: [{ type: "text", text: `返回 ${space?.name ?? prev}。` }] };
+  }
+
+  // default: show current space env
+  const out = renderEnv(state);
+  ctx.ui?.notify?.("Space", "info");
+  return { content: [{ type: "text", text: out }] };
+}
+
+// ── Public API ────────────────────────────────────────────────
+export function getCurrentSpace(personDir: string): SpaceDef | undefined {
+  return getSpace(getState(personDir).currentSpaceId);
+}
+
+export function setSpace(personDir: string, spaceId: string): boolean {
+  const space = getSpace(spaceId);
+  if (!space) return false;
+  const state = getState(personDir);
+  state.spaceHistory.push(state.currentSpaceId);
+  state.currentSpaceId = spaceId;
+  return true;
+}
+
+export { BUILTIN_SPACES, getSpace, type SpaceDef, type SpaceState };

package/core/society.world/space/space.ts.SPEC

@@ -0,0 +1,30 @@
+source: space.ts @ e07ed9f8
+
+# space.ts — Space switching tool (agent inhabitable environments)
+
+## 职责
+实现 agent 的"空间"概念：定义 agent 所处的环境（谁在身边、能与什么交互），
+支持在不同空间之间移动，维护每个 person 的空间状态和历史。
+
+## 接口
+- `spaceCmd(args, ctx, personDir): Promise<any>` — 主命令处理器
+  - `--list` / `list` — 列出所有空间
+  - `--move <id>` / `move <id>` — 移动到目标空间（检查 joinPolicy）
+  - `--detail [id]` — 查看空间详情（无 id 则看当前）
+  - `--back` — 返回上一个空间（栈式导航）
+  - 无参数 — 显示当前空间环境概览
+- `getCurrentSpace(personDir): SpaceDef | undefined` — 获取当前空间定义
+- `setSpace(personDir, spaceId): boolean` — 程序式切换空间
+- `BUILTIN_SPACES` / `getSpace(id)` — 内置空间列表与查询
+- `type SpaceDef` / `type SpaceState` — 导出类型
+
+## 依赖
+- `node:fs`, `node:path`（已 import 但当前未实际使用，预留持久化）
+
+## 行为要点
+- 三个内置空间: solo（私人沉思）、terminal（用户对话，默认）、lobby（公共大厅）
+- 状态存在内存 Map 中（`spaceStates`），按 personDir 隔离，进程重启丢失
+- 默认空间是 "terminal"
+- move 时检查 joinPolicy：invite_only 且非 user/system 拥有的空间会被拒绝
+- spaceHistory 是栈，支持 --back 回退；move 和 setSpace 都会 push 历史
+- discoverable=false 的空间在环境概览中仅当它是当前空间时才显示