楼盖舒适度分析程序
使用手册

1.1 产品定位 #

TigerkinSCA 是一款楼盖（楼板）振动舒适度分析桌面程序，程序标题即「楼盖舒适度分析程序」。它把「结构模型 → 模态与质量源 → 四类激励荷载 → 频率匹配与工况命名 → 标签指派 → 发送模型 → 模态分析 → 时程计算 → 结果提取 → 规范校核 → 计算书」这一条链路收进同一个窗口，结构模型由本机运行的 CSI 产品提供：SAP2000 或 ETABS（可附加已运行的实例，也可直接按 ProgID 启动新实例）。

程序面向结构工程师，不要求使用脚本或命令行：参数在窗口里填，曲线在窗口里看，结论按规范条文给出「满足 / 不满足」。同时，程序通过标准 Model Context Protocol（MCP）向外部通用 Agent（Claude Desktop / OMP）暴露 29 项专业领域工具，便于把重复操作交给 Agent 执行。

1.2 核心能力 #

1.3 典型使用场景 #

• 办公楼 / 住宅楼盖行走舒适度评估——按跨中点步频激励取值，校核峰值加速度是否满足「住宅、医院病房、办公室、会议室、医院门诊室、教室、宿舍、旅馆、酒店、托儿所、幼儿园」类别限值。
• 有节奏运动场所——舞厅、演出舞台、看台、室内运动场地、健身房，按节奏类型取 γ 系数与人群荷载强度 Qp，并按有效加速度合成判据校核。
• 连廊与室内天桥——封闭连廊 / 不封闭连廊 / 室内天桥三类，分别校核竖向与横向峰值加速度。
• 设备振动楼层——车间办公室、生产操作区、安装娱乐振动设备的楼层等，逐台设备单建工况并与类别限值比对。
• 既有楼盖减振改造——布设 TMD 后复算，在计算书中给出各提取点的减振率 η。

1.4 功能地图 #

手册后续章节的顺序与 Ribbon 五个页签一致：定义→TMD→分析→结果→MCP。

1.5 术语速查 #

2.1 运行环境要求 #

2.2 安装包行为 #

2.3 启动与单实例 #

1. 启动程序：双击开始菜单中的 TigerkinSCA，主窗口以最大化打开（标题为「楼盖舒适度分析程序 — {产品名} 未连接」）。
2. 单实例保护：若已有实例在运行，会弹出提示 SlabComfort 主程序已在运行，请直接使用已打开的窗口。 与 如需重新启动，请先退出当前实例后再运行。，本次启动随即退出。
3. 恢复授权：程序在主窗口出现之前先读取本机授权状态；到期与时间回拨等异常会在此时判定（见第 3 章）。
4. 加载本机设置：读取 settings.json（工作区）与 view-settings.json（三维视图外观与六个显示层开关），恢复上次的后端选择、界面与视图状态。
5. 启动 MCP 管道：主程序启动即监听本机命名管道，供外部 Agent 连接（见第 16 章）。

未连接后端时，三维视图居中显示提示 请连接分析后端以加载结构模型，Ribbon 上的连接入口位于【定义】页「后端」组，下拉按钮默认文案为 选择后端…。

2.4 本机文件位置 #

3.1 三档授权与功能范围 #

程序按功能键校核授权，判定规则是「当前档位 ≥ 该功能所需档位」。档位由低到高为 Free（免费）、Annual（年费版）、Perpetual（永久版）。

3.2 免费（Free）可用范围 #

免费档对应的功能键是 load_create（激励荷载创建）与 load_chart（荷载时程图表）：前者对应「荷载配置」中的荷载定义，后者对应同一窗口右栏的时程曲线预览。连接后端、发送模型、模态分析、时程计算、获取结果、四类校核与生成计算书均需要年费版及以上。

3.3 机器码：购买与授权都要用 #

授权与当前机器绑定。机器码由本机硬件指纹派生（主板 / BIOS / 处理器 / 系统 MachineGuid 等信息经哈希前 25 位，按 5 位一组以 - 连接），不随程序升级变化。

1. 打开授权登录窗：菜单 授权(_L) → 登录/购买…(_L)，窗口标题 SlabComfort 授权登录。
2. 复制机器码：点击窗口底部机器码文本，看到 机器码已复制到剪贴板。
3. 提供机器码：购买时把机器码提供给作者 / 销售方；线下授权时须与邀请码一起使用。

3.4 两条激活路径 #

路径 A：线上购买后登录

1. 点 打开购买页面（购买卡片常驻显示，卡片标题 购买授权）或直接访问购买页，完成下单。
2. 回到授权登录窗，确认模式切换复选框 邀请码激活（线下授权） 处于未勾选状态。
3. 填写 用户名 与 密码（注册模式要求密码 ≥6 字符，登录模式无此限制）。
4. 点 登 录（按钮文本中 `登` 与 `录` 之间有一个空格）。登录过程中状态栏显示 正在登录...。
5. 成功后窗口显示已登录卡片：档位（Annual / Perpetual / Free）与到期信息（`到期：yyyy-MM-dd（剩余 N 天）` 或 `永久授权`）。

