claude-ace

skill
Guvenlik Denetimi
Basarisiz
Health Uyari
  • No license — Repository has no license file
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Basarisiz
  • process.env — Environment variable access in benchmarks/bench_glm.js
  • process.env — Environment variable access in benchmarks/full_bench.js
  • execSync — Synchronous shell command execution in benchmarks/quality_bench.js
  • process.env — Environment variable access in benchmarks/quality_bench.js
  • fs.rmSync — Destructive file system operation in benchmarks/test_v020.js
  • fs.rmSync — Destructive file system operation in benchmarks/test_v030.js
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

Claude省钱版 — 效果基本一致的情况下可以节约Token消耗约90%,超级省Token,支持OpenAI及国产大模型(DeepSeek/GLM/通义千问)的AI编程助手。本项目基于ClaudeCode源码实现。

README.md

Claude-ACE (Claude 省钱版)

节约 90% Token 消耗,支持 OpenAI 及国产大模型接口的下一代 AI 编程助手。

Claude-ACE (Adaptive Context Engine) 是一个从第一性原理出发构建的 AI 编程助手。它以 Anthropic 官方发布的 Claude Code 源码为基线进行深度重构,通过引入活体语义图谱自我修复能力意图验证闭环等机制,彻底解决了传统 AI 编程助手过度消耗 Token、强绑定单一模型等痛点。

Claude-ACE Startup


🎯 核心亮点

💰 极致省钱:Token 消耗直降 90%

彻底抛弃低效的文本全量读取(Grep/Cat),使用 Tree-sitter 提取代码的 AST 骨架,并通过 ExpandSymbolTool 实现"按需展开"。

Token Saving Strategies

详细 Token 节约对照表 (实测数据)

任务场景 传统全量读取 (Claude Code) Claude-ACE (骨架+按需展开) 节约比例
理解大文件架构 (2000行) ~4,500 tokens ~450 tokens ~90%
查找特定函数逻辑 2,521 tokens 1,106 tokens 56.1%
理解模块职责 2,497 tokens 849 tokens 66.0%
处理超大复杂文件 (1144行) 182,843 tokens 28,372 tokens 84.5%

注:文件越大,骨架压缩比越高,节约效果越明显。

🌐 模型自由:支持 OpenAI 与国产大模型

不再强绑定 Anthropic 的 Claude 模型。Claude-ACE 默认支持任何兼容 OpenAI API 格式的大模型接口,让你自由选择性价比最高的模型。

支持的模型提供商及配置参考

提供商 申请地址 环境变量 OPENAI_BASE_URL 推荐模型 (OPENAI_MODEL)
智谱 GLM 申请 API Key https://open.bigmodel.cn/api/paas/v4/ glm-5-turbo (推荐) / glm-4-flash (免费)
通义千问 申请 API Key https://dashscope.aliyuncs.com/compatible-mode/v1 qwen-turbo / qwen-max / qwen-coder-plus
DeepSeek 申请 API Key https://api.deepseek.com/v1 deepseek-chat / deepseek-reasoner
MiniMax 申请 API Key https://api.minimax.chat/v1 MiniMax-Text-01 / abab6.5s-chat
Kimi 申请 API Key https://api.moonshot.cn/v1 moonshot-v1-8k / moonshot-v1-32k
OpenAI 申请 API Key https://api.openai.com/v1 gpt-4o-mini / gpt-4o

✨ 首次启动配置向导
Claude-ACE v0.8.4 引入了交互式配置向导。首次启动时,系统会引导你一次性填写所有想使用的提供商的 API Key。
Key 会被安全地持久化保存到 ~/.ace-keys.json 中,重启后自动加载,无需重复配置。

🔄 无缝切换模型
配置完成后,在运行中随时输入 /model <模型名称>(例如 /model deepseek-chat),系统会自动加载对应提供商的 Key 和 Base URL,立即生效,无需重启
如果需要更新或补充 Key,随时输入 /setup 即可重新进入配置向导。


🚀 五大核心能力 (v0.7.0 完整集成)

维度 Claude Code Claude-ACE 核心突破
一:上下文理解 文本检索 (Grep/Glob) 活体系统语义图谱 AST 骨架 + 按需展开 + CallGraph 蝴蝶效应分析,Token 直降 90%
二:运行模式 被动唤醒的 REPL 主动演化与自我修复 后台 Watchdog 守护进程,真实运行 npm test 并自动修复
三:代码生成 直接修改 → 报错 → 重试 意图驱动的验证闭环 意图 → 测试 → 实现 → 自愈,骨架失败自动降级全量上下文
四:架构思维 顺从的"打字员" 批判性思维架构师 CriticalArchitect 拒绝糟糕设计,主动提供安全/性能更优的建议
五:知识积累 仅限当前项目上下文 跨维度工程直觉 CrossProjectMemory 持久化跨项目记忆 + 三问质量门控

