这个项目能做什么

Tinte 是一个设计系统编译器和主题工具链。其核心前提是,当编码代理能够将你的令牌(tokens)视为 API,并将组合规则视为指令时,它就能编写符合品牌规范的 UI;Tinte 将这两者从一个身份配置编译成一个可安装的制品。 提取、编译和强制执行均读取同一个 tinte.config.json。文档记录的 CLI 命令包括:from --emit-script(为实时页面打印提取脚本)、from --normalize(将捕获的样式转换为身份草案)、build --plugin(将身份编译为 Agent Plugin),以及针对一个或多个路径进行 lint,任何绕过令牌的颜色都将导致退出码 1。 tinte build --plugin 会生成一个插件目录,其中包含 plugin.json 和一个包含 SKILL.md 及 references/tokens.css 的 skill 文件夹。SKILL.md 承载了类型比例、语调和组合法则;tokens.css 是代理将其作为 API 读取的令牌文件。项目网站 tinte.dev 由 Tinte 根据自身配置编译的插件进行样式设计,且 design.md 和 tokens.css 可在其实际路径下获取。 此外,该工具还提供主题构建器:从参考开始,转换为提供者(provider)并安装。13 个语义化 OKLCH 令牌可从单一事实来源编译为 shadcn/ui 预设、VS Code 主题、终端配置(Alacritty, Kitty, Warp, Windows Terminal)以及 19 种以上的格式。公共主题可通过预设 API 作为 shadcn registry:base 项目安装,包括字体变体请求和一个返回基础配置、字体和安装命令的包端点,以及一个支持搜索的公共主题浏览端点。 Ray by Tinte(位于 ray.tinte.dev)涵盖了代码截图和主题提取:支持 500 多个语法主题、16 种语言、PNG/SVG 导出,并提供一个文档记录的免费 REST API(每分钟 60 次请求,无需身份验证)。记录的端点可从图像中提取颜色主题,并使用任何 Tinte 主题对代码进行截图。 发布的可复用包包括:用于主题原语、OKLCH 颜色模型和类型定义的 @tinte/core;用于格式转换器的 @tinte/providers;以及用于 Agent Plugin 编译器和主题安装程序的 tinte npm 包。开发过程使用 bun 进行依赖安装、开发服务器运行和生产构建。该项目在 MIT 许可证下发布。