aionclaw处理大项目时触发“100% context used”是因代码批量注入挤占全部token预算,必须启用智能项目图谱加载(第一步确认元数据文件、第二步执行/graph enable、第三步验证/ls --related-to)、配置分级上下文裁剪(.clawignore排除或/context depth限制)及拆分任务并建立接续文件(/save-context与/load-context)。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

项目太大时AionClaw频繁提示“100% context used”,说明代码文件批量注入已挤占全部token预算,必须主动分批加载关键上下文,否则/edit、/read等指令会直接失败或返回截断内容。
启用智能项目图谱加载
这是最优先启用的机制,它让AionClaw不再扫描整个仓库,而是根据依赖关系动态识别当前任务真正需要的文件。
第一步:确认项目根目录存在有效元数据文件,如pyproject.toml(Python)、package.json(Node.js)或Cargo.toml(Rust),缺失会导致图谱引擎无法初始化。
第二步:在AionClaw会话中输入/graph enable并回车,执行后将自动构建模块依赖快照,耗时约3~8秒,期间不要发送其他指令。
第三步:运行/ls --related-to src/main.py验证是否只列出被main.py直接引用的模块——若返回上百个无关文件,说明图谱未生效,需检查元数据文件语法是否正确或是否存在多入口配置冲突。
后续所有/read和/edit操作将默认遵循该图谱路径,未命中依赖链的文件不会自动载入上下文,【这一步不执行,后续所有分批策略都将失效】。
配置分级上下文裁剪
当图谱加载后仍超限,需人工指定哪些层级可压缩。AionClaw支持按文件类型、路径深度、修改时间三类维度裁剪。
方法一:按文件类型排除非核心文件
在项目根目录新建.clawignore文件,逐行写入要跳过的类型,例如:
*.md
__pycache__/
node_modules/
dist/
注意:.clawignore语法兼容Git风格,但不支持!反向规则,写错会导致整层目录被误删。
方法二:按路径深度限制加载层数
执行/context depth 3,强制AionClaw只加载从src/开始向下最多3级的子目录,如src/api/v1/auth.py会被加载,但src/api/v1/utils/helpers.py将被跳过。
拆分任务并建立接续文件
适合重构类长周期任务,把一个大需求拆成若干小任务,每个任务聚焦单个功能模块,并通过接续文件传递上下文状态。
① 在首次任务中执行/edit src/payment/processor.py完成核心逻辑修改后,运行/save-context payment_flow_v2,该命令会将当前上下文快照保存为命名片段。
② 进入下一个任务前,先执行/load-context payment_flow_v2,AionClaw会自动恢复上一次的代码片段、变量名、注释习惯等上下文特征,无需重新加载整个模块。
③ 接续文件默认存储在~/.aionclaw/context/下,不可手动编辑,【删除该目录将永久丢失所有已保存的上下文片段】。











