Code Tour 是 VS Code 的轻量插件，用于创建可执行、可分享的交互式代码导览；所有数据以 JSON 文件存于项目中，安装即用，支持 Markdown、命令执行与 Git 协作，适合新人上手与知识沉淀。
Code Tour 是一款适用于 Visual Studio Code 的轻量级插件，能帮你为代码库创建可执行、可分享的交互式导览，特别适合新成员上手、代码审查说明或功能模块讲解。它不依赖外部服务，所有信息以纯文本 JSON 文件形式保存在项目中，简洁可控。
安装与基础配置
在 VS Code 扩展市场搜索 “Code Tour”，安装由 Microsoft 发布的官方插件（图标为指南针）。安装后无需额外配置，重启编辑器即可使用。插件会自动识别项目根目录下的 .code-tour 文件夹，其中存放所有导览文件（如 getting-started.tour）。
快速创建第一个导览
按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 “Code Tour: Create Tour”，回车后命名导览（例如 auth-flow）。接着在你希望讲解的代码行左侧点击 “+” 号添加步骤，每步支持写标题、描述，并可选择是否自动跳转到该位置。导览保存后即生成一个 JSON 文件，结构清晰，可直接提交到 Git。
OpenClaw Skill: Obsidian Markdown to Cloudflare Pages
下载
将选定的 Obsidian 笔记发布为静态站点并部署到 Cloudflare Pages。
让导览真正可用
- 用 Code Tour: Start Tour 启动当前文件中的导览，或从资源管理器右键 tour 文件选择运行
- 支持 Markdown 描述，可嵌入代码块、链接甚至简单表情符号，提升可读性
- 步骤中可添加 “Run Command” 字段，比如执行测试或打开终端，实现半自动化引导
- 多人协作时，建议把 tour 文件放在 .code-tour/ 目录下并加入 README 提示，方便新人发现
小技巧与注意事项
导览步骤绑定的是具体行号，如果对应代码被大幅修改或删除，步骤可能失效——建议优先为稳定接口、核心逻辑或配置文件编写导览；避免在临时分支或频繁重构的代码上投入太多 tour 维护成本。另外，tour 文件本身是普通 JSON，可手动编辑调整顺序、补充条件说明，甚至用脚本批量生成。
基本上就这些。Code Tour 不复杂但容易忽略，坚持为关键路径配上几条简明导览，团队知识沉淀会明显更轻量、更可持续。
