# 更新记录

历史版本中的功能说明仅适用于对应版本。当前功能与安装方式请以 [README](README.md) 为准。

## 0.3.24

- 包名改为 `dsh-procuremate`，同步 bundle 引用及浏览器模块标识。
- 保留内部入口、API 与资料路径；旧包需先卸载再安装新包。

## 0.3.23

- 对外名称统一为采购助手 · ProcureMate。
- 重写社区说明，拆分更新记录、贡献指南及兼容范围。
- 安装包标识与数据路径保持兼容。

## 历史更新摘要

> 0.3.22：展示名称更新为“采购助手”，英文名为 Procurement Assistant。包名、内部标识及资料路径保留，支持沿用现有安装和数据。

> 0.3.21：移除采购表“询价状态”列，保留已询价行底色与左侧标识。勾选行后通过顶部按钮更改状态，状态筛选与计数保留。

> 0.3.20：通用注意事项移至操作栏下、采购表上方，宽屏横向排列，默认显示前三条，可展开全部或收起；新一轮导入时恢复收起状态。

> 0.3.19：移除采购明细中“未指定具体品牌”的附加提示，保留原始品牌名称、品名和备注。

> 0.3.18：删除物料编码的专用字段定义、表头映射及界面排除分支。原表中的编码列按普通未映射列处理，不再生成额外的编码字段或空导出列。

> 0.3.17：移除导入列对应关系中的“物料编码”选项及采购明细中的编码展示；自动识别、切换工作表和调整表头均不再映射该字段。原始编码列仍作为未映射列保留，原 Excel 不变。

> 0.3.16：每次确认导入都视为新一轮询价，导入明细全部重置为未询价，并清除对应的历史标记；取消导入不改变现有状态。此规则替代 0.3.13 的重新导入恢复行为。

> 0.3.15：已询价底色不再影响“注意事项”列，该列保留原有背景和提醒样式。

> 0.3.14：加深已询价行的蓝色底色，新增左侧深蓝标识条，并将状态按钮改为深蓝底白字。

> 0.3.13：采购明细新增“询价状态”，可逐行点击切换，或勾选后批量标为已询价／未询价；支持全部、未询价、已询价筛选。已询价行有独立底色和文字标记。标记自动保存到资料文件，不修改原 Excel；重新导入同一路径、同一工作表、行号及内容不变的明细时恢复。文件移动、行移动或内容变更后按未询价处理。复制文本不会自动标记。

> 0.3.12：移除复制询价文本时的省份拦截。缺少需求公司、无法识别省份或跨省时仍显示提示，但允许复制当前文本，包括手动编辑后的内容。

> 0.3.11：新增“公司省份”配置入口，支持新增、编辑、删除、搜索及 Excel / JSON 导入导出。询价区可快捷配置无法识别的公司。配置按完整公司名称匹配（忽略空白和全半角差异），优先于内置记录及地名推断，并自动保存到参考资料文件。旧版资料无需迁移。请按实际收货省份填写，同一公司跨省收货时仍需人工核实。

> 0.3.10：确认表头与列对应关系移除单价字段；自动识别、切换工作表和调整表头均不再映射单价。原列仍作为未映射原始列保留以便整理版导出。

> 0.3.9：采购明细新增“取消全选”，清除全部已选行（含搜索隐藏的行）；移除采购明细单价展示列。原文件及整理版导出中的原始单价不变。

> 0.3.8：注意事项的关键词字段改为“品名”，仅按采购品名包含所填文字匹配，不匹配型号和备注。指定品牌及品名时两者须同时符合；仅指定品名也显示在对应行。原字段数据保留并按新品名规则使用，旧 Excel 列名仍可导入。

> 0.3.7：移除提示场景选择与规则编辑中的场景字段，旧场景不再限制提醒。品牌注意事项导入后直接显示在对应行；通用提醒基于已导入明细匹配，无需勾选。关键词与品牌别名匹配继续保留。

> 0.3.6：修复资料切换卡顿。品牌别名索引按供货商数组缓存，资料修改后重新建立；空搜索跳过匹配计算，列表计数和展示共用筛选结果。

> 0.3.5：工作台只保留采购明细、供货商与注意事项。采购搜索支持供货商资料中的品牌别名；两类资料均可搜索及弹窗编辑。指定品牌提醒在对应行显示并标注适用场景；右侧仅显示通用场景提醒。价格表和渠道页面、参考报价及渠道查询区已移除，旧数据字段暂保留兼容，不会自动删除已有资料。

> 当前版本 0.3.4：采购表仅供读取，单价显示为文本。已移除单价编辑、回填、原 Excel 保存和相关重试。下方旧版本写回说明仅为历史记录。供货商等参考资料仍保存到 procurement-workbench.json。


