在 Obsidian 中按标签/文件夹/可见性给图谱视图节点…

当用户想让 Obsidian 图谱视图按标签、文件夹或可见性着色时，安全地重写 .obsidian/graph.json 的 colorGroups 字段。

适用场景

解决思路

1. 先解析配置：按 llm-wiki/SKILL.md 的 Config Resolution Protocol 获取 OBSIDIAN_VAULT_PATH（内联 @name 覆盖 → 从 CWD 向上查找 .env → 全局配置 → 提示设置）。
2. 确认 $OBSIDIAN_VAULT_PATH/.obsidian/ 存在；若不存在说明该 vault 从未在 Obsidian 中打开过，让用户先在 Obsidian 中打开一次再重跑。
3. 若 Obsidian 可能正开着，提醒用户：Obsidian 关闭时会覆盖 graph.json，请先关闭 vault，或准备好立即重载（Cmd/Ctrl+R）并在重载前不要改动图谱设置。
4. 根据用户措辞推断模式，含糊时默认 by-tag：'color by tag'/'color my graph'/'make it colorful' → by-tag；'color by folder'/'color by category'/'color by directory' → by-category；'highlight visibility'/'show internal/pii in graph'/'visibility colors' → by-visibility；用户给出显式映射（tag:#foo = red 或 JSON）→ custom；'combine tag and visibility'/'both' → combined（先 visibility 后 tag）。
5. 使用 10 色色盲友好调色板，按顺序使用：0 #4E79A7 (5142951) 蓝、1 #F28E2B (15896107) 橙、2 #E15759 (14767961) 红、3 #76B7B2 (7780786) 青、4 #59A14F (5873999) 绿、5 #EDC948 (15583048) 黄、6 #B07AA1 (11565217) 紫、7 #FF9DA7 (16751527) 粉、8 #9C755F (10253663) 棕、9 #BAB0AC (12234924) 灰；每个颜色包装为 {"a": 1, "rgb": <int>}。
6. by-tag 模式：glob $VAULT_PATH/**/*.md，排除 _archives/、_raw/、.obsidian/、node_modules/、index.md、log.md、_insights.md；解析每页 frontmatter 的 tags 并统计频次；从频次列表中剔除 visibility/* 标签（保留系统标签，仅在 by-visibility 或 combined 模式处理）；取使用最多的前 10 个标签（不足 10 个则全用）；对第 i 个标签 T 生成 {"query": "tag:#T", "color": palette[i]}；可选在末尾追加未打标签页面的兜底项 {"query": "-[\"tag\":]", "color": palette[9]}，但若第 9 个颜色槽已被真实标签占用则跳过。
7. by-category 模式：按固定顺序使用七个 vault 顶层文件夹以保证颜色稳定——concepts→0 蓝、entities→1 橙、skills→2 红、references→3 青、synthesis→4 绿、projects→5 黄、journal→6 紫；对每个存在且至少含一个 .md 文件的文件夹生成 {"query": "path:\"<folder>\"", "color": {"a": 1, "rgb": <int>}}。
8. by-visibility 模式：按此顺序生成恰好三条（先匹配者胜，故最严格在前）——visibility/pii → #E15759 (14767961)、visibility/internal → #F28E2B (15896107)、visibility/public → #59A14F (5873999)，例如 {"query": "tag:#visibility/pii", "color": {"a": 1, "rgb": 14767961}}；无 visibility/ 标签的页面保持 Obsidian 默认色，不加兜底项。
9. combined 模式：先输出 by-visibility 条目，再输出 by-tag 条目；冲突时 visibility 因排在前面而优先。
10. custom 模式：若用户给出显式映射则照做；把用户给的十六进制（如 #FF00FF）用 int(hex_without_hash, 16) 转成 packed int，并包装为 {"a": 1, "rgb": <int>}。
11. 读取现有 $VAULT_PATH/.obsidian/graph.json；若不存在则从最小默认结构开始（含 collapse-filter、search、showTags、showAttachments、hideUnresolved、showOrphans、collapse-color-groups、colorGroups: []、collapse-display、showArrow、textFadeMultiplier、nodeSizeMultiplier、lineSizeMultiplier、collapse-forces、centerStrength、repelStrength、linkStrength、linkDistance、scale、close 等字段）。
12. 写入前先备份：把现有文件复制为 .obsidian/graph.json.backup-<YYYYMMDD-HHMM>；若同一分钟已有备份则复用，避免堆积重复文件。
13. 只替换 colorGroups 字段为新数组，其他字段一律不动，以保留用户的缩放、物理、过滤、搜索与显示偏好。
14. 按原文件的 JSON 风格写回（通常是紧凑单行或 2 空格缩进，保持原样）。
15. 打印摘要，例如：Graph colorized → .obsidian/graph.json，含 Mode、Groups、Palette、Backup 行，并提示重载 Obsidian（Cmd/Ctrl+R）查看新颜色；若 Obsidian 正开着，先关闭或立即重载，因为 Obsidian 关闭时会覆盖 graph.json 从而抹掉改动。
16. 向 $VAULT_PATH/log.md 追加：- [TIMESTAMP] GRAPH_COLORIZE mode=<mode> groups=<N> backup=graph.json.backup-<stamp>。
17. 边界处理：by-tag 模式下 vault 无标签则回退到 by-category 并告知用户；用户想撤销则从最新的 graph.json.backup-* 恢复并在 log.md 记录；用户想清空所有颜色组则设 colorGroups: []、备份并记为 GRAPH_COLORIZE mode=clear；.obsidian/ 缺失则让用户先在 Obsidian 打开一次再重跑，不要自行创建 .obsidian/；查询语法注意：含空格的文件夹路径需加引号（path:"my folder"），嵌套斜杠标签按字面处理（tag:#visibility/internal），不要 URL 编码；编辑时 Obsidian 开着要提示风险——它在启动时读取 graph.json 并在关闭时重写。
18. 注意：这是纯配置编辑，不改页面内容、不写 frontmatter；可安全重复运行（每次新建备份，只重写 colorGroups）；若用户有手工整理想保留的颜色组，提供 combined 模式或先询问再覆盖；此调色板与 wiki-export 的 graph.html 社区颜色一致，使 Obsidian 图谱与导出可视化外观统一。

适用边界 · 注意事项

• vault 从未在 Obsidian 中打开过（.obsidian/ 不存在）时——应先让用户在 Obsidian 中打开一次，不要自行创建 .obsidian/。
• Obsidian 正开着且用户无法先关闭或立即重载时——Obsidian 关闭时会覆盖 graph.json，可能抹掉改动。
• 用户有手工整理且想保留的颜色组时——不要直接覆盖，改用 combined 模式或先询问。