路径 B：邀请码激活（线下授权）

1. 勾选 邀请码激活（线下授权），窗口出现 邀请码 / 授权码 输入框。
2. 填写 用户名、密码（≥6 字符）与 邀请码 / 授权码。
3. 点 邀请码激活，状态栏显示 正在激活邀请码...。
4. 成功后提示 邀请码激活成功。，并回到已登录卡片。

3.5 授权不足与异常提示 #

4.1 主窗口分区 #

4.2 菜单栏 #

4.3 Ribbon 五页签 #

4.4 项目工作流树 #

左侧面板标题为 项目工作流，默认展开「项目概览」与「结构模型」两个根节点，节点右侧显示运行期明细；可双击的节点在鼠标移入时变为手形，双击即执行该节点的动作（连接 / 打开对话框 / 运行分析）。默认面板宽 220（可拖拽 180–400）。

4.5 未连接与无数据时的提示 #

4.6 快捷键与鼠标手势 #

三维视口旋转

中键拖动

三维视口平移

Shift + 中键拖动

三维视口选择

左键点选或框选（左键不再旋转相机）

右键菜单

命中构件时为「定位到此构件 / 查看属性 / 适合窗口 / 切换视角 / 切换相机」

5.1 流程总图 #

5.2 逐步操作 #

1. 连接后端：定义›后端 下拉中选择运行中的实例（角标 `当前` / `切换` / `附加`），或选择 启动 SAP2000 新实例 / 启动 ETABS 新实例。前置：本机已安装对应 CSI 产品；年费版及以上授权。产出：三维模型加载、「结构模型」各计数填充、窗口标题变为「{产品名}{版本}{(PID xxx)} · {模型名或"未命名"}」。
2. 定义模态与质量：定义›模态质量 → 定义模态和质量。前置：已连接后端（未连接时提示 `请先在【定义】页连接 {产品名} 以获取荷载模式。`）。产出：模态工况（模态名称 / 模态数量 / 模态类型）与质量源 tigerkinmass 写入后端。
3. 材料系数（可选）：定义›模态质量 → 材料系数，选择材料并填「弹性模量系数:」（默认 1.0）。前置：已连接；`material_modify` 授权。产出：后端材料弹性模量按系数放大。
4. 荷载配置：定义›荷载 → 荷载配置 → 「荷载管理」窗 新增（或选中条目后 编辑）。前置：已连接；需要「结构基频(Hz):」有效值才能得到频率候选。产出：一条或多条荷载（身份名如 walkload_1.6），并自动保存工作区。
5. 标签指派：定义›指定 → 荷载标签 与 结果标签。前置：已连接（或在三维视图中先选中点 / 板）。产出：加载位置标签集合与结果测点标签集合，且两窗各自变为「已指派」。
6. TMD（可选）：TMD›TMD → TMD 布置，填参数、取挂点坐标后 应用。前置：三维视图已有几何（「从视图拾取」需要）或手工输入坐标。产出：当前 TMD 系统（名称、参数与挂点坐标），Ribbon 摘要变为「{名称} · {N} 挂点」。
7. 发送模型：分析›运行 → 发送模型。前置：已连接；荷载标签非空；质量源与模态工况已定义；`send_model` 授权。产出：后端生成荷载模式、荷载工况、单位力分配与（若已定义）TMD 对象。
8. 模态分析：分析›运行 → 模态分析。前置：已连接；模态工况与质量源非空；模型已保存为文件（SAP2000 .sdb / ETABS .edb）。产出：模态工况计算完成，可读回结构自振频率。
9. 时程计算：分析›运行 → 时程计算。前置：模型已保存（界面强制）。产出：各荷载工况的线性时程分析结果。
10. 获取结果：结果›结果 → 获取结果。前置：已连接；结果标签非空（否则提示 `获取结果前请先指派结果标签。`）；模型已锁定且目标工况已完成。产出：各测点加速度时程，工作流树「结果数」更新。
11. 规范校核：结果›校核 → 行走激励校核 / 有节奏运动校核 / 连廊天桥校核 / 设备振动校核。前置：`result_check` 授权且结果非空（否则提示 `暂无结果数据，请先运行计算并获取结果。`）。产出：各测点峰值与「满足 / 不满足」判定，可导出单项校核简报。
12. 计算书（可选）：结果›报告 → 生成计算书。前置：`calculation_report` 授权；向导中勾选至少一个计算工况与一个提取测点并选择保存路径。产出：.docx 综合计算书（含封面签署、动力特性、荷载工况、时程响应、校核汇总、结论与附录）。

5.3 前置条件状态机 #

5.4 最小完整示例（办公楼楼盖） #

下面给出一次最短可用流程的取值示例，全部使用程序默认值或示例值，可照此对号入座。

