Zion默认按语义块多处插入，需用@路径、--before代码或--scope single限定单处修改，并通过git diff和浏览器开发者工具验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
用函子Zion追加一句「加个搜索框」时，它不会只改这一处——Zion默认以语义块为单位匹配和插入，若项目中存在多个结构相似的导航区、工具栏或页面头部，该指令可能在多处触发插入，导致重复添加搜索框。
确认Zion当前作用范围
打开终端，进入项目根目录，执行 zion status 查看当前激活的上下文区域。输出中会显示 【Active scope: header.tsx, layout.tsx】 这类路径，说明Zion正同时监听多个文件。
如果没看到具体文件名，说明Zion处于全局模式，此时任意含「导航」「工具栏」「顶部栏」语义的组件都可能被修改。
精准限定只改一处的方法
方法一：用文件路径锚定
在指令末尾加上 @src/components/Header.tsx，完整输入：zion add "加个搜索框" @src/components/Header.tsx。Zion会跳过其他文件，仅在该路径下查找最近的可插入位置（如 JSX 中 return 语句内第一个 div 的开头）。
方法二：用代码片段锚定
先复制 Header.tsx 中的一行特征代码，比如 ，然后执行：zion add "加个搜索框" --before "。这会确保新元素严格插在该标签之前，不依赖语义理解。
方法三：临时禁用跨文件匹配
执行 zion config --scope single，Zion将强制降级为单文件模式。此后所有指令只影响你当前打开的编辑器标签页所对应的文件，哪怕终端不在该目录下也生效。
验证是否真只改了一处
第一步：保存所有已修改文件 → 第二步：运行 git diff --no-index /dev/null src/（需先确保无未提交变更）→ 第三步：在输出中搜索 搜索框，确认只出现一次。
注意：如果项目使用了 Storybook 或单元测试快照，Zion可能同步更新了 *.stories.tsx 或 *.test.tsx 文件里的示例代码——这些也会出现在 git diff 中，但不属于运行时渲染的「一处」。要区分真实 DOM 插入点，得直接检查浏览器开发者工具里实际挂载的组件树。
