railwise-darwin-x64 1.2.29

package/bin/skill/pptx/scripts/thumbnail.py

@@ -0,0 +1,289 @@
+"""Create thumbnail grids from PowerPoint presentation slides.
+
+Creates a grid layout of slide thumbnails for quick visual analysis.
+Labels each thumbnail with its XML filename (e.g., slide1.xml).
+Hidden slides are shown with a placeholder pattern.
+
+Usage:
+    python thumbnail.py input.pptx [output_prefix] [--cols N]
+
+Examples:
+    python thumbnail.py presentation.pptx
+    # Creates: thumbnails.jpg
+
+    python thumbnail.py template.pptx grid --cols 4
+    # Creates: grid.jpg (or grid-1.jpg, grid-2.jpg for large decks)
+"""
+
+import argparse
+import subprocess
+import sys
+import tempfile
+import zipfile
+from pathlib import Path
+
+import defusedxml.minidom
+from office.soffice import get_soffice_env
+from PIL import Image, ImageDraw, ImageFont
+
+THUMBNAIL_WIDTH = 300
+CONVERSION_DPI = 100
+MAX_COLS = 6
+DEFAULT_COLS = 3
+JPEG_QUALITY = 95
+GRID_PADDING = 20
+BORDER_WIDTH = 2
+FONT_SIZE_RATIO = 0.10
+LABEL_PADDING_RATIO = 0.4
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Create thumbnail grids from PowerPoint slides."
+    )
+    parser.add_argument("input", help="Input PowerPoint file (.pptx)")
+    parser.add_argument(
+        "output_prefix",
+        nargs="?",
+        default="thumbnails",
+        help="Output prefix for image files (default: thumbnails)",
+    )
+    parser.add_argument(
+        "--cols",
+        type=int,
+        default=DEFAULT_COLS,
+        help=f"Number of columns (default: {DEFAULT_COLS}, max: {MAX_COLS})",
+    )
+
+    args = parser.parse_args()
+
+    cols = min(args.cols, MAX_COLS)
+    if args.cols > MAX_COLS:
+        print(f"Warning: Columns limited to {MAX_COLS}")
+
+    input_path = Path(args.input)
+    if not input_path.exists() or input_path.suffix.lower() != ".pptx":
+        print(f"Error: Invalid PowerPoint file: {args.input}", file=sys.stderr)
+        sys.exit(1)
+
+    output_path = Path(f"{args.output_prefix}.jpg")
+
+    try:
+        slide_info = get_slide_info(input_path)
+
+        with tempfile.TemporaryDirectory() as temp_dir:
+            temp_path = Path(temp_dir)
+            visible_images = convert_to_images(input_path, temp_path)
+
+            if not visible_images and not any(s["hidden"] for s in slide_info):
+                print("Error: No slides found", file=sys.stderr)
+                sys.exit(1)
+
+            slides = build_slide_list(slide_info, visible_images, temp_path)
+
+            grid_files = create_grids(slides, cols, THUMBNAIL_WIDTH, output_path)
+
+            print(f"Created {len(grid_files)} grid(s):")
+            for grid_file in grid_files:
+                print(f"  {grid_file}")
+
+    except Exception as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+def get_slide_info(pptx_path: Path) -> list[dict]:
+    with zipfile.ZipFile(pptx_path, "r") as zf:
+        rels_content = zf.read("ppt/_rels/presentation.xml.rels").decode("utf-8")
+        rels_dom = defusedxml.minidom.parseString(rels_content)
+
+        rid_to_slide = {}
+        for rel in rels_dom.getElementsByTagName("Relationship"):
+            rid = rel.getAttribute("Id")
+            target = rel.getAttribute("Target")
+            rel_type = rel.getAttribute("Type")
+            if "slide" in rel_type and target.startswith("slides/"):
+                rid_to_slide[rid] = target.replace("slides/", "")
+
+        pres_content = zf.read("ppt/presentation.xml").decode("utf-8")
+        pres_dom = defusedxml.minidom.parseString(pres_content)
+
+        slides = []
+        for sld_id in pres_dom.getElementsByTagName("p:sldId"):
+            rid = sld_id.getAttribute("r:id")
+            if rid in rid_to_slide:
+                hidden = sld_id.getAttribute("show") == "0"
+                slides.append({"name": rid_to_slide[rid], "hidden": hidden})
+
+        return slides
+
+
+def build_slide_list(
+    slide_info: list[dict],
+    visible_images: list[Path],
+    temp_dir: Path,
+) -> list[tuple[Path, str]]:
+    if visible_images:
+        with Image.open(visible_images[0]) as img:
+            placeholder_size = img.size
+    else:
+        placeholder_size = (1920, 1080)
+
+    slides = []
+    visible_idx = 0
+
+    for info in slide_info:
+        if info["hidden"]:
+            placeholder_path = temp_dir / f"hidden-{info['name']}.jpg"
+            placeholder_img = create_hidden_placeholder(placeholder_size)
+            placeholder_img.save(placeholder_path, "JPEG")
+            slides.append((placeholder_path, f"{info['name']} (hidden)"))
+        else:
+            if visible_idx < len(visible_images):
+                slides.append((visible_images[visible_idx], info["name"]))
+                visible_idx += 1
+
+    return slides
+
+
+def create_hidden_placeholder(size: tuple[int, int]) -> Image.Image:
+    img = Image.new("RGB", size, color="#F0F0F0")
+    draw = ImageDraw.Draw(img)
+    line_width = max(5, min(size) // 100)
+    draw.line([(0, 0), size], fill="#CCCCCC", width=line_width)
+    draw.line([(size[0], 0), (0, size[1])], fill="#CCCCCC", width=line_width)
+    return img
+
+
+def convert_to_images(pptx_path: Path, temp_dir: Path) -> list[Path]:
+    pdf_path = temp_dir / f"{pptx_path.stem}.pdf"
+
+    result = subprocess.run(
+        [
+            "soffice",
+            "--headless",
+            "--convert-to",
+            "pdf",
+            "--outdir",
+            str(temp_dir),
+            str(pptx_path),
+        ],
+        capture_output=True,
+        text=True,
+        env=get_soffice_env(),
+    )
+    if result.returncode != 0 or not pdf_path.exists():
+        raise RuntimeError("PDF conversion failed")
+
+    result = subprocess.run(
+        [
+            "pdftoppm",
+            "-jpeg",
+            "-r",
+            str(CONVERSION_DPI),
+            str(pdf_path),
+            str(temp_dir / "slide"),
+        ],
+        capture_output=True,
+        text=True,
+    )
+    if result.returncode != 0:
+        raise RuntimeError("Image conversion failed")
+
+    return sorted(temp_dir.glob("slide-*.jpg"))
+
+
+def create_grids(
+    slides: list[tuple[Path, str]],
+    cols: int,
+    width: int,
+    output_path: Path,
+) -> list[str]:
+    max_per_grid = cols * (cols + 1)
+    grid_files = []
+
+    for chunk_idx, start_idx in enumerate(range(0, len(slides), max_per_grid)):
+        end_idx = min(start_idx + max_per_grid, len(slides))
+        chunk_slides = slides[start_idx:end_idx]
+
+        grid = create_grid(chunk_slides, cols, width)
+
+        if len(slides) <= max_per_grid:
+            grid_filename = output_path
+        else:
+            stem = output_path.stem
+            suffix = output_path.suffix
+            grid_filename = output_path.parent / f"{stem}-{chunk_idx + 1}{suffix}"
+
+        grid_filename.parent.mkdir(parents=True, exist_ok=True)
+        grid.save(str(grid_filename), quality=JPEG_QUALITY)
+        grid_files.append(str(grid_filename))
+
+    return grid_files
+
+
+def create_grid(
+    slides: list[tuple[Path, str]],
+    cols: int,
+    width: int,
+) -> Image.Image:
+    font_size = int(width * FONT_SIZE_RATIO)
+    label_padding = int(font_size * LABEL_PADDING_RATIO)
+
+    with Image.open(slides[0][0]) as img:
+        aspect = img.height / img.width
+    height = int(width * aspect)
+
+    rows = (len(slides) + cols - 1) // cols
+    grid_w = cols * width + (cols + 1) * GRID_PADDING
+    grid_h = rows * (height + font_size + label_padding * 2) + (rows + 1) * GRID_PADDING
+
+    grid = Image.new("RGB", (grid_w, grid_h), "white")
+    draw = ImageDraw.Draw(grid)
+
+    try:
+        font = ImageFont.load_default(size=font_size)
+    except Exception:
+        font = ImageFont.load_default()
+
+    for i, (img_path, slide_name) in enumerate(slides):
+        row, col = i // cols, i % cols
+        x = col * width + (col + 1) * GRID_PADDING
+        y_base = (
+            row * (height + font_size + label_padding * 2) + (row + 1) * GRID_PADDING
+        )
+
+        label = slide_name
+        bbox = draw.textbbox((0, 0), label, font=font)
+        text_w = bbox[2] - bbox[0]
+        draw.text(
+            (x + (width - text_w) // 2, y_base + label_padding),
+            label,
+            fill="black",
+            font=font,
+        )
+
+        y_thumbnail = y_base + label_padding + font_size + label_padding
+
+        with Image.open(img_path) as img:
+            img.thumbnail((width, height), Image.Resampling.LANCZOS)
+            w, h = img.size
+            tx = x + (width - w) // 2
+            ty = y_thumbnail + (height - h) // 2
+            grid.paste(img, (tx, ty))
+
+            if BORDER_WIDTH > 0:
+                draw.rectangle(
+                    [
+                        (tx - BORDER_WIDTH, ty - BORDER_WIDTH),
+                        (tx + w + BORDER_WIDTH - 1, ty + h + BORDER_WIDTH - 1),
+                    ],
+                    outline="gray",
+                    width=BORDER_WIDTH,
+                )
+
+    return grid
+
+
+if __name__ == "__main__":
+    main()

package/bin/skill/rail-monitoring-plan/SKILL.md

@@ -0,0 +1,147 @@
+---
+name: rail-monitoring-plan
+description: 轨道交通控制保护区/地保监测方案编制与评审技能。用户提到地铁保护区、控制保护区、监测方案、专家评审、内审、方案重难点、测点/频率/报警值、工作量/报价，或涉及邻近既有线、高架区间、盾构区间、桥下基坑等施工影响时使用。
+license: MIT
+metadata:
+  author: jawewang
+  version: '2.0'
+  domain: 轨道交通监测 / 地铁保护区监护
+---
+
+# 轨道交通控制保护区监测方案编写 Skill
+
+辅助起草、内审、修订、专家评审《XX 工程施工期间轨道交通 X 号线控制保护区监测方案》全流程。
+
+## 何时使用本 Skill
+
+当用户需要执行以下任一任务时启用：
+
+- 接到新项目、**从零开始起草**监测方案（最常见场景）
+- 编制方案前的资料清单准备、立项决策、报价估算
+- 已有初稿，准备**内审会议**或撰写内审纪要
+- 根据**内审意见 / 专家评审意见** 对方案进行修改并撰写回复表
+- 估算监测点数量、监测频率、报警值与停测条件
+- 撰写"监测重难点及应对措施"、"预消警流程"、"应急预案"等核心章节
+- 校验既有方案是否覆盖运营单位（如宁波市轨道交通集团）所要求的全部章节
+
+## 第一步：判断当前所处阶段（必做）
+
+启动 skill 时**先和用户确认所处阶段**，再决定加载哪份 reference。不要盲目跳到模板填空——同一个方案在不同阶段的关注点完全不同。
+
+> **同时确认监测对象类型**：地下盾构区间 / **高架区间** / 车站 / 出入场线。若是高架（含高架区间、出入场线高架段、车辆段引桥），**强制加载** `references/elevated-line.md`，地下场景下的"收敛"项目不适用，应改为"墩柱倾斜"。
+
+| 阶段 | 用户典型表达 | 主用 reference |
+|---|---|---|
+| **0 期 资料收集与立项** | "新接了个项目"、"准备写方案"、"还没拿到全部资料" | `references/phase0-intake.md`（高架时叠加 `references/elevated-line.md` §二资料清单） |
+| **1 期 初稿起草** | "开始写方案"、"重难点不会写"、"工作量怎么算" | `references/phase1-drafting.md` + `references/key-difficulties.md` + `references/scoping-and-pricing.md`（高架时叠加 `references/elevated-line.md` 全文） |
+| **2 期 内审准备** | "明天/下周内审"、"准备内审材料"、"写内审纪要" | `references/phase2-internal-review.md` |
+| **3 期 专家评审与修订** | "送审了"、"专家评审意见回复"、"修改意见" | `references/review-checklist.md` + `references/review-response-template.md` |
+
+> **阶段不清晰时的快速判别**：问用户三个问题——(1) 工筹横道图、勘察报告、安评报告是否已收齐？(2) 方案有没有出过初稿？(3) 内审/专审是否已发生？答 1 否= 0 期；1 是 + 2 否= 1 期；2 是 + 内审已发生 + 专审未发生= 2 期；专审已发生= 3 期。
+
+---
+
+## 各阶段核心动作总览
+
+### 0 期 资料收集与立项决策
+
+详细流程见 `references/phase0-intake.md`，要点：
+
+- **索取资料清单**：用规范化清单一次性问全（避免反复来回），含工程类、勘察类、轨道类、评估类、合同类五大块
+- **监测等级判定**：按工程类型 × 影响范围 × 风险等级三轴决策表确定 一/二/三级
+- **模板选择**：运营线路 → 模板 A（16 章）；建设期线路 → 模板 B（11–14 章）
+- **报价快算**：用 `references/scoping-and-pricing.md` 的公式预估测点、监测次数、人工费
+
+### 1 期 初稿起草
+
+详细流程见 `references/phase1-drafting.md`，建议**起草顺序**（**不要从第 1 章顺写**）：
+
+1. 先写 **3.1 监测范围** 与 **3.4 监测频率分阶段表**——这两节锚定整份方案
+2. 再回填 **1.5 施工筹划**（从工筹横道图提取阶段）
+3. 写 **5 章 监测点布设** + **3.5 工作量预估**（数量算清楚）
+4. **2.3 监测重难点及应对措施**——单独花时间，按 `references/key-difficulties.md` 的"诊断→推演→生成"工作流写
+5. **11 章 报警值与预消警**——引用安评报告进行项目化裁剪
+6. 最后回填 1.1–1.4（工程概况类）、4 章控制网、6 章监测方法（这些可大段复用）
+7. 附图清单先列文字描述，定稿前再补图
+
+**关键纪律**：每节起草前问自己"这一节本项目和上一项目相比有什么不一样？"如果答不上来，就是要么资料没吃透，要么这一节没必要写得那么详细。
+
+### 2 期 内审准备
+
+详细流程见 `references/phase2-internal-review.md`，要点：
+
+- **送审前 3 天**：用 `references/review-checklist.md` 自查；用 `phase2-internal-review.md` 的"内审预演问题表"自问 20 个问题
+- **会议组织**：议程模板、参会人员清单（部门技术负责人、项目经理、技术总工）
+- **内审纪要回填**：用 `references/review-response-template.md` 的内审版样式逐条落实
+
+### 3 期 专家评审与修订
+
+延续现有 checklist 与回复模板：
+
+- 送审材料组卷：方案正式版 + 内审意见回复 + 附图册 + 安评报告 + 施工方案摘要
+- 高频意见对照：`references/review-checklist.md` 内"评审会议典型修改意见汇总"
+- 回复表撰写：`references/review-response-template.md`，每条**必须**注明对应页码
+
+---
+
+## 两类方案模板（择一使用）
+
+阅读本 skill 时务必先弄清楚用户场景属于哪一类。两类模板章节顺序和数量差异较大：
+
+### 模板 A：运营分公司标准格式（**16 章**，重型，强制用于运营线路）
+适用于既有运营线路（如宁波 1/2/3/6/7/8 号线已开通段）受外部施工影响时的方案。**必须**包含运营分公司要求的"轨行区作业管理""数据保密""与工程相关单位的配合"等章节。完整目录见 `references/toc-template-A.md`。
+
+### 模板 B：设计院精简格式（**11–14 章**，轻型，适用于建设期线路）
+适用于建设期/未运营线路、或工程量较小、由设计院出具的方案。完整目录见 `references/toc-template-B.md`。
+
+> 默认按 **模板 A** 起草。如用户明确为建设期线路或要求简版，再切换到模板 B。
+
+---
+
+## 出稿后通用质量保障要点
+
+- **章节编号与目录完全一致**，避免出现"3.2 → 3.4（跳号）"
+- **图表必须有编号和题注**（图 X.X-1 XXX 示意图）
+- **报警值表必须分项目、分阶段、分类型**——预警/报警/控制三栏不可合并
+- **每个施工阶段的监测频率表都必须独立成表**（参考 6 号线望春桥方案，五个阶段五张表）
+- **平面控制网与高程控制网必须分别给"基准点 / 工作基点 / 监测点"三级**
+- **应急组织机构必须列出"地保办—地保车间—监测单位—施工方"四级**
+
+## 输出格式建议
+
+- 默认输出 **Markdown** (`.md`)，便于版本控制与后续转换
+- 用户明确要 Word 文档时，先用 markdown 起稿，再通过 `pandoc` 转 `.docx`
+- 附图先用文字描述位置（"详见图 5.1-1"），不强行插入图片
+- 中文标点全部使用中文全角符号，规范名称用书名号《》
+
+## 参考资源清单
+
+### 阶段流程类
+- `references/phase0-intake.md` — **0 期** 资料收集 / 立项决策 / 监测等级判定 / 模板选择
+- `references/phase1-drafting.md` — **1 期** 初稿起草顺序 + 每节"无中生有"的写法
+- `references/phase2-internal-review.md` — **2 期** 内审准备 / 会议组织 / 纪要回填
+- `references/review-checklist.md` — **3 期** 评审高频意见自检清单
+- `references/review-response-template.md` — **3 期** 内审/专审回复表格式
+
+### 技术资料库
+- `references/toc-template-A.md` — 模板 A（16 章）详细目录
+- `references/toc-template-B.md` — 模板 B（11–14 章）详细目录
+- `references/technical-standards.md` — 规范清单、报警值、仪器精度、监测频率标准库（**地下默认**，含高架补丁表）
+- **`references/elevated-line.md` — 高架专题：监测项目/精度/测点/控制网/频率/报警值/重难点/章节定制清单（高架场景必加载）**
+- `references/key-difficulties.md` — **重难点章节"诊断→推演→生成"工作流**（含 G. 高架工况）
+- `references/scoping-and-pricing.md` — 测点数量、监测工作量、报价快速估算
+
+### 输出资产
+- `assets/plan-template.md` — 完整方案 Markdown 模板（直接复用）
+
+## 示例：典型工况快速选择
+
+| 工况 | 必备监测项目 | 关键关注 |
+|---|---|---|
+| **基坑开挖**（紧邻既有线） | 沉降、水平位移、收敛、巡视；基坑围护抽测 | 开挖至坑底/换撑/拆撑阶段加密 |
+| **顶管/盾构下穿** | 沉降、水平位移、收敛、静力水准（自动化） | 顶进至轴线/注浆置换/嵌缝阶段最敏感 |
+| **管廊上跨** | 沉降、水平位移、收敛 | 卸土回弹与重车荷载分别加密 |
+| **桥梁迁建** | 沉降、水平位移、收敛、振动 | 钢板桩打拔、桥桩施工、桥下通道开挖阶段 |
+| **临近建筑施工** | 沉降、水平位移、巡视 | 重载车辆停放位置补充说明 |
+| **盾构区间施工**（建设期） | 沉降、水平位移、收敛、振动、轨道几何 | 按工筹分阶段制定频率表 |
+| **高架区间 / 出入场线**（桥梁还建、桥下基坑、管廊上跨、邻近桥桩） | 沉降（墩顶/墩底/盖梁/梁端）、水平位移、**桥墩倾斜**、巡视 | **不写"收敛"**；辅桥道床状态前置调查；首级控制点设桥外；登高+接触网约束；详 `references/elevated-line.md` |