[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-op7418--CodePilot":3,"tool-op7418--CodePilot":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 真正成长为懂上",156033,2,"2026-04-14T23:32:00",[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":74,"owner_avatar_url":75,"owner_bio":76,"owner_company":77,"owner_location":78,"owner_email":77,"owner_twitter":73,"owner_website":77,"owner_url":79,"languages":80,"stars":96,"forks":97,"last_commit_at":98,"license":99,"difficulty_score":100,"env_os":101,"env_gpu":102,"env_ram":102,"env_deps":103,"category_tags":108,"github_topics":109,"view_count":32,"oss_zip_url":77,"oss_zip_packed_at":77,"status":17,"created_at":118,"updated_at":119,"faqs":120,"releases":156},7644,"op7418\u002FCodePilot","CodePilot","A multi-model AI agent desktop client — connect any AI provider, extend with MCP & skills, control from your phone. Built with Electron + Next.js.","CodePilot 是一款功能强大的多模型 AI 智能体桌面客户端，旨在为用户提供一个统一、灵活的 AI 交互中心。它解决了当前 AI 工具分散、切换繁琐且难以跨设备协同的痛点，让用户无需在不同平台间反复跳转，即可在一个界面中无缝连接包括 Anthropic、OpenAI、国产大模型及本地部署在内的 17+ 种 AI 服务商，甚至能在对话中途自由切换模型而不丢失上下文。\n\n这款工具不仅限于代码辅助，更进化为通用的个人智能工作空间。它支持“生成式 UI\"，让 AI 能直接渲染交互式图表和仪表盘；具备远程桥接功能，可通过手机在微信、钉钉等即时通讯软件中控制桌面端任务；同时引入 MCP 协议与技能市场，极大扩展了自动化能力。此外，CodePilot 还贴心地提供了会话回溯、分屏对比、用量统计及持久化记忆等功能，帮助助手随着使用时间推移更懂你的工作习惯。\n\nCodePilot 非常适合开发者、研究人员、设计师以及任何希望深度整合 AI 到日常流中的进阶用户。无论你是需要频繁对比不同模型效果的极客，还是希望通过手机随时调度桌面算力的忙碌职场人，CodePilot 都能凭借基于 Electron ","CodePilot 是一款功能强大的多模型 AI 智能体桌面客户端，旨在为用户提供一个统一、灵活的 AI 交互中心。它解决了当前 AI 工具分散、切换繁琐且难以跨设备协同的痛点，让用户无需在不同平台间反复跳转，即可在一个界面中无缝连接包括 Anthropic、OpenAI、国产大模型及本地部署在内的 17+ 种 AI 服务商，甚至能在对话中途自由切换模型而不丢失上下文。\n\n这款工具不仅限于代码辅助，更进化为通用的个人智能工作空间。它支持“生成式 UI\"，让 AI 能直接渲染交互式图表和仪表盘；具备远程桥接功能，可通过手机在微信、钉钉等即时通讯软件中控制桌面端任务；同时引入 MCP 协议与技能市场，极大扩展了自动化能力。此外，CodePilot 还贴心地提供了会话回溯、分屏对比、用量统计及持久化记忆等功能，帮助助手随着使用时间推移更懂你的工作习惯。\n\nCodePilot 非常适合开发者、研究人员、设计师以及任何希望深度整合 AI 到日常流中的进阶用户。无论你是需要频繁对比不同模型效果的极客，还是希望通过手机随时调度桌面算力的忙碌职场人，CodePilot 都能凭借基于 Electron 和 Next.js 构建的流畅体验，成为你得力的数字副驾驶。","\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fop7418_CodePilot_readme_41c5e2c733a1.png\" width=\"32\" height=\"32\" alt=\"CodePilot\" style=\"vertical-align: middle; margin-right: 8px;\" \u002F> CodePilot\n===\n\n**A multi-model AI agent desktop client** -- connect any AI provider, extend with MCP & skills, control from your phone, and let your assistant learn your workflow.\n\n[![GitHub release](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Fop7418\u002FCodePilot)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases)\n[![Downloads](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fdownloads\u002Fop7418\u002FCodePilot\u002Ftotal)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases)\n[![GitHub stars](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fop7418\u002FCodePilot)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Fstargazers)\n[![Platform](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fplatform-macOS%20%7C%20Windows%20%7C%20Linux-lightgrey)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-BSL--1.1-orange)](LICENSE)\n\n[中文文档](.\u002FREADME_CN.md) | [日本語](.\u002FREADME_JA.md)\n\n![CodePilot](https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F9750450a-9f6f-49ce-acd4-c623a4e24281)\n\n---\n\n[Download](#download) | [Quick Start](#quick-start) | [Documentation](#documentation) | [Contributing](#contributing) | [Community](#community)\n\n---\n\n## Download\n\n| Platform | Download | Architecture |\n|---|---|---|\n| macOS | [Apple Silicon (.dmg)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Flatest) · [Intel (.dmg)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Flatest) | arm64 \u002F x64 |\n| Windows | [Installer (.exe)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Flatest) | x64 + arm64 |\n| Linux | [AppImage](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Flatest) · [.deb](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Flatest) · [.rpm](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Flatest) | x64 + arm64 |\n\nOr visit the [Releases](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases) page for all versions.\n\n---\n\n## Why CodePilot\n\n### Multi-provider, one interface\n\nConnect to **17+ AI providers** out of the box. Switch providers and models mid-conversation without losing context.\n\n| Category | Providers |\n|---|---|\n| Direct API | Anthropic, OpenRouter |\n| Cloud platforms | AWS Bedrock, Google Vertex AI |\n| Chinese AI providers | Zhipu GLM (CN\u002FGlobal), Kimi, Moonshot, MiniMax (CN\u002FGlobal), Volcengine Ark (Doubao), Xiaomi MiMo, Aliyun Bailian (Qwen) |\n| Local & self-hosted | Ollama, LiteLLM |\n| Custom | Any Anthropic-compatible or OpenAI-compatible endpoint |\n| Media | Google Gemini (image generation) |\n\n### Beyond coding — a full AI agent\n\nCodePilot started as a coding tool but has grown into a **general-purpose AI agent desktop**:\n\n- **Assistant Workspace** — Persona files, persistent memory, onboarding flows, and daily check-ins. Your assistant learns your preferences and adapts over time.\n- **Generative UI** — AI can create interactive dashboards, charts, and visual widgets rendered live in-app.\n- **Remote Bridge** — Connect to Telegram, Feishu, Discord, QQ, and WeChat. Send messages from your phone, get responses on your desktop.\n- **MCP + Skills** — Add MCP servers (stdio \u002F sse \u002F http) with runtime monitoring. Define reusable skills or install from the skills.sh marketplace.\n- **Media Studio** — AI image generation with batch tasks, gallery, and tagging.\n- **Task Scheduler** — Schedule recurring tasks with cron expressions or intervals.\n\n### Built for daily use\n\n- Pause, resume, and **rewind sessions to any checkpoint**\n- **Split-screen** dual sessions side by side\n- Track **token usage and costs** with daily charts\n- Import Claude Code CLI session history\n- Dark \u002F Light theme toggle\n- English + Chinese interface\n\n---\n\n## Quick Start\n\n### Path A: Download a release (most users)\n\n1. Download the installer for your platform from the [Download](#download) section above\n2. Launch CodePilot\n3. **Configure a Provider** in **Settings > Providers** — add your API key for any supported provider\n4. Start a conversation\n\n> **Note:** Installing the [Claude Code CLI](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Foverview) (`npm install -g @anthropic-ai\u002Fclaude-code`) unlocks additional capabilities like direct file editing, terminal commands, and git operations. It is recommended but not required for basic chat.\n\n### Path B: Build from source (developers)\n\n| Prerequisite | Minimum version |\n|---|---|\n| Node.js | 18+ |\n| npm | 9+ (ships with Node 18) |\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot.git\ncd CodePilot\nnpm install\nnpm run dev              # browser mode at http:\u002F\u002Flocalhost:3000\n# -- or --\nnpm run electron:dev     # full desktop app\n```\n\n---\n\n## Core Capabilities\n\n### Conversation & Interaction\n\n| Capability | Details |\n|---|---|\n| Interaction modes | Code \u002F Plan \u002F Ask |\n| Reasoning effort | Low \u002F Medium \u002F High \u002F Max + Thinking mode |\n| Permission control | Default \u002F Full Access, per-action approval |\n| Session control | Pause, resume, rewind to checkpoint, archive |\n| Model switching | Change model mid-conversation |\n| Split screen | Side-by-side dual sessions |\n| Attachments | Files and images with multimodal vision support |\n| Slash commands | \u002Fhelp \u002Fclear \u002Fcost \u002Fcompact \u002Fdoctor \u002Freview and more |\n\n### Extensions & Integrations\n\n| Capability | Details |\n|---|---|\n| Providers | 17+ providers: Anthropic, OpenRouter, Bedrock, Vertex, Zhipu GLM, Kimi, Moonshot, MiniMax, Volcengine, MiMo, Bailian, Ollama, LiteLLM, custom endpoints |\n| MCP servers | stdio \u002F sse \u002F http, runtime status monitoring |\n| Skills | Custom \u002F project \u002F global skills, skills.sh marketplace |\n| Bridge | Telegram \u002F Feishu \u002F Discord \u002F QQ \u002F WeChat remote control |\n| CLI import | Import Claude Code CLI .jsonl session history |\n| Image generation | Gemini image gen, batch tasks, gallery |\n\n### Data & Workspace\n\n| Capability | Details |\n|---|---|\n| Assistant Workspace | Persona files (soul.md, user.md, claude.md, memory.md), onboarding, daily check-ins, persistent memory |\n| Generative UI | AI-created interactive dashboards and visual widgets |\n| File browser | Project file tree with syntax-highlighted preview |\n| Git panel | Status, branches, commits, worktree management |\n| Usage analytics | Token counts, cost estimates, daily usage charts |\n| Task scheduler | Cron-based and interval scheduling with persistence |\n| Local storage | SQLite (WAL mode), all data stays on your machine |\n| i18n | English + Chinese |\n| Themes | Dark \u002F Light, one-click toggle |\n\n---\n\n## First Launch\n\n1. **Configure a Provider** — Go to **Settings > Providers** and add credentials for the provider you want to use. CodePilot includes presets for all major providers — just pick one and enter your API key.\n2. **Create a conversation** — Pick a working directory, select a mode (Code \u002F Plan \u002F Ask), and choose a model.\n3. **Set up Assistant Workspace** (optional) — Go to **Settings > Assistant**, choose a workspace directory, and enable Onboarding. CodePilot creates `soul.md`, `user.md`, `claude.md`, and `memory.md` at the workspace root.\n4. **Add MCP servers** (optional) — Go to the **MCP** page in the sidebar to add and manage MCP servers. Custom skills are managed on the separate **Skills** page.\n5. **Install Claude Code CLI** (optional) — For advanced features like file editing and terminal commands, install the CLI: `npm install -g @anthropic-ai\u002Fclaude-code`\n\n---\n\n## Platform & Installation Notes\n\nmacOS builds are code-signed with a Developer ID certificate but not notarized, so Gatekeeper may still prompt on first launch. Windows and Linux builds are unsigned.\n\n\u003Cdetails>\n\u003Csummary>macOS: Gatekeeper warning on first launch\u003C\u002Fsummary>\n\n**Option 1** -- Right-click `CodePilot.app` in Finder > Open > confirm.\n\n**Option 2** -- System Settings > Privacy & Security > scroll to Security > click Open Anyway.\n\n**Option 3** -- Run in Terminal:\n```bash\nxattr -cr \u002FApplications\u002FCodePilot.app\n```\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>Windows: SmartScreen blocks the installer\u003C\u002Fsummary>\n\n**Option 1** -- Click \"More info\" on the SmartScreen dialog, then \"Run anyway\".\n\n**Option 2** -- Settings > Apps > Advanced app settings > set App Install Control to allow apps from anywhere.\n\u003C\u002Fdetails>\n\n---\n\n## Documentation\n\n📖 **Full documentation:** [English](https:\u002F\u002Fwww.codepilot.sh\u002Fdocs) | [中文](https:\u002F\u002Fwww.codepilot.sh\u002Fzh\u002Fdocs)\n\n**Getting started:**\n- [Quick Start](#quick-start) -- Download or build from source\n- [First Launch](#first-launch) -- Provider setup, workspace configuration\n- [Installation Guide](https:\u002F\u002Fwww.codepilot.sh\u002Fdocs\u002Finstallation) -- Detailed setup instructions\n\n**User guides:**\n- [Providers](https:\u002F\u002Fwww.codepilot.sh\u002Fdocs\u002Fproviders) -- Configuring AI providers and custom endpoints\n- [MCP Servers](https:\u002F\u002Fwww.codepilot.sh\u002Fdocs\u002Fmcp) -- Adding and managing Model Context Protocol servers\n- [Skills](https:\u002F\u002Fwww.codepilot.sh\u002Fdocs\u002Fskills) -- Custom skills, project skills, and the skills.sh marketplace\n- [Bridge](https:\u002F\u002Fwww.codepilot.sh\u002Fdocs\u002Fbridge) -- Remote control via Telegram, Feishu, Discord, QQ, WeChat\n- [Assistant Workspace](https:\u002F\u002Fwww.codepilot.sh\u002Fdocs\u002Fassistant-workspace) -- Persona files, onboarding, memory, daily check-ins\n- [FAQ](https:\u002F\u002Fwww.codepilot.sh\u002Fdocs\u002Ffaq) -- Common issues and solutions\n\n**Developer docs:**\n- [ARCHITECTURE.md](.\u002FARCHITECTURE.md) -- Architecture, tech stack, directory structure, data flow\n- [docs\u002Fhandover\u002F](.\u002Fdocs\u002Fhandover\u002F) -- Design decisions and handover documents\n- [docs\u002Fexec-plans\u002F](.\u002Fdocs\u002Fexec-plans\u002F) -- Execution plans and tech debt tracker\n\n---\n\n## FAQ\n\n\u003Cdetails>\n\u003Csummary>Do I need the Claude Code CLI?\u003C\u002Fsummary>\n\nNo. You can use CodePilot with any supported provider (OpenRouter, Zhipu GLM, Volcengine, Ollama, etc.) without the Claude Code CLI. The CLI is only needed if you want Claude to directly edit files, run terminal commands, or use git operations on your machine. For chat and assistant features, just configure a provider and start a conversation.\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>Configured a Provider but no models appear\u003C\u002Fsummary>\n\nVerify the API key is valid and the endpoint is reachable. Some providers (Bedrock, Vertex) require additional environment variables or IAM configuration beyond the API key. Use the built-in diagnostics (**Settings > Providers > Run Diagnostics**) to check connectivity.\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>What is the difference between \u003Ccode>npm run dev\u003C\u002Fcode> and \u003Ccode>npm run electron:dev\u003C\u002Fcode>?\u003C\u002Fsummary>\n\n`npm run dev` starts only the Next.js dev server -- you use CodePilot in your browser at `http:\u002F\u002Flocalhost:3000`. `npm run electron:dev` starts both Next.js and the Electron shell, giving you the full desktop app experience with native window controls.\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>Where are the Assistant Workspace files?\u003C\u002Fsummary>\n\nWhen you set up a workspace, CodePilot creates four Markdown files at the **workspace root directory**: `soul.md` (personality), `user.md` (user profile), `claude.md` (rules), and `memory.md` (long-term notes). State tracking (onboarding progress, check-in dates) is stored in the `.assistant\u002F` subdirectory. Daily memories go to `memory\u002Fdaily\u002F`.\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>Bridge requires additional setup per platform\u003C\u002Fsummary>\n\nEach Bridge channel (Telegram, Feishu, Discord, QQ, WeChat) requires its own bot token or app credentials. Go to the **Bridge** page in the sidebar to configure channels. You will need to create a bot on the target platform first and provide the token to CodePilot.\n\u003C\u002Fdetails>\n\n---\n\n## Community\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fop7418_CodePilot_readme_c63e460b4c69.png\" width=\"240\" alt=\"WeChat Group QR Code\" \u002F>\n\nScan the QR code to join the WeChat user group for discussions, feedback, and updates.\n\n- [GitHub Issues](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Fissues) -- Bug reports and feature requests\n- [GitHub Discussions](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Fdiscussions) -- Questions and general discussion\n\n---\n\n## Contributing\n\n1. Fork the repository and create a feature branch\n2. `npm install` and `npm run electron:dev` to develop locally\n3. Run `npm run test` before opening a PR\n4. Submit a PR against `main` with a clear description\n\nKeep PRs focused -- one feature or fix per pull request.\n\n\u003Cdetails>\n\u003Csummary>Development commands\u003C\u002Fsummary>\n\n```bash\nnpm run dev                    # Next.js dev server (browser)\nnpm run electron:dev           # Full Electron app (dev mode)\nnpm run build                  # Production build\nnpm run electron:build         # Build Electron distributable\nnpm run electron:pack:mac      # macOS DMG (arm64 + x64)\nnpm run electron:pack:win      # Windows NSIS installer\nnpm run electron:pack:linux    # Linux AppImage, deb, rpm\n```\n\n**CI\u002FCD:** Pushing a `v*` tag triggers a full multi-platform build and creates a GitHub Release automatically.\n\n**Notes:**\n- Electron forks a Next.js standalone server on `127.0.0.1` with a random free port\n- Chat data is stored in `~\u002F.codepilot\u002Fcodepilot.db` (dev mode: `.\u002Fdata\u002F`)\n- SQLite uses WAL mode for fast concurrent reads\n\u003C\u002Fdetails>\n\n---\n\n## License\n\n[Business Source License 1.1 (BSL-1.1)](LICENSE)\n\n- **Personal \u002F academic \u002F non-profit use**: free and unrestricted\n- **Commercial use**: requires a separate license — contact [@op7418 on X](https:\u002F\u002Fx.com\u002Fop7418)\n- **Change date**: 2029-03-16 — after which the code converts to Apache 2.0\n","\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fop7418_CodePilot_readme_41c5e2c733a1.png\" width=\"32\" height=\"32\" alt=\"CodePilot\" style=\"vertical-align: middle; margin-right: 8px;\" \u002F> CodePilot\n===\n\n**一款多模型 AI 助手桌面客户端** -- 可连接任意 AI 提供商，通过 MCP 和技能扩展功能，用手机控制，并让您的助手学习您的工作流程。\n\n[![GitHub 发布](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Fop7418\u002FCodePilot)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases)\n[![下载量](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fdownloads\u002Fop7418\u002FCodePilot\u002Ftotal)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases)\n[![GitHub 星标](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fop7418\u002FCodePilot)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Fstargazers)\n[![平台](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fplatform-macOS%20%7C%20Windows%20%7C%20Linux-lightgrey)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases)\n[![许可证](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-BSL--1.1-orange)](LICENSE)\n\n[中文文档](.\u002FREADME_CN.md) | [日本語](.\u002FREADME_JA.md)\n\n![CodePilot](https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F9750450a-9f6f-49ce-acd4-c623a4e24281)\n\n---\n\n[下载](#download) | [快速入门](#quick-start) | [文档](#documentation) | [贡献](#contributing) | [社区](#community)\n\n---\n\n## 下载\n\n| 平台 | 下载 | 架构 |\n|---|---|---|\n| macOS | [Apple Silicon (.dmg)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Flatest) · [Intel (.dmg)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Flatest) | arm64 \u002F x64 |\n| Windows | [安装程序 (.exe)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Flatest) | x64 + arm64 |\n| Linux | [AppImage](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Flatest) · [.deb](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Flatest) · [.rpm](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Flatest) | x64 + arm64 |\n\n或访问 [发布页面](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases) 获取所有版本。\n\n---\n\n## 为什么选择 CodePilot\n\n### 多提供商，统一界面\n\n开箱即用即可连接 **17+ 家 AI 提供商**。在对话过程中无需丢失上下文即可切换提供商和模型。\n\n| 类别 | 提供商 |\n|---|---|\n| 直接 API | Anthropic, OpenRouter |\n| 云平台 | AWS Bedrock, Google Vertex AI |\n| 中国 AI 提供商 | Zhipu GLM (CN\u002FGlobal), Kimi, Moonshot, MiniMax (CN\u002FGlobal), Volcengine Ark (Doubao), Xiaomi MiMo, Aliyun Bailian (Qwen) |\n| 本地及自托管 | Ollama, LiteLLM |\n| 自定义 | 任何兼容 Anthropic 或 OpenAI 的接口 |\n| 媒体 | Google Gemini (图像生成) |\n\n### 不止于编码 — 全功能 AI 助手\n\nCodePilot 最初是一款编码工具，如今已发展为一款 **通用型 AI 助手桌面应用**：\n\n- **助理工作区** — 包括角色文件、持久化记忆、引导流程和每日问候。您的助手会不断学习您的偏好并逐步适应。\n- **生成式 UI** — AI 可以创建交互式仪表盘、图表和可视化小部件，并在应用内实时渲染。\n- **远程桥接** — 连接 Telegram、飞书、Discord、QQ 和微信。您可以在手机上发送消息，在桌面端接收回复。\n- **MCP + 技能** — 添加 MCP 服务器（stdio \u002F sse \u002F http），并进行运行时监控。您可以定义可重用的技能，或从 skills.sh 市场安装。\n- **媒体工作室** — AI 图像生成支持批量任务、图库和标签管理。\n- **任务调度器** — 使用 cron 表达式或间隔时间安排定期任务。\n\n### 专为日常使用打造\n\n- 暂停、恢复，并 **将会话回退到任意检查点**\n- **分屏** 同时开启两个会话\n- 通过每日图表跟踪 **token 使用情况和费用**\n- 导入 Claude Code CLI 会话历史\n- 暗色 \u002F 浅色主题切换\n- 英文 + 中文界面\n\n---\n\n## 快速入门\n\n### 路径 A：下载发行版（大多数用户）\n\n1. 从上方的 [下载](#download) 部分下载适合您平台的安装程序\n2. 启动 CodePilot\n3. 在 **设置 > 提供商** 中 **配置提供商** — 添加您支持的任何提供商的 API 密钥\n4. 开始对话\n\n> **注意：** 安装 [Claude Code CLI](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Foverview) (`npm install -g @anthropic-ai\u002Fclaude-code`) 可解锁更多功能，如直接编辑文件、执行终端命令和 Git 操作。虽然推荐使用，但并非基础聊天所必需。\n\n### 路径 B：从源码构建（开发者）\n\n| 前提条件 | 最低版本 |\n|---|---|\n| Node.js | 18+ |\n| npm | 9+（随 Node 18 一起提供） |\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot.git\ncd CodePilot\nnpm install\nnpm run dev              # 浏览器模式，地址为 http:\u002F\u002Flocalhost:3000\n# 或 --\nnpm run electron:dev     # 完整桌面应用\n```\n\n---\n\n## 核心功能\n\n### 对话与交互\n\n| 功能 | 详情 |\n|---|---|\n| 交互模式 | 代码 \u002F 计划 \u002F 询问 |\n| 推理强度 | 低 \u002F 中 \u002F 高 \u002F 极限 + 思考模式 |\n| 权限控制 | 默认 \u002F 完全访问权限，逐项批准 |\n| 会话控制 | 暂停、恢复、回退到检查点、归档 |\n| 模型切换 | 在对话中更换模型 |\n| 分屏 | 并排双会话 |\n| 附件 | 文件和图片，支持多模态视觉 |\n| 斜杠命令 | \u002Fhelp \u002Fclear \u002Fcost \u002Fcompact \u002Fdoctor \u002Freview 等等 |\n\n### 扩展与集成\n\n| 功能 | 详情 |\n|---|---|\n| 提供商 | 17+ 家提供商：Anthropic、OpenRouter、Bedrock、Vertex、Zhipu GLM、Kimi、Moonshot、MiniMax、Volcengine、MiMo、Bailian、Ollama、LiteLLM，以及自定义接口 |\n| MCP 服务器 | stdio \u002F sse \u002F http，运行时状态监控 |\n| 技能 | 自定义 \u002F 项目级 \u002F 全局技能，skills.sh 市场 |\n| 桥接 | Telegram \u002F 飞书 \u002F Discord \u002F QQ \u002F 微信 远程控制 |\n| CLI 导入 | 导入 Claude Code CLI .jsonl 会话历史 |\n| 图像生成 | Gemini 图像生成，支持批量任务和图库 |\n\n### 数据与工作区\n\n| 功能 | 详情 |\n|---|---|\n| 助理工作区 | 角色文件（soul.md、user.md、claude.md、memory.md）、引导流程、每日问候、持久化记忆 |\n| 生成式 UI | AI 创建的交互式仪表盘和可视化小部件 |\n| 文件浏览器 | 项目文件树，支持语法高亮预览 |\n| Git 面板 | 状态、分支、提交和工作树管理 |\n| 使用分析 | token 统计、费用估算、每日使用图表 |\n| 任务调度器 | 基于 cron 和间隔时间的任务调度，具有持久性 |\n| 本地存储 | SQLite（WAL 模式），所有数据均保存在您的设备上 |\n| i18n | 英文 + 中文 |\n| 主题 | 暗色 \u002F 浅色，一键切换 |\n\n---\n\n## 首次启动\n\n1. **配置提供商** — 前往 **设置 > 提供商**，添加您想要使用的提供商的凭据。CodePilot 为所有主流提供商提供了预设选项——只需选择一个并输入您的 API 密钥。\n2. **创建对话** — 选择一个工作目录，选定模式（代码 \u002F 计划 \u002F 提问），并选择一个模型。\n3. **设置助理工作区**（可选）— 前往 **设置 > 助理**，选择一个工作区目录，并启用引导流程。CodePilot 会在工作区根目录下创建 `soul.md`、`user.md`、`claude.md` 和 `memory.md` 文件。\n4. **添加 MCP 服务器**（可选）— 前往侧边栏中的 **MCP** 页面，以添加和管理 MCP 服务器。自定义技能则在单独的 **技能** 页面进行管理。\n5. **安装 Claude Code CLI**（可选）— 若要使用文件编辑和终端命令等高级功能，请安装 CLI：`npm install -g @anthropic-ai\u002Fclaude-code`\n\n---\n\n## 平台与安装说明\n\nmacOS 版本已使用开发者 ID 证书进行代码签名，但尚未经过公证，因此首次启动时 Gatekeeper 可能仍会弹出提示。Windows 和 Linux 版本则未签名。\n\n\u003Cdetails>\n\u003Csummary>macOS：首次启动时 Gatekeeper 警告\u003C\u002Fsummary>\n\n**选项 1** -- 在 Finder 中右键点击 `CodePilot.app` > 打开 > 确认。\n\n**选项 2** -- 系统设置 > 隐私与安全性 > 滚动至“安全性”部分 > 点击“仍要打开”。\n\n**选项 3** -- 在终端中运行：\n```bash\nxattr -cr \u002FApplications\u002FCodePilot.app\n```\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>Windows：SmartScreen 阻止安装程序\u003C\u002Fsummary>\n\n**选项 1** -- 在 SmartScreen 对话框中点击“更多信息”，然后选择“仍要运行”。\n\n**选项 2** -- 设置 > 应用程序 > 高级应用设置 > 将“应用安装控制”设置为允许来自任何来源的应用。\n\u003C\u002Fdetails>\n\n---\n\n## 文档\n\n📖 **完整文档：** [英文](https:\u002F\u002Fwww.codepilot.sh\u002Fdocs) | [中文](https:\u002F\u002Fwww.codepilot.sh\u002Fzh\u002Fdocs)\n\n**入门指南：**\n- [快速入门](#quick-start) -- 下载或从源码构建\n- [首次启动](#first-launch) -- 提供商设置、工作区配置\n- [安装指南](https:\u002F\u002Fwww.codepilot.sh\u002Fdocs\u002Finstallation) -- 详细设置说明\n\n**用户指南：**\n- [提供商](https:\u002F\u002Fwww.codepilot.sh\u002Fdocs\u002Fproviders) -- 配置 AI 提供商和自定义端点\n- [MCP 服务器](https:\u002F\u002Fwww.codepilot.sh\u002Fdocs\u002Fmcp) -- 添加和管理模型上下文协议服务器\n- [技能](https:\u002F\u002Fwww.codepilot.sh\u002Fdocs\u002Fskills) -- 自定义技能、项目技能以及 skills.sh 市场\n- [桥接](https:\u002F\u002Fwww.codepilot.sh\u002Fdocs\u002Fbridge) -- 通过 Telegram、飞书、Discord、QQ、微信进行远程控制\n- [助理工作区](https:\u002F\u002Fwww.codepilot.sh\u002Fdocs\u002Fassistant-workspace) -- 角色文件、引导流程、记忆、每日签到\n- [常见问题解答](https:\u002F\u002Fwww.codepilot.sh\u002Fdocs\u002Ffaq) -- 常见问题及解决方案\n\n**开发者文档：**\n- [ARCHITECTURE.md](.\u002FARCHITECTURE.md) -- 架构、技术栈、目录结构、数据流\n- [docs\u002Fhandover\u002F](.\u002Fdocs\u002Fhandover\u002F) -- 设计决策与交接文档\n- [docs\u002Fexec-plans\u002F](.\u002Fdocs\u002Fexec-plans\u002F) -- 执行计划与技术债务跟踪器\n\n---\n\n## 常见问题解答\n\n\u003Cdetails>\n\u003Csummary>我需要 Claude Code CLI 吗？\u003C\u002Fsummary>\n\n不需要。您可以使用 CodePilot 与任何支持的提供商（OpenRouter、智谱 GLM、火山引擎、Ollama 等）配合使用，而无需 Claude Code CLI。只有当您希望 Claude 直接编辑文件、运行终端命令或在您的机器上执行 Git 操作时，才需要 CLI。对于聊天和助理功能，只需配置一个提供商并开始对话即可。\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>已配置提供商但未显示任何模型\u003C\u002Fsummary>\n\n请确认 API 密钥有效且端点可访问。某些提供商（如 Bedrock、Vertex）除了 API 密钥之外，还需要额外的环境变量或 IAM 配置。您可以使用内置诊断工具（**设置 > 提供商 > 运行诊断**）来检查连接情况。\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>`npm run dev` 和 `npm run electron:dev` 有何区别？\u003C\u002Fsummary>\n\n`npm run dev` 仅启动 Next.js 开发服务器——您可以在浏览器中通过 `http:\u002F\u002Flocalhost:3000` 使用 CodePilot。而 `npm run electron:dev` 则同时启动 Next.js 和 Electron 宿主进程，为您提供完整的桌面应用体验，包括原生窗口控件。\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>助理工作区文件位于何处？\u003C\u002Fsummary>\n\n当您设置工作区时，CodePilot 会在 **工作区根目录** 下创建四个 Markdown 文件：`soul.md`（个性）、`user.md`（用户简介）、`claude.md`（规则）以及 `memory.md`（长期笔记）。状态跟踪信息（引导进度、签到日期）则存储在 `.assistant\u002F` 子目录中。每日记忆则保存在 `memory\u002Fdaily\u002F` 目录下。\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>桥接功能需要针对每个平台进行额外设置\u003C\u002Fsummary>\n\n每个桥接渠道（Telegram、飞书、Discord、QQ、微信）都需要各自的机器人令牌或应用凭证。请前往侧边栏中的 **桥接** 页面来配置各个渠道。您需要先在目标平台上创建一个机器人，并将令牌提供给 CodePilot。\n\u003C\u002Fdetails>\n\n---\n\n## 社区\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fop7418_CodePilot_readme_c63e460b4c69.png\" width=\"240\" alt=\"WeChat Group QR Code\" \u002F>\n\n扫描二维码加入 WeChat 用户群，参与讨论、反馈和最新动态。\n\n- [GitHub Issues](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Fissues) -- Bug 报告和功能请求\n- [GitHub Discussions](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Fdiscussions) -- 问题解答和一般讨论\n\n---\n\n## 贡献\n\n1. 分支仓库并创建功能分支\n2. 使用 `npm install` 和 `npm run electron:dev` 进行本地开发\n3. 在提交 PR 之前运行 `npm run test`\n4. 向 `main` 分支提交带有清晰描述的 PR\n\n请确保每次 PR 只包含一个功能或修复。\n\n\u003Cdetails>\n\u003Csummary>开发命令\u003C\u002Fsummary>\n\n```bash\nnpm run dev                    # Next.js 开发服务器（浏览器）\nnpm run electron:dev           # 完整 Electron 应用（开发模式）\nnpm run build                  # 生产构建\nnpm run electron:build         # 构建 Electron 发行版\nnpm run electron:pack:mac      # macOS DMG（arm64 + x64）\nnpm run electron:pack:win      # Windows NSIS 安装程序\nnpm run electron:pack:linux    # Linux AppImage、deb、rpm\n```\n\n**CI\u002FCD：** 推送 `v*` 标签会触发全平台构建，并自动创建 GitHub Release。\n\n**注意事项：**\n- Electron 会在 `127.0.0.1` 上以随机空闲端口 fork 一个 Next.js 独立服务器\n- 聊天数据存储在 `~\u002F.codepilot\u002Fcodepilot.db` 中（开发模式：`.\u002Fdata\u002F`）\n- SQLite 使用 WAL 模式以实现快速并发读取\n\u003C\u002Fdetails>\n\n---\n\n## 许可证\n\n[商业源代码许可证 1.1 (BSL-1.1)](LICENSE)\n\n- **个人 \u002F 学术 \u002F 非营利用途**：免费且无限制\n- **商业用途**：需另行授权 — 请联系 [@op7418 on X](https:\u002F\u002Fx.com\u002Fop7418)\n- **变更日期**：2029-03-16 — 此后代码将转为 Apache 2.0 许可证","# CodePilot 快速上手指南\n\nCodePilot 是一款支持多模型接入的 AI 智能体桌面客户端。它允许你连接任意 AI 提供商，通过 MCP 协议扩展能力，并支持手机远程控制，让助手逐步学习你的工作流。\n\n## 环境准备\n\n### 系统要求\nCodePilot 支持以下主流操作系统：\n- **macOS**: Apple Silicon (arm64) 或 Intel (x64)\n- **Windows**: x64 或 arm64\n- **Linux**: x64 或 arm64 (支持 AppImage, .deb, .rpm)\n\n### 前置依赖（仅针对源码构建）\n如果你选择下载安装包使用，无需安装额外依赖。若需从源码构建或开发，请确保安装以下工具：\n- **Node.js**: 18+ 版本\n- **npm**: 9+ 版本（通常随 Node.js 自动安装）\n\n> **可选增强**：安装 Claude Code CLI 可解锁直接文件编辑、终端命令执行及 Git 操作等高级功能（非必需）：\n> ```bash\n> npm install -g @anthropic-ai\u002Fclaude-code\n> ```\n\n## 安装步骤\n\n### 方式一：下载预编译包（推荐大多数用户）\n\n1. 访问 [Releases 页面](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Flatest)。\n2. 根据你的操作系统下载对应的安装包：\n   - **macOS**: 下载 `.dmg` 文件（区分 Apple Silicon 或 Intel）。\n   - **Windows**: 下载 `.exe` 安装程序。\n   - **Linux**: 下载 `.deb` (Debian\u002FUbuntu), `.rpm` (Fedora\u002FCentOS) 或 `AppImage`。\n3. 运行安装程序并按照提示完成安装。\n\n> **macOS 用户注意**：若首次启动遇到\"无法打开”提示，请在“系统设置”>“隐私与安全性”中点击“仍要打开”，或在终端运行 `xattr -cr \u002FApplications\u002FCodePilot.app`。\n\n### 方式二：源码构建（开发者）\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot.git\ncd CodePilot\nnpm install\n\n# 模式 A: 浏览器开发模式\nnpm run dev\n\n# 模式 B: 完整桌面应用开发模式\nnpm run electron:dev\n```\n\n## 基本使用\n\n### 1. 配置 AI 提供商\n启动 CodePilot 后，首先需要配置模型来源：\n- 进入 **Settings (设置)** > **Providers (提供商)**。\n- 选择你拥有的服务商（如 Zhipu GLM, Moonshot, OpenRouter, Ollama 等）。\n- 填入对应的 **API Key**。CodePilot 内置了国内主流大模型（智谱、月之暗面、MiniMax 等）的预设配置。\n\n### 2. 开始对话\n- 点击主界面新建会话。\n- **选择工作目录**：指定代码项目所在的文件夹。\n- **选择模式**：根据需求切换 `Code` (编码), `Plan` (规划), 或 `Ask` (问答) 模式。\n- **选择模型**：从已配置的提供商中选择具体模型。\n- 输入指令即可开始与 AI 协作。\n\n### 3. 进阶功能（可选）\n- **助手工作区**：在 **Settings > Assistant** 中启用 Onboarding，系统将生成 `soul.md`, `user.md` 等文件，让 AI 记忆你的偏好。\n- **MCP 扩展**：在侧边栏 **MCP** 页面添加服务器，扩展 AI 的工具调用能力。\n- **远程桥接**：配置 **Bridge** 页面，绑定 Telegram、飞书或微信，实现手机端发送消息、桌面端接收回复。","资深全栈开发者李明正在同时维护一个涉及国内大模型（如 Kimi）和国际模型（如 Claude）的复杂项目，并需要随时通过手机处理紧急的代码审查任务。\n\n### 没有 CodePilot 时\n- **多平台切换繁琐**：需要在浏览器、不同厂商的网页控制台和本地终端之间反复跳转，无法在同一个界面无缝切换国内外模型，导致上下文频繁中断。\n- **移动端协作断层**：收到钉钉或微信的紧急代码修改需求时，无法直接在手机上调用桌面端的专业开发环境，只能口头描述或回家后再处理。\n- **工作流缺乏记忆**：每次开启新对话都要重新输入项目背景和个人编码规范，AI 无法长期记住李明的偏好，重复沟通成本极高。\n- **功能扩展受限**：想要让 AI 执行本地脚本或连接自定义数据库时，配置复杂的 MCP 服务需要大量手动编写胶水代码，门槛高且易出错。\n\n### 使用 CodePilot 后\n- **统一聚合操作台**：在一个客户端内直接连接 Kimi、Claude 等 17+ 家服务商，对话中可随时无感切换模型，完整保留上下文，思维流不再被打断。\n- **手机远程遥控**：通过 Remote Bridge 功能将微信\u002F飞书与桌面端打通，李明在通勤路上用手机发送指令，CodePilot 即在桌面自动执行代码重构并返回结果。\n- **智能助理进化**：利用 Persona 文件和持久化记忆功能，CodePilot 主动学习李明的代码风格，每日自动检查项目状态并按其习惯生成日报，越用越懂他。\n- **低代码能力扩展**：直接从技能市场安装现成的 MCP 插件，无需编写额外代码即可让 AI 安全地读取本地日志或监控服务器状态，极大降低了自动化门槛。\n\nCodePilot 将分散的 AI 工具整合为具备长期记忆和跨端控制能力的超级代理，让开发者从繁琐的配置中解放，专注于核心创造。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fop7418_CodePilot_f5d3ca6a.png","op7418","歸藏","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fop7418_4adb5854.jpg","产品设计师🎨\r\nAI画图工具操作员🔧\r\nAI课程撰写与信息收集整理📰\r\n致力于发掘借助AI工具改善设计与产品开发流程的各种可能性🤔",null,"beijing","https:\u002F\u002Fgithub.com\u002Fop7418",[81,85,88,92],{"name":82,"color":83,"percentage":84},"TypeScript","#3178c6",96.2,{"name":86,"color":87,"percentage":10},"MDX","#fcb32c",{"name":89,"color":90,"percentage":91},"JavaScript","#f1e05a",0.5,{"name":93,"color":94,"percentage":95},"CSS","#663399",0.4,5247,560,"2026-04-14T17:45:26","NOASSERTION",1,"Linux, macOS, Windows","未说明",{"notes":104,"python":102,"dependencies":105},"该工具为桌面客户端应用，主要依赖 Node.js 环境运行。可选安装 Claude Code CLI (@anthropic-ai\u002Fclaude-code) 以解锁文件编辑、终端命令和 Git 操作等高级功能。本地数据存储使用 SQLite (WAL 模式)。macOS 首次启动可能需处理 Gatekeeper 警告，Windows 可能需处理 SmartScreen 拦截。",[106,107],"Node.js 18+","npm 9+",[15,13,14],[110,111,112,113,114,115,116,117],"ai","anthropic","claude","claude-code","desktop-app","electron","gui","nextjs","2026-03-27T02:49:30.150509","2026-04-15T10:58:43.068298",[121,126,131,136,141,146,151],{"id":122,"question_zh":123,"answer_zh":124,"source_url":125},34251,"在 Windows 上遇到 \"Error: spawn EINVAL\" 错误怎么办？","该问题通常由环境变量中包含非法字符或 undefined 值引起，已在多个版本中修复。请执行以下步骤：\n1. 将 CodePilot 更新到最新版本 **v0.10.11**（包含 commit `83a0109`, `c0e96bd`, `01e7e0c` 的修复）。\n2. 更新后，如果是第三方 API 用户，建议删除并重新配置 API Provider。\n3. 确保 Claude Code CLI 已正确安装且在系统 PATH 中（终端运行 `claude --version` 确认）。\n这些修复包括清理环境变量、过滤未定义值以及正确解析 Windows .cmd wrapper 路径。","https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Fissues\u002F64",{"id":127,"question_zh":128,"answer_zh":129,"source_url":130},34252,"配置了智谱 (Zhipu) 或其他第三方 API，但聊天时仍显示连接到 Claude 模型或提示 \"Disconnected\"？","这通常是由于旧版本中 `extra_env` 空值覆盖环境变量或 Windows 下执行器路径解析错误导致的。解决方案如下：\n1. **升级软件**：务必更新到 **v0.10.11** 或更高版本。\n2. **重置配置**：在设置中删除现有的第三方 API Provider，然后重新添加。\n3. **检查执行器**：确保终端中可以正常运行 `claude` 命令。Windows 用户需确认 Claude Code 已加入 PATH。\n4. **配置渠道**：添加第三方 API 时，请选择 \"Anthropic\" 渠道，然后通过设置页面的 API 按钮进行配置。\n如果问题依旧，请检查开发者工具中的错误日志。","https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Fissues\u002F65",{"id":132,"question_zh":133,"answer_zh":134,"source_url":135},34253,"提示 \"Claude Code executable not found\" 错误如何解决？","此错误表示软件无法找到 Claude Code CLI 的可执行文件，常见于 Windows 环境。请按以下步骤排查：\n1. **验证安装**：在终端（CMD 或 PowerShell）中运行 `claude --version`，确认 CLI 已安装且可用。\n2. **检查 PATH**：确保 Claude Code 的安装目录已添加到系统环境变量 PATH 中。\n3. **更新版本**：升级到 **v0.10.11**，该版本修复了 Windows 下 `.cmd` 包装器的路径解析问题（commit `01e7e0c`），不再需要手动配置复杂的路径。\n4. **重新配置**：更新后，在设置中重新添加 API Provider 以刷新配置。","https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Fissues\u002F59",{"id":137,"question_zh":138,"answer_zh":139,"source_url":140},34254,"编辑第三方 API 配置后，API Key 无法保存导致连接失败？","这是一个已知的问题，在某些版本（如 0.47.0 - 0.48.0）中，编辑现有配置时 API Key 可能未被正确持久化。临时解决方案包括：\n1. **降级版本**：部分用户反馈降级到 **v0.46** 版本可以正常保存和加载 API Key。\n2. **重建配置**：尝试删除当前的 API 配置，重新创建一个新的配置项而不是编辑旧的。\n3. **等待修复**：关注后续版本更新，维护者正在处理相关的大动作更新以稳定此功能。","https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Fissues\u002F449",{"id":142,"question_zh":143,"answer_zh":144,"source_url":145},34255,"CodePilot 声称是 \"原生 (Native)\" 应用，但它基于 Electron，这是否矛盾？","这里的 \"原生 (Native)\" 指的是 \"原生桌面应用程序 (Native Desktop App)\"，而非指使用 C++ 或 Swift 等原生语言编写。具体含义如下：\n- 它是一个独立的可安装应用程序，拥有自己的窗口、标题栏和本地文件系统访问权限。\n- 它与仅在浏览器中运行的 Web 应用不同，提供了更紧密的操作系统集成体验。\n虽然其技术栈基于 Next.js 和 Electron（与 VS Code 类似），但在用户体验和功能定位上被视为原生桌面应用。","https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Fissues\u002F74",{"id":147,"question_zh":148,"answer_zh":149,"source_url":150},34256,"如何获取 Windows 版本的安装包？","Windows 版本已通过 GitHub Actions CI 实现自动打包。获取方式如下：\n1. 访问项目的 **GitHub Releases** 页面。\n2. 下载最新版本的 `.exe` 安装包（NSIS 格式）。\n每次发布新版本时，系统会自动构建并上传 Windows 安装包，无需手动编译或使用虚拟机。","https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Fissues\u002F31",{"id":152,"question_zh":153,"answer_zh":154,"source_url":155},34257,"项目是否有飞书 (Feishu) 或 Discord 的集成支持？","是的，飞书和 Discord 的桥接功能已经在开发计划或早期支持中。用户在配置时需注意：\n- 在设置中选择相应的渠道进行配置。\n- 如果测试连接成功但机器人状态显示异常（如小绿点是黑的），请检查机器人权限设置或 Token 配置是否正确。\n具体配置细节建议参考最新的 README 文档或社区讨论。","https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Fissues\u002F134",[157,162,167,172,177,182,187,192,197,202,207,212,217,222,227,232,237,242,247,252],{"id":158,"version":159,"summary_zh":160,"released_at":161},264110,"v0.50.1","## CodePilot v0.50.1\n\n> 飞书一键创建机器人 + SubAgent UI 可视化 + 消息队列模式 + 桥接稳定性大修 — 推荐所有飞书桥接用户升级。v0.50.0 因 CI lint 规则未通过构建未发布，v0.50.1 修复后重新发版。\n\n### 新增功能\n\n- **飞书一键创建机器人**：设置 → 飞书设置 → \"创建并绑定飞书应用\"，浏览器自动打开飞书授权页面，确认后 Bot 能力、权限、事件订阅和长连接模式全部自动配置，无需再手动进飞书开放平台后台\n- **SubAgent 执行过程可视化**：Agent 调用子代理（explore \u002F general）时，工具面板会显示闪电图标和子代理的嵌套工具调用进度（带 spinner \u002F 完成 \u002F 失败状态指示）\n- **输入框草稿持久化**：在一个聊天中打了字还没发送，切换到别的聊天再切回来，输入内容仍然保留（按会话分别保存）\n- **消息队列模式**：AI 正在响应时继续输入并回车，消息会显示在输入框上方的队列卡片里，AI 回复完成后自动发送。支持取消队列中的消息，参考 Codex 设计\n- **飞书 AskUserQuestion 交互卡片**：Agent 在飞书桥接中使用 AskUserQuestion 时，现在会渲染为带选项按钮的交互卡片（之前直接被拒绝），点击选项即可继续对话\n- **飞书资源消息支持**：飞书桥接现在可以接收图片、文件、音频、视频消息，自动下载并附加到对话上下文（带重试和 20MB 大小限制）\n\n### 修复问题\n\n- **飞书群聊 @mention 过滤失效**（#384）：设置\"需要 @提及\"开关后，机器人真的会在群里只响应 @Bot 的消息\n- **飞书话题群串 session**（#321）：未开启\"话题会话\"时，不同话题消息不再被错误地路由到独立会话\n- **飞书桥接鉴权配置失效**：dmPolicy \u002F groupPolicy \u002F allowFrom \u002F groupAllowFrom 配置现在真的会拦截未授权用户的消息和卡片点击（之前是配置存在但从未生效）\n- **飞书 WebSocket 幽灵连接**：停止桥接或重绑应用时，旧的长连接现在会被正确关闭，不再出现重复消息投递\n- **桥接停止不中断任务**：点击\"停止桥接\"后，正在运行的 Claude 会话会立刻被打断，不再继续写数据库\n- **历史回放二进制附件乱码**：音频、视频、二进制文件在历史对话重放时不再被当成 UTF-8 文本注入上下文\n- **消息投递可靠性**（#266）：飞书 outbound 消息加了指数退避重试，瞬时网络故障不再导致消息丢失\n- **SubAgent 启动后后续消息排队**：在 AI 执行子代理期间继续发消息不会阻塞，会进入队列等待当前轮次完成\n\n### 优化改进\n\n- 队列中的消息以卡片形式悬浮在输入框上方（参考 Codex），可随时取消，不再混在聊天流里造成\"两条用户消息一条没回复\"的视觉错觉\n- Streaming 中输入时按钮图标智能切换：空输入 → 终止图标，有内容 → 发送图标（只对纯文本有效；slash 命令 \u002F badge \u002F Image Agent 保持终止图标避免误导）\n- 飞书快速创建支持已有应用场景：点击\"已有飞书应用？点击手动配置\"可展开原有的 App ID \u002F App Secret 手动录入表单\n- 飞书多 question \u002F multi-select 的 AskUserQuestion 会被明确拒绝并附带清晰原因，不再静默截断成半截答案\n- 飞书 bot identity 启动失败后会每 60s 后台重试，不再永久 fail-open（#384 的边界情况）\n\n## 下载地址\n\n### macOS\n- [Apple Silicon (M1\u002FM2\u002FM3\u002FM4)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.50.1\u002FCodePilot-0.50.1-arm64.dmg)\n- [Intel](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.50.1\u002FCodePilot-0.50.1-x64.dmg)\n\n### Windows\n- [Windows 安装包](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.50.1\u002FCodePilot.Setup.0.50.1.exe)\n\n## 安装说明\n\n**macOS**: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示，在系统设置 > 隐私与安全中点击\"仍要打开\"\n**Windows**: 下载 exe 安装包 → 双击安装\n\n## 系统要求\n\n- macOS 12.0+ \u002F Windows 10+ \u002F Linux (glibc 2.31+)\n- 需要配置 API 服务商（Anthropic \u002F OpenRouter \u002F OpenAI 等）\n- 可选安装 Claude Code CLI 以获得完整命令行能力\n","2026-04-14T17:53:53",{"id":163,"version":164,"summary_zh":165,"released_at":166},264111,"v0.49.0","## CodePilot v0.49.0\n\n> Agent 运行时能力大幅升级 — 借鉴 Hermes Agent 框架的 6 项核心能力 + 12 项额外改进。Native Runtime 用户将获得更智能的工具调度、更低的 API 成本、跨会话记忆，以及全新的交互式提问和 Skill 建议功能。\n\n### 新增功能\n\n- **历史会话搜索**：Agent 现在可以搜索所有历史对话的内容。当你说\"上次我们讨论 X 的结论是什么\"时，它能自动检索并引用之前的对话，不再需要手动翻找和复制\n- **Skill 自动保存建议**：当 Agent 完成一个复杂多步工作流（8+ 步骤、3+ 种工具）后，会在对话区底部弹出持久提示条，建议你把这个流程保存为可复用的 Skill。点击\"保存为 Skill\"按钮可一键启动保存流程\n- **结构化提问（AskUserQuestion）**：Agent 现在可以向你提出结构化的多选题，而不只是文字提问。当需要你在多个方案之间做选择时，会弹出带选项按钮的交互卡片，所有问题必须回答完整才能提交\n- **辅助模型自动路由**：上下文压缩、摘要等辅助任务现在会自动使用你配置中的小模型（如 Haiku），不再消耗主模型的额度。支持 5 级智能降级，即使主服务商不可用也能自动切换到备用服务商\n- **上下文压缩通知**：长对话触发自动压缩时，状态栏会显示\"已压缩 N 条消息，节省约 X tokens\"的提示，持续 5 秒，让你知道发生了什么\n\n### 优化改进\n\n- 辅助模型路由现在正确识别当前会话的服务商，不再错误使用全局默认服务商的凭证进行压缩\n- Bridge\u002FIM 场景下 AskUserQuestion 会被明确拒绝并提示模型改用文字提问，而不是静默返回空答案\n- 权限系统新增\"总是需要交互\"工具类别，AskUserQuestion 和 ExitPlanMode 即使在信任模式下也会弹出 UI\n- permission-registry 的超时计时器添加了 unref()，不再阻止应用优雅退出\n- 上下文压缩器 shouldAutoCompact 标记为 @deprecated，指向真正在用的 needsCompression\n\n### 基础设施（开发者相关）\n\n- 并行安全调度模块（parallel-safety.ts）：4 层判定算法已就绪，等待 AI SDK 提供 batch 级 hook 后接入\n- 渐进式子目录发现模块（subdirectory-hint-tracker.ts）：AGENTS.md\u002FCLAUDE.md 懒加载已就绪，等待 agent-tools.ts 集成\n- Token 预算裁剪模块（pruneOldToolResultsByBudget）：可选的增强裁剪策略已就绪\n- 新增 ~90 个单元测试，覆盖所有新模块\n\n## 下载地址\n\n### macOS\n- [Apple Silicon (M1\u002FM2\u002FM3\u002FM4)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.49.0\u002FCodePilot-0.49.0-arm64.dmg)\n- [Intel](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.49.0\u002FCodePilot-0.49.0-x64.dmg)\n\n### Windows\n- [Windows 安装包](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.49.0\u002FCodePilot.Setup.0.49.0.exe)\n\n## 安装说明\n\n**macOS**: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示，在系统设置 > 隐私与安全中点击\"仍要打开\"\n**Windows**: 下载 exe 安装包 → 双击安装\n\n## 系统要求\n\n- macOS 12.0+ \u002F Windows 10+ \u002F Linux (glibc 2.31+)\n- 需要配置 API 服务商（Anthropic \u002F OpenRouter \u002F OpenAI 等）\n- 可选安装 Claude Code CLI 以获得完整命令行能力\n","2026-04-12T11:09:20",{"id":168,"version":169,"summary_zh":170,"released_at":171},264112,"v0.48.2","## CodePilot v0.48.2\n\n> v0.48 系列稳定性修复版 — 主要修复了第三方服务商配置和对话管理的几个关键问题，建议所有 v0.48.x 用户升级。\n\n### 修复问题\n\n- **第三方服务商设为默认后无法使用**：设置阿里云百炼、智谱、OpenRouter 等第三方服务商为默认后，新对话首条消息报 \"No provider credentials available\" 或进程崩溃的问题。根因是 UI 上的\"当前选中\"标记被错误地当作\"启用\u002F禁用\"过滤，导致用户明确设置的默认服务商被忽略\n- **编辑第三方服务商后测试连接失败**：之前前端会把编辑对话框里显示的遮罩密钥（`***xxx`）原样发送给服务器做测试，导致一律 401。现在未改动时后端自动从数据库读取真实密钥\n- **重命名对话点了没反应**：macOS \u002F Windows 上点击左侧会话列表三点菜单 → 重命名对话后，输入框无法打开的问题（Electron 禁用了 window.prompt）\n- **诊断页面的误导性警告**：Claude Code 诊断日志中出现的 \"Provider is inactive, re-resolving\" 警告实际上是代码逻辑 bug，会让用户误以为配置有问题。已清除\n- **切换认证方式后测试使用旧凭证**：服务商编辑对话框切换 API Key \u002F Auth Token 时的状态迁移不一致，可能导致测试连接使用错误凭证\n\n### 新增功能\n\n- **编辑时可以直接测试连接**：编辑已有服务商时，未改动 API Key 也能直接点\"测试连接\"，自动使用已保存的密钥。之前这种场景按钮是禁用的，用户必须重新输入一遍密钥才能测\n- **主动清除已存 API Key**：服务商编辑对话框新增\"清除已存密钥\"按钮，支持撤销。之前一旦保存就无法删除已存密钥，只能重新输入新值覆盖\n\n### 优化改进\n\n- 会话重命名改用应用内对话框，支持 Enter 提交、Esc 取消、打开时自动全选原标题方便直接替换\n- 测试连接按钮状态对齐完整的密钥生命周期：无密钥禁用、保留原密钥可测、标记清除后禁用（避免测试旧密钥却保存新状态的误导性成功）\n- 服务商编辑对话框的 API Key 输入框在编辑态显示\"已保存，留空则沿用原密钥\"提示，不再泄露遮罩字符串\n\n## 下载地址\n\n### macOS\n- [Apple Silicon (M1\u002FM2\u002FM3\u002FM4)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.48.2\u002FCodePilot-0.48.2-arm64.dmg)\n- [Intel](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.48.2\u002FCodePilot-0.48.2-x64.dmg)\n\n### Windows\n- [Windows 安装包](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.48.2\u002FCodePilot.Setup.0.48.2.exe)\n\n## 安装说明\n\n**macOS**: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示，在系统设置 > 隐私与安全中点击\"仍要打开\"\n**Windows**: 下载 exe 安装包 → 双击安装\n\n## 系统要求\n\n- macOS 12.0+ \u002F Windows 10+ \u002F Linux (glibc 2.31+)\n- 需要配置 API 服务商（Anthropic \u002F OpenRouter \u002F OpenAI 等）\n- 可选安装 Claude Code CLI 以获得完整命令行能力\n","2026-04-11T05:23:21",{"id":173,"version":174,"summary_zh":175,"released_at":176},264113,"v0.48.1","## CodePilot v0.48.1\n\n> 为修复 v0.48.0 发布后出现的问题而推出的紧急版本，解决了 Runtime 选择、看板渲染、数据库约束等方面的问题。\n\n### 修复问题\n\n- 修复了仅配置第三方服务商（如智谱、Kimi）时，自动模式错误选择 Claude Code 引擎导致无法使用的问题\n- 修复了 Native 引擎下大量请求被误判为“空响应”的问题\n- 修复了看板面板中 Widget 样式丢失、内容被裁切的问题\n- 修复了删除会话时可能出现的数据库外键约束错误\n- 修复了 OpenAI Codex API 连接超时没有明确提示的问题，现在会建议配置代理\n- 修复了更新通知弹窗在每次启动时重复弹出的问题\n\n### 优化改进\n\n- Runtime 选择现在精确匹配请求使用的服务商凭据，不再被无关服务商干扰\n- 显式选择 Claude Code 引擎时始终尊重用户选择，不再因凭据检查误判\n- 服务商过期引用（如删除服务商后的残留绑定）现在正确回退到可用服务商\n\n## 下载地址\n\n### macOS\n- [Apple Silicon (M1\u002FM2\u002FM3\u002FM4)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.48.1\u002FCodePilot-0.48.1-arm64.dmg)\n- [Intel](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.48.1\u002FCodePilot-0.48.1-x64.dmg)\n\n### Windows\n- [Windows 安装包](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.48.1\u002FCodePilot.Setup.0.48.1.exe)\n\n## 安装说明\n\n**macOS**: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示，在系统设置 > 隐私与安全中点击“仍要打开”\n**Windows**: 下载 exe 安装包 → 双击安装\n\n## 系统要求\n\n- macOS 12.0+ \u002F Windows 10+ \u002F Linux (glibc 2.31+)\n- 需要配置 API 服务商（Anthropic \u002F OpenRouter \u002F OpenAI 等）\n- 可选安装 Claude Code CLI 以获得完整命令行能力","2026-04-10T16:36:46",{"id":178,"version":179,"summary_zh":180,"released_at":181},264114,"v0.48.0","## CodePilot v0.48.0\n\n> 全新 Agent 引擎架构：无需安装 Claude Code CLI 即可完整使用，同时支持 OpenAI 授权登录。\n\n### 新增功能\n\n- 双 Agent 引擎可选：AI SDK 引擎（开箱即用，支持多服务商）和 Claude Code 引擎（通过 CLI 驱动，完整命令行能力），可在设置中自由切换\n- OpenAI 授权登录：ChatGPT Plus\u002FPro 用户可在服务商设置中通过 OAuth 登录，直接使用 GPT-5.4、GPT-5.4-Mini、GPT-5.3-Codex 等模型\n- 输入框下方新增 Agent 引擎状态标记，显示当前实际使用的引擎，hover 可查看详情并跳转设置\n- 首次打开自动检测系统语言，中文系统自动切换为中文界面\n\n### 优化改进\n\n- 首次设置引导优化：Claude Code CLI 标记为\"可选\"，新用户无需安装 CLI 即可开始使用\n- 内置工具全量注册：通知、素材管理、仪表盘、记忆搜索、CLI 工具管理等 29 个工具始终可用，不再依赖关键词触发\n- 内置工具（codepilot_* 系列）跳过权限审批，减少不必要的确认弹窗\n- 系统提示词全面升级：参考 Claude Code 和 OpenCode 的提示词体系，提升代码生成质量\n- MCP 工具完整支持：外部 MCP 服务器的工具在 AI SDK 引擎下也能正常使用\n- 错误监控扩展：新增 Native 引擎专属错误类别和 Sentry 上报，便于问题定位\n\n### 修复问题\n\n- 修复了文件回退（Rewind）可能丢失会话前未提交修改的问题\n- 修复了中断对话在 Claude Code 引擎下不生效的问题\n- 修复了带附件消息在多轮对话中丢失的问题\n- 修复了 OpenAI OAuth 登录成功页在 token 交换失败时仍显示成功的问题\n- 修复了 OAuth callback 服务器监听所有网卡的安全问题，改为仅监听 localhost\n\n## 下载地址\n\n### macOS\n- [Apple Silicon (M1\u002FM2\u002FM3\u002FM4)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.48.0\u002FCodePilot-0.48.0-arm64.dmg)\n- [Intel](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.48.0\u002FCodePilot-0.48.0-x64.dmg)\n\n### Windows\n- [Windows 安装包](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.48.0\u002FCodePilot.Setup.0.48.0.exe)\n\n## 安装说明\n\n**macOS**: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示，在系统设置 > 隐私与安全中点击\"仍要打开\"\n**Windows**: 下载 exe 安装包 → 双击安装\n\n## 系统要求\n\n- macOS 12.0+ \u002F Windows 10+ \u002F Linux (glibc 2.31+)\n- 需要配置 API 服务商（Anthropic \u002F OpenRouter \u002F OpenAI 等）\n- 可选安装 Claude Code CLI 以获得完整命令行能力","2026-04-09T06:02:59",{"id":183,"version":184,"summary_zh":185,"released_at":186},264115,"v0.47.0","## CodePilot v0.47.0\n\n> 服务商系统全面治理，新增连接测试和匿名错误上报，品牌重定位为多模型 AI Agent 桌面客户端。\n\n### 新增功能\n\n- 服务商配置新增\"测试连接\"按钮：填完 API Key 后立即验证是否能连通，不用发消息才发现配置有误\n- 服务商配置新增引导面板：显示计费模式标签、API Key 获取链接、配置注意事项\n- 新增匿名错误上报（Sentry）：帮助开发者定位高频问题，默认开启，可在设置中关闭\n- 新增服务商模型管理 API：支持为每个服务商自定义添加\u002F删除模型\n- 新增小米 MiMo 服务商（按量付费 + Token Plan 两种模式）\n\n### 修复问题\n\n- 修复智谱 GLM、Moonshot、OpenRouter、百炼等 6 个服务商的认证方式配置错误，大幅减少首次连接失败\n- 修复用户终端 Claude Code 的 settings.json 配置覆盖 CodePilot 服务商选择的问题\n- 修复运行时报错缺少恢复操作建议的问题，现在会显示\"重新获取 Key\"等可点击链接\n- 修复模型选择下拉框出现横向滚动条的问题\n- 修复\"管理服务商\"按钮跳转到通用设置而非服务商页面的问题\n- 修复 Kimi 使用了错误的认证头（Bearer 而非 X-Api-Key）的问题\n\n### 优化改进\n\n- 品牌重定位：从\"Claude Code 桌面 GUI\"更新为\"多模型 AI Agent 桌面客户端\"\n- README 全面重构（中\u002F英\u002F日三语）：新增下载量和 Stars badges，下载区前置，17+ 服务商表格\n- 服务商系统新增 Zod Schema 校验：防止无效配置上线，新增 61 个自动化测试\n- 服务商配置页去除 230 行重复代码，统一为单一数据源\n- 官网服务商文档更新：修正国内服务商表格，新增各服务商注意事项\n- GitHub About 描述和联系方式更新\n\n## 下载地址\n\n### macOS\n- [Apple Silicon (M1\u002FM2\u002FM3\u002FM4)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.47.0\u002FCodePilot-0.47.0-arm64.dmg)\n- [Intel](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.47.0\u002FCodePilot-0.47.0-x64.dmg)\n\n### Windows\n- [Windows 安装包](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.47.0\u002FCodePilot.Setup.0.47.0.exe)\n\n## 安装说明\n\n**macOS**: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示，在系统设置 > 隐私与安全中点击\"仍要打开\"\n**Windows**: 下载 exe 安装包 → 双击安装\n\n## 系统要求\n\n- macOS 12.0+ \u002F Windows 10+ \u002F Linux (glibc 2.31+)\n- 需要配置 API 服务商（Anthropic \u002F OpenRouter \u002F 智谱 \u002F Kimi \u002F Ollama 等）\n- 推荐安装 Claude Code CLI 以获得完整功能","2026-04-04T16:42:12",{"id":188,"version":189,"summary_zh":190,"released_at":191},264116,"v0.46.0","## CodePilot v0.46.0\n\n> 新增 Ollama 本地模型支持，优化工具调用展示和推理内容（Thinking）的显示与保留。\n\n### 新增功能\n\n- 新增 Ollama 服务商预设：一键接入本地模型，无需 API 密钥\n- 新增推理内容（Thinking）流式展示：支持实时查看模型的推理过程\n- 工具调用展示全面重构：分组折叠、状态指示、运行中工具实时输出\n\n### 修复问题\n\n- 修复中断或出错时已展示的推理内容（Thinking）在完成态消失的问题\n- 修复远程桥接（Telegram\u002FDiscord\u002F飞书）静默丢弃推理内容的问题\n- 修复未注册工具（MCP 工具、插件工具等）在操作列表中不显示名称的问题\n- 修复 auth_token 认证方式未显式清空 API Key 导致部分服务商连接失败的问题\n\n### 优化改进\n\n- 服务商文档新增 Ollama 配置指南（中英双语）\n\n## 下载地址\n\n### macOS\n- [Apple Silicon (M1\u002FM2\u002FM3\u002FM4)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.46.0\u002FCodePilot-0.46.0-arm64.dmg)\n- [Intel](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.46.0\u002FCodePilot-0.46.0-x64.dmg)\n\n### Windows\n- [Windows 安装包](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.46.0\u002FCodePilot.Setup.0.46.0.exe)\n\n## 安装说明\n\n**macOS**: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示，在系统设置 > 隐私与安全中点击\"仍要打开\"\n**Windows**: 下载 exe 安装包 → 双击安装\n\n## 系统要求\n\n- macOS 12.0+ \u002F Windows 10+ \u002F Linux (glibc 2.31+)\n- 需要配置 API 服务商（Anthropic \u002F OpenRouter \u002F Ollama 等）\n- 推荐安装 Claude Code CLI 以获得完整功能\n","2026-04-03T16:19:21",{"id":193,"version":194,"summary_zh":195,"released_at":196},264117,"v0.45.1","## CodePilot v0.45.1\n\n> 新增默认侧边面板设置、小米 MiMo Token Plan 渠道，以及 Buddy 头像本地化等修复。\n\n### 新增功能\n\n- 新增「默认侧边面板」设置：可选择新对话时自动打开文件树、看板、Git 或不打开\n- 新增小米 MiMo Token Plan 服务商预设，支持订阅套餐方式使用\n\n### 修复问题\n\n- 修复 Buddy 头像在部分网络环境下无法加载的问题（图片改为本地打包）\n- 修复 Windows 安装包下载链接指向错误文件名的问题\n\n## 下载地址\n\n### macOS\n- [Apple Silicon (M1\u002FM2\u002FM3\u002FM4)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.45.1\u002FCodePilot-0.45.1-arm64.dmg)\n- [Intel](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.45.1\u002FCodePilot-0.45.1-x64.dmg)\n\n### Windows\n- [Windows 安装包](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.45.1\u002FCodePilot.Setup.0.45.1.exe)\n\n## 安装说明\n\n**macOS**: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示，在系统设置 > 隐私与安全中点击\"仍要打开\"\n**Windows**: 下载 exe 安装包 → 双击安装\n\n## 系统要求\n\n- macOS 12.0+ \u002F Windows 10+ \u002F Linux (glibc 2.31+)\n- 需要配置 API 服务商（Anthropic \u002F OpenRouter 等）\n- 推荐安装 Claude Code CLI 以获得完整功能\n","2026-04-03T07:53:59",{"id":198,"version":199,"summary_zh":200,"released_at":201},264118,"v0.45.0","## CodePilot v0.45.0\n\n> 内存优化专项：全面治理客户端内存占用，涵盖缓存淘汰、流式加载、懒加载、消息窗口化等多项改进。同时包含上下文管理系统和 CLI 升级能力。\n\n### 新增功能\n\n- 新增上下文管理系统：自动测量 token 用量、智能压缩长对话、改进的上下文回退策略\n- 新增 CLI 版本检测和一键升级功能，在设置页直接管理 Claude Code CLI\n- 新增系统代理自动透传，VPN\u002F代理用户无需手动配置即可正常使用\n\n### 优化改进\n\n- 代码高亮缓存（Shiki）加入 LRU 淘汰策略，不再随代码块种类无限增长\n- 侧边面板（文件预览、Git、文件树、看板、助理）改为按需加载，未打开时不占用内存\n- Markdown 渲染引擎及插件改为懒加载，仅在实际需要渲染时才加载\n- 终端输出加入 500KB 硬上限，长时间运行的命令不再无限累积内存\n- 聊天消息列表加入 300 条滑动窗口，超出部分自动卸载、上翻时按需重新加载\n- 文件预览改为流式读取，不再将整个大文件加载到内存中\n- 大文件（>10MB）的图片、视频、音频预览改为流式传输\n- 图片上传后立即释放 base64 数据，仅在发送给 AI 时按需从磁盘读取\n- 图片引用缓存加入容量上限（50 条）和自动淘汰\n- 流式会话管理器中的定时器全部纳入统一追踪，会话结束时确保清理\n- 工具输出预览窗口从 5000 字符缩减至 2000 字符\n\n### 修复问题\n\n- 修复多张图片引用时保留策略错误的问题，现在正确保留最新的图片\n- 修复上下文压缩后 token 预算计算不准确的问题\n- 修复压缩器模型回退和服务商解析的问题\n\n## 下载地址\n\n### macOS\n- [Apple Silicon (M1\u002FM2\u002FM3\u002FM4)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.45.0\u002FCodePilot-0.45.0-arm64.dmg)\n- [Intel](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.45.0\u002FCodePilot-0.45.0-x64.dmg)\n\n### Windows\n- [Windows 安装包](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.45.0\u002FCodePilot.Setup.0.45.0.exe)\n\n## 安装说明\n\n**macOS**: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示，在系统设置 > 隐私与安全中点击\"仍要打开\"\n**Windows**: 下载 exe 安装包 → 双击安装\n\n## 系统要求\n\n- macOS 12.0+ \u002F Windows 10+ \u002F Linux (glibc 2.31+)\n- 需要配置 API 服务商（Anthropic \u002F OpenRouter 等）\n- 推荐安装 Claude Code CLI 以获得完整功能\n\n","2026-04-03T05:31:19",{"id":203,"version":204,"summary_zh":205,"released_at":206},264119,"v0.44.1","## CodePilot v0.44.1\n\n> v0.44.0 热修复：修复切换会话时模型选择器跳到错误模型的问题，以及若干界面优化。\n\n### 修复问题\n\n- 修复切换会话时，模型选择器短暂显示上一个会话的模型再跳回正确值的问题\n- 修复分栏视图中切换会话同样会出现模型跳动的问题\n- 修复全局默认模型属于其他服务商时，可能被错误应用到当前会话的问题\n- 移除设置页中的\"重置伙伴\"按钮（测试功能，不应出现在正式版）\n\n### 优化改进\n\n- 看板面板默认宽度从 640px 调整为 480px，减少对聊天区域的占用\n- 模型解析逻辑统一为共享函数，主聊天页和分栏视图行为一致\n- 新增 11 个模型解析回归测试，覆盖跨服务商、空配置、已删除服务商等边界场景\n\n## 下载地址\n\n### macOS\n- [Apple Silicon (M1\u002FM2\u002FM3\u002FM4)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.44.1\u002FCodePilot-0.44.1-arm64.dmg)\n- [Intel](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.44.1\u002FCodePilot-0.44.1-x64.dmg)\n\n### Windows\n- [Windows 安装包](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.44.1\u002FCodePilot-Setup-0.44.1.exe)\n\n## 安装说明\n\n**macOS**: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示，在系统设置 > 隐私与安全中点击\"仍要打开\"\n**Windows**: 下载 exe 安装包 → 双击安装\n\n## 系统要求\n\n- macOS 12.0+ \u002F Windows 10+ \u002F Linux (glibc 2.31+)\n- 需要配置 API 服务商（Anthropic \u002F OpenRouter 等）\n- 推荐安装 Claude Code CLI 以获得完整功能\n","2026-04-01T10:19:30",{"id":208,"version":209,"summary_zh":210,"released_at":211},264120,"v0.44.0","## CodePilot v0.44.0\n\n> Buddy 游戏化全面升级：3D 视觉体系、心跳双模式、后台通知、调度器健壮性修复，以及 54 个新增测试。\n\n### 新增功能\n\n- Buddy 宠物全面使用 3D Fluent Emoji 图片替代系统 emoji，覆盖 Wizard 揭晓、聊天空状态、新建聊天入口、侧栏推广卡、看板 Buddy 卡\n- 稀有度渐变背景和胶囊标签，视觉上从灰\u002F绿\u002F蓝\u002F紫\u002F金区分 5 个等级\n- 助理空会话展示 Buddy 3D 形象（有 Buddy）或 3D 蛋图（无 Buddy），非助理项目保持 CodePilot logo\n- 看板 Buddy 卡重新设计：紧凑状态行、进化按钮反馈、设置按钮内联\n- 心跳系统支持\"软心跳\"模式：在普通对话中自然顺带做日常检查，不打断用户\n- 后台无窗口时（tray-only 模式），定时任务通知仍能弹出系统通知，点击恢复窗口\n- 定时任务调度器支持冷启动自动恢复（不再依赖首次聊天触发）\n- Buddy 重置时自动清理 soul.md 中的旧性格描述\n\n### 修复问题\n\n- 修复心跳指令可能混入普通对话的问题\n- 修复 Buddy 领养引导和心跳检查可能同时触发的冲突\n- 修复工作区内 symlink 可以绕过路径校验读取外部文件的安全漏洞\n- 修复 session-only 循环任务到期后每 10 秒重复执行的问题\n- 修复 session-only 任务无法列出和取消的问题\n- 修复 session-only 任务失败后不退避、不自动禁用的问题\n- 修复 low\u002Fnormal 优先级通知被静默吞掉的问题\n- 修复 MCP 工具硬编码 localhost:3000 导致 worktree 和打包环境失效的问题\n- 修复自动记忆提取的\"本轮已写入\"检查失效的问题\n- 修复记忆提取计数器跨会话串线的问题\n- 修复 cron 表达式解析器对周\u002F月级调度计算错误的问题（扩展到 4 年扫描）\n- 修复不可能的 cron 表达式（如 2 月 30 日）会设置错误执行时间的问题\n\n### 优化改进\n\n- 心跳触发判定统一到服务端 API，前端不再重复实现\n- 通知系统新增服务端队列，前端 5 秒轮询显示 Toast + 系统通知\n- Electron 通知优先走 IPC 原生桥（支持点击回到窗口），浏览器 Notification 仅作开发模式 fallback\n- 定时任务创建和调度共用同一份 cron\u002Finterval 解析函数，消除重复实现\n- 新增 54 个单元测试覆盖 cron 解析、记忆提取计数器、心跳标记清理、通知队列、后台通知解析\n\n## 下载地址\n\n### macOS\n- [Apple Silicon (M1\u002FM2\u002FM3\u002FM4)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.44.0\u002FCodePilot-0.44.0-arm64.dmg)\n- [Intel](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.44.0\u002FCodePilot-0.44.0-x64.dmg)\n\n### Windows\n- [Windows 安装包](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.44.0\u002FCodePilot-Setup-0.44.0.exe)\n\n## 安装说明\n\n**macOS**: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示，在系统设置 > 隐私与安全中点击\"仍要打开\"\n**Windows**: 下载 exe 安装包 → 双击安装\n\n## 系统要求\n\n- macOS 12.0+ \u002F Windows 10+ \u002F Linux (glibc 2.31+)\n- 需要配置 API 服务商（Anthropic \u002F OpenRouter 等）\n- 推荐安装 Claude Code CLI 以获得完整功能\n","2026-04-01T07:44:28",{"id":213,"version":214,"summary_zh":215,"released_at":216},264121,"v0.43.1","## CodePilot v0.43.1\n\n> v0.43.0 热修复：修复可视化组件流式输出时中文显示为乱码、看板刷新按钮对 CLI 数据源不生效的问题。\n\n### 修复问题\n\n- 修复可视化组件在流式输出时中文字符显示为 `\\uXXXX` 转义码的问题\n- 修复看板刷新按钮对 CLI 数据源类型的组件不生效的问题\n\n## 下载地址\n\n### macOS\n- [Apple Silicon (M1\u002FM2\u002FM3\u002FM4)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.43.1\u002FCodePilot-0.43.1-arm64.dmg)\n- [Intel](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.43.1\u002FCodePilot-0.43.1-x64.dmg)\n\n### Windows\n- [Windows 安装包](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.43.1\u002FCodePilot-Setup-0.43.1.exe)\n\n## 安装说明\n\n**macOS**: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示，在系统设置 > 隐私与安全中点击\"仍要打开\"\n**Windows**: 下载 exe 安装包 → 双击安装\n\n## 系统要求\n\n- macOS 12.0+ \u002F Windows 10+ \u002F Linux (glibc 2.31+)\n- 需要配置 API 服务商（Anthropic \u002F OpenRouter 等）\n- 推荐安装 Claude Code CLI 以获得完整功能\n","2026-03-30T04:05:34",{"id":218,"version":219,"summary_zh":220,"released_at":221},264122,"v0.43.0","## CodePilot v0.43.0\n\n> 本版本新增**项目看板**——AI 原生的项目控制台。聊天中生成的可视化组件可以固定到看板持续追踪，支持文件、MCP 工具、CLI 命令三种数据源，看板数据自动刷新，组件可导出为图片分享。\n\n### 新增功能\n\n- **项目看板**：右侧新增看板面板，固定聊天中的可视化组件到看板，项目级持续追踪\n- **看板 MCP 工具**：AI 在对话中直接管理看板——固定组件、刷新数据、更新内容、调整排序，全部通过对话完成\n- **三种数据源**：支持本地文件（glob 模式）、MCP 工具（Linear\u002FNotion 等外部服务）、CLI 命令（git log\u002Fdocker ps 等）作为看板数据来源\n- **组件导出为图片**：在看板或聊天中点击导出按钮，将可视化组件保存为高清 PNG 图片（含 Chart.js 图表）\n- **看板与对话联动**：点击看板组件标题可发起深入分析对话；AI 自动感知看板内容，对话中了解你在追踪什么\n- **组件间联动**：看板组件之间可以通过筛选器实现数据联动——点击一个组件的筛选条件，其他组件自动更新\n- **看板组件排序**：通过上下箭头调整组件顺序，支持自动刷新开关\n\n### 修复问题\n\n- 修复可视化组件在部分模型下渲染为 JSON 代码的问题（解析器改为格式无关，兼容所有模型输出变体）\n- 修复 Chart.js 图表因 CDN 脚本加载时序问题不渲染的问题\n- 修复可视化组件底部内容被裁切的问题\n\n### 优化改进\n\n- 可视化组件的 Pin 和显示代码按钮统一为工具栏，对齐显示\n- Toast 提示支持 loading 状态（转圈等待 → 成功\u002F失败自动切换）\n- 看板组件标题改为人类可读的自然语言（如\"用户参与度指标\"而非 user_engagement）\n\n## 下载地址\n\n### macOS\n- [Apple Silicon (M1\u002FM2\u002FM3\u002FM4)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.43.0\u002FCodePilot-0.43.0-arm64.dmg)\n- [Intel](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.43.0\u002FCodePilot-0.43.0-x64.dmg)\n\n### Windows\n- [Windows 安装包](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.43.0\u002FCodePilot-Setup-0.43.0.exe)\n\n## 安装说明\n\n**macOS**: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示，在系统设置 > 隐私与安全中点击\"仍要打开\"\n**Windows**: 下载 exe 安装包 → 双击安装\n\n## 系统要求\n\n- macOS 12.0+ \u002F Windows 10+ \u002F Linux (glibc 2.31+)\n- 需要配置 API 服务商（Anthropic \u002F OpenRouter 等）\n- 推荐安装 Claude Code CLI 以获得完整功能\n","2026-03-30T03:40:26",{"id":223,"version":224,"summary_zh":225,"released_at":226},264123,"v0.42.0","## CodePilot v0.42.0\n\n> 本版本聚焦 **CLI 工具的 AI 化安装体验**和全新的 **Agent 友好度评分系统**。安装工具改为由 AI 全程协助，工具卡片新增 5 星评分帮你判断哪些工具最适合 AI 使用。\n\n### 新增功能\n\n- **AI 协助安装 CLI 工具**：点击安装按钮直接跳转聊天，AI 帮你执行安装命令、处理权限问题、引导认证配置、生成工具简介，全流程在对话中完成\n- **Agent 友好度 5 星评分**：工具卡片新增 ★★★★★ 评分，从 5 个维度评估工具对 AI 的友好程度（Agent 原生设计 \u002F JSON 输出 \u002F Schema 自省 \u002F Dry Run \u002F 上下文友好）\n- **AI 自动评估兼容度**：通过聊天添加的自定义工具，AI 会从 --help 输出自动评估 Agent 兼容度；批量生成简介时也会同步评估\n- **新增推荐 CLI 工具**：即梦 Dreamina CLI（AI 图片\u002F视频生成）、飞书 Lark CLI（200+ 命令覆盖飞书全业务域）\n- **工具安装后自动配置**：需要认证的工具安装后，AI 自动引导完成登录和配置；需要 Skills 安装的工具（飞书、gws）会在安装提示中告知\n\n### 修复问题\n\n- 修复斜杠命令（如 \u002Freview）发送时用户附加文本在气泡中不显示的问题\n- 修复 JSON 格式版本号（如 Dreamina CLI）在工具卡片上显示为乱码的问题\n- 移除不可用的 Custom API (OpenAI-compatible) Provider 选项\n- 修复旧版 custom provider 升级时可能误删有效配置的问题\n\n### 优化改进\n\n- 工具详情弹窗新增\"AI Agent 兼容度\"区域，展示具体达标维度和评分\n- GLM 模型更新为 GLM-5-Turbo \u002F GLM-5.1 \u002F GLM-4.5-Air\n- MCP list 工具的 JSON 输出在所有工具类型中统一字段格式\n\n## 下载地址\n\n### macOS\n- [Apple Silicon (M1\u002FM2\u002FM3\u002FM4)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.42.0\u002FCodePilot-0.42.0-arm64.dmg)\n- [Intel](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.42.0\u002FCodePilot-0.42.0-x64.dmg)\n\n### Windows\n- [Windows 安装包](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.42.0\u002FCodePilot-Setup-0.42.0.exe)\n\n## 安装说明\n\n**macOS**: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示，在系统设置 > 隐私与安全中点击\"仍要打开\"\n**Windows**: 下载 exe 安装包 → 双击安装\n\n## 系统要求\n\n- macOS 12.0+ \u002F Windows 10+ \u002F Linux (glibc 2.31+)\n- 需要配置 API 服务商（Anthropic \u002F OpenRouter 等）\n- 推荐安装 Claude Code CLI 以获得完整功能\n","2026-03-28T09:55:40",{"id":228,"version":229,"summary_zh":230,"released_at":231},264124,"v0.41.0","## CodePilot v0.41.0\n\n> 本版本重点是**侧边栏导航重构**和**全局 UI 一致性优化**。左侧导航从两层图标栏简化为单层侧边栏，所有页面的标题样式统一，多处交互细节改进。\n\n### 新增功能\n\n- **单层侧边栏导航**：移除左侧图标栏（NavRail），Skills、MCP、CLI 工具、素材库、远程桥接等入口整合到侧边栏内，设置固定在底部，所有页面始终可见\n- **对话列表搜索弹窗**：搜索改为弹窗形式，支持实时搜索会话并快速跳转\n- **项目文件夹动画**：文件夹展开\u002F折叠增加平滑过渡动画\n- **对话列表自动截断**：超过 10 条对话的项目自动折叠，底部显示\"展开更多\"\n- **助理项目置顶**：设置了助理工作区的项目自动排在列表最前\n- **新增推荐 CLI 工具**：即梦 Dreamina CLI（AI 创作工具包）、飞书 Lark CLI（200+ 命令覆盖飞书全业务域）\n- **macOS 磨砂玻璃效果**：Electron 窗口启用 vibrancy，侧边栏支持原生毛玻璃效果\n\n### 修复问题\n\n- 修复斜杠命令（如 \u002Freview）发送时用户附加文本在气泡中不显示的问题\n- 修复窗口缩小到 1024px 以下时侧边栏消失且无法恢复的问题\n- 修复搜索弹窗关闭后隐形过滤条件仍生效的问题\n- 修复对话截断可能隐藏当前打开会话的问题\n- 修复 JSON 格式版本号（如 Dreamina CLI）显示为乱码的问题\n- 修复 OpenAI-compatible 类型 Provider 实际不可用但仍显示在选项中的问题\n- 移除 Custom API (OpenAI-compatible) Provider 选项（Claude Code SDK 不支持）\n\n### 优化改进\n\n- 所有非聊天页面标题样式统一：主标题 + 副标题 + 全宽分割线，操作按钮位置一致\n- Skills 页面左右分栏改为单线分割，去除嵌套圆角矩形边框\n- 非聊天页面顶部空白区域缩小\n- \"添加项目文件夹\"简化为\"新建项目\"\n- 更新指示点颜色跟随主题色\n- 导入 CLI 会话功能移至设置 > Claude CLI 区域\n- GLM 模型更新为 GLM-5-Turbo \u002F GLM-5.1 \u002F GLM-4.5-Air\n\n## 下载地址\n\n### macOS\n- [Apple Silicon (M1\u002FM2\u002FM3\u002FM4)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.41.0\u002FCodePilot-0.41.0-arm64.dmg)\n- [Intel](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.41.0\u002FCodePilot-0.41.0-x64.dmg)\n\n### Windows\n- [Windows 安装包](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.41.0\u002FCodePilot-Setup-0.41.0.exe)\n\n## 安装说明\n\n**macOS**: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示，在系统设置 > 隐私与安全中点击\"仍要打开\"\n**Windows**: 下载 exe 安装包 → 双击安装\n\n## 系统要求\n\n- macOS 12.0+ \u002F Windows 10+ \u002F Linux (glibc 2.31+)\n- 需要配置 API 服务商（Anthropic \u002F OpenRouter 等）\n- 推荐安装 Claude Code CLI 以获得完整功能\n","2026-03-28T04:55:03",{"id":233,"version":234,"summary_zh":235,"released_at":236},264125,"v0.40.0","## CodePilot v0.40.0\n\n> 本次大版本聚焦两个方向：**素材库全面升级**和全新的 **CLI 工具 AI 管理**。素材库支持直接在聊天中生成和导入媒体文件，CLI 工具可以通过对话完成安装、注册、更新的全流程。\n\n### 新增功能\n\n- **聊天内生成图片并自动保存**：在对话中直接生成图片，自动保存到素材库并内联展示，无需手动导入\n- **聊天内导入媒体文件**：通过对话将本地图片\u002F视频\u002F音频文件导入素材库，支持自动提取元数据（提示词、模型、分辨率）\n- **CLI 工具 AI 管理**：告诉 AI \"帮我安装 ffmpeg\" 或 \"检查工具更新\"，它会自动完成安装、注册、生成简介、检测更新的全流程\n- **CLI 工具版本更新检测**：AI 可以检查哪些已安装的 CLI 工具有可用更新，并帮你一键升级\n- **CLI 工具结构化简介**：AI 生成的工具简介升级为完整格式（工具介绍、适用场景、快速上手、示例提示词），与官方推荐工具一致\n- **新增 3 个推荐 CLI 工具**：ElevenLabs CLI（AI 语音代理管理）、Stripe CLI（支付集成）、网易云音乐 CLI（AI 音乐控制）\n- **官网更新公告区域**：首页新增最近 5 条版本更新卡片，可直接查看每个版本的更新内容\n\n### 修复问题\n\n- 修复 AI 生成的 CLI 工具简介关闭后丢失的问题（现在持久化到数据库）\n- 修复切换主题后重启应用会恢复默认主题的问题\n- 修复暗色模式下 Bash 代码块文字颜色与背景对比度不足、几乎看不清的问题\n- 修复未安装的工具详情弹窗错误显示\"尝试使用\"按钮的问题\n- 修复官网 FAQ 中错误描述为仅支持 macOS 的问题（实际已支持全平台）\n\n### 优化改进\n\n- CLI 工具管理页面的\"添加工具\"改为对话式体验，跳转聊天由 AI 协助完成\n- 已安装工具详情弹窗新增\"尝试使用\"按钮，一键开启新对话\n- 额外检测到的系统工具和用户自定义工具分别显示\"系统检测\"\u002F\"自定义\"标签\n- 自定义工具卡片支持点击查看详情\n- 终端\u002FBash 代码块使用主题感知 CSS 变量，适配所有主题的明暗模式\n- 官网下载按钮改为直接链接到 GitHub Releases 最新版本\n\n## 下载地址\n\n### macOS\n- [Apple Silicon (M1\u002FM2\u002FM3\u002FM4)](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.40.0\u002FCodePilot-0.40.0-arm64.dmg)\n- [Intel](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.40.0\u002FCodePilot-0.40.0-x64.dmg)\n\n### Windows\n- [Windows 安装包](https:\u002F\u002Fgithub.com\u002Fop7418\u002FCodePilot\u002Freleases\u002Fdownload\u002Fv0.40.0\u002FCodePilot-Setup-0.40.0.exe)\n\n## 安装说明\n\n**macOS**: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示，在系统设置 > 隐私与安全中点击\"仍要打开\"\n**Windows**: 下载 exe 安装包 → 双击安装\n\n## 系统要求\n\n- macOS 12.0+ \u002F Windows 10+ \u002F Linux (glibc 2.31+)\n- 需要配置 API 服务商（Anthropic \u002F OpenRouter 等）\n- 推荐安装 Claude Code CLI 以获得完整功能\n","2026-03-27T16:45:02",{"id":238,"version":239,"summary_zh":240,"released_at":241},264126,"v0.39.0","## Downloads\n\n**Windows**\n- **CodePilot Setup 0.39.0.exe** — Windows installer (x64 + arm64)\n\n**macOS**\n- **CodePilot-0.39.0-arm64.dmg** — macOS Apple Silicon (M1\u002FM2\u002FM3\u002FM4)\n- **CodePilot-0.39.0-x64.dmg** — macOS Intel\n\n**Linux**\n- **AppImage \u002F deb \u002F rpm** — x64 and arm64\n\n## Installation\n\n**Windows**: Download the exe installer, double-click to install.\n\n**macOS**:\n1. Download the DMG for your chip architecture\n2. Open the DMG, drag CodePilot into Applications\n3. If you see a security prompt on first launch, go to **System Settings > Privacy & Security** and click \"Open Anyway\"\n4. Configure your Anthropic API Key in Settings\n\n**Linux**: Run the AppImage directly, or install via deb\u002Frpm package.\n\n## Requirements\n\n- Windows 10+ \u002F macOS 12.0+ \u002F Linux (glibc 2.31+)\n- Anthropic API Key or `ANTHROPIC_API_KEY` environment variable\n- Claude Code CLI recommended for code features\n\n## Changelog\n\n| Commit | Description |\n|--------|-------------|\n| `8be94c6` | chore: prepare v0.39.0 release |\n| `1ce3b7b` | Merge branch 'worktree-unified-context-layer' |\n| `f0930b3` | docs: add bridge plan-mode vs full_access tech debt item |\n| `f8e187a` | fix: disable split screen menu item for sessions already in split |\n| `564ecfd` | fix: sidebar session list no longer clips at narrow widths |\n| `69cac71` | fix: session list item layout uses flex instead of absolute positioning |\n| `be161c9` | fix: sidebar context menu bugs from Codex review |\n| `ae5290f` | feat: three-dot context menus for sessions and projects |\n| `325e188` | fix: enable plan mode toggle on new chat page |\n| `98c4f0f` | docs: add unified context layer exec plan |\n| `0b773cb` | fix: plan mode bypassed by full_access, mode race condition, MCP cache staleness |\n| `8329d2a` | refactor: unified context layer + plan mode + MCP latency optimization |\n| `33c8bd8` | fix: recommend native mac update builds |\n| `a6b1273` | docs: refresh weixin bridge handover |\n","2026-03-25T01:19:24",{"id":243,"version":244,"summary_zh":245,"released_at":246},264127,"v0.38.5","## Downloads\n\n**Windows**\n- **CodePilot Setup 0.38.5.exe** — Windows installer (x64 + arm64)\n\n**macOS**\n- **CodePilot-0.38.5-arm64.dmg** — macOS Apple Silicon (M1\u002FM2\u002FM3\u002FM4)\n- **CodePilot-0.38.5-x64.dmg** — macOS Intel\n\n**Linux**\n- **AppImage \u002F deb \u002F rpm** — x64 and arm64\n\n## Installation\n\n**Windows**: Download the exe installer, double-click to install.\n\n**macOS**:\n1. Download the DMG for your chip architecture\n2. Open the DMG, drag CodePilot into Applications\n3. If you see a security prompt on first launch, go to **System Settings > Privacy & Security** and click \"Open Anyway\"\n4. Configure your Anthropic API Key in Settings\n\n**Linux**: Run the AppImage directly, or install via deb\u002Frpm package.\n\n## Requirements\n\n- Windows 10+ \u002F macOS 12.0+ \u002F Linux (glibc 2.31+)\n- Anthropic API Key or `ANTHROPIC_API_KEY` environment variable\n- Claude Code CLI recommended for code features\n\n## Changelog\n\n| Commit | Description |\n|--------|-------------|\n| `ab952ee` | chore: patch security dependencies |\n| `2aa3718` | chore: prepare v0.38.5 release |\n| `c175830` | Merge branch 'worktree-wechat-bridge' |\n| `207471f` | chore: merge bridge cwd healing into WeChat bridge |\n| `f7434d1` | feat: add WeChat bridge channel |\n| `6a98c12` | fix: self-heal bridge working directories |\n| `a38809b` | chore: remove stale worktree gitlink, ignore .claude\u002F, fix MCP scope text |\n| `e72c165` | fix: prevent widget MCP on plain chat, clarify MCP toggle scope |\n| `fcef327` | fix: chat latency remediation — effort default, MCP persistent toggle, mode convergence |\n| `2a6888d` | fix: 修复 4 个 UI\u002F逻辑 bug + 安全审查修补 |\n","2026-03-22T17:37:39",{"id":248,"version":249,"summary_zh":250,"released_at":251},264128,"v0.38.4","## Downloads\n\n**Windows**\n- **CodePilot Setup 0.38.4.exe** — Windows installer (x64 + arm64)\n\n**macOS**\n- **CodePilot-0.38.4-arm64.dmg** — macOS Apple Silicon (M1\u002FM2\u002FM3\u002FM4)\n- **CodePilot-0.38.4-x64.dmg** — macOS Intel\n\n**Linux**\n- **AppImage \u002F deb \u002F rpm** — x64 and arm64\n\n## Installation\n\n**Windows**: Download the exe installer, double-click to install.\n\n**macOS**:\n1. Download the DMG for your chip architecture\n2. Open the DMG, drag CodePilot into Applications\n3. If you see a security prompt on first launch, go to **System Settings > Privacy & Security** and click \"Open Anyway\"\n4. Configure your Anthropic API Key in Settings\n\n**Linux**: Run the AppImage directly, or install via deb\u002Frpm package.\n\n## Requirements\n\n- Windows 10+ \u002F macOS 12.0+ \u002F Linux (glibc 2.31+)\n- Anthropic API Key or `ANTHROPIC_API_KEY` environment variable\n- Claude Code CLI recommended for code features\n\n## Changelog\n\n| Commit | Description |\n|--------|-------------|\n| `b5d558d` | fix: #341 #343 #346 #347 — provider fixes + global default model |\n","2026-03-20T13:58:11",{"id":253,"version":254,"summary_zh":255,"released_at":256},264129,"v0.38.3","## Downloads\n\n**Windows**\n- **CodePilot Setup 0.38.3.exe** — Windows installer (x64 + arm64)\n\n**macOS**\n- **CodePilot-0.38.3-arm64.dmg** — macOS Apple Silicon (M1\u002FM2\u002FM3\u002FM4)\n- **CodePilot-0.38.3-x64.dmg** — macOS Intel\n\n**Linux**\n- **AppImage \u002F deb \u002F rpm** — x64 and arm64\n\n## Installation\n\n**Windows**: Download the exe installer, double-click to install.\n\n**macOS**:\n1. Download the DMG for your chip architecture\n2. Open the DMG, drag CodePilot into Applications\n3. If you see a security prompt on first launch, go to **System Settings > Privacy & Security** and click \"Open Anyway\"\n4. Configure your Anthropic API Key in Settings\n\n**Linux**: Run the AppImage directly, or install via deb\u002Frpm package.\n\n## Requirements\n\n- Windows 10+ \u002F macOS 12.0+ \u002F Linux (glibc 2.31+)\n- Anthropic API Key or `ANTHROPIC_API_KEY` environment variable\n- Claude Code CLI recommended for code features\n\n## Changelog\n\n| Commit | Description |\n|--------|-------------|\n| `c8a1581` | feat: add Xiaomi MiMo provider preset + update MiniMax to M2.7 |\n","2026-03-18T23:15:04"]