@dyyz1993/create-agent 1.9.0

package/templates/general/src/mainview/lib/i18n/locales/zh.json

@@ -0,0 +1,157 @@
+{
+  "app": {
+    "title": "Pi Agent",
+    "connecting": "正在连接 RPC 服务器...",
+    "mode": {
+      "desktop": "桌面 (IPC)",
+      "web": "Web (WebSocket)"
+    }
+  },
+  "sidebar": {
+    "explorer": "资源管理器",
+    "git": "源代码管理",
+    "search": "搜索",
+    "rules": "规则"
+  },
+  "tabs": {
+    "chat": "聊天",
+    "feed": "动态 + 订阅",
+    "bash": "终端",
+    "todo": "待办",
+    "debug": "调试"
+  },
+  "chat": {
+    "title": "消息",
+    "placeholder": "输入消息...",
+    "send": "发送",
+    "empty": "开始对话..."
+  },
+  "explorer": {
+    "title": "资源管理器",
+    "pathPlaceholder": "路径",
+    "refresh": "刷新",
+    "listDirectory": "列出目录",
+    "newFile": "新建文件",
+    "newFolder": "新建文件夹",
+    "rename": "重命名",
+    "delete": "删除",
+    "copyPath": "复制路径",
+    "confirmDelete": "确认删除",
+    "confirmDeleteMessage": "确定要删除 \"{{name}}\" 吗？此操作无法撤销。",
+    "emptyHint": "输入路径并点击刷新"
+  },
+  "git": {
+    "title": "源代码管理",
+    "staged": "已暂存更改",
+    "changes": "更改",
+    "untracked": "未跟踪",
+    "noChanges": "未检测到更改",
+    "commits": "提交记录",
+    "noCommits": "暂无提交",
+    "noFiles": "暂无文件",
+    "loadingFiles": "加载文件中...",
+    "commitPlaceholder": "提交信息 (Ctrl+Enter 提交)",
+    "committing": "提交中...",
+    "commit": "提交",
+    "openDiff": "打开差异",
+    "openFile": "打开文件",
+    "copyHash": "复制哈希",
+    "copyMessage": "复制信息",
+    "copyPath": "复制路径",
+    "pull": "拉取",
+    "push": "推送",
+    "refresh": "刷新",
+    "stage": "暂存",
+    "unstage": "取消暂存",
+    "stageAll": "全部暂存",
+    "unstageAll": "全部取消暂存",
+    "worktrees": "工作树",
+    "close": "关闭",
+    "justNow": "刚刚",
+    "minutesAgo": "{{count}}分钟前",
+    "hoursAgo": "{{count}}小时前",
+    "daysAgo": "{{count}}天前"
+  },
+  "feed": {
+    "title": "动态 + 订阅",
+    "newPost": "新动态",
+    "authorPlaceholder": "作者",
+    "post": "发布",
+    "postPlaceholder": "写点什么...",
+    "subscribeWithFilter": "带过滤器订阅",
+    "filterPlaceholder": "过滤器 JSON，如 {\"category\":\"tech\"}",
+    "subscribe": "订阅",
+    "unsubscribe": "取消订阅",
+    "noFilter": "无过滤",
+    "eventStream": "事件流",
+    "live": "直播",
+    "noPostsYet": "暂无动态，在上方创建一条！"
+  },
+  "todo": {
+    "title": "待办",
+    "add": "添加待办",
+    "placeholder": "需要做什么？",
+    "save": "添加",
+    "empty": "暂无任务",
+    "emptyHint": "点击\"添加待办\"来创建",
+    "status": "状态：",
+    "statusPending": "待处理",
+    "statusInProgress": "进行中",
+    "statusCompleted": "已完成"
+  },
+  "rules": {
+    "title": "规则",
+    "add": "添加规则",
+    "namePlaceholder": "规则名称",
+    "patternPlaceholder": "Glob 匹配模式 (如 **/*.ts)",
+    "save": "保存",
+    "empty": "暂无规则",
+    "emptyHint": "点击\"添加规则\"来创建",
+    "pattern": "模式："
+  },
+  "bash": {
+    "title": "终端",
+    "enterCommand": "输入命令...",
+    "run": "运行",
+    "processRunning": "进程运行中... (PID: {{pid}})",
+    "waitingOutput": "等待输出...",
+    "exit": "退出码: {{code}}",
+    "noActiveProcess": "无活动进程",
+    "getStarted": "运行命令开始",
+    "kill": "终止",
+    "exited": "已退出({{code}})"
+  },
+  "diff": {
+    "lineByLine": "逐行对比",
+    "sideBySide": "并排对比",
+    "loading": "加载差异...",
+    "before": "修改前",
+    "after": "修改后"
+  },
+  "debug": {
+    "rpcCalls": "RPC 调用",
+    "call": "调用",
+    "subscriptions": "订阅",
+    "subscribe": "订阅",
+    "unsubscribe": "取消订阅",
+    "events": "{{count}} 个事件",
+    "noEvents": "暂无事件",
+    "logs": "日志"
+  },
+  "theme": {
+    "light": "浅色",
+    "dark": "深色",
+    "toggle": "切换主题"
+  },
+  "locale": {
+    "en": "English",
+    "zh": "中文"
+  },
+  "common": {
+    "loading": "加载中...",
+    "cancel": "取消",
+    "confirm": "确认",
+    "save": "保存",
+    "delete": "删除"
+  }
+}

