Excel 保持格式编辑

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install excel-keep-format-edit
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 excel-keep-format-edit。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Excel 保持格式编辑是一个 Openclaw Skills 工作流，可在现有 Excel 和旧版 XLS 报表中更改特定值，而无需重建工作簿。它通过 pywin32 使用 Excel COM 打开原始文件的副本，只修改选定单元格，并保留字体、边框、合并单元格、条件格式、列宽、布局以及其他 Excel 原生细节。
此技能专为财务报告工作流设计，例如审计调整、会计更正、财务预测以及报表行项目重分类。它还会通过扫描标签而不是猜测坐标来定位目标行和列，然后对资产负债表、损益表及相关财务数据执行平衡检查。

应用场景

更新现有 Excel 或 XLS 报表，同时保持其视觉设计不变。
应用审计调整、会计更正或财务报表重分类。
修改留存收益、收入、费用、应收款项或其他指定行项目。
调整资产负债表中的值，同时保持资产 = 负债 + 权益。
更新旧版工作簿，避免使用 openpyxl 重建时损坏格式或布局。
更改期初或期末留存收益后对账财务报表。
在编辑值之前，定位双栏或并排报表中的会计标签。
验证手动维护的合计数和报表关系在编辑后仍保持一致。

工作原理

确认指定的工作簿、目标报表、会计标签以及需要更改的值。
将源工作簿复制到输出路径，确保原始文件保持不变。
使用 pywin32 通过 Microsoft Excel COM 打开复制的工作簿；不要使用 openpyxl 重建工作簿。
扫描工作表标签以定位实际目标行和列。对于并排排列的资产负债表，这一步至关重要，因为标签可能位于 E 列，而值可能位于 G 列或 H 列。
考虑 Excel COM 的行列索引从 1 开始，而不要假设坐标与 xlrd 等从 0 开始的库相同。
只写入指定目标单元格的值，不更改工作簿格式、样式、合并单元格、列宽和布局。
在适用时重新计算工作簿；如果旧版 XLS 文件将合计数存储为静态数字而非公式，则手动重新计算合计数。
通过 Excel COM 保存并关闭工作簿。
验证会计关系，包括资产 = 负债 + 权益，以及留存收益变动与累计利润之间的关系。
报告输出文件和任何验证结果，包括需要人工审核的差异。

配置指南

Windows 操作系统。
已安装 Microsoft Excel，且可用于 COM 自动化。
安装和运行时使用同一个 Python 环境。
在该环境中安装 pywin32 软件包。
在代理的虚拟环境中安装依赖项：
python -m pip install pywin32
使用同一个虚拟环境中的 Python 解释器运行编辑脚本。将 pywin32 安装到一个环境，却使用系统 Python 运行脚本，可能导致 win32com、pywintypes 或相关模块导入错误。
操作指南
保持原始工作簿不变，并将编辑结果写入复制后的输出文件。
如果 python -I 会导致解释器无法访问已安装的站点软件包，请勿使用它。
保存后确保 Excel 正常关闭，包括执行 Workbook.Close 和 Excel.Quit。
编辑前确认目标工作表名称。
不要盲目终止 Python 进程，因为该进程可能属于 Web 应用程序或网关。
写入值之前，使用标签扫描确认目标位置，尤其是在双侧财务报表中。
Excel 保持格式编辑 数据架构与分类体系
工作簿和输出处理
项目 组织方式或规则
源工作簿 用户提供的原始 .xls 或 Excel 工作簿；按只读方式处理。
输出工作簿 通过 Excel COM 原位编辑的工作簿副本。
工作表范围 目标工作表，例如资产负债表、损益表或现金流量表。
单元格寻址 Excel COM 使用从 1 开始的行列索引。
目标发现 扫描可见标签和会计科目，而不是依赖猜测的行号。
值更新 仅更改指定单元格的 .Value；保留所有其他工作簿属性。
重新计算 请求 Excel 执行计算，但不要假设旧版文件中的静态合计数会自动更新。
验证结果 记录平衡检查结果以及任何尚未解决的差异。
财务元数据分类
资产负债表：流动资产、非流动资产、负债、实收资本、留存收益、资产总额、负债和权益总额。
损益表：收入、成本、管理费用、财务费用、营业利润、营业外收入、税前利润、所得税和净利润。
现金流量表：与现金相关的变动和非现金调整；如果调整不涉及现金收付，通常无需更改。
对账规则：资产必须等于负债加权益；在适用情况下，期末留存收益减期初留存收益应与累计利润相符。
布局元数据：字体、边框、合并单元格、条件格式、列宽、工作表排列以及其他 Excel 原生格式均保留在工作簿副本中。
对于并排报表，此技能会明确区分左侧值列（如 C 列或 D 列）与右侧值列（如 G 列或 H 列），以防将编辑内容写入错误的报表区域。

高级特性

基于 COM 原生方式进行编辑，比使用 openpyxl 重建文件更可靠地保留旧版 XLS 格式和工作簿布局。
基于标签发现行列，减少硬编码坐标导致的错误。
支持标签区域和值区域分开的并排财务报表。
提供先复制再编辑的保护措施，以便保留原始工作簿供比较或回滚。
支持 Excel 重新计算，同时识别静态小计和合计单元格可能需要手动计算。
支持验证资产与负债及权益之间的资产负债表关系。
支持将留存收益与期初余额及累计利润进行对账。
提供实用保护措施，避免虚拟环境不匹配、COM 索引错误、左右列选择错误以及进程清理不完整等问题。
作为专注型 Openclaw Skills 自动化工具，可用于审计调整、会计更正和受控的电子表格更新，而无需重新设计源报表。

name: excel-keep-format-edit slug: excel-keep-format-edit
displayName: Excel原表改数字不破格式·财务三表勾稽自动保
description: >- 客户拿来一张老报表说「就在原表上改个数，格式一点都不要动」——用 openpyxl 重建一次，字体、边框、合并单元格、条件格式、列宽全丢，客户一打开就知道这不是他原来那张表。

正确做法：用 Excel COM 打开原文件的副本，只改目标单元格的值，其余原样保留。

这套 skill 解决三个真痛点：

• 格式零丢失：复制原件再改，不重建工作簿
• 别猜行号：先扫科目名定位实际行列再改（附「资产负债表是左右双栏、科目在 E 列、数值在 G/H 列」这个反复踩的坑）
• 改完保勾稽：财务三表调整后自动校验「资产=负债+所有者权益」，不是改完就交

适用：审计调整分录、财务测算、错账更正、报表科目重分类。
环境：Windows + Office（用 pywin32 调 COM）。

触发词：Excel改数字、保格式修改、原表修改、不动格式、xls修改、财务三表、资产负债表调整、勾稽关系、审计调整。
version: 1.1.0
author: 九品锦锂e
summary: 用Excel COM只改目标单元格，字体边框合并条件格式列宽全不动；改完校验三表勾稽。
license: MIT