安装

项目不依赖任何构建工具或第三方运行时，可以直接使用静态资源。

1. 下载图标包

下载 psycho-icons.zip，其中包含按分类组织的 Regular SVG、全部 Bold SVG、SVG 精灵图、元数据与使用说明。

2. 本地启动网站

npm start
# 打开 http://localhost:4173

server.js 只使用 Node.js 内置模块，Node 18+ 即可运行。也可以直接双击 index.html 在浏览器中打开。

3. 从源码重新生成

npm run build

构建脚本读取 assets/js/icons.js，生成 icons/ 下的单枚 SVG、downloads/ 下的精灵图、JSON 与 ZIP。

使用

直接使用单枚 SVG

<img src="icons/brain/brain.svg" width="32" height="32" alt="大脑">

每个文件自带 stroke="#1b1a18"，用 CSS 的 width / height 缩放即可；需要换色时替换 stroke 值，或把内联 SVG 的 stroke 改为 currentColor 以继承文字颜色。

使用 SVG 精灵图

<svg width="32" height="32" viewBox="0 0 48 48">
  <use href="downloads/psycho-icons-sprite.svg#psi-brain" />
</svg>

所有 symbol 的 id 统一为 psi-<name>。使用外部精灵图时，颜色由外层 SVG 的 color 决定。

切换字重与语言

常规使用 stroke-width="2"，加粗使用 stroke-width="3"。两者共享完全相同的路径，缩放时不会重绘轮廓。页面右上角可切换中文 / English，选择会保存在本地，也可以用 ?lang=en 直接打开英文版。

设计规范

• 一个母版，缩放而非重绘。 所有图标在 48×48 网格上绘制，站点中的 16–64px 只是同一份路径的缩放。
• 两种字重，共享路径。 加粗仅改变描边宽度，不改变造型，保证同一套图标在两种密度下的语义一致。
• 2px 网格与圆角端点。 坐标落在 2px 节奏上，stroke-linecap="round" 与 stroke-linejoin="round" 保持柔和的心理学语境。
• 无填充、单色、可继承颜色。 全部使用 fill="none" 与 stroke="currentColor"，方便在深浅主题中复用。
• 语义化双语命名。 英文 kebab-case 名称 + 中文标签 + 中英混合关键词，便于搜索与学术语境使用。
• 概念优先于装饰。 每个图形对应一个可辨识的心理学概念（如认知行为三角、习惯回路、大五人格），而非抽象装饰图形。

分类体系

情绪与情感、认知与思维、感知与感觉、大脑与神经科学、行为与学习、临床与心理健康、治疗与照护、社会与关系、发展与毕生、人格与自我、研究方法、界面通用。

贡献图标

所有图标定义在 assets/js/icons.js 的 ICONS 数组中，每项包含名称、分类、中文标签、搜索标签与 SVG 内容：

I('brain', 'brain', '大脑', 'brain neuro mind 脑 神经',
  p('M24 10c-4-3-10-2-12 2 ...') + ln(24, 10, 24, 40))

新增图标后运行 npm run build，脚本会校验名称唯一性、分类合法性与 SVG 结构，然后重新生成全部分发文件。贡献时请保持 48×48 网格、无填充、圆角端点与 2px 描边节奏，并同时提供中文标签与中英文关键词。

想提议新图标但不确定名称？描述它的中文名、英文名与所属分类即可，格式与上面一致。

许可与法律

图标与站点代码以 MIT License 发布：可以自由用于商业与非商业项目、修改与再分发，只需保留版权与许可声明。不提供任何明示或暗示的担保。

心理学相关图形用于示意与教育目的，不构成诊断、治疗建议或医疗宣传。涉及临床术语的图标命名仅为学科通用表述。

路线图

• 扩充临床与发展心理细分图标，目标 500+ 枚。
• 补充每个图标的关键词别名与多语言标签。
• 提供 npm 包、React / Vue 组件与 Figma 组件库。
• 增加「图标请求」流程与版本变更日志。
• 提供填充（filled）风格与更多尺寸的光学母版。

术语表

图标命名中常见的心理学术语：

• Affect / 情感 — 情绪体验的效价与唤起度维度。
• Cognition / 认知 — 注意、记忆、推理、决策等信息处理过程。
• Gestalt / 格式塔 — 知觉倾向于把零散元素组织为整体。
• Schema / 图式 — 组织经验与预期的心理结构。
• Metacognition / 元认知 — 对自身认知过程的觉察与调节。
• Reinforcement / 强化 — 提高行为再次发生概率的后果。
• Extinction / 消退 — 强化撤除后行为频率逐渐降低。
• CBT / 认知行为疗法 — 以想法、情绪、行为三者关系为核心的干预。
• Attachment / 依恋 — 个体与重要他人之间的情感联结模式。
• Big Five / 大五人格 — 开放性、尽责性、外倾性、宜人性、神经质。
• Locus of control / 控制点 — 个体对结果归因于自身或外部的程度。
• Double-blind / 双盲 — 参与者与主试均不知分组条件的研究设计。