默认页面
原则：
- 尽量不要自己手动修改代码，完善 skills, docs 来让 ai 写的更好
- 尽量不要自己手动 @ 上下文，完善文档地图，以及 skills 描述，来让 ai 自己找到上下文
当你引入了 Codex、Aider、Cline (原 Claude Dev) 等独立 AI 辅助工具，或者其他基于命令行的 Agent 框架时，**“虚拟工作区”就彻底失效了**。因为这些外部工具不认识 VS Code/Cursor 的 `.code-workspace` 文件，它们只认**物理文件系统（Physical File System）**，通常依靠在当前目录（CWD）或向上遍历来自动发现 `AGENTS.md` 或 `.agents/` 目录。
要在“保持真实物理根目录”和“同一时间只关注少数几个项目”之间取得完美的平衡，我为你推荐以下两种真正的高阶解法：
方案一：“全局全开 + 动态屏蔽”流派 (The Exclusion Pattern) —— 最推荐
与其用虚拟工作区把小项目“拼”起来，不如**直接把整个 `workspace` 作为物理根目录打开**，然后用 Cursor 的屏蔽机制把不需要的项目“隐藏”掉。
- **物理结构**：保持最直观的层级，全局文件直接放在物理根目录。
```text
workspace/
├── AGENTS.md <-- 外部 Agent 工具一秒自动发现
├── .agents/ <-- 外部工具的 Skill 目录
├── .vscode/
│ └── settings.json
├── project_A/
├── project_B/
└── project_C/
```
workspace/
├── AGENTS.md <-- 外部 Agent 工具一秒自动发现
├── .agents/ <-- 外部工具的 Skill 目录
├── .vscode/
│ └── settings.json
├── project_A/
├── project_B/
└── project_C/
```
- **操作逻辑**：用 Cursor 直接打开整个 `workspace` 文件夹。
- **优雅管理**：通过 `.vscode/settings.json` 中的 `files.exclude` 和 `search.exclude` 动态隐藏当前不需要的项目。
```json
{
"files.exclude": {
"project_C": true, // 隐藏不在当前工作流的项目
"old_project_*": true
},
"search.exclude": {
"project_C": true
}
}
```
{
"files.exclude": {
"project_C": true, // 隐藏不在当前工作流的项目
"old_project_*": true
},
"search.exclude": {
"project_C": true
}
}
```
- **效果**：
- **对于 Cursor**：文件树非常清爽，全局搜索和 AI 索引（Codebase indexing）**绝对不会**去读取被 exclude 的文件夹，上下文完全纯净。
- **对于外部工具 (Codex/Agent)**：因为你是在真正的物理根目录运行终端，它们可以毫无障碍地向上或向下遍历，完美、静默地自动加载 `AGENTS.md` 和 `.agents/skill`。
- **进阶技巧**：你可以安装 VS Code 插件 **"Explorer Exclude"**。它可以在侧边栏加一个面板，让你用**打勾/取消打勾**的方式，一键切换这些项目的显示和隐藏，免去手写 JSON 的麻烦。