ManagerForClaudeCode

Claude Code 的终端管理工具（React + Ink + TypeScript）

当前处于骨架状态：页面导航框架已完成（顶栏 Tab / 数字键切页 / 底栏键帽 / 启动页 / 退出画面），三个页面是占位页，功能逐个填充中。

仓库结构：三个子项目

目录	子项目	说明
src/（本目录）	ManagerForClaudeCode 本体	React + Ink + TypeScript 终端 TUI，本文档描述对象
claude-code-router/	CCR 魔改 fork（git submodule）	musistudio/claude-code-router 的 fork，带本地补丁。main 跟踪上游，custom 维护补丁，见 docs/PATCHES.md
ccr-tray/	CCRTray 托盘（Electron + TS）	常驻系统托盘监控 ccr 服务，见 ccr-tray/README.md

页面规划（占位中，功能未实现）

按键	页面	规划功能
1	HISTORY	Claude Code 历史对话管理：项目 × 会话列表 / 搜索 / 预览 / 删除 / 归档 / 导出
2	PLUGINS	MCP / Skills / 插件统一分类管理（编程类/逆向类…），一键拔插：不用的移入备份池、要用的载入，减少无用上下文
3	SETTING	设置

全局键：Esc 退出，数字键切页；页面自己的按键由页面组件自治。

启动 / 退出画面

• 启动页：全屏居中 MFCC 字符画渐显 → 呼吸动画（提示行常亮）→ 回车进入 / Esc 直接退出；终端 resize 实时重排
• 退出画面：完全清屏 → 左上角紧凑字符画渐显 → 定格，附本次使用时长与自定义文案

两者都是纯 ANSI 直写 stdout（不经过 Ink），字符画与文案常量在 src/shell/goodbye.ts / src/shell/splash.ts 顶部，随改随用。

使用

npm install
npm run build  
npm start        
npm run dev       

全局安装（可选）：

npm link
mcp-manager

项目结构

src/
├── cli.tsx                      # 入口：启动页 → Ink 应用 → 退出画面
├── App.tsx                      # 纯外壳：顶栏 Tab / content / 底栏，全局键（Esc、数字切页）
├── types.ts                     # 框架契约类型：PageMeta / PageProps / PageEntry / ShellValue
├── shell/
│   ├── context.ts               # useShell()：外壳 → 页面的反馈/尺寸通道
│   ├── splash.ts                # 启动页（纯 ANSI，呼吸动画 + 回车等待）
│   └── goodbye.ts               # 退出画面（纯 ANSI，紧凑字符画 + 时长）
├── pages/
│   ├── registry.ts              # 页面注册表（加页面只改这里）
│   ├── HISTORYPage.tsx          # 1 · 占位
│   ├── PLUGINSPage.tsx          # 2 · 占位
│   └── SETTINGPage.tsx          # 3 · 占位
├── hooks/
│   ├── useScrollableList.ts     # 虚拟滚动 Hook
│   └── useTerminalSize.ts       # 终端尺寸自适应 Hook（resize 订阅）
└── components/                  # 7 个通用 UI 积木（ScrollableList / DetailPanel / 等）

架构原则：外壳通用，页面自治。加一个页面 = 建一个导出 meta + 组件 的文件 + 注册表加一行。详细契约见 docs/ARCHITECTURE.md。

技术栈

• React 19 — UI 框架
• Ink 6 — React for CLIs
• TypeScript 7 — 类型与编译
• Chalk 5 — 终端颜色

---

子项目：CCRTray 托盘

ccr-tray/ 是独立的桌面托盘程序（Electron + TypeScript），与本 CLI 互不依赖：

cd ccr-tray
npm install
npm run dev        # esbuild 打包 + electron 启动
npm run dist       # electron-builder 打 NSIS 安装包

详细说明见 ccr-tray/README.md。