v0.7.9-dev.17

[0.7.9-dev.17] - 2026-11-11

Docker 发布与部署

• Docker CI 核对已有固定标签的摘要、版本、提交和 linux/amd64、linux/arm64 两种架构，只构建并推送缺失的 API 或 Web 镜像。查询失败或镜像身份不符时停止发布。
• 隔离 Compose 项目验证网页更新、库存数据、挂载和端口后，才推进 dev / web-dev。从 master 手动补发同版本时默认只补固定标签，已有镜像直接复用。镜像发布指南
• 统一 Compose 模板的环境变量和挂载声明，补充对默认服务、Watchtower 和群晖部署配置的校验。
• 网页更新统一使用 docker-compose.hub-web-update.yml。旧项目若引用已移除的覆盖文件，请保留原部署目录中的文件，迁移并重新部署后再移除。旧项目迁移步骤

v0.7.9-dev.16

[0.7.9-dev.16] - 2026-11-10

Web 管理台

• 手机端改用底部导航，可直接切换概览、库存、BOM 预设、同步与设置。登录页优先显示表单。
• 库存首屏压缩搜索和筛选区域，列表优先显示名称、料号、库位和数量。点整行查看详情，返回后保留列表位置。多选操作位于底部导航上方。
• 库存工具在手机上独立打开，资料检查、从订单更新及旧参数补全可以在工具页完成。资料更新和批量删除仍在确认后提交。
• 设置按用途分组。概览、同步和 BOM 预设在窄屏使用列表，桌面继续使用表格。较长的名称、路径和状态可换行显示。

验证与部署

• Web 生产构建通过。使用隔离数据在 320 px 和 390 px 竖屏、844 × 390 px 横屏及 1280 px 桌面浏览器验证了搜索、详情返回、多选、资料应用和页面导航，覆盖中英文。
• Docker 开发渠道使用 rafaelikaros/component_manager:dev 和 rafaelikaros/component_manager:web-dev。在原 Compose 项目中成对更新镜像，沿用原数据挂载。部署与更新

v0.7.9-dev.15

[0.7.9-dev.15] - 2026-11-10

Web 库存

• 「库存资料检查」新增「全选可更新资料」，覆盖本次扫描的所有页面。确认前可取消单个字段，厂商型号匹配仍需单独确认。
• 跨页应用自动分批提交。遇到网络中断时，可以重试未完成的条目，保留原请求标识与已确认的处理结果。

服务端与 Docker

• 首次配置页区分 API 地址、管理台地址和管理员密钥，直接说明在网页保存配置的方式。
• 嘉立创资料查询使用公开目录。服务端移除已停用的立创 OpenAPI 集成及其环境变量，既有公开目录查询仍可使用。
• 简化 Compose 模板，标准数据库路径等使用镜像默认值，MQTT 可在 Web 设置配置。网页更新使用 Compose 的实际项目名，内置令牌由 API 在持久化目录生成。升级时继续使用原项目和原数据挂载。
• Docker／群晖快速部署和网页更新已更新。开发渠道成对使用 dev 与 web-dev。

文档

• 更新客户端、库存、项目用料、标签、同步、接口和部署指南。旧界面验收与打印取证资料归入历史索引及协议文档。

v0.7.9-dev.14

[0.7.9-dev.14] - 2026-11-10

Web 库存管理

• 手机端使用紧凑导航，优先显示搜索、筛选和库存卡片。点开卡片即可查看元件详情，桌面端继续使用表格。
• 「库存 → 多选」支持逐项勾选和全选当前页。底部操作条显示已选数量，删除前再次确认。删除结果可同步到客户端。

嘉立创库存资料检查

• 「库存 → 库存工具 → 库存资料检查」可扫描当前账户的全部有效元件，包括零库存记录。支持只补缺失或复查已有资料，按结果筛选后查看修改前后的差异。中文使用国内嘉立创 EDA，英文使用国际 EasyEDA。
• 优先按完整 C 料号匹配。无 C 料号时，只推荐完整厂商型号、品牌及已有可比资料一致的唯一候选，应用前需人工确认。已有参数出现相互冲突的值时保留原记录。
• 可逐项选择分类、封装和参数，商城参考价单独勾选。应用只写入选定资料，保留名称、SKU、图片、自由备注、数量、库位及库存成本。应用和批量删除均需启用 Web 库存写入。预览在服务重启后需重新扫描。

