qwen-code/packages/chrome-qwen-bridge/INSTALL.md

📦 Chrome Qwen Bridge - 安装指南

🚀 快速安装（推荐）

一键安装（首次用户）

# 进入项目目录
cd packages/chrome-qwen-bridge

# 运行安装向导
npm run install:all

这个命令会：

1. ✅ 引导你安装 Chrome 扩展
2. ✅ 自动配置 Native Host
3. ✅ 保存扩展 ID 供后续使用
4. ✅ 启动调试环境

📝 安装方式说明

场景 1：从 Chrome Web Store 安装（未来）

当扩展发布到 Chrome Web Store 后：

1. 从商店安装扩展
2. 运行 npm run install:host（会自动检测已安装的扩展）
3. 完成！

场景 2：开发者模式安装（当前）

# 步骤 1：安装扩展和 Native Host
npm run install:all

# 步骤 2：启动调试
npm run dev

场景 3：分步安装

# 1. 仅安装 Chrome 扩展
npm run install:extension

# 2. 仅配置 Native Host
npm run install:host

# 3. 启动开发环境
npm run dev

🔧 Native Host 说明

什么是 Native Host？

Native Host 是一个本地程序，允许 Chrome 扩展与本地应用（如 Qwen CLI）通信。出于安全考虑，Chrome 要求必须手动安装。

智能安装器特性

我们的 smart-install.sh 脚本会：

1. 自动检测 - 尝试自动找到已安装的扩展
2. 保存配置 - 记住扩展 ID，下次无需输入
3. 通用模式 - 即使没有扩展 ID 也能配置
4. 连接测试 - 可选的连接验证

安装位置

Native Host 配置文件位置：

• macOS: ~/Library/Application Support/Google/Chrome/NativeMessagingHosts/
• Linux: ~/.config/google-chrome/NativeMessagingHosts/

❓ 常见问题

Q: 必须手动安装 Native Host 吗？

A: 是的，这是 Chrome 的安全要求。但我们的智能安装器让这个过程非常简单。

Q: 如何找到扩展 ID？

A:

1. 打开 chrome://extensions/
2. 找到 "Qwen CLI Bridge"
3. ID 显示在扩展卡片上（类似 abcdefghijklmnop...）

Q: 重装扩展后需要重新配置吗？

A: 如果扩展 ID 改变了，需要重新运行 npm run install:host。脚本会自动检测新的 ID。

Q: 如何验证安装成功？

A: 运行 npm run dev，如果能看到插件图标并能点击连接，说明安装成功。

📋 命令参考

命令	说明
npm run install:all	完整安装向导
npm run install:extension	仅安装扩展
npm run install:host	仅配置 Native Host
npm run dev	启动调试环境
npm run clean	清理所有配置和日志

🔄 更新和重装

如果需要重新安装：

# 清理旧配置
npm run clean

# 重新安装
npm run install:all

📚 更多信息

• 调试指南
• API 文档
• 架构设计