Files
svfs/svfs-plugins-root/com.svfs.demo/blobs/e8/e87bc4fd4a0c7a3dddc7919a724a45ec84dd9c99d550d5d36fd53a6047c8a701
T
chakcy f62704ca0e 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

52 lines
1.5 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>SVFS 演示插件</title>
<link rel="stylesheet" href="style.css">
</head>
<body>
<main>
<header>
<img src="icon.svg" width="44" height="44" alt="icon">
<div>
<h1>SVFS 演示插件</h1>
<p id="version">正在连接宿主…</p>
</div>
</header>
<section class="card" id="missing" hidden>
这个页面不在客户端里打开(没有检测到 svfs 桥)。
在 SVFS Client 中安装并启用本插件即可看到完整功能。
</section>
<section class="card">
<h2>宿主信息</h2>
<dl id="host-info"><dt>加载中…</dt></dl>
</section>
<section class="card">
<h2>存储(storage 权限,按插件隔离)</h2>
<p>这个插件被打开了 <b id="count">…</b> 次</p>
<button id="reset">计数清零</button>
<button id="add10">再加 10 次</button>
</section>
<section class="card">
<h2>接口服务(net 权限,经宿主请求服务器 API)</h2>
<button id="ping">请求 /api/ping</button>
<pre id="net-out" class="note">未请求。相对 path 会拼在客户端配置的服务器地址后。</pre>
</section>
<section class="card">
<h2>通知与标题(notify / title 权限)</h2>
<button id="notify">发一条原生通知</button>
<button id="paint">随机换个标题颜色</button>
<p class="note" id="changelog"></p>
</section>
</main>
<script src="app.js"></script>
</body>
</html>