验证与部署

• 30 项后端测试、13 项 Web 测试及 Web 构建通过。隔离浏览器验证了窄屏、横屏、桌面布局，以及批删取消和逐字段应用。小米 9 从隔离服务端实测同步到选中的 33Ω 阻值，并核对名称、数量、库位与备注。
• Docker 开发渠道使用 rafaelikaros/component_manager:dev 和 rafaelikaros/component_manager:web-dev，也可成对固定为 0.7.9-dev.14 和 web-0.7.9-dev.14。Docker 更新说明 · 库存资料检查说明

v0.7.9-dev.13

[0.7.9-dev.13] - 2026-11-09

Android 料盘标签识别

• 「添加元件」支持拍照或从相册选择原厂料盘标签。本机 OCR 提取厂商型号、包装标称数量和标签上可读的参数，可展开查看原始识别文字。
• 复用现有嘉立创元件库查询，保留完整型号后缀，选择精确匹配的料号后回填品牌、封装和可用的电气参数。目录查不到时可用标签资料继续录入。
• 将标签和目录的品牌、封装、阻值、容值、电感量、耐压和精度逐项比较，统一等价单位。缺少可比资料时提示人工核对，有差异时逐项显示两边的值，明确确认后才回填。包装标称数量只作参考，实际入库数量另填。
• 小米 9 使用国巨、三星和 ROHM 三张原图验证识别、查询与资料回填，并用合成标签验证冲突确认、取消和资料不足提示。17 项直接相关的 Android 测试及功能提交 CI通过。更多品牌与标签版式仍需实拍验收。

HM-A300E Android 实验适配

• 现有标签编辑与打印页增加 HM-A300E CPCL 机型及间隙／连续纸选择，复用元件、自由标签、预览和队列。旧 M1 队列保留原协议，M1 的实际打印尺寸限制保持不变。
• 改用型号专用汉印 CPCL SDK 进行握手、空闲状态查询和单张打印。保留连接供下一张复用，打印提交后逐张核对实物。
• 提供可选 SDK 构建参数与应用内打印诊断。SDK 构建和验收步骤见适配指南。
• 含 SDK 的独立包已在小米 9 上实测同一队列的两张 40×60 mm 间隙标签，重启打印机后两张均完整出纸。公开 APK 使用默认构建，HM-A300E 打印需要按适配指南自行加入 SDK 构建。

购买价格与 PCBA 材料成本（Issue #27）

• Android、Windows 和可选 Web 库存入库支持记录实际商品金额，与商城参考价独立保存。以当前库存加权平均价计价；正常出库保持均价，调拨不改价，归零后清空。明确零金额为赠品，未填写金额及历史无价库存保持未知。
• 立创订单导入读取人民币含税商品小计，缺小计时按单价与订购数量换算；同订单同料号逐行合并金额，沿用来源去重。BOM 项目用料预览增加单套、整批材料成本及缺成本提示，预览不扣库存。
• 支持补录当前剩余库存成本并保留估值记录，不回写历史采购。首版统计 CNY 商品成本，不计运费、PCB、加工及人工费用；非采购变动和未知成本规则见成本指南。
• 增加成本同步能力检查，旧客户端不再能通过无成本字段的数量变更静默破坏已有成本。完整 Excel 备份升级为 schemaVersion=2，金额保存为文本，兼容旧备份的未知成本迁移。
• 补齐 Android 成本协议、旧库迁移和界面断言，并修复快捷入库错误提示。Windows 同步测试覆盖成本协议拒绝条件，修订后的 CI通过。

v0.7.9-dev.9

[0.7.9-dev.9] - 2026-11-03

出入库默认原因

