chore: migrate remaining address tool assets

2026-10-12 08:24:35 +08:00
parent 2fb416ac33
commit ca1478079f
3 changed files with 118 additions and 0 deletions
@@ -0,0 +1,28 @@
+# 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`.