渲圖標之線

行 viz 之全線以自現符渲圖標。涵色板生、數建、清單立、技/代/團之圖標渲。

正入點：自項目根 bash viz/build.sh [flags]，或自 viz/ bash build.sh [flags]。此文司平台察（WSL、Docker、原）、R 二進制之擇、步序。永勿於建文直呼 Rscript——其路獨為 MCP 服之設。

用時

• 立或改符函後乃用
• 增新技、代、團於庫後乃用
• 圖標需為新或更色板再渲乃用
• 行全線之重建（如基設變後）乃用
• 初設 viz 之境乃用

入

• 可選：實類——skill、agent、team、或 all（默：all）
• 可選：色板——具體色板名或 all（默：all）
• 可選：域濾——技圖標之具體域（如 git、design）
• 可選：渲模——full、incremental、或 dry-run（默：incremental）

法

第一步：驗先決

確境備為渲。

1. 確 viz/build.sh 存：

   ls -la viz/build.sh
   

2. 驗 Node.js 可得：

   node --version
   

3. 察 viz/config.yml 存（平台特之 R 路圖）：

   ls viz/config.yml
   

build.sh 自動司 R 二進制之解——無需手驗 R 路。於 WSL 用 /usr/local/bin/Rscript（WSL 原 R），於 Docker 用容器之 R，於原 Linux/macOS 用 PATH 中之 Rscript。

得：build.sh、Node.js、config.yml 皆存。

敗則：若 config.yml 缺，線退用系默。若 Node.js 缺，由 nvm 裝之。

第二步：行其線

build.sh 依序行五步：

1. 生色板色（R）→ palette-colors.json + colors-generated.js
2. 建數（Node）→ skills.json
3. 建清單（Node）→ icon-manifest.json、agent-icon-manifest.json、team-icon-manifest.json
4. 渲圖標（R）→ icons/ 與 icons-hd/ 之 WebP 文
5. 生終端符（Node）→ cli/lib/glyph-data.json

全線（諸類、諸色板、標 + HD）：

bash viz/build.sh

增量（略已存於盤之圖標）：

bash viz/build.sh --skip-existing

單域（獨技）：

bash viz/build.sh --only design

單實類：

bash viz/build.sh --type skill
bash viz/build.sh --type agent
bash viz/build.sh --type team

乾運（預覽而不渲）：

bash viz/build.sh --dry-run

獨標尺（略 HD）：

bash viz/build.sh --no-hd

build.sh 後諸旗皆過至 build-all-icons.R。

得：圖標渲至 viz/public/icons/<palette>/ 與 viz/public/icons-hd/<palette>/。

敗則：

• NTFS 上 renv 掛起：viz .Rprofile 繞 renv/activate.R 而直設 .libPaths()。確自 viz/ 行（build.sh 由 cd "$(dirname "$0")" 自動之）
• 缺 R 包：自 build.sh 所選 R 境行 Rscript -e "install.packages(c('ggplot2', 'ggforce', 'ggfx', 'ragg', 'magick', 'future', 'furrr', 'digest'))"
• 無符繫：實需符函——渲前用 create-glyph 技

第三步：驗其出

確渲順畢。

1. 察文數合期：

   find viz/public/icons/cyberpunk -name "*.webp" | wc -l
   find viz/public/icons-hd/cyberpunk -name "*.webp" | wc -l
   

2. 察文大宜（每圖 2-80 KB）
3. 行 audit-icon-pipeline 技以行詳察

得：文數合清單入數。文大於宜範。

敗則：若數不合，某符渲時或誤。察建日誌之 [ERROR] 行。

CLI 旗參

諸旗皆由 build.sh 過至 build-all-icons.R：

旗	默	述
--type <types>	all	逗分：skill、agent、team
--palette <name>	all	單色板或 all（9 色板）
--only <filter>	無	域（技）或實 ID（代/團）
--skip-existing	關	略已存 WebP 之圖標
--dry-run	關	列將生者
--size <n>	512	出維（像素）
--glow-sigma <n>	4	光糊半徑
--workers <n>	自	並工（detectCores()-1）
--no-cache	關	忽內雜緩
--hd	開	啟 HD 變（1024px）
--no-hd	關	略 HD 變
--strict	關	首子文敗時退

build.sh 內所行

獨為參——勿手行此諸步：

cd viz/
# 1. Platform detection: sets R_CONFIG_ACTIVE (wsl, docker, or unset)
# 2. R binary selection: WSL → /usr/local/bin/Rscript, Docker → same, native → Rscript
# 3. $RSCRIPT generate-palette-colors.R
# 4. node build-data.js
# 5. node build-icon-manifest.js --type all
# 6. $RSCRIPT build-all-icons.R "$@"  (flags passed through)
# 7. node build-terminal-glyphs.js

Docker 之替

線亦可於 Docker 行：

cd viz
docker compose up --build

此於隔之 Linux 境行全線並於 8080 口供其果。

驗

• 行 bash viz/build.sh（非裸 Rscript）
• 色板色已生（JSON + JS）
• 數文自庫建
• 清單自數生
• 圖標已為目類與色板渲
• 文數合期
• 文大於宜範（2-80 KB）

陷

• 直呼 Rscript：永勿手行 Rscript build-icons.R 或 Rscript generate-palette-colors.R。必用 bash build.sh [flags]。直 Rscript 呼繞平台察可用誤之 R 二進制（用 ~/bin/Rscript 之 Windows R 而非 /usr/local/bin/Rscript 之 WSL 原 R）。注：CLAUDE.md 與諸指南中 Windows R 之路獨為 MCP 服之設，非為建文
• 誤工作所：build.sh 自動 CD 至己所（cd "$(dirname "$0")"），故可自任處呼之：自項目根 bash viz/build.sh 行正
• 陳清單：build.sh 依序行 1-5 步，故清單渲前必再生。若獨需清單而不渲，用 node viz/build-data.js && node viz/build-icon-manifest.js（Node 步無需 R）
• renv 未啟：.Rprofile 之變通需自 viz/ 行——build.sh 司之。用 --vanilla 旗或自他所行 R 必略之
• Windows 之並：Windows 不持基於 fork 之並——線經 config.yml 自選 multisession

參

• audit-icon-pipeline — 渲前察缺符與圖標
• create-glyph — 為缺圖標之實立新符函
• enhance-glyph — 再渲前改現符