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 測試失敗的原因，修復錯誤，執行測試套件，並以簽署提交方式提交變更。」
研究與報告	「收集關於 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 代理領域軟體專案。