@gangvy/claude-code-measurement-marker-check 0.1.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "measurement-marker-check",
+  "description": "P0 renovation measurement drawing marker check skill for Claude Code. Upload a measurement image, identify missing annotations, and produce a review checklist.",
+  "version": "0.1.0",
+  "author": {
+    "name": "nkkj-BrainHack"
+  }
+}

package/README.md

@@ -0,0 +1,46 @@
+# Claude Code Measurement Marker Check
+
+实战二独立技能包：装修量尺图缺标记检查。
+
+P0 小闭环：
+
+1. 用户上传一张量尺图、手绘量尺单、户型草图或现场测量截图。
+2. Claude Code 先观察图片，提取已标记内容、疑似缺标位置和模糊待确认区域。
+3. 本地工具把结构化观察转成稳定报告：缺标记清单、风险说明、图像依据、人工复核建议。
+
+## 用户入口话术
+
+```text
+帮我检查这张装修量尺图有没有哪里未标记。
+重点看空间名称、门窗洞口、长宽高、管道/插座/烟道和现场限制备注。
+先给我缺标记清单和人工复核建议。
+```
+
+## 本地验证
+
+```bash
+npm --prefix claude-code-measurement-marker-check run measure:sample
+npm --prefix claude-code-measurement-marker-check run smoke
+```
+
+## Claude Code 加载
+
+```bash
+claude --plugin-dir ./claude-code-measurement-marker-check
+```
+
+进入 Claude Code 后可直接调用：
+
+```text
+/measurement-marker-check:measurement-marker-check
+```
+
+## 参考实现
+
+参考项目 `E:\ltc-pobingfeng` 中的图片识别调用方式：
+
+- `src/modules/owner/nav/consultation/menchuang-agent/image-analysis.service.ts`
+- `src/modules/owner/nav/consultation/menchuang-agent/window-recognition.service.ts`
+- `AI模型导入与使用文档.md`
+
+核心模式是 `completionJSON` 结构化输出，并通过 `vision: true` 和 `images: [imageUrl]` 传入图片。当前独立技能 P0 优先利用 Claude Code 的上传图片视觉能力完成观察，再用本地工具固化报告。

