taracodlabs/aiden

Aiden — Autonomous AI agent that operates your computer with prompts: browser control, terminal execution, workflows, tools, recovery systems, and persistent memory. Built solo. AGPL-3.0.

Aiden – 自主 AI 工作引擎

是什么 – Aiden 是一个开源的基于 Node 的 AI 代理，能够接收高层次目标（例如："修复此仓库中的失败测试" 或 "研究一个主题并撰写报告"），并在您自己的机器上执行完整的流程。它会规划、运行命令、与浏览器交互、调用 API、操作文件和 Git 仓库，并最终生成可验证的成果证明。所有这些都在一个 TUI/CLI 界面中完成，让您能够批准高风险步骤、设置预算，并检查持久化的操作日志。

为何重要 – 大多数基于聊天的工具仅停留在提供建议。Aiden 桥接了 "我该做什么？" 和 "帮我做吧" 之间的鸿沟，同时保持您对流程的控制权并提供审计追踪。它被设计为一个通用的“工作者”，可无缝集成到任何开发或自动化环境中。

核心功能

功能	说明
目标到执行	接收自然语言目标，创建多步骤计划，并在操作系统、终端、浏览器、API 和版本控制系统中执行。
持久状态与证据	每个操作都以 Job → Attempt → Effect → Evidence → Verification → Proof 链的形式记录在 SQLite 中，支持崩溃后恢复并可后续验证结果。
风险分级审批	可设置信任等级（观察者/助手/伙伴），在执行破坏性操作（如提交代码、发送网络请求）前需明确批准。
多提供商 LLM 支持	支持 OpenAI、Anthropic、Google Gemini、Groq、Ollama 及任何自定义端点（BYOK）。
子代理	大型任务可拆分为独立子代理，其输出必须经过验证后才能被接受。
守护进程 / 触发器	可选后台模式，可监控文件、定时任务、邮件或 Webhook，并自动启动自主运行。
丰富通道	可通过内置 TUI、Discord、Slack、Telegram、邮件或通用 Webhook 进行交互。
代码库模式	拍摄仓库快照，分析其结构，安全地修改文件，运行测试/构建，并将 Git 操作记录为可验证的效应。
工作台 UI	基于 Web 的工作台（`aiden web`）允许您设计可视化、类型化的流程，编译为相同的执行契约。

技术栈

语言 / 运行时 – TypeScript 5，目标为 Node 20/22，以 ESM npm 包（aiden-runtime）形式发布。
打包器 – esbuild。
持久化 – 通过 better-sqlite3 使用 SQLite 与 FTS5。
浏览器自动化 – Playwright（无头 Chromium）。
容器沙箱 – 可选 Docker 支持，用于隔离运行。
通信 – 使用 Server-Sent Events (SSE) 流式输出；支持可选守护进程模式。
模型-上下文协议 (MCP) – 用于一致模型交互的自定义 1.0 协议。
跨平台 – 支持 Windows 11、Linux、WSL 和 macOS（仅 API 模式）。

快速上手（约 60 秒）

# 全局安装运行时
npm install -g aiden-runtime
# 启动交互式 CLI（Operator TUI）
aiden

或不安装直接运行单次实例：

npx aiden-runtime@latest

首次启动会引导您完成快速设置向导，随后进入 REPL，您可以输入目标，例如：

> 研究最新的 Rust 异步模式并输出 Markdown 摘要

您将看到计划，批准任何高权限步骤，最终获得 Markdown 文件和验证日志。

典型使用场景

场景	示例提示
代码库维护	"找出 CI 测试失败的原因，修复 bug，运行测试套件，并以签名提交方式提交更改。"
研究与报告	"收集关于 Transformer 量化最近的论文，比较其结果，并生成结构化报告。"
网页自动化	"登录 example.com，用我的数据填写注册表单，下载确认 PDF 并保存到 ~/Downloads。"
后台自动化	"监视 ~/Inbox 中的新 .txt 文件，并自动将内容摘要到 Google 文档中。"*
多代理编排	"生成 UI 原型，然后让子代理编写 React 组件，最后将两者合并到仓库中。"

成熟度与社区

版本 – 稳定版 v4.21.1（通过 npm latest 发布）。
许可证 – AGPL-3.0（开源，任何修改必须公开源码）。
活跃度 – 每月发布，详细变更日志，活跃的 Discord 社区。
安装体积 – 单个 npm 包，可选 Docker 用于沙箱运行；无重型二进制文件。
已知限制 – 第三方账户连接需手动配置提供者；在极端终端缩放下存在部分视觉问题；Windows 安装包未捆绑（仅运行时）。

快速参考链接

npm 包 – https://www.npmjs.com/package/aiden-runtime
文档 – 仓库中的 docs/v4.5/（涵盖 CLI 命令、模型切换、技能扩展等）
Discord 社区 – https://discord.gg/CU5wshJW4F
发布说明 – 查看 RELEASE-NOTES-v4.21.1.md 及更早标签。

总结 – Aiden 是一个全栈自主 AI 代理，超越聊天模式，让开发者和高级用户只需提出一个目标，即可在自己的机器上执行可验证、可恢复的流程。它是一个真正、持续维护的 AI 代理领域软件项目。