address-tool/docs/migration-inventory.md

Existing service content migration inventory

Source service directory: /root/.openclaw/workspace/address_tool Active systemd unit: address-tool.service

Migrated into this repository

• server.py: API server, request throttling, FakeNameGenerator integration and fallback provider logic. Repository copy uses a directory-relative web root and environment-only API key configuration.
• index.html: active browser UI served by the API server.
• scripts/gen.py: existing standalone CLI helper that calls the fallback address API.
• .env.example: names and defaults for runtime configuration; contains no credentials.
• deploy/address-tool.service.example: example unit for a future migration.

Intentionally not copied into Git

• server.py.bak-*, index.html.bak-*: historical snapshots, not runtime inputs. The full source directory was preserved in a separate backup before extraction.
• __pycache__/: generated Python bytecode.
• Runtime credentials: kept only in an ignored local .env file (mode 600) when available from the existing source. Never commit it.

Current deployment status

The existing systemd unit still runs /root/.openclaw/workspace/address_tool/server.py on port 18990. This migration does not stop, restart, or repoint that service. A later cutover must first test the repository copy and configure its environment file and service account.

External runtime dependencies

• Optional FakeNameGenerator API, configured with FNG_API_KEY.
• Fallback API https://www.meiguodizhi.com/api/v1/dz.
• Cap.js widget/CDN and CAPTCHA endpoint referenced by index.html.