[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-winfunc--opcode":3,"tool-winfunc--opcode":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",157379,2,"2026-04-15T23:32:42",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[52,13,15,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":32,"last_commit_at":59,"category_tags":60,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":67,"readme_en":68,"readme_zh":69,"quickstart_zh":70,"use_case_zh":71,"hero_image_url":72,"owner_login":73,"owner_name":73,"owner_avatar_url":74,"owner_bio":75,"owner_company":76,"owner_location":76,"owner_email":77,"owner_twitter":78,"owner_website":79,"owner_url":80,"languages":81,"stars":108,"forks":109,"last_commit_at":110,"license":111,"difficulty_score":32,"env_os":112,"env_gpu":113,"env_ram":114,"env_deps":115,"category_tags":127,"github_topics":129,"view_count":32,"oss_zip_url":76,"oss_zip_packed_at":76,"status":17,"created_at":145,"updated_at":146,"faqs":147,"releases":178},7874,"winfunc\u002Fopcode","opcode","A powerful GUI app and Toolkit for Claude Code - Create custom agents, manage interactive Claude Code sessions, run secure background agents, and more.","opcode 是一款专为 Claude Code 打造的桌面级图形界面工具，旨在将原本依赖命令行的操作转化为直观、高效的视觉体验。它解决了开发者在使用 Claude Code 时面临的会话管理分散、缺乏可视化监控以及自定义代理配置复杂等痛点，让用户无需记忆繁琐指令即可轻松掌控开发流程。\n\n这款软件非常适合希望提升 AI 辅助编程效率的软件开发者和工程师使用。通过 opcode，用户可以像浏览文件夹一样管理所有项目与历史会话，随时恢复中断的工作上下文；还能创建具备特定系统提示词的定制 AI 代理，并在后台安全运行以处理非阻塞任务。此外，它内置了详细的使用分析仪表盘，能实时追踪 API 消耗成本与 Token 用量，帮助团队优化预算。\n\n在技术亮点方面，opcode 基于现代化的 Tauri 2 框架构建，不仅拥有轻量级的性能表现，还提供了对 MCP（模型上下文协议）服务器的原生支持，方便扩展 AI 能力边界。同时，它对 CLAUDE.md 配置文件的管理和时间轴检查点功能，让复杂的长周期开发任务变得井井有条。无论是日常编码还是构建自动化工作流，opcode 都能成为你得力的 AI 开发指","opcode 是一款专为 Claude Code 打造的桌面级图形界面工具，旨在将原本依赖命令行的操作转化为直观、高效的视觉体验。它解决了开发者在使用 Claude Code 时面临的会话管理分散、缺乏可视化监控以及自定义代理配置复杂等痛点，让用户无需记忆繁琐指令即可轻松掌控开发流程。\n\n这款软件非常适合希望提升 AI 辅助编程效率的软件开发者和工程师使用。通过 opcode，用户可以像浏览文件夹一样管理所有项目与历史会话，随时恢复中断的工作上下文；还能创建具备特定系统提示词的定制 AI 代理，并在后台安全运行以处理非阻塞任务。此外，它内置了详细的使用分析仪表盘，能实时追踪 API 消耗成本与 Token 用量，帮助团队优化预算。\n\n在技术亮点方面，opcode 基于现代化的 Tauri 2 框架构建，不仅拥有轻量级的性能表现，还提供了对 MCP（模型上下文协议）服务器的原生支持，方便扩展 AI 能力边界。同时，它对 CLAUDE.md 配置文件的管理和时间轴检查点功能，让复杂的长周期开发任务变得井井有条。无论是日常编码还是构建自动化工作流，opcode 都能成为你得力的 AI 开发指挥中心。","\n\u003Cdiv align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwinfunc_opcode_readme_3ba373b96219.png\" alt=\"opcode Logo\" width=\"120\" height=\"120\">\n\n  \u003Ch1>opcode\u003C\u002Fh1>\n  \n  \u003Cp>\n    \u003Cstrong>A powerful GUI app and Toolkit for Claude Code\u003C\u002Fstrong>\n  \u003C\u002Fp>\n  \u003Cp>\n    \u003Cstrong>Create custom agents, manage interactive Claude Code sessions, run secure background agents, and more.\u003C\u002Fstrong>\n  \u003C\u002Fp>\n  \n  \u003Cp>\n    \u003Ca href=\"#features\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FFeatures-✨-blue?style=for-the-badge\" alt=\"Features\">\u003C\u002Fa>\n    \u003Ca href=\"#installation\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FInstall-🚀-green?style=for-the-badge\" alt=\"Installation\">\u003C\u002Fa>\n    \u003Ca href=\"#usage\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FUsage-📖-purple?style=for-the-badge\" alt=\"Usage\">\u003C\u002Fa>\n    \u003Ca href=\"#development\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDevelop-🛠️-orange?style=for-the-badge\" alt=\"Development\">\u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fdiscord.com\u002Finvite\u002FKYwhHVzUsY\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-Join-5865F2?style=for-the-badge&logo=discord&logoColor=white\" alt=\"Discord\">\u003C\u002Fa>\n  \u003C\u002Fp>\n\u003C\u002Fdiv>\n\n![457013521-6133a738-d0cb-4d3e-8746-c6768c82672c](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwinfunc_opcode_readme_a4efe52f6105.png)\n\n\n\nhttps:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F6bceea0f-60b6-4c3e-a745-b891de00b8d0\n\n\n\n> [!TIP]\n> **⭐ Star the repo and follow [@getAsterisk](https:\u002F\u002Fx.com\u002FgetAsterisk) on X for early access to `asteria-swe-v0`**.\n\n> [!NOTE]\n> This project is not affiliated with, endorsed by, or sponsored by Anthropic. Claude is a trademark of Anthropic, PBC. This is an independent developer project using Claude.\n\n## 🌟 Overview\n\n**opcode** is a powerful desktop application that transforms how you interact with Claude Code. Built with Tauri 2, it provides a beautiful GUI for managing your Claude Code sessions, creating custom agents, tracking usage, and much more.\n\nThink of opcode as your command center for Claude Code - bridging the gap between the command-line tool and a visual experience that makes AI-assisted development more intuitive and productive.\n\n## 📋 Table of Contents\n\n- [🌟 Overview](#-overview)\n- [✨ Features](#-features)\n  - [🗂️ Project & Session Management](#️-project--session-management)\n  - [🤖 CC Agents](#-cc-agents)\n  \n  - [📊 Usage Analytics Dashboard](#-usage-analytics-dashboard)\n  - [🔌 MCP Server Management](#-mcp-server-management)\n  - [⏰ Timeline & Checkpoints](#-timeline--checkpoints)\n  - [📝 CLAUDE.md Management](#-claudemd-management)\n- [📖 Usage](#-usage)\n  - [Getting Started](#getting-started)\n  - [Managing Projects](#managing-projects)\n  - [Creating Agents](#creating-agents)\n  - [Tracking Usage](#tracking-usage)\n  - [Working with MCP Servers](#working-with-mcp-servers)\n- [🚀 Installation](#-installation)\n- [🔨 Build from Source](#-build-from-source)\n- [🛠️ Development](#️-development)\n- [🔒 Security](#-security)\n- [🤝 Contributing](#-contributing)\n- [📄 License](#-license)\n- [🙏 Acknowledgments](#-acknowledgments)\n\n## ✨ Features\n\n### 🗂️ **Project & Session Management**\n- **Visual Project Browser**: Navigate through all your Claude Code projects in `~\u002F.claude\u002Fprojects\u002F`\n- **Session History**: View and resume past coding sessions with full context\n- **Smart Search**: Find projects and sessions quickly with built-in search\n- **Session Insights**: See first messages, timestamps, and session metadata at a glance\n\n### 🤖 **CC Agents**\n- **Custom AI Agents**: Create specialized agents with custom system prompts and behaviors\n- **Agent Library**: Build a collection of purpose-built agents for different tasks\n- **Background Execution**: Run agents in separate processes for non-blocking operations\n- **Execution History**: Track all agent runs with detailed logs and performance metrics\n\n\n\n### 📊 **Usage Analytics Dashboard**\n- **Cost Tracking**: Monitor your Claude API usage and costs in real-time\n- **Token Analytics**: Detailed breakdown by model, project, and time period\n- **Visual Charts**: Beautiful charts showing usage trends and patterns\n- **Export Data**: Export usage data for accounting and analysis\n\n### 🔌 **MCP Server Management**\n- **Server Registry**: Manage Model Context Protocol servers from a central UI\n- **Easy Configuration**: Add servers via UI or import from existing configs\n- **Connection Testing**: Verify server connectivity before use\n- **Claude Desktop Import**: Import server configurations from Claude Desktop\n\n### ⏰ **Timeline & Checkpoints**\n- **Session Versioning**: Create checkpoints at any point in your coding session\n- **Visual Timeline**: Navigate through your session history with a branching timeline\n- **Instant Restore**: Jump back to any checkpoint with one click\n- **Fork Sessions**: Create new branches from existing checkpoints\n- **Diff Viewer**: See exactly what changed between checkpoints\n\n### 📝 **CLAUDE.md Management**\n- **Built-in Editor**: Edit CLAUDE.md files directly within the app\n- **Live Preview**: See your markdown rendered in real-time\n- **Project Scanner**: Find all CLAUDE.md files in your projects\n- **Syntax Highlighting**: Full markdown support with syntax highlighting\n\n## 📖 Usage\n\n### Getting Started\n\n1. **Launch opcode**: Open the application after installation\n2. **Welcome Screen**: Choose between CC Agents or Projects\n3. **First Time Setup**: opcode will automatically detect your `~\u002F.claude` directory\n\n### Managing Projects\n\n```\nProjects → Select Project → View Sessions → Resume or Start New\n```\n\n- Click on any project to view its sessions\n- Each session shows the first message and timestamp\n- Resume sessions directly or start new ones\n\n### Creating Agents\n\n```\nCC Agents → Create Agent → Configure → Execute\n```\n\n1. **Design Your Agent**: Set name, icon, and system prompt\n2. **Configure Model**: Choose between available Claude models\n3. **Set Permissions**: Configure file read\u002Fwrite and network access\n4. **Execute Tasks**: Run your agent on any project\n\n### Tracking Usage\n\n```\nMenu → Usage Dashboard → View Analytics\n```\n\n- Monitor costs by model, project, and date\n- Export data for reports\n- Set up usage alerts (coming soon)\n\n### Working with MCP Servers\n\n```\nMenu → MCP Manager → Add Server → Configure\n```\n\n- Add servers manually or via JSON\n- Import from Claude Desktop configuration\n- Test connections before using\n\n## 🚀 Installation\n\n### Prerequisites\n\n- **Claude Code CLI**: Install from [Claude's official site](https:\u002F\u002Fclaude.ai\u002Fcode)\n\n### Release Executables Will Be Published Soon\n\n## 🔨 Build from Source\n\n### Prerequisites\n\nBefore building opcode from source, ensure you have the following installed:\n\n#### System Requirements\n\n- **Operating System**: Windows 10\u002F11, macOS 11+, or Linux (Ubuntu 20.04+)\n- **RAM**: Minimum 4GB (8GB recommended)\n- **Storage**: At least 1GB free space\n\n#### Required Tools\n\n1. **Rust** (1.70.0 or later)\n   ```bash\n   # Install via rustup\n   curl --proto '=https' --tlsv1.2 -sSf https:\u002F\u002Fsh.rustup.rs | sh\n   ```\n\n2. **Bun** (latest version)\n   ```bash\n   # Install bun\n   curl -fsSL https:\u002F\u002Fbun.sh\u002Finstall | bash\n   ```\n\n3. **Git**\n   ```bash\n   # Usually pre-installed, but if not:\n   # Ubuntu\u002FDebian: sudo apt install git\n   # macOS: brew install git\n   # Windows: Download from https:\u002F\u002Fgit-scm.com\n   ```\n\n4. **Claude Code CLI**\n   - Download and install from [Claude's official site](https:\u002F\u002Fclaude.ai\u002Fcode)\n   - Ensure `claude` is available in your PATH\n\n#### Platform-Specific Dependencies\n\n**Linux (Ubuntu\u002FDebian)**\n```bash\n# Install system dependencies\nsudo apt update\nsudo apt install -y \\\n  libwebkit2gtk-4.1-dev \\\n  libgtk-3-dev \\\n  libayatana-appindicator3-dev \\\n  librsvg2-dev \\\n  patchelf \\\n  build-essential \\\n  curl \\\n  wget \\\n  file \\\n  libssl-dev \\\n  libxdo-dev \\\n  libsoup-3.0-dev \\\n  libjavascriptcoregtk-4.1-dev\n```\n\n**macOS**\n```bash\n# Install Xcode Command Line Tools\nxcode-select --install\n\n# Install additional dependencies via Homebrew (optional)\nbrew install pkg-config\n```\n\n**Windows**\n- Install [Microsoft C++ Build Tools](https:\u002F\u002Fvisualstudio.microsoft.com\u002Fvisual-cpp-build-tools\u002F)\n- Install [WebView2](https:\u002F\u002Fdeveloper.microsoft.com\u002Fmicrosoft-edge\u002Fwebview2\u002F) (usually pre-installed on Windows 11)\n\n### Build Steps\n\n1. **Clone the Repository**\n   ```bash\n   git clone https:\u002F\u002Fgithub.com\u002FgetAsterisk\u002Fopcode.git\n   cd opcode\n   ```\n\n2. **Install Frontend Dependencies**\n   ```bash\n   bun install\n   ```\n\n3. **Build the Application**\n   \n   **For Development (with hot reload)**\n   ```bash\n   bun run tauri dev\n   ```\n   \n   **For Production Build**\n   ```bash\n   # Build the application\n   bun run tauri build\n   \n   # The built executable will be in:\n   # - Linux: src-tauri\u002Ftarget\u002Frelease\u002F\n   # - macOS: src-tauri\u002Ftarget\u002Frelease\u002F\n   # - Windows: src-tauri\u002Ftarget\u002Frelease\u002F\n   ```\n\n4. **Platform-Specific Build Options**\n   \n   **Debug Build (faster compilation, larger binary)**\n   ```bash\n   bun run tauri build --debug\n   ```\n   \n   **Universal Binary for macOS (Intel + Apple Silicon)**\n   ```bash\n   bun run tauri build --target universal-apple-darwin\n   ```\n\n### Troubleshooting\n\n#### Common Issues\n\n1. **\"cargo not found\" error**\n   - Ensure Rust is installed and `~\u002F.cargo\u002Fbin` is in your PATH\n   - Run `source ~\u002F.cargo\u002Fenv` or restart your terminal\n\n2. **Linux: \"webkit2gtk not found\" error**\n   - Install the webkit2gtk development packages listed above\n   - On newer Ubuntu versions, you might need `libwebkit2gtk-4.0-dev`\n\n3. **Windows: \"MSVC not found\" error**\n   - Install Visual Studio Build Tools with C++ support\n   - Restart your terminal after installation\n\n4. **\"claude command not found\" error**\n   - Ensure Claude Code CLI is installed and in your PATH\n   - Test with `claude --version`\n\n5. **Build fails with \"out of memory\"**\n   - Try building with fewer parallel jobs: `cargo build -j 2`\n   - Close other applications to free up RAM\n\n#### Verify Your Build\n\nAfter building, you can verify the application works:\n\n```bash\n# Run the built executable directly\n# Linux\u002FmacOS\n.\u002Fsrc-tauri\u002Ftarget\u002Frelease\u002Fopcode\n\n# Windows\n.\u002Fsrc-tauri\u002Ftarget\u002Frelease\u002Fopcode.exe\n```\n\n### Build Artifacts\n\nThe build process creates several artifacts:\n\n- **Executable**: The main opcode application\n- **Installers** (when using `tauri build`):\n  - `.deb` package (Linux)\n  - `.AppImage` (Linux)\n  - `.dmg` installer (macOS)\n  - `.msi` installer (Windows)\n  - `.exe` installer (Windows)\n\nAll artifacts are located in `src-tauri\u002Ftarget\u002Frelease\u002F`.\n\n## 🛠️ Development\n\n### Tech Stack\n\n- **Frontend**: React 18 + TypeScript + Vite 6\n- **Backend**: Rust with Tauri 2\n- **UI Framework**: Tailwind CSS v4 + shadcn\u002Fui\n- **Database**: SQLite (via rusqlite)\n- **Package Manager**: Bun\n\n### Project Structure\n\n```\nopcode\u002F\n├── src\u002F                   # React frontend\n│   ├── components\u002F        # UI components\n│   ├── lib\u002F               # API client & utilities\n│   └── assets\u002F            # Static assets\n├── src-tauri\u002F             # Rust backend\n│   ├── src\u002F\n│   │   ├── commands\u002F      # Tauri command handlers\n│   │   ├── checkpoint\u002F    # Timeline management\n│   │   └── process\u002F       # Process management\n│   └── tests\u002F             # Rust test suite\n└── public\u002F                # Public assets\n```\n\n### Development Commands\n\n```bash\n# Start development server\nbun run tauri dev\n\n# Run frontend only\nbun run dev\n\n# Type checking\nbunx tsc --noEmit\n\n# Run Rust tests\ncd src-tauri && cargo test\n\n# Format code\ncd src-tauri && cargo fmt\n```\n\n## 🔒 Security\n\nopcode prioritizes your privacy and security:\n\n1. **Process Isolation**: Agents run in separate processes\n2. **Permission Control**: Configure file and network access per agent\n3. **Local Storage**: All data stays on your machine\n4. **No Telemetry**: No data collection or tracking\n5. **Open Source**: Full transparency through open source code\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n### Areas for Contribution\n\n- 🐛 Bug fixes and improvements\n- ✨ New features and enhancements\n- 📚 Documentation improvements\n- 🎨 UI\u002FUX enhancements\n- 🧪 Test coverage\n- 🌐 Internationalization\n\n## 📄 License\n\nThis project is licensed under the AGPL License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- Built with [Tauri](https:\u002F\u002Ftauri.app\u002F) - The secure framework for building desktop apps\n- [Claude](https:\u002F\u002Fclaude.ai) by Anthropic\n\n---\n\n\u003Cdiv align=\"center\">\n  \u003Cp>\n    \u003Cstrong>Made with ❤️ by the \u003Ca href=\"https:\u002F\u002Fasterisk.so\u002F\">Asterisk\u003C\u002Fa>\u003C\u002Fstrong>\n  \u003C\u002Fp>\n  \u003Cp>\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FgetAsterisk\u002Fopcode\u002Fissues\">Report Bug\u003C\u002Fa>\n    ·\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FgetAsterisk\u002Fopcode\u002Fissues\">Request Feature\u003C\u002Fa>\n  \u003C\u002Fp>\n\u003C\u002Fdiv>\n\n\n## Star History\n\n[![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwinfunc_opcode_readme_a70d13930214.png)](https:\u002F\u002Fwww.star-history.com\u002F#getAsterisk\u002Fopcode&Date)\n","\u003Cdiv align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwinfunc_opcode_readme_3ba373b96219.png\" alt=\"opcode Logo\" width=\"120\" height=\"120\">\n\n  \u003Ch1>opcode\u003C\u002Fh1>\n  \n  \u003Cp>\n    \u003Cstrong>一款功能强大的 GUI 应用及工具包，专为 Claude Code 打造\u003C\u002Fstrong>\n  \u003C\u002Fp>\n  \u003Cp>\n    \u003Cstrong>创建自定义智能体、管理交互式 Claude Code 会话、运行安全的后台代理等。\u003C\u002Fstrong>\n  \u003C\u002Fp>\n  \n  \u003Cp>\n    \u003Ca href=\"#features\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FFeatures-✨-blue?style=for-the-badge\" alt=\"Features\">\u003C\u002Fa>\n    \u003Ca href=\"#installation\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FInstall-🚀-green?style=for-the-badge\" alt=\"Installation\">\u003C\u002Fa>\n    \u003Ca href=\"#usage\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FUsage-📖-purple?style=for-the-badge\" alt=\"Usage\">\u003C\u002Fa>\n    \u003Ca href=\"#development\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDevelop-🛠️-orange?style=for-the-badge\" alt=\"Development\">\u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fdiscord.com\u002Finvite\u002FKYwhHVzUsY\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-Join-5865F2?style=for-the-badge&logo=discord&logoColor=white\" alt=\"Discord\">\u003C\u002Fa>\n  \u003C\u002Fp>\n\u003C\u002Fdiv>\n\n![457013521-6133a738-d0cb-4d3e-8746-c6768c82672c](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwinfunc_opcode_readme_a4efe52f6105.png)\n\n\n\nhttps:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F6bceea0f-60b6-4c3e-a745-b891de00b8d0\n\n\n\n> [!TIP]\n> **⭐ 给这个仓库点个赞，并在 X 上关注 [@getAsterisk](https:\u002F\u002Fx.com\u002FgetAsterisk)，抢先体验 `asteria-swe-v0`**。\n\n> [!NOTE]\n> 本项目与 Anthropic 无任何关联，未获其认可或赞助。Claude 是 Anthropic, PBC 的注册商标。本项目由独立开发者基于 Claude 进行开发。\n\n## 🌟 概述\n\n**opcode** 是一款功能强大的桌面应用，彻底革新了您与 Claude Code 的交互方式。基于 Tauri 2 构建，它提供了一个美观的图形界面，用于管理您的 Claude Code 会话、创建自定义智能体、跟踪使用情况等等。\n\n您可以将 opcode 视为您管理 Claude Code 的指挥中心——它弥合了命令行工具与可视化体验之间的鸿沟，让 AI 辅助开发变得更加直观和高效。\n\n## 📋 目录\n\n- [🌟 概述](#-overview)\n- [✨ 特性](#-features)\n  - [🗂️ 项目与会话管理](#️-project--session-management)\n  - [🤖 CC 智能体](#-cc-agents)\n  \n  - [📊 使用分析仪表盘](#-usage-analytics-dashboard)\n  - [🔌 MCP 服务器管理](#-mcp-server-management)\n  - [⏰ 时间线与检查点](#-timeline--checkpoints)\n  - [📝 CLAUDE.md 管理](#-claudemd-management)\n- [📖 使用方法](#-usage)\n  - [快速入门](#getting-started)\n  - [项目管理](#managing-projects)\n  - [创建智能体](#creating-agents)\n  - [使用情况跟踪](#tracking-usage)\n  - [MCP 服务器操作](#working-with-mcp-servers)\n- [🚀 安装](#-installation)\n- [🔨 从源码构建](#-build-from-source)\n- [🛠️ 开发](#️-development)\n- [🔒 安全性](#-security)\n- [🤝 贡献](#-contributing)\n- [📄 许可证](#-license)\n- [🙏 致谢](#-acknowledgments)\n\n## ✨ 特性\n\n### 🗂️ **项目与会话管理**\n- **可视化项目浏览器**：浏览您所有位于 `~\u002F.claude\u002Fprojects\u002F` 中的 Claude Code 项目\n- **会话历史**：查看并恢复过去的编码会话，保留完整上下文\n- **智能搜索**：通过内置搜索快速找到项目和会话\n- **会话概览**：一目了然地查看首次消息、时间戳和会话元数据\n\n### 🤖 **CC 智能体**\n- **自定义 AI 智能体**：创建具有自定义系统提示和行为的专用智能体\n- **智能体库**：构建针对不同任务的专业智能体集合\n- **后台执行**：在独立进程中运行智能体，实现非阻塞操作\n- **执行历史**：记录所有智能体的运行情况，附带详细日志和性能指标\n\n\n\n### 📊 **使用分析仪表盘**\n- **费用跟踪**：实时监控您的 Claude API 使用量和费用\n- **Token 分析**：按模型、项目和时间段进行详细拆解\n- **可视化图表**：展示使用趋势和模式的精美图表\n- **数据导出**：导出使用数据用于会计和分析\n\n### 🔌 **MCP 服务器管理**\n- **服务器注册表**：通过中央 UI 管理 Model Context Protocol 服务器\n- **轻松配置**：可通过 UI 添加服务器，或从现有配置中导入\n- **连接测试**：在使用前验证服务器连通性\n- **Claude Desktop 导入**：从 Claude Desktop 导入服务器配置\n\n### ⏰ **时间线与检查点**\n- **会话版本控制**：可在编码会话中的任意时刻创建检查点\n- **可视化时间线**：通过分支式时间线导航会话历史\n- **即时恢复**：一键跳转回任意检查点\n- **分支会话**：从现有检查点创建新分支\n- **差异查看器**：清晰显示检查点之间的具体变化\n\n### 📝 **CLAUDE.md 管理**\n- **内置编辑器**：直接在应用内编辑 CLAUDE.md 文件\n- **实时预览**：即时查看 Markdown 渲染效果\n- **项目扫描**：查找您所有项目中的 CLAUDE.md 文件\n- **语法高亮**：全面支持 Markdown 并提供语法高亮\n\n## 📖 使用方法\n\n### 快速入门\n\n1. **启动 opcode**：安装完成后打开应用程序\n2. **欢迎界面**：选择 CC 智能体或项目\n3. **首次设置**：opcode 将自动检测您的 `~\u002F.claude` 目录\n\n### 项目管理\n\n```\n项目 → 选择项目 → 查看会话 → 恢复或开始新会话\n```\n\n- 点击任意项目即可查看其会话\n- 每个会话都会显示第一条消息和时间戳\n- 可直接恢复会话，也可开始新的会话\n\n### 创建智能体\n\n```\nCC 智能体 → 创建智能体 → 配置 → 执行\n```\n\n1. **设计您的智能体**：设置名称、图标和系统提示\n2. **选择模型**：从可用的 Claude 模型中挑选\n3. **设置权限**：配置文件读写和网络访问权限\n4. **执行任务**：在任意项目上运行您的智能体\n\n### 使用情况跟踪\n\n```\n菜单 → 使用仪表盘 → 查看分析\n```\n\n- 按模型、项目和日期监控费用\n- 导出数据以生成报告\n- 即将推出使用量警报功能\n\n### MCP 服务器操作\n\n```\n菜单 → MCP 管理器 → 添加服务器 → 配置\n```\n\n- 可手动添加服务器，也可通过 JSON 导入\n- 支持从 Claude Desktop 配置中导入\n- 在使用前测试连接\n\n## 🚀 安装\n\n### 先决条件\n\n- **Claude Code CLI**：请从 [Claude 官方网站](https:\u002F\u002Fclaude.ai\u002Fcode) 安装\n\n### 正式发布版可执行文件即将上线\n\n## 🔨 从源码构建\n\n### 前置条件\n\n在从源代码构建 opcode 之前，请确保已安装以下内容：\n\n#### 系统要求\n\n- **操作系统**：Windows 10\u002F11、macOS 11+ 或 Linux（Ubuntu 20.04+）\n- **内存**：至少 4GB（建议 8GB）\n- **存储空间**：至少 1GB 可用空间\n\n#### 必需工具\n\n1. **Rust**（1.70.0 或更高版本）\n   ```bash\n   # 使用 rustup 安装\n   curl --proto '=https' --tlsv1.2 -sSf https:\u002F\u002Fsh.rustup.rs | sh\n   ```\n\n2. **Bun**（最新版本）\n   ```bash\n   # 安装 bun\n   curl -fsSL https:\u002F\u002Fbun.sh\u002Finstall | bash\n   ```\n\n3. **Git**\n   ```bash\n   # 通常已预装，若未安装：\n   # Ubuntu\u002FDebian：sudo apt install git\n   # macOS：brew install git\n   # Windows：从 https:\u002F\u002Fgit-scm.com 下载\n   ```\n\n4. **Claude Code CLI**\n   - 从 [Claude 官方网站](https:\u002F\u002Fclaude.ai\u002Fcode) 下载并安装\n   - 确保 `claude` 已添加到您的 PATH 中\n\n#### 平台特定依赖\n\n**Linux（Ubuntu\u002FDebian）**\n```bash\n# 安装系统依赖\nsudo apt update\nsudo apt install -y \\\n  libwebkit2gtk-4.1-dev \\\n  libgtk-3-dev \\\n  libayatana-appindicator3-dev \\\n  librsvg2-dev \\\n  patchelf \\\n  build-essential \\\n  curl \\\n  wget \\\n  file \\\n  libssl-dev \\\n  libxdo-dev \\\n  libsoup-3.0-dev \\\n  libjavascriptcoregtk-4.1-dev\n```\n\n**macOS**\n```bash\n# 安装 Xcode 命令行工具\nxcode-select --install\n\n# 通过 Homebrew 安装额外依赖（可选）\nbrew install pkg-config\n```\n\n**Windows**\n- 安装 [Microsoft C++ 构建工具](https:\u002F\u002Fvisualstudio.microsoft.com\u002Fvisual-cpp-build-tools\u002F)\n- 安装 [WebView2](https:\u002F\u002Fdeveloper.microsoft.com\u002Fmicrosoft-edge\u002Fwebview2\u002F)（通常 Windows 11 已预装）\n\n### 构建步骤\n\n1. **克隆仓库**\n   ```bash\n   git clone https:\u002F\u002Fgithub.com\u002FgetAsterisk\u002Fopcode.git\n   cd opcode\n   ```\n\n2. **安装前端依赖**\n   ```bash\n   bun install\n   ```\n\n3. **构建应用程序**\n\n   **开发模式（支持热重载）**\n   ```bash\n   bun run tauri dev\n   ```\n\n   **生产构建**\n   ```bash\n   # 构建应用程序\n   bun run tauri build\n   \n   # 构建后的可执行文件位于：\n   # - Linux：src-tauri\u002Ftarget\u002Frelease\u002F\n   # - macOS：src-tauri\u002Ftarget\u002Frelease\u002F\n   # - Windows：src-tauri\u002Ftarget\u002Frelease\u002F\n   ```\n\n4. **平台特定构建选项**\n\n   **调试构建（编译更快，二进制文件更大）**\n   ```bash\n   bun run tauri build --debug\n   ```\n\n   **适用于 macOS 的通用二进制文件（Intel + Apple Silicon）**\n   ```bash\n   bun run tauri build --target universal-apple-darwin\n   ```\n\n### 故障排除\n\n#### 常见问题\n\n1. **“cargo not found” 错误**\n   - 确保 Rust 已安装，并且 `~\u002F.cargo\u002Fbin` 在您的 PATH 中\n   - 运行 `source ~\u002F.cargo\u002Fenv` 或重启终端\n\n2. **Linux：“webkit2gtk not found” 错误**\n   - 安装上述列出的 webkit2gtk 开发包\n   - 在较新的 Ubuntu 版本中，可能需要 `libwebkit2gtk-4.0-dev`\n\n3. **Windows：“MSVC not found” 错误**\n   - 安装包含 C++ 支持的 Visual Studio 构建工具\n   - 安装后重启终端\n\n4. **“claude command not found” 错误**\n   - 确保 Claude Code CLI 已安装并位于 PATH 中\n   - 使用 `claude --version` 测试\n\n5. **构建因“内存不足”失败**\n   - 尝试使用较少的并行任务进行构建：`cargo build -j 2`\n   - 关闭其他应用程序以释放 RAM\n\n#### 验证构建结果\n\n构建完成后，您可以验证应用程序是否正常运行：\n\n```bash\n# 直接运行构建后的可执行文件\n# Linux\u002FmacOS\n.\u002Fsrc-tauri\u002Ftarget\u002Frelease\u002Fopcode\n\n# Windows\n.\u002Fsrc-tauri\u002Ftarget\u002Frelease\u002Fopcode.exe\n```\n\n### 构建产物\n\n构建过程会生成多个产物：\n\n- **可执行文件**：主 opcode 应用程序\n- **安装程序**（使用 `tauri build` 时）：\n  - `.deb` 包（Linux）\n  - `.AppImage`（Linux）\n  - `.dmg` 安装程序（macOS）\n  - `.msi` 安装程序（Windows）\n  - `.exe` 安装程序（Windows）\n\n所有产物均位于 `src-tauri\u002Ftarget\u002Frelease\u002F` 目录下。\n\n## 🛠️ 开发\n\n### 技术栈\n\n- **前端**：React 18 + TypeScript + Vite 6\n- **后端**：Rust 与 Tauri 2\n- **UI 框架**：Tailwind CSS v4 + shadcn\u002Fui\n- **数据库**：SQLite（通过 rusqlite）\n- **包管理器**：Bun\n\n### 项目结构\n\n```\nopcode\u002F\n├── src\u002F                   # React 前端\n│   ├── components\u002F        # UI 组件\n│   ├── lib\u002F               # API 客户端及实用工具\n│   └── assets\u002F            # 静态资源\n├── src-tauri\u002F             # Rust 后端\n│   ├── src\u002F\n│   │   ├── commands\u002F      # Tauri 命令处理器\n│   │   ├── checkpoint\u002F    # 时间线管理\n│   │   └── process\u002F       # 进程管理\n│   └── tests\u002F             # Rust 测试套件\n└── public\u002F                # 公共资源\n```\n\n### 开发命令\n\n```bash\n# 启动开发服务器\nbun run tauri dev\n\n# 仅运行前端\nbun run dev\n\n# 类型检查\nbunx tsc --noEmit\n\n# 运行 Rust 测试\ncd src-tauri && cargo test\n\n# 格式化代码\ncd src-tauri && cargo fmt\n```\n\n## 🔒 安全性\n\nopcode 优先考虑您的隐私与安全：\n\n1. **进程隔离**：代理在独立进程中运行\n2. **权限控制**：可为每个代理配置文件和网络访问权限\n3. **本地存储**：所有数据均保存在您的设备上\n4. **无遥测**：不收集或追踪任何数据\n5. **开源**：通过开源代码实现完全透明\n\n## 🤝 贡献\n\n我们欢迎您的贡献！请参阅我们的 [贡献指南](CONTRIBUTING.md) 以获取详细信息。\n\n### 贡献领域\n\n- 🐛 Bug 修复与改进\n- ✨ 新功能与增强\n- 📚 文档改进\n- 🎨 UI\u002FUX 优化\n- 🧪 测试覆盖率提升\n- 🌐 国际化支持\n\n## 📄 许可证\n\n本项目采用 AGPL 许可证授权——详情请参阅 [LICENSE](LICENSE) 文件。\n\n## 🙏 致谢\n\n- 基于 [Tauri](https:\u002F\u002Ftauri.app\u002F) 构建——用于构建桌面应用的安全框架\n- Anthropic 的 [Claude](https:\u002F\u002Fclaude.ai)\n\n---\n\n\u003Cdiv align=\"center\">\n  \u003Cp>\n    \u003Cstrong>由 \u003Ca href=\"https:\u002F\u002Fasterisk.so\u002F\">Asterisk\u003C\u002Fa> 用心打造 ❤️\u003C\u002Fstrong>\n  \u003C\u002Fp>\n  \u003Cp>\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FgetAsterisk\u002Fopcode\u002Fissues\">报告 Bug\u003C\u002Fa>\n    ·\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FgetAsterisk\u002Fopcode\u002Fissues\">请求功能\u003C\u002Fa>\n  \u003C\u002Fp>\n\u003C\u002Fdiv>\n\n\n## 星标历史\n\n[![星标历史图表](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwinfunc_opcode_readme_a70d13930214.png)](https:\u002F\u002Fwww.star-history.com\u002F#getAsterisk\u002Fopcode&Date)","# opcode 快速上手指南\n\n**opcode** 是一款基于 Tauri 2 构建的强大桌面应用，旨在为 **Claude Code** 提供图形化界面（GUI）。它可以帮助你管理项目会话、创建自定义 AI 代理、监控 API 用量以及配置 MCP 服务器，让 AI 辅助开发更加直观高效。\n\n## 1. 环境准备\n\n在开始之前，请确保你的系统满足以下要求并安装了必要的依赖。\n\n### 系统要求\n- **操作系统**: Windows 10\u002F11, macOS 11+, 或 Linux (Ubuntu 20.04+)\n- **内存**: 最低 4GB (推荐 8GB)\n- **存储**: 至少 1GB 可用空间\n\n### 前置依赖安装\n\n#### 1. 安装 Claude Code CLI (必需)\nopcode 依赖官方的 Claude Code 命令行工具。\n- 访问 [Claude 官网](https:\u002F\u002Fclaude.ai\u002Fcode) 下载并安装。\n- 确保安装后可以在终端运行 `claude --version`。\n\n#### 2. 安装基础开发工具\n你需要安装 **Rust**, **Bun**, 和 **Git**。\n\n*   **Rust** (后端核心):\n    ```bash\n    curl --proto '=https' --tlsv1.2 -sSf https:\u002F\u002Fsh.rustup.rs | sh\n    # 安装完成后重启终端或运行：source ~\u002F.cargo\u002Fenv\n    ```\n    > 💡 **国内加速**: 如果下载缓慢，可配置国内镜像源：\n    > ```bash\n    > export RUSTUP_DIST_SERVER=https:\u002F\u002Fmirrors.tuna.tsinghua.edu.cn\u002Frustup\n    > export RUSTUP_UPDATE_ROOT=https:\u002F\u002Fmirrors.tuna.tsinghua.edu.cn\u002Frustup\u002Frustup\n    > curl --proto '=https' --tlsv1.2 -sSf https:\u002F\u002Fsh.rustup.rs | sh\n    > ```\n\n*   **Bun** (前端包管理器):\n    ```bash\n    curl -fsSL https:\u002F\u002Fbun.sh\u002Finstall | bash\n    ```\n    > 💡 **国内加速**:\n    > ```bash\n    > curl -fsSL https:\u002F\u002Fmirrors.sdu.edu.cn\u002Fmisc\u002Fbun.sh\u002Finstall | bash\n    > ```\n\n*   **Git**:\n    - macOS: `brew install git`\n    - Ubuntu\u002FDebian: `sudo apt install git`\n    - Windows: 从 [git-scm.com](https:\u002F\u002Fgit-scm.com) 下载安装。\n\n#### 3. 平台特定依赖 (仅 Linux 用户需要)\n如果你使用 Ubuntu\u002FDebian，需安装以下系统库以支持 Tauri 构建：\n```bash\nsudo apt update\nsudo apt install -y \\\n  libwebkit2gtk-4.1-dev \\\n  libgtk-3-dev \\\n  libayatana-appindicator3-dev \\\n  librsvg2-dev \\\n  patchelf \\\n  build-essential \\\n  curl \\\n  wget \\\n  file \\\n  libssl-dev \\\n  libxdo-dev \\\n  libsoup-3.0-dev \\\n  libjavascriptcoregtk-4.1-dev\n```\n\n## 2. 安装步骤 (源码构建)\n\n目前官方尚未发布预编译安装包，请通过源码构建安装。\n\n### 第一步：克隆项目\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FgetAsterisk\u002Fopcode.git\ncd opcode\n```\n\n### 第二步：安装前端依赖\n```bash\nbun install\n```\n> 💡 **国内加速**: 如果遇到依赖下载慢，可临时设置 Bun 的 registry：\n> ```bash\n> bun config set registry https:\u002F\u002Fregistry.npmmirror.com\n> bun install\n> ```\n\n### 第三步：构建应用\n\n**选项 A：开发模式运行 (带热重载)**\n适合调试或首次体验：\n```bash\nbun run tauri dev\n```\n\n**选项 B：生产环境构建 (生成可执行文件)**\n构建完成后，可执行文件位于 `src-tauri\u002Ftarget\u002Frelease\u002F` 目录下：\n```bash\nbun run tauri build\n```\n\n- **Linux\u002FmacOS 运行**: `.\u002Fsrc-tauri\u002Ftarget\u002Frelease\u002Fopcode`\n- **Windows 运行**: `.\\src-tauri\\target\\release\\opcode.exe`\n\n## 3. 基本使用\n\n构建完成并启动应用后，你将看到欢迎界面。以下是核心功能的最简操作流程：\n\n### 🚀 快速开始\n1.  启动 **opcode**。\n2.  应用会自动检测本地的 `~\u002F.claude` 目录。\n3.  在主界面选择进入 **Projects** (项目管理) 或 **CC Agents** (代理管理)。\n\n### 📂 管理项目与会话\n- **浏览项目**: 点击左侧项目列表，查看该目录下所有的 Claude Code 会话历史。\n- **恢复会话**: 点击任意历史会话，查看上下文消息，点击 \"Resume\" 继续之前的工作，或 \"Start New\" 开启新对话。\n- **时间轴回溯**: 在会话视图中，利用时间轴功能创建检查点 (Checkpoints)，随时一键回滚代码状态或分支出新会话。\n\n### 🤖 创建自定义 Agent\n1.  进入 **CC Agents** 标签页，点击 **Create Agent**。\n2.  **配置**: 输入名称、上传图标、编写 System Prompt (系统提示词)。\n3.  **权限**: 设定该代理的文件读写范围及网络访问权限。\n4.  **运行**: 选择目标项目，点击执行，代理将在后台独立进程中运行任务。\n\n### 📊 查看用量统计\n- 点击菜单中的 **Usage Dashboard**。\n- 实时查看不同模型、不同项目的 Token 消耗和成本估算。\n- 支持导出数据进行财务分析。\n\n### 🔌 配置 MCP 服务器\n- 进入 **MCP Manager**。\n- 手动添加服务器配置或通过 JSON 导入。\n- 支持直接从 Claude Desktop 导入现有配置，并提供连接测试功能。","资深全栈开发者李明正在同时维护三个微服务项目，需要频繁切换上下文并利用 Claude Code 进行代码重构和 Bug 修复。\n\n### 没有 opcode 时\n- **会话管理混乱**：只能依赖终端历史记录查找过往对话，一旦关闭窗口就难以恢复包含完整上下文的开发现场。\n- **角色切换繁琐**：每次让 AI 执行不同任务（如“单元测试”或“数据库迁移”）时，都要手动重复输入复杂的系统提示词来定义 AI 行为。\n- **成本黑盒焦虑**：无法实时查看各项目的 Token 消耗明细，往往在月底收到账单时才发现某个实验性项目耗资过高。\n- **后台任务阻塞**：运行耗时较长的代码生成任务时，终端被占用，无法并行处理其他紧急的开发指令。\n\n### 使用 opcode 后\n- **可视化断点续传**：通过图形界面直观浏览所有项目会话，点击即可瞬间恢复之前的编码现场，无缝衔接中断的工作流。\n- **自定义智能体库**：预先配置好“测试专家”、“重构助手”等专用 Agent，一键调用即可让 AI 以特定专业角色投入工作，无需重复咒语。\n- **实时成本看板**：仪表盘清晰展示每个项目、每种模型的实时用量与费用趋势，帮助团队精准控制预算并及时优化策略。\n- **无感后台执行**：将耗时任务交给后台 Agent 独立运行，主界面保持流畅响应，实现多任务并行处理而不互相干扰。\n\nopcode 将原本碎片化、黑盒化的命令行交互，升级为可视、可控且高效的 AI 研发指挥中心。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fwinfunc_opcode_a5c4aaf3.png","winfunc","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fwinfunc_af4c8e9b.png","winfunc.",null,"hello@winfunc.com","winfunction","https:\u002F\u002Fwinfunc.com","https:\u002F\u002Fgithub.com\u002Fwinfunc",[82,86,90,94,98,101,105],{"name":83,"color":84,"percentage":85},"TypeScript","#3178c6",76.4,{"name":87,"color":88,"percentage":89},"Rust","#dea584",21.9,{"name":91,"color":92,"percentage":93},"CSS","#663399",1.5,{"name":95,"color":96,"percentage":97},"Just","#384d54",0.1,{"name":99,"color":100,"percentage":97},"Shell","#89e051",{"name":102,"color":103,"percentage":104},"Nix","#7e7eff",0,{"name":106,"color":107,"percentage":104},"HTML","#e34c26",21523,1661,"2026-04-15T12:53:53","AGPL-3.0","Windows 10\u002F11, macOS 11+, Linux (Ubuntu 20.04+)","未说明","最低 4GB，推荐 8GB",{"notes":116,"python":113,"dependencies":117},"该工具是基于 Tauri 的桌面应用，非 Python 项目。构建前必须安装 Claude Code CLI 并确保其在系统 PATH 中。Linux 用户需安装 webkit2gtk 等系统级开发库；Windows 用户需安装 Microsoft C++ Build Tools 和 WebView2；macOS 用户需安装 Xcode Command Line Tools。",[118,119,120,121,122,83,123,124,125,126],"Rust >= 1.70.0","Bun (latest)","Git","Claude Code CLI","React 18","Vite 6","Tauri 2","Tailwind CSS v4","SQLite (rusqlite)",[35,14,128],"视频",[130,131,132,133,134,135,136,137,138,139,140,141,142,143,144],"anthropic","anthropic-claude","claude","claude-4","claude-4-sonnet","claude-ai","claude-code","claude-code-sdk","cursor","ide","llm","llm-code","claude-4-opus","rust","tauri","2026-03-27T02:49:30.150509","2026-04-16T08:19:18.009993",[148,153,158,163,168,173],{"id":149,"question_zh":150,"answer_zh":151,"source_url":152},35263,"为什么项目从 Claudia 改名为 Gooey 或 opcode？","项目最近从 Claudia 更名为 opcode（Gooey 这个名字被认为不够好），主要是因为与 Anthropic 的 Claude 名称过于相似，为了避免潜在的商标法律纠纷。新官网已上线：https:\u002F\u002Fopcode.sh\u002F","https:\u002F\u002Fgithub.com\u002Fwinfunc\u002Fopcode\u002Fissues\u002F317",{"id":154,"question_zh":155,"answer_zh":156,"source_url":157},35264,"macOS 下打包后的 DMG 应用提示“未找到 Claude Code 安装”怎么办？","在 Mac M2 环境下，开发模式 (`bun run tauri dev`) 能正常找到 Claude，但打包后 (`bun run tauri build`) 会报错。这通常是因为 `src-tauri\u002Ftauri.conf.json` 文件中 `bundle > icon` 部分缺少了图标配置。解决方法是用 VS Code 编辑该文件，在 icon 列表中添加 `\"icons\u002Ficon.icns\"`。此问题已在后续提交中修复。","https:\u002F\u002Fgithub.com\u002Fwinfunc\u002Fopcode\u002Fissues\u002F37",{"id":159,"question_zh":160,"answer_zh":161,"source_url":162},35265,"集成终端无法找到 pnpm、npm 等命令（PATH 环境变量失效）如何解决？","这是 macOS 下的常见问题，应用内置终端未正确继承用户 Shell（如 .zshrc）中的 PATH 变量，导致找不到通过 Homebrew 或 nvm 安装的命令。解决方案是：不要使用默认捆绑的 Claude Code，而是在设置中选择系统安装的 Claude Code 路径。具体操作可尝试将系统的 claude 二进制文件复制并重命名为 claude-code，或者在应用设置中手动指定系统 Claude 的路径。","https:\u002F\u002Fgithub.com\u002Fwinfunc\u002Fopcode\u002Fissues\u002F197",{"id":164,"question_zh":165,"answer_zh":166,"source_url":167},35266,"Windows 下编译运行后提示找不到 Claude Code 怎么办？","在 Windows 11 下编译运行时如果找不到 Claude Code，通常是因为应用扫描 Windows 环境变量的逻辑存在问题，或者安装了带有额外组件的“全家桶”版本导致版本不匹配。建议参考 Issue #213 的修复方案，检查环境变量配置或更新到包含该修复的最新版本。","https:\u002F\u002Fgithub.com\u002Fwinfunc\u002Fopcode\u002Fissues\u002F229",{"id":169,"question_zh":170,"answer_zh":171,"source_url":172},35267,"运行时提示“env: node: No such file or directory”错误如何修复？","该错误通常由环境配置问题引起。社区贡献者已通过 Pull Request #69 修复了包括此问题在内的多个缺陷（涉及历史记录、node 环境和聊天无限加载问题）。建议拉取最新代码或应用该 PR 中的文件更改即可解决。","https:\u002F\u002Fgithub.com\u002Fwinfunc\u002Fopcode\u002Fissues\u002F64",{"id":174,"question_zh":175,"answer_zh":176,"source_url":177},35268,"执行命令时提示“error: unknown option '--model'”是什么原因？","在 macOS 等平台使用 v0.2.0 等旧版本时，发送任何 prompt 都可能返回此错误。这通常是由于版本不兼容或构建问题导致的。诊断信息显示运行版本为 unknown 时尤为常见。解决方法是重新构建最新版本（fresh build），新版本通常能正常识别该参数。","https:\u002F\u002Fgithub.com\u002Fwinfunc\u002Fopcode\u002Fissues\u002F111",[179,184],{"id":180,"version":181,"summary_zh":182,"released_at":183},280298,"v0.2.0","\u003Cdiv align=\"center\">\r\n  \u003Cimg src=\"https:\u002F\u002Fraw.githubusercontent.com\u002FgetAsterisk\u002Fopcode\u002Fv0.2.0\u002Fsrc-tauri\u002Ficons\u002Ficon.png\" alt=\"opcode Logo\" width=\"128\" height=\"128\">\r\n\u003C\u002Fdiv>\r\n\r\n## opcode v0.2.0\r\n\r\n### 变更内容\r\n\r\n- 将 Claudia 更名为 opcode\r\n- 添加了匿名化的分析跟踪功能\r\n\r\n### 下载\r\n\r\n- macOS: `.dmg`、`.app.tar.gz`（通用：适用于 Apple Silicon 和 Intel 处理器）\r\n- Linux: `.AppImage`、`.deb`\r\n\r\n### 安装\r\n\r\n- macOS: 打开 `.dmg` 文件，将 opcode 拖拽到“应用程序”文件夹中。\r\n- Linux: 对 `.AppImage` 文件执行 `chmod +x` 命令并运行，或在 Debian\u002FUbuntu 系统上安装 `.deb` 包。\r\n\r\n\r\n**完整更新日志**: https:\u002F\u002Fgithub.com\u002FgetAsterisk\u002Fopcode\u002Fcompare\u002Fv0.1.0...v0.2.0","2025-08-31T15:13:14",{"id":185,"version":186,"summary_zh":187,"released_at":188},280299,"v0.1.0","## 变更内容\n* docs: 在 README 中添加 Star History 图表，由 @coygeek 在 https:\u002F\u002Fgithub.com\u002FgetAsterisk\u002Fclaudia\u002Fpull\u002F15 中完成\n* 添加 Claude Code GitHub Actions，由 @mufeedvh 在 https:\u002F\u002Fgithub.com\u002FgetAsterisk\u002Fclaudia\u002Fpull\u002F55 中完成\n* feat: 实现支持后台执行的可恢复 Claude 会话，由 @mufeedvh 在 https:\u002F\u002Fgithub.com\u002FgetAsterisk\u002Fclaudia\u002Fpull\u002F93 中完成\n* Fix: 根据 Apple 设计规范调整 macOS 版本的应用图标尺寸。由 @bfmvsa 在 https:\u002F\u002Fgithub.com\u002FgetAsterisk\u002Fclaudia\u002Fpull\u002F112 中完成\n* Improve: 修复 Tauri 暗色主题中的白色滚动条问题，由 @brennercruvinel 在 https:\u002F\u002Fgithub.com\u002FgetAsterisk\u002Fclaudia\u002Fpull\u002F234 中完成\n* feat: 添加代理配置支持，由 @xmqywx 在 https:\u002F\u002Fgithub.com\u002FgetAsterisk\u002Fclaudia\u002Fpull\u002F179 中完成\n* Fix: 修复标签管理器的 UX 问题，由 @thetronjohnson 在 https:\u002F\u002Fgithub.com\u002FgetAsterisk\u002Fclaudia\u002Fpull\u002F251 中完成\n\n## 新贡献者\n* @coygeek 在 https:\u002F\u002Fgithub.com\u002FgetAsterisk\u002Fclaudia\u002Fpull\u002F15 中完成了首次贡献\n* @mufeedvh 在 https:\u002F\u002Fgithub.com\u002FgetAsterisk\u002Fclaudia\u002Fpull\u002F55 中完成了首次贡献\n* @bfmvsa 在 https:\u002F\u002Fgithub.com\u002FgetAsterisk\u002Fclaudia\u002Fpull\u002F112 中完成了首次贡献\n* @brennercruvinel 在 https:\u002F\u002Fgithub.com\u002FgetAsterisk\u002Fclaudia\u002Fpull\u002F234 中完成了首次贡献\n* @xmqywx 在 https:\u002F\u002Fgithub.com\u002FgetAsterisk\u002Fclaudia\u002Fpull\u002F179 中完成了首次贡献\n* @123vivekr 在 https:\u002F\u002Fgithub.com\u002FgetAsterisk\u002Fclaudia\u002Fpull\u002F268 中完成了首次贡献\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002FgetAsterisk\u002Fclaudia\u002Fcommits\u002Fv0.1.0","2025-08-15T06:21:51"]