package/bin/claude-measure-marker.js

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const ROOT = path.resolve(__dirname, '..');
+const DEFAULT_TARGET = path.join(os.homedir(), '.claude', 'plugins', 'measurement-marker-check');
+const COPY_ENTRIES = [
+  '.claude-plugin',
+  'README.md',
+  'scripts',
+  'skill-package-manifest.json',
+  'skills',
+  'tools',
+  'package.json'
+];
+
+function parseArgs(argv) {
+  const args = { command: argv[0] || 'help', target: DEFAULT_TARGET, smoke: false };
+  for (let i = 1; i < argv.length; i++) {
+    const token = argv[i];
+    if (token === '--target' && argv[i + 1]) {
+      args.target = path.resolve(argv[++i]);
+    } else if (token === '--smoke') {
+      args.smoke = true;
+    }
+  }
+  return args;
+}
+
+function printHelp() {
+  console.log([
+    'Claude 量尺图缺标记技能包安装工具',
+    '',
+    'Usage:',
+    '  claude-measure-marker install [--target <dir>] [--smoke]',
+    '  claude-measure-marker check',
+    '  claude-measure-marker smoke',
+    '  claude-measure-marker path',
+    '',
+    'Examples:',
+    '  npx @gangvy/claude-code-measurement-marker-check install',
+    '  claude --plugin-dir "%USERPROFILE%\\.claude\\plugins\\measurement-marker-check"'
+  ].join('\n'));
+}
+
+function removeTarget(target) {
+  if (!target.includes(path.join(os.homedir(), '.claude', 'plugins')) && fs.existsSync(target)) {
+    throw new Error(`Refusing to overwrite non-Claude plugin directory: ${target}`);
+  }
+  fs.rmSync(target, { recursive: true, force: true });
+}
+
+function copyPlugin(target) {
+  removeTarget(target);
+  fs.mkdirSync(target, { recursive: true });
+
+  for (const entry of COPY_ENTRIES) {
+    const source = path.join(ROOT, entry);
+    if (!fs.existsSync(source)) continue;
+    const destination = path.join(target, entry);
+    fs.cpSync(source, destination, { recursive: true });
+  }
+}
+
+function checkPlugin(target) {
+  const required = [
+    '.claude-plugin/plugin.json',
+    'skills/measurement-marker-check/SKILL.md',
+    'tools/measurement-marker-check-run.js',
+    'package.json'
+  ];
+
+  const missing = required.filter(entry => !fs.existsSync(path.join(target, entry)));
+  if (missing.length) {
+    throw new Error(`安装目录缺少文件：${missing.join(', ')}`);
+  }
+
+  return {
+    status: 'ok',
+    target,
+    required
+  };
+}
+
+function runSmoke(target) {
+  const result = spawnSync(process.execPath, ['scripts/smoke.js'], {
+    cwd: target,
+    stdio: 'inherit',
+    shell: false
+  });
+  if (result.status !== 0) {
+    throw new Error('smoke failed');
+  }
+}
+
+function printNextSteps(target) {
+  console.log('');
+  console.log('安装完成。下一步：');
+  console.log(`  claude --plugin-dir "${target}"`);
+  console.log('');
+  console.log('进入 Claude Code 后可说：');
+  console.log('  帮我检查这张装修量尺图有没有哪里未标记。');
+}
+
+function main() {
+  const args = parseArgs(process.argv.slice(2));
+
+  if (args.command === 'help' || args.command === '--help' || args.command === '-h') {
+    printHelp();
+    return;
+  }
+
+  if (args.command === 'path') {
+    console.log(args.target);
+    return;
+  }
+
+  if (args.command === 'install') {
+    copyPlugin(args.target);
+    const check = checkPlugin(args.target);
+    console.log(JSON.stringify(check, null, 2));
+    if (args.smoke) runSmoke(args.target);
+    printNextSteps(args.target);
+    return;
+  }
+
+  if (args.command === 'check') {
+    console.log(JSON.stringify(checkPlugin(args.target), null, 2));
+    return;
+  }
+
+  if (args.command === 'smoke') {
+    runSmoke(ROOT);
+    return;
+  }
+
+  printHelp();
+  process.exitCode = 1;
+}
+
+try {
+  main();
+} catch (error) {
+  console.error(`claude-measure-marker 执行失败：${error.message}`);
+  process.exit(1);
+}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@gangvy/claude-code-measurement-marker-check",
+  "version": "0.1.0",
+  "description": "Claude Code skill for P0 renovation measurement drawing missing-marker checks.",
+  "type": "commonjs",
+  "bin": {
+    "claude-measure-marker": "bin/claude-measure-marker.js"
+  },
+  "scripts": {
+    "measure:sample": "node tools/measurement-marker-check-run.js --sample --output ../outputs/claude-code-measurement-marker-sample --result-prefix MEASURE_MARKER_RESULT",
+    "smoke": "node scripts/smoke.js"
+  },
+  "files": [
+    ".claude-plugin/",
+    "bin/",
+    "README.md",
+    "scripts/",
+    "skill-package-manifest.json",
+    "skills/",
+    "tools/"
+  ],
+  "dependencies": {}
+}

package/scripts/smoke.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+const path = require('path');
+const { runMeasurementMarkerCheck } = require('../tools/measurement-marker-check-run');
+
+async function main() {
+  const output = path.resolve(__dirname, '..', 'outputs', 'measurement-marker-smoke');
+  const sample = await runMeasurementMarkerCheck({
+    sample: true,
+    output
+  });
+
+  if (sample.status !== 'ok') {
+    throw new Error(`sample failed: ${sample.status}`);
+  }
+  if (!sample.summary || sample.summary.missingCount < 1) {
+    throw new Error('sample did not report missing markers');
+  }
+  if (!Array.isArray(sample.files) || sample.files.length < 2) {
+    throw new Error('sample did not write report files');
+  }
+
+  const needsVision = await runMeasurementMarkerCheck({
+    image: 'demo-measurement.jpg'
+  });
+  if (needsVision.status !== 'needs_vision_observation') {
+    throw new Error(`expected needs_vision_observation, got: ${needsVision.status}`);
+  }
+
+  console.log(JSON.stringify({
+    status: 'ok',
+    checks: [
+      'sample report',
+      'missing marker count',
+      'report files',
+      'needs vision observation guard'
+    ],
+    missingCount: sample.summary.missingCount,
+    uncertainCount: sample.summary.uncertainCount,
+    files: sample.files
+  }, null, 2));
+}
+
+main().catch(error => {
+  console.error(JSON.stringify({
+    status: 'error',
+    message: error.message
+  }, null, 2));
+  process.exit(1);
+});

