weflow-cli 1.5.0 → 1.6.1

package/docs/RELEASING.md

@@ -0,0 +1,124 @@
+# 发布清单
+
+npm 包与 GitHub 分开发布，中间隔多久都不奇怪——`1.5.0` 与主线之间曾拉开 128 个提交、
+两个多月，直接导致用户照着 README 敲 `init --path` 却报 `unknown option`。
+
+按下面顺序走，每一步都有对应的**失败长什么样**。
+
+## 1. 定版本号
+
+按语义化版本，不是按「改了多少行」：
+
+| 改动性质 | 升哪一位 | 例 |
+| --- | --- | --- |
+| 新功能、新命令、新参数 | **minor** | 1.5.0 → 1.6.0 |
+| 只修 bug、只改文档 | patch | 1.6.0 → 1.6.1 |
+| 破坏兼容 | major | 1.6.0 → 2.0.0 |
+
+已备好但**从未发布**的版本号可以并进下一个：`1.5.1` 准备过却没发，
+它的修复就直接并进了 `1.6.0`。
+
+## 2. 整理 CHANGELOG
+
+- 把 `## Unreleased` 改名为 `## <新版本号>`
+- 若上一版已写好但没发布，把它的条目并入，删掉那个空段
+- 通用说明（如「npm 与 GitHub 分开发布」）移到文件顶部，别留在版本段里
+
+## 3. 构建与测试
+
+```powershell
+npm run build
+npm test
+```
+
+## 4. 打包检查（**不能跳过**）
+
+```powershell
+npm pack --dry-run
+```
+
+本地常有 `output/`（几 GB 产出）、`models/`（几 GB 模型）、`_env.json`（含密钥）
+这类东西。`package.json` 的 `files` 是白名单，理论上挡住——但**白名单也可能写漏**，
+所以逐项确认：
+
+```powershell
+npm pack --dry-run 2>&1 | grep -E "npm notice [0-9]" > /tmp/list.txt
+grep -E "^output/|^models/|node_modules|\.env|\.db$|\.dat$|secret|credential" /tmp/list.txt
+```
+
+**这条命令必须没有输出。** 有输出就停下来查。
+
+同时确认新增文件确实**在**包里（白名单是按目录配的，容易漏）：
+
+```powershell
+grep -E "新文件名" /tmp/list.txt
+```
+
+## 5. 发布
+
+需要 npm 凭据。`ribiaosu` 账号开了 2FA，所以两条路：
+
+**凭据（推荐，一次配置长期可用）** — 用**带 `Bypass 2FA` 的 Granular Access Token**，
+在 https://www.npmjs.com/settings/ribiaosu/tokens 生成时**必须勾选那个框**。
+漏勾的 token 会在发布时报 `403 ... bypass 2fa enabled is required`。
+
+| 现象 | 原因 |
+| --- | --- |
+| `403 ... two-factor authentication ... required` | token 没勾 Bypass 2FA，或没用 OTP |
+| `ENEEAUTH` | 没登录 / 没配 token |
+
+**验证 token 是否可用**（`bypass_2fa` 必须是 `true`）：
+
+```powershell
+curl -s -H "Authorization: Bearer <token>" https://registry.npmjs.org/-/npm/v1/tokens
+```
+
+**一次性验证码**：
+
+```powershell
+npm publish --otp=<6位码>
+```
+
+## 6. 触发国内镜像同步（**新加的必要步骤**）
+
+国内用户大多用 `registry.npmmirror.com`（淘宝源），它对新版本有同步延迟。
+不同步的话，发布后几个小时内会有人来提「版本不存在」的 issue——
+`weflow-cli@1.6.0` 就这样被报过一次（Issue #8）。
+
+```powershell
+curl -X PUT https://registry.npmmirror.com/-/package/weflow-cli/syncs
+```
+
+返回 `{"ok":true,...,"state":"waiting"}` 即已受理。**约 5 分钟后**生效。
+
+## 7. 验证两个源都是新版本
+
+```powershell
+npm view weflow-cli version --registry=https://registry.npmjs.org
+npm view weflow-cli version --registry=https://registry.npmmirror.com
+```
+
+两个都要是新版本号才对外宣告。官方源发布后自身也有几分钟 CDN 传播延迟——
+期间 `npm view` 可能显示旧版本、tarball 可能 404，**这是在传播，不是失败**。
+用这个判断是否真的发出去了：
+
+```powershell
+npm publish    # 再发一次
+```
+
+报 `409 Conflict - Cannot publish over previously staged version` → **已经发布成功**。
+
+## 8. 兜底：告诉用户怎么绕开镜像
+
+```powershell
+npm config get registry                                            # 看用的哪个源
+npm view weflow-cli version --registry=https://registry.npmjs.org  # 用官方源查
+```
+
+两个源结果不一致 → 是镜像同步问题，不是包的问题：
+`npm install -g weflow-cli@<版本> --registry=https://registry.npmjs.org` 立刻可用。
+
+## 发布后
+
+- 回到相关 issue 回复「已发布 + 升级方式」
+- GitHub Release 与本清单解耦：源码、编译包、npm 三者版本差异要对用户可见

