# v2.7.0 · 安装与数据可靠性升级

本次保留 20 个业务模块、25 个完整工作流，以及 WorkBuddy、DeepSeek Harness 和通用 Agent Skill 三种入口，重点修复升级、数据保存和文件读写中的实际问题。

| 检查发现 | 升级后的行为 |
|---|---|
| 依赖更新后源码复刻清单过期，导致 CI 失败 | 每次检查先构建并重建复刻包，再验证所有源文件的 SHA-256 |
| 依赖审计发现 5 个漏洞项 | 更新 MCP SDK、Zod 及相关传递依赖；官方 npm 审计为 0 |
| 上传与工作流目录可能被符号链接引到工作区外 | 检查目录和临时文件，拒绝符号链接与越界写入 |
| 安装器尚未验证配置便替换旧目录 | 先预检与暂存，备份后切换，遇到失败恢复旧目录 |
| 备份遗漏置顶、最近工作流，内层损坏数据可能进入界面 | 补齐备份字段，逐项校验并保留恢复前副本 |
| 本机保存失败被忽略，主题切换后立即刷新可能丢失 | 提交后立即保存，失败显示明确的导出提示 |
| 金额显示省略分位，浮点合计出现尾差 | 显示两位小数，按分计算利润与异常合计 |
| CSV 文本可能被 Excel 当作公式 | 对公式样式的文本加保护前缀，保留普通中文和金额 |
| Widget 复制失败仍可能报告成功 | 检查实际复制结果，失败时提示手动复制 |
| npm 包内缺少配套卸载与安装辅助文件 | 补齐 Shell / PowerShell 共用逻辑、卸载脚本和文档 |

## 立即使用

从源码预览：

```bash
npm ci
npm run preview
```

打开 http://127.0.0.1:4173。预览中的台账和主题保存在该浏览器来源的本机存储，工作流指令需粘贴到 AI 对话执行。安装完整 WorkBuddy 应用见 [安装指南](../INSTALL_WORKBUDDY.md)。GitHub 下载包的版本以 Releases 页面为准。

## 数据恢复

导出格式仍为 v2，旧备份可以继续导入。新增备份包含资料置顶和最近工作流。历史备份缺少这两项时，保留当前记录。

导入先检查所有数据，再保存恢复前副本，最后切换。校验失败不替换现有数据。“下载恢复前副本”可以导出回滚材料。存储拒绝写入或容量不足时，先导出备份再处理存储问题。

JSON 备份不包含原始财务文件。Widget 的资料选择只建立当前会话索引，仍需在宿主对话中添加原始附件。

## 验证与运行边界

```bash
npm ci
npm run verify:release
npm run audit:deps
```

CI 覆盖 Linux Node.js 20、22、24 和 Windows Node.js 24 / PowerShell。浏览器回归使用虚构数据；真实 WorkBuddy / DSH 的插件加载与 AI 文件处理仍需在对应宿主内验收。此次源码升级不重启宿主，不更改现有模型、登录配置或业务文件。