@mrrisega/dsh-remote 0.6.4-beta.3 → 0.6.4-beta.4

package/README.md

@@ -33,6 +33,7 @@ dsh-remote 是一个轻量的**隧道模式**远程控制方案：电脑端运
 - **登录后 bridge 自动连上，全程零刷新**：面板自动补运行环境 → 拉起 bridge → 显示「正在连接中继…」，连上后自动变成「已连接 ✅」并刷新二维码与设备列表；失败有可读原因、自动重试倒计时和「复制诊断信息」。
 - **手机端自动等待电脑上线**：空设备列表不再让人干等或手动刷新，电脑一上线设备自己出现。
 - **安装引导改版**：有插件市场入口就搜索 `dsh-remote` 安装（不用敲命令）；没有就复制一条命令；两条路都收敛到「登录后稍等，电脑会自己出现」。
+- **安装输出更干净**：不再重复打印同一段引导，结尾只给一份汇总（地址 / 自启动服务 / 下一步）；装完当下 dsh web 没开着也会如实说明「打开 dsh web 后 bridge 会自动启动」，不再像报错。
 
 **0.6.2 起已有**
 
@@ -142,6 +143,58 @@ npx @mrrisega/dsh-remote setup --server wss://<你的域名>:端口 --key <访
 - 建议上线前用**真机回归**一次完整链路：手机登录解锁 → 🔒 加密访问（对话/工具/审批/凭据）→
   明文回退提示 → 修改密码后旧会话全部失效、重新登录恢复。
 
+## 匿名装机统计与隐私
+
+生产诊断发现「注册了但设备一直没连上」的用户没有任何账号数据、无法归因，因此插件内置了一条
+**匿名装机统计**通道，只上报**装机与连接是否成功**：
+
+- **采**：事件名（安装开始/失败原因/运行环境就绪/bridge 是否注册成功/首次远程打通/面板打开/重启/更新）、
+  失败码（白名单，如 `npm_unreachable`、`npm_eacces`、`runtime_install_timeout`）、插件版本号、
+  系统平台（`darwin`/`linux`/`win32`）、架构（`arm64`/`x64`）、node 主版本号，
+  以及一个**本机随机 ID**（`crypto.randomUUID()`，非硬件派生、重装即变、不可跨机器关联）；
+- **不采**：手机号 / 邮箱 / 账号 ID、任何会话或文件内容、真实 hostname / 用户名 / 文件路径、
+  密码与密钥、设备指纹 `machine_fp`、原始 IP、精确地理位置；请求**不带 Authorization**（匿名、与账号解耦）；
+- **可关**：`export DSH_REMOTE_TELEMETRY=0` → 完全关闭（不生成随机 ID、不落任何文件、不发任何请求）；
+  也可在中继/Nginx 侧直接丢弃 `POST /api/telemetry/events`；
+- **可查**：面板「关于 dsh-remote」卡片底部有一行说明与链接，完整字段清单与核实方法见
+  [docs/telemetry.md](docs/telemetry.md)。
+
+## 数据与隐私
+
+上一节讲的是「匿名装机统计」这条通道本身；这一节回答更常见的问题：**你的数据落在哪里、我们到底统计什么**。
+
+**开源部分采集 / 不采集**
+
+- **采**（开源部分只有一件事）：装机与连接是否成功这条**匿名**统计通道，字段清单见上一节。
+- **不采**：**你的会话内容**（对话、工具执行、审批、凭据、文件正文与 WebSocket 消息——中继侧不采集内容）、
+  **你的账号**（匿名通道不接受任何账号/设备关联，请求不带 Authorization）、**原始 IP**
+  （匿名通道不上报 IP，也不做任何按 IP 的关联分析）、真实 hostname / 用户名 / 文件路径。
+- **官方云服务额外记录的**：只有**接入事件**（注册 / 设备接入 / 真实登录 / 首次打通 / 首次看到安装引导），
+  同样是事件级、不含任何内容。**开源部分不产生也不上报这类事件。**
+- **装机漏斗统计的粒度**：云服务的漏斗统计**建立在审计日志之上**，因此口径是「注册 / 新增设备 /
+  真实登录 / 首次打通」这类**事件条数**——**不是内容，也不是行为轨迹**。
+  桥接进程每次启动都会重新登记设备，**重复登记不记为新增**，所以「新增设备数」对得上真实装机量，
+  不会被反复重连刷高。
+- 完整字段级清单、可核实方法与自行关闭方式见 [docs/telemetry.md](docs/telemetry.md)。
+
+**如何关闭**
+
+```bash
+export DSH_REMOTE_TELEMETRY=0     # 完全关闭匿名装机统计：不生成随机 ID、不落文件、不发请求
+```
+
+也可在网络侧直接丢弃 `POST /api/telemetry/events`（中继 / Nginx / 防火墙），
+关闭后不影响面板、bridge 与连接流程的任何功能。
+
+**自建模式（self-hosted）**
+
+自己部署 `relay-router` 时，**数据只落到你自己的服务器**：
+
+- 匿名统计发往你在 `.dsh-config.json` 里配置的 `api_url`（即你的实例），不经过任何第三方服务；
+- 没有账号体系、也没有管理端后台，不存在「注册 / 接入事件」的云侧统计；
+- 远程操作的内容只经过**你自己的**中继；开启 E2EE 后端到端加密（手机 ↔ 电脑），中继也读不到内容；
+- 是否保留数据、保留多久，完全由你决定；不想留任何统计就 `DSH_REMOTE_TELEMETRY=0`。
+
 ## 自建部署（开源版）
 
 1. 在有公网 HTTPS 入口的服务器上部署 `relay-router`（见 [docs/self-hosting.md](docs/self-hosting.md)）：