package/docs/ROADMAP.md

@@ -0,0 +1,191 @@
+# WeFlow CLI 整体改进与扩展计划书
+
+> 版本：草案 v1.0  
+> 适用范围：`weflow-cli` 主仓库、CLI、MCP、本地阅读器，以及基于公开数据契约的合作集成。  
+> 本文描述方向、分期、验收标准与维护机制；当前已实现能力以 [PROJECT_STATE.md](PROJECT_STATE.md) 为准。
+
+## 一、定位与目标
+
+WeFlow CLI 的长期定位是**用户授权的本地数据底座**：在用户设备上，将本地聊天、公众号阅读、收藏与知识资料整理为可查询、可导出、可被 AI 或合作应用在明确边界内使用的数据能力。
+
+项目不以替代官方客户端或进行账号自动化为目标。核心价值是让用户能够在本地完成资料整理、阅读、检索、导出、复盘与受控分析，并为上层产品提供稳定、可审查的接口。
+
+未来 12 至 18 个月的目标：
+
+1. **稳定可用**：初始化、数据库访问、导出与日报在支持的平台上有清晰诊断、可重试路径和回归验证。
+2. **数据可信**：消息、媒体、来源、时间范围和导出覆盖状态可被追溯；宁可标记缺失，也不误配内容。
+3. **AI 可控**：本地流程默认可不用 AI；需要云端 AI 时，让用户看得见输入范围、成本与执行结果。
+4. **面向合作扩展**：以版本化 JSON 数据契约和只读 MCP 为边界，让 `she-love-me` 等合作项目可以接入，而不触及数据库、密钥或本地目录。
+5. **长期可维护**：让后续维护者和 Agent 能从项目状态、决策记录、测试与问题模板快速理解现状并连续推进。
+
+## 二、发展原则
+
+| 原则 | 具体要求 |
+| --- | --- |
+| 本地优先 | 原始聊天数据、数据库访问凭据、导出文件默认保留在用户设备；不把真实数据写入仓库、测试或公开报告。 |
+| 用户授权 | 仅处理用户本人拥有或明确获授权的数据；涉及写入、发布、云端处理与长期服务时采用预览和确认。 |
+| 准确优先 | 媒体、联系人与会话匹配必须依赖可靠身份；无法可靠对应时显示占位与原因，不以猜测填充。 |
+| 兼容演进 | CLI 人类可用输出保持稳定；面向工具的 JSON/MCP 接口采用版本化、可扩展、保留未知字段的方式演进。 |
+| 默认最小权限 | MCP 默认只读；助手默认拒绝陌生来源；本地阅读器仅监听回环地址。 |
+| 可验证交付 | 每项功能都要有明确入口、成功条件、失败诊断和与风险相称的自动化或本机验证。 |
+
+## 三、现状与主要缺口
+
+| 能力线 | 已有基础 | 主要缺口 |
+| --- | --- | --- |
+| 本地聊天数据 | 会话、联系人、消息、收藏、朋友圈缓存与多格式导出；支持部分 NT 媒体和 HTML 阅读 | 微信版本与媒体格式变化快；资源库映射、图片/表情/视频覆盖率仍需提升；导出覆盖情况需要更清晰地呈现。 |
+| 初始化与诊断 | 复用已验证配置、按需刷新、路径发现、缺失密钥测试 | 支持场景需要形成更标准的诊断包与兼容性矩阵，减少 Issue 中的反复沟通。 |
+| 公众号日报 | 来源筛选、分类、补昨日报、无 AI 运行、HTML 阅读器、收藏同步 | 需要提升抓取韧性、增量更新、阅读质量与定时任务可观测性。 |
+| 知识与 AI | Vault、检索、RAG、阅读笔记、报告和隐私模式 | 需要统一数据选择、成本提示、结果引用、可复现评估与本地模型体验。 |
+| Agent/MCP | 只读 MCP、能力发现、版本化消息数据契约 | 工具覆盖仍不完整；需要稳定分页/增量同步、模拟数据集与合作接入指南。 |
+| 工程治理 | 项目状态、技术决策、安全说明、测试与 CI | 需要路线图、发布节奏、依赖治理、性能基线与更结构化的 Issue/PR 流程。 |
+
+## 四、分期路线
+
+### P0：可靠性与导出修复
+
+**目标：** 让用户最常使用的初始化、查询和 HTML 导出流程稳定、可解释。
+
+| 工作项 | 交付物 | 验收标准 |
+| --- | --- | --- |
+| 初始化兼容性 | 支持版本/平台矩阵、脱敏诊断命令、常见失败决策树 | 在支持版本上可完成配置验证；失败结果能区分路径、运行环境、数据库访问与客户端状态问题。 |
+| 媒体导出可靠性 | 会话级缓存索引、图片/表情/转发卡片渲染、媒体覆盖统计 | HTML 能展示可可靠关联的本地媒体；无法匹配的记录不出现错图；导出完成后报告图片、表情、链接与占位数量。 |
+| 导出性能 | 本地媒体优先、远程资源预算、可选的离线模式 | 大会话导出不会因外部封面请求无限等待；离线模式可在无网络时完成本地内容导出。 |
+| 回归样本 | 完全合成的数据库/缓存夹具与真实机脱敏验证清单 | 每种媒体分支至少有合成回归；发布前按清单完成一次本机真实验证。 |
+
+**优先顺序：** 先修复数据错配和导出失败，再增加新媒体格式；所有“显示更多内容”的改动都必须先证明不会把无关媒体关联到消息。
+
+### P1：数据底座与稳定接口
+
+**目标：** 将当前 CLI 能力整理为可供其他本地应用和 Agent 安全调用的数据层。
+
+| 工作项 | 交付物 | 验收标准 |
+| --- | --- | --- |
+| 数据契约完善 | `weflow-message/v1` 补充媒体状态、来源字段、覆盖信息和兼容策略 | 下游应用无需读取数据库即可消费消息；未知类型、缺失媒体和分页边界均有明确语义。 |
+| 增量同步 | 基于时间窗的重叠读取、去重建议、稳定的同步状态文件 | 重新运行不会遗漏边界消息；下游能判断结果是否可能不完整。 |
+| MCP 扩展 | 与 CLI 共享的只读工具：会话发现、分页读取、导出任务状态、日报读取 | 工具输入有上限和校验；响应不包含密钥、路径、未授权会话或完整无界数据。 |
+| 数据质量报告 | `check` 或独立只读命令输出结构化健康摘要 | 用户可看到数据库可读性、媒体覆盖、日报完整性与配置状态，而不暴露敏感内容。 |
+| 合作接入包 | 合作方 README、模拟数据、兼容性测试和最小示例 | 合作项目可在没有真实微信数据的环境中完成开发与集成测试。 |
+
+### P2：日报与个人知识工作流
+
+**目标：** 把公众号阅读、收藏、笔记和知识检索变成连续且可控的个人工作流。
+
+| 工作项 | 交付物 | 验收标准 |
+| --- | --- | --- |
+| 日报韧性 | 来源健康状态、失败重试、去重、补报记录、生成摘要 | 当天或昨日报缺失时能说明原因并可重跑；不会重复写入同一篇文章。 |
+| 阅读器体验 | 来源/类别筛选、搜索、阅读进度、收藏与本地笔记关联 | 所有状态保存在本地；刷新后阅读和收藏状态可恢复。 |
+| 来源配置 | 来源类别、白名单/停用状态、来源发现与导入导出 | 已分类来源不重复调用主题分类；用户可迁移自己的来源配置。 |
+| 知识沉淀 | 将日报、收藏和用户笔记转成可追溯的 Vault 条目 | 每条知识条目保留来源、日期和原始链接；生成内容与原始材料可区分。 |
+| 定时运行 | 可查看、可暂停、可重跑的本地任务状态 | 定时任务失败会留下脱敏状态与下一步建议；不会静默重复启动阅读器。 |
+
+### P3：受控 AI 与个人助手
+
+**目标：** 让 AI 成为用户的本地数据助手，而不是不透明的数据出口。
+
+| 工作项 | 交付物 | 验收标准 |
+| --- | --- | --- |
+| 统一 AI 执行层 | 模型、端点、隐私模式、输入上限、成本预估与执行审计的统一配置 | 每次云端调用可说明发送范围和模型；关闭 AI 后所有非 AI 流程仍完整可用。 |
+| 检索与问答质量 | 引用原始片段、时间/来源筛选、回答置信提示与反馈入口 | 回答能指出使用了哪些本地材料；不把检索结果当作未经核实的事实。 |
+| 法律线索辅助 | 面向用户选择的材料进行事件线索、时间线和证据清单整理 | 输出明确标记为线索整理，不替代法律意见；原始材料、导出副本和分析结果可独立保存。 |
+| 助手权限模型 | 会话/群组级白名单、只读工具选择、人工确认的写操作 | 默认拒绝；任何外发、写入或发布均经过预览与明确确认。 |
+| 本地模型支持 | 本地模型发现、能力检测、降级策略和性能说明 | 未配置云端密钥时，支持的本地模型可完成基础检索与摘要。 |
+
+### P4：生态合作与可持续维护
+
+**目标：** 让项目可被可靠复用、协作开发和长期维护。
+
+| 工作项 | 交付物 | 验收标准 |
+| --- | --- | --- |
+| 合作模式 | 数据契约版本策略、兼容性承诺、模拟集与集成 CI | 下游项目升级时可自动发现不兼容变更；合作方不能越过本地权限边界。 |
+| 插件/适配器机制 | 受限的本地适配器接口与能力声明 | 第三方扩展无法直接读取配置、数据库或任意文件；扩展能被单独禁用。 |
+| 发布治理 | 版本号、变更日志、GitHub Release、npm 发布核对表 | GitHub 源码、编译包和 npm 版本的差异对用户可见；发布前完成构建、测试和敏感信息检查。 |
+| 社区协作 | Issue 模板、兼容性反馈模板、PR 检查清单、贡献者指南 | 问题报告可复现且脱敏；外部贡献可通过自动检查与人工审阅。 |
+| 可观测性 | 本地匿名/脱敏运行摘要与性能基线 | 不采集真实聊天内容；维护者可定位慢导出、抓取失败和兼容性回归。 |
+
+## 五、横向工程专项
+
+### 1. 测试策略
+
+- **单元测试：** 路径解析、输入验证、数据契约、隐私过滤、媒体匹配和 AI 路由。
+- **合成集成测试：** 通过不含真实聊天内容的模拟数据库、缓存文件和 HTTP 夹具验证初始化、导出、日报与 MCP。
+- **本机验收清单：** 在用户授权的本地环境中验证会话读取、日期导出、图片/表情/链接、日报生成与阅读器启动；结果只记录计数和状态。
+- **兼容性回归：** 对每个支持的微信版本、操作系统和安装位置记录验证日期、通过项和已知限制。
+
+### 2. 性能与资源预算
+
+- 为导出、媒体扫描、日报抓取、索引和 AI 请求设定时间、文件大小、数量和内存上限。
+- 大任务提供进度、可取消能力和明确的部分完成状态。
+- 优先会话范围、日期范围和增量处理，避免无边界扫描全部数据。
+- 对远程封面、网页抓取和云端 AI 建立独立预算，使它们不阻塞本地核心流程。
+
+### 3. 安全与隐私治理
+
+- 新增外部网络访问、MCP 工具、写操作或数据导出格式时，先检查 `SECURITY.md` 与 `DECISIONS.md`。
+- 所有日志、测试夹具、Issue 示例和 CI 产物使用合成或脱敏数据。
+- 密钥仅从加密配置或环境变量进入子进程，绝不写入命令行、HTML、报告或版本库。
+- 定期审查依赖漏洞；升级先在独立改动中验证，不使用未经验证的破坏性自动修复。
+
+## 六、里程碑与验收节奏
+
+| 里程碑 | 建议周期 | 通过条件 |
+| --- | --- | --- |
+| M1：稳定导出 | P0 完成时 | 初始化、会话读取和 HTML 导出在支持环境可复现；媒体不发生已知错配；导出不会被外部网络长期阻塞。 |
+| M2：数据底座 v1 | P1 完成时 | CLI JSON 与 MCP 使用同一版本化契约；模拟集和合作接入示例可独立运行。 |
+| M3：阅读与知识闭环 | P2 完成时 | 公众号来源配置、日报、收藏和 Vault 之间可本地追溯，补报与失败恢复可验证。 |
+| M4：受控 AI 助手 | P3 完成时 | AI 调用范围、隐私模式、成本与引用可见；默认权限和确认机制通过回归。 |
+| M5：生态发布 | P4 完成时 | 发布流程、兼容性检查、合作接入和社区反馈机制形成稳定闭环。 |
+
+每个里程碑使用以下最小交付清单：功能说明、数据/权限边界、测试证据、已知限制、文档更新、可回滚方案。未满足这些条件的实验能力不进入默认工作流。
+
+## 七、优先级与资源建议
+
+### 必须优先投入
+
+1. 初始化和数据库兼容性。
+2. 导出准确性、媒体覆盖和性能。
+3. 数据契约与 MCP 的稳定性。
+4. 日报的可靠生成与本地阅读体验。
+5. 安全边界、文档和回归测试。
+
+### 条件成熟后推进
+
+1. 多模型和更复杂的 AI 分析。
+2. 法律线索整理与结构化证据包。
+3. 插件生态和更多外部合作。
+4. 更多平台与客户端版本的兼容适配。
+
+### 暂不纳入默认能力
+
+- 个人微信账号自动发消息、拉群、群管理或未验证的客户端自动化。
+- 向第三方直接暴露数据库、密钥、完整本地目录或无范围限制的聊天内容。
+- 无用户确认的云端分析、自动发布或跨设备同步。
+
+## 八、维护机制
+
+1. **每次改动先定位能力线：** 归入 P0–P4 或横向专项；没有对应目标的改动应说明必要性。
+2. **每次功能变更同步文档：** 用户可见行为更新 README/CHANGELOG，现状更新 `PROJECT_STATE.md`，长期取舍更新 `DECISIONS.md`。
+3. **每周维护检查：** 查看 Issue、PR、依赖告警、兼容反馈与定时任务状态；仅记录脱敏摘要。
+4. **每个发布前复核：** 构建、回归测试、媒体专项测试、敏感信息扫描、源代码与编译产物路径验证。
+5. **每季度复盘路线：** 根据真实 Issue、成功率、导出覆盖、日报完成率和合作集成反馈调整优先级，而不是仅按功能数量衡量进展。
+
+## 九、近期可执行清单
+
+以下任务可作为下一轮开发候选，按顺序推进：
+
+1. 为 HTML 导出增加结构化媒体覆盖报告，区分“本地缓存命中、远程封面、缺失占位、无法可靠匹配”。
+2. 完成高位编码的转发卡片渲染：同时保留本地缩略图、标题、描述和原始跳转链接。
+3. 建立合成 NT 媒体夹具与导出性能基线，覆盖图片、表情、转发文章、视频和缺失资源。
+4. 将消息契约的覆盖信息暴露给 CLI JSON 与 MCP，供合作项目显示不完整状态。
+5. 增加 `check --json` 的数据健康摘要，并加入日报与阅读器完整性检查。
+6. 为日报来源配置增加导入导出、失效来源提示和本地运行历史。
+7. 为合作项目提供只读集成示例、模拟数据和兼容性测试工作流。
+
+## 十、成功标准
+
+路线完成不是命令数量增加，而是达到以下状态：
+
+- 用户可以在支持环境中用清晰步骤完成初始化、读取、导出与日报生成，并在失败时得到不泄露隐私的可操作提示。
+- 导出的内容能够说明哪些媒体和链接被完整保留、哪些没有可靠来源，且不会误配他人或其他会话的媒体。
+- AI、MCP 与合作项目只使用用户明确允许的、范围受限的数据接口。
+- 项目维护者或新的 Agent 能仅依靠仓库文档、测试与模拟数据继续开发，而不依赖真实聊天记录或口头记忆。

