railwise-ai 1.2.32 → 1.2.34

package/agent-pack/assets/skill/cad-bim-review/SKILL.md

@@ -0,0 +1,84 @@
+# CAD/BIM 质检 Skill
+
+## 适用对象
+
+- `cad2bim_job`
+- 关联 CAD/GIS/BIM 转换任务的 `project`
+
+不适用于直接生成新的 IFC、XKT、GLB 或绕过转换器创建模型。
+
+## OS Native 输入
+
+优先读取：
+
+1. `input/locked-facts.json`
+2. `input/locked-cad-bim-facts.json`
+3. `input/context-pack.json`
+4. `input/cad-bim-context.json`
+5. `input/capability-blueprint.json`
+
+上传文件、转换日志、readiness、manifest、mapping、scene、模型产物和错误堆栈均以 locked 文件为准。
+
+## 数据源优先级
+
+1. CAD2BIM 任务状态、转换日志、错误堆栈。
+2. readiness、文件执行计划、图层规格和源文件审查。
+3. manifest、mapping、scene、semantic model、模型产物。
+4. 用户补充的坐标系、单位、楼层、专业类型。
+
+## 追问策略
+
+缺坐标系时询问：CGCS2000、本地坐标、未知需人工确认。
+
+缺单位时询问：米、毫米、图纸未标注。
+
+缺专业类型时询问：隧道、基坑、桥梁、管廊、综合。
+
+转换失败时询问：补 DXF、补图层说明、补构件映射、仅生成失败诊断。
+
+## 输出 JSON Schema
+
+```json
+{
+  "summary": "string",
+  "failureReason": "string",
+  "qualityFindings": [
+    {
+      "item": "string",
+      "status": "passed|warning|failed|missing",
+      "sourceRefs": ["string"],
+      "fix": "string"
+    }
+  ],
+  "inputChecklist": ["string"],
+  "artifactInventory": ["string"],
+  "missingInputs": ["string"]
+}
+```
+
+## 禁止事项
+
+- 不得假装生成不存在的 IFC、XKT、GLB、scene 或 manifest。
+- 不得把转换失败任务写成成功。
+- 不得忽略坐标系、单位、图层语义缺失。
+- 不得把源图纸问题归咎于用户个人。
+
+## 报告模板
+
+```markdown
+## 转换任务概况
+
+## 输入文件与 readiness
+
+## 转换失败/质量问题
+
+## 模型产物和语义完整性
+
+## 补救建议
+```
+
+## 示例
+
+输入：`cad2bim.job.diagnose`，locked facts 有 error stack 且无 GLB。
+
+输出：解释失败原因和补救清单，明确“未生成 GLB”。

package/agent-pack/assets/skill/canvas-design/SKILL.md

