CodeBridge 的官方介绍页 · Official intro site for CodeBridge.
手机收到短信验证码,点一下就能填到你正在用的网页里。
When the code arrives on your phone, send it to the webpage you're working on — only when you ask.
本仓库为静态落地页(index.html 英文默认 · zh.html 中文)。产品使用说明见下文;实现与隐私以主项目 CodeBridge 为准。
CodeBridge 由两部分组成,在同一局域网(通常同一 Wi‑Fi)下协同工作:
| 组件 | 说明 |
|---|---|
| Android 收码端 | 读取短信中的验证码,在本地解析后通过局域网 HTTP 提供 |
| Chromium 浏览器扩展 | 在你当前标签页、手动触发时,从手机拉取验证码并填入网页输入框 |
特点:不把整段短信上传云端;默认只传 4–8 位验证码;每次填码需你点击扩展或快捷键,页面会先显示提示横幅。
MVP 范围:收码端仅 Android;填码端为 Chrome / Edge 等 Chromium 浏览器;手机与电脑需在同一局域网。
- Android 手机(收短信验证码的设备)
- 电脑 + Chrome 或 Edge(Chromium 内核)
- 手机与电脑连接同一 Wi‑Fi(或同一局域网)
- 从主项目获取并安装:
- Android 应用:仓库
android-app/ - 浏览器扩展:仓库
chrome-extention/
- Android 应用:仓库
- 用 Android Studio 打开主仓库的
android-app/构建安装包,或安装已分发的 APK(视你的获取渠道而定)。 - 首次打开时,按提示授予与短信 / 验证码相关的权限(用于从短信中识别那几位数字)。
- 保持应用在后台可用,以便接收新短信并解析验证码。
敏感权限说明与上架要求见主项目
android-app/README.md。
开发 / 自测(加载已解压扩展):
- 打开
chrome://extensions(Edge 为edge://extensions)。 - 开启「开发者模式」。
- 选择「加载已解压的扩展程序」,指向主仓库中的
chrome-extention/目录。
日常使用: 安装完成后,扩展会出现在浏览器工具栏。
- 确认手机与电脑在同一 Wi‑Fi 下。
- 在 Android 应用中查看配对信息(二维码或配对码;手机端局域网服务默认端口 37653)。
- 在 扩展选项页中配置手机的局域网地址(例如
http://192.168.x.x:37653)并完成配对流程。 - 在手机上确认允许与此电脑配对(带外确认,类似蓝牙配对)。
- 配对成功后获得绑定 token;扩展会保存会话信息(关闭浏览器后可能需要重新配对,见主项目说明)。
配对相关接口(供联调参考):POST /v1/pair/hello、GET /v1/pair/result;拉码:GET /v1/otp/latest(需 Authorization: Bearer <token>)。
- 在电脑浏览器中打开需要填写验证码的网页,并聚焦到该标签页。
- 等待手机收到短信验证码(应用会在本地解析)。
- 点击扩展图标,在弹窗中选择「从手机拉取并填入」;或使用快捷键(默认可在
chrome://extensions/shortcuts中查看/修改,如Ctrl+Shift+Y)。 - 页面顶部会先出现简短提示横幅,再将验证码写入当前页的输入框(优先
autocomplete="one-time-code"等字段)。
不会自动静默填码——必须你主动触发。
| 问题 | 说明 |
|---|---|
| 会收集我的短信吗? | 不会上传整段短信。仅提取验证码数字,并在已配对的手机与电脑之间局域网传输。 |
| 支持 iPhone 吗? | MVP 收码端仅支持 Android。 |
| 手机和电脑不在同一 Wi‑Fi? | 当前版本需同一局域网才能配对与传码。 |
| 换网络或重启后要重新配对吗? | 绑定 token 默认以内存会话为主,结束进程或关闭浏览器后可能需要重新配置/配对,见主项目实施包。 |
| 文件 | 语言 |
|---|---|
index.html |
English(默认) |
zh.html |
简体中文 |
导航栏可切换 English ↔ 中文。
产品问题、使用疑问或官网文案建议,请提交 Issue:
https://github.com/intellicubex/CodeBridgeWebsite/issues
技术规格与隐私草稿见主项目:
docs/sms-otp-autofill-implementation-pack.md