收录规范 — 绘 · 模板工作台

① 一个模板 = 一个文件夹

每个模板独立成 folder，放进 templates/，四样东西齐全：

NO.07-环形热图/
├── plot.pdf        输出效果图（必放）
├── script.R        画图脚本（必放）
├── input.txt       示例数据（必放）
└── meta.json       模板说明（必放，字段见下表）

② meta.json 字段

字段	类型	说明
id	字符串	模板唯一名，与文件夹同名，如 NO.07-环形热图
title	字符串	一句话标题，如「环形热图 + 分组注释」
cat	字符串	图型分类，取总目录现有一级分类之一
script	字符串	脚本文件名
inputs	数组	输入数据文件名列表
schema	对象	每列的列名、类型、含义（给人和 AI 看）
params	数组	可调参数白名单：参数名、默认值、含义
output	字符串	输出文件说明
notes	字符串	一句话使用要点

③ 数据格式约定

默认 Tab 分隔的 txt/csv；第一行是表头；不要合并单元格。
长表优先（一列一变量），列名用英文，含义写进 schema。
脚本里禁止硬编码绝对路径之外的东西——setwd 是唯一的必改行，收进 params。

④ 给 AI / Agent 的使用规范

如果你是 AI，正在替人画图：先在本库 assets/data.js 里按 cat 检索同类模板，选编号最接近的一张；输出必须复用该模板的布局与配色体系，数据列严格遵循它的 schema；只允许修改 params 白名单内的参数（颜色、标题、条数等）；禁止自创图型结构。改完在代码注释里标注来源模板号，如 # based on NO.02。

机器可读索引：assets/data.js（window.TEMPLATES 数组，含全部模板的编号、标题、分类、状态）。每条记录将来会带上 schema 与 params，供 AI 直接消费。

⑤ 收录流程

第一步：按上面结构准备好文件夹，放进 templates/。
第二步：运行收录脚本（即将随包提供），自动生成缩略图、标注版代码与目录记录。
第三步：总目录刷新即可见，状态从「已编目」升级为「素材在库」。