Architecture & Code Tour
AI Translation Notice
This page is an English translation of the authoritative Chinese architecture guide. Refer to the Chinese version in case of discrepancies.
ModelBridge separates shared gateway core logic (_worker.js), platform runtime adapters (src/platforms/), remote/SQLite state primitives (src/state/ & src/self-hosted/), and packaging/admin tooling (tools/).
Interactive Architecture Diagram
Module Responsibilities & Source Guide Index
| Module / Path | Responsibility | Source Reference |
|---|---|---|
_worker.js | Portal/admin UI, 4-domain auth, AppConfigStore DO, routing, protocol translation, fetchUpstream | repo-docs/walkthroughs/one-real-run.md |
src/platforms/ | cloudflare.mjs, edgeone.mjs, esa.mjs, shared.mjs (PLATFORM_LIMITS & runPlatformRequest) | repo-docs/modules/platform-adapters.md |
src/state/ | remote.mjs (2 MiB/16 MiB RPC), service.mjs (DO RPC server), sqlite.mjs (WAL + BEGIN IMMEDIATE) | repo-docs/modules/access-and-config.md |
src/self-hosted/server.mjs | Node.js 24 state HTTP service (127.0.0.1:8788, /_modelbridge/state, strict origin/token checks) | repo-docs/modules/platform-adapters.md |
tools/ | build-platforms.mjs (6 dist/ bundles), state-admin.mjs, verify-*.mjs, repo_maintenance_guard.py | Code Map & Module Reference |
Detailed source-verified guides live in Chinese under
repo-docs/in the repository; browse the English navigation stubs at Source Guide Index and Code Map Reference.
Contributor Workflow & Guards
sh
pnpm run check
node --test tests/*.test.mjs
node tools/build-platforms.mjs- Commits are checked by
tools/repo_maintenance_hooks(tools/repo_maintenance_guard.py) for Conventional Commit subjects and accidental secret/local-path leakage. Never bypass hooks with--no-verify. - See
CONTRIBUTING.mdandSECURITY.mdat the repository root for contribution and vulnerability disclosure policies.
Next Steps
- Read key architectural decisions and the DO-to-SQLite migration runbook in Architecture Decisions & Migrations.