phoenix-wing

phoenix-wing

Phoenix Wing 跨语言共享核心与 UI 底座 — TypeScript 多包 · CAD 共享算法 · Vue3 控件 · 壳层框架

按需安装

npm install @phoenix-wing/code-core
npm install @phoenix-wing/kt-codegen
npm install @phoenix-wing/cad-contracts @phoenix-wing/cad-core
npm install @phoenix-wing/workspace-schema
npm install phoenix-wing vue pinia

只有 Web UI 或旧消费者需要 Vue 聚合包时才安装 phoenix-wing。参数驱动 CAA/Qt/C++ 代码生成使用 @phoenix-wing/kt-codegen。Node SQLite adapter 单独安装 @phoenix-wing/db-node。CAD 执行链使用 TypeScript；不再提供 Rust source 包或 Python CAD 后端。cad-contracts 还提供无驱动的 Schema v13 只读查询核心，编辑器扩展可接宿主内置 SQLite 而不安装桌面应用。纯 Code/CAD/Codegen 小包不会带入 Vue、Element Plus、SQLite 或 Rust 二进制。

phoenix-wing 聚合 UI 只发布 dist 编译产物。根入口和保留的 .vue 兼容子路径均落到同一份 JavaScript 模块图，避免 Vite 分别预构建根入口与源码 SFC 时产生 Vue/Pinia singleton 双实例。新代码优先使用根入口的命名导出；组件样式由编译入口自动加载。

跨宿主兼容性不依靠 npm 版本猜测：KtCodegen Plan、Ribbon contribution、workspace schema、CAD native/provider/query 都有独立的 schema/protocol 版本与运行时拒绝门禁。Canonical fixtures 随对应 npm 包发布，产品仓直接导入同一 Registry fixture，只保留宿主 adapter，不再维护消费副本。

单仓 CI 使用 pnpm verify:ci，只依赖 Wing checkout；多消费者联调按 消费者本地联调与验证分别运行各产品的受控 local/Registry 命令。 仓库没有一个会静默修改消费者依赖图的通用 verify:consumers 命令。

消费者本地联调

Phoenix 消费者统一使用 pnpm dev 启动 Registry Wing，使用 pnpm wing 启动同级 ../phoenix-wing 本地源码；旧的根级 pnpm dev:registry 和本地开发同义命令均删除。找不到同级 Wing 时本地命令必须停止，不会回退 Registry，也不需要 pnpm link 或修改依赖文件。Wing 默认直接在主库 develop 修改、验证和本地提交归档；用户另行要求隔离时才使用独立 worktree。其他目录可通过文件系统目录链接把同级 phoenix-wing 指向该主库。

正式 npm 包行为必须另跑显式 Registry 对照命令。完整目录、命令、安全边界与消费者验收入口见 docs/本地验证方法.md。

快速使用

详见 docs/快速使用.md

模块概览

当前模块与发布单元入口见 docs/文档索引.md。

命名规则

所有公共 API 使用前缀防止冲突：

KtCodegen 是参数代码生成领域的显式命名例外；其余 Phoenix Wing 公共 API 继续遵守 Pnw 前缀。

详见 docs/命名规则.md

文档

Wing 自身的示例入口：pnpm dev 启动开发验证工作台；pnpm example:registry --wing-version 0.7.5 在隔离目录验证指定 npm 版本。两者共用示例页面，固定显示真实来源；产品消费者原有 pnpm dev / pnpm wing 规则不变。

Peer Dependencies

• vue ^3.0（可选，仅使用控件时需要）
• pinia ^2.0 || ^3.0（可选，仅使用 store 时需要）
• element-plus ^2.0（可选，部分控件需要）

消费场景

Wing 源码提供共享 TypeScript 工具库与壳层框架。典型消费方式包括本地 CAD 工作台、编辑器扩展和 Web 管理应用；各消费者按需安装领域小包或聚合 UI 包。本页不披露未核实公开许可的消费者身份、仓库地址或业务样本。

许可

Copyright © 2024–2026 凤凰之翼（PhoenixWing）贡献者。项目使用 Apache License 2.0 开源。