故障排查

1. 无法连接到 Server

先检查：

• Protocol 是否正确
• Host 和 Port 是否正确
• Base Path 是否正确
• 目标 Server 是否真的在运行
• 浏览器当前是否能访问这个地址

如果你刚更新过扩展代码，先执行：

npm run build:extension

然后刷新扩展。

2. 当前连接要求 Token

如果你看到：

• Missing bearer token
• Invalid bearer token
• Permission denied

通常说明目标 Server 已开启统一鉴权，但当前连接还没有可用 Token。

处理方式：

1. 打开扩展设置页
2. 选中对应连接
3. 在本机终端执行 town token create my-token
4. 把 token 粘贴到设置页并保存

3. 远程机器上服务没有对外暴露

如果你访问的是远程机器，还需要确认 Console 本身不是只绑定在本机回环地址。

从 town 的代码看：

• 未传 --host / --public 时，Console 默认仍是本机模式 127.0.0.1
• 传 --public 时，会绑定 0.0.0.0

通常可以这样启动：

town start --public

或者：

town console start --public

如果你希望之后每次启动都沿用公网绑定，可以执行：

town public on

4. 没有可用 Agent

通常表示：

• town agent start 还没启动
• 当前连接地址不对
• 当前 Agent 没有处于运行状态

5. 没有可用 Session

扩展不会凭空创建 Session。

这通常意味着：

• 对应渠道还没有产生过历史会话
• 当前 Agent 没有关联的聊天渠道
• 你当前连接下的默认 Session 已失效，需要重新选择

6. 抓到的正文不对

全页抓取是 best-effort，不是浏览器阅读模式的完全克隆。

当前逻辑会：

• 优先选择最像正文的 main/article
• 过滤导航、侧边栏和隐藏内容
• 尝试合并多个强相关主体区块

如果页面结构非常特殊，仍然可能抓到多余内容。