harveyz-skill 0.1.2 → 0.2.1

package/skills/web-fetch/article-fetcher/references/article_utils.py

@@ -0,0 +1,225 @@
+"""
+共享工具函数：格式化 block、构建文章、修复 frontmatter
+"""
+import re, os, json, sqlite3
+from datetime import datetime, timezone, timedelta
+
+# ------------------------------------------------------------
+# 公共常量
+# ------------------------------------------------------------
+HEADING_PREFIX = {'h1': '# ', 'h2': '## ', 'h3': '### ', 'h4': '#### '}
+IMAGE_BASE_URL = 'Image/'
+
+FETCH_DATE = datetime.now(timezone(timedelta(hours=8))).strftime('%Y-%m-%d')
+
+# ------------------------------------------------------------
+# 1. format_block: 将单个 block 转为 Markdown 字符串
+# ------------------------------------------------------------
+def format_block(block):
+    """将 {tag, content} 转为 Markdown 格式"""
+    tag = block.get('tag', 'p')
+    content = block.get('content', '')
+    if tag in HEADING_PREFIX:
+        return HEADING_PREFIX[tag] + content
+    if tag == 'pre':
+        return f'```\n{content}\n```'
+    if tag == 'li':
+        return f'- {content}'
+    # 内容以 # 开头且含 / 或 --- = SKILL.md 代码块
+    if content.startswith('# ') and ('/' in content or '---' in content):
+        return f'```\n{content}\n```'
+    return content
+
+
+# ------------------------------------------------------------
+# 2. infer_ext: 从 URL 或 Content-Type 推断图片扩展名
+# ------------------------------------------------------------
+def infer_ext(url, content_type=''):
+    """从 URL 或 Content-Type 推断图片扩展名"""
+    ext_map = {'image/jpeg': '.jpg', 'image/png': '.png', 'image/gif': '.gif', 'image/webp': '.webp'}
+    if content_type:
+        return ext_map.get(content_type, '.jpg')
+    url_lower = url.lower()
+    for ext in ['.jpg', '.jpeg', '.png', '.gif', '.webp']:
+        if ext in url_lower:
+            return '.jpg' if ext == '.jpeg' else ext
+    return '.jpg'
+
+
+# ------------------------------------------------------------
+# 3. build_article_from_json: 从统一 JSON 构建文章
+# ------------------------------------------------------------
+def build_article_from_json(json_path, title, source_url, origin_filename,
+                             tags, description, author='', publish_date='',
+                             origin_path=None, article_path=None):
+    """
+    从 article_combined.json 构建原文/译文文件。
+
+    JSON 结构：
+        blocks: [{tag, content, blockIndex}]
+        images: [{src, alt, afterBlock, filename}]
+    """
+    with open(json_path, encoding='utf-8') as f:
+        data = json.load(f)
+
+    blocks = data.get('blocks', [])
+    images = data.get('images') or data.get('imageBlocks') or []  # 兼容 imageBlocks/image 两种 key
+
+    # 按 afterBlock 插入图片
+    body_units = []
+    # afterBlock == -1 的图片插入文章最开头
+    pre_imgs = [f'![]({IMAGE_BASE_URL}{img["filename"]})'
+                for img in images if img.get('afterBlock') == -1]
+    if pre_imgs:
+        body_units.append('\n'.join(pre_imgs))
+
+    for i, block in enumerate(blocks):
+        unit_parts = [format_block(block)]
+        for img in images:
+            if img.get('afterBlock') == i:
+                unit_parts.append(f'![]({IMAGE_BASE_URL}{img["filename"]})')
+        body_units.append('\n'.join(unit_parts))
+
+    body = '\n\n'.join(body_units)
+
+    tags_str = '  - ' + '\n  - '.join(tags)
+
+    fm = f"""---
+publish_date: {publish_date}
+fetch_date: {FETCH_DATE}
+author: {author}
+source_url: {source_url}
+origin_title: "{origin_filename.replace('.md', '')}"
+tags:
+{tags_str}
+description: {description}
+---"""
+
+    content = f"""{fm}
+
+[[Origin/{origin_filename}]]
+
+---
+
+# {title}
+
+{body}
+"""
+    return content
+
+
+# ------------------------------------------------------------
+# 4. repair_frontmatter: 自动修复 frontmatter 字段
+# ------------------------------------------------------------
+def repair_frontmatter(fp, url, defaults=None):
+    """
+    尝试自动补全缺失字段，返回 (fm_dict, 修复了哪些字段, 剩余问题列表)
+    """
+    defaults = defaults or {}
+    with open(fp, encoding='utf-8') as f:
+        content = f.read()
+
+    m = re.match(r'^---\n(.*?)\n---', content, re.DOTALL)
+    if not m:
+        return {}, [], ['无frontmatter']
+
+    fm = {}
+    for line in m.group(1).split('\n'):
+        if ':' in line:
+            k, v = line.split(':', 1)
+            fm[k.strip()] = v.strip()
+
+    fixed, remaining = [], []
+
+    # 自动补全 defaults
+    for field, value in defaults.items():
+        if not fm.get(field, '').strip():
+            fm[field] = value
+            fixed.append(f'{field}={value}')
+
+    # tags 格式修复：逗号分隔 → YAML 列表
+    tags_raw = fm.get('tags', '')
+    if tags_raw and ',' in tags_raw and not tags_raw.startswith('-'):
+        raw_list = [t.strip() for t in tags_raw.split(',') if t.strip()]
+        def _norm_tag(t):
+            if re.search(r'[\u4e00-\u9fff]', t):
+                return t.lower()
+            return t.lower().replace(' ', '-')
+        fm['tags'] = '\n  - ' + '\n  - '.join(_norm_tag(t) for t in raw_list)
+        fixed.append('tags=YAML列表')
+
+    # tags 大写修复
+    if fm.get('tags', '').startswith('-'):
+        tag_lines = [l for l in fm['tags'].strip().split('\n') if l.strip().startswith('-')]
+        new_lines = []
+        for tl in tag_lines:
+            tag_val = tl.lstrip('- ').strip()
+            if tag_val and tag_val != tag_val.lower():
+                new_lines.append(f'  - {tag_val.lower()}')
+                fixed.append(f'tag-lowercase={tag_val}')
+            else:
+                new_lines.append(tl)
+        fm['tags'] = '\n'.join(new_lines)
+
+    # 写回文件
+    fm_lines = [f'{k}: {v}' for k, v in fm.items()]
+    fm_str = '---\n' + '\n'.join(fm_lines) + '\n---\n'
+    with open(fp, 'w', encoding='utf-8') as f:
+        f.write(fm_str + content[m.end():])
+
+    # 检查剩余问题
+    for fld in ['publish_date', 'author', 'source_url']:
+        if not fm.get(fld, '').strip():
+            remaining.append(f'{fld}空')
+    if 'origin_title' not in fm or not fm.get('origin_title', '').strip():
+        remaining.append('origin_title空')
+    if 'description' not in fm or not fm.get('description', '').strip():
+        remaining.append('description空')
+
+    return fm, fixed, remaining
+
+
+# ------------------------------------------------------------
+# 5. record_issues: 写入 issues 字段
+# ------------------------------------------------------------
+def record_issues(url, issues_text, db_path=None):
+    """将 issues 写入 SQLite"""
+    if db_path is None:
+        db_path = os.path.expanduser(
+            '{{SKILL_DIR}}/scripts/url-index.db'
+        )
+    conn = sqlite3.connect(db_path)
+    conn.execute('UPDATE url_index SET issues=? WHERE source_url=?',
+                 (issues_text, url))
+    conn.commit()
+
+
+# ------------------------------------------------------------
+# 6. validate_and_repair: 完整校验 + 自动修复流程
+# ------------------------------------------------------------
+def validate_and_repair(origin_path, article_path, url, defaults=None):
+    """
+    执行保存后校验，自动修复可修复的问题。
+    返回 (是否通过, fixed列表, remaining列表)
+    """
+    defaults = defaults or {}
+    defaults.setdefault('fetch_date', FETCH_DATE)
+
+    fm_orig, fixed_orig, rem_orig = repair_frontmatter(origin_path, url, defaults)
+    fm_art, fixed_art, rem_art = repair_frontmatter(article_path, url, defaults)
+
+    all_fixed = fixed_orig + fixed_art
+    all_remaining = [f'[Origin] {r}' for r in rem_orig] + [f'[Article] {r}' for r in rem_art]
+
+    passed = len(all_remaining) == 0
+    return passed, all_fixed, all_remaining
+
+
+# ------------------------------------------------------------
+# 7. sanitize_filename: 文件名清理
+# ------------------------------------------------------------
+def sanitize_filename(name):
+    """移除文件名中的特殊字符"""
+    for ch in ['\\', '/', '*', '?', '<', '>', '|', ':', '"']:
+        name = name.replace(ch, '')
+    return name.lstrip('.')