6.1 入口与四类荷载总览 #

入口只有一条链路：定义›荷载 → 荷载配置 打开「荷载管理」窗 → 新增（或选中条目后 编辑）打开 荷载配置 — 动力参数与时程工作台。窗口左栏为类型卡片与参数流，中间为可拖拽分隔条，右栏为实时动力学仿真与操作栏。

窗口右栏的「JGJ/T 441-2019 规范设计指引」卡片固定给出两条口径：`行走/连廊采样约束：Δt < 1/(72·f)；设备振动采样约束：Δt < 1/(24·max(f₁, fm))。` 与 `行走激励施加于点；有节奏运动与连廊激励施加于面；设备振动逐台单建工况。`

6.2 全局动力参数 #

分组标题为 全局动力参数 (Global Parameters)，四类荷载共用。

6.3 行走激励 #

入口：定义›荷载 → 荷载配置 → 新增 → 类型卡片选 行走激励 → 分组 行走物理参数。

生成公式（三阶谐波叠加）：

F(t) = P·[0.5·cos(2πft) + 0.2·cos(4πft + π/2) + 0.1·cos(6πft + π/2)]，即 γ = {0.5, 0.2, 0.1}、相位 φ = {0, π/2, π/2}，P 默认 0.7 kN。

采样约束：Δt < 1/(72·f)（式 5.3.4-3，严格小于），此处的 f 取结构自振频率；结构频率未设置（≤0 或非有限）时按荷载频率代入。例如 f = 1.8 Hz 时上限 ≈ 0.0077 s，默认 Δt = 0.005 s 通过。

高密度人群走道：当走道按高密度人群口径取值时，荷载改为单余弦模型，幅值 = P_b(0.28)·r′·ψ(f)（P_b 竖向 0.28 kN/m²），频率仍取走道步频；ψ 按人群激励频率查 表 6-7，等效人群密度 r′ = 10.8·√(ζ·N)/A、N = 0.5A（式 9.2.4）。该路径需要显式给出人群密度与 ψ（缺省即拒绝，避免幅值静默为 0），与单人行走是两条不可混用的公式；荷载配置窗口的「行走物理参数」目前只提供「人体重量(kN):」一项，人群走道口径经 MCP 侧 create_walking_load 的 useCrowdLoad（需同时给 crowdDensity 与 psiVertical）启用。

1. 确认「结构基频(Hz):」为楼盖真实一阶频率（可先跑【定义】→ 初始分析）。
2. 在「激励频率匹配集」中勾选需要生成的频率（可点 全选），右栏曲线随即刷新。
3. 核对右栏 Δt 是否有红色横幅；有则减小「时间步长(s):」。
4. 点主按钮 创建荷载；勾选多个频率时按钮文案变为 批量创建荷载 ({N}个)。

6.4 有节奏运动 #

入口：同一窗口，类型卡片选 有节奏运动 → 分组 节奏运动物理参数。此类荷载施加于面。

生成公式：F(t) = Qp·Σ γᵢ·cos(2πi·ft)（i = 1..3，相位全为 0）。γ 系数与取样系数随节奏类型变化：

采样约束：Δt < 1/(72·f)（式 6.3.4-3），此处的 f 取荷载频率（激励频率本身）；结构频率未设置时同样按荷载频率。

1. 选择「节奏类型:」，Qp 会自动切换到对应规范值（需要时可手工改）。
2. 勾选「激励频率匹配集」中的频率；若改选节奏类型，候选频率会按新的区间重算，需重新确认勾选。
3. 确认右栏曲线与 Δt 横幅正常后点 创建荷载 / 批量创建荷载 ({N}个)。

6.5 连廊与天桥 #

入口：同一窗口，类型卡片选 连廊与天桥 → 分组 连廊与室内天桥物理参数。此类荷载施加于面，并按方向分三种：一阶竖向、二阶竖向、横向。

生成公式：F(t) = P_b·r′·ψ(f)·cos(2πft)（式 9.2.2 单余弦）。其中 P_b 竖向 0.28 / 横向 0.035 kN/m²；等效人群密度 r′ = 10.8·√(ζ·N)/A，N = 0.5A（式 9.2.4，ζ 为阻尼比、A 为面积 m²）。

采样约束：Δt < 1/(72·f)（式 9.3.4-2），f 取结构自振频率；横向（Lateral）时改用第一阶横向自振频率 f_L1（即「横向基频:」填入值）。

1. 选择「桥梁类型:」；若为 Lateral，先填写「横向基频:」（或先由模态分析取得）。
2. 核对「荷载(kN/m²):」与「结构类型:」（后者决定阻尼比缺省）。
3. 填「面积(m²):」或点 读SAP 从后端读取桥面面积。
4. 勾选频率后点主按钮创建；三个方向需要分别创建各自的工况。

6.6 设备振动 #

