真实界面截图：工作台与引用面板，使用 2026-10-17 专用示例环境。它展示项目资料入口，不代表所有下方功能都在此图中，也不是最新发行包的验收截图。更多操作见实际界面演示。

README 介绍当前源码中的产品能力，不代表每项能力都已包含在最新发行包中。使用发行版前请对照对应的 Release 说明与版本记录。

三步运行

需要 Git、Docker Engine 与 Docker Compose（macOS 可使用 Docker Desktop）。安装脚本先检查环境，再配置、构建并启动源码版本：

git clone https://github.com/skyelan1999/aide.git
cd aide
bash scripts/install.sh --check
bash scripts/install.sh --source

启动后在 模型设置 配置自己的模型，再选择工作空间开始任务。配置目录范围、发行版安装和故障处理见安装说明。

⭐ 如果 aide 对你的项目有帮助，欢迎在 GitHub 点亮 Star。

为什么选择 aide

aide 的名字来自 AI + IDE。它把 AI 能力与集成工作环境放在一起，让你围绕专业任务组织项目、资料、工具和操作过程，减少在多个窗口之间切换，把注意力留给分析、判断与成果本身。

aide 把项目文件、AI 对话、修改提案、运行轨迹与命令执行放在同一个工作空间。它面向希望在本机掌握文件与执行环境的开发者：用 AI 理解项目、梳理方案，再由自己审阅和应用改动。

• 围绕真实项目工作：连接本地目录或 SSH/SFTP 工作区，浏览、编辑、附加文本文件。
• 过程可检查：查看规划、工具调用、文件提案和模型审查；写入和命令执行需要明确操作。
• 环境可迁移：Go、Python、Node.js、Git 随 Docker 环境提供，源码、镜像、工作文件与会话数据分别管理。

项目数据在本机持久化；使用云端模型时，任务内容、上下文和工具读取结果会发送到所配置的提供商。aide 是独立项目，借鉴 DeepSeek Harness 的设计思路，不是 DeepSeek 官方产品，也不提供完整 DSH/Cordis 运行时兼容。

可以完成什么

按专业场景扩展 aide

aide 可以直接用于日常专业工作。需要适配软件研发、技术资料分析或内部流程时，可让开发 AI 复用现有能力，调整界面、策略、插件及外部系统连接。Agent 路由管理的是开发与维护活动，不替代使用者的专业判断。

1. Fork 或克隆源码，保留 MIT 许可证；为定制建立独立分支。
2. 填写 场景定制指南 中的需求模板，明确哪些目录、资料和工具可以使用。
3. 让 AI 先读 AGENTS.md，按需求 → 设计 → 实现 → 测试 → 文档 → Release 的路由开发。
4. 在隔离环境检查真实界面和结果，再构建自己的 Docker 镜像；源码、镜像和数据卷分别交付。

源码用于定制，镜像用于快速运行。 发行镜像包含运行工具链与已编译应用，不替代源码仓库；源码修改后重新构建镜像。下载 Docker 镜像与校验和 · 镜像导入与启动。

源码配置细节

需要 Git、Docker Engine 与 Docker Compose。macOS 可使用 Docker Desktop。当前已有 Apple Silicon 环境验证记录；其他平台应自行构建并检查。宿主机不需要先安装 Go 或 npm 依赖。

也可以直接使用环境检查与安装脚本：bash scripts/install.sh --check，然后选择 --source 或 --image 归档路径。完整前置环境、首次登录和故障处理见 安装说明。

1. 获取项目

git clone https://github.com/skyelan1999/aide.git
cd aide

仓库若要求访问权限，请使用有权限的 GitHub 账户。

2. 配置本地目录

首次配置才复制 .env.example；已有 .env 时直接编辑，避免覆盖。

cp -n .env.example .env
mkdir -p context

将 .env 中目录改成实际存在的路径。下面使用 aide 本身作为工作区、context/ 作为只读资料目录，并将本地浏览范围限制到你的开发目录：

AIDE_PORT=8097
AIDE_WORKSPACE=.
AIDE_CONTEXT=./context
AIDE_LOCAL_ROOT=/absolute/path/to/your/projects

挂载范围要点：仓库的 Compose 默认 AIDE_LOCAL_ROOT=$HOME，即将整个用户主目录可读写挂载到 /local。按需改为较小的已存在目录；容器命令和可信插件能访问其权限内的挂载内容。/context 保持只读。

3. 构建、启动并登录

bash scripts/aide.sh build

源码目录首次运行或 git pull 后执行 build（macOS 双击 build.command，Windows 运行 build.bat），增量构建成功后自动启动。日常使用 start.command / start.sh / start.bat：只启动已安装镜像，已运行时重新打开工作台，不编译代码或镜像。Release 完整包直接使用 start。默认地址为 https://localhost:8097。首次源码构建需要获取基础镜像与依赖，详见标准启动器接口。

macOS 独立应用：源码版可双击 desktop.command 编译并打开 ~/Applications/Aide.app，保留原工作台界面，使用应用内标签、系统菜单和文件面板。之后日常 start.command 打开已编译应用；build.command 更新镜像及桌面宿主。后台服务与 Safari 共用，退出窗口不会停止后台任务。详见 Mac 独立窗口。

macOS 发布包首次启动：当前 ZIP 尚未使用 Apple Developer ID 签名并公证，Safari 下载后可能被 Gatekeeper 拦截。仅在确认文件来自 aide 官方 Release 且未被篡改后，先尝试运行一次 start.command，再打开「系统设置 → 隐私与安全性」，在“安全性”区域选择仍要打开并确认。若系统没有提供“仍要打开”，可在终端切换到解压后的包目录，只移除启动脚本的隔离标记：xattr -d com.apple.quarantine start.command，然后双击启动。不要对来源不明的软件执行此操作。免此提示分发需要配置 Developer ID 签名和 Apple 公证。

