Skip to content

v0.2.0

Pre-release
Pre-release

Choose a tag to compare

View all tags
@MapleMapleCat MapleMapleCat released this 16 Jul 01:41
v0.2.0
ac3f009

Database incompatibility / 数据库不兼容

Warning

v0.2.0 is not database-compatible with v0.1.0. Do not start v0.2.0 with an existing v0.1.0 SQLite database.

v0.2.0 与 v0.1.0 的数据库不兼容。请勿让 v0.2.0 直接使用现有的 v0.1.0 SQLite 数据库。

Before upgrading, stop v0.1.0 and back up its database file or Docker volume. Start v0.2.0 with a new database path or volume, then recreate or manually migrate the required users, tiers, API keys, invite codes, and runtime settings. In-place upgrades and downgrades using the same database are not supported.

升级前请先停止 v0.1.0，并备份数据库文件或 Docker 数据卷。请为 v0.2.0 使用新的数据库路径或数据卷，再按需重新创建或手动迁移用户、等级、API Key、邀请码及运行时设置。不支持在同一个数据库上直接升级或降级。

Project naming

  • Unified the project, executable, MCP implementation, panel, Docker Compose service, and documentation under the grok-search-mcp name.
  • Renamed release archives and their contained executable from grok-mcp to grok-search-mcp.
  • Published the multi-platform Docker image as maplemaplecat/grok-search-mcp:v0.2.0.
  • Renamed the default database file to grok-search-mcp.db and the Compose volume to grok-search-mcp-data.
  • Added GROK_SEARCH_MCP_* environment variables while retaining the former GROK_MCP_* names as compatibility aliases.

Highlights

  • Added bounded keyset pagination throughout the user and administration panels, configurable usage page sizes, lazy debug-body loading, and cancellation of obsolete requests so large histories no longer cause unbounded database or DOM work.
  • Added live global and per-user search concurrency controls, persisted runtime settings, and limiter reuse to reduce contention while allowing administrators to tune active search capacity without restarting the service.
  • Improved long-running search reliability with incremental SSE parsing, bounded stream resources, phase-specific connection and TLS timeouts, larger reusable connection pools, and safe transport replacement.
  • Reworked SQLite persistence with separate read/write pools, indexed ownership and usage queries, asynchronous usage accounting, retention rollups, maintenance operations, bounded debug capture storage, and clearer responsibility-based modules.
  • Improved authentication scalability with complete cached snapshots and a sharded, bounded LRU resolver cache.
  • Improved panel performance and maintainability through batched tier loading, domain-specific handlers and event controllers, semantic stylesheet modules, and shared pagination/runtime-settings helpers.
  • Tightened data integrity for invite-code creator references and removed obsolete full-list and legacy compatibility paths.
  • Added release-triggered multi-platform Docker publishing and pinned patched Go toolchain and runtime images.

Deployment notes

  • Search concurrency and other supported runtime settings can be updated from the administration panel without restarting.
  • The listen address, database path, JWT secret, and source-IP RPM settings remain startup-only configuration.
  • Internet-facing deployments should continue to place the plain-HTTP service behind a trusted HTTPS reverse proxy or load balancer.
  • Docker image: maplemaplecat/grok-search-mcp:v0.2.0.

Assets

  • grok-search-mcp_0.2.0_linux_amd64.tar.gz: statically linked Linux amd64 binary, README, and license.
  • grok-search-mcp_0.2.0_linux_arm64.tar.gz: statically linked Linux arm64 binary, README, and license.
  • checksums.txt: SHA-256 checksums for both archives.

Verify downloaded assets from the same directory with:

sha256sum -c checksums.txt

Full changelog

v0.1.0...v0.2.0

Assets 5
Loading