入口：同一窗口，类型卡片选 设备振动 → 分组 设备台账清单 (每台设备 = 一个工况)，用 ＋ 添加 / 编辑 / 删除 维护台账。设备荷载逐台单建工况、不组合；从设备台账「编辑」进入时类型卡片被锁定为「设备振动」。

生成公式（公式入口）：f_m = n_m/60，P_m = m_m·e_m·(0.105·n_m)²/1000 kN（式 7.2.3，式中 e_m 按 m 代入）。台账摘要行实时显示 `将添加设备：设备·{类型}{序号} {f_m:F2} Hz · P_m={P_m:0.000} kN` 与身份名（如 EquipLoad_24.17_Fan_1）。

采样约束：Δt < 1/(24·max(f₁, f_m))——按每周期 24 个采样点的工程处置（JGJ/T 441 第 7 章未规定积分步长，设备为单频简谐、无高阶谐波），f₁ 取结构自振频率。高转速设备必须下调 Δt：例如 2900 r/min ≈ 48.3 Hz 时上限约 0.00086 s。

1. 点 ＋ 添加，选「设备类型:」与「序号:」（通用设备 会自动切到直输入口）。
2. 选择「荷载入口:」：风机 / 水泵 / 电机可走公式入口（填 m_m、e_m、n_m）；有厂家资料时直接选 厂家直输 P_m/f_m 填幅值与频率。
3. 核对摘要行中的 f_m 与 P_m，必要时下调「时间步长(s):」直到 Δt 横幅消失。
4. 点 添加设备；随后在台账中用 编辑 / 删除 维护（删除确认框文案 `确定要删除设备荷载 "{行显示名}" 吗？`）。

6.7 预览、拦截与创建按钮 #

主按钮（新建）

创建荷载；勾选 ≥2 个频率时显示 批量创建荷载 ({N}个)；设备类型下显示 添加设备

主按钮（编辑）

保存修改，以当前参数原位重建该荷载（主频率变更时先确认再删旧建新）

荷载显示名

`行走 {F2} Hz`、`节奏 {F2} Hz`、`连廊·竖向一阶/竖向二阶/横向 {F2} Hz`、`设备·{风机|水泵|电机|通用}{序号} {F2} Hz`

取消

取消（等同 Esc）

7.1 结构频率从哪来 #

匹配的前提是「已知结构自振频率」。两条来源：

• 【定义】→ 初始分析：运行模态分析后读回各阶频率，把第一阶写入「结构基频(Hz):」，并弹出「选择模态」窗（可勾选需参与播种的模态、拖动「变形比例」预览振型），确认后按当前荷载类型把各阶最大位移节点追加写入标签。
• 手工填写「结构基频(Hz):」（默认 2.0）。

7.2 匹配算法 #

1. 准备结构频率：必须已完成模态分析并读入结构自振频率；没有结构频率就不生成工况。
2. 按谐波阶次求商：对阶次 i = 1、2、3，分别计算 结构频率 / i。
3. 钳入敏感步频区间：把每个商按荷载类型钳入 表 7-1 的区间（低于下限取下限，高于上限取上限）。
4. 去重并升序：钳制后的频率去重（相同频率只保留一个工况），升序排序得到工况频率列表。
5. 命名并创建：按命名规则生成工况名（荷载身份名），勾选后批量创建。

7.3 工况命名规则 #

名称与实际展示是两套口径：列表、图表图例、工作流树使用中文显示名（如「行走 1.60 Hz」），而工况判重与持久化使用身份名（如 walkload_1.6）。同名的荷载不会重复创建——身份名即判重键。

7.4 演算示例 #

匹配集位置

「荷载配置 — 动力参数与时程工作台」左栏，区块标题 激励频率匹配集 (式 5.2.3 / 6.2.3 / 9.2.3):，顶部有 全选 复选框，逐条为 `{频率:F2} Hz` 复选框

前置条件

已读入结构频率（由「初始分析」写入或手工填写「结构基频(Hz):」）；类型为行走 / 有节奏运动 / 连廊与天桥时才会显示该区块

与设备振动的区别

设备振动的频率由转速或厂家资料决定，不参与结构频率匹配，因此该区块在设备类型下不显示

8.1 两类标签的区别 #

程序用两套彼此独立的标签集合：一套描述激励加在哪里（窗口标题 荷载标签，按钮文案 指定荷载标签），另一套描述加速度在哪里取（窗口标题 结果标签，按钮文案 指定结果标签）。两个窗口共用同一套界面，但是两个互相独立的单实例，互不抢焦点。

8.2 从后端选择集读取标签 #

1. 打开窗口：定义›指定 → 荷载标签（或 结果标签），也可双击左侧工作流树「标签管理」下的同名节点。
2. 在后端软件中先选中对象：荷载标签按当前荷载类型读点或读面，结果标签读点。也可在本软件三维视图中点选 / 框选（选择过滤的 点 / 面 复选框要先勾上允许的对象类型）。
3. 点窗内的 从SAP获取（按钮内容显示为 指定荷载标签 / 指定结果标签）或 从视图选区读取，标签即写入列表。
4. 需要手工补充时，在输入框填名称后按回车或点 添加（输入框 ToolTip：`输入新标签名称，回车或点击「添加」`）。
5. 核对列表计数 `共 {0} 项`，关闭窗口。列表标题为 标签列表，右侧有 全选 / 取消全选。