package/skills/web-fetch/article-fetcher/references/file-format.md

@@ -0,0 +1,73 @@
+# 文件格式模板
+
+## 原文文件格式
+
+```markdown
+---
+publish_date: YYYY-MM-DD
+fetch_date: YYYY-MM-DD
+author: 作者名
+source_url: https://xxx.com/article
+origin_title: Original Title
+category: Category（可选，来源列表页抓取的分类标签）
+tags:
+  - tag1
+  - tag2
+description: 一两句话摘要
+---
+
+文章正文...
+```
+
+## 译文文件格式
+
+```markdown
+---
+publish_date: YYYY-MM-DD
+fetch_date: YYYY-MM-DD
+author: 作者名
+source_url: https://xxx.com/article
+origin_title: Original Title
+category: Category（可选，来源列表页抓取的分类标签）
+tags:
+  - tag1
+  - tag2
+description: 一两句话摘要，概括文章核心内容，供快速阅读。
+---
+
+[[Origin/文章原标题.md]]
+
+---
+
+翻译后的正文...
+```
+
+## frontmatter 字段说明
+
+| 字段 | 原文文件 | 译文文件 | 来源 |
+|------|----------|----------|------|
+| `publish_date` | ✅ 必须 | ✅ 必须 | 页面显示日期，ISO 8601 格式取前 10 位（YYYY-MM-DD） |
+| `fetch_date` | ✅ 必须 | ✅ 必须 | 抓取时间，格式 YYYY-MM-DD（北京时间） |
+| `author` | ✅ 必须 | ✅ 必须 | 页面显示作者，若无则留空 |
+| `source_url` | ✅ 必须 | ✅ 必须 | 当前抓取的 URL |
+| `origin_title` | — | ✅ 必须 | 原文标题，用于 obsidian 双向链接 |
+| `category` | 可选 | 可选 | 来源列表页抓取的分类标签，由 cron 任务注入，article-fetcher skill 只做透传 |
+| `tags` | — | ✅ 必须 | YAML 列表格式，非逗号分隔 |
+| `description` | — | ✅ 必须 | 一两句话摘要，供快速阅读，基于译文内容提取 |
+
+## 文件命名规则
+
+```python
+import re
+origin_filename = re.sub(r'[\\/:*?<>|".]', '', title) + '.md'
+```
+
+移除字符：`\ / : * ? < > | " .`（与 SKILL.md 保持一致）。
+
+## 保存路径
+
+| 类型 | 路径 |
+|------|------|
+| 原文 | `Origin/<origin_title>.md` |
+| 译文 | `<title>.md`（无 Origin 子文件夹） |
+| 图片 | `Image/<url_hash>_img_N.ext` |

