wk42worldworld/cybercode

整合 Claude Code 编程能力与 Hermes Agent 自进化能力的智能体 / An AI agent combining Claude Code coding capabilities with Hermes Agent self-evolution.

CyberCode – 本地執行的 Claude 風格程式助手

是什麼 – CyberCode 是一個基於 Claude Code 互動模型的開源 AI 代理平台。它完全在你的機器上運行，可與任何 Anthropic 相容 API（MiniMax、OpenRouter 等）通訊，並提供遠超簡單對話的全套功能：

功能	你將獲得
永久記憶與自我進化	代理會記住過去的專案，提取穩定的「技能」並允許你編輯或刪除這些知識。
多模態 UI	全螢幕 TUI（Ink）、跨平台桌面 GUI（Tauri + React），以及透過 Telegram、Feishu（和 Discord）進行遠端控制。
電腦操作	代理可操作 macOS 或 Windows GUI，執行終端指令、編輯檔案，並管理 Git worktree。
模型無關	可接入任何 Anthropic 相容端點、OpenAI 相容服務或本地模型。內建模型路由、健康檢查及自動降級至本地 WebSearch 的功能。
上下文優化	自動進行令牌預算管理（清理、智能截斷、壓縮層），並提供透明 UI 顯示預估節省量。
本地程式圖	索引符號、匯入、呼叫關係，讓代理可查詢此圖以提供簡潔、相關的程式上下文。
排程與後台任務	支援一次性或重複性任務，即使你離開也能執行，還提供「無頭」`--print` 模式用於 CI 流水線。
可擴展性	支援插件、技能、多代理編排，以及用於自訂工具的 MCP 伺服器。

快速開始（CLI）

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/wk42worldworld/cybercode/main/scripts/install-cli.sh | bash
# Windows PowerShell
irm https://raw.githubusercontent.com/wk42worldworld/cybercode/main/scripts/install-cli.ps1 | iex

安裝程式會拉取最新穩定版二進位檔，如需則安裝 Bun，並將 cybercode 命令新增至你的 PATH（無需管理員權限）。

常用命令：

命令	用途
`cybercode`	在目前專案資料夾中啟動互動式會話
`cybercode "Explain this repo"`	一次性任務，完成後退出
`cybercode -p "Fix failing test"`	無頭模式，輸出 JSON 友好結果
`cybercode -c`	繼續最近一次會話
`cybercode -r`	選擇並恢復一個已儲存的會話
`cybercode --model <model>`	為本次執行選擇特定模型
`cybercode -w <feature-name>`	為會話建立隔離的 Git worktree
`cybercode plugin …`	管理插件
`cybercode doctor`	診斷環境問題

桌面應用程式

使用 Tauri 2 + React 建構。 從 發行頁面 下載適用於你系統的安裝檔（macOS Apple Silicon、macOS Intel、Windows x64、Linux x64）。GUI 提供：

專案選擇器與多會話標籤頁
提供者與模型選擇面板
程式圖探索器（符號搜尋、架構檢視、檔案索引）
令牌優化儀表板
定時任務管理器
檔案編輯或命令執行的即時權限提示

遠端控制

Telegram 和 Feishu 适配器允許同一代理在伺服器上以無頭模式執行，並透過聊天客戶端進行控制。當你離開工作台時，非常適合執行長時間重構或 CI 風格的自動化任務。

可擴展性

技能 – 可重用的使用者定義工具包，代理可呼叫。
插件 – 即插即用的套件，用於新增命令或 UI 面板。
MCP 伺服器 – 將本地代理公開為 OpenAI/Anthropic 相容端點（cc_… 節點鍵），供其他工具呼叫。
代理團隊 – 協調多個子代理並行工作。

從原始碼開始

如果你更傾向於從原始碼執行（例如開發桌面 UI）：

# 安裝 Bun（執行時與套件管理器）
curl -fsSL https://bun.sh/install | bash   # macOS/Linux
# 或 Homebrew: brew install bun
# Windows PowerShell: powershell -c "irm bun.sh/install.ps1 | iex"

bun install               # 安裝相依性
cp .env.example .env      # 新增你的 API 金鑰
./bin/cybercode           # TUI 模式
# 或啟動伺服器 + 桌面 UI 用於開發
SERVER_PORT=3456 bun run src/server/index.ts
cd desktop && bun run dev --host 127.0.0.1 --port 2024

文件（在 README 中連結）詳細介紹了每個功能、環境變數設定以及遷移/可攜式 USB 工作流程。

誰會使用 CyberCode？

個人開發者：希望擁有能跨會話記住程式碼庫的 AI 合作夥伴。
團隊：需要一個自托管、廠商無關的助手（避免被 Anthropic 鎖定）。
研究人員：在真實程式碼工作流程中探索記憶、自我進化或多代理編排。
自動化工程師：希望排程程式碼維護任務或將 AI 集成到 CI 流水線中。