jmylchreest/aide
GitHub: jmylchreest/aide
AIDE 为 AI 编程助手提供持久化记忆、架构决策管理、代码索引和多智能体编排，让跨会话开发更连贯高效。
Stars: 11 | Forks: 3
# AIDE - AI 开发环境
为 AI 编程助手提供持久化记忆、代码智能和多智能体编排。兼容 **Claude Code**、**OpenCode** 和 **Codex CLI**。
## 安装说明
**Claude Code:**
```
claude plugin marketplace add jmylchreest/aide
claude plugin install aide@aide
```
**OpenCode:**
```
bunx @jmylchreest/aide-plugin install
```
**Codex CLI:**
```
codex plugin marketplace add jmylchreest/aide
codex plugin add aide@aide
bunx @jmylchreest/aide-plugin install --platform codex # hooks only — Codex has no plugin hook support
```
## 功能特性
| 功能 | 作用 |
| ------------------- | -------------------------------------------------------------------------------- |
| **记忆 (Memory)** | 跨会话记住偏好和上下文 |
| **决策 (Decisions)** | 记录架构选择，并在每个会话中强制执行 |
| **蓝图** | 为 Go、Rust、GitHub Actions 等预置最佳实践决策 |
| **代码索引** | 通过 tree-sitter 实现快速符号搜索、调用图和引用 |
| **静态分析** | 检测复杂度、耦合度、机密信息和代码重复 |
| **概览** | 映射代码库结构：模块、入口点、技术栈、变动热点 |
| **技能** | 通过自然语言触发的 23 个内置工作流 |
| **Swarm** | 具有完整 SDLC 流水线（设计、测试、实现、验证、文档）的并行智能体 |
| **34 个 MCP 工具** | 对上述所有功能的完全编程访问权限 |
## 快速开始
### 现有项目 —— 了解代码库：
```
Survey this codebase and help me understand its structure.
```
AIDE 会索引符号，发现模块、技术栈、入口点和 git 变动热点，然后呈现全局概览。[完整指南](docs/docs/getting-started/existing-project.md)
### 新项目 —— 设置防护机制：
使用精选的最佳实践进行引导，然后进行自定义：
```
aide blueprint import go go-github-actions # seeds decisions from blueprints
aide blueprint import --detect # or auto-detect from project markers
```
然后使用 `decide` 技能针对特定项目选择进行细化：
```
Help me decide on the auth strategy and database schema for this project.
```
蓝图涵盖语言惯用法、工具链、CI/CD 和常见陷阱。`decide` 技能处理特定于项目的架构选择。两者都会在未来的所有会话中持久保存。[完整指南](docs/docs/getting-started/new-project.md)
### 与团队共享决策：
将决策和记忆导出为对 git 友好的 markdown，然后提交它们：
```
aide share export # writes to .aide/shared/
git add .aide/shared && git commit -m "share: team decisions"
```
将 `AIDE_SHARE_AUTO_IMPORT=1` 添加到 `.claude/settings.json` 的团队成员会在会话开始时自动导入它们。决策按主题采用追加模式（新的优先，保留历史记录）；记忆通过 ULID 合并（最新编辑生效）。
**未安装 AIDE 的队友仍然可以使用该文件夹。** 每个 `.aide/shared/decisions/*.md` 和 `.aide/shared/memories/*.md` 都是带有结构化 frontmatter 的独立 markdown —— 任何 AI 助手都可以将它们作为上下文摄取。导出文件旁会附带一个简短的 `DECISIONS.md` / `MEMORIES.md` 说明文档，用于记录格式。[完整指南](docs/docs/reference/storage.md#import-conflict-resolution)
## 技能
技能是由关键词触发的 markdown 工作流。自然输入 —— 触发匹配是模糊的。
| 技能 | 示例提示词 | 执行内容 |
| -------------------- | --------------------------------------- | ------------------------------------------------------ |
| **swarm** | `swarm 3 implement dashboard` | 具有每个故事 SDLC 流水线的并行智能体 |
| **plan-swarm** | `plan swarm for the dashboard` | 将工作分解为故事以供 swarm 执行 |
| **decide** | `help me decide on auth strategy` | 结构化决策访谈，记录选择 |
| **design** | `design the auth system` | 包含接口和验收标准的技术规范 |
| **survey** | `survey this codebase` | 映射模块、技术栈、入口点和变动 |
| **test** | `write tests for auth` | 带有覆盖率验证的测试套件 |
| **implement** | `implement the feature` | TDD —— 使失败的测试通过 |
| **verify** | `verify the implementation` | 完整的 QA：测试、lint、类型、构建、调试工件 |
| **docs** | `update the documentation` | 更新文档以匹配实现 |
| **autopilot** | `autopilot fix all failing tests` | 持久执行 —— 直到验证完成才会停止 |
| **build-fix** | `fix the build errors` | 迭代修复构建/lint/类型错误 |
| **debug** | `debug why login fails` | 带有假设检验的系统化调试 |
| **perf** | `optimize the API` | 性能分析和优化 |
| **review** | `review this PR` | 专注于安全的代码审查 |
| **patterns** | `check code health` | 通过静态分析揭示代码质量问题 |
| **assess-findings** | `assess findings` | 分流：阅读代码，接受噪音，保留实际问题 |
| **code-search** | `find all auth functions` | 搜索符号，查找调用点 |
| **memorise** | `remember I prefer vitest` | 为未来的会话存储信息 |
| **recall** | `do you remember the testing decision?` | 搜索记忆和决策 |
| **forget** | `forget the old auth decision` | 软删除或硬删除记忆 |
| **git** | `create a worktree for this feature` | Git 操作和 worktree 管理 |
| **worktree-resolve** | `merge worktrees` | 通过冲突解决合并 worktree 分支 |
| **context-usage** | `how much context am I using?` | 分析会话上下文和 token 使用量 |
**自定义技能：** 创建带有 YAML frontmatter（`name`、`triggers`）和 markdown 正文的 `.aide/skills/my-skill.md`。自动发现顺序为：`.aide/skills/` > `skills/` > 插件内置 > `~/.aide/skills/`。
## 配置
| 变量 | 描述 |
| -------------------------------- | ------------------------------------------------ |
| `AIDE_DEBUG=1` | 启用调试日志（记录到 `.aide/_logs/`） |
| `AIDE_FORCE_INIT=1` | 在非 git 目录中强制初始化 |
| `AIDE_CODE_WATCH=1` | 启用文件监视以自动重新索引 |
| `AIDE_CODE_WATCH_DELAY=30s` | 文件更改后重新索引之前的延迟 |
| `AIDE_INDEX_NON_VCS=1` | 允许在非 VCS 目录中进行监视/索引（默认：拒绝） |
| `AIDE_INDEX_WORKERS=N` | 用于代码索引的并行解析器工作进程（默认：NumCPU，上限为 32） |
| `AIDE_MEMORY_INJECT=0` | 禁用记忆注入 |
| `AIDE_MEMORY_SCORING_DISABLED=1` | 禁用记忆评分（使用时间顺序） |
| `AIDE_MEMORY_DECAY_DISABLED=1` | 禁用记忆评分中的近因衰减 |
| `AIDE_SHARE_AUTO_IMPORT=1` | 启动时自动导入共享的决策/记忆 |
## CLI 参考
```
aide status # System dashboard
aide code index # Index codebase symbols
aide code search "getUser" # Search symbols
aide survey run # Map codebase structure
aide findings run all # Run all static analysers
aide findings stats # Health overview
aide findings list --severity=critical # View critical findings
aide version # Check binary version
```
## aide-web
用于监控 aide daemon 实例的可选 Web 仪表板 —— 状态、记忆、决策、发现、代码搜索等。
**下载：** [最新发布](https://github.com/jmylchreest/aide/releases/latest)
| 平台 | 文件 |
| -------- | ------ |
| Linux x64 | [aide-web-linux-amd64](https://github.com/jmylchreest/aide/releases/latest/download/aide-web-linux-amd64) |
| Linux arm64 | [aide-web-linux-arm64](https://github.com/jmylchreest/aide/releases/latest/download/aide-web-linux-arm64) |
| macOS x64 | [aide-web-darwin-amd64](https://github.com/jmylchreest/aide/releases/latest/download/aide-web-darwin-amd64) |
| macOS arm64 | [aide-web-darwin-arm64](https://github.com/jmylchreest/aide/releases/latest/download/aide-web-darwin-arm64) |
| Windows x64 | [aide-web-windows-amd64.exe](https://github.com/jmylchreest/aide/releases/latest/download/aide-web-windows-amd64.exe) |
| Windows arm64 | [aide-web-windows-arm64.exe](https://github.com/jmylchreest/aide/releases/latest/download/aide-web-windows-arm64.exe) |
```
aide-web --port 8080 --open
```
## 文档
完整文档：**[jmylchreest.github.io/aide](https://jmylchreest.github.io/aide/)**
- [架构](https://jmylchreest.github.io/aide/docs/reference/architecture) — 分层设计、hooks、MCP 读写分离
- [MCP 工具](https://jmylchreest.github.io/aide/docs/reference/mcp-tools) — 全部 34 个工具：memory、decisions、code、findings、survey、tasks、tokens
- [CLI 参考](https://jmylchreest.github.io/aide/docs/reference/cli) — 完整的命令参考
- [Swarm 模式](https://jmylchreest.github.io/aide/docs/modes/swarm) — SDLC 流水线、worktree、智能体协调
- [技能](https://jmylchreest.github.io/aide/docs/skills) — 内置和自定义技能参考
- [存储](https://jmylchreest.github.io/aide/docs/reference/storage) — 文件布局，通过 git 共享
## 高级安装
### Claude Code — 面向团队的 Marketplace
在 `~/.claude/settings.json`（或用于项目级别的 `.claude/settings.json`）中注册 marketplace，以便提示团队成员进行安装：
```
{
"extraKnownMarketplaces": {
"aide": {
"source": {
"source": "github",
"repo": "jmylchreest/aide"
}
}
}
}
```
### Claude Code — 权限
添加到 `~/.claude/settings.json`：
```
{
"permissions": {
"allow": [
"Bash(aide *)",
"Bash(**/aide *)",
"Bash(git worktree *)",
"mcp__plugin_aide_aide__*"
]
}
}
```
### 从源码构建
```
git clone https://github.com/jmylchreest/aide && cd aide
# 构建（需要 Go 1.25+ 和 Bun）
cd aide && go build -o ../bin/aide ./cmd/aide && cd ..
bun install && bun run build
# Claude Code
claude --plugin-dir /path/to/aide
# OpenCode
bunx @jmylchreest/aide-plugin install --project
```
## 故障排除
```
aide version # Check binary
aide status # Full system dashboard
AIDE_DEBUG=1 claude # Debug logging (or AIDE_DEBUG=1 opencode)
```
**重新安装：**
```
# Claude Code
claude plugin uninstall aide && claude plugin install aide@aide
# OpenCode
bunx @jmylchreest/aide-plugin uninstall && bunx @jmylchreest/aide-plugin install
```
## 许可证
MIT
标签：EVTX分析, 日志审计