# AskBridge
[简体中文](README.md) | [English](README_EN.md)
AskBridge 是一个 Windows 截图问答工具。框选屏幕内容后，可以复制截图、切换 AI 模型，或将截图和预设文字准备到 AI 网页的输入区。最终是否发送始终由用户决定。
## 演示
77 秒演示片，走完从 `Alt+Q` 框选到把截图与提示词准备进 AI 网页输入区的完整流程。片中的网页与日志全部是**虚构演示数据**（域名一律用保留的 `.invalid`），不出现任何真实账号、对话或项目内容。
▶ 观看完整演示（77 秒 · 1080p · MP4）
## 下载与打开
方法一：
AskBridge 需要 64 位 Windows 10 或更高版本，以及 Microsoft Edge WebView2 Runtime（Windows 10/11 通常已内置；界面文字目前为简体中文）。
1. 前往 [GitHub Releases](https://github.com/wanghongyu666qiang/AskBridge/releases) 下载最新版 `AskBridge-版本号-Setup.exe`。
2. 双击安装程序，在安装窗口中选择一个独立的安装目录，并按需选择桌面快捷方式、开始菜单快捷方式和登录后自动启动。安装器不会默认选择 C 盘目录。
3. 点击“安装”完成安装，然后通过所选快捷方式运行 AskBridge。程序启动后常驻 Windows 托盘，右键托盘图标可以打开设置或退出。
AskBridge 启动后会在后台检查 GitHub Releases，此后每 24 小时检查一次。发现新版本时会显示托盘通知；也可以右键托盘图标选择“检查更新”。通过 `Setup.exe` 安装的版本只有在你确认后，才会把官方安装包下载到 `data/Updates` 并在设置窗口显示进度，核对发布页提供的 SHA-256 以及维护者的离线 Ed25519 签名，正常退出、原位置升级并重新启动。如果安装器启动失败，可以从托盘菜单再次选择“安装”，直接使用已校验的安装包，无需重新下载。更新会保留全部 `data`；失败时恢复原程序。便携版会提示新版本，但需要从官方 Release 手动替换程序文件。
普通用户不需要打开 PowerShell，也不需要运行仓库 `scripts` 目录中的任何命令。
在本仓库参与开发时，编译后的调试程序位于 `target/debug/askbridge.exe`，发布程序位于 `target/release/askbridge.exe`。
方法二：微软商店搜索：AskBridge
## 快捷键
| 快捷键 | 操作 |
| --- | --- |
| `Alt+Q` | 框选截图并显示工具条 |
| `Alt+Shift+Q` | 框选后使用默认模型和快速提示词准备网页内容，不显示工具条 |
| `Alt+W` | 打开默认模型网页，直接在网页中输入文字 |
| `Esc` | 在截图界面取消 |
| `Enter` | 在截图工具条中确认使用当前模型 |
在截图工具条中切换模型后，新选择会保存为下次的默认模型。只有点击工具条“复制”、从托盘选择“复制上次截图到剪贴板”，或使用明确的通用粘贴路径时，才会把截图写入剪贴板。
## 浏览器选择
AskBridge 支持 ChatGPT、Gemini、Claude、豆包、DeepSeek、智谱清言（GLM）、Kimi 和自定义 HTTPS 供应商。
ChatGPT 可以在“设置 > 浏览器”中选择四种打开方式：
- **桌面网页端**：复用现有登录；截图请求会聚焦唯一可确认的输入区并执行一次 Ctrl+V，确认出现新的附件结构后才报告准备完成，最终仍由你手动发送。纯文字请求只打开页面。
- **AskBridge 专用 Chrome**：支持自动上传截图，需要在独立浏览器中登录一次。
- **通用粘贴**：把截图写入剪贴板，聚焦目标浏览器网页或受支持的 AI 桌面客户端窗口后模拟一次 Ctrl+V，由你确认并手动发送。该模式可以使用日常浏览器或 ChatGPT、Claude、豆包桌面客户端中的登录状态；AskBridge 只在唯一输入区附近检测到稳定的新附件结构后报告准备完成。找不到匹配窗口时会用默认浏览器打开新页面；如果粘贴已经执行但附件状态仍不确定，AskBridge 会停止并要求你先检查页面，不会自动再次粘贴。
- **专用 Chrome 优先，安全失败后通用粘贴**：截图请求先由专用 Chrome 准备；仅当失败发生在写入任何文字或附件之前，才自动改用一次 Ctrl+V。若可能已经部分写入，AskBridge 会停止而不会再次粘贴。纯文字请求仍只使用专用 Chrome。
专用 Chrome 使用独立的 `BrowserProfile`，不会连接或修改日常 Chrome 配置。
## 使用边界
- AskBridge 不调用模型 API，也不运行本地模型。
- AskBridge 不读取密码、验证码、Cookie、网页正文或历史对话。
- AskBridge 不记录问题原文、截图内容、剪贴板内容或完整聊天 URL。
- AskBridge 不自动点击网页发送按钮，所有请求的 `auto_submit` 固定为 `false`。
- 登录失效、网页结构变化或附件准备失败时，本次操作会停止并显示原因。
## 数据位置
- 源码开发环境：仓库根目录下的 `data`（从 `target` 中的调试程序运行时自动识别）
- 安装版或便携版：`askbridge.exe` 同目录下的 `data`
- 自定义位置：设置绝对路径环境变量 `ASKBRIDGE_DATA_DIR`
配置、日志、专用浏览器资料和更新缓存分别位于 `data/config.json`、`data/logs`、`data/BrowserProfile` 和 `data/Updates`。网页上传使用的临时截图会为异步读取保留最多 10 分钟后删除；程序异常退出遗留的临时文件和已使用或遗留的更新安装包会在后续启动时清理。
更多信息见 [隐私说明](docs/PRIVACY.md)、[故障排查](docs/TROUBLESHOOTING.md)、[安全策略](SECURITY.md) 和[更新日志](CHANGELOG.md)。
## 开发
需要 stable Rust、Windows GNU 或 MSVC 构建链，以及 Microsoft Edge WebView2 Runtime。
```powershell
cargo fetch --locked
cargo test --workspace --locked --offline
cargo build --workspace --release --locked --offline
cargo run --package xtask --locked --offline -- help
```
`scripts` 目录是项目维护自动化，不是用户操作步骤：
- `build.ps1` 和 `test.ps1` 是日常构建与测试入口。
- `package.ps1` 和 `test-release-local.ps1` 是打包与完整发布验收入口。
- `test-*` 和 `validate-*` 是被上述入口调用的独立检查器，用于验证安装、路径保护和真实 UI。
- `measure-*` 是独立的性能测量辅助脚本，需要分析性能时手动运行。
- `cargo xtask` 承担可纯 Rust 测试的性能报告与发布产物验证逻辑。
- `Install-AskBridge.ps1` 与 `Uninstall-AskBridge.ps1` 会被打包进发布产物。
发布维护命令
完整本地发布验收：
```powershell
./scripts/test-release-local.ps1 -AcceptanceRoot D:/AskBridge/target/release-local-acceptance-20260902
```
`AcceptanceRoot` 必须替换为当前仓库 `target` 目录下尚不存在的新绝对路径。
生成安装包和便携包时必须显式指定一个空目录：
```powershell
./scripts/package.ps1 -ArtifactRoot D:/你选择的发布目录
```
脚本不会默认把发布产物写入 C 盘。
推送普通提交只会运行 CI，不会创建 Release。发布时先确保 `Cargo.toml` 中的版本号已更新并完成本地验收，再推送与版本号完全一致的 `vX.Y.Z` 标签；`.github/workflows/release.yml` 会在 Windows MSVC 环境自动复查格式、Clippy、测试和发布构建，生成安装包、便携包及 SHA-256 文件并用仓库密钥对哈希清单做离线 Ed25519 签名，然后创建 GitHub Release：
```powershell
git push origin main
git tag vX.Y.Z
git push origin vX.Y.Z
```
发布依赖 GitHub Actions 保密项 `UPDATE_SIGNING_KEY` 中保存的签名私钥（十六进制）。本地生成密钥对使用：
```powershell
cargo xtask gen-update-key --output <绝对路径>
```
本地打包同样必须提供 `-UpdateSigningKeyFile` 或环境变量 `ASKBRIDGE_UPDATE_SIGNING_KEY`，否则打包会直接失败。
## 许可证
本项目基于 [Apache License 2.0](LICENSE) 开源。
## 合作伙伴
推广合作伙伴:[BizBot-AI自动推广系统](https://bizbot.zvo.cn/)(雷鸣云有限公司）
[](https://www.orcarouter.ai/ref/ref_3331abbb338d93b7f9c3)