package/skills/web-fetch/article-fetcher/scripts/import_reading.py

@@ -0,0 +1,75 @@
+#!/usr/bin/env python3
+"""
+一次性脚本：将 Reading 目录下（不含子文件夹）的 Markdown 文档
+frontmatter 信息解析后存入 url-index.db。
+"""
+import sqlite3, os, re, glob
+
+BASE_DIR = "{{VAULT_PATH}}"
+DB_PATH  = os.path.expanduser("{{SKILL_DIR}}/scripts/url-index.db")
+
+def parse_frontmatter(content):
+    m = re.match(r'^---\n(.*?)\n---', content, re.DOTALL)
+    if not m:
+        return {}
+    fm = {}
+    for line in m.group(1).split('\n'):
+        if ':' in line:
+            key, val = line.split(':', 1)
+            fm[key.strip()] = val.strip()
+    return fm
+
+def extract_title(content, filepath):
+    # 先从 frontmatter 读 title
+    fm = parse_frontmatter(content)
+    if fm.get('title'):
+        return fm['title']
+    # 再从文件名
+    name = os.path.splitext(os.path.basename(filepath))[0]
+    return name
+
+conn = sqlite3.connect(DB_PATH)
+files = glob.glob(os.path.join(BASE_DIR, "*.md"))
+
+inserted = 0
+skipped  = 0
+errors   = []
+
+for fp in files:
+    name = os.path.basename(fp)
+    try:
+        with open(fp, encoding='utf-8') as f:
+            content = f.read()
+    except Exception as e:
+        errors.append(f"{name}: 读取失败 {e}")
+        continue
+
+    fm = parse_frontmatter(content)
+
+    source_url   = fm.get('source_url', '')
+    publish_date = fm.get('publish_date', '')
+    author       = fm.get('author', '')
+    origin_title = fm.get('origin_title', '')
+    title        = extract_title(content, fp)
+
+    if not source_url:
+        # 无 source_url 视为无法去重，跳过
+        skipped += 1
+        print(f"  跳过（无 source_url）: {name}")
+        continue
+
+    try:
+        conn.execute("""
+            INSERT OR IGNORE INTO url_index
+                (source_url, title, origin_title, author, publish_date)
+            VALUES (?, ?, ?, ?, ?)
+        """, (source_url, title, origin_title, author, publish_date))
+        inserted += 1
+        print(f"  ✓ {name}")
+    except Exception as e:
+        errors.append(f"{name}: 写入失败 {e}")
+
+conn.commit()
+print(f"\n完成：插入 {inserted} 条，跳过 {skipped} 条，错误 {len(errors)} 条")
+for e in errors:
+    print(f"  ✗ {e}")