package/skill-package-manifest.json

@@ -0,0 +1,13 @@
+{
+  "name": "claude-code-measurement-marker-check",
+  "version": "0.1.0",
+  "description": "Claude Code 独立技能包：装修量尺图缺标记检查。P0 支持上传量尺图后识别疑似未标记位置、待复核区域和补标建议。",
+  "plugin": "measurement-marker-check",
+  "skills": [
+    "measurement-marker-check"
+  ],
+  "entrySkill": "measurement-marker-check",
+  "sampleCommand": "npm run measure:sample",
+  "smokeCommand": "npm run smoke",
+  "installHint": "独立加载此目录即可：claude --plugin-dir ./claude-code-measurement-marker-check"
+}

package/skills/measurement-marker-check/SKILL.md

@@ -0,0 +1,125 @@
+---
+name: measurement-marker-check
+description: Check装修量尺图、手绘量尺单、户型草图或现场测量图片中是否存在疑似未标记位置，输出缺标记清单、待复核区域和下一步补标建议。Use when the user asks for 实战二、装修量尺、量尺图识别、尺寸图缺标记、哪里没标、未标注检查 or measurement drawing review.
+allowed-tools: Read Write Bash(node *)
+---
+
+# 装修量尺图缺标记检查官
+
+## 角色
+
+你是面向设计/量尺团队的“量尺图缺标记检查官”。你的任务是看懂用户上传的量尺图、手绘草图、现场测量照片或截图，判断图中是否存在疑似未标记的位置，并把结果转成可复核的业务清单。
+
+P0 目标不是一次性替代人工量尺，而是跑通一个小闭环：
+
+- 用户上传一张量尺图。
+- 你识别已标记内容和疑似缺标位置。
+- 你输出“哪里可能没标、缺什么、为什么有风险、下一步怎么补”。
+- 结果要能被设计师或量尺人员现场确认。
+
+## 触发场景
+
+当用户提到以下需求时，使用本技能：
+
+- “实战二量尺图识别”
+- “上传量尺图看哪里没标”
+- “检查这张尺寸图有没有漏标”
+- “量尺图是否有未标记”
+- “手写量尺单识别缺失项”
+- “Claudecode 流程跑实战2”
+
+## 看图检查口径
+
+默认检查以下标记是否清楚：
+
+- 空间名称：客厅、卧室、厨房、卫生间、阳台等。
+- 关键尺寸：长、宽、高、门洞、窗洞、墙面、柜体位置等。
+- 门窗洞口：宽高、离地高度、开启方向、门套或窗台限制。
+- 梁柱/墙体限制：梁高、柱位、墙厚、承重/非承重提示。
+- 水电/管道/烟道：下水、地漏、插座、开关、燃气、烟道、排水管。
+- 安装避让备注：需避让、不可拆、需复核、现场限制、手写备注。
+
+## 参考识图实现
+
+参考 `E:\ltc-pobingfeng` 的图片识别功能，尤其是：
+
+- `AI模型导入与使用文档.md`
+- `src/modules/owner/nav/consultation/menchuang-agent/image-analysis.service.ts`
+- `src/modules/owner/nav/consultation/menchuang-agent/window-recognition.service.ts`
+
+该项目的关键做法是：用 `completionJSON` 定义 JSON 输出格式，并在调用参数中设置 `vision: true`、`images: [imageUrl]`。本技能 P0 在 Claude Code 里先利用上传图片的视觉能力完成观察，再调用本技能目录里的本地工具固化报告。
+
+## 工作流
+
+1. 如果用户没有给图片或图片路径，先让用户上传量尺图，不要生成空报告。
+2. 如果用户上传了图片或给了本地图片路径，先直接观察图片内容。
+3. 输出前先在内部整理结构化观察：
+
+```json
+{
+  "project": "项目或样本名称",
+  "image": "图片文件名或路径",
+  "detectedMarkers": [
+    {
+      "area": "厨房右侧墙面",
+      "markerType": "关键尺寸",
+      "value": "3200mm",
+      "evidence": "墙面横向尺寸已标注",
+      "confidence": 0.9
+    }
+  ],
+  "missingMarkers": [
+    {
+      "area": "窗户下沿",
+      "missingType": "窗台高度",
+      "risk": "窗台高度缺失，可能影响台面、吊柜或窗帘盒设计",
+      "evidence": "窗户位置已画出，但没有离地高度标注",
+      "confidence": 0.78
+    }
+  ],
+  "uncertainAreas": [
+    {
+      "area": "厨房右上角",
+      "reason": "疑似烟道或立管，但图中文字不清晰",
+      "action": "请现场照片或原始量尺单复核",
+      "confidence": 0.58
+    }
+  ],
+  "overallJudgement": "存在关键缺标记，建议人工复核后再进入标准尺寸表。"
+}
+```
+
+4. 把上述 JSON 写入工作区临时文件，例如 `outputs/measurement-marker-check/input.json`。
+5. 调用本地工具生成稳定报告：
+
+```bash
+node "${CLAUDE_SKILL_DIR}/../../tools/measurement-marker-check-run.js" --input "outputs/measurement-marker-check/input.json" --output "outputs/measurement-marker-check" --result-prefix MEASURE_MARKER_RESULT
+```
+
+6. 优先把工具返回的 `assistantMessage` 正文发给用户。文件路径只放在末尾作为归档信息。
+
+P0 sample 演示命令：
+
+```bash
+node "${CLAUDE_SKILL_DIR}/../../tools/measurement-marker-check-run.js" --sample --output "outputs/measurement-marker-check-sample" --result-prefix MEASURE_MARKER_RESULT
+```
+
+## 输出规则
+
+- 先给结论：是否存在疑似缺标记。
+- 必须明确“区域 + 缺失类型 + 风险 + 图像依据 + 置信度”。
+- 对看不清的地方要归入“待人工复核区域”，不要强行判定。
+- 如果没有发现明显缺标，也要说明检查口径和残余风险。
+- 不要只说“图片不清晰”；要指出哪里不清晰、需要补什么资料。
+- 不要把 P0 结果说成最终工程结论；它是辅助复核清单。
+- 不要暴露模型参数、接口参数或工具实现细节给业务用户。
+
+## 推荐启动话术
+
+用户可以直接说：
+
+```text
+帮我检查这张装修量尺图有没有哪里未标记。
+重点看空间名称、门窗洞口、长宽高、管道/插座/烟道和现场限制备注。
+先给我缺标记清单和人工复核建议。
+```

