1.7.0

1.7.0 更新说明

新功能

• Web 交易图片附件：新建或编辑交易时上传、移除和替换图片，支持原图查看与下载，并与 App 双向同步。
• MCP 小票上传与交易关联：新增 upload_attachment，上传后将返回的文件 ID 传给 create_transaction 或 update_transaction。附件按指定顺序展示，同账本相同内容会复用文件，不会重复存储。
• 本地文件上传：客户端运行仓库的 scripts/mcp_local_files.py stdio 适配器后，同名上传工具接受 file_path，直接上传文件原始字节，模型无需输出 Base64。HTTP 直连继续使用 content_base64；批量创建工具暂不支持附件。

修复

• 修复父分类改名后子分类消失，恢复可确认的分类父子关联。
• 全量同步正确保留「不计入收支」与「不计入预算」标记。
• 首页资产构成按汇率折算到主币种，不再直接相加不同币种金额。

升级说明

1. 升级前备份数据库及附件目录，再更新到 sunxiao0721/beecount-cloud:1.7.0。本次同时更新 latest。
2. 官方 Docker 启动会执行 alembic upgrade head。新增 0020_category_parent_links 数据迁移，仅修复同一用户、同一分类类型下能够唯一确定的父子关系；不会猜测存在歧义或已删除的父分类。该修复的 downgrade 不会撤回已恢复的数据。
3. 先升级 Cloud，再升级 App 3.8.6，以同步已有附件的顺序与信息变更及分类关联。
4. MCP 上传需要 PAT 的 mcp:write 权限。附件和交易必须属于同一账本；编辑时不传附件列表保留原附件，传 [] 移除全部关联，传列表替换完整关联集合。
5. 使用本地文件适配器需在客户端安装 mcp>=1.27,<2，配置 Cloud 地址、私有 PAT 和 --allow-dir。服务端无需挂载客户端文件目录。适配器拒绝授权目录外文件及符号链接越界。

使用文档：Web/App 交易附件 · MCP · MCP 本地文件配置

---

Docker

• sunxiao0721/beecount-cloud:1.7.0
• sunxiao0721/beecount-cloud:latest

Commits

Compare: 1.6.9...1.7.0

• fix(web): 首页资产构成按汇率折算到主币种,不再跨币种 1:1 裸加 (#104) (#112) (05a6e65) — @TNT-Likely
• docs: 捐赠模块新增 Ko-fi 与链上 USDT 入口 (#113) (fb0a4b8) — @TNT-Likely
• fix(sync): 保留全量快照中的交易统计与预算标记 (07c4093) — @TNT-Likely
• fix(category): 修复父分类改名后子分类消失 (0758b41) — @TNT-Likely
• feat(web): 支持交易图片上传移除与替换 (#119) (80fc2a4) — @TNT-Likely
• feat(mcp): 支持小票上传与交易附件关联 (#120) (c24d17e) — @TNT-Likely
• docs(cloud): 增加官网日志与项目技能入口 (#121) (39cee9e) — @TNT-Likely