package/templates/general/src/mainview/main.tsx

@@ -0,0 +1,20 @@
+import "./lib/i18n";
+import { StrictMode } from "react";
+import { createRoot } from "react-dom/client";
+import { apiClient } from "./lib/api-client";
+import "./index.css";
+import App from "./App";
+
+const isElectrobun = typeof window !== "undefined" && !!window.__electrobunBunBridge;
+
+if (isElectrobun) {
+  // 桌面端：同步初始化 IPC（Electrobun 要求桥接在页面加载时同步设置）
+  apiClient.initSyncForDesktop();
+}
+// Web 端 WS 初始化由 App.tsx 统一管理，避免竞争
+
+createRoot(document.getElementById("root")!).render(
+  <StrictMode>
+    <App />
+  </StrictMode>
+);

package/templates/general/src/mainview/stores/__tests__/use-chat-store.test.ts

@@ -0,0 +1,104 @@
+import { describe, it, expect, beforeEach } from "vitest";
+import { useChatStore } from "../use-chat-store";
+import { act } from "@testing-library/react";
+
+vi.mock("../../lib/api-client", () => ({
+  apiClient: {
+    call: vi.fn().mockResolvedValue({ ok: true }),
+  },
+}));
+
+vi.mock("../use-log-store", () => ({
+  useLogStore: {
+    getState: () => ({ addLog: vi.fn() }),
+  },
+}));
+
+describe("useChatStore", () => {
+  beforeEach(() => {
+    act(() => {
+      useChatStore.setState({
+        messages: [],
+        inputText: "",
+      });
+    });
+  });
+
+  it("initial state", () => {
+    const state = useChatStore.getState();
+    expect(state.messages).toEqual([]);
+    expect(state.inputText).toBe("");
+  });
+
+  it("setInputText", () => {
+    act(() => {
+      useChatStore.getState().setInputText("hello");
+    });
+    expect(useChatStore.getState().inputText).toBe("hello");
+  });
+
+  it("addMessage", () => {
+    const msg = {
+      id: "1",
+      role: "user" as const,
+      content: "hi",
+      timestamp: Date.now(),
+    };
+    act(() => {
+      useChatStore.getState().addMessage(msg);
+    });
+    expect(useChatStore.getState().messages).toHaveLength(1);
+    expect(useChatStore.getState().messages[0].content).toBe("hi");
+  });
+
+  it("setMessages", () => {
+    const msgs = [
+      { id: "1", role: "user" as const, content: "a", timestamp: 1000 },
+      { id: "2", role: "assistant" as const, content: "b", timestamp: 2000 },
+    ];
+    act(() => {
+      useChatStore.getState().setMessages(msgs);
+    });
+    expect(useChatStore.getState().messages).toHaveLength(2);
+  });
+
+  it("addMessage appends to existing", () => {
+    act(() => {
+      useChatStore.getState().setMessages([
+        { id: "1", role: "user", content: "a", timestamp: 1000 },
+      ]);
+    });
+    act(() => {
+      useChatStore.getState().addMessage({
+        id: "2",
+        role: "assistant",
+        content: "b",
+        timestamp: 2000,
+      });
+    });
+    const msgs = useChatStore.getState().messages;
+    expect(msgs).toHaveLength(2);
+    expect(msgs[1].content).toBe("b");
+  });
+
+  it("sendMessage clears inputText after sending", async () => {
+    act(() => {
+      useChatStore.getState().setInputText("hello world");
+    });
+    await act(async () => {
+      await useChatStore.getState().sendMessage();
+    });
+    expect(useChatStore.getState().inputText).toBe("");
+  });
+
+  it("sendMessage does nothing with empty input", async () => {
+    act(() => {
+      useChatStore.getState().setInputText("   ");
+    });
+    const { apiClient } = await import("../../lib/api-client");
+    const callSpy = vi.mocked(apiClient.call);
+    callSpy.mockClear();
+    await useChatStore.getState().sendMessage();
+    expect(callSpy).not.toHaveBeenCalled();
+  });
+});

