XLCS 模板自动升级工具指南书

📌 快速导航

导航	链接
⚡️ 模版下载	/categories/模版下载/
📑 版本矩阵	/categories/版本矩阵/
🚀 上手指南	/categories/上手指南/
❓ 更新日志	/categories/更新日志/
🛠 讨论求助	https://xlcs.de/

📖 产品说明

XLCS 模板自动升级工具 是专门为 XLCS 房产项目全成本测算模板设计的独立升级工作台，用于把旧版 XLCS 测算文件中的关键输入数据安全迁移到新版模板中。

工具采用独立 .xlsm 文件承载迁移代码、规则表、临时数据、运行日志和迁移报告。旧模板只作为只读数据源，新模板只作为写入目标，不在旧模板或新模板中生成迁移辅助表，尽量保持新旧模板本身纯净。

核心设计原则为：

1
2
3

升级工具 = 规则表 + 迁移代码 + 临时数据 + 迁移报告
旧模板 = 只读数据源
新模板 = 纯净写入目标

该方案的主要优势是：避免新旧两个 XLCS 模板长时间同时打开造成卡死或 VBA 工程互相干扰；避免在新模板中生成 LegacyData_临时读取、MigrationReport、AnchorMap 等辅助表；并且可以把不同历史版本的升级规则长期沉淀在工具文件中，便于后续维护多版本升级规则。

🎯 工具定位

XLCS模板升级工具.xlsm 不是一个测算模板，而是一个模板升级工作台。

它主要负责：

识别旧模板版本；
激活对应版本的历史规则；
只读打开旧模板并提取数据；
生成标准化旧数据表；
打开新版模板并写入数据；
写新前弹窗确认升级规则；
写入后按配置执行城市刷新、融资计算等宏；
另存为升级后副本；
输出迁移报告、迁移汇总和工具体检报告；
维护不同历史版本的升级规则。

正常升级过程中，用户不需要手工修改旧模板，也不需要在新模板中放置迁移代码或辅助表。

🧩 架构说明

一、独立工具文件架构

工具采用独立工作簿架构：

1	XLCS模板升级工具.xlsm

工具文件内保存：

内容	说明
迁移代码	VBA 迁移逻辑、读取旧模板、写入新模板、报告生成
规则表	`AnchorMap_升级定位`、`SimpleFieldMap_升级字段`、`VersionRule_版本规则`
临时数据	`LegacyData_临时读取`
报告数据	`MigrationReport`、`MigrationSummary_迁移汇总`、`CheckReport_工具体检`
诊断数据	`MapAudit_字段映射诊断`
运行记录	`Log_运行日志`
管理员维护	洋红扫描、版本规则固化、规则备份、字段映射诊断

二、新旧模板角色

文件	角色	是否写入辅助表
旧模板	只读数据源	否
新模板	纯净写入目标	否
升级工具	迁移工作台	是

升级流程中，工具会控制旧模板读取后关闭，再打开新模板写入，尽量避免两个 XLCS 测算模板同时长时间打开。该设计是为了降低 VBA 工程名同名、外链刷新、打开宏、事件触发等复杂因素带来的风险。

🚀 核心升级流程

分步升级流程

打开 XLCS模板升级工具.xlsm
    ↓
点击【读旧文件】
    ↓
选择旧模板文件
    ↓
工具只读打开旧模板
    ↓
识别旧模板版本
    ↓
版本规则决策（精确匹配或推荐替代规则）
    ↓
用户确认版本规则
    ↓
激活对应版本规则
    ↓
读取旧模板数据（含字段别名兼容补值）
    ↓
写入工具自身 LegacyData_临时读取
    ↓
关闭旧模板
    ↓
点击【写新模板】
    ↓
选择新版模板
    ↓
识别新模板版本并激活新版规则
    ↓
写新前升级规则确认弹窗（显示旧/新版本、规则版本、风险提示）
    ↓
按规则写入输入区
    ↓
写新后自动宏执行确认弹窗（按配置列出将执行/已跳过的宏）
    ↓
执行城市状态刷新（可选）
    ↓
执行前期工程指标刷新（可选）
    ↓
执行融资及支付计划计算（可选）
    ↓
最终计算
    ↓
生成 MigrationReport
    ↓
另存为升级后副本
    ↓
生成 MigrationSummary_迁移汇总
    ↓
关闭新模板

一键升级流程