## 早期版本说明

以下为已被后续版本替代的开发记录，不是当前操作指南。

### 询价文字格式

复制询价文字时，每件产品单独成块，序号、品牌、品名、型号 / 规格、数量等使用【标签】分行显示；复杂规格放在标题下一行，产品之间用分隔线区分。文字可直接粘贴到微信及电商聊天窗口。

### 0.2.3 询价调整

序号与品牌合并为一行。填写收货省份后，询价末尾注明目的地、含税含运费及 13% 增值税专用发票要求。移除询价记录和发送对象，复制不存档。旧数据文件仍可读取，后续保存不再包含历史记录字段。

### 0.2.4 询价格式与目的地

每个产品占一个文本行，手机聊天窗口会按宽度自然折行。发往省份根据需求公司自动识别，不再手填。兼容旧明细保留的需求公司列及 Excel 合并的公司单元格。支持已核实公司和内置省市地名；公司名称不含可识别地名或存在歧义时提示核实，不擅自推断。多省明细须分批询价。旧版手填省份不再用于询价。

### 0.2.5 询价模板

按指定格式输出品牌、品名、型号 / 规格、数量，每件一行，产品之间使用分隔线。不输出序号、物料编码和备注。结尾为“发往某省。报价请含税含运费，并支持开具 13% 增值税专用发票。”省份仍根据需求公司自动确定。

### 0.2.6 保存与重试

手动修改明细单价后点击「保存单价」。未保存单价不会随其他资料的自动保存写入。失败保留页面修改和原始原因，可直接重试保存，无需重新导入。多窗口冲突可确认后用当前全部内容覆盖保存；目录切换冲突不允许覆盖。关闭或刷新页面前应先保存。

### 0.3.0 原 Excel 写回

点击「打开原 Excel」通过本机文件选择器打开采购表，确认工作表、表头和单价列。单价输入框失焦后自动写回原路径、原工作表、原行及对应单价列；价格表回填也写回该文件。状态栏显示完整保存路径，失败保留页面输入并提供「重试写入 Excel」。原文件被其他软件修改时停止写入，公式单元格不覆盖。

采购明细和单价不再存入 procurement-workbench.json，该文件仅保存供货商、价格表、渠道、注意事项。旧文件仍可读取，下一次参考资料保存将去除旧明细字段。重新打开工作台需要再次打开采购 Excel；此前写入的单价直接从 Excel 读取。

.xlsx 直接修改对应单元格 XML，其他压缩包部件保持原内容。.xls 通过 macOS 已安装的 Microsoft Excel 处理临时副本，完成后校验并替换原文件；首次使用可能需要允许控制 Excel，且需完成 Excel 首次启动。临时文件在操作后清理，不生成自动备份。请避免同时在 Excel 中编辑同一原文件；磁盘外部修改会触发冲突提示。文件选择及 .xls 写入目前面向 macOS。

### 0.3.1 Windows / WPS 兼容

Windows 使用系统文件选择框，支持中文文件名、空格路径及本机目录配置。默认参考资料目录为当前用户目录下的 buyer/data，例如 C:\Users\用户名\buyer\data；macOS 默认路径不变。

.xlsx 直接修改原文件，不需要 Microsoft Excel 或 WPS 自动化接口。Windows 旧格式 .xls 优先尝试 KET.Application（WPS），不可用时尝试 Excel.Application；两者均不可用时提示用 WPS 另存为 .xlsx，不自动转换原文件。macOS 的 .xls 写回仍需要 Microsoft Excel；只有 WPS 时请先另存为 .xlsx。

失焦写回前，应避免在 WPS / Excel 中同时编辑同一文件。文件被占用或无写入权限时，插件保留输入并提供重试。Windows 分支已经过代码测试，尚未在 Windows / WPS 实机上验证，详见 COMPATIBILITY.md。

### 0.3.2 服务兼容检查

打开原 Excel 前检查保存服务是否支持文件操作。页面与旧服务混用时提示安装新版并重启，不再发送会被旧服务误解成切换目录的请求。未知操作不再默认进入目录切换。

### 0.3.3 供货商表导入

允许只有品牌的待补充记录，不将其判定为已有合作供货商。保留供货商单元格中的店铺超链接，并提供打开店铺入口；原有联系人、微信、电话及描述按原文保存。根据表中明确填写的品牌别名归并重复品牌，完全重复记录去重。店铺名称来自导入表，不表示插件核实了旗舰店身份。缺少品牌或同一行有不同链接时提示具体行号，不静默丢弃。