feat: 插件化桌面客户端 svfs-client（含凭据/会话/网络/日志的脚手架补齐）

一个插件 = 一个完整的 .svfs 包：客户端把插件前端经 svfs://<插件id>/ 直接加载进 WebView（不落盘、不起端口、不解包），每个插件一个独立 origin（浏览器按 origin 隔离 localStorage）与独立键值存储；快照即版本——升级 = 派生快照的增量打包，回滚 = 把注册表指针切回旧快照，包文件一个字节不用动。svfs_client 复用 svfs_studio 的主题与基础部件，故两个包一并入库。按评估结论补齐的 P0 三块： * 会话：桥在"宿主注入的 token 被 401 拒绝"时通知壳层，提示一次并给出一键「重新登录…」；服务器状态灯把「在线但登录失效」（黄）与「离线」（红）分开，不再把凭据失效误报成网络不可达； * 凭据：新增 credentials.py——token 不再明文进 settings.json。Windows 走 DPAPI （密文只有当前用户在本机解得开），其它平台走系统凭据库（可选依赖 keyring），都没有才明文兜底并在「设置 → 登录凭据」如实提示；令牌与签发它的 base_url 绑定（换服务器不会把旧令牌发出去）；老字段 auth_token 启动时自动迁移； * 强登录链路保持：启动动画 → 静默校验 → 登录窗 → 主窗口，不可达时离线宽限。 P1/P2：net 超时与重试（只对幂等方法，避免重发 POST 变两单）可配、代理与自签 CA 可配（loopback 永远直连）；诊断日志滚动落盘（1MB×3，可关）——崩溃后还能回看现场；客户端自更新检查（静态 <base_url>/client/manifest.json，缺失即静默）；插件清单可选 net_hosts 白名单；notify 改走系统托盘（无托盘降级状态栏）；设置界面新增网络 / 登录凭据 / 诊断日志三块。 examples/：示例服务端（FastAPI，含登录、上传即 publish、客户端版本接口）、 Vue 3 插件模板（带浏览器版宿主模拟器）、svfs-plugins-root/ 为模板配套的演示插件实体。测试：tests/test_client_*.py（纯层 + Qt 层 + 一次真实 WebEngine 冒烟）、 tests/test_studio_*.py、tests/test_plugin_server.py。
2026-09-16 17:15:48 +08:00
parent 06ec7c38bc
commit f62704ca0e
85 changed files with 23462 additions and 0 deletions
@@ -0,0 +1,79 @@
+/* 演示插件的前端逻辑：全部能力都走宿主注入的 window.svfs（Promise）。 */
+"use strict";
+
+var $ = function (id) { return document.getElementById(id); };
+var PLUGIN_VERSION = "2.0.0";
+
+function randomColor() {
+  var letters = "0123456789abcdef", out = "#";
+  for (var i = 0; i < 6; i++) out += letters[Math.floor(Math.random() * 16)];
+  return out;
+}
+
+async function main() {
+  if (!window.svfsReady) {
+    $("missing").hidden = false;
+    $("version").textContent = "插件 " + PLUGIN_VERSION + "（未连接宿主）";
+    return;
+  }
+  var svfs = await window.svfsReady;
+
+  var info = await svfs.host.info();
+  $("version").textContent = "插件 " + PLUGIN_VERSION + "  ·  桥 API v" + info.apiVersion;
+  $("host-info").innerHTML = "";
+  [["插件 id", info.pluginId], ["宿主", info.appName + " " + info.appVersion],
+   ["平台", info.platform], ["来源", info.source || "-"]]
+    .forEach(function (row) {
+      var dt = document.createElement("dt"); dt.textContent = row[0];
+      var dd = document.createElement("dd"); dd.textContent = row[1];
+      $("host-info").append(dt, dd);
+    });
+
+  // storage：按插件隔离的键值存储，换一台机器/重装插件也不会串到别的插件
+  var count = 0;
+  try {
+    count = parseInt(await svfs.storage.get("visits"), 10) || 0;
+    count += 1;
+    await svfs.storage.set("visits", count);
+  } catch (e) { /* 没拿到 storage 权限时静默降级 */ }
+  $("count").textContent = String(count);
+  $("reset").onclick = async function () {
+    await svfs.storage.set("visits", 0);
+    $("count").textContent = "0";
+    svfs.ui.notify("计数已清零");
+  };
+  $("add10").onclick = async function () {
+    count += 10;
+    await svfs.storage.set("visits", count);
+    $("count").textContent = String(count);
+  };
+
+  $("notify").onclick = function () {
+    svfs.ui.notify("来自 " + info.pluginId + " 的通知（" + PLUGIN_VERSION + "）");
+  };
+  $("paint").onclick = function () {
+    svfs.ui.setTitle("SVFS Client · 演示插件 " + randomColor());
+  };
+
+  // net：宿主代发 HTTP 请求（不经过浏览器的 CORS）。相对 path 拼在
+  // 客户端配置的服务器地址（base_url）后；也可以给 {url: "https://…"}。
+  $("ping").onclick = async function () {
+    if (!svfs.net) {
+      $("net-out").textContent = "这个宿主没有 net 能力（需要客户端支持桥 API v2）";
+      return;
+    }
+    $("net-out").textContent = "请求中…";
+    try {
+      var res = await svfs.net.request({ method: "GET", path: "/api/ping" });
+      $("net-out").textContent = "HTTP " + res.status + "\n"
+        + (res.bodyText || "(空响应)").slice(0, 300);
+    } catch (e) {
+      $("net-out").textContent = "请求失败: " + e.message
+        + "\n（先在「插件管理 → 服务器」里配置地址，服务端需提供 /api/ping）";
+    }
+  };
+
+  $("changelog").textContent = "v2：新增主题色切换与变更记录";
+}
+
+main();