安装与连接

前置条件

在使用扩展前，通常需要先启动 Downcity 服务：

town start
town agent start

如果你是从仓库本地加载扩展，还需要先构建产物：

npm run build:extension

在 Chrome 中加载

1. 打开 chrome://extensions
2. 打开右上角 开发者模式
3. 点击 加载已解压的扩展程序
4. 选择 products/chrome-extension/dist

第一次需要配置什么

扩展默认会带一个连接，默认地址是：

• Protocol: http
• Host: 127.0.0.1
• Port: 5315
• Base Path: 空

如果你的 Server 不在默认地址，打开扩展设置页进行修改。设置页现在主要分成四块：

• Server Connections：管理多个连接
• Authentication：为当前连接配置 Bearer Token
• Default Routing：为当前连接选择默认 Agent / Session
• Default Ask：设置 Popup 默认 Ask

如何新增多个连接

你可以在设置页中：

1. 点击 新建连接
2. 填写连接名称、Host 和 Port
3. 如果远程服务使用 HTTPS 或挂在子路径下，补充 Protocol 和 Base Path
4. 如有需要，填写该连接专属的 Bearer Token
5. 点击保存

保存后，Popup 中就可以直接切换这些连接。

如何获取 Token

如果目标 Server 开启了统一鉴权，可以先在本机终端执行：

town token create my-token

如果你更喜欢交互式流程，也可以直接执行：

town token

然后把得到的 token 粘贴到设置页的 Bearer Token。

Agent 和 Session 怎么选

扩展会先读取当前连接上的 Agent 列表，再读取该 Agent 下可用的 Session 列表。

如果没有可用 Session，通常说明：

• 对应聊天渠道还没有产生过历史会话
• Agent 还没有运行
• 当前连接地址配置错误
• 远程 Console 没有以公网模式监听，或服务器防火墙未放行端口

如果是服务器部署，你可以选择用 town start --public 单次启动公网 Console，或者用 town public on 持久化公网模式。

更新扩展后该做什么

每次改了 extension 代码后，先重新构建：

npm run build:extension

然后回到 chrome://extensions，点击扩展的刷新按钮。