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 流水线中。