ChimeraAI 桌面应用程序
Your Intelligent Desktop Companion
Built with Electron, React, TypeScript, and powered by AI
📚 文档
- 🏅（奖牌） 黄金法则 - 必读！项目规范
- 📖 完整文档 - 完整的文档索引
- 🚀 表情符号“🚀”通常表示火箭、发射、快速前进或加速等概念，在中文中没有直接对应的文字翻译，但可以根据上下文灵活表达为“火箭”、“发射”、“快速前进”或“加速”等意思。 开发指南 - 设置与开发
- 📅 日期/日历 阶段0完成 - 基金会地位
🚀 阶段0 - 基础建设完成
✅ 已实现的功能
- 现代技术栈
- 用于桌面应用的Electron - React 19 用于用户界面（UI） - 使用TypeScript确保类型安全 - Vite，助力超快速开发 - 带有自定义深色主题的Tailwind CSS
- 核心架构
- 主进程（Electron） - 渲染进程（React） - 使用预加载脚本实现安全的IPC（进程间通信） - 上下文隔离已启用
- 用户界面组件
- 玻璃形态设计系统 - 响应式导航栏 - 页面路由（主页、作品集、工具、聊天、游戏、设置） - 动画头像占位符 - 自定义颜色调色板的深色主题
- 安全
- contextIsolation: true - nodeIntegration: false - 通过预加载脚本实现安全的进程间通信 (IPC)
📦 开发
安装依赖项
yarn install运行开发模式
🚀 推荐（带自动检查）：
./launcher_app.sh手册：
yarn dev这将会：
- 在端口5173上启动Vite开发服务器
- 启动 Electron 并启用热重载
- 自动打开开发者工具
构建应用程序
yarn build为您的平台创建生产构建版本 release/ 目录。
📁 项目结构
chimera-ai/
├── README.md # You are here (project overview)
├── docs/ # 📚 All documentation
│ ├── index.md # Documentation index
│ ├── golden-rules.md # Project conventions (MUST READ)
│ ├── DEVELOPMENT.md # Complete dev guide
│ ├── tools.md # Python tools docs
│ ├── games.md # Web games docs
│ └── phase/ # Phase documentation
│ └── phase_0.md # Foundation complete
├── electron/ # Electron main process
│ ├── main.ts # Entry point
│ └── preload.ts # Secure IPC bridge
├── src/ # React renderer
│ ├── components/ # Reusable UI components
│ ├── pages/ # Page components
│ ├── stores/ # Zustand state (future)
│ ├── styles/ # Global styles
│ ├── lib/ # Utilities
│ ├── App.tsx # Root component
│ └── main.tsx # React entry
├── tests/ # All test files (test_*.py)
├── tools/ # Python tools
├── games/ # Web games
├── public/ # Static assets
└── build/ # Build configs🎨 设计系统
颜色
- 背景：
#1e1e1e - 表面：
#2d2d30 - 主要的，重要的:
#007acc - 次要的；二级的：
#0098ff - 重音：
#00d4ff
组件
.glass- 玻璃质感效果（或玻璃模糊效果）.card- 卡片悬浮并支持悬停效果.btn-primary- 主要操作按钮.input- 样式化的表单输入
🔮 即将开启的阶段
- 第一阶段用户界面增强 - Lottie动画，高级效果
- 第二阶段Python 工具 - 工具执行框架
- 第三阶段AI聊天 - Ollama集成
- 第四阶段动画 - 高级虚拟角色状态
- 第五阶段游戏与润色 - 最终特性
📖 书籍 看 docs/index.md 翻译为中文是：文档/索引文件（或：文档目录文件） 以获取完整文档
🛠️ 技术栈
- 桌面电子33
- 用户界面（UI）React 19，TypeScript
- 打包工具（或称为捆绑程序）Vite 6
- 造型Tailwind CSS 3
- 国家状态（如需）
- 图标Lucide React
- 路由器React Router 7
📝 笔记
- 两个进程均启用了热重载功能
- 在开发模式下，开发者工具（DevTools）会自动打开
- IPC通信是类型安全的
- 从第一天起就遵循最佳安全实践
🤝 贡献（或“参与贡献”）
- 阅读 “Golden Rules”的中文翻译是“黄金法则”或“基本准则” 第一！
- 检查 开发指南
- 严格遵守项目规范
- 在提交前所有测试均通过
📖 了解更多
______________________________________________________________________
当前状态阶段0完成 ✅\ 下一个第一阶段 - 用户界面增强与动画制作