codehelper

概览

QCode 是用 Go 实现的 AI 编程智能体运行时，在本地运行并具备受控执行。它将仓库理解、模型调用、受治理的工具、审批、验证、持久会话和子智能体协作统一在单一的运行时协议之后。主要入口是一个加载本地 Web 界面的 macOS 桌面应用。项目处于初期开发阶段，在首个公开稳定版发布之前，接口和持久化格式可能会变化。 该系统强调适合长期运行的工程特性：本地控制，源码和执行都留在用户的工作区；由主智能体和子智能体共享单一的 Web 入口和运行时；受控执行，所有修改类工具都要经过策略、权限、章程、日志和操作系统沙箱检查；证据优先，搜索、编辑、审批、验证、用量和追踪构成可检查的运行时事实；以及无需分叉控制平面即可扩展，MCP、Skill 和子智能体通过受治理的适配器接入。安全能力不可用时会明确报告，而不是悄悄降级。 QCode 需要 Go 1.26 或更高版本、Git、Node.js 和 npm，以及 Xcode Command Line Tools。目前仅支持 macOS（amd64/arm64）。用户必须配置包含 Base URL、Protocol、Model ID 和 API Key 的连接；API 密钥由操作系统 Keyring 加密。会话可以在已配置的连接之间切换经过验证的模型。Web 界面默认地址为 127.0.0.1:6732。可以安装独立的运行时用于调试。