@@ -182,6 +235,7 @@ npx @mrrisega/dsh-remote setup --server wss://<你的域名>:端口 --key <访
 ## 文档
 
 - [docs/self-hosting.md](docs/self-hosting.md) — 开源自建完整指南（含安全提示）
+- [docs/telemetry.md](docs/telemetry.md) — 匿名装机统计：采集/不采集清单与关闭方法
 - [CONTRIBUTING.md](CONTRIBUTING.md) — 贡献指南
 - [SECURITY.md](SECURITY.md) — 安全策略与漏洞报告流程
 - [CHANGELOG.md](CHANGELOG.md) — 版本记录

package/docs/telemetry.md

@@ -0,0 +1,145 @@
+# 匿名装机统计（遥测）与隐私边界
+
+本文面向**用户与审计者**：dsh-remote 的「匿名装机统计」通道到底采集什么、不采集什么、
+数据长什么样、如何**彻底关闭**，以及你如何自己核实这些说法。
+
+- 实现代码（客户端半）：[`packages/dsh-remote-web/lib/index.js`](../packages/dsh-remote-web/lib/index.js)
+  中的「匿名装机/连接遥测」段落（唯一的 payload 构造点是 `telemetryEventOf()`）。
+- 关闭开关：环境变量 `DSH_REMOTE_TELEMETRY=0`（见下文「如何关闭」）。
+- README 摘要：[README「匿名装机统计与隐私」](../README.md#匿名装机统计与隐私)。
+
+---
+
+## 1. 为什么要做这个统计
+
+2026-09 的生产诊断显示：11 个新注册用户里只有 3 人最终把设备连上——**6 人电脑端从未装上**、
+**2 人装了但 bridge 没连上**。而「装不上」的机器**没有任何账号、也就没有任何数据**，
+于是「我本地好好的，新机器上失败」这类问题在服务端永远无法归因。
+
+这条通道只补这一段事实：**装机与连接是否成功、卡在哪一步**，用来：
+
+- 判断某个版本的补装成功率是否下降（回归预警）；
+- 判断失败集中在哪一类原因（没装 node / npm 源不通 / 权限不足 / 平台不支持 / 安装超时）；
+- 判断「注册了但手机端看不到设备」的用户，是卡在补装、卡在 bridge 拉起，还是卡在中继注册。
+
+它**不**用于、也**不能**用于：识别具体用户、分析使用内容、投放或画像。
+
+## 2. 采集什么（全部字段，无其他）
+
+一次请求（批量）的 body：
+
+```json
+{
+  "install_id": "3f2b1c8e-9a4d-4c1e-8b77-0d5f6a2e9c31",
+  "source": "plugin",
+  "events": [
+    { "name": "install_started", "at": 1789000000000, "version": "0.6.4-beta.4", "os": "darwin", "arch": "arm64", "node": "22" },
+    { "name": "install_failed", "fail_code": "npm_unreachable", "at": 1789000000000, "version": "0.6.4-beta.4", "os": "darwin", "arch": "arm64", "node": "22" }
+  ]
+}
+```
+
+| 字段 | 取值 | 说明 |
+| --- | --- | --- |
+| `install_id` | 本机随机 UUID | **本机生成**的随机 ID（`crypto.randomUUID()`），非硬件派生、不含机器信息；换机或删除后重装即变，**不可跨机器关联同一个人** |
+| `source` | `plugin` | 目前只由插件（node 半）上报 |
+| `name` | 事件名白名单 | 见下表 |
+| `fail_code` | 失败码白名单 | 仅 `install_failed` / `update_failed` 附带 |
+| `at` | 毫秒时间戳 | 事件发生时间 |
+| `version` | 插件版本号 | 例如 `0.6.4-beta.4` |
+| `os` | `process.platform` | 仅平台名：`darwin` / `linux` / `win32` |
+| `arch` | `process.arch` | 仅架构：`arm64` / `x64` |
+| `node` | 主版本号字符串 | 例如 `"22"`（**不含**次版本、补丁、路径） |
+
+### 事件名白名单（只发这些，其它一律不发）
+
+`install_started`（开始补装运行环境）· `install_failed`（附 `fail_code`）· `runtime_ready`（运行环境就绪）·
+`bridge_started`（bridge 进程拉起）· `bridge_registered`（设备已在中继注册成功 = 真正可用）·
+`tunnel_disconnected` · `first_remote_ok`（首次远程打通）· `plugin_loaded` · `panel_opened` ·
+`harness_restart`（自动重启触发）· `update_started` · `update_failed`（附 `fail_code`）
+
+### 失败码白名单（`fail_code`）
+
+`node_missing` · `node_too_old` · `npm_unreachable` · `npm_eacces` · `platform_unsupported` ·
+`runtime_install_timeout` · `launchd_failed` · `bridge_exit` · `bind_conflict` · `bind_device_limit` · `unknown`
+
+> 原始错误文本**绝不外发**（它可能含文件路径、用户名、主机名）：只做白名单归类，
+> 归不进去的一律记 `unknown`。
+
+## 3. 不采集什么（硬边界）
+
+以下内容**不会**出现在遥测里，代码里也不存在对应字段（见 `telemetryEventOf()`）：
+
+- ❌ 手机号、邮箱、账号 ID、设备 `device_id`、访问密钥、任何登录凭据
+- ❌ 任何会话内容与文件内容（对话、工具执行、审批、凭据、文件正文、WebSocket 消息）
+- ❌ 真实 **hostname**、系统用户名、家目录、任何文件路径
+- ❌ 密码、JWT、`bridge_secret`、E2EE 密钥或口令
+- ❌ 设备指纹 `machine_fp`（同机识别用，**只**上报给账号 API 用于顶替旧设备，不进遥测）
+- ❌ 原始 IP（服务端只看到 TCP 来源，客户端不上报 IP）、精确地理位置、GPS
+- ❌ 用户行为轨迹、页面浏览路径、点击流、崩溃堆栈原文
+
+遥测请求**不带 `Authorization` 头**：它是一个与账号体系解耦的匿名通道，
+服务端也不接受用账号凭据关联这些事件。
+
+## 4. 如何关闭
+
+```bash
+# 完全关闭：不生成 install_id、不落任何遥测文件、不发任何请求
+export DSH_REMOTE_TELEMETRY=0
+```
+
+- 判定规则：`DSH_REMOTE_TELEMETRY` 取值 `0` / `false` / `off` / `no` → 关闭；
+  未设置或 `1` / `true` → 开启（**默认开启**）。判定在每次记录/发送时读取，改完重启 dsh web 生效。
+- 诊断/测试隔离开关 `DSH_RELAY_SKIP_SERVICE=1` 同样会让遥测完全不发送
+  （它本来就是「不要碰外部世界」的隔离开关，本仓库测试脚本全局置位它）。
+- 关闭后插件**连本机队列都不读**，`<relayDir>/.telemetry-*.json` 不会新增或发送。
+- 也可以在**网络侧**屏蔽：中继/Nginx/防火墙里丢弃 `POST /api/telemetry/events`
+  （插件对任何失败都静默退避，不会影响你的正常使用与面板）。
+- 已经产生的本机文件可以随时删除（它们只是待发队列）：
+
+  ```bash
+  rm -f ~/.dsh-remote/.telemetry-install-id ~/.dsh-remote/.telemetry-queue.json ~/.dsh-remote/.telemetry-once.json
+  ```
+
+## 5. 本机都有哪些文件、怎么发
+
+| 文件（`<relayDir>` 默认 `~/.dsh-remote`） | 权限 | 内容 |
+| --- | --- | --- |
+| `.telemetry-install-id` | `0600` | 一行随机 UUID（首次生成后复用） |
+| `.telemetry-queue.json` | `0600` | 待发事件队列（上限 200 条，超出**丢最旧**） |
+| `.telemetry-once.json` | `0600` | 一次性事件标记（如 `first_remote_ok` 只发一次） |
+
+发送行为：
+
+- 端点：`POST <api_url>/api/telemetry/events`（`api_url` 取本机 `.dsh-config.json` 的 `api_url`，
+  与安装上报同源；自建部署即你自己的服务地址）；
+- 请求头：`content-type: application/json`、`x-dsh-client: dsh-remote/<version>`，**无 Authorization**；
+- 批量：单批 ≤ 20 条、body ≤ 32KB；队列 ≥ 5 条立即发送，否则每 60s 一次；
+- 失败退避：30s → 2m → 10m → 1h，累计 6 次仍失败则丢弃该批（不永久堆积）；
+- 全程静默：任何异常都被吞掉，**不会**影响面板、bridge、连接流程或任何用户可见行为。
+
+> 仓库测试/诊断用的加速开关 `DSH_REMOTE_TELEMETRY_MS` 会把上面的心跳与退避**按比例缩放**
+> （默认不设置；生产环境请勿设置，生产值就是本文写明的这串）。
+
+## 6. 你可以自己核实
+
+1. 读代码：`packages/dsh-remote-web/lib/index.js` 搜 `匿名装机/连接遥测`；
+   事件与失败码白名单是 `TELEMETRY_EVENT_NAMES` / `TELEMETRY_FAIL_CODES`，
+   payload 唯一构造点是 `telemetryEventOf()`——字段表就是上面第 2 节。
+2. 跑测试（仓库自带，含「禁止字段不得出现在 payload」的断言）：
+
+   ```bash
+   DSH_RELAY_SKIP_SERVICE=1 node --test packages/dsh-remote-web/test/telemetry.test.mjs
+   ```
+
+3. 关掉开关后抓包/看日志验证：`DSH_REMOTE_TELEMETRY=0` 时不会有任何 `/api/telemetry/events` 请求，
+   也不会有 `.telemetry-*` 文件生成。
+
+## 7. 服务端怎么处理（约定）
+
+- 按 `install_id` + `name` 做**匿名漏斗**统计（装机成功率、失败原因分布、注册→可用转化）；
+- 不与会话/账号/设备表做关联分析；不长期保存原始 `at` 精度以外的东西；
+- 未知事件名、未知 `fail_code` 一律丢弃（避免脏数据污染口径）。
+
+> 本项目的许可（PolyForm Noncommercial）与隐私承诺都建立在「如实披露」之上：
+> 如果这条通道将来要增加任何字段或事件，必须先改本文与 README，再改代码。

package/dsh-setup.mjs

@@ -83,7 +83,7 @@ function ensureRuntimeCopy() {
     fs.cpSync(wsSrc, path.join(CONFIG_DIR, "node_modules", "ws"), { recursive: true, force: true });
   }
   fs.writeFileSync(verFile, ver);
-  console.log(`✅ 运行时已固化到 ${CONFIG_DIR}（自启动指向稳定路径，不再依赖 npx 缓存）`);
+  console.log(`✅ 运行时: ${CONFIG_DIR}`);
 }
 try { ensureRuntimeCopy(); } catch (e) { console.warn(`⚠️ 运行时固化跳过: ${e.message}`); }
 
