bitz 开发者工具链与生态全景

在现代化微内核架构演进中，工程团队往往面临着工具链碎片化与契约脆弱性的双重夹击：

1. 开发者环境准入失控：内网商业制品库访问、工位机器码绑定与开发期临时授权缺乏统一闭环，开发人员常常因拔插 USB 扩展坞导致网卡 MAC 漂移而频繁触发硬件锁机阻断；
2. 端到端契约频繁漂移：前端手写 Axios 请求、后端手写 HttpClient，API 字段大小写或类型稍有调整便引发静默运行时故障；
3. 架构样板代码机械臃肿：按照企业微内核整洁架构落地一个业务用例，开发者必须手动在 Application、Contracts、Domain、Infrastructure 四个工程中编写大量重复的 CQRS 命令、仓储接口、事件模型与依赖注入接线；
4. 包源投毒与配置混乱：多源 NuGet 环境中未配置包源映射，公共包与内部商业包混淆，引发安全审计红线。

bitz（NuGet 全局工具包 BitzOrcas.Cli，对应命令 bitz）是 BitzOrcas.Modern 面向全体研发团队交付的工业级全生命周期 CLI 开发者工具链。作为微内核架构的核心资产与统一脚手架，它集成了开发者统一身份准入、稳态防拔插硬件锁保护、OpenAPI 强类型代理生成、CQRS 垂直切片自动化物化、可视化本地设计工作台与全链路自愈诊断。

真实运行效果交互式终端演示

以下实操步骤全量取自开发机器的真实执行过程，涵盖从工位准入、健康诊断、代码生成到环境自愈的完整研发旅程。每个终端均支持即时复制命令并在本地复现：

步骤 1：Codeup 默认首选统一身份准入与硬件绑定 (bitz login)

执行 bitz login 命令启动设备准入。CLI 默认将 Codeup（阿里云效 Git 统一身份） 设为首选认证源，本地自动通过回环 HTTP 监听器调起浏览器完成云效企业 SSO 授权。

同时，底层硬件引擎执行物理特征采集：自动穿透虚拟网卡、VPN 与常见 USB 扩展坞芯片（如 ASIX AX88179、Realtek RTL8153），精确锁定板载主物理 MAC，生成终身恒定的稳态硬件机器码（如 BITZ-7E2A-94DF-0C81-561A），彻底根除因工位拔插扩展坞导致的锁机故障。

认证握手完成后，LicenseHub 自动颁发受信任的开发者安全证书，CLI 自动将其持久化至 ~/.bitz/bitz-dev.lic，并向用户级 NuGet.Config 安全注入商业私有源凭据。

步骤 2：宿主机开发凭据与硬件锁健康体检 (bitz status)

在任何开发机器上，执行 bitz status 可随时唤起全景健康体检看板。

看板清晰展示当前机器硬件特征、证书绑定机器码、100% 硬件匹配度、开发者组织邮箱、当前绑定的准入认证源（如 Codeup (阿里云效 Git 统一身份)），以及软硬双期限倒计时：

• 软期限（Soft Expire，默认 30 天）：到达后 CLI 控制台给出黄色警示，提醒联网执行 bitz login 滚动续约，但不阻断本地构建；
• 硬期限（Hard Expire，默认 90 天）：超过后 Roslyn 编译期守护触发致命阻断，强制锁定受控商业包，杜绝离职未授权滥用。

步骤 3：强类型客户端代理生成 (bitz generate-proxy)

告别手写 API 请求！执行 bitz generate-proxy 直接解析微服务或单体提供的 OpenAPI 3.0 / 3.1 规范（支持本地 JSON 或远程 URL）。

对于 C# 客户端，自动生成包含标准 XML 注释与 DTO 的强类型接口 I{Service}ApiClient、具备连接池管理与取消令牌支持的 HttpClient 实现，以及 Add{Service}ApiClient 依赖注入扩展；对于 TypeScript 前端，自动将后端 PascalCase 转为标准 camelCase，并自动生成枚举 Label 国际化字典映射。

步骤 4：CQRS 垂直切片代码自动化物化 (bitz generate-slice)

业务开发往往需要编写极其繁复的样板代码。执行 bitz generate-slice，只需提供聚合名称、所属模块与核心业务字段：

CLI 将全自动在目标模块中物化输出：

• 继承 TenantAggregateRoot 的纯净领域聚合根，打标适配器中立的 [BitzTable] 与 [BitzColumn]；
• 领域事件（CreatedDomainEvent / UpdatedDomainEvent）；
• 读模型数据传输对象（DTO）；
• CQRS 业务命令（Create / Update / Delete）与对应 CommandHandler；
• CQRS 业务查询（GetById / GetList）与对应 QueryHandler；
• Minimal API 路由组自动接线与智能 Agent 适配的 [GenerateMcpTool] 标记；
• 质量红线：生成的代码 100% 具备标准 XML 注释与完整可运行逻辑，零未实现占位符（No Placeholders），直接通过 <TreatWarningsAsErrors>true</TreatWarningsAsErrors> 门禁。

