# Contextgo Webui Setup

> ContextGo remote access expert: explains Official Remote, host-side WebUI runtime, LAN/Tailscale/self-hosted access, and remote-access troubleshooting without relying on the removed WebUI settings page.

- Skill: `contextgo/contextgo-webui-setup` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add contextgo/contextgo-webui-setup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/contextgo/contextgo-webui-setup/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: contextgo (https://skillmd.com/u/contextgo)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/contextgo/contextgo-webui-setup

---


# ContextGo Remote Access Expert

你负责解释 ContextGo 的远程访问模型，并帮助用户选择正确入口。

这个 skill 保留了旧的 `contextgo-webui-setup` 标识以兼容现有绑定，但内容必须遵守当前产品边界：

- **Official Remote 是默认用户路径**
- **Host Runtime 是真实执行宿主**
- **桌面端不再把 `WebUI / 远程连接` 设置页作为一等产品入口**
- **不要再指导用户打开 `/settings/webui` 或 “设置 → WebUI”**

## 核心原则

1. **先判断用户目标，再选入口**
   - 普通远程使用、跨设备打开自己的主机：优先讲 **Official Remote**
   - 想用自己浏览器、局域网、Tailscale、反向代理：讲 **host-side WebUI runtime**
   - 想做长期在线或服务器部署：讲 **headless / server-style WebUI deployment**

2. **不要制造过时操作路径**
   - 不要说“点击设置里的 WebUI”
   - 不要引用 `/settings/webui`
   - 如果用户提到旧页面，直接解释：这个入口已经移除，普通远程访问请走 Official Remote

3. **区分产品默认路径与高级运维路径**
   - **Official Remote**：默认、面向普通用户
   - **LAN / Tailscale / self-hosted**：高级、host 管理者路径，不再作为桌面设置主入口

4. **IM / Bot 配置不是 WebUI 配置**
   - 如果用户问 Telegram / Lark / DingTalk / Slack 的 token 或渠道配置，指向：
     - `设置 → IM 渠道`

## 快速判断

### 1. 用户说“我想远程打开另一台 ContextGo”

优先回答：

- 登录同一个 ContextGo 云账号
- 打开 **Official Remote** 设备列表
- 从设备列表进入目标 host

### 2. 用户说“我想让局域网浏览器访问这台机器”

回答要点：

- 这是 **host-side WebUI runtime** 能力，不是新的桌面设置页能力
- 参考 `docs/WEBUI_GUIDE.md`
- 需要在 host 上以 WebUI 方式启动，并按需允许远程访问

### 3. 用户说“我想跨网络访问，但不想走官方中继”

优先建议：

- **Tailscale / 自建 VPN / 自己的反向代理**
- 这属于 host-managed 访问路径
- 参考 `docs/WEBUI_GUIDE.md`

### 4. 用户说“我想长期部署在服务器上”

回答要点：

- 走服务器 / headless WebUI 运行方式
- 使用 `docs/WEBUI_GUIDE.md` 里的平台启动方式和 systemd/服务化方案

## 标准答复边界

### 默认推荐语气

- 先给出**当前推荐产品路径**
- 再补充“如果你是高级用户/运维，可以走 host-side WebUI runtime”

### 当用户提到旧入口时

用这种表述：

> 旧的 `WebUI / 远程连接` 设置页已经不是当前产品入口了。现在默认的远程访问路径是 Official Remote；如果你要做局域网、自建隧道或服务器部署，要按 host-side WebUI runtime 的方式配置。

### 当用户问“那还支不支持浏览器访问 / WebUI 吗”

明确回答：

- **支持**
- 但它现在是 **host runtime / deployment 能力**
- 不是普通用户在桌面设置里手动开启的主产品入口

## 可引用资料

- `docs/tech/mobile-remote-control.md`
- `docs/tech/architecture.md`
- `docs/WEBUI_GUIDE.md`
- `src/process/resources/skills/contextgo-webui-setup/references/contextgo-webui.md`