@@ -0,0 +1,141 @@
+---
+name: canvas-design
+description: 工程图表与可视化设计技能。当需要生成监测趋势图、断面剖面图、测点分布示意图或其他工程可视化图表时加载此技能。
+---
+
+## 适用场景
+
+- 监测时序趋势折线图（沉降、位移、轴力随时间变化）
+- 基坑断面剖面示意图
+- 测点布置示意图
+- 多测点对比柱状图
+- 预警等级分布饼图/环形图
+- 报告中需要插入的任何工程图表
+
+## 可用工具
+
+### `chart_generator`（SVG 趋势图生成）
+
+系统内置的图表工具，专为监测时序数据设计。
+
+参数说明：
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| `data` | 数组 | 时序数据，每条含 point_id/date/value |
+| `title` | 字符串 | 图表标题 |
+| `alertThreshold` | 数字 | 报警阈值，显示为红色水平虚线 |
+| `outputPath` | 字符串 | SVG 输出路径 |
+
+输出：800×400px SVG 文件，含多测点折线、图例、网格线和报警线。
+
+## 图表设计规范
+
+### 配色方案
+
+趋势图使用以下 10 色系列区分不同测点：
+
+```
+#2563eb  蓝色（第1条线）
+#dc2626  红色（第2条线）
+#16a34a  绿色（第3条线）
+#ca8a04  黄色（第4条线）
+#9333ea  紫色（第5条线）
+#0891b2  青色（第6条线）
+#e11d48  玫红色（第7条线）
+#65a30d  黄绿色（第8条线）
+#c026d3  品红色（第9条线）
+#ea580c  橙色（第10条线）
+```
+
+报警线固定为：`#dc2626` 红色虚线（stroke-dasharray: 6,4）
+
+### 坐标轴规范
+
+| 元素 | 规范 |
+|------|------|
+| X 轴 | 日期或期次编号，间隔显示避免重叠（超过10个日期时旋转45°） |
+| Y 轴 | 监测值，单位标注在轴标题中（如"累计变化量 (mm)"） |
+| 网格线 | 浅灰色（`#e5e7eb`），水平网格线为主 |
+| 刻度 | 自动计算合理间距，避免小数位过多 |
+
+### 图表标题规范
+
+格式：`[监测项目] + [时间范围/描述]`
+
+示例：
+- 地表沉降监测趋势图（2025年1月-3月）
+- DB-01~DB-05 累计沉降量变化曲线
+- 第三道支撑轴力监测趋势图
+- 深层水平位移剖面图（CX-02，第15期）
+
+### 图例
+
+- 位置：图表上方或右侧，不遮挡数据区域
+- 格式：线段颜色 + 测点编号
+- 当测点超过 6 个时，分两行显示
+
+## 典型图表场景
+
+### 沉降趋势图
+
+```
+调用 chart_generator，传入：
+data: [
+  { point_id: "DB-01", date: "2025-01-15", value: -2.3 },
+  { point_id: "DB-01", date: "2025-01-22", value: -4.1 },
+  ...
+  { point_id: "DB-02", date: "2025-01-15", value: -1.8 },
+  ...
+]
+title: "地表沉降监测趋势图"
+alertThreshold: -30
+outputPath: "./沉降趋势图.svg"
+```
+
+注意：沉降值通常为负数（向下为正），图表 Y 轴应体现方向性。
+
+### 多期对比（需自行构造 SVG）
+
+当 `chart_generator` 不满足需求时（如需要柱状图、剖面图），可直接编写 SVG 代码：
+
+```svg
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 400">
+  <!-- 标题 -->
+  <text x="400" y="30" text-anchor="middle" font-size="16" font-weight="600">图表标题</text>
+  <!-- 坐标系 -->
+  <!-- 数据绑定 -->
+</svg>
+```
+
+手写 SVG 时遵循以下规范：
+- viewBox 统一为 `0 0 800 400`（与 chart_generator 一致）
+- 字体使用 `font-family="PingFang SC, Microsoft YaHei, sans-serif"`
+- 数值文字使用 `font-variant-numeric: tabular-nums`
+
+### 测斜仪深层位移剖面图
+
+这类图表 `chart_generator` 不直接支持，需构造 SVG：
+
+```
+X 轴：位移量（mm），正方向为远离基坑方向
+Y 轴：深度（m），从上到下递增（地面在顶部）
+数据线：各期位移剖面，用不同颜色区分
+标注：管口标高、地面标高、支撑位置（水平虚线标注）
+```
+
+## 报告中使用图表的规范
+
+1. 每张图必须有图号和图名：`图 X-X [图名]`
+2. 图表下方注明数据来源期次和日期
+3. SVG 输出后告知用户文件路径，用户可在 Word 中手动插入
+4. 一份日报通常包含 1-2 张趋势图，月报/总结报告包含 5-10 张
+5. 图表与正文分析必须对应——图中标注的异常点在正文中必须有解释
+
+## 注意事项
+
+- `chart_generator` 输出纯 SVG 文件，可在浏览器直接打开预览
+- SVG 可无损缩放，适合打印；建议在报告中以 50%-75% 宽度插入
+- 超过 10 条测点线时图表会变得拥挤，建议分组出图（如按断面分）
+- 时序数据日期跨度超过 6 个月时，X 轴建议按月显示而非按日
+- 颜色选择需考虑黑白打印场景——重要的报警线使用虚线+标签双重标识

package/agent-pack/assets/skill/construction-monitoring/SKILL.md

@@ -0,0 +1,89 @@
+# 建设期监测 AI Native Skill
+
+## 适用对象
+
+- `construction_project`
+- 建设期监测类 `project`
+- `auto_monitor_project`
+- 建设期监测 `report_draft`
+
+不适用于地保控制保护区专项高频报表；地保使用 `di-bao-monitoring`。
+
+## OS Native 输入
+
+优先读取：
+
+1. `input/locked-facts.json`
+2. `input/locked-construction-monitoring-facts.json`
+3. `input/context-pack.json`
+4. `input/construction-monitoring-context.json`
+5. `input/capability-blueprint.json`
+
+项目、测点、自动化监测值、阈值、预警、报告草稿、处置记录和现场资料均以 locked 文件为准。
+
+## 数据源优先级
+
+1. OS 建设期项目、监测对象、测点和阈值。
+2. OS 已入库监测成果、预警、质量门禁和处置记录。
+3. 报告中心日报、周报、月报、阶段报告、总结报告。
+4. 用户补充的施工工况、现场照片、评审意见。
+
+## 追问策略
+
+缺报表周期时询问：日报、周报、月报、阶段报告、自定义。
+
+缺工况说明时询问：继续生成待补工况说明、上传现场记录、从项目日志提取。
+
+缺预警处置时询问：生成待确认处置建议、补充处置记录、仅生成预警解释。
+
+## 输出 JSON Schema
+
+```json
+{
+  "summary": "string",
+  "projectSummary": "string",
+  "riskExplanation": [
+    {
+      "risk": "string",
+      "sourceRefs": ["string"],
+      "recommendation": "string"
+    }
+  ],
+  "reportSections": [
+    {
+      "sectionKey": "string",
+      "title": "string",
+      "body": "string",
+      "sourceRefs": ["string"]
+    }
+  ],
+  "missingInputs": ["string"]
+}
+```
+
+## 禁止事项
+
+- 不得改写监测值、预警等级、阈值、测点数量或报告周期。
+- 不得把未复核数据写成正式结论。
+- 不得混淆地保保护区和一般建设期监测口径。
+- 不得生成不存在的评审意见或现场照片。
+
+## 报告模板
+
+```markdown
+## 项目与监测概况
+
+## 本周期监测数据
+
+## 预警和风险解释
+
+## 工况与处置建议
+
+## 结论和待补资料
+```
+
+## 示例
+
+输入：`construction.alert.explain`，locked facts 有 2 条预警和 1 份处置记录。
+
+输出：逐条解释预警，引用 locked facts 中的预警 ID 和处置记录。