选择旧模板
→ 读取旧模板数据
→ 关闭旧模板
→ 选择新模板
→ 写新前规则确认
→ 写入新模板
→ 自动宏执行确认
→ 执行自动宏
→ 另存升级副本
→ 生成迁移报告
→ 生成汇总报告
→ 运行写新后体检
→ 统一提示完成结果

建议初次使用或规则调试阶段，优先采用”读旧 → 写新”的分步流程；规则稳定后，再使用”一键升级”。

🧭 首页功能区

工具首页分为用户区、数据区和管理员区。

区域	按钮	说明
用户常用区	读旧文件	选择旧模板，只读读取旧模板数据
用户常用区	写新模板	选择新模板，将旧数据写入新版模板
用户常用区	一键升级	执行完整一键升级流程（读旧→写新→汇总→体检）
用户常用区	运行体检	检查工具规则和迁移结果完整性
用户常用区	生成汇总	生成迁移汇总报告
用户常用区	刷新导航	刷新所有工作表的返回首页按钮和冻结表头
用户常用区	自动宏配置	第8~9行配置写新后自动宏执行开关
数据与报告区	旧数据	查看 `LegacyData_临时读取`
数据与报告区	升级报告	查看 `MigrationReport`
数据与报告区	汇总报告	查看 `MigrationSummary_迁移汇总`
数据与报告区	固定区域	查看 `AnchorMap_升级定位`
数据与报告区	独立字段	查看 `SimpleFieldMap_升级字段`
数据与报告区	版本规则	查看 `VersionRule_版本规则`
数据与报告区	运行日志	查看 `Log_运行日志`
管理员维护区	开启管理	显示管理员维护按钮
管理员维护区	版本扫描	扫描洋红输入框，维护字段规则（执行前自动备份）
管理员维护区	版本固化	固化当前规则为历史版本规则（执行前自动备份）
管理员维护区	版本备份	手动备份当前规则表
管理员维护区	关闭管理	隐藏管理员维护按钮

自动宏配置

首页第8~9行提供写新后自动宏执行开关，共6项：

配置项	值单元格	默认值	说明
刷新城市名	C8	否	写新后执行 `XLCS_刷新城市状态`
刷新前期工程指标	E8	否	写新后执行 `UpdateDuplicateInfo`
生成融资利息	G8	否	写新后执行 `CalculateAllFinancing`
生成非标融资利息	C9	否	写新后执行 `CalculateNonStandardLoan`
生成前期工程支付	E9	否	写新后执行 `GeneratePaymentPlan`
全表重算	G9	否	写新后执行全工作簿 `Application.Calculate`

默认所有宏均不执行。修改后在下一次执行”写新模板”时生效。

写新完成后，工具会弹出自动宏执行确认框，列出当前配置中将执行和已跳过的宏项。用户点击”是”按配置执行，点击”否”全部跳过。

🗂 核心工作表说明

工作表	用途
`首页`	工具主入口、按钮、状态卡片、自动宏配置和使用提示
`AnchorMap_升级定位`	对象化区域定位规则，如销售去化、产品属性、户配、前期工程指标、配套用房/地下空间等
`SimpleFieldMap_升级字段`	独立基础字段迁移规则
`VersionRule_版本规则`	旧/新模板版本与历史规则表之间的匹配关系
`LegacyData_临时读取`	从旧模板读取出的标准化旧数据（23列结构）
`MigrationReport`	写入新模板时生成的逐条迁移明细（含生成时间列）
`MigrationSummary_迁移汇总`	对迁移结果进行统计汇总
`CheckReport_工具体检`	检查工具规则、数据、报告是否完整
`Log_运行日志`	记录打开文件、读取、写入、错误等运行过程
`ScanScope_洋红扫描范围`	管理员配置洋红扫描的工作表和区域
`MapAudit_字段映射诊断`	管理员批量检查字段映射旧地址重复、来源地址冲突等问题
`Bak_Simple_时间戳`	字段规则备份表
`Bak_Anchor_时间戳`	定位规则备份表
`Bak_Version_时间戳`	版本规则备份表

⚙️ 核心功能一览

