智能桌面应用

ChimeraAI Desktop App是一款基于Electron和React的智能桌面应用,提供UI组件、安全架构和多种功能模块,适用于开发者和技术爱好者。

  • by LycuscoderTeam
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 LycusCoder/AgentChimera-MCP-Tools

使用说明

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

这将会:

  1. 在端口5173上启动Vite开发服务器
  2. 启动 Electron 并启用热重载
  3. 自动打开开发者工具

构建应用程序

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通信是类型安全的
  • 从第一天起就遵循最佳安全实践

🤝 贡献(或“参与贡献”)

  1. 阅读 “Golden Rules”的中文翻译是“黄金法则”或“基本准则” 第一!
  2. 检查 开发指南
  3. 严格遵守项目规范
  4. 在提交前所有测试均通过

📖 了解更多


当前状态阶段0完成 ✅
下一个第一阶段 - 用户界面增强与动画制作