• Android 与 Windows 的手动库存变动表单自动填写当前类型对应的原因：入库默认“入库”，出库默认“出库”，调整与调拨也有对应默认值，无需每次重复输入。
• 切换变动类型时，仅替换空白或原默认原因；手动填写的自定义原因保持不变。关闭表单后重新打开，按当前变动类型重新填入默认值。
• 继续使用原有数量、库位及保存校验，不迁移数据库、不改同步协议；历史流水原因保持原记录。已有扫码和快捷出入库的默认原因逻辑不变。

验证与发布范围

• 小米 9 独立测试包竖屏验证入库、出库、调整、调拨默认值、类型切换、自定义原因保留及重新打开表单通过；未保存测试流水，原应用及现有库存未覆盖，测试后恢复旋转设置。
• Windows Release 编译及实现提交的主 CI通过；未进行 Windows 桌面界面验收。
• 本版为 dev 预发布，生成 Android APK、Windows 自包含 ZIP 和 Web 静态包，并发布配套 Docker 开发镜像 dev / web-dev。Web 与 Updater 继续共用管理镜像、独立运行；正式 latest / web-latest 和历史独立 updater 标签不移动。

v0.7.9-dev.8

[0.7.9-dev.8] - 2026-11-03

Docker 管理镜像

• Web 和 Updater 共用 web-* 管理镜像，保持独立容器；API 镜像及前后端分离不变。默认启动 Web，command: [updater] 启动单 worker 更新服务，健康检查按角色执行。
• Compose 中两个管理容器共用 COMPONENT_VAULT_WEB_IMAGE，只给 Updater 挂载 Docker 管理接口和任务目录。更新 API/Web 时继续保留 Updater，避免中断更新任务；不再构建或发布新的独立 updater-* 镜像。
• 补充旧 updater 的一次迁移步骤：同时修改镜像和启动命令，保留原项目、账户、数据和任务卷。既有独立 updater 可继续更新兼容 API/Web；本次不修改 SQLite 或同步协议。
• Docker CI 检查共享镜像的两个启动模式、对应健康检查、端口隔离和无 Docker 挂载的 Web；发布后继续用独立临时 Compose 项目验证真实更新及数据保留。实际完成状态以本版本 Docker 发布任务为准，未在用户群晖上执行操作。

文档与部署说明

• 重写仓库首页，增加 Ikaros 首屏、版本与构建徽章、Android／Windows／Docker 入口和按任务组织的文档导航。
• 合并重复阶段记录，移除分散的旧 Issue 快照、上游对比、库存扩展计划与跨设备待办；验证摘要集中到 history/verification.md，原始证据通过固定提交追溯。更新各模块 README，删除个人工具链路径和早期验证状态。
• 明确 0.7.8 保留数据升级 dev 与零配置启用网页更新的区别：首次仍需配置 updater，之后管理员可确认更新兼容渠道，网页检查不会自动安装。
• 清理四份被现行指南与架构取代的账户、Android 重构及 UI 计划，修复入口引用；保留协议、实机与历史版本证据并标注日期范围。
• 统一 dev Docker 镜像发布、原图持久目录、查询语言来源、账户删除和标签工具说明，纠正旧文档中的相互矛盾表述。
• 补充已有正式版直接升级 dev 的步骤，以及网页应用配置与宿主 Compose 配置的边界；首次升级可同时启用 updater，保留原项目、账户、数据及环境配置。

v0.7.9-dev.7

[0.7.9-dev.7] - 2026-11-02

网页更新修正与群晖简化配置

• 修复 dev.6 发布验收暴露的 .env 权限问题：更新组件以 root 执行时，原子替换前保留原文件所有者、组和权限，备份同样保留属性，不再令宿主原用户失去配置访问权。属性复制失败时不拉取、不修改配置或重建。
• 新增 docker-compose.hub-web-update.yml 完整单文件模板，群晖项目无需手动合并 Hub 与 updater 多份配置，Web 默认启动。旧项目仍需一次在 GUI 中保留原数据来源、端口、网络并启用更新组件，之后日常操作在网页进行。
• 增加模板渲染一致性检查及 POSIX 权限回归，继续使用真实临时 Compose 项目的发布后更新门禁。dev.6 三镜像虽然已推送，最终更新验收因权限缺陷失败，不建议使用；以本版最终 CI 结果为准。
• 不更改库存 schema、同步协议或原生业务；仅发布 dev 镜像，不移动正式 latest / web-latest。验证结果和发布摘要见工作记录。

