Code Assistant
可在桌面、终端和编辑器中自主读写代码并执行命令的 Rust 编程助手。
按维度查看评分与理由
证据显示产品具有权限层级、命令沙箱、不安全工具组合过滤、工具调用及返回内容展示，并在浏览器登录时采用人工交接；发布流水线也把写权限限制在最终 publish 作业。扣分在于 README 同时把“更严格的沙箱”列为未来工作，未说明每类文件修改或命令执行的逐项确认规则、密钥静态存储与日志脱敏细节。依赖使用 Cargo 锁定构建，多个 GitHub Action 和主要 Git 依赖固定到提交，但仍有两个补丁依赖跟随分支，且未展示漏洞扫描或更新策略。会话分支提供一定恢复基础，却没有明确的文件编辑回滚机制。MIT 文件给出了作者归属，但发布者身份和维护主体未得到进一步确认。
README、工作区清单和 CI 对跨平台、多界面产品的描述基本一致；CI 在 Linux、macOS、Windows测试 GPUI，并对其余工作区执行格式、lint 和测试，发布前也重复这些门禁。依赖采用锁文件和若干精确提交，有助于可用性，但分支型 Git 补丁和较大的多平台依赖面降低了充分性。错误处理只有零散证据：发布脚本会拒绝降级和未知目标，然而 README 的路线图明确表明陈旧文件替换与失败工具调用的友好处理仍待完善，因此失败消息仅获薄弱分。
受众和场景覆盖很清楚，包括 GUI、终端、MCP、ACP、编辑器、无头运行、多家模型提供商以及代码和办公文档。配置可通过设置界面或 JSON 完成，并提供多平台预构建包和源码构建说明，环境适配证据充分。能力边界部分由权限层级、沙箱、读后写过滤和人工登录交接体现，但具体边界矩阵未提供；工具语法按会话自适应且可加载项目指引，不过何时选择工具、技能或子代理的精确触发规则没有展开。
README 结构清楚，将入门、差异、功能、接口、配置、贡献和路线图分开，并链接专题文档；安装覆盖预构建包、各平台依赖、源码构建和集成示例。命令及产品名总体稳定，但四种模式和多个配置入口的兼容承诺未说明。示例较实用但没有 FAQ。路线图披露了若干已知缺口，仍非系统化限制清单。MIT 许可证完整明确。发布工作流实现版本检查、标记、制品发布和下一开发版本递增，但所给材料没有 changelog。贡献入口存在，版权作者可识别，不过未给出正式维护者、支持渠道、响应承诺或安全报告责任。
工具活动可视化、会话持久化与分支、流式输出、附件、格式化后状态协调以及编码和换行保持，支持产出直接用于真实代码库；但材料没有展示实际输出样例或质量验收流程，因此可用性未满分。相较普通聊天助手，多界面自主工具循环、文档读取、浏览器操作和格式化协调体现明显增量价值。预构建包和图形化配置降低采用成本，但运行模型、浏览器、外部 MCP 服务及大型 Rust 构建的时间、令牌和安全成本未量化。
主要声明可追溯到 README 的具体功能描述，并由 Cargo 工作区、固定依赖和 CI／发布配置对架构、平台与发布流程形成部分佐证。材料未包含实现源码、专题文档内容或测试结果，因此权限、沙箱、凭据隔离、编码保持等重要声明无法在所给来源间充分交叉核验。README 通常区分现有功能和路线图，但营销式断言（例如不会静默改写换行、登录时永不看到凭据）缺少限定和实现证据，故未获满分。
- 该代理能够读取、修改文件并运行命令；在用于重要仓库前，应核实默认权限层级、沙箱边界、命令确认策略及可恢复的版本控制流程。
- API 密钥可由设置界面或环境变量提供，但所给材料未说明本地存储、日志脱敏、会话记录或附件中的秘密处理方式。
- MCP 客户端和浏览器能力扩大了数据流与外部影响范围；应逐一审查已连接服务器、工具权限、网络目标和登录交接行为。
- 部分 Git 依赖来自分支而非不可变修订，且未展示依赖漏洞扫描；生产采用前应检查锁文件解析结果与依赖安全状态。
- 发布流程允许删除并重建同版本标签和 Release；维护者应确认这符合制品不可变性和供应链审计要求。
这个 Agent 能做什么，适合哪些场景？
Code Assistant 是一个用 Rust 编写的开源自主编程代理，可围绕本地代码库循环执行读取、搜索、编辑文件和运行命令等操作。它提供基于 Zed GPUI 的原生图形界面、终端界面、无头 MCP 服务器，以及供 Zed 等编辑器连接的 ACP 代理。用户可以选择 Anthropic、OpenAI、Google Vertex AI、Ollama、OpenRouter、SAP AI Core、Groq、Cerebras 或 Mistral 等模型提供方。它会展示工具调用及返回给模型的上下文，并支持项目会话、分支、持久化状态、附件、子代理、权限等级、命令沙箱和上下文压缩。除源代码外，它还能将 Word、Excel、PowerPoint、PDF 等文档转换为 Markdown 供代理处理，并可通过受人工登录交接保护的浏览器会话测试 Web 应用。项目采用 MIT 许可证，可使用预编译版本，也可从源码构建并在本机运行。
用户添加项目目录并提交任务后，Code Assistant 在该代码库上运行自主代理循环：读取和搜索文件、编辑内容、执行命令，并把每次工具调用及其返回上下文显示给用户。保存文件时，它可以运行项目格式化器，再将模型修改与格式化结果协调起来，避免仅为刷新上下文而重新读取文件；写回时会保留原始编码、BOM 与 CRLF/LF 行尾。它还能自动把 Word、Excel、PowerPoint、PDF 等文档转换为 Markdown，连接外部 MCP 服务器，并驱动真实浏览器完成导航、读取、点击和输入。产品可通过 code-assistant 启动原生 GUI，通过 code-assistant --tui 使用终端界面，通过 code-assistant acp 作为 ACP 编辑器代理运行，或通过 code-assistant server 作为无头 MCP 服务器运行。任何模式都可用 --task 接收初始任务，例如 code-assistant --task "Explain this codebase"。
- 希望代理直接修改本地项目的开发者，可在 GUI 中查看每次读取、搜索、编辑和命令执行的具体结果。
- 偏好终端工作流的工程师，可用
code-assistant --tui在项目会话中完成代码理解和修改任务。 - 使用 Zed 的团队，可通过
code-assistant acp将它配置为外部 ACP 编程代理。 - 使用 Claude Desktop 的用户，可通过
code-assistant server将本地代码操作能力作为 MCP 服务器接入。 - 维护同时包含代码、PDF 和 Office 文件的项目人员，可让代理把这些文档作为 Markdown 与源码一起分析。
- 测试 Web 应用的开发者，可使用浏览器会话执行导航、点击和输入，并在登录时由人工接管凭据输入。
这个 Agent 有哪些优点和局限？
- 工具调用界面会显示执行了哪些工具，以及每项结果中哪些内容被交给模型，便于追踪代理行为。
- 格式化后会协调模型修改与格式化结果，减少重新读取文件造成的 token 消耗和后续编辑失配。
- 读写过程中保留文件编码、BOM 和 CRLF/LF 行尾，降低无关格式变更风险。
- 同一二进制文件覆盖原生 GUI、TUI、MCP server 和 ACP agent 四种使用方式。
- 支持多家托管模型提供方和 Ollama，并能把 Office、PDF 等文档与代码一起处理。
- 使用托管模型需要配置相应提供方的 API 密钥，相关服务费用和可用性不由本项目控制。
- 从源码构建需要 Rust；Linux 还需要多项图形、音频、Vulkan 和系统开发库，macOS 需要 MetalToolchain。
- 代理具备编辑文件和运行命令的能力，采用前需要根据项目风险配置权限等级和命令沙箱。
- 更严格地把工具访问限制到项目内 Git 跟踪文件仍列在未来方向中，并非已明确完成的能力。
- 检测模型将要修改自上次读取后已变化文件的功能仍在规划列表中，存在陈旧文件编辑失败的风险。
如何安装或部署这个 Agent？
最快方式是在 GitHub Releases 下载对应的预编译包：Apple Silicon 使用 Code-Assistant-macos-aarch64.app.zip，Intel Mac 使用 Code-Assistant-macos-x86_64.app.zip，Linux 使用 code-assistant-linux-x86_64.zip，Windows 使用 code-assistant-windows-x86_64.zip。启动后，首次运行会打开 Settings；选择模型提供方、粘贴 API 密钥并选择模型，然后在应用内添加项目目录。若从源码构建，先安装 Rust；macOS/Linux 可执行 curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh。Debian/Ubuntu 还需执行 sudo apt-get install -y --no-install-recommends pkg-config build-essential libssl-dev libzstd-dev libfontconfig-dev libwayland-dev libx11-xcb-dev libxkbcommon-x11-dev libasound2-dev libvulkan1；macOS 需执行 xcodebuild -downloadComponent MetalToolchain。随后运行 git clone https://github.com/stippi/code-assistant、cd code-assistant 和 cargo build --release，生成的二进制文件位于 target/release/code-assistant。
如何使用这个 Agent？
首次可直接运行 code-assistant，在 Settings 中配置提供方、API 密钥和模型，添加项目目录后开始对话。需要终端界面时运行 code-assistant --tui；要直接提交初始任务，可运行 code-assistant --task "Explain this codebase"。在 Zed 中，把可执行文件配置为 agent server，命令设为 /path/to/code-assistant，参数使用 ["acp", "--model", "Claude Sonnet 4.5"]，并通过环境变量提供 ANTHROPIC_API_KEY。在 Claude Desktop 的 Developer 配置中添加名为 code-assistant 的 MCP server，命令设为 /path/to/code-assistant，参数设为 ["server"]，并按示例设置 SHELL。外部 MCP 服务器、技能、提供方和模型也可在应用 Settings 中管理。