8.3 指派、清除与多选 #

8.4 与发送模型、获取结果的依赖 #

9.1 TMD 参数与派生预览 #

入口：TMD›TMD → TMD 布置（也可双击工作流树「TMD」组节点或「TMD节点标签」）。打开的是非模态编辑器 TMD 定义与挂点；打开它不需要后端连接。

右侧「派生参数（实时）」面板随输入即时刷新，显示：

最优频率比 fopt

TMD 频率与结构频率的最优比

单点质量

同时给出 t 与 kg 两个量纲（坐标行为 0 时显示「单点质量/刚度/阻尼：—（坐标行数为 0，添加坐标行后计算）」）

单点刚度

单位 kN/m

单点阻尼

单位 kNs/m

最优阻尼比

与底部摘要行的「最佳阻尼比」一致

底部摘要行

f_TMD={值} Hz · 最佳阻尼比={值} · 系统刚度={值} kN/m

参数不可解析时

预览整块显示 参数输入有误，无法生成预览。

9.2 挂点坐标与视图拾取 #

9.3 操作步骤 #

1. 定义 TMD：TMD›TMD → TMD 布置，填写名称、质量比、结构参与质量、结构频率、高度与方向，核对右侧派生参数。
2. 指派挂点：先在主窗三维视图中点选 / 框选节点（底部工具条勾上 点），回到编辑器点 从视图拾取；或手工 添加坐标 逐行输入 XYZ（mm）。
3. 应用：点底部 应用，日志记录 `TMD 系统已应用：{Name}（{N} 个挂点坐标）`，工作区随即自动保存；Ribbon 摘要变为「{名称} · {N} 挂点」。
4. 发送至后端：分析›运行 → 发送模型。程序沿设定方向负向偏移「高度」生成质量点，并按 ≤1mm 容差匹配模型节点；未命中或多命中会整体中止发送。
5. 复算并校核减振效果：时程计算 → 获取结果 → 相应校核窗口比对前后峰值（见 9.5）。

9.4 删除 TMD #

入口：TMD›TMD → 删除TMD（未定义 TMD 时该按钮禁用）。删除前弹出确认框，标题 删除 TMD，正文原文：

将删除 TMD 系统「{name}」及其全部 {count} 个挂点坐标，且不影响已发送到目标模型的对象（下次发送时清理）。是否继续？

9.5 减振率与效果评价 #

减振率（Vibration Reduction Ratio，η）定义为：无 TMD 与有 TMD 时提取点峰值加速度的降幅百分比 —— η = (a₀ − a)/a₀ × 100%，其中 a₀ 为无 TMD 原结构峰值加速度，a 为布设 TMD 后的峰值加速度。

10.1 三个执行按钮 #

三个按钮同处 Ribbon 分析›运行 组，从左到右依次是 发送模型、模态分析、时程计算。它们都要求已完成后端连接，且都需要年费版及以上的授权档位。

10.2 发送模型：写入什么 #

1. 连接后端：定义›后端 下拉中选择运行中的实例（点选 = 附加 / 切换），或选 启动 SAP2000 新实例 / 启动 ETABS 新实例。
2. 指派荷载标签：定义›指定›荷载标签。行走激励选点对象，有节奏运动与连廊选面对象。
3. 定义模态与质量源：定义›模态质量›定义模态和质量。
4. （可选）定义 TMD：TMD›TMD›TMD 布置。
5. 点击发送：分析›运行›发送模型。通过只读预检后开始五阶段写入。

只读预检（任一不通过则中止，后端模型保持原样）

预检失败时弹窗标题为 发送预检未通过，日志同步输出全文；仅警告时弹窗标题为 发送预检警告，正文以「以下警告不阻止发送，是否继续？」收束，选择取消即中止发送。

10.3 模态分析 #

点击 模态分析 后依次执行：连接检查 → 模型已保存检查 → 模态工况兜底 → 质量源阻断检查 → 运行分析 → 读回频率并回填结构基频。

同一套核心链路也挂在 Ribbon【定义】页「初始分析」组的 初始分析 按钮上，其说明为「基于已定义质量源运行模态分析，按模态多选播种荷载/结果标签，并在三维视图预览振型变形」——需要一次跑完模态并顺便生成初选工况/测点标签时用它。

10.4 时程计算 #