package/skills/web-fetch/article-fetcher/scripts/init_db.py

@@ -0,0 +1,33 @@
+#!/usr/bin/env python3
+"""初始化 SQLite url_index 表"""
+import sqlite3, os
+
+DB_PATH = os.path.expanduser(
+    '{{SKILL_DIR}}/scripts/url-index.db'
+)
+
+# 确保目录存在
+os.makedirs(os.path.dirname(DB_PATH), exist_ok=True)
+
+conn = sqlite3.connect(DB_PATH)
+conn.execute("""
+    CREATE TABLE IF NOT EXISTS url_index (
+        source_url   TEXT PRIMARY KEY,
+        title        TEXT,
+        origin_title TEXT,
+        author       TEXT,
+        publish_date TEXT,
+        fetch_date   TEXT,
+        tags         TEXT,
+        description  TEXT,
+        issues       TEXT,
+        origin_path  TEXT,
+        article_path TEXT
+    )
+""")
+conn.execute("CREATE INDEX IF NOT EXISTS idx_publish_date ON url_index(publish_date)")
+conn.execute("CREATE INDEX IF NOT EXISTS idx_author ON url_index(author)")
+conn.commit()
+conn.close()
+
+print(f"✅ url_index 表初始化完成: {DB_PATH}")

package/skills/web-fetch/article-fetcher/vars.json