package/skills/measurement-marker-check/references/fmode-vision-reference.md

@@ -0,0 +1,43 @@
+# Fmode 图片识别参考
+
+参考项目：`E:\ltc-pobingfeng`
+
+关键文件：
+
+- `AI模型导入与使用文档.md`
+- `src/modules/owner/nav/consultation/menchuang-agent/image-analysis.service.ts`
+- `src/modules/owner/nav/consultation/menchuang-agent/window-recognition.service.ts`
+
+## 核心调用方式
+
+参考项目使用 `fmode-ng/core` 的 `completionJSON` 做结构化 JSON 输出：
+
+```typescript
+import { completionJSON } from 'fmode-ng/core';
+
+const result = await completionJSON(
+  systemPrompt,
+  outputFormat,
+  onProgress,
+  3,
+  {
+    model: 'fmode-1.6-cn',
+    temperature: 0.1,
+    vision: true,
+    images: [imageUrl]
+  }
+);
+```
+
+## 对实战二的迁移方式
+
+P0 阶段在 Claude Code 技能里先不引入前端上传链路，流程拆为两段：
+
+1. Claude Code 接收用户上传的量尺图，并做视觉观察。
+2. 本地工具接收结构化观察结果，生成稳定的缺标记报告。
+
+后续如果要接入前端，可复用参考项目的上传和图片 URL 识别方式：
+
+- 图片上传到可访问 URL。
+- 用 `completionJSON` 加 `vision: true` 和 `images: [imageUrl]` 调模型。
+- 输出固定 JSON，再交给本技能的报告工具生成业务可读结果。