package/agent-pack/assets/skill/customer-portal-brief/SKILL.md

@@ -0,0 +1,121 @@
+# 客户门户简报 Skill
+
+## 适用对象
+
+- `customer_portal`
+- `customer_project`
+
+用于客户门户项目中心，为客户可见的授权项目生成项目简报、预警解释和交付物摘要。
+
+## 不适用对象
+
+- 不适用于内部经营、成本、利润、绩效、审批和回款催收分析。
+- 不适用于客户未授权项目、未发布报告、未验收结论或内部风险复盘。
+- 不适用于替代正式监测报告、预警通知单、安全评估或消警审批。
+- 不适用于从聊天记录或外部资料推断客户无权查看的信息。
+
+## OS Native 输入
+
+运行时必须优先读取：
+
+- `input/object-ref.json`
+- `input/actor-context.json`
+- `input/permission-scope.json`
+- `input/context-pack.json`
+- `input/locked-facts.json`
+- `input/capability-blueprint.json`
+- `input/customer-portal-context.json`
+- `input/locked-customer-portal-facts.json`
+- `input/customer-portal-blueprint.json`
+- `input/skill-context.md`
+
+客户可见项目、报告、预警、资料和最新数据均以 locked facts 为准。
+
+## 数据源优先级
+
+1. RAILWISE-OS `locked-customer-portal-facts.json`。
+2. RAILWISE-OS `locked-facts.json`。
+3. 用户在引导面板选择的项目、周期、输出深度。
+4. 不允许输出客户未授权项目或内部管理信息。
+
+## locked 数据边界
+
+- AI 不得修改客户授权范围、项目状态、预警数、报告数、资料数和监测数据。
+- AI 可以把内部事实改写成客户可读说明，但不得泄露内部审批、成本、人员隐私或未发布结论。
+- 若客户绑定为空，必须提示无授权项目，而不是生成泛化简报。
+
+## 追问策略
+
+当信息不足时，优先追问选择题：
+
+- 项目范围：当前项目 / 全部授权项目。
+- 输出：项目简报 / 预警解释 / 交付物摘要。
+- 语气：客户汇报 / 内部复核 / 风险沟通。
+- 周期：本月 / 本季度 / 自定义。
+
+## 输出 JSON Schema
+
+写入 `output/result.json`：
+
+```json
+{
+  "result": {
+    "summary": "string",
+    "findings": ["string"],
+    "risks": [
+      {
+        "title": "string",
+        "severity": "low|medium|high",
+        "sourceRefs": ["string"]
+      }
+    ],
+    "recommendedActions": ["string"],
+    "missingInputs": ["string"]
+  }
+}
+```
+
+同时写入 `output/summary.md`。
+
+## 禁止事项
+
+- 禁止输出客户无权查看的项目、报告、预警或文件。
+- 禁止披露内部成本、利润、审批意见、员工隐私和未确认责任归因。
+- 禁止夸大风险或给出未经工程师确认的安全结论。
+- 禁止把 AI 简报作为正式报告发布，必须经过人工验收。
+
+## 模板
+
+### 客户项目简报
+
+- 项目：`{projectName}`。
+- 当前状态：`{status}`。
+- 监测概况：`{pointCount}` 个测点，`{reportCount}` 份报告。
+- 预警：`{pendingAlertCount}` 条待处置。
+- 后续：`{nextCommunication}`。
+
+### 交付物摘要
+
+- 报告：`{reportName}`，版本 `{version}`，状态 `{status}`。
+- 资料：`{fileName}`，类型 `{fileType}`。
+- 缺口：`{missingItem}`。
+
+## 示例
+
+```json
+{
+  "result": {
+    "summary": "当前授权项目共 2 个，均处于监测中，最近报告和资料已同步到客户门户。",
+    "findings": ["A 项目有 1 条待处置预警，已保留处置进展说明。"],
+    "risks": [
+      {
+        "title": "待处置预警需要客户关注",
+        "severity": "medium",
+        "sourceRefs": ["locked-customer-portal-facts.json.assetsByProject.0.alerts"]
+      }
+    ],
+    "recommendedActions": ["由项目工程师确认处置状态后更新客户门户。"],
+    "missingInputs": []
+  }
+}
+```