@@ -0,0 +1,12 @@
+[
+  {
+    "name": "VAULT_PATH",
+    "description": "Obsidian Reading 目录完整路径（例如 /Users/you/Vault/Product/Reading）",
+    "default": "{{HOME}}/Vault/Product/Reading"
+  },
+  {
+    "name": "SKILL_DIR",
+    "description": "article-fetcher skill 安装后的完整路径（用于定位辅助脚本和数据库文件）",
+    "default": "{{HOME}}/.claude/skills/article-fetcher"
+  }
+]

package/skills/writing/mermaid-diagram/SKILL.md

@@ -0,0 +1,220 @@
+---
+name: mermaid-diagram
+description: >
+  Mermaid 专业作图标准。只要用户提到"画图"、"mermaid"、"流程图"、"产业链"、
+  "板块地图"、"时序图"、"序列图"、"状态机"、"甘特图"、"象限图"、"思维导图"、
+  "接口调用"、"系统交互"，或需要在 Markdown 文档中嵌入任何 Mermaid 图表，
+  立即调用本 skill。支持 flowchart / sequenceDiagram / stateDiagram / timeline /
+  gantt / quadrantChart / mindmap 全类型。
+user_invocable: true
+version: "1.3.0"
+---
+
+# Mermaid 专业作图标准
+
+> **按需读取对应文件，不要一次性全部读入：**
+> - flowchart / 产业链 / 板块地图 → `references/flowchart.md` + `references/color-templates.md`
+> - sequenceDiagram / 时序图 / 接口调用 → `references/sequence.md`
+> - stateDiagram / 状态机 / 周期图 → `references/statediagram.md`
+> - gantt / timeline → `references/gantt-timeline.md`
+> - quadrantChart / mindmap → `references/other-charts.md`
+> - Python 批量检测 → `scripts/check_mermaid.py`（直接运行，无需读入）
+
+---
+
+## 1. 图类型选择矩阵（最关键一步）
+
+### 按语义选型
+
+| 要表达的语义 | 正确图类型 | 错误选择 | 理由 |
+|------------|----------|---------|------|
+| 产业链 / 供应链（有方向的流动） | `flowchart TD` | `mindmap` | mindmap 是放射状从属关系，无法表达方向性流动 |
+| 层级树形结构（无流向） | `mindmap` | `flowchart` | mindmap 的分支布局更自然 |
+| 循环状态转换 | `stateDiagram-v2` | `flowchart` | stateDiagram 语义最精确 |
+| 时间轴事件 | `timeline` | `gantt` | timeline 按时间节点列举，无时段重叠 |
+| 并行时间段 / 甘特 | `gantt` | `timeline` | gantt 能展示多条目时间段重叠 |
+| 二维象限定位 | `quadrantChart` | 自制坐标 | 原生支持，配置简单 |
+| 系统 / 服务间有时序的调用链 | `sequenceDiagram` | `flowchart` | sequenceDiagram 原生支持激活框、条件块、并行 |
+| 资金 / 数据流（有环路） | `flowchart TD` | `sequenceDiagram` | flowchart 支持循环箭头 |
+| 板块地图（股票/行业） | `flowchart TD` + subgraph | `mindmap` / 表格 | subgraph 支持分组+颜色+箭头 |
+| 时间轮动 / 波浪 | `timeline` | `graph LR` | timeline 语义直接对应时序 |
+
+### 图类型速查
+
+```
+flowchart TD      → 产业链、流程、板块地图、资本流
+flowchart LR      → 仅当内容天然横向（如横向对比）才用，否则用 TD
+sequenceDiagram   → 系统/服务间交互、API 调用时序、接口联调
+mindmap           → 纯树形知识结构，无需表达流向
+timeline          → 历史事件/里程碑时间轴，每个时间点有多个条目
+gantt             → 多轨道并行时间段（如技术迭代、项目计划）
+stateDiagram-v2   → 状态机、周期轮动（如估值周期）
+quadrantChart     → 2×2 矩阵定位（如确定性 vs 弹性）
+```
+
+---
+
+## 2. 布局原则
+
+### 宽度控制（窄页优先）
+
+Markdown 渲染器页面宽度通常 700–900px，图表必须适配：
+
+| 场景 | 规则 |
+|------|------|
+| 主流方向 | 优先 `flowchart TD`（纵向），避免 `flowchart LR` |
+| subgraph 内节点 | **最多 2–3 个节点并排**；超过则用 `---` 配对 |
+| stateDiagram | 使用 `direction TB`，不用 `direction LR` |
+| 不可用横向LR的场景 | 产业链、板块地图、状态机、节奏图 |
+
+### 禁止的布局写法
+
+```
+❌ direction TB in flowchart subgraph   # 仅 v10+ 支持，兼容性差
+❌ 4+ 孤立节点在同一 subgraph           # 全部横向排开，过宽
+❌ flowchart LR 用于产业链              # 三列并排超出页面
+❌ nested subgraph（嵌套子图）          # Mermaid 渲染不稳定
+```
+
+> 矩阵布局 `---` 配对技法、subgraph 间箭头写法见 `references/flowchart.md 或对应图类型文件`。
+
+---
+
+## 3. Roland Berger 配色体系
+
+### 核心色板
+
+```
+主色 Deep Navy   #00205B   用于最重要/最底层/上游  subgraph
+主色 RB Blue     #003E96   用于中间层/平台层        subgraph
+中蓝 Medium Blue #1E5C9E   用于应用层/下游          subgraph
+节点 Navy Node   #0A2E7A   上游 subgraph 内节点
+节点 Blue Node   #0050B8   中游 subgraph 内节点
+节点 Mid Node    #2A6EAE   下游 subgraph 内节点
+```
+
+### 语义辅助色
+
+```
+预警 / 高风险    fill:#7B1010  stroke:#B52020
+机会 / 买入      fill:#1A5E3A  stroke:#2A7E50
+等待 / 持有      fill:#003E96  stroke:#1A6AC4
+投机 / 主题      fill:#2E0078  stroke:#5A20A0
+价值 / 配置      fill:#004060  stroke:#1A5E80
+```
+
+### 配色规则
+
+- 深色背景（fill 暗于 `#4A4A4A`）**必须**加 `color:#fff`
+- subgraph 背景比节点背景**深 10–15%**（提供层次感）
+- 同一图内最多使用 **3 种主色** + 语义辅助色
+- `quadrantChart` 的 quadrant 标签不加颜色（库自动渲染）
+- `timeline` / `gantt` / `stateDiagram` 使用库默认颜色，不强制 RB 色
+
+> 完整配色模板（含三层产业链示例）→ `references/color-templates.md`
+
+---
+
+## 4. 语法禁区（Syntax Forbidden Zone）
+
+### 禁用字符（Fatal Characters）
+
+| 字符 | Unicode | 替换方案 |
+|------|---------|---------|
+| `·` 中点 | U+00B7 | 用 `/` 或空格 |
+| `→` 右箭头 | U+2192 | 用 `->` 或 `to` |
+| `—` 破折号 | U+2014 | 用 `-` |
+| `"` `"` | U+201C/D | 用 `"` 标准双引号 |
+| emoji | >U+1F000 | 完全删除 |
+
+### 禁用语法
+
+```
+❌ \n 换行符在节点标签内        → 改用 <br/>
+❌ / 在 quadrant 标签内        → 改用空格或删除
+❌ + 在 timeline key 内         → 改用 "以后" 或文字后缀
+❌ 中文作为 stateDiagram stateID → 用 ASCII ID + as 别名
+❌ YYYY-Q 日期格式在 gantt      → 改用 YYYY-MM-DD
+❌ direction TB 在 flowchart subgraph → 改为全局 TD，删除子图内 direction
+❌ 多行 edge label（|"line1\nline2"|）→ 改为单行短语
+❌ sequenceDiagram 中文/空格参与者名不加处理 → 用 alias 或引号
+❌ sequenceDiagram activate 未配对 deactivate → 必须一一对应
+❌ sequenceDiagram 消息文本内换行 → 不支持，保持单行
+```
+
+---
+
+## 5. 渲染前强制检查清单
+
+每张图创建完毕后，**逐项检查**以下 12 项，全部通过才能输出：
+
+```
+□ 1.  图类型与语义匹配（见第 1 节选型矩阵）
+□ 2.  主方向为 TD 或纵向（非 LR，除非有充分理由）
+□ 3.  subgraph 内每行 ≤ 3 个节点（超过已用 --- 配对）
+□ 4.  无 emoji 字符（在任何标签/子图/边中）
+□ 5.  无 · 中点符（全文替换为 /）
+□ 6.  无 → 箭头字符（替换为 -> 或文字）
+□ 7.  节点标签换行使用 <br/>，不使用 \n
+□ 8.  stateDiagram state ID 全为 ASCII
+□ 9.  gantt 日期格式为 YYYY-MM-DD
+□ 10. quadrantChart 标签无 /
+□ 11. timeline key 无 + % & 特殊字符
+□ 12. 所有深色节点（fill 深于 #4A4A4A）已设 color:#fff
+□ 13. sequenceDiagram 参与者名含中文/空格时已用 alias 或引号
+□ 14. sequenceDiagram 每个 activate 有对应 deactivate
+```
+
+> 批量自动检测 → 运行 `scripts/check_mermaid.py`
+
+---
+
+## 6. 快速参考卡
+
+### 图类型 → 场景
+
+```
+产业链/供应链   → flowchart TD + 3个subgraph + UP→MID→DOWN 箭头
+板块地图        → flowchart TD + subgraph per layer + --- 矩阵节点
+资本/数据流     → flowchart TD + 有向链 + 反馈环
+系统交互/时序   → sequenceDiagram + participant alias + activate/deactivate
+状态周期        → stateDiagram-v2 direction TB + ASCII state ID
+时间轴          → timeline（事件点）/ gantt（时间段）
+象限定位        → quadrantChart
+知识树          → mindmap
+```
+
+### RB 配色速查
+
+```
+上游子图   fill:#00205B  stroke:#1E4A9A
+中游子图   fill:#003E96  stroke:#1A6AC4
+下游子图   fill:#1E5C9E  stroke:#3A8ACC
+上游节点   fill:#0A2E7A  stroke:#1E4A9A
+中游节点   fill:#0050B8  stroke:#1A6AC4
+下游节点   fill:#2A6EAE  stroke:#3A8ACC
+预警红     fill:#7B1010  stroke:#B52020
+机会绿     fill:#1A5E3A  stroke:#2A7E50
+投机紫     fill:#2E0078  stroke:#5A20A0
+价值蓝绿   fill:#004060  stroke:#1A5E80
+所有深色背景加 color:#fff
+```
+
+### 禁用字符替换
+
+```
+·  (U+00B7)  → /
+→  (U+2192)  → ->  或文字
+—  (U+2014)  → -
+"" (U+201C/D)→ "
+emoji        → 删除
+\n 在节点    → <br/>
+```
+
+### 矩阵布局模板
+
+```
+A["节点A"] --- B["节点B"]    ← 第一行（2列）
+C["节点C"] --- D["节点D"]    ← 第二行（2列）
+E["奇数节点"]                 ← 第三行（居中）
+```