v0.7.9-dev.6

[0.7.9-dev.6] - 2026-11-02

服务端网页更新

• 新增可选服务端网页更新：管理员共享一个渠道选择，检查版本后确认更新，支持持久进度、API重启重连、刷新恢复及失败重试。
• 新增 Compose updater 服务与镜像，复用原项目配置、端口和挂载，不需要日常SSH；仅updater具有Docker socket，普通账户不可更新。
• 在线目标须保留网页更新能力，旧正式版0.7.8在替换前被拒绝。保留现有手动恢复流程，不自动降级数据库。
• 更新前先拉取目标并核对 API/Web 的版本、构建提交和入口能力，再备份 .env 与重建；任务由独立服务继续执行，主 API 重启不丢失状态。updater 自身中断后重新排队未完成作业，保留最近100条结束记录。
• 群晖在原项目通过 GUI 加入更新服务、同一数据来源、原部署目录及网络一次后，可在网页完成受支持版本间的更新。新增一次配置教程，内部认证文件自动生成，不需用户填写额外密钥。
• 使用 Docker CLI 28.x / 配套 Compose 和 API 自动协商，照顾旧 NAS Engine；不强制 DOCKER_API_VERSION。自定义 CONFIG_PATH 不再影响共享内部令牌，支持显式路径。

验证与边界

• 管理员代理11项、updater/helper11项及版本前缀兼容检查通过，Web构建和浏览器隔离模拟流程通过：确认、旧正式拒绝、短暂断线、重连和刷新恢复。未操作真实NAS或已有库存。
• 初版主CI及最终Docker CI通过真实三镜像构建、容器启动、鉴权与任务持久化检查。发布还需通过独立临时Compose项目的真正更新验收，核对数据、端口、挂载与容器替换；最终结果记录在工作记录。
• 本轮只发布dev；当前正式镜像仍不包含网页更新，不能承诺现在即可在线切回旧正式版。API/Web和updater均提供独立开发镜像，不推动正式标签。

v0.7.9-dev.5

[0.7.9-dev.5] - 2026-11-02

服务端批量删除

• 服务端库存支持当前页多选批量删除，确认后整批事务执行，保留流水并同步删除墓碑，冲突全部回滚，可重试未知网络结果。
• 管理台显示本页选择数量、SKU 确认框及完成状态。翻页或更改筛选清空选择；只操作当前账户，并沿用 Web 库存写入开关。

Docker 独立构建与渠道切换

• Docker CI 与原生客户端 CI/发布附件分离；开发镜像更新 dev/web-dev，正式镜像继续 latest/web-latest。独立发布可手动重跑，不依赖重新构建客户端。
• 新增官方 Compose 部署渠道切换助手，自动处理配置、配套镜像拉取和原项目重建，保留数据挂载与端口，不需要手动改镜像标签。
• 助手兼容旧 Hub Compose，保留 Watchtower 的配置组合，先拉取并确认 API/Web 的版本与构建提交一致，再备份和更新 .env。拉取失败或镜像尚未配套时不重建，支持预览及重试；不删除数据卷。
• 服务端关于页支持正式/开发版更新检测，按 API 地址记住浏览器偏好；实际容器切换仍由部署助手或宿主机管理，不加入服务端自更新代理。
• 新增渠道切换教程，说明现有部署升级、群晖项目、旧镜像覆盖优先级、Watchtower 与数据备份。

验证

• 本次实现 195dbe0 的独立 Docker CI 构建及容器启动检查通过；主 CI 各项检查通过。
• 隔离浏览器实测两项批删取消/确认，接口核对删除墓碑和保护字段；实际检测正式版与开发版，刷新保留渠道，中英文显示通过。助手使用假 Docker 验证失败/配套检查/原配置保留，本机未做真实 NAS 切换。镜像发布与摘要核对见工作记录。