package/templates/general/src/mainview/stores/__tests__/use-connection-store.test.ts

@@ -0,0 +1,35 @@
+import { describe, it, expect, beforeEach } from "vitest";
+
+describe("useConnectionStore", () => {
+  beforeEach(async () => {
+    vi.resetModules();
+  });
+
+  it("should have initial state", async () => {
+    const { useConnectionStore } = await import("../use-connection-store");
+    const state = useConnectionStore.getState();
+    expect(state.mode).toBe("web");
+    expect(state.ready).toBe(false);
+  });
+
+  it("should set ready state", async () => {
+    const { useConnectionStore } = await import("../use-connection-store");
+    useConnectionStore.getState().setReady(true);
+    expect(useConnectionStore.getState().ready).toBe(true);
+  });
+
+  it("should set mode", async () => {
+    const { useConnectionStore } = await import("../use-connection-store");
+    useConnectionStore.getState().setMode("desktop");
+    expect(useConnectionStore.getState().mode).toBe("desktop");
+  });
+
+  it("should toggle mode between web and desktop", async () => {
+    const { useConnectionStore } = await import("../use-connection-store");
+    expect(useConnectionStore.getState().mode).toBe("web");
+    useConnectionStore.getState().setMode("desktop");
+    expect(useConnectionStore.getState().mode).toBe("desktop");
+    useConnectionStore.getState().setMode("web");
+    expect(useConnectionStore.getState().mode).toBe("web");
+  });
+});

package/templates/general/src/mainview/stores/__tests__/use-locale-store.test.ts

@@ -0,0 +1,32 @@
+import { describe, it, expect, beforeEach, vi } from "vitest";
+
+describe("useLocaleStore", () => {
+  beforeEach(async () => {
+    vi.resetModules();
+    localStorage.clear();
+  });
+
+  it("should default to English", async () => {
+    const { useLocaleStore } = await import("../use-locale-store");
+    expect(useLocaleStore.getState().locale).toBe("en");
+  });
+
+  it("should change locale", async () => {
+    const { useLocaleStore } = await import("../use-locale-store");
+    useLocaleStore.getState().setLocale("zh");
+    expect(useLocaleStore.getState().locale).toBe("zh");
+  });
+
+  it("should persist locale to localStorage", async () => {
+    const { useLocaleStore } = await import("../use-locale-store");
+    useLocaleStore.getState().setLocale("zh");
+    expect(localStorage.getItem("locale")).toBe("zh");
+  });
+
+  it("should restore locale from localStorage", async () => {
+    localStorage.setItem("locale", "zh");
+    vi.resetModules();
+    const { useLocaleStore } = await import("../use-locale-store");
+    expect(useLocaleStore.getState().locale).toBe("zh");
+  });
+});

