设计规范
首页、文档网站和 Playground 共用一套设计令牌与交互语言。设计概念为 “图层信号”:深墨色画布作为基底,电光青与蓝紫作为“选区与信号”色,配合 Photoshop 原生语汇——透明棋盘格、选区蚂蚁线、变换控制点和图层标签——表达“用代码操控 PSD 文档”。
共享来源
| 内容 |
位置 |
使用方 |
| 设计令牌 |
docs/assets/css/tokens.css |
Jekyll 页面直接引用;Playground 由 Vite 导入 |
| 图标路径 |
docs/_data/icons.json |
Jekyll icon.html include;Playground icons.jsx 导入 |
| 品牌标识 |
docs/_includes/logo.html、docs/assets/img/favicon.svg |
全站 |
| 能力状态 |
docs/status.md front matter |
能力矩阵页与首页 |
| 示例文档 |
cmd/psdkit-web-samples(构建时生成) |
Playground 与首页真实引擎演示 |
色彩
| 令牌 |
值 |
用途 |
--bg |
#070a12 |
深色基底 |
--surface / --surface-2 |
#0f1522 / #141b2b |
面板、卡片 |
--brand-cyan |
#22e4ff |
主强调、焦点、选区 |
--brand-violet |
#8b7bff |
次强调、近似策略 |
--state-done / partial / none |
绿 / 琥珀 / 红 |
能力状态 |
文档提供浅色阅读主题(跟随系统,可手动切换),浅色下强调色加深以保证对比度。霓虹、发光与模糊只用于首页的视觉焦点,不出现在正文或工具面板中。
字体与排版
- 正文使用系统 UI 字体栈(PingFang SC / 微软雅黑等),代码与 API 名使用等宽字体栈。
- 首页标题使用超大字号与紧凑字距;文档正文 16px、行高 1.85,最大行宽约 820px。
交互约定
- 所有可交互元素具有可见焦点环(
--focus)。
- 动效表达图层关系与处理过程,统一使用
--ease-out 曲线;prefers-reduced-motion 下关闭视差与过渡。
- 概念动画、真实 Go 计算结果和引擎加载状态使用不同标签区分:概念演示标注“示意”,真实输出标注“Go Wasm 输出”。
- “保存预览”与“实时重绘”在 Playground 画布上使用不同颜色的来源标签。
技术约定
| 约定 |
要求 |
| 部署 |
腾讯 COS 纯静态;psdkit.asin1.com 的首页与文档在 /,Playground 在 /demo/;本地默认 /psdkit/ 前缀 |
| Worker |
相对 ./wasm/worker.js 或显式 workerURL,不写死根路径 |
| 执行 |
真实 Go Wasm,不用 Canvas 重写算法 |
| 文件 |
本机导入,不添加上传服务 |
| 能力 |
保留 unsupported、精度策略与全部预算限制 |
| 内部验收 |
公开站点隐藏依赖 __fixtures 的回归入口 |
| 协议 |
保留二进制通道、typed 句柄、超大整数与资源释放 |