feat(chrome-qwen-bridge): 🔥 init chrome qwen code bridge

This commit is contained in:
yiliang114
2025-12-20 00:58:41 +08:00
parent a92be72e88
commit a60c5c6697
57 changed files with 9489 additions and 0 deletions

View File

@@ -0,0 +1,121 @@
# 📦 Chrome Qwen Bridge - 安装指南
## 🚀 快速安装(推荐)
### 一键安装(首次用户)
```bash
# 进入项目目录
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开发者模式安装当前
```bash
# 步骤 1安装扩展和 Native Host
npm run install:all
# 步骤 2启动调试
npm run dev
```
### 场景 3分步安装
```bash
# 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` | 清理所有配置和日志 |
## 🔄 更新和重装
如果需要重新安装:
```bash
# 清理旧配置
npm run clean
# 重新安装
npm run install:all
```
## 📚 更多信息
- [调试指南](./docs/debugging.md)
- [API 文档](./docs/api-reference.md)
- [架构设计](./docs/architecture.md)