chakcy_code_repository/svfs - svfs - chakcy Git remote hosting service

7 Commits 4 Branches 0 Tags

3 Commits

Include renames

Author	SHA1	Message	Date
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
chakcy	06ec7c38bc	feat: 统一 svfs 子命令入口，打包进度回调与对象缓存路径桌面应用（svfs-studio / svfs-client）要用的前置改动： * 新增 src/sqlite_vfs/cli/main.py：`svfs <子命令>` 统一入口，旧的独立命令（vfspack / vfsunpack / …）保留为别名，两套跑同一段 execute(args)；各子命令因此从 sys.exit() 改成返回退出码，便于被复用； * FolderPacker.pack_folder(progress=…)：每处理一个条目（目录也算）回调一次，供 GUI 进度条使用；只有传了回调时才做"只 stat、不读内容"的预扫描，CLI 的行为与开销不变；回调抛出的异常一路上抛——GUI 的中断语义就靠它； * publish.default_cache_dir()：对象缓存目录（客户端设置里可改）；load_manifest 对"误把服务器根地址当清单填进来"给出可用插件列表的提示，而不是只甩一个 format=None。测试：新增 tests/test_cli_main.py、tests/test_pack_progress.py，test_publish.py 补充。	2026-09-16 17:15:16 +08:00
chakcy	ecdfacc620	fix+feat: 修复打包/解包主链路，并把存储层重建为内容寻址 + 快照起始状态：主链路 100% 不可用，而且失败被静默吞掉——打包后库里 0 个文件、界面仍打印"文件数量: N"；解包导出 0 个文件并在磁盘上生成几百层 sub/sub/sub 垃圾目录。缺陷修复（4 个 P0 + 12 个 P1，逐条见 BUG_REPORT.md）： - 建表列名 compresse_algo 与 INSERT/read_file 用的 compress_algo 不一致 - list_directory 按 path 而非 parent_path 过滤，导致导出无限自递归 - CLI --ignore-timestamps 把 export_filesystem 赋成引用自身的 lambda - add_file 缺少 commit（直接调用 API 时静默丢数据） - LIKE 前缀误伤兄弟目录（删 doc 连带删 docs）；mv_dir 二次改名 - 失败路径一律返回 exit code 0；--exclude 是子串匹配而非 glob - FolderPacker.add_file 反向调用 export_file_safe，会用库内内容覆盖源文件存储层（schema v3，格式变更，提供 vfsmigrate 迁移）： - 内容移入 blobs(hash PRIMARY KEY)：相同内容只存一份，跨路径/跨快照共享 - files 的唯一约束改为 UNIQUE(snapshot_id, path)：一个库存多个版本 - 完整性：每文件 sha256 + 快照级摘要 + HMAC-SHA256 签名，只读连接即可验证 - 增量打包：按 mtime+size 或 sha256 只写变化项，未变文件不重写不重压 - get_file_info 不再返回 content（元数据查询不该搬 BLOB）新增能力： - 可选 FastAPI 静态文件插件（extras，核心仍零第三方依赖） - 内容寻址发布到对象存储 + 逐对象校验的取回客户端 - 压缩默认改回 zlib：实测比自研哈夫曼体积小 1/3~1/170、快数百倍其它： - P2-4：时间戳显式转字符串，清掉 1240 条 DeprecationWarning（盘上格式不变） - read_file 负数 offset/size 改为报错（原先会走切片语义从末尾取） - requires-python 从 >=3.7 改为按实际 API 推导的 >=3.9 测试：0 → 343 个用例，纯标准库 unittest，有/无 FastAPI 两种环境都跑通。证据见 docs/evidence-*.txt。	2026-09-14 00:11:42 +08:00

Author

SHA1

Message

Date

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

chakcy

06ec7c38bc

feat: 统一 svfs 子命令入口，打包进度回调与对象缓存路径

桌面应用（svfs-studio / svfs-client）要用的前置改动：

* 新增 src/sqlite_vfs/cli/main.py：`svfs <子命令>` 统一入口，旧的独立命令
  （vfspack / vfsunpack / …）保留为别名，两套跑同一段 execute(args)；各子命令
  因此从 sys.exit() 改成返回退出码，便于被复用；
* FolderPacker.pack_folder(progress=…)：每处理一个条目（目录也算）回调一次，
  供 GUI 进度条使用；只有传了回调时才做"只 stat、不读内容"的预扫描，CLI 的
  行为与开销不变；回调抛出的异常一路上抛——GUI 的中断语义就靠它；
* publish.default_cache_dir()：对象缓存目录（客户端设置里可改）；load_manifest
  对"误把服务器根地址当清单填进来"给出可用插件列表的提示，而不是只甩一个
  format=None。

测试：新增 tests/test_cli_main.py、tests/test_pack_progress.py，test_publish.py 补充。

2026-09-16 17:15:16 +08:00

chakcy

ecdfacc620

fix+feat: 修复打包/解包主链路，并把存储层重建为内容寻址 + 快照

起始状态：主链路 100% 不可用，而且失败被静默吞掉——打包后库里 0 个文件、
界面仍打印"文件数量: N"；解包导出 0 个文件并在磁盘上生成几百层 sub/sub/sub 垃圾目录。

缺陷修复（4 个 P0 + 12 个 P1，逐条见 BUG_REPORT.md）：
- 建表列名 compresse_algo 与 INSERT/read_file 用的 compress_algo 不一致
- list_directory 按 path 而非 parent_path 过滤，导致导出无限自递归
- CLI --ignore-timestamps 把 export_filesystem 赋成引用自身的 lambda
- add_file 缺少 commit（直接调用 API 时静默丢数据）
- LIKE 前缀误伤兄弟目录（删 doc 连带删 docs）；mv_dir 二次改名
- 失败路径一律返回 exit code 0；--exclude 是子串匹配而非 glob
- FolderPacker.add_file 反向调用 export_file_safe，会用库内内容覆盖源文件

存储层（schema v3，格式变更，提供 vfsmigrate 迁移）：
- 内容移入 blobs(hash PRIMARY KEY)：相同内容只存一份，跨路径/跨快照共享
- files 的唯一约束改为 UNIQUE(snapshot_id, path)：一个库存多个版本
- 完整性：每文件 sha256 + 快照级摘要 + HMAC-SHA256 签名，只读连接即可验证
- 增量打包：按 mtime+size 或 sha256 只写变化项，未变文件不重写不重压
- get_file_info 不再返回 content（元数据查询不该搬 BLOB）

新增能力：
- 可选 FastAPI 静态文件插件（extras，核心仍零第三方依赖）
- 内容寻址发布到对象存储 + 逐对象校验的取回客户端
- 压缩默认改回 zlib：实测比自研哈夫曼体积小 1/3~1/170、快数百倍

其它：
- P2-4：时间戳显式转字符串，清掉 1240 条 DeprecationWarning（盘上格式不变）
- read_file 负数 offset/size 改为报错（原先会走切片语义从末尾取）
- requires-python 从 >=3.7 改为按实际 API 推导的 >=3.9

测试：0 → 343 个用例，纯标准库 unittest，有/无 FastAPI 两种环境都跑通。
证据见 docs/evidence-*.txt。

2026-09-14 00:11:42 +08:00