 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
|
a7d7a8fb14
|
modify: 0.2.0
|
2026-09-14 00:58:53 +08:00 |
|
|
chakcy
|
1620d3eb5a
|
docs: 补 README 能力章节、缺陷报告与两份设计说明
- README：新增「数据能力」四节（内容寻址去重 / 快照与时间旅行 / 完整性校验与签名 /
增量打包）与「发布到对象存储」一节，附实测对比表；重写「要不要用 --compress」
（结论从"别用"反转为"默认就该开"）、「迁移旧格式」；修正项目结构与字段表
- BUG_REPORT.md：13 节，含 P0/P1 逐条分析、P2/P3 清单、五批后续追加的记录，
以及过程中被推翻的两处结论（第九节的压缩建议、P3-1 的 uv sync 判断）
- docs/encryption-design.md：加密的设计说明——去重与随机 nonce 的冲突、
标准库没有密码学原语、以及现有 freq_blob 可作为每块附加数据的槽位
- docs/evidence-*.txt：各阶段的测试运行证据（修复前 / 修复后 / 双环境）
|
2026-09-14 00:11:53 +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 |
|
|
chakcy
|
161ac9129f
|
modify: READNE.md
|
2026-01-23 17:50:27 +08:00 |
|
|
chakcy
|
dd5d9a11ad
|
create: 创建 svfs 仓库
|
2025-11-07 20:52:44 +08:00 |
|