ARTICLE · 1237739
角规调查模拟与采伐决策工具1.0使用说明
QUOTE
规则不写进人的记忆，写进代码。
—— Mu
这套工具的价值不在能算什么，而在每一步都告诉你：数是怎么来的，误差还剩多少。所以它的说明书，本质上是一份顺序说明——先做什么、后做什么，跳步会付出什么代价。
第一次打开这个工具，容易犯一个错：直接冲进「详细模拟工作台」填参数。
实际上它的设计是「先定规则，再算数」。规则放在第 01 章，算数在第 02 到 06 章，出成果在第 07 到 09 章。当然完整走完一套流程后，顺序就不那么重要了，你可以在多个环节不停的返工，毕竟返工是此类项目常态~。
本文看点
01
先定规则再算数
02
口径决定结果
03
提示即用法
01
OVERVIEW
总览与全局设置
定位——模块入口、使用声明、界面主题与计算口径的全局开关。
界面结构
计算口径：先定这件事
顶栏开关同时控制主程序与批量小班，切换后立即按新口径重算。两条路线的差别是根本性的：
无论选哪种，导出的《公式与参数表》都会记录本次口径。交接成果时不需要口头说明用的是哪一套。
工具全局设置
点「应用并重算主程序与批量小班」后，已生成的小班按新策略重算；点取消不保存。
主题与声明
四套主题：现代林业绿、冰岛岩蓝、橄榄砂岩、液态玻璃升级版。主题只影响显示，不影响任何计算结果与导出格式。
NOTICE
本工具用于调查模拟、方案比较、教学演示和辅助决策，不替代现场调查、技术规程与专业人员判断。模型参数、树种组成、形高公式与出材率模型必须按当地实际林分校准；所有导出结果须经专业人员复核后方可用于正式业务。
02
CONFIG
系统参数配置
定位——全工具的规则底座：样点数怎么定、胸径怎么分布、树高怎么随胸径变化、各树种用什么形高公式与出材率表。
任何正式作业前先完成本模块，再进入模拟或录入。改过参数后旧结果会失效，需要重新生成。
三个按钮
下载配置模板
导出 Excel，含「树种与形高」「出材率曲线」两个工作表，可直接编辑。
上传自定义配置
读取同结构 Excel，替换当前全部参数。
恢复默认配置
回到内置默认值，用于试错后复位。
样点数量标准
该标准同时决定：详细模拟生成的样点行数、标准录入页的应录入样点数、新标准记录表的样点行数。
胸径波动分布（7 种）
选择依据是株数随径阶的分布形状，不是凭经验猜。
树高与胸径曲线
默认「原版独立随机」仅用于兼容旧结果，正式使用建议改选幂函数。
曲线指数 b 默认 0.55，建议范围 0.3～0.8。b 越小树高越平缓，b 越大大小径木树高差距越明显。该参数只在非独立随机模式下生效。
选择曲线模式后，工具会把各样点树高的样本均值自动校正回你输入的林分平均树高。你输入的平均树高，就是成果里的平均树高。
树种模型
每个树种需要三样东西，缺一不可：
形高公式——形式为树高的表达式，如 0.5112 + 0.5378 * h。形高指胸高断面积 1 平方米对应的蓄积量
出材率曲线——按胸径给出规格材率、小规格材率，决定出材量与剩余物
剩余物比重——吨每立方米，用于把剩余物体积折算成重量
公式允许使用四则运算、括号、数字、变量 h，以及白名单内的数学函数。保存时会自动试算 3～28 米六个树高点，结果必须落在 0.5～50 之间，否则拒绝保存并说明原因。
内置形高公式与出材率表为示例值。用于正式业务前，请用本地解析木、标准地或已有成果表替换，并在小范围内与既有成果比对通过后再推开。
注意事项
改配置会失效旧结果
已生成结果被标记失效，导出按钮禁用，必须重新点生成结果。
模板随树种列表变化
批量导入模板的树种列按当前配置动态生成，换了配置就要重新下载。
只改数值不改结构
配置 Excel 的列名与工作表名不要改。
03
SIMULATION
详细模拟工作台
定位——功能最完整的模块：参数模拟、样点表、各树种结果、采伐决策、导出。
输入——地籍小班号、作业小班号、伐区面积、平均胸径、平均树高、每亩株数、蓄积调整系数、森林类别与采伐类型方式、十分法树种组成。
输出——6 到 7 个工作表的 Excel 工作簿。
操作步骤
确认口径——这一步决定后续是否执行整数断面配平
填写基本参数——面积精确到 0.001 公顷；胸径与树高按优势木或平均木填写；每亩株数用于推算公顷株数与株行距
填蓄积调整系数——范围 0～1，默认 1。小于 1 用于蓄积的对齐
录入十分法组成——每个树种 0～10 的整数，合计必须等于 10，面板顶部实时显示合计与百分比
调整归并建议（可选）——可逐树种改目标，最终以你的选择为准
点生成结果——生成样点表、各树种结果、配平残差、株行距推算、公顷蓄积估算
采伐模拟（可选）——逐树种设采伐强度，点执行采伐模拟
点导出结果——文件名格式为「角规调查表_地籍小班号_作业小班号.xlsx」
生成结果区看什么
采伐模拟
左侧逐树种设采伐强度（0～100%），可只对部分树种采伐。执行后拆成两套结果：采伐木含株数、蓄积、规格材、小规格材、综合规格材、综合出材率、剩余物；保留木含株数、蓄积、出材、平均胸径与树高。
株数按最大余数法整数化，蓄积强度跟随整数化后的株数强度，因此株数强度等于蓄积强度成立。剩余物全部计入采伐木，保留木剩余物为 0。点「重置 / 显示原数据」可清空采伐结果。
参数改动后必须重新生成。改动基本参数或组成后，页面顶部出现提示条，导出按钮禁用。此时表格与导出内容仍是上一次的数据，直接导出会出错。
注意事项
成数必须整数且合计 10
任何一项非法都会逐项报错，不会静默取整。
断面积超过合理上限会提示
约 60 平方米每公顷时提示组合现实中通常不成立，提示不阻断，允许教学演示。
低占比树种的量化提示要看
目标蓄积低于一个断面可表达的量时，会说明波动幅度及归并后对整组的影响。
缺形高公式直接报错
会列出缺失树种名，回系统参数配置补齐。
04
BATCH
批量小班管理
定位——把几十个小班当台账管理：一次导入、批量生成、逐班微调、批量导出。
导入
点下载批量导入模板，得到含表头与一行示例的 xlsx
按模板填写。必备列：地籍小班号、作业小班号、伐区面积、平均胸径、平均树高、每亩株数。可选列：蓄积调整系数、森林类别、采伐类型、采伐方式、树种组成，以及每个树种一列的成数
点批量导入 Excel。系统在前 5 行内自动探测表头，并对列名做归一化，去空格、全角括号转半角
缺列会提示缺哪几列；某行参数非法会记入错误清单，不阻断其他行
台账操作
树种组成映射关系管理
用于把调查时的树种名转成当前树种模型认识的标准名。
自定义——可自由定义树种映射规则，删改均可恢复
映射管理——维护源树种到标准树种的规则。处理顺序：自定义映射、内置别名、当前模型精确名称
映射管理只做导入前的名称标准化；最终计算时的树种归并仍由全局设置与逐班设置控制，两者不要混用。
05
FIELD ENTRY
从标准角规点录入
定位——正规调查入口，以实测样点为基准，不做组成配平，口径固定为以样点为准。
约束——角规常数 1.0；最多保留 3 个主要树种；样点数按标准模板，新标准 4～18，旧模板 6～12。
操作步骤
选调查模板——新标准需坐标，旧模板不需
填表头——系统自动显示应录入样点数
选森林类别与采伐类型方式——三级联动，可留空，仅用于新标准记录表表头
加样点——逐个添加，或下载模板填好后导入。导入会替换当前样点列表
逐点逐树种填——树高与胸径按该树种平均木填写；角规断面数填该点数到的株数，常数 1.0 时 1 株即 1 平方米每公顷。留空或填 0 表示未数到
点以标准点为基准生成结果
采伐模拟（可选），然后导出
多图斑管理
可在同一次任务里维护多个图斑，逐图斑录入与生成，分别导出或一次导出全部。切换图斑时表头参数随图斑切换，已录入样点保留。
注意事项
样点数有上下限
低于下限或高于上限会提示；新标准超过 18 个在生成记录表时截断并提示。
样点要避开林缘
避开道路、空地，保证代表性；可用 SHP 样点布设预先规避。
树种超过 3 个会停止
新标准记录表会停下来提示先归并，不是简单截断。
按编号聚合
同图斑内各树种样点编号应对应，工具按编号聚合，不按行序。
06
AGGREGATE
角规调查表批量汇总
定位——把本工具导出的多个小班工作簿，合并成一张分树种汇总表。
操作步骤
点上传区或直接拖入多个 xlsx、xls 文件，支持一次全选
等待解析。进度显示已解析文件数与小班数，括号内分别统计并入、重复跳过、无班号跳过、解析失败
查看处理日志。重复小班、缺合计行、班号为空等都会被记下
核对预览表，列较多可左右滑动，首列为作业小班号
点导出分树种汇总表
输出内容
导出为单表「小班汇总表_分树种」。基础列包括作业小班号、地籍小班号、森林类别、面积、总株数、总蓄积、公顷蓄积、规格材、小规格材、剩余物、采伐株数、采伐蓄积、采伐强度、采伐规格材、采伐小规格材、综合规格材、实测出材率、采伐剩余物、采伐树种、保留树种。右侧按树种横向展开三组：树种采伐蓄积、树种采伐材积、树种采伐株数。
注意事项
只汇总本工具导出的工作簿
外部表格字段不匹配时会被跳过或记入日志。
重复上传保留先到的
同一小班号后到的记为重复跳过。
班号为空会尝试回退
从文件名回退，仍取不到则跳过并记警告。
缺失不等于零
源文件缺合计行时对应格显示短横，避免把缺失当成 0。
限并发解析
几十个文件不会卡死页面，但请等进度走完再操作。
07
角规控制检尺测树记录表
定位——把调查成果转成可打印、可签字的外业记录表。两套模板并存，互不影响。
旧规则模板操作
上传多个本工具导出的工作簿，必须包含采伐木统计工作表，即先执行采伐模拟再导出
设字体、字号、纸张方向、四边距
点生成并导出打印版 Excel
新标准模板操作
上传多个角规调查表。需含角规样地调查表、各树种详细结果、采伐木统计、公式与参数表
回填样点坐标（可选）。文件自带样点坐标页会自动读取，也可下载坐标模板填写后导入
设字体、字号、方向
点生成并导出新标准表
新标准表的口径
缺采伐木统计工作表会直接报错并说明原因——本工具只在执行采伐模拟后导出该表。请先回模拟区执行采伐，重新导出，再生成记录表。
08
DESIGN SHEET
采伐作业设计表
定位——在内置的广东省采伐作业设计表版式上，逐小班生成成品 Excel。一个小班一个 Sheet，汇总成一个 xlsx。
版式——24 行 12 列、55 处合并单元格、宋体 18 号标题、仿宋 11 号正文、5 条缩进说明、60 个占位符。
四步流程
上传汇总表——按作业小班号或地籍小班号匹配，可下载标准模板（79 列，含填写说明）。上传后系统会告诉你还缺什么
批量导入角规调查表（可选）——不导入也能直接按汇总表生成；导入后用工具侧结果补充或替换
核对与调整——逐占位符确认来源、当前值、小数位与状态
生成——选 Sheet 名依据（作业小班号或伐区号）与地籍号分隔符，点生成并导出设计表
第三步怎么核
表格列出 60 个占位符的位置、来源、取值来源或当前值、小数位、状态与成品取值。可按状态筛选：
工具条另提供「全部替换为工具侧」与「全部保留汇总表」两个快捷动作，适合整批取舍。编号类占位符只接受精确匹配，避免误配到作业小班号、地籍小班号。
数值格式
郁闭度 2 位；面积 4 位；蓄积、剩余物、出材量、综合规格材 1 位；其余原样输出。空值不写成 0，而是删除占位符留白。
注意事项
别传错表
汇总表与角规调查表不是同一张，更新设计汇总表也不能传到这里。
生成前先看待补充
删掉的占位符不会在成品里留下痕迹，容易漏填而不自知。
Sheet 名可切换
默认取作业小班号，重名会自动处理；如需按伐区号命名在第四步切换。
先重生成再导出
设计表引用工具侧结果，若源调查表参数又改过，请先重新生成。
09
WORD
更新造林设计表
定位——读更新设计汇总表（宽表 125 列），输出每小班一份表的 docx。
独立——与采伐作业设计表各自独立：不读取、不覆盖采伐设计数据。
操作步骤
选模板——新版抚育模板（第一次、第二次、次年）或旧版抚育模板（当年、次年、三年）。模板必须与数据口径匹配
上传汇总表——首行为列名，每行一个小班。首次使用先下载示例模板，按列填好再上传
填标题前缀（可选）——如生态公益林，自动拼成前缀加更新造林小班调查设计表。编号取汇总表编号列
生成——单册输出一个 docx，每小班一份表、表间分页、页码连续；按年度分册则按年度拆成多个 docx
填写要求
列名须与示例模板一致，首行 125 列，每行一个小班。改列名会导致取不到值
建议至少填编号、县镇街村、作业小班号、地籍小班号、采伐年度，其余列可留空，留空处文档对应位置自动留白
抚育列用第一次第二次次年，或当年次年三年其中一套，系统按列名自动识别口径，不要两套混填
注意事项
大册生成时别切页面
首次生成大册请耐心等待，切换页面可能中断任务。
单册与分册内容一致
前者适合逐级报批，后者适合分年度归档，仅拆分方式不同。
留白是设计如此
关键字段全空时生成的表会大面积留白，不是失败。
10
TOOLKIT
其他工具
定位——独立于主流程的辅助工具，互不影响主程序的计算与导出。
SHP 四至坐标计算
从矢量图斑批量提取四至坐标，补齐设计表东至南至西至北至的 X、Y 值。
同时选择 shp 几何、dbf 属性、prj 坐标系三个文件，按住 Ctrl 可一次多选；也可选单个 zip
点解析并计算四至，查看字段数、要素数、坐标系、超长字段提示
点导出 Excel，四至取整数、含带号，原属性字段原样保留
缺一不可：缺 shp 无法计算，缺 dbf 导不出小班号等原有字段，缺 prj 算不出经纬度、也显示不出坐标系。
两套 Excel 合并成 Word
把采伐作业设计表与角规表按 Sheet 名自动配对，生成纵向 A4、一表一页、页码连续的打印稿，附表 X-1 与 X-2。
第 1 套选采伐作业设计表，第 2 套选角规表，旧新标准自动识别
点解析并配对，Sheet 名对不上的会列出
点生成 Word
照片图册生成
两种成册方式，均输出可直接打印的 Word。
照片无 GPS 时自动不叠加、不报错；拍摄日期优先取 EXIF，取不到再用台账。
通用林龄计算器
按三套标准推算林龄，结果可回填汇总表林龄列。
标准集
GB/T 26424-2026 默认、林草湿 2026 广东、二类调查 2016 广东。切换后维度与树种组自动变化。
单条计算
选类别、地区、起源、龄组，输入组成，选取值方式与代表年龄策略后计算。展开判定明细可看落表过程。
批量计算
下载模板、填台账、上传、自动列对照、计算、导出。不改原表，只追加四列，原有格式全部保留；按一般用材林估算的经济林整行标红。
标准表浏览
查看三套标准的龄组、树种组、年龄区间对照表，上次命中的行会高亮。
树种按系数加树种名解析，系数 1～10，7 即 70%；未识别树种按该表软阔处理并提示；混交林按优势树种确定龄组。
SHP 样点布设
在图斑内部按新标准样点数随机布点、避开林缘，导出可直接导入记录表的样点坐标。
选择 shp、dbf、prj 文件
设作业小班号字段、林分平均高、最粗木胸径、断面积系数
选林缘约束：标准取林分平均高与最小间距的较大值，从严再加入 50 米，或自定义
设随机种子，同一种子可复现，点生成样点
导出样点坐标，可直接用于新标准记录表回填
支持多部件图斑与带洞图斑，样点只落在有效面内。
11
FORMULA
计算口径与公式
这一章是给复核用的。看到任何一个数不对，先在这里找它该由什么算出。
整数断面配平
目标蓄积先换算成目标断面总量，按各样点现有断面积分配权重并取整，然后以最小化总蓄积残差为目标逐个断面增减，最多迭代 800 次。若全部为 0 但目标蓄积大于 0，则在形高最小的样点强制置 1，保证有目标就有表达。
残差量与残差率写入「整数断面配平残差」工作表，残差偏大会标红，需人工判断是否可以接受。
采伐模型
等比例均匀采伐：株数先按强度算期望值，再用最大余数法整数化；蓄积、规格材、小规格材按整数化后的株数比例折算；保留木平均胸径、树高与出材率保持不变；剩余物全部归采伐木。
样点数与树种上限
12
EXPORT
导出结构与提示对照
导出工作簿的七个工作表：
「公式与参数表」是复核的关键：任何人拿到这个工作簿，都能还原出结果是怎么算出来的。
常见提示与处理
∞
THE END
使用约定
数据与文件
批量导入与多数解析只接受 xlsx，旧版 xls 请先另存为 xlsx
所有计算在本机浏览器完成，文件不上传服务器。换电脑或清缓存前请先导出成果
同一小班建议保留原始导入文件与导出成果，便于回溯
浏览器
建议 Chrome 或 Edge 最新版，老旧内核浏览器不支持
生成大册 Word 或解析几十个工作簿时请勿中途切换页面
离线版已内置依赖，可直接分发；非离线版需能访问网络加载组件
署名与共享
本工具由作者 Mu 以 Vibe Coding 方式制作并开源共享。可用于学习、内部调查、教学演示与二次开发；请保留作者署名与开源说明，请勿冒充原创、闭源转售或删除声明。
我是 Mu，这套工具的作者。
如果你觉得这篇有收获，欢迎点赞、在看、转发三连。
工具地址：
https://forest-cruise-pro.app.workbuddy.host/?sharecode=2MHOPAQTTN