package/templates/general/src/mainview/stores/__tests__/use-log-store.test.ts

@@ -0,0 +1,45 @@
+import { describe, it, expect, beforeEach } from "vitest";
+
+describe("useLogStore", () => {
+  beforeEach(async () => {
+    vi.resetModules();
+  });
+
+  it("should start with empty logs", async () => {
+    const { useLogStore } = await import("../use-log-store");
+    expect(useLogStore.getState().logs).toEqual([]);
+  });
+
+  it("should add log entries", async () => {
+    const { useLogStore } = await import("../use-log-store");
+    useLogStore.getState().addLog("test message");
+    const logs = useLogStore.getState().logs;
+    expect(logs).toHaveLength(1);
+    expect(logs[0]).toContain("test message");
+  });
+
+  it("should prepend timestamp to log entries", async () => {
+    const { useLogStore } = await import("../use-log-store");
+    useLogStore.getState().addLog("hello");
+    const log = useLogStore.getState().logs[0];
+    expect(log).toMatch(/^\[\d{2}:\d{2}:\d{2}\] hello$/);
+  });
+
+  it("should limit log entries to MAX_LOGS", async () => {
+    const { useLogStore } = await import("../use-log-store");
+    for (let i = 0; i < 200; i++) {
+      useLogStore.getState().addLog(`log ${i}`);
+    }
+    expect(useLogStore.getState().logs.length).toBeLessThanOrEqual(100);
+  });
+
+  it("should keep most recent logs when exceeding limit", async () => {
+    const { useLogStore } = await import("../use-log-store");
+    for (let i = 0; i < 150; i++) {
+      useLogStore.getState().addLog(`log ${i}`);
+    }
+    const logs = useLogStore.getState().logs;
+    expect(logs.length).toBeLessThanOrEqual(100);
+    expect(logs[logs.length - 1]).toContain("log 149");
+  });
+});

package/templates/general/src/mainview/stores/__tests__/use-theme-store.test.ts

@@ -0,0 +1,59 @@
+import { describe, it, expect, beforeEach, vi } from "vitest";
+
+describe("useThemeStore", () => {
+  beforeEach(async () => {
+    vi.resetModules();
+    localStorage.clear();
+    document.documentElement.classList.remove("dark");
+  });
+
+  it("should default to dark theme", async () => {
+    const { useThemeStore } = await import("../use-theme-store");
+    const state = useThemeStore.getState();
+    expect(state.theme).toBe("dark");
+  });
+
+  it("should toggle between light and dark", async () => {
+    const { useThemeStore } = await import("../use-theme-store");
+    const store = useThemeStore.getState();
+
+    expect(store.theme).toBe("dark");
+    store.toggleTheme();
+    expect(useThemeStore.getState().theme).toBe("light");
+
+    useThemeStore.getState().toggleTheme();
+    expect(useThemeStore.getState().theme).toBe("dark");
+  });
+
+  it("should set theme explicitly", async () => {
+    const { useThemeStore } = await import("../use-theme-store");
+    useThemeStore.getState().setTheme("light");
+    expect(useThemeStore.getState().theme).toBe("light");
+  });
+
+  it("should persist theme to localStorage", async () => {
+    const { useThemeStore } = await import("../use-theme-store");
+    useThemeStore.getState().setTheme("light");
+
+    expect(localStorage.getItem("theme")).toBe("light");
+  });
+
+  it("should restore theme from localStorage", async () => {
+    localStorage.setItem("theme", "light");
+
+    vi.resetModules();
+    const { useThemeStore } = await import("../use-theme-store");
+
+    expect(useThemeStore.getState().theme).toBe("light");
+  });
+
+  it("should apply dark class to document element", async () => {
+    const { useThemeStore } = await import("../use-theme-store");
+    useThemeStore.getState().setTheme("dark");
+
+    expect(document.documentElement.classList.contains("dark")).toBe(true);
+
+    useThemeStore.getState().setTheme("light");
+    expect(document.documentElement.classList.contains("dark")).toBe(false);
+  });
+});

