需配置全项目上下文感知：一、启用递归扫描与引用解析；二、绑定tsconfig.json等锚点文件并指定作用范围；三、开启跨文件符号继承并设深度为3；四、生成并启用claw context snapshot快照。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用WorkBuddy执行涉及多个文件、分散于不同子目录的复杂任务时，发现AI无法识别跨层级引用的变量、函数或配置项，则可能是由于项目上下文未被完整加载与关联。以下是实现全项目上下文感知的配置步骤：
一、启用全项目路径索引与结构解析
WorkBuddy需先构建完整的本地项目拓扑视图，才能识别跨文件的符号依赖关系。该步骤强制扫描根目录下所有子级路径，并建立AST级语义链接，使“import”“require”“include”等调用可被前向追溯。
1、打开WorkBuddy主界面，在左侧导航栏点击「项目管理」图标。
2、点击右上角「添加项目」按钮，选择本地工作区根目录（如D:\my-project）。
3、在弹出的配置面板中，勾选「递归扫描全部子目录」与「解析代码间引用关系」两项。
4、点击「构建索引」，等待状态栏显示“索引完成（共解析XX个文件，XX个符号）”。
二、绑定全局上下文锚点文件
单靠自动扫描不足以维持跨文件语义一致性，需指定一个或多个锚点文件作为上下文基准源。这些文件通常包含项目级配置、类型定义或共享常量，WorkBuddy将据此推导其余文件的隐含约束条件。
1、在已加载的项目设置页中，展开「上下文锚定」区域。
2、点击「添加锚点文件」，从文件树中选择以下任一类文件：tsconfig.json、package.json、pyproject.toml、.env.local。
3、对每个锚点文件，手动指定其作用范围：例如将tsconfig.json设为“影响所有.ts/.tsx文件”，将.env.local设为“注入所有运行时环境变量”。
4、保存后，WorkBuddy将在后续对话中自动将锚点内容注入当前会话的Working Memory。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
三、配置跨文件符号继承策略
默认情况下，WorkBuddy仅在当前编辑文件内解析符号。启用符号继承后，系统可在响应中直接引用其他文件中定义的类名、接口、枚举值或SQL表结构，无需用户重复说明。
1、进入【智能助手】→【会话设置】→「代码上下文」子页。
2、将「跨文件符号可见性」开关切换为开启状态。
3、在「继承深度」选项中选择数值：3（表示最多向上追溯3层目录中的同名模块）。
4、勾选「允许继承类型定义」与「允许继承数据库Schema注释」两项，确保TS接口、SQL注释块等内容可被跨文件调用。
四、启用Claw Context Snapshot持久化
常规上下文在重启或切换项目后即失效。Claw Context Snapshot功能可将当前项目的完整符号图谱、变量映射与依赖链序列化为本地快照，下次加载同一项目时自动恢复，避免重复索引。
1、在项目设置页底部，点击「生成上下文快照」按钮。
2、系统自动生成快照文件，路径为：C:\WorkBuddy\context_snapshots\my-project_20260412_0113.json。
3、勾选「启动时自动加载匹配项目快照」选项。
4、关闭并重新打开WorkBuddy，确认右下角状态栏显示“上下文已从快照恢复（127个符号，9个跨文件引用）”。
