WorkBuddy已激活跨文件代码引用处理机制，依赖符号可见性建模与文件系统语义解析协同工作，具体包括：一、启用跨文件符号继承与自动导入；二、基于AST解析的动态路径补全；三、RAG增强的隐式引用识别与导入建议；四、Claw绑定驱动的跨仓库路径映射补全。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在编写代码时，发现WorkBuddy能自动识别未显式导入的函数、类或变量，并提示添加import语句，或在输入路径字符串时补全相对/绝对文件路径，则说明已激活跨文件代码引用处理机制。该能力依赖于符号可见性建模与文件系统语义解析的协同工作。以下是实现此功能的具体方法：
一、启用跨文件符号继承与自动导入触发
该机制使WorkBuddy能在当前作用域中感知其他文件导出的标识符，并在用户输入匹配前缀时主动建议补全及自动注入对应import语句，避免手动查找和书写错误路径。
1、进入【智能助手】→【会话设置】→「代码上下文」子页。
2、将「跨文件符号可见性」开关切换为开启状态。
3、在「继承深度」选项中选择数值:3(表示最多向上追溯3层目录中的同名模块)。
4、勾选「允许继承类型定义」与「允许继承数据库Schema注释」两项，确保TS接口、SQL注释块等内容可被跨文件调用。
5、在编辑器中输入未导入但已存在于项目其他文件中的函数名前缀（如format_），触发补全弹窗后，点击带「+import」图标的候选条目。
二、基于AST解析的动态路径补全
该方法通过抽象语法树分析当前文件的模块导入结构与运行时路径构造逻辑，在字符串字面量中识别路径拼接模式（如path.join(__dirname, '../utils')），并基于项目目录拓扑实时推荐合法子路径。
1、确保项目根目录下存在有效的配置文件（如tsconfig.json、pyproject.toml或package.json）。
2、在JavaScript/TypeScript文件中，编写含require()或import()动态加载语句的代码，例如require('./' + moduleName)。
3、将光标置于单引号或双引号内部，输入点号（.）或斜杠（/）后暂停，系统将列出当前目录下所有可访问的子路径。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
4、若路径指向一个index.js或__init__.py文件，补全项将自动附加/以支持进一步展开。
三、RAG增强的隐式引用识别与导入建议
当目标符号来自第三方库、运行时生成模块或无类型声明的CommonJS包时，标准静态分析可能失效。此时WorkBuddy启用RAG策略，从本地缓存的API文档切片中召回相似签名，并生成带路径提示的导入建议。
1、确认设置中已启用RAG辅助补全开关（路径：设置 → 智能补全 → 高级选项）。
2、在代码中输入一个常见但未导入的方法名（如pd.read_csv），并在其前缀处触发补全。
3、观察补全弹窗底部是否出现[来自文档] read_csv(filepath_or_buffer, sep=',', )类似提示。
4、点击该条目，系统将自动插入import pandas as pd语句至文件顶部最近的空白行。
四、Claw绑定驱动的跨仓库路径映射补全
该机制适用于多仓库协同开发场景，WorkBuddy依据已建立的仓库关联关系，将远程仓库的源码路径结构映射到本地挂载路径，并在import语句中提供精确的相对路径补全。
1、进入「代码管理」→「仓库关联」，确认至少一个外部仓库已被添加并启用版本锁定。
2、在主仓库TS文件中输入import {，随后键入空格，系统将列出所有已关联仓库中导出的命名空间与模块名。
3、选择某模块后，补全引擎将根据其package.json中的exports字段或index.ts入口推导合法路径。
4、若目标模块位于./libs/backend-core/src/auth，则自动补全为"@team/backend-core/auth"而非物理路径。
