修复固件哈希兼容性并完善部署配置

AGENTS.md

@@ -2,6 +2,21 @@
 
 Before changing this project, read `README.zh-CN.md` in full. Its architecture constraints, extension procedure, validation checklist, and release steps are authoritative.
 
+## Project identity
+
+- This is a self-hosted Vue 3 + TypeScript browser-local tools application with a zero-dependency Node.js static/configuration server.
+- `package.json` is the authoritative application version. The default production port is `9000`.
+- `shared/tool-catalog.json` is the authoritative tool catalog; `shared/default-navigation.json` defines first-run ordering.
+- `README.zh-CN.md` is the complete product, architecture, deployment, extension, and AI handoff document. `README.md` is only the universal entry point.
+- Windows Server uses `web-tools.ps1`; containers use `Dockerfile` and `docker-compose.yml`.
+
+## First actions in a new session
+
+1. Read `README.zh-CN.md`, then inspect `git status --short --branch` and preserve all existing worktree changes.
+2. Read the closest existing tool, its `src/lib/` logic, and related tests before adding or changing behavior.
+3. Keep default production port references synchronized in `server/index.mjs`, `web-tools.ps1`, `Dockerfile`, `docker-compose.yml`, `.env.example`, and deployment documentation.
+4. Run `npm run check`; for deployment changes also validate PowerShell syntax and Docker Compose configuration when those tools are available.
+
 Key rules:
 
 - Preserve the anonymous, no-login, no-database design. Tool calculations are isolated in each browser tab; only navigation order is shared globally.