步骤 5：可视化切片建模与 Web Studio 工作台 (bitz suite)

为了满足可视化交互诉求，bitz suite 提供了业界领先的本地双模设计器：

• 终端 TUI 模式：通过 Spectre.Console 提供交互式表单向导、属性类型选择、AST 生成树预览与安全确认；
• 本地微型 Web Studio 模式 (--web)：CLI 内置微型 HttpListener，在本地 127.0.0.1:5200 调起深色玻璃拟态 Web UI，支持实时字段增删、动态 AST 代码预览与一键落盘到工程。

步骤 6：全环境深度诊断与一键自愈修复 (bitz doctor --fix)

在跨平台或新工位迁移场景中，开发环境常出现包缓存损坏、环境变量缺失或配置不规范。

运行 bitz doctor --fix：探针全方位体检操作系统架构、.NET 10 SDK、Node.js 前端链、Docker 守护进程、硬件指纹稳定性、许可证软硬期限，并自动分析 NuGet.Config 的 packageSourceMapping 规则。当发现存在投毒隐患或缺失配置时，带 --fix 参数自动执行幂等自愈修复！

交互式终端体验中心

您可以通过下方终端模拟窗直接体验各个命令的交互过程与真实输出（支持自由切换标签）：

核心功能与命令深度参考

1. 全局安装与平滑升级

安装方式

# 方式 A：公网公开源安装（开源/社区引导入门，无需配置凭据）
dotnet tool install -g BitzOrcas.Cli

# 方式 B：企业私有源安装（包含商业增强特性与内部私有包）
dotnet tool install -g BitzOrcas.Cli --add-source <commercial-feed-url>

# 方式 C：开发期本地离线安装
dotnet tool install -g BitzOrcas.Cli --add-source ./artifacts/packages --prerelease

升级管理 (bitz update)

CLI 搭载了后台低优先级异步嗅探器（UpdateNotifier）：

• 每次用户执行命令时在后台异步检查最新版本；
• 本地 ~/.bitz/version-cache.json 维护 24 小时缓存防抖；
• 1.5 秒硬超时与 Fail-Silent 设计，断网或超时绝不阻断前台操作。

bitz update --self              # 升级 CLI 全局工具自身
bitz update check               # 忽略缓存，联机对比当前版本与远端正式版/预览版
bitz update packages            # 扫描当前工程的 Directory.Packages.props 并批量升级官方包

2. 统一身份准入与凭据治理 (bitz login / logout / status)

参数与支持的认证源

用法：
  bitz login [options]