package/agent-pack/assets/skill/data-analysis/SKILL.md

@@ -0,0 +1,79 @@
+---
+name: data-analysis
+description: 测绘数据平差与变形分析专业技能包。当处理控制网平差、变形趋势分析或数据异常判断时加载此技能。
+---
+
+## 适用场景
+
+- 水准网、导线网平差计算流程指导
+- 地铁结构长期变形时序数据分析
+- 自动化监测数据清洗与趋势判读
+- 变形速率计算与收敛性判断
+
+## 平差计算标准流程
+
+### 水准网平差
+
+1. 数据检查：核对测段数量与检定书中路线设计一致
+2. 闭合差计算：调用 `check_leveling_closure` 工具，严禁口算
+3. 权的确定：按测段长度定权（$p_i = C / L_i$，C 为常数）
+4. 法方程建立：$N_{bb} \hat{x} = W$
+5. 求解平差值：$\hat{x} = N_{bb}^{-1} W$
+6. 精度评定：单位权中误差 $\hat{\sigma}_0 = \sqrt{V^T P V / (n-t)}$
+7. 点位精度：$\sigma_i = \hat{\sigma}_0 \sqrt{Q_{ii}}$（$Q_{ii}$ 为协因数阵对角元素）
+
+### 导线网平差
+
+1. 角度闭合差检核：调用 `check_traverse_angular` 工具
+2. 坐标闭合差计算：$f_x$, $f_y$
+3. 全长相对闭合差：$f_s / \Sigma s$（四等导线≤1/40000）
+4. 近似坐标计算 → 法方程建立 → 严密平差
+
+## 变形分析方法论
+
+### 单测次数据处理
+
+| 步骤 | 方法 | 判断标准 |
+|-----|------|---------|
+| 粗差检验 | 莱特准则（$3\sigma$）或格拉布斯准则 | $|v_i| > 3\sigma$ 为粗差 |
+| 系统误差 | 对比不同时段仪器的读数漂移规律 | 趋势线斜率持续单向 |
+| 相关性验证 | 相邻测点变形是否呈连续分布 | 孤立异常点须重测确认 |
+
+### 时序数据趋势分析
+
+- **线性趋势**：$y = kt + b$，$k$ 为变形速率（mm/d）
+- **指数衰减**：$y = A \cdot e^{-\lambda t} + C$（适用于固结沉降后期）
+- **拐点识别**：当速率 $k_n > 1.5 \times \bar{k}_{前期}$ 时，判定为加速阶段，触发预警
+
+### 收敛性判断标准
+
+满足以下条件可判定变形趋于稳定：
+- 连续30天日变化量 ≤ 0.1mm
+- 速率曲线斜率接近0（|k| < 0.05mm/d）
+- 累计变化量达到渐近线（拟合误差 < 5%）
+
+## 预警分级体系
+
+```
+绿色（正常）：累计变化量 < 控制值70%，速率 < 1mm/d
+黄色（提示）：累计变化量 70%~85%，速率 1~2mm/d
+橙色（预警）：累计变化量 85%~100%，速率 2~3mm/d
+红色（报警）：累计变化量 ≥ 控制值100%，或速率 > 3mm/d
+```
+
+## CSV 数据处理规范
+
+- **禁止**：将原始 CSV 文件内容直接塞给 LLM 分析
+- **正确做法**：调用 `analyze_monitoring_csv` 工具处理，获取浓缩 JSON 后再解读
+- 工具会自动执行：MAD 粗差剔除 → 核心指标计算 → 超限标记
+- AI 的职责是：基于工具返回的结果，给出**工程判断和结论建议**
+
+## 报告数据呈现规范
+
+| 要求 | 说明 |
+|-----|------|
+| 有效数字 | 变化量保留至小数点后1位（mm），速率保留2位 |
+| 表格形式 | 所有测点数据必须表格呈现，禁止列举 |
+| 单位统一 | 全文统一使用 mm，不与 m 混用 |
+| 超限标注 | 超限数据使用 **加粗** + ⚠️ 标注 |
+| 基准说明 | 明确注明基准期及基准值获取方式 |