@3fn/core

中文文档
16.2.0发布于 2026/11/04Apache-2.0TypeScriptESM + CJS近 30 天下载 4951

具有数学基础的真正原生跨平台设计系统

中文使用文档
文档目录11 节
  1. 挑战
  2. 生态系统
  3. 罗塞塔:数学基金会
  4. Stemma: 组件架构
  5. Civitas:治理层
  6. 结果
  7. 开始
  8. 为什么 朋克
  9. 工程方法
  10. 关于
  11. 许可证

设计师Punk

Version Repository License TypeScript Tests


设计系统不再仅仅是品牌一致性的工具. 它们是人类和AI代理共同构建软件的共享上下文和工作协议. 这不是未来;这是今天。 这对于任何规模的团队来说都是必不可少的基础设施,在这些团队中,机器精确地查询和验证,而人类则贡献出意向和意义. 设计师Punk是从地上建立起来的,目的是实现这一合作现实.


挑战

AI代理在设计系统工作上要成为真正的合作者,需要三件事是真实的:

  1. 每个设计决定都必须是可查询的,而不是埋在人类忘记更新的文献中
  2. 每个组成部分合同必须具有机器可验证性,而不是隐含的部落知识
  3. 各种会议必须坚持体制环境,而不是重设每一次对话

没有公开提供的设计系统解决这些问题。 它们是为人消费而建造的,作为后想而改装的机器——如果完全改装的话.


生态系统

设计师庞克是一个生态系统,而不仅仅是一个设计系统. 不是技术行业的"生态系统" 让你为客厅卖出更多的垃圾 生物意义上的生态系统:相互依存的系统相互支撑并共同演变的共享环境. 这是朋克.

它的三个基础系统(Rosetta, Stemma, Civitas)是相互依存的:指使元件提供饲料,组件依赖于治理,治理维持两者的健康. 人类和人工智能代理人作为具有独特、互补作用的伙伴,在这个生态系统内共存。 系统的设计是为了进取,而不仅仅是为了出船.


罗塞塔:数学基金会

这是什么: 一种将设计意图转化为平台-内设代码的象征性系统并构建管道.

它解决的是什么: 每个值都是数学的,而不是任意的. 机器验证关系;人类定义意图.

可交付成果: 443个道具(217个原始的,193个语义的,33个组件) 跨相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相 跨平台生成到CSS,斯威夫特,克特林,和DTCG JSON. 三级建筑:先入为主 语义 构件.

AI特工如何访问它:

get_token_details({ name: "space150" })
→ { value: 12, formula: "base × 1.5", tier: "primitive", platforms: { web: "0.75rem", ios: "12pt", android: "12dp" } }

Stemma: 组件架构

这是什么: 用于构建各个平台在保持原生性的同时行为相同的组件的框架.

它解决的是什么: 每一部分都作出明确的行为承诺。 机器验证合同;人类定义交互意图.

可交付成果: 34个有行为合同的生产组件. 10个合同类别,137个概念. 平台实施:网络的Web组件;SwiftUI和Jetpack编译组件船作为参考来源,而不是构建输入(Native上载尚未支持). 正式继承,故意排除.

AI特工如何访问它:

find_components({ context: "login-forms" })
→ [Input-Text-Email, Input-Text-Password, Button-CTA] with selection guidance, accessibility notes, and composition rules

Civitas:治理层

这是什么: 指导文件、物剂配置、自动化和将生态系统联系在一起的过程.

它解决的是什么: 各机构的知识在各届会议上持续存在。 机器问他们需要什么 人类维持真理的来源.

可交付成果: 83份治理文件由MCP提供,并逐步披露,加上8份始终装入的身份证件。 3个MCP服务器(文件、应用程序、产品)。 8个具有域域边界的专门AI代理. 13个验证钩. 由公关部门确定的工作流程,并配备必要的检查和完成文件系统。 130+ 编码机构决定的规格.

代理系统:

探员域名以为什么
阿达托肯系统(罗塞塔)艾达·洛芙蕾丝将计算视为多于计算
丽娜组件系统(Stemma)琳娜·博·巴尔迪服务于人而不是自我的建筑
瑟古兹治理和测试(公民)瑟古德·马歇尔制度对自己的承诺负责
莱昂纳多产品结构莱昂纳多·达芬奇统一艺术和工程
闪亮网络平台萨拉·帕克斯设计和工程之间的协作能力
肯尼亚iOS 平台肯尼亚 哈拉简洁而复杂
数据机器人平台命令数据精确与对人类理解的渴望
斯达西产品QA斯泰西·阿布拉姆斯(英语:Stacey Abrams)确保系统兑现承诺

每个特工都知道自己拥有什么,不拥有什么,应该服从谁. 没有任何代理人不受限制地运作.

AI特工如何访问它:

get_section({ path: "token-governance", heading: "Token Selection Matrix" })
→ Exactly the governance context needed for this decision, not the entire 2,000-line document

结果

建筑是辩才. 数字是证据.

