Lite page and docs: the current app, remote core, and the licensing contact

[fylorn]

The Lite page and the Lite docs described the app as it was before the navigation was reorganised: a Findings page, three protections, a menu bar showing cost and output rate, system notifications for unreachable upstreams, and a control channel that only runs over a local socket. This brings them in line with the current app, adds the remote core, and fixes the licensing contact.

Lite page (/lite, /zh-CN/lite)

• Meta and hero in the approved register. The headline now reads "A local AI API gateway for macOS, Windows and Linux"; the share card and og:image:alt are generated from it, so /og/lite.png changes with it.
• Features, page by page: Overview, Traffic, Clients, Keys, Upstreams, Routing, dry run, Security, MCP (new) and Settings (UI languages). Claims were checked in code rather than in other copy:
  • Security: five protections (outbound redaction, tool-call inspection, hidden characters, content filter, output limit), each Off / Observe / Enforce; all start in Observe except the output limit, which starts Off (tw-config/src/security.rs in Core).
  • Notifications: only warning and critical notices become system notifications; an unreachable upstream is listed in the app only (src-tauri/src/notices/rules.rs in Lite).
  • Menu bar: today's tokens and cost, orange or red as a subscription quota runs low or out; tray on Windows and Linux (src-tauri/src/menubar).
• Remote core (new section): what connecting to a server changes, the encrypted control channel, where the key is stored (a private file, not the keychain), with links to the server deployment guide and the new docs page.
• Architecture diagram: the control channel is labelled with its three forms (unix socket on macOS and Linux, loopback port on Windows, TCP port to a remote core) and the encrypted handshake on each.
• Screenshots come from the Lite repository's pipeline (docs/screenshots/web at ThinkWatchProject/ThinkWatch-Lite@ac57512): requests → traffic, findings → security and mcp, plus keys, routing, settings, three remote-core images, the menu (664×1120) and the menu bar item (178×64, shown at 89 px). Every image has an alt text that describes that image, in the page's language. requests*, findings*, menubar-cost.png and menubar-quota.png are removed; nothing references them. The SoftwareApplication screenshot list follows the feature ids and points at the new files.
• The Chinese headline keeps the highlighted noun on one line and wraps balanced, so it no longer leaves a single character on the last line.

Docs

• overview: pages table, the five protections with what each does in Enforce, notifications, connection to Core; the stale "subscription usage is not billed", Findings page and per-launch credential text is gone.
• install: "Apple silicon", and a link to the remote core page. No winget. Updates as src-tauri/src/updater.rs on Lite dev does them: the first check two minutes after start, then daily; an automatic check that finds a version posts a system notification (unless notices are In app only or Off); the notification, the Install Version menu item and Update to in Settings › About open the update window; then it depends on how the app was installed.
• overview and the Lite page: sticky sessions are on by default for a rotation group (Group.session_affinity defaults to true in Core) and can be turned off per group.
• run-from-source: every build, pnpm tauri dev included, needs src-tauri/resources/twcore, so bash src-tauri/scripts/fetch-core.sh runs after pnpm install (as in Lite's CONTRIBUTING on the README pull request); no more "needs no network" or sibling thinkwatch-core checkout.
• architecture: repository layout including src-tauri/crates/ (tw-adopt, tw-scan), the supervisor and safe mode, and a control-channel section (Noise NNpsk0, listen.control.key, no TLS).
• New remote-core page, Connecting to a remote core / 连接远程 core: what the server needs, the steps in the app, switching, what changes while connected, and the security of the connection. Registered in the sidebar after "Install and update" (_meta.ts, Lite entries only). A version mismatch is fixed with sudo twcore upgrade --version <the version the app shows> --restart, which moves the server up or down; the Lite page says the same.

License page

The commercial licensing contact is now fylorn@outlook.com; hello@thinkwat.ch has no MX record and cannot receive mail.

Checks

• pnpm build (pnpm 10) passes with the same warnings as main.
• The built site validates: JSON-LD against the schema.org vocabulary, canonical, hreflang and Open Graph tags, internal links and anchors, sitemap and RSS — 0 errors, 0 warnings. All 113 external links answer.
• Checked in a browser at 1200 and 375 px, in both languages: no horizontal scroll, the diagram label on one line per entry.

Notes for review

• Merge after feat(core): server deployment on the Core page, the home page and the Core docs #18. The server deployment links (serverDocsHref in LitePage.astro, two links in each remote-core.md) point at /docs/core/server-deployment and /zh-CN/docs/core/server-deployment on this site, which feat(core): server deployment on the Core page, the home page and the Core docs #18 adds. Built alone, this branch reports those six links as missing; built together with feat(seo): social preview images for the GitHub repositories #17 and feat(core): server deployment on the Core page, the home page and the Core docs #18 there are 0 broken links among 5,132.
• The screenshots were taken from Lite's dev branch, which already has the upgraded interface (for example the routing map), not yet in the released 2026.9.16.
• The home page's Lite band shows /lite/overview.webp, replaced here with the 7-day Overview; its alt text in home.ts is updated in feat(core): server deployment on the Core page, the home page and the Core docs #18 with the same text as overviewAlt.

🤖 Generated with Claude Code