本地登录令牌和模型 API Key 是两种凭据。不要分享带令牌的地址或将令牌贴到问题单。普通开发构建可能显示 dev/unknown；正式版本需要构建身份，见发布与维护。

4. 配置模型

打开左下角 模型设置，填写提供商的 Base URL、API Key，添加模型 ID 与上下文窗口，保存当前模型。OpenAI GPT-6 系列自动使用 Responses API；其他模型按提供商兼容接口调用。具体地址、模型名称和费用以你的提供商为准。

“已配置”仅表示配置字段就绪，不代表连接成功。先发送不含私有资料的简短问题确认可用。无模型时文件与命令功能仍可使用。

5. 完成第一项任务

1. 点工作空间卡片，确认当前项目路径；打开右侧 文件。
2. 打开目标文件，选择 附加到任务；补充所需的辅助资料。
3. 在 策略 中选择模型与 Profile，输入目标和验收条件。
4. 先用 对话 理解项目；需要改动时选择 AI 工作流。
5. 检查提案和审查结果，确认后应用文件修改。已有文件须符合附件与版本校验要求。
6. 将建议命令填入命令面板，审阅后手动运行；根据实际输出判断任务是否完成。

本轮发行线的 策略 → 审批 可切换手动或辅助审批；它与模型自动路由分别配置。项目文件 标题栏的星座图标直接打开知识星图。按 F… 文件、C… 代码、S… 会话编号定位后，可将引用插入打开星图时的原会话草稿，不自动发送。操作与验收边界见使用指南和知识星图架构。

详细操作、资料来源、费用、搜索与压缩说明见使用指南。

数据与运行环境

启动器首次迁移会校验旧卷全部普通文件的内容、权限和软链接，保留旧卷。核心配置、会话、保险库及工具用户缓存随启动目录保存，Docker 容器/卷清理不再删除它们；项目自己的 .cache 仍由项目管理。备份、迁移和恢复见启动目录持久化。请通过启动器初始化，不要直接用裸 docker compose up 创建空目录。

Go 服务使用 go:embed 分发前端；前端为原生 JS/CSS，Markdown 解析器随仓库本地分发，无 CDN 和 npm 安装步骤。修改源码后需要重建发布镜像。镜像归档位于 docker-images/，不包含挂载目录和数据卷。

bash scripts/aide.sh status   # 查看服务状态
bash scripts/aide.sh logs     # 查看近期日志
bash scripts/aide.sh test     # 一次性容器中运行 Go race / vet
bash scripts/aide.sh export   # 导出本机 aide:local 镜像
bash scripts/aide.sh stop     # 停止服务，保留数据卷

参与开发

所有开发 Agent 从 AGENTS.md 进入同一个流程：

需求 → 设计 → 实现 → 测试 → 文档 → 清理 → Release

python3 scripts/agent-route.py start my-feature --request "需求与目标"
python3 scripts/agent-route.py check
python3 scripts/agent-route.py verify quick
python3 scripts/agent-route.py audit

支持 Codex、Claude Code、DeepSeek DSH 的项目入口，以及豆包和 WorkBuddy 的显式启动指令。它是仓库开发规范与检查工具，不是产品内的多 Agent 调度功能。客户端适配方式与能力边界见接入说明。

使用边界

• 适用于可信单用户本地工作台，默认端口仅绑定回环地址；不面向公网或多用户托管。
• AI 可以通过读工具读取授权工作区，不能再把“只有显式附件会进入模型”视为保证。
• 文件应用逐文件原子写入，不是跨文件事务；已应用的修改不会因后续失败自动回滚。
• 已支持逐 token SSE 流式输出（chat 模式实时可见）、MCP stdio / Streamable HTTP 只读工具发现/调用，以及终端与知识星图等工作区能力；插件和检索能力以对应协议说明及插件启用状态为准，不代表完整兼容第三方 DSH 插件。
• 上下文与缺失 usage 的 Token 数量为启发式估算；压缩可能丢失细节，重要事实应回查原文件和轨迹。

文档导航

许可与致谢

项目使用 MIT License。本地分发的第三方组件保留各自许可证。感谢 DeepSeek Harness 提供设计参考。

内置鲸鱼娘背景

设置 → 外观 → 工作台背景 → 鲸鱼娘，可直接选择随应用内置的静音循环视频，无需上传。默认仍关闭，原有强度调节、本地素材与后台/锁屏/减少动态效果暂停规则保留。实际截图与实现边界。

插件独立建库、独立发布，从插件市场或 ZIP 显式安装；Aide 不携带、预装或同步插件源码。安装状态位于已忽略的 plugins/，主程序更新不会覆盖插件。已有克隆首次拉取该变更前，请先按一次性迁移说明备份并保留本地插件升级。

文档有效性与版本

README 概述源码当前记录的产品能力；具体发行包是否包含某项能力，以同版本的 Release 说明和发行收据为准。不要把候选构建、静态截图或本地验收描述成正式发行结果。

工作台截图的历史采集基线为源码 0fef6411（2026-10-17），来自带专用示例数据的隔离实例；截图不代表最新界面，也不等于生产或发行验收。更多截图证据和验证范围、界面演示手册与当前交互设计。

日常启动配置以 .env 为准：start.command → scripts/aide.sh → Docker Compose，读取 AIDE_PORT（默认 8097）和 COMPOSE_FILE。临时验收端口不是用户启动入口。目录范围与 macOS 共享根模式见工作目录配置。