@@ -219,8 +219,7 @@ function writeAutostartFile() {
   <key>EnvironmentVariables</key><dict><key>PATH</key><string>/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin</string><key>DSH_BRIDGE_INSTALL_SOURCE</key><string>${INSTALL_SOURCE}</string><key>DSH_BRIDGE_INSTALL_VERSION</key><string>${INSTALL_VERSION}</string></dict>
 </dict></plist>`;
     fs.writeFileSync(plistPath, plist);
-    console.log(`✅ 已创建自启动服务: ${plistPath}`);
-    return plistPath;
+    return plistPath; // 路径在最终汇总里统一展示(避免同一信息打印两遍)
   }
   if (process.platform === "linux") {
     const dir = path.join(os.homedir(), ".config/systemd/user");
@@ -228,8 +227,7 @@ function writeAutostartFile() {
     const unit = `[Unit]\nDescription=dsh-remote bridge (auto-starts with dsh web)\n\n[Service]\nExecStart=${runCmd}\nRestart=on-failure\nRestartSec=5\nEnvironment=PATH=/usr/local/bin:/usr/bin:/bin\nEnvironment=DSH_BRIDGE_INSTALL_SOURCE=${INSTALL_SOURCE}\nEnvironment=DSH_BRIDGE_INSTALL_VERSION=${INSTALL_VERSION}\n\n[Install]\nWantedBy=default.target\n`;
     const unitPath = autostartFilePath();
     fs.writeFileSync(unitPath, unit);
-    console.log(`✅ 已创建自启动服务: ${unitPath}`);
-    return unitPath;
+    return unitPath; // 路径在最终汇总里统一展示
   }
   console.log("⚠️ 当前平台暂不支持自启动，请手动运行 `dsh-remote run`");
   return null;
@@ -238,8 +236,7 @@ function writeAutostartFile() {
 function restartBridgeService() {
   const svcFile = autostartFilePath();
   if (svcFile && !fs.existsSync(svcFile)) {
-    console.log("[dsh-remote] 未检测到自启动服务，自动生成...");
-    writeAutostartFile();
+    writeAutostartFile(); // 静默补生成(调用方会汇总展示路径)
   }
   if (process.platform === "darwin") {
     const plistPath = autostartFilePath();
@@ -279,14 +276,25 @@ function restartBridgeService() {
   return { ok: false, status: "unsupported", detail: `平台 ${process.platform} 不支持自启动` };
 }
 
+/**
+ * dsh web 是否正在运行（127.0.0.1:3080）。
+ * bridge 本身依赖 dsh web 才工作：dsh web 没开时 bridge 起来也会立刻退出，
+ * 所以「装完当下 bridge 没在跑」是**正常状态**，不能当失败吓用户（见 install 汇总）。
+ */
+async function isDshWebUp(timeoutMs = 1200) {
+  try {
+    const ac = new AbortController();
+    const timer = setTimeout(() => ac.abort(), timeoutMs);
+    await fetch("http://127.0.0.1:3080/", { signal: ac.signal });
+    clearTimeout(timer);
+    return true;
+  } catch { return false; }
+}
+
 function installAutostart() {
   const svcPath = writeAutostartFile();
   const r = restartBridgeService();
-  if (r.ok) {
-    console.log(`✅ 自启动服务已加载并运行${r.pid ? ` (pid=${r.pid})` : ""}`);
-  } else {
-    console.log(`⚠️ 自启动服务启动失败: ${r.detail || r.status}`);
-  }
+  // 不再在这里直接打印(信息在 install 汇总里给一次),身份由调用方持有
   return { path: svcPath, status: r };
 }
 
@@ -458,20 +466,40 @@ async function setup(argv) {
   }
 
   const pub = await fetchPublicConfig(cfg.api_url || DEFAULT_API);
-  console.log("\n══════════════════════════════════════");
-  console.log("✅ 安装完成！");
+  const webUp = await isDshWebUp();
+  // 服务状态字符串是给插件面板解析的稳定契约(running / 未运行),不要改口径
+  const svcState = st.ok
+    ? `✅ 运行中${st.pid ? ` (pid=${st.pid})` : ""}`
+    : `未运行 (${st.detail || st.status})`;
+  const L = [];
+  L.push("✅ 安装完成");
+  if (selfHosted) {
+    L.push(`   服务器: ${cfg.tunnel_url}`);
+    L.push(`   手机端: 打开 ${cfg.tunnel_url.replace(/^ws/, "https")}/app/ ，用访问密钥登录`);
+  } else {
+    L.push(`   远程控制地址: ${pub.app_url || DEFAULT_APP_URL}`);
+  }
+  L.push(`   自启动服务: ${svc.path || "(当前平台不支持,可用 dsh-remote run 手动运行)"} — ${svcState}`);
+  // 唯一一处"下一步"引导(上面各阶段不再重复打印同样的话)
+  if (!st.ok && !webUp) {
+    // dsh web 没开时 bridge 起来即退,这是正常状态;要说清"什么时候会自己好",而不是甩一句"启动失败"
+    L.push("");
+    L.push("ℹ 检测到 dsh web 当前没有运行，所以 bridge 还没接上（正常，不是安装出错）。");
+    L.push("   打开 dsh web 后 bridge 会自动启动，无需任何命令。");
+    L.push("   如果 dsh web 已经开着但看不到本机，先重启 dsh web 让插件生效。");
+  } else if (!st.ok) {
+    L.push("");
+    L.push(`⚠️ bridge 未能启动: ${st.detail || st.status}`);
+    L.push(`   可查看日志: ${CONFIG_DIR}/.dsh-bridge.log`);
+  }
   if (selfHosted) {
-    console.log(`   服务器地址: ${cfg.tunnel_url}`);
-    console.log(`   手机端: 打开 ${cfg.tunnel_url.replace(/^ws/, "https")}/app/ ，用访问密钥登录即可。`);
+    L.push("");
+    L.push("   下一步: 手机端用访问密钥登录即可（bridge 登录后自动启动）。");
   } else {
-    console.log(`   远程控制地址: ${pub.app_url || DEFAULT_APP_URL}`);
-    console.log(`   下一步（小白/无需任何命令）: 打开 dsh web → 设置 → 「远程控制」→ 注册/登录手机号即可。`);
-    console.log(`   若你是从 DeepSeek App/插件市场 安装：请【完全退出并重开 App】（或刷新 profile），插件即生效。`);
-    console.log(`   登录后 bridge 会自动启动，手机端即可看到本机。`);
+    L.push("");
+    L.push("   下一步: 打开 dsh web → 设置 → 「远程控制」→ 注册/登录手机号即可（无需任何命令）。");
   }
-  if (svc.path) console.log(`   自启动服务: ${svc.path}`);
-  console.log(`   服务状态: ${st.ok ? "✅ 运行中" + (st.pid ? ` (pid=${st.pid})` : "") : "❌ 未运行(" + (st.detail || st.status) + ")"}`);
-  console.log("══════════════════════════════════════");
+  console.log("\n" + L.join("\n") + "\n");
 }
 
 // ---------- plugin：安装/卸载 dsh web 远程控制插件 ----------
@@ -688,18 +716,13 @@ function convergePluginActivation(profileDir, pkgFile, patchFile, pluginDir, pat
       console.error(`❌ 插件入口缺失：${entryFile}（本包不完整？请用官方源重装：npx --registry=https://registry.npmjs.org @mrrisega/dsh-remote@latest）`);
       process.exit(1);
     }
