diff --git a/CHANGELOG.md b/CHANGELOG.md index 20818c4..b7df60c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -15,3 +15,4 @@ - 清退 `ccxt`、`claude-code-guide`、`claude-cookbooks`、`coingecko`、`cryptofeed`、`ddd-doc-steward`、`headless-cli`、`hummingbot`、`markdown-to-epub`、`polymarket`、`postgresql`、`proxychains`、`snapdom`、`sop-generator`、`telegram-dev`、`timescaledb`、`tmux-autopilot`、`twscrape` 等 Skill 目录,仅保留 `auto-skill` 与 Claude 官方 skills 软链接入口。 - 清退 `docs/case-studies/` 实战案例目录,并同步更新 docs 索引、目录级 AGENTS、metadata、labeler 和相关 README 链接口径。 - 清退 `docs/playbooks/` 下 7 个工具型/旧方法论文档,并同步更新 playbooks 索引、README、学习地图与相关概念页链接。 +- 清退 `docs/playbooks/REMOTE_TUNNEL_GUIDE.md`,继续收缩工具型旧文档。 diff --git a/docs/playbooks/README.md b/docs/playbooks/README.md index 878d563..6c87654 100644 --- a/docs/playbooks/README.md +++ b/docs/playbooks/README.md @@ -6,7 +6,6 @@ - [ProxyCast 配置](ProxyCast配置文档.md) - AI 凭证代理服务配置 - [TradeCat Sheets API 使用说明](tradecat-sheets-api-usage.md) - 把公开 Google Sheet 当作 API 注册表与数据面(Data Plane) -- [VS Code Remote Tunnel(WSL)](REMOTE_TUNNEL_GUIDE.md) - 在 WSL 内开通 VS Code Tunnel 供远程访问 - [GEMINI-HEADLESS](GEMINI-HEADLESS.md) - Gemini 无头模式配置 ## 🛠️ 开发经验 diff --git a/docs/playbooks/REMOTE_TUNNEL_GUIDE.md b/docs/playbooks/REMOTE_TUNNEL_GUIDE.md deleted file mode 100644 index 0db83e3..0000000 --- a/docs/playbooks/REMOTE_TUNNEL_GUIDE.md +++ /dev/null @@ -1,67 +0,0 @@ -# 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 # 重命名隧道 -/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` 重新进入。