功能模块	说明
旧模板读取	只读打开旧模板，读取系统信息、独立字段、销售去化、地块、产品属性、产品户配、前期工程指标、配置标准、配套用房及附属/地下空间等数据。
版本识别与决策	自动识别旧/新模板版本，并根据 `VersionRule_版本规则` 激活对应规则包。若未精确匹配，提供推荐替代规则供用户确认。
写新前规则确认	写新开始前弹出确认框，显示旧文件版本、识别版本、采用规则、新模板版本和新模板规则，含替代规则风险提示。
规则激活	将历史版本规则表复制到运行态规则表，保证本次读取/写入使用正确规则。
字段别名兼容	读取阶段自动执行字段别名补值（如”非人防车位售价”映射为”车位售价(万元)”），写入阶段自动执行单位转换。
新模板写入	打开新版模板，将 `LegacyData_临时读取` 中的数据写入新模板对应输入区，支持简单字段、销售去化、地块、产品、户配、前期工程、配置标准、配套用房等多种对象类型。
无效产品行处理	旧文件房源面积为空或为零的产品行，不迁移产品属性，仅将新版该行房源面积列写为零。
前期工程有效产品判断	按旧模板第152行工程成本合计是否非空非零，判断哪些产品需要迁移前期工程指标。
前期工程右侧同步	左侧 E3:U153 写入后，自动同步到右侧 W3:AN153 固定指标区，并从右侧原样复制小计/合计行公式。
自动宏执行确认	写入完成后弹出确认框，列出当前配置中将执行和已跳过的宏项，用户确认后才执行。
新版宏执行	按配置执行城市刷新（`XLCS_刷新城市状态`）、前期工程刷新（`UpdateDuplicateInfo`）、融资计算（`CalculateAllFinancing`、`CalculateNonStandardLoan`）、支付计划生成（`GeneratePaymentPlan`）。
另存升级副本	不覆盖原新版模板，自动另存为带旧文件名和时间戳的升级后副本。
迁移报告	生成逐条写入结果，包括成功、失败、跳过、目标地址、原因说明和生成时间。
迁移汇总	汇总成功、失败、跳过数量，包含版本风险判断、按对象类型统计和失败/跳过明细。
工具体检	检查核心工作表、版本规则、旧数据记录、迁移报告失败项等。一键升级完成后自动执行写新后体检。
字段映射诊断	管理员可批量检查字段规则表中旧地址重复和 LegacyData 中来源地址冲突等高危问题。
管理员规则维护	支持洋红扫描、规则固化、规则备份、车位售价别名规则固化、历史版本规则沉淀。
多版本兼容	支持维护 `V9_4`、`V9_3`、`V8_5` 等不同历史版本规则，未来可继续扩展。

🔍 可迁移数据类型

工具读取旧模板后，会将数据统一写入 LegacyData_临时读取。目前主要支持以下对象类型：

对象类型	说明
`system`	旧模板路径、文件名、版本、版本规则决策等系统信息
`simple_input`	独立基础字段，如普通输入框、参数项等
`product_monthly_plan`	销售去化模板名、月度去化比例（含标准产品行和车位/代建/有偿配建/无偿配建/持有等固定行）
`land_block`	地块信息（地块一至地块十）
`product`	产品属性，包括住宅（fya~~fyn）、商业（fyo~~fyx）等产品行数据
`product_unit_mix`	产品户配，包括户型面积、户数等
`engineering_indicator`	前期工程指标，按产品名称和指标行读取（04.1工程指标工作表 E3:U153）
`engineering_product_marker`	前期工程有效产品标记，基于旧模板第152行工程成本合计判断
`config_standard`	配置标准，按产品组读取04.3配置标准 D2:BX87 区域
`supporting_area`	配套用房及附属/地下空间数据（02基本指标录入 E280:P300 二维区域）

对象化区域通过 AnchorMap_升级定位 中的固定业务规则读取，独立字段通过 SimpleFieldMap_升级字段 读取。

🧱 规则体系说明

1. `AnchorMap_升级定位`

AnchorMap_升级定位 用于定位结构化对象区域，例如：

定位编号	说明
`sales.month.header`	销售去化月份表头
`product.res.start`	住宅产品属性起点
`product.com.start`	商业产品属性起点
`unit_mix.fya.anchor`	户配区第一个产品代码
`engineering.indicator.area`	前期工程指标区（04.1工程指标 E3:U153）
`supporting.area.matrix`	配套用房及附属/地下空间二维区域（02基本指标录入 E280:P300）

这些定位点用于动态找到旧模板和新模板中的关键区域，而不是完全依赖固定地址。前期工程指标区和配套用房区的规则会在读取和写入阶段自动补充，无需管理员手工配置。