1. 前置确认：后端已连接、模型已保存（未保存时的确认框与模态分析一致）。
2. TMD 联动确认：模型内存在 TMD 对象时弹出 提示 框：「当前模型存在TMD，请检查【恒载荷载模式】的自重乘数是否设置为0」。确认后按「含 TMD 质量」计算；取消则中止并记录日志 用户中断，当前模型存在TMD，请在{产品名}中设置恒载的自重乘数为0。
3. 点击计算：分析›运行›时程计算，日志先记 正在开始计算...。
4. 查看结果：成功日志 计算完成。；失败日志 计算失败。{原因}；异常日志 计算出错：{消息}。

10.5 长任务期间界面被禁用 #

当外部 Agent 通过 MCP 正在执行长任务（发送模型 / 模态分析 / 时程计算）时，主程序会挂起模型锁并冻结会改动模型的命令，避免两路操作同时写同一个模型。

11.1 获取结果与新鲜度校验 #

入口：结果›结果›获取结果。

成功时日志输出 已从 {产品名} 获取 {N} 条结果。；读取过程自动切换 kN_m_C 单位制并在结束后还原，加速度即 m/s²、时间轴为真实秒，无需人工换算。若此后切换了后端，旧结果会挂出角标 结果来自 {产品名} · 切换后未刷新，直到重新获取。

11.2 「计算结果」窗口分区说明 #

入口：结果›结果›查看分析，窗口标题为 计算结果，页内大标题为 计算结果分析。窗口自上而下分三个区：筛选区、表格区、图表区，底部是导出按钮。

11.3 导出数据（CSV / TXT） #

导出范围是当前筛选后的多测点 × 工况时程，因此先设好筛选条件再导出。两个按钮位于窗口底部：导出 CSV 与 导出 TXT。

荷载时程的 CSV 导出

若需要的是激励荷载本身的时程（而非响应结果），用荷载侧的导出：荷载管理窗工具栏的 导出CSV，或荷载设计区的 导出时程为 CSV。该文件首行为 Time(s),Value，其后逐点两列；另存为对话框标题为 导出 {荷载名} 时程为 CSV，筛选 CSV 文件 (*.csv)|*.csv；未选中荷载时提示 请先选择一个有数据可导出的荷载。。此功能需要年费版授权（功能名「导出CSV」）。

12.1 四类校核总表 #

四个校核窗的入口同在 Ribbon 结果›校核 组。四窗共用同一打开前置：需年费版「舒适度验算」授权，且结果条数不为 0。

12.2 行走激励校核 #

入口：结果›校核›行走激励校核；窗口标题 结果校核（行走激励）。

结果列读法：表格列为 节点标签、荷载工况、峰值加速度 ap（N6）、校核值 (ap*0.5)（N6）、判断结果（绿色 = 满足 / 红色 = 不满足）。判定式为「峰值 × 0.5 ≤ alim」；时间窗内无数据的结果行不会出现在列表中。结论按行给出 满足 / 不满足。

底部按钮：重新校核（按当前输入重算）与 导出校核简报 (Word)（文件名 {工程名}-行走激励校核简报）。

12.3 有节奏运动校核 #

入口：结果›校核›有节奏运动校核；窗口标题 结果校核（有节奏运动）。

等效加速度 a_pm 的合成规则（W^1.5 组合，式 6.3.1）：a_pm = (Σ a_pi^1.5)^(1/1.5)，其中 a_pi 为该测点各阶谐波峰值。逐测点分组计算——先按测点分组、再在组内按各阶（各工况）谐波峰值做 1.5 次幂求和，不跨测点混合求和。判定阻尼比固定 0.06（§6.3.3）。

结果区读法：顶部摘要卡显示 有效加速度 ap (m/s²)（保留 4 位小数，蓝色大字）与 判断结果（绿 / 红），右侧以斜体给出公式 公式: ap = (Σ(a_i^1.5))^(1/1.5)。明细表列为 选择（复选框，默认全选）、构件编号、工况、峰值加速度 a_i (m/s²)。勾选集合即「参与合成的工况集」，勾选变化即时重算；无任何勾选或缺有效数据时结论文本不变写为满足。结论口径为 满足 / 不满足（有效加速度 ≤ 限值）。

底部按钮：重新计算 与 导出校核简报 (Word)（文件名 {工程名}-有节奏运动校核简报）。

12.4 连廊与室内天桥校核 #

入口：结果›校核›连廊天桥校核（按钮文案），窗口标题为 结果校核（连廊与室内天桥）——两者文案不同，勿混写。

结果列读法：列为 测点标签、竖向峰值 a_p (m/s²)、竖向限值（2 位小数）、竖向判定、横向峰值 a_pL (m/s²)、横向限值（2 位小数）、横向判定、总判定。某方向无工况时，该方向的峰值与判定均显示 —；总判定为 满足 表示竖向与横向同时满足；窗口顶部汇总卡的 整体结论显示 满足 / 不满足，无数据时为 无数据。与行走不同，连廊峰值不乘 0.5。