选项：
  -p, --provider <name>  指定身份提供商 (默认: codeup，可选: codeup, wecom, saas)
  -s, --server <url>     授权中心服务端 URL (默认 https://license.ailinkedlaw.com)
  --device-code          启动设备代码认证流 (适用于 SSH 无头终端、Docker 与 WSL)
  -t, --token <pat>      使用个人访问令牌 (PAT) 直接登录 (适用于 CI/CD 流水线)
  -e, --email <email>    指定关联 Git 邮箱 (默认自动读取 git config user.email)

常见场景执行

bitz login                                     # 默认通过 Codeup 浏览器 SSO 登录
bitz login --provider wecom                    # 通过企业微信扫码登录
bitz login --provider saas                     # 使用 LicenseHub SaaS Host 统一账号登录
bitz login --device-code                       # 无 GUI 远程服务器使用短码授权
bitz login --token pat_sec_xxxx                # CI/CD 自动化流水线免交互准入
bitz status                                    # 输出机器锁与凭据健康体检表格
bitz logout                                    # 安全清除本地会话并提供归档凭据选项

3. 全功能工程脚手架 (bitz new)

六档场景预设

bitz new <ProjectName> [options]

正交维度开关

• --orm <sqlsugar|efcore>：持久化适配器（默认 sqlsugar，支持 efcore 专属 SQL Server 迁移建库）；
• --tenancy <single|multi>：租户隔离机制；
• --capabilities <caps>：装配平台能力（identity, auth, masterdata, workflow, website, risk 等）；
• --frontend <type>：协同生成配套前端（react-admin, vue-admin, astro-site, taro-mobile, none）；
• --non-interactive / --silent：无交互脚本执行模式。

4. 确定性模块七点变异与包管理

模块生命周期

bitz add module Billing --project ./MyApp         # 挂载业务模块（或 DevSandbox 沙箱）
bitz remove module Billing --project ./MyApp      # 原子逆向卸载模块

确定性七点变异契约：模块接入绝非简单的文件拷贝，而是原子性变异七处系统接线：

1. 在 src/Modules/<Name>/ 创建模块工程并设置干净的边界；
2. 宿主 Api 追加 ProjectReference 引用；
3. Program.cs 插入 Mediator 组合根挂载点；
4. 注册数据库建库与迁移贡献程序集；
5. 向主 .slnx 解决方案文件追加模块工程项；
6. 测试套件（tests/{Name}.Unit.Tests）追加引用并生成初始单元测试；
7. 自动补齐符合架构规范的文件头与 XML 注释。

集中包管理与隔离防投毒

bitz add-package FluentValidation --version 11.9.0
bitz remove-package AutoMapper

CLI 自动识别 Central Package Management（CPM，Directory.Packages.props），并自动同步更新 NuGet.Config 中的 packageSourceMapping，确立商业包与开源包的来源隔离。

5. 强类型客户端代码生成 (bitz generate-proxy)

# 生成 C# 客户端 SDK (包含 DTO, Interface, HttpClient 与 DI 扩展)
bitz generate-proxy csharp \
  --spec https://api.internal/swagger/v1/swagger.json \
  --namespace BitzOrcas.Client.Billing \
  --output ./src/Clients/BillingClient

# 生成 TypeScript 前端 SDK (包含 Axios 驱动, camelCase 接口与枚举字典)
bitz generate-proxy ts \
  --spec ./swagger.json \
  --output ./frontend/src/api/billing

6. CQRS 垂直切片全生命周期生成 (bitz generate-slice)

bitz generate-slice MatterIntake \
  --module CaseManagement \
  --tenant \
  --prop "CaseNo:string,ClientName:string,ClaimAmount:decimal,IsUrgent:bool"

生成的代码结构：

src/Modules/CaseManagement/
├── Domain/
│   ├── MatterIntake.cs                          # 继承 TenantAggregateRoot 的业务实体
│   └── Events/
│       ├── MatterIntakeCreatedDomainEvent.cs   # 聚合创建领域事件
│       └── MatterIntakeUpdatedDomainEvent.cs   # 聚合更新领域事件
├── Dtos/
│   └── MatterIntakeDto.cs                      # 读模型数据传输对象
└── Application/
    ├── Commands/MatterIntakes/
    │   ├── CreateMatterIntakeCommand.cs        # 创建命令与 Handler (带事务保存)
    │   ├── UpdateMatterIntakeCommand.cs        # 更新命令与 Handler
    │   └── DeleteMatterIntakeCommand.cs        # 删除命令与 Handler
    └── Queries/MatterIntakes/
        ├── GetMatterIntakeByIdQuery.cs         # 详情查询与 Handler
        └── GetMatterIntakesQuery.cs            # 分页列表查询与 Handler

7. 可视化 Suite 建模工作台 (bitz suite)

bitz suite 是 BitzOrcas CLI 搭载的本地双模设计器与架构审阅副驾驶，专为消除 DDD 垂直切片研发过程中的样板工程阻力而打造：

bitz suite                                      # 终端 TUI 交互模式
bitz suite --web --port 5200                   # 启动本地微型 Web Studio 设计器
bitz suite --web -p 5288 --no-open              # 生产/远程指定端口且禁止自动唤起系统浏览器

核心特性包含：

• 实体设计器与属性网格：支持可视配置字段类型、主外键关系、多租户标记与验证约束；
• 虚拟文件系统（VFS）内存代码审阅：集成 Monaco Editor 进行 7 个分层源文件与物理磁盘的双栏 Diff 审查；
• 多方言 DDL 实时预览：生成 SQL Server 与 PostgreSQL 语法脚本及中文列注释，支持拖拽定位与最大化；
• 光标锚定 ER 图拓扑：基于 SVG 的平滑缩放与关系连线，支持一键导出 Retina 2x PNG / SVG / Mermaid；
• 物理 Git 时间轴与抽屉：多维检索 Commit、第二宽自适应抽屉、36px 快捷折叠导轨与双栏修改对比。

完整功能图解、实操流程与 LegalTech 实战演练，请参阅：BitzOrcas Suite 可视化工作台完整指南与实操手册。

退出码与自动化门禁规范

CLI 在参数解析与执行阶段严格遵循 Fail-Fast 原则，拒绝任何模糊推测：

总结与快速通道

• 创建新系统：bitz new MySystem
• 开发者换机或新接入：bitz login（默认 Codeup 登录）
• 查看本地准入凭据：bitz status
• 生成 API 客户端代理：bitz generate-proxy
• 业务切片极速开发：bitz generate-slice 或可视化工作台 BitzOrcas Suite
• 工位异常自愈排查：bitz doctor --fix
• 发版与运维分发：参阅 Bitz CLI 的 NuGet 双轨分发与发版运维手册