读旧阶段，工具会根据旧模板版本自动判断前期工程指标区的范围（V9 以前为 E3:Y153，V9 及以后为 E3:U153）。

2. `SimpleFieldMap_升级字段`

SimpleFieldMap_升级字段 是独立字段的正式迁移规则表。

它保存：

字段	说明
字段编码	稳定业务编码，跨版本不可随意变更
字段名称	中文字段名称
字段分组	基础指标、工程指标、融资计划等
旧版工作表	旧模板所在工作表
旧版默认区域	旧模板兜底地址
旧版搜索方式	固定地址、固定地址校验或标签偏移
旧版标签文本	用于匹配的标签
新版工作表	新模板目标工作表
新版目标区域	新模板兜底地址
新版搜索方式	新版固定地址、固定地址校验或标签偏移
标签行偏移	标签到输入框的行偏移
标签列偏移	标签到输入框的列偏移
旧标签校验地址	标签校验时标签单元格地址
标签不匹配处理	标签校验不通过时的处理方式（跳过等）
是否迁移	是/否
版本排除	指定版本不参与迁移
备注	特殊说明

独立字段优先使用”工作表 + 标签文本 + 偏移”的方式匹配，地址只作为兜底。

写入阶段，当 SimpleFieldMap 中找不到目标字段时，会自动尝试字段别名重定向（如”非人防车位售价(元/个)”重定向为”车位售价(万元)”）。

3. `VersionRule_版本规则`

VersionRule_版本规则 用于匹配旧/新模板版本与历史规则包。

表结构：

列	说明
规则编号	唯一编号
版本识别关键字	用于匹配旧/新模板版本号中的关键字
规则版本	历史版本编码，如 `V9_4`
SimpleFieldMap表名	对应历史字段规则表名
AnchorMap表名	对应历史定位规则表名
是否默认最新版	仅管理员容错用途
是否启用	是/否
备注	特殊说明
最近匹配版本	最近一次激活时匹配到的版本
最近使用时间	最近一次激活时间

示例：

旧模板版本	使用字段规则	使用定位规则
V9.4	`SimpleFieldMap_V9_4`	`AnchorMap_V9_4`
V9.3	`SimpleFieldMap_V9_3`	`AnchorMap_V9_3`
V8.5	`SimpleFieldMap_V8_5`	`AnchorMap_V8_5`

版本规则决策机制

读取旧模板时，工具会先识别旧模板版本号，然后在 VersionRule_版本规则 中查找精确匹配的启用规则：

精确匹配：直接激活对应规则，用户无需额外确认。
未精确匹配：工具会从所有启用规则中推荐一个版本号最接近的替代规则，弹出确认对话框，用户确认后才会继续。该情况下升级后需要重点核查数据。
无可用规则：工具终止升级并提示管理员补充版本规则。

写入新模板时，同样会识别新模板版本并激活对应的新版规则，并弹出写新前升级规则确认框。

🔄 特殊迁移处理

1. 车位售价单位转换

旧版模板中”非人防车位售价”单位为元/个，新版模板中”车位售价”单位为万元。工具在写入阶段会自动将旧值除以10000。该转换规则通过字段别名兼容机制和 TGT_AdjustSimpleInputValueBeforeWrite 函数实现。

2. 字段别名兼容补值

读取阶段结束后，工具会自动执行字段别名补值，将旧版字段名映射为新版字段名（例如”非人防车位售价(元/个)”→”车位售价(万元)”），确保新版 SimpleFieldMap 能正确识别。

3. 无效产品行处理

如果旧文件中某个产品的房源面积（K列）为空或为零，工具判定该产品为无效产品行：

不迁移该产品的任何属性数据；
不清空新版该产品整行；
仅将新版该产品行的房源面积列写为零。

4. 前期工程指标有效产品判断

工具通过旧模板第152行（工程成本合计行）判断哪些产品是本项目实际启用的产品。只有合计值非空、非零、非横杠的产品列才会被写入新版前期工程指标区，避免旧模板列出全部产品类型时把未启用产品也带入新版。

5. 前期工程右侧固定指标区同步

新版模板在 04.1工程指标!W3:AN153 有一块右侧固定指标区。左侧 E3:U153 写入后，工具会自动将数据同步写入右侧同名产品列（仅允许写入特定行号，小计/合计行由公式自动计算）。

