v0.3

NextBridge v0.3.0

Warning

Document isn't updated yet (still v0.2)

This release is a major bridge and infrastructure update focused on QQ/NapCat forwarding, cross-platform command improvements, deployment usability, and migration robustness.

🚨 Breaking Changes / Upgrade Notes 🚨

• Configuration and integration behavior changed in several areas:
  • HTTP port default
  • webhook_path handling model
  • command prefix flow
  • naming changes around user/nickname/username
  • napcat driver is renamed to qq
• If you are upgrading from older 0.x builds, verify:
  • Migration path and database version state
  • QQ/NapCat forwarding templates and asset URL settings
  • Command routing (/ping and prefix-triggered commands)
  • Any deployment assumptions tied to old HTTP defaults

Highlights

• Added broad QQ/NapCat forwarding improvements, including merged-forward handling and CQ face rendering enhancements.
• Added QQ protocol expansion with Lagrange and OneBot v11 support.
• Added Docker support (Dockerfile + docker-compose) and automated Docker image workflows.
• Introduced shared FastAPI HTTP server architecture and improved media fetching reliability.
• Improved cross-platform ping and command behavior across multiple drivers.

Added

• Docker deployment support with:
  • Dockerfile
  • docker-compose integration
  • CI workflows for image build/push and Docker Hub support
• Built-in command prefix support and command help hinting when typing command prefixes.
• Cross-platform ping by nickname and improved target resolution.
• QQ driver improvements:
  • ws_ssl_verify configuration
  • qid support
  • Lagrange / OneBot v11 protocol support
• Mattermost username fetching support.
• Database migration support and db_version-based migration management.
• New quality/dev tooling integrations (ruff/ty hooks and workflow integration).

Improved

• QQ/NapCat forward rendering pipeline:
  • Better merged-forward rendering behavior
  • Reduced forwarding node logs
  • Improved mention/reply handling for QQ -> Discord forwarding
  • Better handling for untrusted QQ UIDs in forwarding logic
• Media and HTTP reliability:
  • Media fetching retries improved
  • HTTP server startup logging improved
  • Uvicorn log capture improvements
• Telegram forwarding:
  • Added image padding strategy to avoid Telegram API aspect-ratio constraints
  • Added command pass-through for /ping
• CQ face assets and mapping:
  • Expanded CQ face map/gif database coverage
  • Unicode fallback mapping completed and refined
  • Forward assets moved from base64-heavy flow toward hosted asset flow

Fixed

• Discord bot sending now falls back to user_id when username is unavailable (instead of unsafe content fallback paths).
• Cross-platform mentions now only match bound users.
• Prevented mention-spam behavior in Discord by tightening allowed_mentions handling.
• Fixed QQ forward behavior so voice/video messages no longer send rich headers incorrectly.
• Fixed HTTP server start logging issue.

Changed

• Default HTTP server port changed to 9080.
• webhook_path is no longer treated as a secret value.
• “user” naming was refactored toward “nickname”/“username” semantics in core message fields.
• Migration versioning now uses database schema versioning (db_version) instead of app version coupling.
• Replaced python-olm dependency path with fresholm.
• Project documentation was moved out of this repository (docs folder removed here).

Internal / Maintenance

• Multiple lint/style autofix passes and workflow cleanup updates.
• CI/workflow conditions and developer tooling recommendations updated.

Full Changelog: v0.2.1...v0.3

v0.2.1

Just... IDK.

Maybe only README updates

What's Changed

• v0.2.1 by @wyf9 in #13

Full Changelog: v0.2...v0.2.1

v0.2

What's Changed

Features

• Added Matrix end-to-end encryption (E2EE) support.
• Added proxy support for Webhook and Slack.
• Set Feishu WebSocket mode as the default.
• Added Telegram avatar proxy support.
• Added proxy passthrough for source media/attachment downloads.
• Added optional id field support in rule configuration.

Bug Fixes

• Fixed cross-platform reply compatibility issues.
• Fixed driver exception handling to prevent message send interruptions.
• Fixed Discord Webhook reply formatting.
• Optimized driver loading to only load drivers enabled in config (#9).
• Fixed special character replacement handling in Feishu.

Documentation & Tooling

• Updated documentation with icons, feature links, and platform support details.
• Added Ruff workflow for code quality checks.
• Improved logging output and log-level display.
• Fixed version display on startup.

Other Improvements

• Updated Matrix dependency from python-olm to vodozemac.
• Improved proxy configuration: support proxy = null to disable proxy, plus better type hints.
• Added ready-to-use default configuration.
• Improved Richheader page appearance.

PRs

• Bump aiohttp from 3.12.15 to 3.13.3 by @dependabot[bot] in #2
• Bump cryptography from 44.0.3 to 46.0.5 by @dependabot[bot] in #1
• typo: {username} -> {user} by @phanen in #3
• fix: don't echo back to the same instance by @phanen in #4
• feat: custom proxy by @wyf9 in #5
• retry correctly on network error by @phanen in #6
• Bump pyasn1 from 0.6.2 to 0.6.3 by @dependabot[bot] in #7
• fix: AttributeError: module 'loguru' has no attribute 'Record' by @phanen in #8
• v0.2 by @wyf9 in #12

New Contributors

• @dependabot[bot] made their first contribution in #2
• @wyf9 made their first contribution in #5

Full Changelog: https://github.com/siiway/NextBridge/commits/v0.2