package/templates/general/src/mainview/stores/message-batcher.ts

@@ -0,0 +1,25 @@
+type Update = { sessionId: string; apply: () => void };
+
+let queue: Update[] = [];
+let rafId: number | null = null;
+
+function flush() {
+  rafId = null;
+  const batch = queue;
+  queue = [];
+  for (const u of batch) u.apply();
+}
+
+export function batchMessageUpdate(sessionId: string, apply: () => void) {
+  queue.push({ sessionId, apply });
+  if (!rafId) {
+    rafId = requestAnimationFrame(flush);
+  }
+}
+
+export function flushNow() {
+  if (rafId) {
+    cancelAnimationFrame(rafId);
+    flush();
+  }
+}

package/templates/general/src/mainview/stores/use-app-store.ts

@@ -0,0 +1,104 @@
+import { create } from "zustand";
+import { apiClient } from "../lib/api-client";
+import type { RPCMethods } from "../lib/api-client";
+import type { MethodResult } from "@dyyz1993/rpc-core";
+import type { DemoMethod } from "../types";
+import { useLogStore } from "./use-log-store";
+
+type DemoResult = MethodResult<RPCMethods, "system.ping">
+  | MethodResult<RPCMethods, "system.hello">
+  | MethodResult<RPCMethods, "system.echo">
+  | MethodResult<RPCMethods, "chat.send">;
+
+interface AppState {
+  method: DemoMethod;
+  result: DemoResult | null;
+  tickEvents: string[];
+  tickCount: number;
+  subscriptionId: string | null;
+  timerRunning: boolean;
+
+  setMethod: (method: DemoMethod) => void;
+  callRPC: (inputText: string) => Promise<void>;
+  handleSubscribe: () => Promise<void>;
+  handleUnsubscribe: () => Promise<void>;
+  clearDebug: () => void;
+}
+
+export const useAppStore = create<AppState>((set, get) => ({
+  method: "system.ping",
+  result: null,
+  tickEvents: [],
+  tickCount: 0,
+  subscriptionId: null,
+  timerRunning: false,
+
+  setMethod: (method) => set({ method }),
+
+  callRPC: async (inputText: string) => {
+    const { method } = get();
+    const addLog = useLogStore.getState().addLog;
+    addLog(`RPC call: ${method}`);
+    try {
+      addLog(`Calling: ${method}...`);
+      let res: DemoResult;
+      if (method === "system.ping") {
+        res = await apiClient.call("system.ping", {});
+      } else if (method === "system.hello") {
+        res = await apiClient.call("system.hello", {});
+      } else if (method === "system.echo") {
+        res = await apiClient.call("system.echo", {});
+      } else if (method === "chat.send") {
+        const content = inputText.trim() || "Hello from RPC";
+        res = await apiClient.call("chat.send", { content });
+      }
+      set({ result: res });
+      addLog(`Result: ${JSON.stringify(res)}`);
+    } catch (err) {
+      addLog(`Error: ${err instanceof Error ? err.message : String(err)}`);
+    }
+  },
+
+  handleSubscribe: async () => {
+    const addLog = useLogStore.getState().addLog;
+    try {
+      addLog("Subscribing to tick events...");
+      await apiClient.call("timer.start", {});
+      set({ timerRunning: true });
+      addLog("Timer started");
+
+      const subId = await apiClient.subscribe("timer.tick", (payload) => {
+        const time = new Date(payload.timestamp).toLocaleTimeString();
+        set((s) => ({
+          tickEvents: [...s.tickEvents.slice(-19), `#${payload.count} @ ${time}`],
+          tickCount: s.tickCount + 1,
+        }));
+      }, {});
+      set({ subscriptionId: subId });
+      addLog(`Subscribed: ${subId}`);
+    } catch (err) {
+      addLog(`Subscribe error: ${err instanceof Error ? err.message : String(err)}`);
+    }
+  },
+
+  handleUnsubscribe: async () => {
+    const { subscriptionId } = get();
+    const addLog = useLogStore.getState().addLog;
+    try {
+      if (subscriptionId) {
+        apiClient.unsubscribe(subscriptionId);
+        set({ subscriptionId: null });
+        addLog("Unsubscribed");
+      }
+      await apiClient.call("timer.stop", {});
+      set({ timerRunning: false });
+      addLog("Timer stopped");
+    } catch (err) {
+      addLog(`Unsubscribe error: ${err instanceof Error ? err.message : String(err)}`);
+    }
+  },
+
+  clearDebug: () => {
+    set({ result: null, tickEvents: [], tickCount: 0 });
+  },
+}));