同时，左侧的小计/合计行公式会从右侧同名产品列原样复制，确保左侧新增产品列的公式正确。

6. 销售去化非产品固定行

销售去化区除标准产品行（fya ~ fyx）外，还有车位、代建、政府有偿配建、政府无偿配建、持有等非产品固定行。工具通过扫描新版销售去化区 C~F 列文字关键词定位这些固定行，而非按产品代码匹配。

新版模板销售去化区布局为：D137:FA160 为标准产品行，G161:FA165 为非产品固定行，E161:F165 为行头合并区域（写入时跳过）。

7. 配套用房及附属/地下空间

配套用房区（E280:P300）按二维表方式读取和写入，行名按 E 列匹配，指标列按表头文字匹配。K:N 列为公式汇总列，禁止迁移覆盖。V9.1 及以前版本没有 O:P 新增手填值，写入后会自动清空该区域。

如果新版模板中找不到旧模板的行名，工具会按 rowIndex 定位同一行并补写行名。

8. 配置标准

工具按产品组读取 04.3配置标准!D2:BX87 区域，每4列为一个产品组。第2行为产品名称（合并单元格），第4行为配置档次（仅允许组内第1列），第7:87行为指标数据。写入时按产品名称匹配新版产品组，组内列号按偏移写入。

9. 新版模板版本号保护

新版模板的版本号单元格（02基本指标录入!M1）在写入时会被跳过，保留新模板原值。

🧪 洋红扫描说明

洋红扫描的定位

洋红扫描是管理员维护字段规则的开发工具，不是普通用户升级流程的一部分。

正常用户升级旧模板时：

1
2
3

不需要旧模板带洋红色
不需要新模板带洋红色
不需要执行洋红扫描

洋红色只是一种辅助生成 SimpleFieldMap_升级字段 的临时标记，正式迁移规则仍然是 SimpleFieldMap_升级字段。

洋红扫描用途

洋红扫描主要用于：

首次建立字段规则表；
新版模板结构调整后维护字段规则；
发现遗漏字段后补录规则；
维护 V9_4、V9_3 等历史版本规则；
修正或补充独立输入框迁移规则。

扫描范围控制

工具不会全工作簿搜索，也不会扫描 UsedRange 全表，而是只扫描 ScanScope_洋红扫描范围 中配置的工作表和区域。

默认示例：

是否启用	工作表	扫描区域	备注
是	`02基本指标录入`	`A1:FA126`	基础独立字段区
是	`02基本指标录入`	`A261:FA420`	对象区之后独立字段区

管理员应根据不同历史版本模板，把可能存在洋红输入框的工作表和区域配置完整。扫描完成后，工具会自动补回车位售价别名映射规则，避免依赖人工维护。

🧰 管理员维护流程

一、维护历史版本规则

开启管理员模式
    ↓
确认 ScanScope_洋红扫描范围 已配置
    ↓
点击【版本扫描】（执行前自动备份当前规则）
    ↓
选择带洋红标记的历史版本模板
    ↓
扫描结果写入 SimpleFieldMap_升级字段
    ↓
自动补回车位售价别名映射规则
    ↓
检查并修正字段规则
    ↓
点击【版本固化】（执行前自动备份当前规则）
    ↓
输入版本号，如 V9_3
    ↓
生成 SimpleFieldMap_V9_3 和 AnchorMap_V9_3
    ↓
自动登记到 VersionRule_版本规则

二、固化逻辑

固化时，工具不会让用户选择某张表，而是固定将当前运行态规则表复制为历史版本规则表：

1 2	SimpleFieldMap_升级字段 → SimpleFieldMap_V9_3 AnchorMap_升级定位 → AnchorMap_V9_3

也就是说：

1 2	当前运行态规则表 = 待固化草稿输入版本号 = 决定复制后的历史规则表名

三、规则备份

管理员执行扫描、固化等高风险操作前，工具会自动备份当前规则表：

1
2
3

Bak_Simple_时间戳
Bak_Anchor_时间戳
Bak_Version_时间戳

工具默认只保留最近 5 组备份，避免备份表无限增加。

📊 报告体系

1. `MigrationReport`

MigrationReport 是逐条迁移明细表。

字段结构：