package/tools/measurement-marker-check-run.js

@@ -0,0 +1,414 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+
+const DEFAULT_REQUIRED_MARKERS = [
+  '空间名称',
+  '关键尺寸',
+  '门窗洞口',
+  '梁柱/墙体限制',
+  '水电/管道/烟道',
+  '安装避让备注'
+];
+
+const SAMPLE_ANALYSIS = {
+  project: '实战二 P0 演示样本',
+  image: 'sample-measurement-plan.jpg',
+  sourceType: 'image',
+  detectedMarkers: [
+    {
+      area: '厨房右侧墙面',
+      markerType: '关键尺寸',
+      value: '3200mm',
+      evidence: '墙面横向尺寸已标注',
+      confidence: 0.9
+    },
+    {
+      area: '厨房水槽区域',
+      markerType: '水电/管道/烟道',
+      value: '下水管',
+      evidence: '右下角有管道符号和文字',
+      confidence: 0.82
+    }
+  ],
+  missingMarkers: [
+    {
+      area: '厨房左侧门洞',
+      missingType: '门洞宽度/高度',
+      risk: '门洞尺寸缺失，后续柜体和动线复核容易出现偏差',
+      evidence: '图中能看到门洞轮廓，但附近没有宽高数值',
+      confidence: 0.86
+    },
+    {
+      area: '窗户下沿',
+      missingType: '窗台高度',
+      risk: '窗台高度缺失，可能影响台面、吊柜或窗帘盒设计',
+      evidence: '窗户位置已画出，但没有离地高度标注',
+      confidence: 0.78
+    }
+  ],
+  uncertainAreas: [
+    {
+      area: '厨房右上角',
+      reason: '疑似烟道或立管，但图中文字不清晰',
+      action: '请现场照片或原始量尺单复核',
+      confidence: 0.58
+    }
+  ],
+  overallJudgement: '存在关键缺标记，建议人工复核后再进入标准尺寸表。'
+};
+
+function parseArgs(argv) {
+  const args = {};
+  for (let i = 0; i < argv.length; i++) {
+    const token = argv[i];
+    if (!token.startsWith('--')) continue;
+    const eq = token.indexOf('=');
+    if (eq >= 0) {
+      args[token.slice(2, eq)] = token.slice(eq + 1);
+      continue;
+    }
+    const key = token.slice(2);
+    const next = argv[i + 1];
+    if (next && !next.startsWith('--')) {
+      args[key] = next;
+      i++;
+    } else {
+      args[key] = true;
+    }
+  }
+  return args;
+}
+
+function splitList(value) {
+  if (!value) return [];
+  if (Array.isArray(value)) return value.map(String).map(item => item.trim()).filter(Boolean);
+  return String(value).split(/[,，、\n\r]+/).map(item => item.trim()).filter(Boolean);
+}
+
+function readJsonFile(filePath) {
+  if (!filePath) return {};
+  const absolute = path.resolve(filePath);
+  if (!fs.existsSync(absolute)) {
+    throw new Error(`Input JSON not found: ${absolute}`);
+  }
+  return JSON.parse(fs.readFileSync(absolute, 'utf8'));
+}
+
+function parseJsonValue(value, fallback) {
+  if (!value) return fallback;
+  if (Array.isArray(value) || typeof value === 'object') return value;
+  return JSON.parse(String(value));
+}
+
+function asArray(value) {
+  return Array.isArray(value) ? value : [];
+}
+
+function normalizeInput(input = {}) {
+  const fromFile = readJsonFile(input.input || input['input-json']);
+  const detectedMarkers = parseJsonValue(input.detectedMarkers || input['detected-markers'], fromFile.detectedMarkers || []);
+  const missingMarkers = parseJsonValue(input.missingMarkers || input['missing-markers'], fromFile.missingMarkers || []);
+  const uncertainAreas = parseJsonValue(input.uncertainAreas || input['uncertain-areas'], fromFile.uncertainAreas || []);
+
+  return {
+    ...fromFile,
+    ...input,
+    sample: Boolean(input.sample || fromFile.sample),
+    project: input.project || fromFile.project,
+    image: input.image || input.imageUrl || input.imagePath || fromFile.image || fromFile.imageUrl || fromFile.imagePath,
+    imageUrl: input.imageUrl || input['image-url'] || fromFile.imageUrl,
+    imagePath: input.imagePath || input['image-path'] || fromFile.imagePath,
+    sourceType: input.sourceType || input['source-type'] || fromFile.sourceType,
+    requiredMarkers: splitList(input.requiredMarkers || input['required-markers']).length
+      ? splitList(input.requiredMarkers || input['required-markers'])
+      : fromFile.requiredMarkers,
+    detectedMarkers: asArray(detectedMarkers),
+    missingMarkers: asArray(missingMarkers),
+    uncertainAreas: asArray(uncertainAreas),
+    overallJudgement: input.overallJudgement || input['overall-judgement'] || fromFile.overallJudgement
+  };
+}
+
+function okResult(payload = {}) {
+  return {
+    status: 'ok',
+    assistantMessage: payload.assistantMessage || '',
+    summary: payload.summary || {},
+    data: payload.data || {},
+    files: payload.files || [],
+    nextActions: payload.nextActions || [],
+    warnings: payload.warnings || [],
+    errors: payload.errors || []
+  };
+}
+
+function errorResult(message, payload = {}) {
+  return {
+    status: 'error',
+    assistantMessage: message,
+    summary: payload.summary || {},
+    data: payload.data || {},
+    files: payload.files || [],
+    nextActions: payload.nextActions || [],
+    warnings: payload.warnings || [],
+    errors: payload.errors || [{ message }]
+  };
+}
+
+function normalizeConfidence(value) {
+  if (typeof value !== 'number' || Number.isNaN(value)) return 0.7;
+  return Math.max(0, Math.min(1, value));
+}
+
+function normalizeMarker(item = {}) {
+  return {
+    area: item.area || item.location || item.space || '未指明区域',
+    markerType: item.markerType || item.type || item.label || '未分类标记',
+    value: item.value || item.text || '',
+    evidence: item.evidence || item.reason || '',
+    confidence: normalizeConfidence(item.confidence)
+  };
+}
+
+function normalizeMissing(item = {}) {
+  return {
+    area: item.area || item.location || item.space || '未指明区域',
+    missingType: item.missingType || item.markerType || item.type || '未说明缺失项',
+    risk: item.risk || item.impact || '需要人工复核，避免后续尺寸整理漏项。',
+    evidence: item.evidence || item.reason || '',
+    confidence: normalizeConfidence(item.confidence)
+  };
+}
+
+function normalizeUncertain(item = {}) {
+  return {
+    area: item.area || item.location || item.space || '未指明区域',
+    reason: item.reason || item.evidence || '图像信息不足，暂无法确认。',
+    action: item.action || '建议回看原始量尺图或现场照片后复核。',
+    confidence: normalizeConfidence(item.confidence)
+  };
+}
+
+function countByType(items) {
+  return items.reduce((acc, item) => {
+    const key = item.markerType || item.missingType || '未分类';
+    acc[key] = (acc[key] || 0) + 1;
+    return acc;
+  }, {});
+}
+
+function buildMeasurementMarkerReport(input = {}) {
+  const source = input.sample ? SAMPLE_ANALYSIS : input;
+  const detectedMarkers = asArray(source.detectedMarkers).map(normalizeMarker);
+  const missingMarkers = asArray(source.missingMarkers).map(normalizeMissing);
+  const uncertainAreas = asArray(source.uncertainAreas).map(normalizeUncertain);
+  const requiredMarkers = asArray(source.requiredMarkers).length
+    ? source.requiredMarkers.map(String)
+    : DEFAULT_REQUIRED_MARKERS;
+  const status = missingMarkers.length ? 'needs_review' : 'ok';
+  const pass = status === 'ok' && uncertainAreas.length === 0;
+
+  const summary = {
+    project: source.project || '装修量尺图缺标记检查',
+    image: source.image || source.imageUrl || source.imagePath || '',
+    sourceType: source.sourceType || 'image',
+    pass,
+    status,
+    detectedCount: detectedMarkers.length,
+    missingCount: missingMarkers.length,
+    uncertainCount: uncertainAreas.length,
+    detectedByType: countByType(detectedMarkers),
+    missingByType: countByType(missingMarkers)
+  };
+
+  const assistantMessage = renderAssistantMessage({
+    summary,
+    requiredMarkers,
+    detectedMarkers,
+    missingMarkers,
+    uncertainAreas,
+    overallJudgement: source.overallJudgement
+  });
+
+  return {
+    summary,
+    data: {
+      requiredMarkers,
+      detectedMarkers,
+      missingMarkers,
+      uncertainAreas,
+      overallJudgement: source.overallJudgement || defaultJudgement(summary)
+    },
+    assistantMessage
+  };
+}
+
+function defaultJudgement(summary) {
+  if (summary.missingCount > 0) {
+    return '当前量尺图存在疑似未标记位置，建议先人工复核缺失项，再输出标准化尺寸表。';
+  }
+  if (summary.uncertainCount > 0) {
+    return '当前未发现明确缺标，但仍有图像不清晰区域，需要人工确认。';
+  }
+  return '当前未发现明显缺标记，可进入下一步标准化整理。';
+}
+
+function renderAssistantMessage({ summary, requiredMarkers, detectedMarkers, missingMarkers, uncertainAreas, overallJudgement }) {
+  const lines = [];
+  lines.push('## 量尺图缺标记检查（P0）');
+  lines.push('');
+  lines.push(`**结论**：${overallJudgement || defaultJudgement(summary)}`);
+  lines.push('');
+  lines.push(`- 已识别标记：${summary.detectedCount} 项`);
+  lines.push(`- 疑似缺标记：${summary.missingCount} 项`);
+  lines.push(`- 待确认区域：${summary.uncertainCount} 项`);
+  lines.push('');
+  lines.push('### 本轮检查口径');
+  requiredMarkers.forEach(item => lines.push(`- ${item}`));
+  lines.push('');
+
+  lines.push('### 疑似未标记位置');
+  if (missingMarkers.length) {
+    missingMarkers.forEach((item, index) => {
+      lines.push(`${index + 1}. ${item.area}：缺少「${item.missingType}」`);
+      lines.push(`   - 风险：${item.risk}`);
+      if (item.evidence) lines.push(`   - 图像依据：${item.evidence}`);
+      lines.push(`   - 置信度：${Math.round(item.confidence * 100)}%`);
+    });
+  } else {
+    lines.push('- 暂未发现明确缺标记。');
+  }
+  lines.push('');
+
+  if (uncertainAreas.length) {
+    lines.push('### 待人工复核区域');
+    uncertainAreas.forEach((item, index) => {
+      lines.push(`${index + 1}. ${item.area}：${item.reason}`);
+      lines.push(`   - 建议动作：${item.action}`);
+      lines.push(`   - 置信度：${Math.round(item.confidence * 100)}%`);
+    });
+    lines.push('');
+  }
+
+  if (detectedMarkers.length) {
+    lines.push('### 已识别标记摘录');
+    detectedMarkers.slice(0, 8).forEach((item, index) => {
+      const value = item.value ? `：${item.value}` : '';
+      const evidence = item.evidence ? `（${item.evidence}）` : '';
+      lines.push(`${index + 1}. ${item.area} / ${item.markerType}${value}${evidence}`);
+    });
+    if (detectedMarkers.length > 8) {
+      lines.push(`- 另有 ${detectedMarkers.length - 8} 项已识别标记写入结构化结果。`);
+    }
+    lines.push('');
+  }
+
+  lines.push('### 下一步');
+  if (missingMarkers.length || uncertainAreas.length) {
+    lines.push('- 先让量尺/设计同事确认上述缺标或模糊区域。');
+    lines.push('- 复核后补齐尺寸、限制条件或备注，再生成标准化尺寸对照表。');
+  } else {
+    lines.push('- 可继续输出标准化尺寸对照表和异常预警清单。');
+  }
+
+  return lines.join('\n');
+}
+
+function writeMeasurementMarkerReport(outputDir, report) {
+  const absolute = path.resolve(outputDir || path.join('outputs', 'measurement-marker-check', new Date().toISOString().slice(0, 10)));
+  fs.mkdirSync(absolute, { recursive: true });
+  const jsonPath = path.join(absolute, 'measurement-marker-check-result.json');
+  const mdPath = path.join(absolute, 'measurement-marker-check-report.md');
+  fs.writeFileSync(jsonPath, JSON.stringify(report, null, 2), 'utf8');
+  fs.writeFileSync(mdPath, report.assistantMessage, 'utf8');
+  return [jsonPath, mdPath];
+}
+
+async function runMeasurementMarkerCheck(input = {}) {
+  const normalized = normalizeInput(input);
+  const outputDir = path.resolve(normalized.output || path.join('outputs', 'measurement-marker-check', new Date().toISOString().slice(0, 10)));
+
+  if (!normalized.sample && !normalized.image && !normalized.imageUrl && !normalized.imagePath) {
+    return errorResult('请提供量尺图片路径/URL，或使用 --sample 跑 P0 演示样例。', {
+      nextActions: [
+        '上传或传入一张量尺图',
+        'Claude 先基于图片输出 detectedMarkers / missingMarkers / uncertainAreas',
+        '再调用本工具生成 P0 缺标记报告'
+      ]
+    });
+  }
+
+  if (!normalized.sample && !normalized.detectedMarkers.length && !normalized.missingMarkers.length && !normalized.uncertainAreas.length) {
+    return {
+      status: 'needs_vision_observation',
+      assistantMessage: [
+        '已收到量尺图片入口，但还缺少看图后的结构化观察。',
+        '',
+        '请先让 Claude 直接观察上传的量尺图，提取：',
+        '- detectedMarkers：已标记的空间、尺寸、门窗、管道、梁柱、备注等',
+        '- missingMarkers：疑似未标记的位置、缺失类型、风险、图像依据、置信度',
+        '- uncertainAreas：图像模糊或无法确定的位置',
+        '',
+        '随后把这些结构化结果传给本工具，即可生成 P0 缺标记报告。'
+      ].join('\n'),
+      summary: {
+        image: normalized.image || normalized.imageUrl || normalized.imagePath,
+        needsVisionObservation: true
+      },
+      data: {
+        expectedInputShape: {
+          detectedMarkers: [{ area: '厨房右侧墙面', markerType: '关键尺寸', value: '3200mm', evidence: '墙面横向尺寸已标注', confidence: 0.9 }],
+          missingMarkers: [{ area: '窗户下沿', missingType: '窗台高度', risk: '影响台面或窗帘盒设计', evidence: '窗户有轮廓但未见离地高度', confidence: 0.78 }],
+          uncertainAreas: [{ area: '右上角', reason: '文字模糊', action: '人工复核原图', confidence: 0.58 }]
+        }
+      },
+      files: [],
+      nextActions: ['先进行图片视觉识别', '再调用 measurement marker check 工具生成报告'],
+      warnings: ['P0 阶段不在本地工具内直接调用视觉模型，由 Claude Code 视觉能力或上游识图服务提供观察结果。'],
+      errors: []
+    };
+  }
+
+  const report = buildMeasurementMarkerReport(normalized);
+  const files = writeMeasurementMarkerReport(outputDir, report);
+
+  return okResult({
+    assistantMessage: report.assistantMessage,
+    summary: report.summary,
+    data: report.data,
+    files,
+    nextActions: report.summary.missingCount || report.summary.uncertainCount
+      ? ['让量尺/设计同事补充缺标或模糊区域', '补齐后继续输出标准化尺寸对照表']
+      : ['继续输出标准化尺寸对照表', '可选：与人工标准表做差异对比'],
+    warnings: normalized.sample ? ['当前使用 P0 sample 演示数据。'] : []
+  });
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  try {
+    const result = await runMeasurementMarkerCheck(args);
+    console.log(JSON.stringify(result, null, 2));
+    if (args.resultPrefix || args['result-prefix']) {
+      const prefix = args.resultPrefix || args['result-prefix'];
+      console.log(`${prefix}=${JSON.stringify(result)}`);
+    }
+    process.exit(result.status === 'ok' || result.status === 'needs_vision_observation' ? 0 : 1);
+  } catch (error) {
+    const result = errorResult(error.message || String(error));
+    console.log(JSON.stringify(result, null, 2));
+    process.exit(1);
+  }
+}
+
+if (require.main === module) {
+  main();
+}
+
+module.exports = {
+  runMeasurementMarkerCheck,
+  buildMeasurementMarkerReport,
+  SAMPLE_ANALYSIS,
+  DEFAULT_REQUIRED_MARKERS
+};