package/templates/general/src/mainview/stores/use-chat-store.ts

@@ -0,0 +1,37 @@
+import { create } from "zustand";
+import type { ChatMessage } from "../types";
+import { apiClient } from "../lib/api-client";
+import { useLogStore } from "./use-log-store";
+
+interface ChatState {
+  messages: ChatMessage[];
+  inputText: string;
+
+  setInputText: (text: string) => void;
+  sendMessage: () => Promise<void>;
+  addMessage: (msg: ChatMessage) => void;
+  setMessages: (msgs: ChatMessage[]) => void;
+}
+
+export const useChatStore = create<ChatState>((set, get) => ({
+  messages: [],
+  inputText: "",
+
+  setInputText: (text) => set({ inputText: text }),
+
+  sendMessage: async () => {
+    const { inputText } = get();
+    if (!inputText.trim()) return;
+    const text = inputText.trim();
+    set({ inputText: "" });
+    try {
+      await apiClient.call("chat.send", { content: text });
+    } catch (err) {
+      useLogStore.getState().addLog(`Chat error: ${err instanceof Error ? err.message : String(err)}`);
+    }
+  },
+
+  addMessage: (msg) => set((s) => ({ messages: [...s.messages, msg] })),
+
+  setMessages: (msgs) => set({ messages: msgs }),
+}));

package/templates/general/src/mainview/stores/use-connection-store.ts

@@ -0,0 +1,42 @@
+import { create } from "zustand";
+import { apiClient } from "../lib/api-client";
+import { useLogStore } from "./use-log-store";
+
+interface ConnectionState {
+  mode: "web" | "desktop";
+  ready: boolean;
+  setReady: (ready: boolean) => void;
+  setMode: (mode: "web" | "desktop") => void;
+  initializeConnection: () => void;
+}
+
+export const useConnectionStore = create<ConnectionState>((set) => ({
+  mode: "web",
+  ready: false,
+  setReady: (ready) => set({ ready }),
+  setMode: (mode) => set({ mode }),
+
+  initializeConnection: () => {
+    const MAX_RETRIES = 5;
+    let retries = 0;
+    const init = async () => {
+      try {
+        await apiClient.initialize();
+        const transport = apiClient.getTransport();
+        set({
+          mode: transport === "ipc" ? "desktop" : "web",
+          ready: true,
+        });
+        useLogStore.getState().addLog(`${transport === "ipc" ? "Desktop" : "Web"} mode - ${transport.toUpperCase()}`);
+      } catch {
+        retries++;
+        if (retries < MAX_RETRIES) {
+          setTimeout(init, 1000);
+        } else {
+          useLogStore.getState().addLog(`Failed to connect after ${MAX_RETRIES} retries`);
+        }
+      }
+    };
+    init();
+  },
+}));