docs: documents - index remote tunnel guide

i18n/zh/documents/02-方法论/README.md

@@ -14,6 +14,7 @@
 - [Augment MCP 配置](./auggie-mcp配置文档.md) - 上下文引擎配置
 - [ProxyCast 配置](./ProxyCast配置文档.md) - AI 凭证代理服务配置
 - [手机远程 Vibe Coding](./关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md) - 基于 frp 的远程开发
+- [VS Code Remote Tunnel（WSL）](./REMOTE_TUNNEL_GUIDE.md) - 在 WSL 内开通 VS Code Tunnel 供远程访问
 - [GEMINI-HEADLESS](./GEMINI-HEADLESS.md) - Gemini 无头模式配置
 
 ## 🛠️ 开发经验

i18n/zh/documents/02-方法论/REMOTE_TUNNEL_GUIDE.md

@@ -0,0 +1,67 @@
+# VS Code Remote Tunnel（WSL 侧）快速指南
+
+面向场景：在 WSL 内开通 VS Code Tunnel，供 Mac/任意客户端通过 Remote - Tunnels 或 vscode.dev 访问。
+
+## 前置条件
+- WSL 已开启 systemd（`/etc/wsl.conf` 有 `[boot] systemd=true`，然后 `wsl --shutdown` 重进）。
+- 网络可直连或通过本机代理 127.0.0.1:9910（本指南示例端口）。
+
+## 安装 VS Code CLI（WSL 内）
+```bash
+sudo apt-get update
+sudo apt-get install -y wget gpg apt-transport-https
+wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor | sudo tee /etc/apt/keyrings/packages.microsoft.gpg >/dev/null
+echo "deb [arch=amd64,arm64 signed-by=/etc/apt/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" | sudo tee /etc/apt/sources.list.d/vscode.list
+sudo apt-get update
+sudo apt-get install -y code
+which code   # 应为 /usr/local/bin/code 或 /usr/bin/code
+```
+
+## 一次性登录
+```bash
+/usr/local/bin/code tunnel user login
+# 浏览器打开提示的 device code 完成 GitHub 授权
+```
+
+## 配置代理（可选，示例 127.0.0.1:9910）
+创建 drop-in：
+```bash
+mkdir -p ~/.config/systemd/user/code-tunnel.service.d
+cat > ~/.config/systemd/user/code-tunnel.service.d/proxy.conf <<'EOF'
+[Service]
+Environment=HTTP_PROXY=http://127.0.0.1:9910
+Environment=HTTPS_PROXY=http://127.0.0.1:9910
+Environment=NO_PROXY=localhost,127.0.0.1,::1
+EOF
+systemctl --user daemon-reload
+```
+
+## 安装并开机自启隧道服务
+```bash
+/usr/local/bin/code tunnel service install --accept-server-license-terms --name wsl-lenovo
+systemctl --user enable code-tunnel.service
+systemctl --user restart code-tunnel.service
+```
+
+## 验证
+```bash
+/usr/local/bin/code tunnel status        # tunnel: Connected 且 service_installed:true
+systemctl --user status code-tunnel.service --no-pager
+```
+
+## 客户端连接
+- VS Code 桌面：安装 “Remote - Tunnels”，用同一 GitHub 账号登录，Remote Explorer 选择 `wsl-lenovo`。
+- 纯浏览器：访问 `https://vscode.dev/tunnel/wsl-lenovo`，同账号登录即可。
+
+## 日志与维护
+```bash
+/usr/local/bin/code tunnel service log --log info   # 查看服务日志
+/usr/local/bin/code tunnel rename <new-name>        # 重命名隧道
+/usr/local/bin/code tunnel kill                     # 停止当前隧道进程
+/usr/local/bin/code tunnel service uninstall        # 移除自启服务
+```
+
+## 常见故障排查
+- 仍显示 Disconnected：确认代理可用，`curl https://api.github.com` 能通；或暂时 `unset HTTP_PROXY HTTPS_PROXY` 再试。
+- 路径错误 (`\\wsl.localhost\\...`)：不要在 `terminal.integrated.cwd` 写 UNC，删除该项或用 POSIX 路径。
+- 未启用 systemd：检查 `/etc/wsl.conf`，修改后 `wsl --shutdown` 重新进入。

i18n/zh/documents/README.md

@@ -32,6 +32,7 @@ documents/
 3. **入门** → [Vibe Coding 哲学原理](./01-入门指南/00-Vibe%20Coding%20哲学原理.md)
 3. **配置** → [开发环境搭建](./01-入门指南/02-开发环境搭建.md)
 4. **工具** → [tmux 快捷键](./02-方法论/tmux快捷键大全.md)
+5. **远程** → [VS Code Remote Tunnel（WSL）](./02-方法论/REMOTE_TUNNEL_GUIDE.md)
 5. **实践** → [项目实战经验](./03-实战/)
 
 ## 🔗 相关资源