CHAPTER 08 // ECOSYSTEM & NPM
npm 软件包矩阵与发布规范
了解 Cyberpsychosis 在 npmjs 上的 6 个公开软件包、安装组合方式与自动化发布工作流。
8.1 官方 npm 软件包清单
本项目采用 Monorepo 架构维护 6 个公开 npm 包，全部遵循 Apache-2.0 开源许可协议：
| npm 包名 | 版本 | 适用场景 | 安装命令 |
|---|---|---|---|
| cyberpsychosis | 0.1.0 | 一站式全功能 SDK 重导出 + CLI 入口 | npm install cyberpsychosis |
| cyberpsychosis-core | 0.1.0 | 仅需纯无头涌现内核（零外部依赖） | npm install cyberpsychosis-core |
| cyberpsychosis-plugins | 0.1.0 | 六大标准运行时模拟器插件集 | npm install cyberpsychosis-plugins |
| cyberpsychosis-demo | 0.1.0 | 16×12 微缩生态站验证场景 | npm install cyberpsychosis-demo |
| cyberpsychosis-tui | 0.1.0 | 终端 ASCII/ANSI 沙盒渲染器与 CLI | npm install -g cyberpsychosis-tui |
| cyberpsychosis-web | 0.1.0 | Web 涌现实验室工作台与调试服务器 | npm install -g cyberpsychosis-web |
8.2 自动化校验与 npmjs 发布流程
仓库内置 npm run publish:dry-run 本地预检脚本与 .github/workflows/npm-publish.yml 自动化发布流水线。每次发版前自动执行全量 TypeScript 编译与跨维度涌现集成测试，确保发布的产物 100% 可用。
// BASH
CYBERPSYCHOSIS SDK
# 本地验证所有工作区包的打包清单与导出类型
npm run publish:dry-run
# 登录 npmjs 后按依赖拓扑顺序发布公开包
for pkg in core plugins demo-minimal renderer-tui renderer-web cyberpsychosis; do
npm publish "./packages/$pkg" --access public
done