package/docs/SETUP.md

@@ -0,0 +1,103 @@
+# WeFlow CLI 跨电脑部署指南
+
+本指南用于在新电脑部署当前源码。它不迁移数据库、密钥或聊天导出；每台电脑都应在本机重新配置，并只访问用户本人有权访问的数据。
+
+## 前置条件
+
+- Windows 10/11 x64 是当前重点验证平台；Node.js 18+、Python 3.10+。
+- 已安装并登录兼容的微信版本。微信数据库格式和平台行为可能随版本变化。
+- 足够的磁盘空间保存本地日报或导出副本。
+
+## 源码安装
+
+```powershell
+git clone https://github.com/zhuobichen/weflow-cli.git
+cd weflow-cli
+npm install
+npm run build
+python -m pip install -r requirements.txt
+weflow-cli check
+```
+
+开发时使用源码入口：
+
+```powershell
+npm run dev -- check
+npm run dev -- sessions
+```
+
+`npm install -g weflow-cli` 使用 npm 发布包；发布包和 GitHub `master` 的发布时间可能不同。需要确认功能版本时，查看 `package.json`、Git 提交和 `npm view weflow-cli version`，不要假定两者相同。
+
+## 初始化
+
+```powershell
+weflow-cli init
+```
+
+首次初始化时按 CLI 提示完成微信登录。已有有效配置会先验证并复用。数据在自定义目录时：
+
+```powershell
+weflow-cli init --path "D:\WeChatData"
+weflow-cli init --search-drives
+weflow-cli init --full-scan
+```
+
+推荐顺序是显式路径、跨磁盘标准目录搜索、深度结构搜索。不要为了排障把真实配置、数据库或密钥复制到仓库。
+
+换账号、换版本或访问失败时：
+
+```powershell
+weflow-cli init --refresh
+```
+
+完成后用 `sessions`、`contacts` 和一条最小范围的 `messages` 验证，不要直接批量导出。
+
+## Python 环境
+
+Node CLI 会调用当前 PATH 中的 Python。若安装了多个 Python，必须在同一个解释器中安装和检查依赖：
+
+```powershell
+python --version
+python -c "import sqlcipher3, cryptography, html2text, zstandard; print('OK')"
+python -m pip install -r requirements.txt
+```
+
+旧版 3.x 数据另装：
+
+```powershell
+python -m pip install -r requirements-3x.txt
+```
+
+## 日报与阅读器
+
+```powershell
+weflow-cli daily --no-ai
+weflow-cli daily-server --date YYYY-MM-DD --open
+```
+
+持久化关闭日报 AI：
+
+```powershell
+weflow-cli config set dailyAiEnabled false
+```
+
+日报输出和阅读器均为本地文件/回环服务。阅读器默认地址是 `http://127.0.0.1:8765/`，不要把端口暴露到局域网或公网。
+
+## 配置与隐私
+
+配置默认位于用户目录下的 `.weflow-cli/config.json`。路径由程序决定，不要在文档或 Issue 中写入真实用户目录。数据库访问密钥由本机绑定方式加密保存；换电脑不能依赖复制密文，应重新初始化。
+
+以下内容禁止提交：数据库、导出聊天、日报正文、`.env`、MCP 配置中的密钥、账号标识、完整日志和真实截图。MCP 客户端配置前确认其工作目录和权限；云端 AI 只处理明确选择的内容，敏感聊天优先用本地模型。
+
+## 最小验收
+
+```powershell
+weflow-cli check
+weflow-cli sessions -n 3
+weflow-cli contacts -k "关键词"
+weflow-cli messages "联系人A" -n 3
+weflow-cli daily --date YYYY-MM-DD --no-ai
+weflow-cli daily-server --date YYYY-MM-DD --open
+```
+
+问题反馈只提供操作系统、Node/Python 版本、微信版本、命令和脱敏错误。不要提供密钥、数据库、wxid、聊天正文或完整本地路径。

