feat(extension): make the local daemon port configurable in the popup

[shnpd]

摘要

fix #114
扩展原先写死连接 ws://127.0.0.1:52800。本 PR 让用户在 popup 里配置本机 daemon 端口，写入 chrome.storage.local 后 background 自动改 WebSocket URL 并重连。默认端口仍为 52800。

未连接时不再展示 [WSTransport] ... 这类技术错误，改为提示确认 daemon 已启动且端口一致；连接开关在未连接时显示为关闭。

改动说明

• Popup 新增「连接端口」输入，blur / Enter / 关闭弹窗时提交；非法端口只提示、不写入。
• 端口走 chrome.storage.local（bsk_daemon_port），不再使用未接线的 set_port 消息。
• Background 启动时读取已存端口；监听 storage 变化后 setUrl + disconnect/connect。
• WSTransport 支持运行时更换 URL（不自动重连）。
• 隐私政策、架构文档、中英文案同步更新。

ui展示

测试

• 默认端口 52800 能正常连上 daemon
• popup 改成有效端口（如 53200）后，扩展会重连到新端口
• 输入非法端口（abc / 0 / 65536）显示错误，且不写入 storage
• 清空输入后回落到默认端口
• 连接开关关闭时改端口，不会强制重连
• daemon 未启动或端口不一致时，显示「无法连接…」，不显示原始 transport 错误
• 重新打开 popup，端口输入框显示上次保存的值

[Copilot]

🟡 Changes recommended

Port parsing and URL construction need to be made stricter/more robust (e.g., avoid parseInt-accepting malformed input and avoid manual URL concatenation that can break IPv6 formatting).

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

This PR implements runtime configuration of the extension’s local daemon WebSocket port via the popup UI, persisting the setting in chrome.storage.local and updating the background connection behavior accordingly (addressing issue #114).

Changes:

• Added a popup “Connection port” input with validation + persistence (bsk_daemon_port), plus friendlier disconnected-state messaging.
• Updated background to read the stored port at startup and react to storage changes by updating the WebSocket URL and reconnecting.
• Extended transport to allow runtime URL changes and added/updated docs + i18n + tests.

File summaries

File	Description
packages/i18n/src/locales/zh-CN/extension.json	Adds zh-CN strings for daemon port UI and unreachable messaging.
packages/i18n/src/locales/en-US/extension.json	Adds en-US strings for daemon port UI and unreachable messaging.
docs/architecture.md	Documents that the default daemon WS port is configurable via the popup.
apps/extension/src/transport/ws-transport.ts	Allows updating transport URL via setUrl() without auto-reconnect.
apps/extension/src/transport/daemon-endpoint.ts	New helpers for default port, URL resolution, and input/storage normalization.
apps/extension/src/transport/tests/ws-transport.test.ts	Adds coverage for setUrl() behavior.
apps/extension/src/transport/tests/daemon-endpoint.test.ts	Adds coverage for daemon endpoint URL/port parsing helpers.
apps/extension/src/lib/popup-bridge.ts	Removes unused set_port message variant; port now stored via storage.
apps/extension/src/lib/instance-id.ts	Adds get/set helpers and storage key for bsk_daemon_port.
apps/extension/src/lib/tests/instance-id.test.ts	Adds tests for daemon port persistence/normalization.
apps/extension/src/entrypoints/popup/use-daemon-port.ts	New hook to load/commit daemon port preference via chrome.storage.local.
apps/extension/src/entrypoints/popup/use-connection-state.ts	Updates comment to reflect current popup bridge semantics.
apps/extension/src/entrypoints/popup/App.tsx	Renders port input, adjusts disconnected messaging, and hides transport errors when disconnected.
apps/extension/src/entrypoints/popup/App.test.tsx	Adds tests for disconnected UX and daemon port input behavior.
apps/extension/src/entrypoints/background.ts	Reads stored port on startup and reconnects on storage updates.
apps/extension/PRIVACY.zh-CN.md	Updates privacy text to note configurable loopback port.
apps/extension/PRIVACY.md	Updates privacy text to note configurable loopback port.

Review details

• Files reviewed: 17/17 changed files
• Comments generated: 5
• Review effort level: Lite

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.