XLCS 模板升级工具新手使用说明

📌 快速导航

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

XLCS 模板升级工具 - 新手快速上手使用说明书

📖 核心概念与定位

XLCS 模板升级工具 是为 XLCS 房产项目全成本测算模板设计的独立升级工作台。它通过将迁移代码、规则和临时数据封装在工具内，保证升级过程安全、纯净：

升级工具：承载迁移规则、执行代码、临时数据及报告。
旧模板：仅作为只读数据源，防止数据被篡改。
新模板：仅作为纯净写入目标，无任何残留的迁移代码或辅助表。

⚠️ 安全警告：请勿手工同时打开旧模板和新模板，避免 VBA 工程名冲突或重计算卡死。工具会自动控制“读取旧模板后关闭，再打开新模板写入”的流转。

⚙️ 准备工作：自动宏开关配置

在执行升级前，请先在工具主界面第 7~9 行的 “自动宏开关” 区域进行配置。这决定了数据写入新模板后，是否自动执行新版模板中的计算和更新宏：

配置项（第8行）	刷新城市名	刷新前期工程指标	生成融资利息
值单元格（C8/E8/G8）	默认：是	默认：是	默认：是
配置项（第9行）	生成非标融资利息	生成前期工程支付	全表重算
值单元格（C9/E9/G9）	默认：是	默认：是	默认：是

配置方法：双击黄色值单元格，通过下拉菜单选择“是”或“否”。
生效时间：修改后在下一次执行“写新”时生效。

🚀 升级操作流程（二选一）

推荐方案：分步升级流程（适合初次或版本跨度大时）

分步升级便于在中间步骤人工核对提取的数据，流程如下：

打开工具：打开 XLCS模板升级工具V1.xlsm 并核对上述“自动宏开关”。
读取旧模板数据：
- 点击首页的 【① 读旧文件】 按钮。
- 选择您的旧版测算文件。
- 版本规则决策：工具会自动识别旧文件版本并匹配规则。如果未精确匹配，会弹出提示推荐最接近的替代规则（例如用 V9.4 规则读取 V9.3 文件），请仔细阅读弹窗说明后点击“是”确认继续。
- 读取完成后，旧文件会自动关闭。您可以点击首页 【旧数据】 按钮跳转到 LegacyData_临时读取 表查看提取出来的数据。
写入新模板：
- 点击首页的 【② 写新模板】 按钮。
- 选择纯净的新版测算模板文件。
- 确认弹出的升级规则信息。
- 写入过程中，会弹出“自动宏执行确认”，如需按照首页配置执行自动计算，点击“是”；如需临时全部跳过以加快写入速度，点击“否”。
- 写入完成后，工具会自动执行计算并将新文件另存为副本。

极速方案：一键升级流程（适合批量或规则已确认时）

打开工具，确认“自动宏开关”配置。
点击首页的 【③ 一键升级】 按钮。
按弹窗提示依次选择：旧版测算文件 ➔ 新版测算模板。
工具会自动在后台完成：读取旧数据 ➔ 关闭旧文件 ➔ 写入新模板 ➔ 执行自动宏 ➔ 另存副本 ➔ 运行写新后体检 的全套流程。

🧾 升级结果与生成文件说明

1. 升级副本的命名规则

写入完成后，新模板本身不会被覆盖，而是自动另存为带有时间戳的升级后副本。

命名格式：新模板文件名_旧模板文件名_时间戳.xlsm
兜底格式：新模板文件名_已升级_时间戳.xlsm（若未读取到旧文件名）

2. 迁移质量核查

升级完成后，请务必返回工具首页查看右侧状态卡片或跳转到对应报表进行核对：

【迁移汇总】（MigrationSummary）：快速查看迁移成功率、对象类型统计和“失败/跳过”明细。若存在失败项，请优先排查。
【升级报告】（MigrationReport）：记录了每一个单元格的写入结果。如果出现失败，会在“说明”列中列出具体原因（如新版删除了该指标、格式不匹配等）。

⚠️ 关键注意事项（避坑指南）

车位售价单位自动转换：旧版“非人防车位售价”单位为元/个，新版为万元，工具写入时自动除以10000，无需人工换算。管理员已固化该转换规则到所有历史版本规则表中，不会因扫描操作而丢失。
无效产品过滤与老无新有处理：若旧文件某产品“房源面积”列数据为空或为0，工具将判定该产品未实际启用：
- 该产品的所有属性数据（产品属性、户配、工程指标）均不迁移；
- 新版对应产品行的房源面积自动写为0，但不清空其他公式或默认值，避免破坏表格结构。
前期工程指标有效产品过滤：工具根据旧模板“04.1工程指标”工作表第152行的“工程成本合计”是否非空非零，来识别实际启用的工程产品。未启用的产品数据不会被带入新版，防止表格杂乱。
配套用房及附属/地下空间保护：
- 该区域 K:N 列为公式汇总列，禁止覆盖；
- V9.1及以前版本的旧模板无 O:P 新增列，写入时自动跳过，保持新版该区域为空。
新版模板版本号保护：新版模板中的版本号单元格（位于 02基本指标录入!M1）受代码保护，写入时自动跳过，保留新模板原值，防止被旧文件的版本号覆盖。
普通用户禁用“扫描”与“固化”：首页管理员维护区的【版本扫描】、【版本固化】等按钮专供系统管理员开发规则使用。普通用户正常升级数据时切勿点击，以免覆盖当前运行的规则库。
升级后必须人工复核：工具只负责安全、准确地迁移旧文件的手工输入数据。由于新版模板的税费逻辑、城市库、成本分摊或计算公式可能已发生改变，升级后的副本文件仍建议由测算人员进行关键指标的手工核对。

🌐 官网与支持

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