Files
xiaobai-review/tools
8e94c7b429 fix(HEL-199): 为补档工具补上仓库根 sys.path 引导
使 python3 tools/backfill_recent_snapshots.py --help 在干净环境下可直接运行,并同步文档运行示例为容器内执行。

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: multica-agent <github@multica.ai>
2026-08-27 15:12:42 +00:00
..

Maintenance tools

Run these commands from the application root. This directory contains only active startup, registry, and verification tools.

Normal maintenance

  • powershell -ExecutionPolicy Bypass -File tools/start_local.ps1 [-Port 8797]: start the local application in a hidden process and keep logs, the PID, and Python cache under runtime/ instead of the source root.
  • python tools/verify_baseline.py: all unit tests, registry checks, every frontend JavaScript syntax check, Git whitespace check, and read-only SQLite integrity check.
  • python tools/verify_baseline.py --e2e: the same checks plus Playwright. The verifier owns the local static-server lifecycle so the command exits cleanly on Windows.
  • python tools/build_api_registry.py [--check]: generate or verify config/api.config.json from backend/http/dispatch.py and the registered backend/features/*/routes.py owners.
  • python tools/build_architecture_inventory.py [--check]: generate or verify config/architecture-inventory.json from the current source tree.
  • python tools/backfill_recent_snapshots.py --account <admin> [--lookback 60] [--dry-run]: auditable recent trading-day dashboard snapshot backfill. See docs/maintenance/行情历史补档.md.

verify_baseline.py does not inspect a parent checkout or skip tests according to files outside this application. Historical comparison scripts were retired after final standalone acceptance; their results remain under docs/migration/evidence/ and their source remains recoverable from Git history.