# @3fn/core 中文文档 规范地址：https://npmcn.com/package/%403fn/core/ 版本：16\.2\.0 npm 元数据更新时间：2026-11-04T02:02:58.806Z 中文译文更新时间：2026-11-06T05:06:24.055Z 软件包许可：Apache-2\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%403fn/core 原文对照：https://npmcn.com/package/%403fn/core/?lang=original 项目主页：https://github.com/3fn/DesignerPunk#readme 源码仓库：https://github.com/3fn/DesignerPunk ## 关键信息（来自 npm 元数据） - 包体积（解压后）：23.8 MB，1701 个文件 - 模块格式：ESM + CJS - TypeScript 类型：包内自带 - 运行依赖：9 个 - 首次发布：2026-07-05T14:36:26.025Z - 最新版本发布：2026-11-04T02:02:58.632Z - 近 30 天下载量：4951（2026-10-05 至 2026-11-03，npm 官方下载统计） - 已发布版本数：8（近 12 个月 8 个） ## 中文简介 具有数学基础的真正原生跨平台设计系统 ## 安装 ```sh npm install @3fn/core ``` 也可以使用：`pnpm add @3fn/core`、`yarn add @3fn/core`、`bun add @3fn/core` ## README # 设计师Punk [![Version](https://img.shields.io/badge/Version-16.2.0-purple)](https://npmcn.com/package/%403fn/core/docs/releases/release-16.2.0.md) [![Repository](https://img.shields.io/badge/GitHub-DesignerPunk-blue)](https://github.com/3fn/DesignerPunk) [![License](https://img.shields.io/badge/License-Apache--2.0-green.svg)](https://npmcn.com/package/%403fn/core/LICENSE) [![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/) [![Tests](https://img.shields.io/badge/Tests-9377%2B-brightgreen)](https://npmcn.com/package/%403fn/core/) * * * 设计系统不再仅仅是品牌一致性的工具. 它们是人类和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+ 编码机构决定的规格. **代理系统:** | 探员 | 域名 | 以 | 为什么 | | --- | --- | --- | --- | | 阿达 | 托肯系统(罗塞塔) | [艾达·洛芙蕾丝](https://en.wikipedia.org/wiki/Ada_Lovelace) | 将计算视为多于计算 | | 丽娜 | 组件系统(Stemma) | [琳娜·博·巴尔迪](https://en.wikipedia.org/wiki/Lina_Bo_Bardi) | 服务于人而不是自我的建筑 | | 瑟古兹 | 治理和测试(公民) | [瑟古德·马歇尔](https://en.wikipedia.org/wiki/Thurgood_Marshall) | 制度对自己的承诺负责 | | 莱昂纳多 | 产品结构 | [莱昂纳多·达芬奇](https://en.wikipedia.org/wiki/Leonardo_da_Vinci) | 统一艺术和工程 | | 闪亮 | 网络平台 | [萨拉·帕克斯](https://www.linkedin.com/in/sarahparks/) | 设计和工程之间的协作能力 | | 肯尼亚 | iOS 平台 | [肯尼亚 哈拉](https://en.wikipedia.org/wiki/Kenya_Hara) | 简洁而复杂 | | 数据 | 机器人平台 | [命令数据](https://en.wikipedia.org/wiki/Data_\(Star_Trek\)) | 精确与对人类理解的渴望 | | 斯达西 | 产品QA | [斯泰西·阿布拉姆斯(英语:Stacey Abrams)](https://en.wikipedia.org/wiki/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= --name --abbreviation ` —— 说 `init` 是诞生事件——每个设计系统运行一次,永远 3. `npx designerpunk generate` —— 说 `generate` 是管道——运行在每一个符号变化上 4. 填写您的个人笔记——或者在重启后,请您的代理通过. 5. 恢复您的代理会话 。 Claude Code随后要求您信任文件夹并启用DesignerPunk的三个MCP服务器:接受两者. 基罗无所问. [安装指南](https://npmcn.com/package/%403fn/core/docs/consumer/INSTALL.md) **研究建筑:** - [设计师Punk 系统概览](https://npmcn.com/package/%403fn/core/.kiro/steering/DesignerPunk-Systems-Overview.md) - [治理文件](https://npmcn.com/package/%403fn/core/governance/) (83个文件,实际治理层) - [AI 合作框架](https://npmcn.com/package/%403fn/core/governance/AI-Collaboration-Framework.md) * * * ## 为什么 朋克 朋克不是美学 这是一个立场: 创造的工具不应该被那些能买得起企业执照的人, 专门团队, 或多年的专门训练所接受. 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](https://img.youtube.com/vi/sFjNMasG_mU/maxresdefault.jpg)](https://www.youtube.com/live/sFjNMasG_mU) _Punk Your Design——关于DesignerPunk在设计系统之家背后的哲学和建筑的谈话_ [链接](https://www.linkedin.com/in/petermichaelsallen/) • 妇女 [GitHub 图像](https://github.com/3fn) * * * ## 许可证 阿帕奇-2.0 — 见 [自由主义](https://npmcn.com/package/%403fn/core/LICENSE) 详细情况. ## 常见问题 ### @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 和提交记录判断。