列	说明
序号	自增序号
结果	成功/失败/跳过/完成
字段编码	fieldId
字段名称	fieldName
对象类型	objectType
对象主键	objectKey
子项	subKey
目标地址	新模板写入位置
说明	详细原因
生成时间	日期时间格式显示（yyyy/mm/dd hh:mm:ss）

常见结果包括：

结果	说明
成功	已写入目标单元格
失败	未能写入，需要复核
跳过	不需要写入或暂不支持
完成	系统流程完成记录（如预清理、另存副本等）

常见失败原因包括：

SimpleFieldMap 中未找到新版目标；
新版目标工作表不存在；
新版目标区域无效；
对象主键未匹配；
月份序号无效；
户型序号超出范围；
字段编码为空；
新版产品属性区未找到对应属性列；
新版前期工程指标区无法分配目标列；
新版配套区域未找到行名或指标列；
新版配置标准未找到产品组。

2. `MigrationSummary_迁移汇总`

MigrationSummary_迁移汇总 用于快速判断升级结果。

汇总内容包括：

版本与规则风险判断（精确匹配 / 替代规则 / 未记录）；
总记录数；
成功/完成数量；
失败数量；
跳过数量；
按对象类型统计；
失败明细列表；
跳过明细列表；
是否需要人工复核的结论。

3. `CheckReport_工具体检`

CheckReport_工具体检 用于检查工具当前是否具备正常运行条件。

检查内容包括：

检查项	说明
运行环境	检查 Excel/WPS、Dictionary、FSO、FileDialog、VBProject、AutomationSecurity 等能力
核心工作表	检查规则表、日志表、报告表是否存在
版本规则表头	检查是否为新版表头结构
版本规则启用项	检查是否有启用规则、字段规则表/定位规则表是否存在
默认最新版规则	提示性检查，当前架构不强制要求
运行时定位规则	检查必备对象区规则（销售、产品、户配）和扩展区规则（前期工程、配套用房）
字段编码唯一性	检查 `SimpleFieldMap` 是否存在重复 fieldId
字段规则目标地址	检查迁移字段是否缺少新版目标表/区域
旧数据记录	检查 `LegacyData_临时读取` 是否有数据
对象类型	检查是否读取到 `simple_input`、`product`、`land_block`、`engineering_indicator`、`supporting_area` 等对象
系统信息	检查是否记录了旧版本号、文件路径、版本决策信息
迁移失败项	检查 `MigrationReport` 是否存在失败记录
迁移汇总	检查是否已生成汇总
运行日志	检查日志表头格式和记录数

4. `MapAudit_字段映射诊断`

MapAudit_字段映射诊断 用于管理员批量检查字段规则的健康度。

检查内容包括：

检查项	说明
字段映射表旧地址重复	同一旧地址被多个字段使用（高危）
固化结果来源地址重复	LegacyData 中同一来源地址生成了多个字段（高危）

🧭 普通用户使用步骤

一键升级流程

1. 配置自动宏开关（首页第8~9行）
2. 点击【③ 一键升级】
3. 选择旧模板
4. 确认版本规则弹窗
5. 选择新模板
6. 确认写新前升级规则弹窗
7. 工具自动完成读旧→写新→汇总→体检
8. 查看汇总、报告和体检结果

初次使用建议先采用分步流程，确认无误后再使用一键升级。

🧾 生成文件说明

写入新模板后，工具不会覆盖原新版模板，而是另存为升级副本。

命名规则：

1	新模板文件名_旧模板文件名_时间戳.xlsm

命名示例：

1	XLCS全成本测算模板_Core V9版_项目A测算V8.5_20260627_140421.xlsm

如果无法获取旧模板文件名，则使用兜底格式：

1	新模板文件名_已升级_20260627_140421.xlsm

这样可以保留原始新版模板，便于回滚和复核。

⚠️ 注意事项

普通用户不要执行洋红扫描。
洋红扫描只用于管理员维护字段规则，正常升级不需要旧模板或新模板带洋红色。

不要手工同时打开旧模板和新模板。
工具流程会控制”旧模板读取后关闭，再打开新模板写入”，尽量避免两个 XLCS 模板同时打开带来的 VBA 工程互相干扰风险。

升级后必须人工复核。
工具负责迁移输入数据，但新版模板中的公式、外链、城市库、云数据库、销售周期、税费逻辑、成本分摊等仍建议人工检查。

如版本规则未精确匹配，工具会推荐替代规则并弹出确认。
用户确认后才会继续读取或写入。这种情况下升级后需要重点核查数据。