🛠️ 快速开始

环境要求

  • Node.js >= 18
  • 兼容 OpenAI 格式的 API Key

安装与运行

# 1. 克隆仓库
git clone https://github.com/OpenDemon/claude-ace.git
cd claude-ace

# 2. 安装依赖并注册全局命令
npm install
npm link

# 3. 启动 Claude-ACE(之后在任意目录均可直接运行)
ace

注:首次启动会自动弹出配置向导,引导你填写 API Key。启动时会自动检测 Key 的连通性,如果失效会立即提示更新。你也可以随时通过设置环境变量 OPENAI_API_KEYOPENAI_BASE_URLOPENAI_MODEL 来覆盖默认配置。

丰富的斜杠命令菜单

Claude-ACE 提供了对标 Claude Code 的完整 TUI 交互体验,输入 / 即可弹出交互式菜单:

Slash Commands


📚 架构设计

Claude-ACE 的核心架构分为三层,共 10 个核心工具:

┌─────────────────────────────────────────────────────────────┐
│                    Claude-ACE Agent Loop                    │
├──────────────────┬──────────────────┬───────────────────────┤
│  感知层           │  决策层           │   执行层              │
│  (Perception)    │  (Reasoning)     │   (Execution)         │
│                  │                  │                       │
│ SemanticSearch   │ CriticalArchitect│ IntentVerify          │
│ FileRead (ACE)   │ CrossProjectMemory  BashTool             │
│ ExpandSymbol     │ WatchdogAgent    │ FileWrite             │
│ CallGraph        │                  │ GrepTool              │
└──────────────────┴──────────────────┴───────────────────────┘
  1. 感知层 (Perception):将物理文件转化为结构化语义图谱,支持按需展开和调用图(Call Graph)影响分析。
  2. 决策层 (Reasoning):在修改代码前进行架构评估,并检索高质量的历史调试经验。
  3. 执行层 (Execution):基于意图生成测试,代码必须通过测试才会被接受;后台 Watchdog 持续守护代码库健康。

📝 版本历史

v0.8.4(当前版本)

  • 全局 ace 命令:支持通过 npm link 注册全局命令,在任意目录直接输入 ace 即可启动。
  • 启动时静默连通性检测:启动时自动检测已保存 Key 的有效性,遇到 401/402 错误立即引导用户更新,避免等到第一次对话才报错。
  • Worker Thread 架构:Agent 移至独立线程运行,主线程始终保持响应。支持在 Agent 执行任务期间输入新指令(如按 Ctrl+C 取消当前任务)。
  • 首次启动配置向导:自动引导填写各提供商 API Key,持久化保存至 ~/.ace-keys.json,重启自动加载。
  • 无缝模型切换/model 命令切换模型时自动加载对应提供商的 Key,彻底解决 Key 混用导致的 401 错误。
  • 新增 /setup 命令:随时重新配置任意提供商的 API Key。
  • 全面扩展国产模型支持:内置通义千问、DeepSeek、MiniMax、Kimi 等主流国产模型配置。

v0.7.0

  • 完整 CLI 体验:补全 19 个斜杠命令(/status, /skills, /resume, /memory, /watchdog, /callgraph, /model, /compact, /export, /init, /doctor, /cost 等)。
  • 会话持久化:启动界面展示 Recent Activity,支持本地保存、恢复和重命名对话。
  • 流式交互:打字机效果输出,Markdown 实时渲染与代码高亮。

v0.3.0

  • 全面集成:10 个核心工具全部接入 Agent 主流程,五大维度形成完整闭环。
  • 新增 CallGraphTool:基于 AST 的调用图分析,支持 calleescallersimpact(蝴蝶效应分析)。
  • 升级 WatchdogAgent:真实运行 npm testeslint,自动捕获并修复真实错误。

v0.2.0

  • 新增 ExpandSymbolTool:骨架模式下按需展开任意函数完整实现,防止幻觉。
  • 升级 IntentVerificationTool:新增 Fallback 策略,骨架失败自动降级为全量上下文。
  • 升级 CrossProjectMemory:引入三问质量门控机制,拒绝通用知识,只存高价值经验。

v0.1.0

  • 五大维度初始原型实现。
  • 真实 LLM API 回测:Token 消耗降低 84.5%。

🤝 致谢


📄 许可证

MIT License


Built with ❤️ by OpenDemon

Yorumlar (0)

Sonuc bulunamadi