zhishu: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

智枢 ZhiShu - AI Terminal Manager

多 Agent AI 编程终端统一指挥台。在一个桌面应用内管理 Claude Code / Codex / Gemini CLI / Qwen / OpenCode / GLM / MiniMax / Kimi 等 8 款 AI CLI 工具。

技术栈: Electron 31 + React 18 + xterm.js (WebGL) + Zustand + node-pty 平台: macOS (当前唯一支持) 协议: MIT | 作者: Xuuuuu04

---

常用命令

npm start                 # 开发模式 (React dev server + Electron)
npm test                  # 运行所有测试 (Node.js 内置 test runner)
npm run package           # 生产构建 (.dmg/.zip/.app)
npm run verify:desktop    # 验证打包链路（不产完整安装包）
npm run rebuild-native    # 重编译 node-pty（Electron 版本更新后必须）

运行单个测试文件：

node --test electron/gitStatus.test.js
node --test electron/monitor.test.js
node --test electron/tools.test.js
node --test electron/config.test.js
node --test electron/keychain.test.js
node --test electron/pathValidator.test.js
node --test electron/fsImportExternal.test.js
node --test src/store/sessionState.test.js

---

架构总览

graph TB
    subgraph "Main Process (Node.js)"
        MW[BrowserWindow]
        PTY[node-pty<br/>进程管理]
        MON[Process Monitor<br/>1.5s BFS tick]
        RES[Resource Monitor<br/>CPU/MEM/BAT]
        BUF[Terminal Buffer<br/>持久化 500KB/7天]
        GIT[Git Wrapper]
        FS[FS Handlers<br/>browse/ops/image]
        CFG[Config + Keychain]
        TRAY[Tray / Menu Bar]
        HOOK[Hook Watcher<br/>Stop hook 精确通知]
        TODO[AI TODO 助手]
    end

    subgraph "IPC Bridge (contextIsolation)"
        PRE[preload.js<br/>白名单 API]
    end

    subgraph "Renderer Process (React)"
        ZS[Zustand Store]
        SB[Sidebar + 分组系统]
        TV[TerminalView + ToolSelector + ResourceBar]
        SC[SplitContainer]
        GP[GitPanel]
        FTP[FileTreePanel]
        FPP[FilePreviewPanel]
        SM[SettingsModal<br/>5-tab]
        TP[TodoPanel + AI Chat]
        CP[CommandPalette]
        TS[ToastStack]
    end

    MW --> PRE
    PTY --> PRE
    MON --> PRE
    RES --> MON
    BUF --> PRE
    GIT --> PRE
    FS --> PRE
    CFG --> PRE
    HOOK --> PRE
    TODO --> PRE
    PRE --> ZS
    ZS --> SB
    ZS --> TV
    ZS --> GP
    ZS --> FTP
    ZS --> FPP
    ZS --> SM
    ZS --> TP
    ZS --> TS
    ZS --> SC