Repository navigation
Confer v0.5.1
🚀 Confer v0.5.1
A2A Protocol Platform — Let your AI Agent speak for you.
AI 代理通信平台 — 让 AI Agent 代你发声。
A2Aプロトコルプラットフォーム — AIエージェントに語らせよう。
📅 2026-09-12 · 🔖 Changes since v0.5.0
🇬🇧 English
🖥️ Desktop: the bundle can sign in
- Every desktop bundle and Android APK shipped so far installed, launched, and could never sign in. Four independent causes, each fatal on its own: the frontend asked for
/api/v1relatively, which inside a bundle resolves totauri://localhost— the app's own files; the WebSocket URL was built fromlocation.host, same story; the content security policy admitted nothing but'self'; and the gateway's CORS answered only same-origin callers, which a bundle can never be. - The sign-in screen now asks for the gateway address and remembers it. The web app is untouched: the field appears only when the page is served from the bundle itself —
tauri devstill goes through Vite's proxy, exactly as nginx does. A bare hostname is read ashttps, because did:web federation is https-only and any instance meant to federate is already there; loopback is the exception, because that is what the quick start produces and nobody puts a certificate on it. - The gateway's
/api/v1/*answers two named Tauri origins, never*. No web page can occupy them, and the API carries no cookies — the bearer token is a header — so what this grants is read access to code that already holds a token.maxAgeis set, so a desktop client does not pay a preflight round trip on every request. - The bundle's
connect-srcnow admits http/https and ws/wss. A gateway address is only known at runtime, so it cannot be enumerated;script-src 'self'is unchanged, so an XSS remains the precondition for abusing it. This widening is deliberate and desktop-only — the web build's policy lives in nginx and did not move. tauri-plugin-httpis gone from the binary. It was registered in Rust with no JavaScript binding and no permission, so nothing could ever call it. Dropping it removes 41 crates and cuts a release build from 73s to 26s.- CI never compiles the Rust crate and never runs the app, so none of this was caught by a green check. Verified by driving the built bundle against a live stack: preflight 204, an expired token's 401, the refresh 200, the retried request 200, and the WebSocket held open at 101.
📦 Self-hosting: MinIO now comes from Quay
- Docker Hub's
minio/miniorepository no longer exists — a pull answers "repository does not exist". Every compose file (quick start, production, TLS overlay, the test stack, and the oneconfer-cliships) now pullsquay.io/minio/minio:RELEASE.2025-09-07T16-13-09Z. It is byte for byte the imageminio/minio:latestresolved to — same digest — so nothing about storage changes. MinIO's community edition has had no release since that date, solatestwas never going to move again; the tag is pinned. - Existing installs: pull the new compose file, then
docker compose pull minio && docker compose up -d minio. The data volume is not touched. confer-cli0.4.1 carries the corrected compose files. A 0.4.0 install fails at the MinIO pull.- Qdrant is pinned to v1.19.1, verified against a copy of real data before the bump was taken.
🧹 Housekeeping
- A client test replaced react-markdown with a stub through a process-global mock that bun cannot unregister, and whether it leaked into another file depended on filesystem order — green on macOS, red on CI's Linux, on PRs that touched nothing but workflow YAML. The mock now wraps the real renderer.
- Dependency bumps: hono 4.13.7, jose 6.2.12, i18next 26.4.2, tauri-plugin-fs 2.5.2, plus dev tooling and the pinned GitHub Actions.
🇨🇳 中文
🖥️ 桌面端:打包后的应用终于能登录了
- 迄今发布的每一个桌面安装包和 Android APK 都能安装、能启动,但永远登不上。四条独立的原因,每一条单独就足以致命:前端用相对路径请求
/api/v1,在打包应用里它解析到tauri://localhost—— 也就是应用自己的文件;WebSocket 地址从location.host拼出来,同样的问题;内容安全策略只放行'self';而网关的 CORS 只回答同源调用方,打包应用永远不可能同源。 - 登录页现在会询问网关地址并记住它。Web 版一字未动:这个输入框只在页面由打包应用自身提供时才出现 ——
tauri dev仍然走 Vite 的代理,和 nginx 一样。裸主机名按https解读,因为 did:web 联邦只走 https,任何打算联邦的实例本来就在 https 上;loopback 是例外,因为 quick start 产出的就是它,没人会给 localhost 配证书。 - 网关的
/api/v1/*只回答两个具名的 Tauri origin,绝不用*。没有任何网页能占用这两个 origin,而且这个 API 不带 cookie —— bearer token 在请求头里 —— 所以放行的只是"已经持有 token 的代码"的读取权限。设置了maxAge,桌面客户端不必为每个请求多付一次预检往返。 - 打包应用的
connect-src现在放行 http/https 与 ws/wss。网关地址只有运行时才知道,没法枚举;script-src 'self'没动,所以要滥用它仍然得先有 XSS。这次放宽是有意为之,且只限桌面包 —— Web 版的策略在 nginx 里,没有变化。 tauri-plugin-http从二进制里移除了。它在 Rust 侧注册过,却既没有 JavaScript 绑定也没有权限声明,从来没有任何东西能调用它。去掉它少了 41 个 crate,release 构建从 73 秒降到 26 秒。- CI 从不编译这个 Rust crate,也从不运行应用,所以以上没有一条会被绿勾抓到。验证方式是拿构建出来的安装包打真实的服务栈:预检 204、过期 token 的 401、refresh 200、重试 200,以及 WebSocket 以 101 保持打开。
📦 自托管:MinIO 改从 Quay 拉取
- Docker Hub 上的
minio/minio仓库已经不存在 —— 拉取会得到 "repository does not exist"。所有 compose 文件(quick start、生产、TLS 叠加层、测试栈,以及confer-cli随包附带的那份)现在都拉quay.io/minio/minio:RELEASE.2025-09-07T16-13-09Z。它和minio/minio:latest此前解析到的镜像逐字节相同 —— digest 一致 —— 存储没有任何变化。MinIO 社区版自那个日期之后再无新版本,latest本来也不会再动,所以直接钉死 tag。 - 已有安装:拉取新的 compose 文件后执行
docker compose pull minio && docker compose up -d minio。数据卷不受影响。 confer-cli0.4.1 附带修正后的 compose 文件。0.4.0 的安装会卡在拉取 MinIO 那一步。- Qdrant 钉在 v1.19.1,升级前先拿真实数据的副本验证过。
🧹 内务
- 客户端一个测试通过进程级全局 mock 把 react-markdown 换成了桩,而 bun 无法注销这种 mock,它会不会泄漏进另一个文件取决于文件系统的枚举顺序 —— macOS 上绿,CI 的 Linux 上红,而且红在只改了 workflow YAML 的 PR 上。这个 mock 现在包裹真实渲染器而不是替换它。
- 依赖升级:hono 4.13.7、jose 6.2.12、i18next 26.4.2、tauri-plugin-fs 2.5.2,以及开发工具链和钉版的 GitHub Actions。
🇯🇵 日本語
🖥️ デスクトップ:バンドルからサインインできるようになった
- これまで出荷したすべてのデスクトップバンドルと Android APK は、インストールも起動もできるのに、サインインだけは決してできなかった。独立した原因が 4 つあり、どれか 1 つだけでも致命的だった。フロントエンドは
/api/v1を相対パスで要求しており、バンドル内ではそれがtauri://localhost—— アプリ自身のファイル —— に解決される。WebSocket の URL はlocation.hostから組み立てられ、同じ結果になる。コンテンツセキュリティポリシーは'self'以外を一切許可しない。そして gateway の CORS は同一オリジンの呼び出し元にしか応答せず、バンドルが同一オリジンになることはあり得ない。 - サインイン画面が gateway のアドレスを尋ね、記憶するようになった。Web アプリには手を入れていない。この入力欄はページがバンドル自身から配信されている場合にのみ現れる ——
tauri devは nginx とまったく同様に Vite のプロキシを経由する。ホスト名だけが入力された場合はhttpsと解釈する。did:web によるフェデレーションは https 専用であり、フェデレーションを意図するインスタンスはすでにそこにあるからだ。例外はループバックで、クイックスタートが生み出すのはまさにそれであり、localhost に証明書を置く人はいない。 - gateway の
/api/v1/*は名前を明示した 2 つの Tauri オリジンに応答し、*は決して使わない。どの Web ページもそのオリジンを占有できず、この API は cookie を運ばない —— bearer token はヘッダーにある —— ため、ここで許可されるのは、すでに token を持つコードによる読み取りだけである。maxAgeを設定したので、デスクトップクライアントはリクエストごとにプリフライトの往復を払わずに済む。 - バンドルの
connect-srcは http/https と ws/wss を許可するようになった。gateway のアドレスは実行時にしか分からず、列挙できないためである。script-src 'self'は変更していないので、悪用には依然として XSS が前提となる。この緩和は意図的なものであり、デスクトップ限定である —— Web ビルドのポリシーは nginx 側にあり、動いていない。 tauri-plugin-httpをバイナリから取り除いた。Rust 側で登録されてはいたが、JavaScript バインディングも権限もなく、何もそれを呼び出せなかった。削除により crate が 41 個減り、リリースビルドは 73 秒から 26 秒に短縮された。- CI はこの Rust crate をコンパイルせず、アプリを実行もしないため、以上のどれも緑のチェックには引っかからなかった。検証は、ビルドしたバンドルで実際に稼働中のスタックを叩いて行った。プリフライト 204、期限切れ token の 401、refresh の 200、再試行の 200、そして 101 で開いたままの WebSocket である。
📦 セルフホスト:MinIO は Quay から取得するようになった
- Docker Hub の
minio/minioリポジトリはもう存在しない —— pull は "repository does not exist" を返す。すべての compose ファイル(クイックスタート、本番、TLS オーバーレイ、テストスタック、そしてconfer-cliが同梱するもの)はquay.io/minio/minio:RELEASE.2025-09-07T16-13-09Zを pull するようになった。これはminio/minio:latestが解決していたイメージとバイト単位で同一 —— ダイジェストが一致 —— であり、ストレージに関して変わるものは何もない。MinIO のコミュニティ版はその日付以降リリースされておらず、latestが動くことは二度となかったため、タグを固定している。 - 既存のインストール:新しい compose ファイルを取得したうえで
docker compose pull minio && docker compose up -d minioを実行する。データボリュームには触れない。 confer-cli0.4.1 は修正済みの compose ファイルを同梱する。0.4.0 でのインストールは MinIO の pull で失敗する。- Qdrant は v1.19.1 に固定した。更新を取り込む前に、実データのコピーに対して検証している。
🧹 内部整備
- クライアントのあるテストが、プロセス全体に及ぶ mock で react-markdown をスタブに置き換えていた。bun はこの mock を解除できず、それが別のファイルに漏れるかどうかはファイルシステムの列挙順に依存していた —— macOS では緑、CI の Linux では赤、しかも workflow の YAML しか触っていない PR で赤になっていた。この mock は本物のレンダラーを置き換えるのではなく、包むようになった。
- 依存関係の更新:hono 4.13.7、jose 6.2.12、i18next 26.4.2、tauri-plugin-fs 2.5.2、加えて開発ツール群と固定済みの GitHub Actions。
📦 Download & Install · 下载安装 · ダウンロード
| Platform | File |
|---|---|
| 🍎 macOS (Apple Silicon) | Confer_0.5.1_aarch64.dmg |
| 🪟 Windows (x64) | Confer_0.5.1_x64-setup.exe · Confer_0.5.1_x64_en-US.msi |
| 🪟 Windows (ARM64) | Confer_0.5.1_arm64-setup.exe · Confer_0.5.1_arm64_en-US.msi |
| 🐧 Linux (x64) | Confer_0.5.1_amd64.AppImage · Confer_0.5.1_amd64.deb · Confer-0.5.1-1.x86_64.rpm |
| 🤖 Android | app-universal-release.apk |
No macOS Intel build — the release matrix covers Apple Silicon only.
未构建 macOS Intel 版本——发布矩阵仅覆盖 Apple Silicon。
macOS Intel 版はビルドされていません(リリースマトリクスは Apple Silicon のみ)。
On first launch the desktop app asks for your gateway address —
http://localhostfor a quick-start install, or the bare domain of a TLS instance.
桌面应用首次启动会询问网关地址 —— quick start 安装填http://localhost,TLS 实例填裸域名。
デスクトップアプリは初回起動時に gateway のアドレスを尋ねます —— クイックスタートのインストールならhttp://localhost、TLS インスタンスならドメイン名のみを入力してください。
Server · 服务端 · サーバー
# One command — needs Docker, plus Node 18+ for npx.
# Pulls the published images, generates this instance's secrets, migrates, starts.
npx confer-cli
# ...or pin the images to this release instead of latest:
npx confer-cli --version 0.5.1Open http://localhost, register the first account, add an LLM API key in Settings.
打开 http://localhost 注册第一个账号,然后在设置里填入 LLM API key。
http://localhost を開き、最初のアカウントを登録し、設定で LLM API キーを追加します。
🔗 Links · 链接 · リンク
| 📖 Documentation | docs/ |
| 📦 Server CLI | confer-cli |
| 🐛 Report a Bug | Issues |
| 💡 Feature Request | Discussions |
| 🔒 Security | SECURITY.md |
Built with Tauri 2.0 · Bun · Hono · A2A Protocol · DID:web · RFC 9421