在Agent.Space平台让Agent自主修改文件，需确保Workspace已同步、选用支持编辑的Agent与匹配模型，并按三步法发起带作用域、具体动作和变更摘要的任务，最后手动提交更改。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在 Agent.Space 平台上让 Agent 自主修改项目文件，需确保 Workspace 已正确加载、Agent 具备环境感知能力且任务指令边界清晰——否则 Agent 可能读错文件路径、跳过关键配置或覆盖未声明的生产文件。
确认 Workspace 状态与文件可见性
登录 Agent.Space 后，进入目标 Workspace，检查左侧文件树是否完整展开；若显示“Loading…”或仅列出根目录而无子文件夹，说明本地项目未成功导入或同步中断。
点击右上角 Sync Status 图标，确认状态为 Synced；若为 Partial Sync，需手动点击 Retry Import，否则 Agent 将无法读取缺失的文件。
选择支持文件编辑的 Agent 与模型
在 Session 创建页的 Agent 下拉菜单中，必须选择明确标注 File Edit 或 Write + Execute 能力的 Agent，例如 Codex（v2.3+）、Claude Code（Pro Tier）、OpenCode-Workspace。
不支持文件写入的 Agent（如 Claude Read-Only、TestRunner Lite）会在执行阶段跳过所有 save 操作，仅返回建议代码块——【这一步不可跳过，选错 Agent 将导致所有修改指令静默失败】。
模型需匹配 Agent 要求：Codex 强制绑定 o3-mini 或 codex-pro；若强行切换为 claude-3-haiku，系统会禁用文件保存按钮并灰显「Apply Changes」选项。
发起带明确边界的文件修改任务
第一步：在输入框中先声明作用域与禁止项，例如：
「请只修改 src/components/ 和 src/utils/ 下的 TypeScript 文件，不要触碰 public/、dist/、node_modules/ 或任何 .json 配置文件。」
Claude-Obsidian 风格个人知识库构建与自动整理。当用户提到以下任何场景时激活： 知识库、笔记整理、自动双向链接、Obsidian、第二大脑、卡片笔记、原子化笔记、 个人知识管理、PKM、Zettelkasten、卢曼笔记法、笔记原子化、笔记链接、 知识图谱笔记、raw/wiki/output三层、知...
第二步：给出可验证的具体动作，避免模糊动词：
「将 Button.tsx 中所有 onClick 回调里的 console.log 替换为 trackEvent('button_click')，并在该文件顶部 import { trackEvent } from '@/utils/analytics'。」
第三步：强制要求 Agent 输出变更摘要，例如：
「执行完成后，用 Markdown 表格列出：文件路径｜原行号｜原内容｜新内容｜修改原因。」
这三步缺一不可——缺少作用域限定会导致 Agent 修改 .gitignore 或 package.json；缺少具体行号/内容锚点会使替换失效；缺少摘要则无法人工核验是否漏改。
实时验证与手动确认关键修改
Agent 执行过程中，右侧代码预览区会逐个高亮被修改的文件；点击任一文件可查看 diff 视图，绿色为新增，红色为删除。
若发现 Agent 修改了非目标文件（如误改了 README.md），立即点击该文件右上角的 Revert 按钮，再在对话中追加指令：「忽略刚才对 README.md 的所有改动，严格按前三步重试。」
所有文件修改默认处于「待提交」状态，必须点击底部 Commit Changes 按钮才真正写入 Workspace；【未点击即关闭页面，所有变更将永久丢失】。
