diff --git a/website/content/en/_meta.ts b/website/content/en/_meta.ts
index 70ec68b..8bce0a1 100644
--- a/website/content/en/_meta.ts
+++ b/website/content/en/_meta.ts
@@ -23,7 +23,7 @@ export default {
   commands: {
     title: "Commands",
     type: "page",
-    href: "./docs/cli-commands",
+    href: "/en/docs/cli-commands",
   },
   [packageJson.version]: {
     title: `v${packageJson.version}`,
@@ -31,7 +31,7 @@ export default {
     items: {
       contributing: {
         title: "Contributing",
-        href: "./contributing",
+        href: "/en/contributing",
       },
       changelog: {
         title: "Changelog",
diff --git a/website/content/en/docs/advanced-features.mdx b/website/content/en/docs/advanced-features.mdx
index 3d79ed8..92fe650 100644
--- a/website/content/en/docs/advanced-features.mdx
+++ b/website/content/en/docs/advanced-features.mdx
@@ -447,6 +447,6 @@ cat .vsync.json
 
 ## Next Steps
 
-- Check the [FAQ](../faq) for common questions
-- Read about [Contributing](../../contributing) to vsync
-- Explore [Configuration](../configuration) details
+- Check the [FAQ](/en/docs/faq) for common questions
+- Read about [Contributing](/en/contributing) to vsync
+- Explore [Configuration](/en/docs/configuration) details
diff --git a/website/content/en/docs/cli-commands.mdx b/website/content/en/docs/cli-commands.mdx
index 6aaefd2..f2a50f6 100644
--- a/website/content/en/docs/cli-commands.mdx
+++ b/website/content/en/docs/cli-commands.mdx
@@ -549,6 +549,6 @@ vsync sync --help
 
 ## Next Steps
 
-- Learn about [Advanced Features](../advanced-features)
-- Check the [FAQ](../faq) for troubleshooting
-- Explore [Configuration](../configuration) options
+- Learn about [Advanced Features](/en/docs/advanced-features)
+- Check the [FAQ](/en/docs/faq) for troubleshooting
+- Explore [Configuration](/en/docs/configuration) options
diff --git a/website/content/en/docs/configuration.mdx b/website/content/en/docs/configuration.mdx
index 0754c27..af063cd 100644
--- a/website/content/en/docs/configuration.mdx
+++ b/website/content/en/docs/configuration.mdx
@@ -325,6 +325,6 @@ Always use variable references, never hardcode:
 
 ## Next Steps
 
-- Learn all [CLI Commands](../cli-commands)
-- Explore [Advanced Features](../advanced-features)
-- Check the [FAQ](../faq) for troubleshooting
+- Learn all [CLI Commands](/en/docs/cli-commands)
+- Explore [Advanced Features](/en/docs/advanced-features)
+- Check the [FAQ](/en/docs/faq) for troubleshooting
diff --git a/website/content/en/docs/core-concepts.mdx b/website/content/en/docs/core-concepts.mdx
index 334b3f1..fa0e324 100644
--- a/website/content/en/docs/core-concepts.mdx
+++ b/website/content/en/docs/core-concepts.mdx
@@ -247,6 +247,6 @@ Quick command shortcuts.
 
 Now that you understand the core concepts:
 
-- Learn about [Configuration](../configuration) file structure
-- Explore [CLI Commands](../cli-commands) in detail
-- Discover [Advanced Features](../advanced-features) like symlinks
+- Learn about [Configuration](/en/docs/configuration) file structure
+- Explore [CLI Commands](/en/docs/cli-commands) in detail
+- Discover [Advanced Features](/en/docs/advanced-features) like symlinks
diff --git a/website/content/en/docs/getting-started.mdx b/website/content/en/docs/getting-started.mdx
index d0e5d35..192035f 100644
--- a/website/content/en/docs/getting-started.mdx
+++ b/website/content/en/docs/getting-started.mdx
@@ -47,7 +47,7 @@ For global user-level configuration:
 vsync init --user
 ```
 
-> 💡 **Tip**: Learn more about [project vs user levels](../core-concepts#configuration-layers) in Core Concepts.
+> 💡 **Tip**: Learn more about [project vs user levels](/en/docs/core-concepts#configuration-layers) in Core Concepts.
 
 ### Interactive Setup
 
@@ -79,7 +79,7 @@ The CLI will guide you through the setup process:
 ✅ Setup complete! Run vsync sync to start syncing
 ```
 
-> 📚 **Learn more**: See [Configuration](../configuration) for detailed config options.
+> 📚 **Learn more**: See [Configuration](/en/docs/configuration) for detailed config options.
 
 ### 2. Sync Your Configs
 
@@ -96,7 +96,7 @@ vsync sync --dry-run
 vsync sync --prune
 ```
 
-> 🔍 **Details**: Understand [sync modes](../core-concepts#sync-modes) in Core Concepts.
+> 🔍 **Details**: Understand [sync modes](/en/docs/core-concepts#sync-modes) in Core Concepts.
 
 ## Understanding the Output
 
@@ -130,11 +130,11 @@ cursor:
 
 Now that you've installed and initialized vsync:
 
-1. **Learn the Concepts**: Understand [Core Concepts](../core-concepts) like sync modes and layers
-2. **Configure Tools**: Explore [Configuration](../configuration) options for each tool
-3. **Master Commands**: Check out all [CLI Commands](../cli-commands)
-4. **Quick Reference**: Use the [Quick Reference](../quick-reference) cheat sheet
-5. **Advanced Usage**: Dive into [Advanced Features](../advanced-features) like symlinks
+1. **Learn the Concepts**: Understand [Core Concepts](/en/docs/core-concepts) like sync modes and layers
+2. **Configure Tools**: Explore [Configuration](/en/docs/configuration) options for each tool
+3. **Master Commands**: Check out all [CLI Commands](/en/docs/cli-commands)
+4. **Quick Reference**: Use the [Quick Reference](/en/docs/quick-reference) cheat sheet
+5. **Advanced Usage**: Dive into [Advanced Features](/en/docs/advanced-features) like symlinks
 
 ## Real-World Examples
 
@@ -157,7 +157,7 @@ vsync init --user  # Configure which tools to sync
 vsync sync --user  # Sync personal Skills, MCP servers globally
 ```
 
-> 💡 **Related**: Learn about [configuration layers](../core-concepts#configuration-layers).
+> 💡 **Related**: Learn about [configuration layers](/en/docs/core-concepts#configuration-layers).
 
 ### Migration Between Tools
 
@@ -169,7 +169,7 @@ vsync init  # Choose Cursor as SOURCE (reference standard)
 vsync sync  # All configs migrated instantly!
 ```
 
-> 📖 **More info**: See [FAQ - Migration Questions](../faq#migration-questions).
+> 📖 **More info**: See [FAQ - Migration Questions](/en/docs/faq#migration-questions).
 
 ## Troubleshooting
 
@@ -185,12 +185,12 @@ Make sure the tool's configuration directory exists (e.g., `.claude/`, `.cursor/
 
 On macOS/Linux, you may need to grant permissions for file operations. Check that you have write access to the target directories.
 
-> 🔧 **More help**: See the [FAQ](../faq#troubleshooting) for detailed troubleshooting.
+> 🔧 **More help**: See the [FAQ](/en/docs/faq#troubleshooting) for detailed troubleshooting.
 
 ## Getting Help
 
 - Run `vsync --help` for command overview
 - Run `vsync <command> --help` for specific command help
-- Check the [FAQ](../faq) for common questions
-- Use the [Quick Reference](../quick-reference) for command examples
+- Check the [FAQ](/en/docs/faq) for common questions
+- Use the [Quick Reference](/en/docs/quick-reference) for command examples
 - Open an issue on [GitHub](https://github.com/nicepkg/vsync/issues)
diff --git a/website/content/en/docs/index.mdx b/website/content/en/docs/index.mdx
index 30def32..a8d0dae 100644
--- a/website/content/en/docs/index.mdx
+++ b/website/content/en/docs/index.mdx
@@ -21,19 +21,19 @@ Welcome to the vsync documentation! Here you'll find everything you need to sync
 
 ### Getting Started
 
-- **[Getting Started](../getting-started)** - Installation, initialization, and first sync
-- **[Core Concepts](../core-concepts)** - Understanding sync modes, layers, and workflows
+- **[Getting Started](/en/docs/getting-started)** - Installation, initialization, and first sync
+- **[Core Concepts](/en/docs/core-concepts)** - Understanding sync modes, layers, and workflows
 
 ### Reference
 
-- **[Configuration](../configuration)** - Config file structure and tool-specific formats
-- **[CLI Commands](../cli-commands)** - Complete command reference with examples
-- **[Quick Reference](../quick-reference)** - Command cheat sheet and common patterns
+- **[Configuration](/en/docs/configuration)** - Config file structure and tool-specific formats
+- **[CLI Commands](/en/docs/cli-commands)** - Complete command reference with examples
+- **[Quick Reference](/en/docs/quick-reference)** - Command cheat sheet and common patterns
 
 ### Advanced
 
-- **[Advanced Features](../advanced-features)** - Symlinks, performance optimization, and more
-- **[FAQ](../faq)** - Common questions and troubleshooting
+- **[Advanced Features](/en/docs/advanced-features)** - Symlinks, performance optimization, and more
+- **[FAQ](/en/docs/faq)** - Common questions and troubleshooting
 
 ## Supported AI Tools
 
@@ -91,6 +91,6 @@ vsync sync
 
 - **GitHub Issues**: [Report bugs or request features](https://github.com/nicepkg/vsync/issues)
 - **CLI Help**: Run `vsync --help` or `vsync <command> --help`
-- **Contributing**: Check out the [Contributing Guide](../../contributing)
+- **Contributing**: Check out the [Contributing Guide](/en/contributing)
 
-Ready to get started? Head over to [Getting Started](../getting-started)!
+Ready to get started? Head over to [Getting Started](/en/docs/getting-started)!
diff --git a/website/content/en/docs/quick-reference.mdx b/website/content/en/docs/quick-reference.mdx
index 30090f2..cddf611 100644
--- a/website/content/en/docs/quick-reference.mdx
+++ b/website/content/en/docs/quick-reference.mdx
@@ -33,7 +33,7 @@ vsync init --user
 vsync sync --user
 ```
 
-**[Learn more →](../getting-started)**
+**[Learn more →](/en/docs/getting-started)**
 
 ### Daily Sync
 
@@ -68,7 +68,7 @@ vsync clean skill/old-skill
 vsync sync --prune
 ```
 
-**[Learn more →](../cli-commands#clean)**
+**[Learn more →](/en/docs/cli-commands#clean)**
 
 ## Sync Modes
 
@@ -82,7 +82,7 @@ vsync sync
 - ✅ Updates existing items
 - ❌ Never deletes
 
-**[Learn more →](../core-concepts#safe-mode-default)**
+**[Learn more →](/en/docs/core-concepts#safe-mode-default)**
 
 ### Prune Mode
 
@@ -94,7 +94,7 @@ vsync sync --prune
 - ✅ Updates existing items
 - ⚠️ Deletes items not in source
 
-**[Learn more →](../core-concepts#prune-mode)**
+**[Learn more →](/en/docs/core-concepts#prune-mode)**
 
 ## Configuration Layers
 
@@ -118,7 +118,7 @@ vsync sync --user    # Syncs global configs
 
 **Use for**: Personal preferences, global skills
 
-**[Learn more →](../core-concepts#configuration-layers)**
+**[Learn more →](/en/docs/core-concepts#configuration-layers)**
 
 ## Command Examples
 
@@ -206,7 +206,7 @@ vsync clean --user
 vsync clean skill/old-skill -y
 ```
 
-**[Learn more →](../cli-commands#clean)**
+**[Learn more →](/en/docs/cli-commands#clean)**
 
 ### import
 
@@ -237,7 +237,7 @@ vsync import ../other-project --user
 }
 ```
 
-**[Learn more →](../configuration)**
+**[Learn more →](/en/docs/configuration)**
 
 ### Key Settings
 
@@ -261,7 +261,7 @@ vsync import ../other-project --user
 | OpenCode | `{env:VAR}` | `{env:API_KEY}` |
 | Codex | No interpolation | Direct value |
 
-**[Learn more →](../configuration#mcp-configuration-differences)**
+**[Learn more →](/en/docs/configuration#mcp-configuration-differences)**
 
 ### Config File Locations
 
@@ -272,7 +272,7 @@ vsync import ../other-project --user
 | OpenCode | `opencode.json(c)` | `~/.opencode/opencode.json` |
 | Codex | `config.toml` | `~/.codex/config.toml` |
 
-**[Learn more →](../configuration#supported-tools)**
+**[Learn more →](/en/docs/configuration#supported-tools)**
 
 ## Common Patterns
 
@@ -297,7 +297,7 @@ vsync sync
   run: npx @nicepkg/vsync sync --yes
 ```
 
-**[Learn more →](../advanced-features#cicd-integration)**
+**[Learn more →](/en/docs/advanced-features#cicd-integration)**
 
 ### Migration Workflow
 
@@ -312,7 +312,7 @@ vsync plan
 vsync sync
 ```
 
-**[Learn more →](../faq#migration-questions)**
+**[Learn more →](/en/docs/faq#migration-questions)**
 
 ## Exit Codes
 
@@ -360,14 +360,14 @@ mkdir -p ~/.cursor
 vsync init
 ```
 
-**[More troubleshooting →](../faq#troubleshooting)**
+**[More troubleshooting →](/en/docs/faq#troubleshooting)**
 
 ## Related Resources
 
-- **[Getting Started](../getting-started)** - Detailed installation guide
-- **[Core Concepts](../core-concepts)** - Understanding vsync
-- **[CLI Commands](../cli-commands)** - Full command reference
-- **[Configuration](../configuration)** - Config file details
-- **[Advanced Features](../advanced-features)** - Symlinks, performance
-- **[FAQ](../faq)** - Common questions
-- **[Contributing](../../contributing)** - Development guide
+- **[Getting Started](/en/docs/getting-started)** - Detailed installation guide
+- **[Core Concepts](/en/docs/core-concepts)** - Understanding vsync
+- **[CLI Commands](/en/docs/cli-commands)** - Full command reference
+- **[Configuration](/en/docs/configuration)** - Config file details
+- **[Advanced Features](/en/docs/advanced-features)** - Symlinks, performance
+- **[FAQ](/en/docs/faq)** - Common questions
+- **[Contributing](/en/contributing)** - Development guide
diff --git a/website/content/zh/_meta.ts b/website/content/zh/_meta.ts
index 5f45b04..f7434c3 100644
--- a/website/content/zh/_meta.ts
+++ b/website/content/zh/_meta.ts
@@ -23,7 +23,7 @@ export default {
   commands: {
     title: "CLI 命令",
     type: "page",
-    href: "./docs/cli-commands",
+    href: "/zh/docs/cli-commands",
   },
   [packageJson.version]: {
     title: `v${packageJson.version}`,
@@ -31,7 +31,7 @@ export default {
     items: {
       contributing: {
         title: "贡献指南",
-        href: "./contributing",
+        href: "/zh/contributing",
       },
       changelog: {
         title: "更新日志",
diff --git a/website/content/zh/docs/advanced-features.mdx b/website/content/zh/docs/advanced-features.mdx
index 7748b5b..30fd9f6 100644
--- a/website/content/zh/docs/advanced-features.mdx
+++ b/website/content/zh/docs/advanced-features.mdx
@@ -447,6 +447,6 @@ cat .vsync.json
 
 ## 下一步
 
-- 查看 [FAQ](../faq) 了解常见问题
-- 阅读关于[贡献](../../contributing)到 vsync
-- 探索[配置](../configuration)详情
+- 查看 [FAQ](/zh/docs/faq) 了解常见问题
+- 阅读关于[贡献](/zh/contributing)到 vsync
+- 探索[配置](/zh/docs/configuration)详情
diff --git a/website/content/zh/docs/cli-commands.mdx b/website/content/zh/docs/cli-commands.mdx
index 313c963..5c68958 100644
--- a/website/content/zh/docs/cli-commands.mdx
+++ b/website/content/zh/docs/cli-commands.mdx
@@ -549,6 +549,6 @@ vsync sync --help
 
 ## 下一步
 
-- 了解[高级功能](../advanced-features)
-- 查看 [FAQ](../faq) 进行故障排除
-- 探索[配置](../configuration)选项
+- 了解[高级功能](/zh/docs/advanced-features)
+- 查看 [FAQ](/zh/docs/faq) 进行故障排除
+- 探索[配置](/zh/docs/configuration)选项
diff --git a/website/content/zh/docs/configuration.mdx b/website/content/zh/docs/configuration.mdx
index 852116d..f53f3ff 100644
--- a/website/content/zh/docs/configuration.mdx
+++ b/website/content/zh/docs/configuration.mdx
@@ -325,6 +325,6 @@ vsync 在 `.vsync-cache/manifest.json` 维护 manifest：
 
 ## 下一步
 
-- 学习所有 [CLI 命令](../cli-commands)
-- 探索[高级功能](../advanced-features)
-- 查看 [FAQ](../faq) 进行故障排除
+- 学习所有 [CLI 命令](/zh/docs/cli-commands)
+- 探索[高级功能](/zh/docs/advanced-features)
+- 查看 [FAQ](/zh/docs/faq) 进行故障排除
diff --git a/website/content/zh/docs/core-concepts.mdx b/website/content/zh/docs/core-concepts.mdx
index a86a0c2..8e66dd2 100644
--- a/website/content/zh/docs/core-concepts.mdx
+++ b/website/content/zh/docs/core-concepts.mdx
@@ -247,6 +247,6 @@ vsync **从不展开**环境变量——它保留语法：
 
 现在您理解了核心概念：
 
-- 了解[配置](../configuration)文件结构
-- 详细探索 [CLI 命令](../cli-commands)
-- 发现[高级功能](../advanced-features)，如 symlinks
+- 了解[配置](/zh/docs/configuration)文件结构
+- 详细探索 [CLI 命令](/zh/docs/cli-commands)
+- 发现[高级功能](/zh/docs/advanced-features)，如 symlinks
diff --git a/website/content/zh/docs/getting-started.mdx b/website/content/zh/docs/getting-started.mdx
index 2ee6ad6..45bfa74 100644
--- a/website/content/zh/docs/getting-started.mdx
+++ b/website/content/zh/docs/getting-started.mdx
@@ -47,7 +47,7 @@ vsync init
 vsync init --user
 ```
 
-> 💡 **提示**：在核心概念中了解更多关于[项目层与用户层](../core-concepts#configuration-layers)的信息。
+> 💡 **提示**：在核心概念中了解更多关于[项目层与用户层](/zh/docs/core-concepts#configuration-layers)的信息。
 
 ### 交互式设置
 
@@ -79,7 +79,7 @@ CLI 将引导您完成设置过程：
 ✅ 设置完成！运行 vsync sync 开始同步
 ```
 
-> 📚 **了解更多**：查看[配置指南](../configuration)了解详细配置选项。
+> 📚 **了解更多**：查看[配置指南](/zh/docs/configuration)了解详细配置选项。
 
 ### 2. 同步您的配置
 
@@ -96,7 +96,7 @@ vsync sync --dry-run
 vsync sync --prune
 ```
 
-> 🔍 **详情**：在核心概念中理解[同步模式](../core-concepts#sync-modes)。
+> 🔍 **详情**：在核心概念中理解[同步模式](/zh/docs/core-concepts#sync-modes)。
 
 ## 理解输出
 
@@ -130,11 +130,11 @@ cursor:
 
 现在您已经安装并初始化了 vsync：
 
-1. **学习概念**：理解[核心概念](../core-concepts)，如同步模式和层级
-2. **配置工具**：探索每个工具的[配置](../configuration)选项
-3. **掌握命令**：查看所有 [CLI 命令](../cli-commands)
-4. **快速参考**：使用[快速参考](../quick-reference)速查表
-5. **高级用法**：深入了解[高级功能](../advanced-features)，如 symlinks
+1. **学习概念**：理解[核心概念](/zh/docs/core-concepts)，如同步模式和层级
+2. **配置工具**：探索每个工具的[配置](/zh/docs/configuration)选项
+3. **掌握命令**：查看所有 [CLI 命令](/zh/docs/cli-commands)
+4. **快速参考**：使用[快速参考](/zh/docs/quick-reference)速查表
+5. **高级用法**：深入了解[高级功能](/zh/docs/advanced-features)，如 symlinks
 
 ## 实际示例
 
@@ -157,7 +157,7 @@ vsync init --user  # 配置要同步哪些工具
 vsync sync --user  # 全局同步个人 Skills、MCP 服务器
 ```
 
-> 💡 **相关**：了解[配置层级](../core-concepts#configuration-layers)。
+> 💡 **相关**：了解[配置层级](/zh/docs/core-concepts#configuration-layers)。
 
 ### 工具间迁移
 
@@ -169,7 +169,7 @@ vsync init  # 选择 Cursor 作为 SOURCE（参考标准）
 vsync sync  # 所有配置立即迁移！
 ```
 
-> 📖 **更多信息**：查看 [FAQ - 迁移问题](../faq#migration-questions)。
+> 📖 **更多信息**：查看 [FAQ - 迁移问题](/zh/docs/faq#migration-questions)。
 
 ## 故障排除
 
@@ -185,12 +185,12 @@ vsync sync  # 所有配置立即迁移！
 
 在 macOS/Linux 上，您可能需要授予文件操作权限。检查您是否具有目标目录的写入权限。
 
-> 🔧 **更多帮助**：查看 [FAQ](../faq#troubleshooting) 获取详细的故障排除。
+> 🔧 **更多帮助**：查看 [FAQ](/zh/docs/faq#troubleshooting) 获取详细的故障排除。
 
 ## 获取帮助
 
 - 运行 `vsync --help` 获取命令概览
 - 运行 `vsync <command> --help` 获取特定命令帮助
-- 查看 [FAQ](../faq) 了解常见问题
-- 使用[快速参考](../quick-reference)获取命令示例
+- 查看 [FAQ](/zh/docs/faq) 了解常见问题
+- 使用[快速参考](/zh/docs/quick-reference)获取命令示例
 - 在 [GitHub](https://github.com/nicepkg/vsync/issues) 上提交 issue
diff --git a/website/content/zh/docs/index.mdx b/website/content/zh/docs/index.mdx
index 56190dd..dc8bda5 100644
--- a/website/content/zh/docs/index.mdx
+++ b/website/content/zh/docs/index.mdx
@@ -21,19 +21,19 @@ description: vsync 完整指南 - 一条命令同步 AI 氛围编程工具 (Clau
 
 ### 入门
 
-- **[快速开始](../getting-started)** - 安装、初始化和首次同步
-- **[核心概念](../core-concepts)** - 理解同步模式、层级和工作流
+- **[快速开始](/zh/docs/getting-started)** - 安装、初始化和首次同步
+- **[核心概念](/zh/docs/core-concepts)** - 理解同步模式、层级和工作流
 
 ### 参考
 
-- **[配置指南](../configuration)** - 配置文件结构和工具特定格式
-- **[CLI 命令](../cli-commands)** - 完整命令参考和示例
-- **[快速参考](../quick-reference)** - 命令速查表和常用模式
+- **[配置指南](/zh/docs/configuration)** - 配置文件结构和工具特定格式
+- **[CLI 命令](/zh/docs/cli-commands)** - 完整命令参考和示例
+- **[快速参考](/zh/docs/quick-reference)** - 命令速查表和常用模式
 
 ### 进阶
 
-- **[高级功能](../advanced-features)** - Symlinks、性能优化等
-- **[常见问题](../faq)** - 常见问题和故障排除
+- **[高级功能](/zh/docs/advanced-features)** - Symlinks、性能优化等
+- **[常见问题](/zh/docs/faq)** - 常见问题和故障排除
 
 ## 支持的 AI 工具
 
@@ -91,6 +91,6 @@ vsync sync
 
 - **GitHub Issues**：[报告 bug 或请求功能](https://github.com/nicepkg/vsync/issues)
 - **CLI 帮助**：运行 `vsync --help` 或 `vsync <command> --help`
-- **贡献**：查看[贡献指南](../../contributing)
+- **贡献**：查看[贡献指南](/zh/contributing)
 
-准备好开始了吗？前往[快速开始](../getting-started)！
+准备好开始了吗？前往[快速开始](/zh/docs/getting-started)！
diff --git a/website/content/zh/docs/quick-reference.mdx b/website/content/zh/docs/quick-reference.mdx
index 0301f70..716cc2b 100644
--- a/website/content/zh/docs/quick-reference.mdx
+++ b/website/content/zh/docs/quick-reference.mdx
@@ -33,7 +33,7 @@ vsync init --user
 vsync sync --user
 ```
 
-**[了解更多 →](../getting-started)**
+**[了解更多 →](/zh/docs/getting-started)**
 
 ### 日常同步
 
@@ -68,7 +68,7 @@ vsync clean skill/old-skill
 vsync sync --prune
 ```
 
-**[了解更多 →](../cli-commands#clean)**
+**[了解更多 →](/zh/docs/cli-commands#clean)**
 
 ## 同步模式
 
@@ -82,7 +82,7 @@ vsync sync
 - ✅ 更新现有项
 - ❌ 从不删除
 
-**[了解更多 →](../core-concepts#safe-mode-default)**
+**[了解更多 →](/zh/docs/core-concepts#safe-mode-default)**
 
 ### Prune 模式
 
@@ -94,7 +94,7 @@ vsync sync --prune
 - ✅ 更新现有项
 - ⚠️ 删除源中不存在的项
 
-**[了解更多 →](../core-concepts#prune-mode)**
+**[了解更多 →](/zh/docs/core-concepts#prune-mode)**
 
 ## 配置层级
 
@@ -118,7 +118,7 @@ vsync sync --user    # 同步全局配置
 
 **用于**: 个人偏好、全局技能
 
-**[了解更多 →](../core-concepts#configuration-layers)**
+**[了解更多 →](/zh/docs/core-concepts#configuration-layers)**
 
 ## 命令示例
 
@@ -206,7 +206,7 @@ vsync clean --user
 vsync clean skill/old-skill -y
 ```
 
-**[了解更多 →](../cli-commands#clean)**
+**[了解更多 →](/zh/docs/cli-commands#clean)**
 
 ### import
 
@@ -237,7 +237,7 @@ vsync import ../other-project --user
 }
 ```
 
-**[了解更多 →](../configuration)**
+**[了解更多 →](/zh/docs/configuration)**
 
 ### 关键设置
 
@@ -261,7 +261,7 @@ vsync import ../other-project --user
 | OpenCode | `{env:VAR}` | `{env:API_KEY}` |
 | Codex | 无插值 | 直接值 |
 
-**[了解更多 →](../configuration#mcp-configuration-differences)**
+**[了解更多 →](/zh/docs/configuration#mcp-configuration-differences)**
 
 ### 配置文件位置
 
@@ -272,7 +272,7 @@ vsync import ../other-project --user
 | OpenCode | `opencode.json(c)` | `~/.opencode/opencode.json` |
 | Codex | `config.toml` | `~/.codex/config.toml` |
 
-**[了解更多 →](../configuration#supported-tools)**
+**[了解更多 →](/zh/docs/configuration#supported-tools)**
 
 ## 常用模式
 
@@ -297,7 +297,7 @@ vsync sync
   run: npx @nicepkg/vsync sync --yes
 ```
 
-**[了解更多 →](../advanced-features#cicd-integration)**
+**[了解更多 →](/zh/docs/advanced-features#cicd-integration)**
 
 ### 迁移工作流
 
@@ -312,7 +312,7 @@ vsync plan
 vsync sync
 ```
 
-**[了解更多 →](../faq#migration-questions)**
+**[了解更多 →](/zh/docs/faq#migration-questions)**
 
 ## 退出代码
 
@@ -360,14 +360,14 @@ mkdir -p ~/.cursor
 vsync init
 ```
 
-**[更多故障排除 →](../faq#troubleshooting)**
+**[更多故障排除 →](/zh/docs/faq#troubleshooting)**
 
 ## 相关资源
 
-- **[快速开始](../getting-started)** - 详细安装指南
-- **[核心概念](../core-concepts)** - 理解 vsync
-- **[CLI 命令](../cli-commands)** - 完整命令参考
-- **[配置指南](../configuration)** - 配置文件详情
-- **[高级功能](../advanced-features)** - Symlinks、性能
-- **[常见问题](../faq)** - 常见问题
-- **[贡献指南](../../contributing)** - 开发指南
+- **[快速开始](/zh/docs/getting-started)** - 详细安装指南
+- **[核心概念](/zh/docs/core-concepts)** - 理解 vsync
+- **[CLI 命令](/zh/docs/cli-commands)** - 完整命令参考
+- **[配置指南](/zh/docs/configuration)** - 配置文件详情
+- **[高级功能](/zh/docs/advanced-features)** - Symlinks、性能
+- **[常见问题](/zh/docs/faq)** - 常见问题
+- **[贡献指南](/zh/contributing)** - 开发指南