-    console.log(`✅ 插件已拷贝到 ${pluginLocalDir}`);
     declarePluginDep(pkgFile);                      // file: 依赖(包管理器 install 不误删)
     const addedBundle = ensureBundleEntry(pkgFile); // bundles 声明 → 插件自带 patch 自动激活
-    const linked = ensurePluginLinked(profileDir, pluginLocalDir); // 自建 node_modules 链接
+    ensurePluginLinked(profileDir, pluginLocalDir);  // 自建 node_modules 链接
     stripInclude("bundle patch 已是唯一激活点");     // 清历史 include
-    console.log(addedBundle
-      ? `✅ 已加入 dsh.profile.bundles（${PLUGIN_ID} 自带 patch 自动生效）`
-      : `ℹ dsh.profile.bundles 已含 ${PLUGIN_ID}`);
-    console.log(linked
-      ? `✅ 已建立 node_modules/${PLUGIN_ID} → ${pluginLocalDir}（免包管理器即可解析）`
-      : `✅ node_modules/${PLUGIN_ID} 已就绪`);
-    console.log(`✅ 插件安装完成（bundle 形态，无用户 include）。配置目录: ${CONFIG_DIR}`);
+    // 只报结果不报过程:bundle 是否新加、node_modules 是否新建链接都属于实现细节
+    // (失败会各自抛错/提示),用户只需要知道"插件装好了、装在哪"。
+    console.log(`✅ 插件已就绪: ${pluginLocalDir}${addedBundle ? "" : "（此前已激活）"}`);
     return;
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrrisega/dsh-remote",
-  "version": "0.6.4-beta.3",
+  "version": "0.6.4-beta.4",
   "description": "手机远程控制 DeepSeek Harness · Remote control DeepSeek Harness (dsh web) from any phone browser — 100% 全功能 App 级体验：发消息、看工具执行、审批权限、改设置、管凭据，含特权操作，免内网穿透。一条命令安装 npx @mrrisega/dsh-remote。Mobile remote control for DSH, self-host or SaaS, no server needed on LAN.",
   "keywords": [
     "deepseek-harness",
@@ -38,7 +38,8 @@
     "dsh-setup.mjs",
     "clients/dsh-remote",
     "packages/dsh-remote-web",
-    "docs/self-hosting.md"
+    "docs/self-hosting.md",
+    "docs/telemetry.md"
   ],
   "workspaces": [
     "packages/*",
@@ -51,7 +52,7 @@
     "test": "npm run test:router && npm run test:plugin && npm run test:bridge",
     "test:router": "node --test packages/relay-router/test/native-device-selection.test.mjs packages/relay-router/test/quotas.test.mjs packages/relay-router/test/presence-report.test.mjs",
     "_comment:test:plugin": "DSH_RELAY_SKIP_SERVICE=1 = 测试隔离：插件加载时不做真实系统操作（npx 补装 / launchctl / 重启 harness）；需要真实分支的用例自行 unset（见 account-switch / runtime-provision / harness-restart 用例注释）",
-    "test:plugin": "DSH_RELAY_SKIP_SERVICE=1 node --test --test-concurrency=1 packages/dsh-remote-web/test/*.test.mjs",
+    "test:plugin": "DSH_REMOTE_TELEMETRY=0 DSH_RELAY_SKIP_SERVICE=1 node --test --test-concurrency=1 packages/dsh-remote-web/test/*.test.mjs",
     "test:bridge": "node --test clients/dsh-remote/test/*.test.mjs",
     "check": "node --check clients/dsh-remote/dsh-bridge.mjs && node --check clients/dsh-remote/e2ee-shim.mjs && node --check dsh-setup.mjs && node --check packages/dsh-remote-web/lib/index.js && node --check packages/dsh-remote-web/lib/client.js && bash -n deploy/install-open.sh && npm run check:alias",
     "sync:alias": "node scripts/sync-legacy-alias.mjs",

package/packages/dsh-remote-web/lib/client.js

@@ -1131,6 +1131,8 @@ window.__ModuleLoader__.load({
     }
 
     // ── 面板主体（渲染于设置页 settings.section 栏目内） ─────────────────────
+    // 匿名装机统计的「面板打开」只上报一次/每页（node 半还会每进程去重）。
+    var panelOpenedSent = false;
     function RemoteControlSection(props) {
 
       var statusArr = useState(null); var st = statusArr[0]; var setSt = statusArr[1];
@@ -1557,6 +1559,16 @@ window.__ModuleLoader__.load({
         };
       }, [view, mode, loggedIn, phoneKey, serviceRunning]);
 
+      // ── 匿名装机统计（面板打开） ──────────────────────────────────────────────
+      // 只上报「面板被打开过」这一个事件名（node 半每进程去重、DSH_REMOTE_TELEMETRY=0 直接丢弃）；
+      // 不含任何账号、手机号、设备指纹、会话内容或文件内容——隐私边界见 docs/telemetry.md。
+      useEffect(function () {
+        if (panelOpenedSent) return undefined;
+        panelOpenedSent = true;
+        post("/dsh-remote/telemetry/panel-opened", {}).catch(function () { /* 静默：统计失败绝不影响面板 */ });
+        return undefined;
+      }, []);
+
       // ── 登录后自动闭环（0.6.4）：连接阶段短轮询 ──────────────────────────────
       // 登录成功（含从别处已登录、被面板读到）后立刻开始推进连接，之后自调度：
       //   非 online → 2.5s 一次（阶段自动前进，用户零操作）；online → 15s 一次（退避，只做保活/新设备发现）。
@@ -2410,6 +2422,26 @@ window.__ModuleLoader__.load({
             h("div", { className: "dru-hint", style: { marginBottom: 6 } }, "🛠 电脑端一键安装：bridge 与「远程访问」面板一次到位——云端/自建切换、账号登录、bridge 启停、一次性扫码访问、已授权设备管理、意见反馈都在这里。"),
             h("div", { className: "dru-hint", style: { marginBottom: 6 } }, "🔒 安全与通道：HTTP / WebSocket 全量透传，一次性访问密钥认证，面板实时显示设备与已授权设备列表；服务端可配置流量配额。"),
             h("div", { className: "dru-hint" }, "🛡 端到端加密：手机↔电脑之间的消息内容用「你的账号密码派生密钥」端到端加密——密钥与密码不落服务端（仅存校验值），中继只可见路径/大小/时间（详见 README「安全与隐私」）。"),
+            // 匿名装机统计（隐私披露）：开源项目必须把「采什么 / 不采什么 / 怎么关」写在用户看得到的地方。
+            h("div", { className: "dru-hint", style: { marginTop: 6 } },
+              "📊 匿名装机统计：只上报「装机/连接是否成功」这类事件（安装开始与失败原因、bridge 是否注册成功、是否首次远程打通）——"
+              + "不含任何账号、手机号、会话或文件内容、主机名、路径、设备指纹与 IP；标识是本机随机 ID（重装即变）。"
+              + "用环境变量 DSH_REMOTE_TELEMETRY=0 可完全关闭（不生成 ID、不发任何请求）。"),
+            h("div", { className: "dru-hint", style: { marginTop: 4 } },
+              "隐私说明：",
+              h("a", {
+                className: "dru-linkbtn",
+                href: "https://github.com/mrRisega/dsh-remote/blob/main/README.md#匿名装机统计与隐私",
+                target: "_blank",
+                rel: "noreferrer"
+              }, "README「匿名装机统计与隐私」"),
+              " · ",
+              h("a", {
+                className: "dru-linkbtn",
+                href: "https://github.com/mrRisega/dsh-remote/blob/main/docs/telemetry.md",
+                target: "_blank",
+                rel: "noreferrer"
+              }, "完整字段清单 docs/telemetry.md")),
             // 加入交流群（后台上传二维码后出现；点击弹出二维码大图便于扫码）
             community && community.qrcode
               ? h("div", { className: "dru-actions", style: { marginTop: 10 } },