package/docs/images/weflow-architecture.svg

@@ -0,0 +1,65 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1600" height="1080" viewBox="0 0 1600 1080" role="img" aria-labelledby="title desc">
+  <title id="title">WeFlow CLI architecture</title>
+  <desc id="desc">Local-first layers from user inputs through CLI, MCP, services and data adapters to local outputs, with optional external services.</desc>
+  <defs>
+    <style>
+      .bg { fill: #f7f8fa; }
+      .panel { stroke: #d7dce3; stroke-width: 2; rx: 14; }
+      .title { font: 700 27px "Segoe UI", "Microsoft YaHei", sans-serif; fill: #14213d; }
+      .label { font: 600 22px "Segoe UI", "Microsoft YaHei", sans-serif; fill: #14213d; }
+      .body { font: 18px "Segoe UI", "Microsoft YaHei", sans-serif; fill: #334155; }
+      .small { font: 16px "Segoe UI", "Microsoft YaHei", sans-serif; fill: #475569; }
+      .tag { font: 700 16px "Segoe UI", "Microsoft YaHei", sans-serif; fill: #ffffff; }
+      .arrow { stroke: #64748b; stroke-width: 3; marker-end: url(#arrowhead); }
+    </style>
+    <marker id="arrowhead" markerWidth="10" markerHeight="8" refX="9" refY="4" orient="auto">
+      <path d="M0,0 L10,4 L0,8 Z" fill="#64748b"/>
+    </marker>
+  </defs>
+  <rect class="bg" width="1600" height="1080"/>
+  <text class="title" x="80" y="66">WeFlow CLI · 当前技术架构</text>
+  <text class="small" x="80" y="96">本地优先：只有用户明确选择的文章抓取、微信读书、Bot 通道或云端 AI 才会联网</text>
+
+  <rect class="panel" x="80" y="130" width="1440" height="145" fill="#e9eef8"/>
+  <rect x="105" y="151" width="112" height="34" rx="17" fill="#3767a8"/><text class="tag" x="130" y="175">入口</text>
+  <text class="label" x="105" y="225">终端用户</text><text class="body" x="105" y="255">weflow-cli &lt;command&gt;</text>
+  <text class="label" x="460" y="225">MCP 客户端</text><text class="body" x="460" y="255">stdio JSON-RPC</text>
+  <text class="label" x="810" y="225">可选 Bot 通道</text><text class="body" x="810" y="255">官方会话与白名单</text>
+  <text class="label" x="1190" y="225">维护 Agent</text><text class="body" x="1190" y="255">代码、测试与文档</text>
+
+  <line class="arrow" x1="800" y1="280" x2="800" y2="320"/>
+  <rect class="panel" x="80" y="330" width="1440" height="180" fill="#e7f4f0"/>
+  <rect x="105" y="351" width="150" height="34" rx="17" fill="#16866f"/><text class="tag" x="130" y="375">CLI 与服务</text>
+  <text class="body" x="105" y="420">初始化与配置 · sessions / contacts / messages</text>
+  <text class="body" x="105" y="457">export · evidence · favorites · sns · report · todos</text>
+  <text class="body" x="105" y="494">daily / daily-server · vault / wiki / weread · assistant</text>
+  <text class="body" x="850" y="420">路径与权限校验</text>
+  <text class="body" x="850" y="457">隐私过滤 · 白名单 · 发送确认</text>
+  <text class="body" x="850" y="494">日期、来源和 no-ai 开关</text>
+
+  <line class="arrow" x1="800" y1="515" x2="800" y2="555"/>
+  <rect class="panel" x="80" y="565" width="1440" height="180" fill="#fff5df"/>
+  <rect x="105" y="586" width="160" height="34" rx="17" fill="#c47b16"/><text class="tag" x="130" y="610">适配与工作流</text>
+  <text class="body" x="105" y="655">Node：数据库适配 · 配置加密 · 消息通道 · MCP 工具</text>
+  <text class="body" x="105" y="692">Python：NT 数据 · 公众号日报 · HTML 阅读器 · 搜索与报告</text>
+  <text class="body" x="105" y="729">媒体导出：按稳定消息身份匹配，无法确认时保留占位符</text>
+  <text class="body" x="850" y="655">来源类别优先于文章主题分类</text>
+  <text class="body" x="850" y="692">日报无日期时先补齐昨天，再生成今天</text>
+  <text class="body" x="850" y="729">Vault promotion 默认不调用 AI</text>
+
+  <line class="arrow" x1="800" y1="750" x2="800" y2="790"/>
+  <rect class="panel" x="80" y="800" width="680" height="190" fill="#edf1f5"/>
+  <rect x="105" y="821" width="120" height="34" rx="17" fill="#536579"/><text class="tag" x="130" y="845">本地数据</text>
+  <text class="body" x="105" y="885">微信 3.x / 4.x 数据库与媒体缓存</text>
+  <text class="body" x="105" y="920">日报、阅读状态、收藏、Vault 与证据包</text>
+  <text class="body" x="105" y="955">本机配置、加密密钥与助手记忆</text>
+
+  <rect class="panel" x="840" y="800" width="680" height="190" fill="#f1eefa"/>
+  <rect x="865" y="821" width="150" height="34" rx="17" fill="#7654a8"/><text class="tag" x="890" y="845">按需联网</text>
+  <text class="body" x="865" y="885">公众号网页 · 微信读书 API · 官方 Bot</text>
+  <text class="body" x="865" y="920">用户配置的云端 AI 端点</text>
+  <text class="body" x="865" y="955">默认不自动上传聊天数据库或证据包</text>
+
+  <rect x="80" y="1015" width="1440" height="40" rx="20" fill="#14213d"/>
+  <text class="tag" x="510" y="1042">隐私边界：仅处理本人或明确获授权的数据 · 阅读器默认仅监听 127.0.0.1</text>
+</svg>