必须在项目根目录运行opencode并执行/init初始化，否则OpenCode无法识别项目结构；确认根目录含package.json、.git等标志文件后，可用read src/main.py、read "config"或read backend/models.py:100-150精准读取文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让 OpenCode 正确读取项目文件，必须先让它识别出“这是一个什么项目”，而不是直接丢给它一个孤立的文件路径——否则它会把单个文件当全部上下文，漏掉依赖、配置和结构关系。
确认当前目录是项目根目录
执行 cd /path/to/your/project，确保终端当前路径下存在 package.json、pyproject.toml、requirements.txt 或 .git 等标志性文件。OpenCode 依赖这些文件自动推断技术栈和项目边界。
【不这样做会导致 OpenCode 将子目录误判为独立项目，后续 read 工具无法定位 src/lib 下的真实模块】
运行 ls -a 快速核对：如果看不到 package.json 或 .git，说明还没进对地方。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
启动 OpenCode 并完成初始化
在根目录下直接运行 opencode，等待终端进入交互式 TUI 界面。
输入 /init 命令，触发项目初始化流程。这一步会生成 .opencode/ 目录，并自动扫描整个工作区，建立文件索引和向量上下文。
初始化完成后，界面右上角会出现 “✅ Project indexed” 提示。此时 OpenCode 才具备跨文件理解能力，read 工具才能按语义而非字面路径调用文件。
用 read 工具精准读取目标文件
方法一：直接读取已知路径文件
在聊天框中输入：read src/main.py → OpenCode 会加载该文件全文（若文件过大则默认读前 500 行）。
方法二：模糊匹配后选择
输入：read "config" → OpenCode 自动列出所有含 config 的文件（如 config.py、.env.example、webpack.config.js），你用方向键选中后回车即可加载。
方法三：按行范围读取大文件
输入：read backend/models.py:100-150 → 只读第 100 到 150 行，避免内存溢出或上下文污染。
注意：read 后不加任何参数时，OpenCode 会返回当前已加载文件的摘要，不是重读全部内容。