如没有任何可用规则，工具会终止升级。
此时需要管理员补充或固化对应版本的升级规则。

管理员固化历史规则前，应确认当前运行态规则表正确。
固化操作会把当前 SimpleFieldMap_升级字段 和 AnchorMap_升级定位 复制为历史版本规则表。

fieldId 是跨版本迁移桥梁，严禁因地址变化或标签变化随意修改。
同一业务字段在不同版本规则中必须使用相同的 fieldId。

新版模板版本号单元格（02基本指标录入!M1）在写入时会被自动跳过。
保留新模板原值，不被旧数据覆盖。

自动宏默认全部关闭。
首页第8~9行的自动宏开关默认为”否”，需要手动开启后再执行写新。写新完成后会弹出确认框供最终确认。

🧱 技术模块概览

工具 VBA 模块按职责拆分：

模块名称	说明
`读取旧文件数据`	读取旧模板，生成 `LegacyData_临时读取`，包括系统信息、销售去化、地块、产品属性、户配、前期工程指标、配置标准、配套用房/地下空间、独立字段、字段别名补值
`写入新文件数据`	写入新模板并另存升级副本，包括独立字段、销售去化（含固定行和固定区域写入）、地块、产品属性（含无效产品处理）、户配、前期工程指标（含有效产品判断、产品表头写入和右侧同步）、配置标准、配套用房/地下空间、自动宏执行确认、迁移报告生成（含报告缓冲区优化）
`扫描洋红生成字段表`	洋红扫描、字段规则维护，扫描后自动补回车位售价别名映射规则
`M_VersionRule版本规则`	版本规则固化与激活，支持读旧/写新双向版本匹配
`M_Home首页模块`	首页按钮、状态卡片、自动宏配置区、跳转入口
`M_Main一键升级`	一键升级主流程，含写新后自动体检和汇总生成
`M_Init初始化刷新首页模块`	初始化核心表、刷新首页、确保所有工作表表头完整
`M_Btn首页按钮转发模块`	首页按钮短入口，管理员操作含自动备份
`M_AdminMode`	管理员模式开关
`M_Report迁移汇总模块`	迁移汇总生成，含版本风险判断、失败/跳过明细
`M_Check工具体检模块`	工具体检，含运行环境、核心表、版本规则、字段规则、旧数据、迁移报告、日志完整性检查
`M_RuleBackup`	规则备份与清理，默认保留最近 5 组
`M_Nav页面导航模块`	所有工作表返回首页按钮和冻结表头
`modMapAudit`	字段映射诊断，批量检查旧地址重复和来源地址冲突
`M_Util基础公共函数统一层`	公共函数、日志、文件选择、版本识别、文本处理、应用环境保护
`M_ParkingPriceRuleFix`	车位售价别名规则固化到所有规则表
`全导出模块代码到TXT`	导出完整 VBA 工程代码（需 VBProject 访问权限）
`导出标准模块代码到TXT`	导出所有标准模块代码到 TXT 文件

🔐 安全策略

策略	说明
旧模板只读打开	防止误写旧文件
关闭旧模板后再打开新模板	降低多模板同时打开风险
读旧阶段禁用事件、链接更新、自动计算、外部宏	减少打开旧模板时触发宏、外链或重计算
写新阶段不禁用 AutomationSecurity	保持目标模板宏可运行，避免 `Application.Run` 失败
新模板另存副本	不覆盖原文件，副本包含旧文件名和时间戳
规则自动备份	扫描、固化前自动保留规则快照
版本规则用户确认	非精确匹配时弹出确认，无可用规则时终止
写新前规则确认	显示完整升级信息，用户确认后才开始写入
自动宏执行确认	写新后弹出确认框，列出将执行的宏项
新版模板版本号保护	M1 单元格写入时自动跳过
迁移报告与体检	便于复核失败项和异常项
字段映射诊断	检查旧地址重复和来源冲突等高危问题
管理员模式	避免普通用户误点维护功能
配套用房公式列保护	K:N 列为公式汇总列，禁止迁移覆盖

📁 建议文件目录

《XLCS房产项目全成本测算模板》最新完整压缩包目录