汇总卡右侧的规范注释原文为：JGJ/T 441-2019 第 9 章：竖向 a_p ≤ [a_p]（式 4.1.1-1）、横向 a_pL ≤ [a_pL]（式 4.1.2）；限值取表 4.2.4（封闭连廊/室内天桥 0.15/0.10，不封闭连廊 0.50/0.10 m/s²）。底部按钮为 重新校核 与 导出校核简报 (Word)（文件名 {工程名}-连廊天桥校核简报）。

12.5 设备振动校核 #

入口：结果›校核›设备振动校核；窗口标题 结果校核（设备振动）。

结果列读法：列为 测点标签、设备工况、峰值加速度 ap（6 位小数）、限值 [ap]（3 位小数）、比值 ap/[ap]（3 位小数）、判断结果（绿 = 满足 / 红 = 不满足）。行粒度 = 「测点 × 设备工况」，一台设备一个工况逐工况验算；汇总行给出 控制工况，格式为 控制工况：{测点标签} × {设备工况}（a_p={值} m/s²，比值 {值}，{满足|不满足}），即比值 a_p/[a_p] 最大者；无数据时显示 控制工况：—。峰值不乘 0.5。

模型范围建议：验算本层楼盖竖向振动可仅取本层楼盖模型；验算其他楼层楼盖宜取整体结构模型——模型范围由建模决定，窗口仅作提示。底部按钮为 重新校核 与 导出校核简报 (Word)（文件名 {工程名}-设备振动校核简报）。

13.1 入口与前置条件 #

入口：结果›报告›生成计算书，打开窗口 计算书生成向导（760×660，打开时日志记录 已打开计算书生成向导。）。前置：需年费版「计算书生成」授权；无授权时弹出付费授权提示并中止。

13.2 向导四步 #

1. 工程信息：填写签署表单（工程名称、编号、子工程 / 模型、结构类型、设计阶段、设计依据、编制单位、计算日期、设计人 / 校对人 / 审核人 / 审定人、备注）。
2. 章节选择：用预设按钮（全选 / 推荐配置 / 精简配置）快速勾选，再按需微调十项章节复选框。
3. 工况与测点：左列 计算工况、右列 提取测点，各带一个默认勾选的 全选 复选框。
4. 导出与生成：选择 保存路径：（浏览...），确认是否勾选 生成完成后自动打开文档，点击 开始生成；生成期间可随时 取消生成。

章节页说明文案原文：推荐配置：正文全部章节；未定义 TMD 系统时自动排除 TMD 设计与减振对比章。精简配置：封面、概况、动力特性、时程响应、校核汇总与结论六项。；导出页说明文案原文：点击【开始生成】后将在后台提取模态数据、聚合荷载与时程响应、渲染曲线并装配 Word 文档；期间可随时【取消生成】。

13.3 导出格式、文件名与状态文案 #

13.4 综合计算书与单项校核简报 #

14.1 显示层开关全表 #

六个显示层开关位于 Ribbon 定义›显示 组，从左到右依次为 点标签、面标签、显示支座、显示荷载、显示提取点、显示TMD；紧邻的 三维视图设置 按钮打开外观设置窗（见 14.3）。

其中荷载 / 提取点 / TMD 三层是纯可视化层，不参与拾取，随几何重建自动刷新；六个开关的勾选状态随本机视图设置持久化，断开重连不会重置。

14.2 显示层与对象对应关系 #

14.3 视图设置对话框 #

入口：定义›显示›三维视图设置，按钮说明为「设置三维视图背景色、对象颜色、线宽与点样式（仅保存在本机）」；窗口标题 三维视图设置。

14.4 鼠标手势与视角切换 #

视图底部工具条提供：选择过滤复选框 点（允许点选节点）与 面（允许点选面）；填充 / 线框切换按钮（未勾选显示 填充，勾选显示 线框）；以及视角按钮 顶 / 底 / 前 / 后 / 左 / 右 / 三维 / 透视 / 适窗。视图右上角的相机按钮可在 透视 与 正交 之间切换。

14.5 存储与重置 #

视图设置（背景色、对象颜色、线宽、点样式、坐标系统显示与六个显示层开关）只保存在本机，不随工作区导出 / 导入——这是刻意的设计取舍：外观属本机偏好，避免把个人配色强加给同事，也避免污染工作区数据结构。窗口底部固定说明即写着：设置仅保存在本机，不随工作区导出导入。

15.1 文件菜单四项 #

1. 导入(_I)：打开文件选择，筛选 数据文件 (*.json;*.xml;*.csv)|*.json;*.xml;*.csv|所有文件 (*.*)|*.*。选 .json 走工作区导入；选 .xml / .csv 提示功能未开发；其他格式提示 不支持的文件格式。。工作区已有数据时先弹覆盖确认。
2. 保存工作区(_S)（Ctrl+S）：另存为对话框标题 保存当前工作与设置，筛选 JSON 文件 (*.json)|*.json|所有文件 (*.*)|*.*，默认扩展名 json。保存成功后提示 工作区已导出（该导出不影响自动保存目标）。
3. 重置默认值(_R)：确认后删除本机 settings.json 与 view-settings.json，并把当前会话的全部设置、目标后端、ETABS 路径、切换确认偏好、三维视图外观与六个显示层开关恢复默认。
4. 退出(_X)（Alt+F4）：确认后关闭程序，并在窗口关闭时把工作区写回自动保存目标。

