必须先将本地代码项目按要求导入agentspace：根目录需含pom.xml、pyproject.toml、requirements.txt或package.json等工程标识文件，再通过拖拽上传或路径绑定方式添加，最后执行refresh index并点击initialize agent完成初始化。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 AgentSpace 中使用本地已有的代码项目并让智能体理解其结构与逻辑，必须先将项目以可识别的方式导入平台环境，否则 Agent 无法读取源码、分析依赖或执行调试类任务。
确认项目结构是否符合 AgentSpace 要求
AgentSpace 不接受任意压缩包或裸文件夹。它要求项目根目录下存在明确的工程标识文件，例如 【pom.xml（Maven）】、【pyproject.toml 或 requirements.txt（Python）】、【package.json（Node.js）】。若缺失这些文件，AgentSpace 可能跳过扫描或报“未检测到有效项目”。
这一步不能跳过——没有构建标识，AgentSpace 不会启动代码索引，后续所有“解读项目”“生成文档”“调试建议”功能均失效。
通过 AgentSpace UI 上传本地项目
方法一：拖拽上传（推荐用于中小型项目）
打开 AgentSpace 工作区 → 点击左侧面板「Projects」→ 点击「+ Add Project」→ 将整个项目文件夹直接拖入虚线框内 → 等待状态条变为绿色「Indexed」。
注意：拖入的是文件夹本身，不是 zip 包；若拖入后无反应，检查浏览器是否禁用了文件拖放权限。
方法二：路径绑定（适用于大项目或需频繁更新的开发态）
点击「+ Add Project」→ 选择「Link Local Folder」→ 在弹出系统对话框中定位到项目根目录 → 勾选「Auto-sync on file change」→ 点击「Confirm」。
这一步成功后，AgentSpace 会在后台持续监听该路径下的增删改操作，无需重复上传。但首次同步可能耗时较长，尤其含 node_modules 或 .git 目录时，建议提前在设置中排除这些目录。
触发项目解析与智能体初始化
第一步：在项目卡片上点击「⋯」→ 选择「Refresh Index」强制重扫文件结构。
第二步：等待右上角提示「Indexing complete (127 files)」→ 此时点击项目名称进入详情页。
第三步：在详情页底部找到「Initialize Agent」按钮 → 点击后选择预设角色，例如「Backend Engineer」或「Code Reviewer」→ 确认。
这一步完成后，Agent 才真正加载了项目上下文。此时在聊天框输入“这个项目的主入口是哪个文件”，它才能准确定位到 src/main/java/com/example/App.java 或 index.ts 等真实路径。若跳过初始化，所有提问都只会得到泛泛而谈的通用回答。
