Repository navigation
更新日志
6.0
6.0 是主版本更新,以精简为首要目标,有不兼容的改动。
不兼容的改动
- 删除了桌面端,以及
serve --desktop、config import、ffmpeg命令。 - 删除了
analytics overall --force、group members --refresh和回复里的fromCache:这些数据现在每次都重新统计。 - 命令 API 的版本从 1 升到 2,WebUI 需要 0.5.0 或更新的版本;
chat messages和搜索的回复改为类型化字段,serverId改为字符串。
旧版本选定过网页版本的用户,升级后会自动下载适用的网页版本。
完成的 issue
新功能和优化
- #17 weflow config set db_path 支持 网络路径(#584)
- #101 CLI 图片自动下载在 Windows 上用 Rust 代替 PowerShell Get-CimInstance 查找微信主进程(#583)
- #257 Rust 后端使用明确结构体,输出时再序列化,并对比性能与资源占用(#536)
- #259 配置一个基准测试workflow(#512)
- #332 fix(webui): 为 WebUI 下载增加跨进程锁,避免并发重复拉取 GHCR(#386)
- #353 WebUI 导出聊天框(#387)
- #354 WebUI 左边和上边的白色光影问题(#442)
- #355 WebUI 聊天列表(#586)
- #390 WebUI:「我的足迹」导出加上 CSV 和 Excel(#585)
- #397 建立 CLI/HTTP 共用的类型化业务请求与执行分发(#410)
- #398 抽象后台任务与 HTTP 适配层,评估独立 crate(#412)
- #399 定义关键 API 数据模型及 Rust/TypeScript 生成流程(#428)
- #401 拆分 WebUI AppShell、页面编排与业务状态(#418)
- #406 WebUI 增加weflow serve设置功能(#599)
- #413 把 WebUI 仍走子进程的读迁到进程内(#424)
- #430 其余命令的回复改用类型化模型,并在 /openapi.json 里描述 data(#480)
- #432 serve:参数写错的 /api/ 请求会起子进程报错(#437)
- #439 WebUI:界面文字跟随服务端的语言(#594)
- #464 #391 收尾:按 rust-best-practices 复查主线的 Rust 改动(#483)
- #486 chat messages 用 offset 翻到大会话中间页约 2.5 秒,耗时随 offset 线性增长(#503)
- #488 基准测试用的合成账号:与真实数据相同的复杂度和随机性(#511)
- #491 导出链路直接消费消息行结构体(#531)
- #492 API 与 CLI 读取路径改为明确结构体,输出时再序列化(#533)
- #493 #257 收尾:清点剩余 Value 并提交最终对照表(#536)
- #495 CLI 去掉 WXGF 转换的 ffmpeg 兜底(#557)
- #496 删除 weflow ffmpeg 命令、ffmpeg.rs 与 ffmpeg_base_url 配置(#561)
- #500 评估 PGO 与 BOLT(#575)
- #513 基准测试:统计分配次数、累计分配字节和峰值存活堆内存(#520)
- #516 发版时可选运行基准测试,并在更新日志里附上可直接打开的报告链接(#518)
- #519 补测历次正式版之间的基准测试,并补进各自的 release 说明(#587)
- #521 导出时从消息 XML 取字段改用非正则的解析(#543)
- #523 真实账号上 json 导出比 chatlab 慢一倍(#545)
- #537 删除桌面端:Fork 上游的 Electron 备份和只为桌面端存在的 Rust 部分(#540)
- #546 导出时每条消息的 XML 被重复规范化和全文扫描(#549)
- #547 导出路径上剩下的正则换成等价的扫描(#550)
- #548 减少导出路径上的分配和复制(#555)
- #559 修复 heic-rs 的 4:2:2 帧内解码,补上 4:2:2 的 WXGF 画面(#560)
- #562 删除不再使用的内置视频解码 wasm(wasm_video_decode)(#563)
- #576 群成员分析每次都整表扫描,没有消息的成员也要约 0.9 秒(#580)
- #602 基准结果改为单个提交一份:环境键、锚点,对比拆成单独的脚本(#606)
- #603 bench.yml 逐个提交测量,跑在自托管 runner 上,结果存进 gh-pages(#606)
- #605 合成基准账号的分布改成 profile 文件,用真实账号自动定期校准,输出里不出现真实数据(#611)
- #607 chat export-stats 自 v5.0.1 起慢了约 4.5 倍,读取量多了 16 倍(#631)
- #628 WebUI 多格式导出的并行化:可行性、速度与效率评估(#630)
修复
- #287 serve:取消 key db 作业会直接结束进程,硬件断点可能留在微信里(#581)
- #307 analytics overall 的 activeDays 是按月份数估算的,不是实际天数(#388)
- #315 export footprint 除 JSON 外的格式输出不正确(#389)
- #336 网页:年度报告报错 method not allowed; use POST(#385)
- #369 WebUI:App.test 在 bun test 下有 act 警告,打乱顺序时有一个测试失败(#384)
- #382 发布说明的更新日志漏掉了用 gh stack 合并的下层 PR 和它们关闭的 issue(#383)
- #415 WebUI:从足迹或资源页打开聊天时,不会定位到那条消息(#416)
- #433 serve:同一请求带不带 /api/,错误消息的语言可能不同(#438)
- #443 serve:解析过的消息的 messageKey 带出了数据库的本机完整路径(#444)
- #460 年度报告平局时选出的好友每次运行可能不同(#462)
- #574 基准账号的语音数据是随机字节,SILK 解码全部失败(#582)
- #600 读取层没有读 biz_message 库:公众号消息和服务通知(含微信支付)都看不到(#632)
- #609 单独运行 cargo test -p weflow-native 编译失败:找不到 weflow_silk(#612)
- #635 升级到新 API 版本后,选定过网页版本的用户打不开网页(#636)
其他
- #127
key db有几率检测不到微信退出完全(#440) - #396 梳理 CLI、HTTP 与 ServiceHub 的命令执行路径及职责边界(#407)
- #400 补齐 API 契约及跨版本边界测试(#435)
- #403 建立 CLI/HTTP/WebUI 重构基线与自动回归矩阵(#408)
- #494 验证内置 WXGF 解码器的覆盖面与损坏数据的健壮性(#556)
- #501 用 Kani 证明关键纯函数的性质(#579)
- #502 用 proptest 做分页、页解密、解码与导出的性质测试(#578)
其他改动
- #409 refactor(core):共用的类型化读取,CLI 与 /api/ 走同一个业务入口
- #417 refactor(web): 把侧边栏、媒体预览和配置向导从 App 拆出
- #420 fix(serve): 配置文件在同一时间刻度内被改两次时,按内容判断变化
- #421 fix(web): 换账号后不再向新账号请求旧账号的会话
- #422 perf(web): 联系人列表按账号只读一次
- #423 feat(serve): WebUI 其余的只读命令改在服务进程内执行
- #426 feat(core): 关键读取改用类型化的传输模型,serverId 改为字符串
- #427 feat(serve): /openapi.json 描述回复里 data 的结构,并保存契约快照
- #434 契约边界测试(一):用 jsonschema 校验样本和服务端的真实回复
- #441 serve:取消 key db 时先让它撤掉微信里的断点再结束
- #446 chat 的 7 条读取改用类型化模型,并在契约里描述 data
- #447 group 的 7 条读取改用类型化模型,并在契约里描述 data
- #449 analytics 的 5 条读取改用类型化模型,并在契约里描述 data
- #450 /health 告诉客户端服务端的语言
- #451 WebUI 跟随服务端的语言:多语言基础和外壳的英文
- #453 sns 的 3 条读取和年度报告的年份改用类型化模型
- #454 sns timeline 改用类型化模型,并在契约里描述帖子的结构
- #456 biz 的 3 条读取改用类型化模型,并在契约里描述 data
- #457 设置相关的 6 条读取改用类型化模型,并在契约里描述 data
- #458 insight footprint 和 insight get 改用类型化模型,进程内读取的契约补齐
- #459 修复 Linux 上 insight 端到端测试的编译错误
- #461 年度报告和双人报告改用结构体并写入契约
- #465 insight 命令改用结构体并写入契约
- #466 chat export-stats 和 transfer-names 改用结构体并写入契约
- #468 cache、config 和 lang 的写命令改用结构体并写入契约
- #469 backup 命令改用结构体并写入契约
- #471 写出单个文件的导出改用结构体并写入契约
- #472 消息和媒体导出改用结构体并写入契约
- #474 image 和 video 命令改用结构体并写入契约
- #475 ffmpeg、runtime manifest 和 web 命令改用结构体并写入契约
- #477 key、db scan 和 db open 改用结构体并写入契约
- #478 chat 媒体相关命令改用结构体并写入契约
- #479 refactor: sns 下载类命令的回复改用结构体并写入契约(#430)
- #482 refactor: 锁中毒和不会发生的失败改用写明原因的 expect(#464)
- #485 refactor(cli): 把解析好的命令交给执行路径,不再复制命令参数(#464)
- #506 perf:去掉多余的 clone,并在整个 workspace 打开 redundant_clone 与 large_futures 规则
- #507 docs:为每个 unsafe 块写明安全依据,并打开 undocumented_unsafe_blocks 规则
- #508 重构:打开 unwrap_used 和 expect_used 规则,产品代码中会出错的路径不再 panic
- #509 重构:打开 cast_possible_truncation 规则,缩窄转换不再静默截断
- #514 fix(ci): 修复基准测试 workflow 首次运行在 4 核 runner 上的失败(#259)
- #515 feat(ci): 基准测试汇总改成中文,report.html 用 HTML 表格(#259)
- #524 refactor(native):消息行按 RowShape 读取,可以是带类型的 MsgRow 或旧格式的 JSON(#490)
- #534 ci(bench):整理 bench.yml 传给 bench.py 的可选参数
- #538 refactor(assets):CLI 嵌入的文件搬进 weflow-assets(#537)
- #539 refactor!:删除桌面端和只为桌面端存在的 Rust 部分(#537)
- #542 ci(web):契约兼容检查改为和最新发布版比较
- #544 导出时同一张表的键只重新读一次
- #551 导出时复用 zstd 解压上下文,不读用不到的 source 列
- #553 feat(ci): 基准测试运行页面的汇总里显示内存曲线
- #564 perf(stats): 删掉统计缓存和群面板缓存,不靠缓存也更快
- #565 perf(native): 页缓存降到 16 MiB,offset 分页只读索引,聊天日期只解密时间
- #567 perf(stats): 整表统计改为逐页读表,多张表同时读
- #568 perf(report): 年度报告扩展统计改为逐页读表,按会话并行
- #569 perf(export): 每条消息的 XML 只解析一次
- #570 feat(bench): 基准测试报告列表页跟随系统深色模式
- #571 feat(bench): 基准测试报告页跟随系统深色模式
- #572 feat(bench): 基准测试报告列表页和报告页改为靠左
- #573 perf(chat): 解析过的消息把应用消息字段放进 Box,并加上类型大小与 FFI 布局断言
- #577 perf(native): CPU 支持时 SHA-512 用上 BMI1/BMI2(sha2 打补丁,运行时选用)
- #588 feat(web): 聊天页的英文界面
- #589 feat(web): 日历、任务中心和导出页的英文界面
- #590 feat(web): 通讯录、朋友圈和微信支付的英文界面
- #591 feat(web): 资源、备份和足迹的英文界面,英文词典按需加载
- #592 feat(web): 聊天分析和灵感信箱的英文界面
- #593 feat(web): 年度报告和双人报告的英文界面
- #595 refactor(web): 删掉设置页的输出语言选项
- #596 feat(serve): 经命令 API 换的网页版本立刻生效
- #597 feat(web): 在设置里管理网页版本
- #598 feat(serve): serve 的启动选项可以存进配置文件
- #608 build(deps): sha2 补丁跟进上游 #940 的审查意见
- #613 基准补测前的准备:给提交起名字、失败时跳过、保留近期工具链、标出「还没有」的命令
- #614 基准查看页认 BENCH- 自动链接:一个参数指定 base 和 head
- #615 基准结果在发布到 gh-pages 之前一直保留,上传失败不再丢数据
- #616 基准运行页面的 Summary 改为总结运行情况
- #617 基准运行情况改由 publish job 写进 Summary,并按要求补齐内容
- #618 整理基准 workflow:两个提交时给出对比链接,删掉运行页面不再用的代码
- #619 基准 workflow 的 release_tag 输入说明改得更直白
- #620 基准结果里用分支指定的提交记成 分支@提交
- #621 基准查看页报告开头的文字改得更简短
- #622 基准查看页不显示二进制报告的版本号,以 tag 为准
- #623 基准查看页的文案改为书面语
- #624 发布说明里的性能基准一节改为书面语
- #625 补写性能基准时发布说明末尾不再累积空行
- #626 发布说明的性能基准链接改为「在基准测试页查看」
- #627 未发布的 API 版本号由 3 改为 2
- #629 会话行按下时和侧边栏一样收缩
- #633 发布 v6.0.0-rc.1 和 WebUI 0.5.0 的版本号
- #634 更新日志的上一个版本改为按版本号大小选择
- #637 修复更新日志把 issue 号当作 PR 号导致发布失败
- #640 发布 v6.0.0 的版本号
新登记的 issue
- #431 openapi-typescript 支持 TypeScript 7 后,改用它生成 WebUI 的契约类型
- #552 重新设计html导出样式
- #554 重写weflow serve webui 从tsx到rust
- #610 基准测量多种形状的合成账号,减少对单一账号的过拟合
完整对比:v5.0.1...v6.0.0
性能基准
与 v5.0.1 对比。两个版本在同一台自托管 Windows x64 机器上、以合成的基准账号分别测得:在基准测试页查看
- 二进制体积:28.7 MiB → 27.0 MiB(0.94×)
- 命令耗时变化:
export messages json with images27,456 → 24,134 ms(0.87×,已按锚点校正);export messages json3,983 → 1,741 ms(0.44×,已按锚点校正);export messages chatlab2,940 → 1,638 ms(0.53×,已按锚点校正);export messages excel4,124 → 3,182 ms(0.78×,已按锚点校正);export messages html2,806 → 1,909 ms(0.70×,已按锚点校正);export messages txt2,684 → 1,536 ms(0.63×,已按锚点校正);report annual2,179 → 970 ms(0.45×,已按锚点校正);analytics overall919 → 334 ms(0.35×,已按锚点校正);group members1,063 → 363 ms(0.34×,已按锚点校正);group ranking1,059 → 357 ms(0.35×,已按锚点校正);chat export-stats1,000 → 371 ms(0.40×,已按锚点校正);chat date-counts809 → 312 ms(0.40×,已按锚点校正);report dual405 → 278 ms(0.66×,已按锚点校正);chat messages offset2,744 → 324 ms(0.12×,已按锚点校正);其余 4 条处于噪声范围内 weflow serve持续负载:每秒请求数 1.3 → 52,延迟 p50 726 → 32 ms,工作集 828 → 190 MiB;head 的内存在后半段上升 23 MiB- serve_bench:24 个路由加快 10% 以上,5 个变慢 10% 以上
下载
不知道选哪个?先看你的系统,再往下看对应的说明。绝大多数 Windows 电脑选 x64 就对了。
本版本提供构建来源证明(Artifact Attestation)。安装 GitHub CLI 后,点击以展开对应下载项下的“验证下载文件”,在下载目录执行其中的命令,即可验证压缩包的完整性和构建来源。验证成功表示文件完整,且与本仓库签署的构建来源证明一致;无需另外下载
.sha256文件。
Windows
weflow-v6.0.0-windows-x64.zip
适合绝大多数 Windows 电脑,包括常见的台式机和笔记本(Intel 或 AMD 处理器)。不确定就选这个。
验证下载文件
在下载目录中执行:
gh attestation verify weflow-v6.0.0-windows-x64.zip --repo 334456777/WeFlowweflow-v6.0.0-windows-arm64.zip
只适合使用 ARM 处理器的 Windows 电脑,比如搭载骁龙芯片的笔记本、Surface Pro X。这类电脑比较少见。
验证下载文件
在下载目录中执行:
gh attestation verify weflow-v6.0.0-windows-arm64.zip --repo 334456777/WeFlow怎么确认:打开「设置 → 系统 → 系统信息」,看“系统类型”。写着“x64 处理器”选上面那个,写着“ARM 处理器”选这个。
macOS(苹果电脑)
weflow-v6.0.0-macos-arm64.tar.gz
适合2020 年底之后发售的 Mac,也就是用苹果自家芯片(M1、M2、M3 等)的机器。
验证下载文件
在下载目录中执行:
gh attestation verify weflow-v6.0.0-macos-arm64.tar.gz --repo 334456777/WeFlowweflow-v6.0.0-macos-x64.tar.gz
适合较老的 Mac,也就是用 Intel 处理器的机器。
验证下载文件
在下载目录中执行:
gh attestation verify weflow-v6.0.0-macos-x64.tar.gz --repo 334456777/WeFlow怎么确认:点屏幕左上角苹果图标 →「关于本机」。“芯片”一栏写着 Apple M1 之类的,选第一个;写着 Intel 的,选第二个。
Linux
weflow-v6.0.0-linux-x64.tar.gz
适合常见的 Linux 电脑和服务器(Intel 或 AMD 处理器)。
验证下载文件
在下载目录中执行:
gh attestation verify weflow-v6.0.0-linux-x64.tar.gz --repo 334456777/WeFlowweflow-v6.0.0-linux-arm64.tar.gz
适合使用 ARM 处理器的 Linux 设备,比如运行 64 位系统的树莓派、部分云服务器。
验证下载文件
在下载目录中执行:
gh attestation verify weflow-v6.0.0-linux-arm64.tar.gz --repo 334456777/WeFlow怎么确认:打开终端输入
uname -m。显示x86_64选 x64,显示aarch64选 arm64。
下载后怎么用
每个压缩包里有 weflow 程序、README.md(英文说明)、README.zh-CN.md(中文说明)和 LICENSE。下载后解压(tar.gz文件用tar -zxvf <文件名.tar.gz>)就能使用里面的 weflow。
没见过?不会用?把文件扔给蓝色大肥鱼,她会解释。