用途:当 VS Code 文档中的 Markdown 文件被移动、重命名,或内容被删除并迁移到别处,或明确要求添加重定向时使用本技能。
主要能力:在 redirection.json 中创建与管理重定向条目。每个顶层内容目录各有独立文件:docs/ 对应 docs/redirection.json,api/ 对应 api/redirection.json,blogs/ 对应 blogs/redirection.json,remote/ 对应 remote/redirection.json。条目格式为 {"from": "/docs/old/path", "to": "/docs/new/path", "status": 301}。from 为旧 URL 路径,不含扩展名与域名,须以 / 加内容区前缀开头;to 为新路径;status 固定为 301。
使用方式:先确定旧、新路径,去掉 .md 扩展名与仓库根前缀;index.md 的路径为去掉 /index 的目录路径,如 docs/copilot/index.md 对应 /docs/copilot。再按旧路径所属内容区选择正确的 redirection.json,把新条目追加进 JSON 数组,保持 JSON 有效且没有尾随逗号。然后检查重定向链:若同一文件已有条目的 to 等于新条目的 from,应把旧条目的 to 直接指向最终目标。接着在仓库中用 Grep 查找指向旧路径的链接,更新 markdown 与 toc.json 中的引用。最后验证 JSON 有效、from 无重复;若是移动而非删除,确认目标路径的新文件存在。
适用场景:VS Code 文档仓库的结构调整、页面更名、内容合并或迁移时的链接维护。
限制:仅适用于上述 VS Code 文档仓库的 redirection.json 机制,其他站点或框架是否适用暂未提供;未提供自动化脚本、部署后验证方式或与其他重定向方案的兼容性说明。