aionclaw可基于结构完整、权限到位、模型匹配的技术文档实现端到端开发执行；需导入文字型pdf等格式文档，待索引完成后，通过直接指令、分步确认或角色绑定方式触发任务，并授权磁盘访问、验证代码与服务运行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让AI智能体读取项目文档后，自动完成代码编写、环境配置、参数调试等一整套开发流程，而不是只做文字总结或问答。AionClaw在实测中已验证可基于技术文档完成端到端执行，关键在于文档结构是否完整、权限是否到位、模型选择是否匹配。
确认文档可被AionClaw识别和解析
打开AionClaw客户端，点击左上角「文件」→「导入文档」，支持PDF、Markdown、Word、TXT格式。注意：纯扫描版PDF（图片型）无法提取文字，会跳过解析，【必须是文字可复制的PDF】。
导入后等待右下角状态栏显示“文档已索引完成”，此时文档内容已加载进本地向量库，可被Hermes引擎实时调用。
触发开发任务的三种指令写法
方法一：直接指令型
在主对话框输入：“根据刚导入的《订单中心API设计文档》，生成Python FastAPI服务脚手架，包含路由定义、Pydantic模型、mock数据返回逻辑。”
方法二：分步确认型
第一步：说“请分析这份文档的技术栈、接口规范和依赖要求”；
第二步：等它输出结构化摘要后，再发指令：“按摘要中的Flask+SQLite方案，生成完整可运行的app.py和config.py”。
方法三：角色绑定型
输入：“你现在是资深后端工程师，熟悉文档里的微服务架构。请基于该文档，写出Dockerfile、requirements.txt，并在本地启动容器验证接口可用性。”
这一步操作起来很简单，直接把文件拖进去就行。但要注意：如果文档里混有大量模糊截图、手写批注或加密表格，Hermes引擎可能跳过对应段落，导致生成代码缺失关键字段。
执行过程中的关键干预点
第一步：当AionClaw开始写代码时，观察右上角「执行日志」面板——它会实时显示正在调用哪个大模型、是否申请了文件读写权限、是否尝试打开终端或VS Code。
第二步：若日志中出现“权限拒绝：无法写入./src”字样，立即点击弹出的系统授权窗口，勾选「完全磁盘访问」并确认。macOS用户尤其容易卡在这步，【不授权则代码生成后无法保存到本地】。
第三步：生成完成后，它会自动在内置终端运行pip install -r requirements.txt。如遇包冲突，界面会弹出「推荐修复方案」按钮，点击即可替换为兼容版本。
验证结果是否真正可运行
执行完代码生成后，不要只看它返回的代码片段。必须点开左侧「项目管理器」，找到生成的文件夹，双击打开main.py或app.py，检查顶部是否有真实import语句、路由路径是否与文档一致、mock数据是否覆盖了文档列出的全部status code。
最后，在终端里手动执行python main.py，观察控制台是否输出“Uvicorn running on http://127.0.0.1:8000”。能访问且返回JSON，才算闭环完成。