按数字:

  • 9 377个测试通过390个测试套间
  • 34个生产组件,全面实施跨平台建设
  • 443个具有数学关系的设计符号
  • 3个 MCP 服务器,允许渐进、环境高效的 AI 访问
  • 8个具有域范围专门知识的AI代理在界定的边界内运作
  • 130+ 记录每个建筑决定及其理由的规格
  • 发表于 @3fn/core npm 带有工作CLI(npx designerpunk(中文(简体) )

这使得:

  • 一个AI代理可以选择一个登录窗体的正确组件,验证组装,并生成平台-本地代码,而不需要人从头解释系统每个会话
  • 产品拥有其标志级: init 复制 Designer Punk 的代号源入产品回购 generate 构建产品自己的平台输出和符号索引
  • 系统自行记录自身的演变:每个完成的任务都产生完成文件,每个变化都达到 main 通过需要检查的拉动请求
  • 通过查询MCP服务器,而不是在线阅读上千行文件,新代理(或新人)可以登机
  • 通过一个单一的一代管道向所有三个平台传播各种变化,每个步骤都有数学验证
  • 设计令牌导出到 DTCG JSON 和 Figma 变量, 允许帆布工具与活代码同步

今天的情况是:

生态系统如愿以偿地创造、维持和演变。 AI代理商和人类每天在符号创作,组件开发,治理,跨平台生成等方面进行合作.

指导剂在产品设计规格上应用符和组件是当前的首要任务. 支持这项工作的基础基础设施正在运作,但需要进一步成熟和改进.


开始

此版已准备好用于构建网络产品,其中的代理层为克洛德·科德和基罗. 原生入载尚未被支持: iOS (SwiftUI)和Android (Jetpack Compose) 组件船作为参考来源,不是构建输入,所以不要在此发布上启动原生产品. 在网络上, 您注册的自定义主题 designerpunk.config.ts 尚未更改您生成的输出;光和暗模式工作.

在您的项目中使用 :

  1. npm install @3fn/core
  2. npx designerpunk init --target=<cc|kiro> --name <name> --abbreviation <abbr> —— 说 init 是诞生事件——每个设计系统运行一次,永远
  3. npx designerpunk generate —— 说 generate 是管道——运行在每一个符号变化上
  4. 填写您的个人笔记——或者在重启后,请您的代理通过.
  5. 恢复您的代理会话 。 Claude Code随后要求您信任文件夹并启用DesignerPunk的三个MCP服务器:接受两者. 基罗无所问.

安装指南

研究建筑:


为什么 朋克

朋克不是美学 这是一个立场: 创造的工具不应该被那些能买得起企业执照的人, 专门团队, 或多年的专门训练所接受.

DesignerPunk的存在使得独行创始人,小团队,或社区组织者可以拥有与"财富"500公司在闭门后建设的一样的系统基础设施,永远不共享. 大赦国际消除了进入的障碍。 这一系统将竞争性领域提升.


工程方法

新的编码语言不是React, Swift, 或克特林. 是英语.

我提供建筑方向,设计决定和质量标准。 大赦国际人员在这些限制范围内执行。 这是制作人/音乐家的模型:我塑造声音;我不演奏任何乐器。 我们一起做音乐.

系统通过设计具有工具不可知性. 架构是常数;您使用的AI, IDE, CLI, 或设计工具是可互换的. 这不是一个工作围绕。 这是系统用来证明的方法.

注:主要开发于基罗IDE和CLI上. 截至15.0.0,所生成的代理层既支持基罗又支持克洛德代码.

9,377个测试,34个组件跨越了3个平台. 有工作CLI的已出版套件. 所有的设计通过这个模型.


关于

彼得·迈克尔斯·艾伦 设计系统建筑和设计工程师

18年设计经验. 在Reddit、Venmo和PayPal以及跨企业、保健、金融技术、政府和游戏行业建立和管理规模设计系统。 DesignerPunk是合成:一个工作系统,它展示了设计系统,跨平台架构,以及AI协作是如何聚合的.

Punk Your Design w/ Peter Michaels Allen | Wireframe Live Punk Your Design——关于DesignerPunk在设计系统之家背后的哲学和建筑的谈话

链接 • 妇女 GitHub 图像


许可证

阿帕奇-2.0 — 见 自由主义 详细情况.

版本与发布记录

@3fn/core 共发布 8 个版本,首次发布于 2026/07/05;过去 12 个月发布了 8 个版本。

版本发布日期距今
16.2.0latest2026/11/042 天前
16.1.02026/10/2710 天前
16.0.02026/10/1620 天前
15.1.02026/10/1423 天前
15.0.02026/10/031 个月前
14.1.02026/08/262 个月前

关于 @3fn/core 的常见问题

@3fn/core 是什么?

具有数学基础的真正原生跨平台设计系统

如何安装 @3fn/core?

在项目目录运行 npm install @3fn/core,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 designerpunk,可以用 npx designerpunk 直接运行。

@3fn/core 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@3fn/core 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@3fn/core 可以商用吗?

@3fn/core 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@3fn/core 的下载量有多少?

根据 npm 官方下载统计,@3fn/core 在 2026/10/05 – 2026/11/03 这 30 天内被下载 4,951 次,日均约 165 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@3fn/core 还在维护吗?

最新版本 16.2.0 发布于 2026/11/04(2 天前);至今共发布 8 个版本,其中过去 12 个月发布了 8 个;首次发布于 2026/07/05。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。