序号	文件名称
1	XLCS全成本测算模板_Core V9版.xlsm
2	XLCS PRO V2全成本测算模板_多地块版.xlsm（多地块专用）
3	单页简易测算模版simple-template.xlsm
4	XLCS房产项目全成本测算模板使用说明.docx
5	XLCS Core WPS用户快速上手.docx
6	deepseek对XLCS全成本测算模版分析.docx
7	版本更新说明.txt
8	城市库使用说明.txt
9	各版本选择说明.txt
10	XLCS房产项目全成本测算模板快速上手.txt
11	wps.vba.rar（WPS官网免费个人版必装VBA插件）
12	小白版Core.rar、小白版PRO.rar
13	XLCS模板升级工具V1.xlsm

📥 最新版下载地址

XLCS模板升级工具已包含在最新版压缩包中。
选择任意一个下载地址，输入 Access password，在下载页面右上角点击下载按钮。
如未出现下载按钮，请刷新页面。

类型	地址
主力下载地址	http://fccs.cc/xiazaigengxin/120.html
备用下载地址	http://cskits.com/posts/e79f33ad.html
备用下载地址	http://fccsz.com/xiazaigengxin/120.html

🌐 官网与支持

类型	地址
官网	http://fccs.cc
官网	http://fckcs.cn
官网	http://fckcs.com
官网	http://fdc.sd
官网	http://fccsz.com
官网	http://cskits.com
求助建议	http://xlcs.de/
邮件联系	admin@fdc.sd

📷 工具预览

XLCS 模板升级工具预览

✅ 总结

XLCS模板升级工具.xlsm 的核心价值在于：

把迁移逻辑从新模板中剥离；
让旧模板只读、新模板纯净；
把规则、临时数据、报告、日志集中在工具文件中；
支持 V9_4、V9_3、V8_5 等历史版本规则沉淀；
版本规则决策透明化，非精确匹配需用户确认，无可用规则时终止升级；
降低两个复杂 XLCS 模板同时打开时的互相干扰风险；
自动处理车位售价单位转换、无效产品行、前期工程有效产品判断等复杂迁移场景；
前期工程指标支持左侧写入+右侧同步+公式自动补齐；
写入后按用户配置可选执行城市刷新和融资计算宏，并有执行确认；
迁移报告带生成时间戳，汇总含版本风险判断和按对象类型统计；
一键升级自动串联读旧、写新、汇总、体检全流程；
为未来多版本升级、规则维护、报告复核、字段映射诊断提供统一工作台。

最终架构可以概括为：

升级工具负责迁移
旧模板负责提供数据
新模板负责承接数据
规则表负责长期维护
报告表负责过程复核
体检表负责质量把关

XLCS — 让全成本测算更智能

XLCS 模板自动升级工具指南书

📌 快速导航

📖 产品说明

🎯 工具定位

🧩 架构说明

一、独立工具文件架构

二、新旧模板角色

🚀 核心升级流程

分步升级流程

一键升级流程

🧭 首页功能区

自动宏配置

🗂 核心工作表说明

⚙️ 核心功能一览

🔍 可迁移数据类型

🧱 规则体系说明

1. AnchorMap_升级定位

2. SimpleFieldMap_升级字段

3. VersionRule_版本规则

版本规则决策机制

🔄 特殊迁移处理

1. 车位售价单位转换

2. 字段别名兼容补值

3. 无效产品行处理

4. 前期工程指标有效产品判断

5. 前期工程右侧固定指标区同步

6. 销售去化非产品固定行

7. 配套用房及附属/地下空间

8. 配置标准

9. 新版模板版本号保护

🧪 洋红扫描说明

洋红扫描的定位

洋红扫描用途

扫描范围控制

🧰 管理员维护流程

一、维护历史版本规则

二、固化逻辑

三、规则备份

📊 报告体系

1. MigrationReport

2. MigrationSummary_迁移汇总

3. CheckReport_工具体检

4. MapAudit_字段映射诊断

🧭 普通用户使用步骤

推荐流程

一键升级流程

🧾 生成文件说明

⚠️ 注意事项

🧱 技术模块概览

🔐 安全策略

📁 建议文件目录

《XLCS房产项目全成本测算模板》最新完整压缩包目录

📥 最新版下载地址

🌐 官网与支持

📷 工具预览

✅ 总结

1. `AnchorMap_升级定位`

2. `SimpleFieldMap_升级字段`

3. `VersionRule_版本规则`

1. `MigrationReport`

2. `MigrationSummary_迁移汇总`

3. `CheckReport_工具体检`

4. `MapAudit_字段映射诊断`