15.2 工作区内容范围

15.3 本机文件位置

15.4 自动保存时机

15.5 导入覆盖风险与备份

导入的现场若来自另一种后端，程序只记一条日志 导入现场来自 {来源}，将按 {当前目标} 语义发送，不会改写当前目标后端，也不弹窗——发送目标仍以「后端」下拉中的当前目标为准。若设置文件损坏或来自更高主版本，程序会自动备份为 settings.corrupt-{时间戳}.json / settings.futureversion-{时间戳}.json 并回落默认设置，同时给出一次性提示。

16.1 MCP 是什么

MCP（Model Context Protocol）是一套通用协议，用来把本程序的专业能力「暴露」给外部 AI Agent。本程序通过标准 MCP 对外开放 31 项工具：外部 Agent 连接后，可以像人一样读取模型状态与结构自振频率、创建四类激励荷载、指派加载位置与结果测点、发送模型并运行分析、读取加速度结果、执行舒适度校核、查询与修改材料，还能检索本程序内置的技能知识。工具名与说明可在桌面端 Ribbon【MCP】页 →「MCP 客户端接入」组 → 工具目录 中按类别浏览。

16.2 运行架构与前置条件

16.3 两种获取接入配置的方式

两种格式的差异：OMP 格式比通用格式多一个 $schema 字段，条目含 "type": "stdio"；--format=claude 的产物是通用 mcpServers 结构，不能直接粘进 OpenCode 的配置文件。

16.4 配置文件放置位置

16.5 连通性自检 --status

配置或启动 Agent 前，可在控制台自检桌面主程序与 CSI 后端状态：TigerkinSCA.exe --status [--pipe=<name>] [--timeout=<秒>]（默认超时 1.5 秒）。在线返回退出码 0，离线返回 1，输出为缩进 JSON，不弹出任何对话框。

16.6 工具目录（31 项）与授权拦截

外部 Agent 的 tools/list 全量返回 31 项工具，其中 29 项可按上述五类在「MCP 完整工具目录」窗口浏览（窗口说明文案：通过标准 Model Context Protocol 向外部通用 Agent（Claude Desktop / OMP）暴露的 29 项专业领域工具；知识工具通过 prompts/tools 另行提供：）。工具目录内 17 项只读 / 知识 / 校核工具、14 项写类工具；目录对调用方全量可见，但每一项的调用权限都按其所属功能键逐项拦截——免费档只有 7 项荷载创建工具可以调用，其余 24 项（含读取与知识工具）在未授权时一律返回 LICENSE_DENIED；授权只取决于档位，与「读 / 写」类别无关。

六篇内置技能以 prompts 形式暴露，正文按需加载；磁盘目录 %APPDATA%\Tgk\SlabComfort\skills 优先、内嵌版本兜底。

18.1 快捷键与手势全表

18.2 错误码全表（十二项）

18.3 规范依据

18.4 术语表

框架（Frame）

从 CSI 后端导入的梁柱线单元，三维视图中以线元绘制。

面（Slab）

楼板壳 / 面单元，三维视图默认以单一漫反射材质绘制（无结果云图着色）。

节点（Point）

CSI 点对象（结构节点），以点精灵绘制。

提取点（Extraction Point）

舒适度结果提取位置的用户标记，独立显示层与符号色，不是节点。

索（Cable） / 链杆（Link）

CSI 索单元与连接单元，均以线元绘制。

显示层（Display Layer）

可独立开关的几何集合（荷载符号 / 提取点 / TMD / 支座 / 标签），由 Ribbon 开关按钮控制。

视图设置（View Settings）

三维视图外观参数（背景色 / 框架色 / 面色 / 线宽 / 点样式），仅存本机，不随工作区导出导入。

计算书（Calculation Report）

楼盖舒适度分析与规范验算的书面交付文档，含工程签署、动力特性、荷载工况、时程结果、规范校核与减振评价，导出为 Word（.docx）。

综合计算书

涵盖结构全部模态动力特性、全部已定义工况、TMD 减振方案及全部提取点规范校核结论的完整工程报审计算书。

单项校核简报

在具体校核窗口（行走 / 有节奏 / 连廊 / 设备）针对当前单一荷载类型一键导出的精简核算报告。

减振率 η

无 TMD 与有 TMD 时提取点峰值加速度降幅百分比：η = (a₀ − a) / a₀ × 100%。

无头图表渲染

不依赖界面控件可视树，在后台内存中以标准尺寸与印刷级分辨率将时程曲线或荷载函数直接绘制并编码为图片的机制。

18.5 版本与环境信息