® YANYUCLOUDCUBE · 言语（河南）智能科技有限公司 Yanyu Intelligent Technology Co., Ltd.
万象归元于云枢 | 深栈智启新纪元 All things converge in cloud pivot; Deep stacks ignite a new era of intelligence
言启千行代码 | 语枢万物智能 Words Inspire Thousands of Lines of Code; Language Pivots the Intelligence of All Things
言启象限 | 语枢未来 Words Initiate Quadrants, Language Serves as Core for Future
中文：YYC³ AI Family Token Console 是本地闭环多端推理矩阵数据看盘系统 —— 面向 M4 Max + iMac + NAS 集群的实时监控中枢。涵盖监控中心（数据监控 / 一键跟进 / 巡查模式 / 告警规则）、运维管理（操作中心 / 文件管理 / 数据库管理 / 闭环 / 报表导出）、AI 智能（API 矩阵与模型管理 / AI 辅助决策 / AI 诊断）、AI Family（12 小时钟盘 / Family 中心）与系统管理（审计 / 用户 / 安全 / PWA）六大域，以「文档讲 why、代码讲 how」的双轮驱动工程闭环交付。
English: YYC³ AI Family Token Console is a local closed-loop multi-device inference matrix dashboard — a real-time monitoring hub for M4 Max + iMac + NAS clusters. It spans six domains: Monitoring Center, Operations Management, AI Intelligence, AI Family, Developer Standards, and System Administration, delivered through a dual-wheel engineering loop of "docs explain why, code shows how".
| # | 中文 | English |
|---|---|---|
| 1 | 六大功能域：监控 / 运维 / AI 智能 / AI Family / 开发规范 / 系统管理 | Six Domains: Monitoring / Ops / AI / AI Family / Dev Standards / Admin |
| 2 | 全端图标体系：Android / Web / iOS / macOS / watchOS 五平台 29 PNG 全链路对齐 | Full-Platform Icons: 5 platforms, 29 PNGs, end-to-end aligned |
| 3 | PWA 全链路：manifest + 运行时 head 注入 + CDN 回退 + 安装引导 | PWA Full-Chain: manifest + runtime head injection + CDN fallback + install prompt |
| 4 | 双语 i18n：zh-CN / en-US 全量语言包一致性测试保障 | Bilingual i18n: zh-CN / en-US packs guarded by consistency tests |
| 5 | 质量门禁：TS strict 双旗标 + 分级测试（3230+ 用例）+ 覆盖率 86+ / 悬空 Promise 零容忍 + 色值/重复/体量/死代码四基线 | Quality Gates: strict dual-flag TS + tiered tests (3230+) + coverage 86+ / floating-promise zero / color·dup·size·knip baselines |
| 6 | 闭环 CI/CD：Typecheck → Lint(边界) → Unit+Coverage → Security → E2E → Build(纪律四件套) 六阶段流水线 | Closed-Loop CI/CD: Typecheck → Lint(boundaries) → Unit+Coverage → Security → E2E → Build(discipline) |
| 7 | 零依赖部署：Node 原生（LAN/公网双形态 + HMAC+jti 吊销 + gzip + 审计日志 + 运维台）+ Ollama 反向代理 | Zero-Dep Deploy: native Node (LAN/public + HMAC+jti revocation + gzip + audit log + ops console) + Ollama reverse proxy |
| 8 | 设计系统内嵌：Design Tokens / 组件展示 / 阶段评审一体化 | Embedded Design System: tokens / showcase / stage review in one |
| 9 | 智能化终端补全闭环：上下文感知引擎 × 五维协同源（节点/模型/家族成员/路由/环境变量）× 历史-频率反馈进化 | Intelligent Terminal Completion: context-aware engine × 5-dimension sources × frequency-ranked feedback loop |
| 依赖 Dependency | 最低版本 Min Version | 用途 Purpose |
|---|---|---|
| Node.js | 22+ | 运行时 Runtime |
| pnpm | 11+ | 包管理 Package manager |
| Git | 2.40+ | 版本管理 Version control |
# 1. 克隆仓库 Clone
git clone https://github.com/YYC-Cube/YYC3-AI-API-Token-Console.git
cd YYC3-AI-API-Token-Console
# 2. 安装依赖 Install (开发服务器端口: 3030 起)
pnpm install
# 3. 启动开发服务器 Start dev server
pnpm dev # → http://localhost:3030
# 3'. 局域网可访问 LAN accessible
pnpm dev:host
# 4. 质量门禁 Quality gates（与 CI 同款，本地绿 = CI 绿）
pnpm typecheck # TypeScript strict 检查
pnpm lint # ESLint 0-errors + import 分层边界
pnpm test:unit # Vitest 分级单测 (零外部依赖档)
pnpm test:coverage # 覆盖率 ≥ 门槛 (90/85/80/88 已锁定, 退化即阻断)
# 4'. 架构守护工具链 Architecture guards
pnpm doctor # 12 项环境/策略一键自诊断
pnpm smart:audit # 十维度全链路智能审计 (84s 快照 + JSON 报告, CI 周期归档)
pnpm astgrep # ast-grep 反模式扫描 (7 条规则 × ts/tsx 双语言)
pnpm guardrail-probe # 门禁有效性探针 (植入违规样本断言真实拦截)
pnpm size:check # 文件体量门禁 (基线只减不增)
pnpm knip # 死代码盘点 (基线只减不增)
# 5. 生产构建 + 本地部署 Build & serve
pnpm build # Vite 生产构建 → dist/
pnpm serve:local # 零依赖部署服务器 (默认 3118) + Ollama 代理YYC3-AI-API-Token-Console/
├── AGENTS.md # AI 导师上下文总纲 (技术栈/门禁/红线)
├── .github/ # CI 流水线 + Issue/PR 模板 + 标签清单
│ ├── workflows/ci.yml # 六阶段 CI（typecheck→lint→test+coverage→scan→e2e→build）
│ ├── workflows/pages.yml # CI 全绿后自动部署 GitHub Pages (token.yyc3.vip)
│ ├── workflows/release.yml # tag v* 触发 GitHub Release
│ ├── ISSUE_TEMPLATE/ # Bug/Feature/Docs 三模板
│ ├── PULL_REQUEST_TEMPLATE.md # PR 规范（五高自检 + Footprint Ladder 档位）
│ └── labels.json # 仓库标签机器可读清单
├── index.html # Vite 入口 (全端 favicon/manifest 链)
├── package.json # 脚本与依赖 (dev: 3030 · 精确锁定无 ^ 漂移)
├── vite.config.ts # Vite + React + Tailwind v4
├── vitest.config.ts # 测试三项目工作区 (unit-dom/unit-node/integration)
├── knip.config.ts # 死代码盘点基线 (只减不增)
├── public/
│ ├── manifest.json # PWA manifest (yyc3-icons 对齐)
│ ├── 404.html # SPA 404 回退 (静态资源不回退 + 深链还原; 经 Vite 进 dist)
│ ├── CNAME # 自定义域名 token.yyc3.vip
│ ├── yyc3-Family.png # README 顶图 / 品牌主视觉 (1800×450)
│ └── yyc3-icons/ # 全端图标体系 (5 平台 29 PNG)
├── deploy/
│ ├── server.mjs # 零依赖部署服务器 (LAN 形态, 默认 3118) + Ollama 反向代理
│ ├── console-server.mjs # 公网形态 (gzip + settings 内容协商) + HMAC 鉴权 + 多节点代理
│ ├── console-auth.mjs # 鉴权内核 (HMAC 签名 + jti 吊销 + 登录限流)
│ ├── console-metrics.mjs # 网关指标聚合 (四源设备清单)
│ ├── console-ws-relay.mjs # WS 中继 (手写 RFC 6455 最小实现)
│ └── pm2-YYC3.service # systemd 留档 (fnOS 放开后可切)
├── scripts/
│ ├── ast-grep/ # 结构化反模式守护 (7 条规则 × ts/tsx, 全 error 级)
│ ├── check-size.mjs # 体量门禁 (阈值 + 基线)
│ ├── check-color-budget.mjs # 色值基线门禁 (只减不增, 5486 冻结)
│ ├── check-dup-budget.mjs # 重复代码基线门禁 (jscpd, 生产码口径)
│ ├── knip-check.mjs # knip 基线门禁
│ ├── guardrail-probe.mjs # 门禁有效性探针 (20 探针 × 双跑)
│ ├── nas-console-ops.mjs # NAS console 运维交互台 (status/verify/heal/boot)
│ ├── bundle-stats.mjs # 构建产物体积统计 (zlib gzip)
│ ├── chain-verify.mjs # PWA/i18n/图标三链一致性校验 (dist 实证)
│ ├── inject-precache.mjs # SW 预缓存产物清单注入 (build 后置)
│ ├── doctor.mjs # 环境自诊断 (12 项)
│ └── check_mermaid.py # Mermaid 代码块开闭校验（pre-commit 闸）
├── src/
│ ├── main.tsx # React 挂载入口
│ ├── styles/ # fonts / tailwind / theme
│ └── app/
│ ├── App.tsx # 根组件 (ErrorBoundary + Auth + i18n + 404 深链还原)
│ ├── routes.ts # 路由表 (六大功能域)
│ ├── components/ # 116 业务组件 (零孤儿)
│ ├── hooks/ # 27 自定义 Hooks (全部有直接单测, AGENTS.md 细则)
│ ├── config/providers/ # 提供商声明式配置 (JSON + zod, 24 提供商/69 模型)
│ ├── lib/ # yyc3-icons / 存储 / 网络工具 / terminal-completions 智能补全引擎 / batch 检查点
│ └── __tests__/ # 190 测试文件 · 3230 用例 (AGENTS.md 细则)
└── docs/ # 文档体系（讲 why）
├── YYC3-全量落地实施总结与衔接报告.md # 分析+规划+交付单一事实源 (Phase 1-4)
├── archive/ # 历史文档归档 (深度分析/审计/规划原文)
└── YYC3-开发者文档/ # 架构 / CI/CD / 标签 / 发布 / 贡献 / 安全
| 平台 Platform | 尺寸覆盖 Sizes | 关键用途 Key Usage |
|---|---|---|
| Web App | 16 / 32 / 180 / 192 / 512 | favicon · apple-touch · PWA |
| Android | 48–512 (mdpi→Play Store) | 启动器 · 商店 |
| iOS | 20–1024 (iPhone/iPad) | 主屏 · 通知 · Spotlight |
| macOS | 16–1024 | 桌面 · Dock · About |
| watchOS | 48–1024 | 表盘 · Short Look |
链路:
public/yyc3-icons/→index.htmlfavicon 链 →manifest.json→useYYC3Head运行时注入 →yyc3-icons.tsCDN 回退 Chain:public/yyc3-icons/→index.htmlfavicons →manifest.json→useYYC3Headruntime injection →yyc3-icons.tsCDN fallback
详见 图标可视化架构展示文档。
| 检查项 Gate | 工具 Tool | 通过标准 Standard |
|---|---|---|
| 类型检查 | tsc --noEmit (strict 双旗标) |
0 errors (noUncheckedIndexedAccess + exactOptionalPropertyTypes) |
| 代码规范 | eslint (boundaries 分层契约) |
0 errors · import 分层契约 |
| 悬空 Promise | lint:fp (type-aware 专项) |
0 悬空 (78→0 已固化) |
| 单元测试 | vitest --project unit-dom unit-node |
100% pass (3230+ 用例, maxWorkers=8) |
| 覆盖率 | vitest --coverage |
≥ 门槛 90/85/80/88 (实测 95.19/90.92/86.22/93.21) |
| E2E | playwright (13 用例) |
11 功能 + Lighthouse ≥90 (实测 98) + 离线多路由 |
| 安全扫描 | gitleaks (全历史 + 工作树双模式) |
0 secrets leaked |
| 反模式守护 | ast-grep (7 规则 × ts/tsx, 全 error) |
0 命中 |
| 体量门禁 | check-size.mjs |
基线文件只减不增 + 函数 ≤800 行 |
| 色值基线 | check-color-budget.mjs |
5486 冻结 (增量必须走 Design Tokens) |
| 重复基线 | check-dup-budget.mjs (jscpd) |
生产码 15 克隆 / 237 行冻结 (测试域豁免) |
| 死代码盘点 | knip-check.mjs |
基线只减不增 (devDeps 3) |
| 元门禁 | guardrail-probe.mjs (20 探针) |
双跑全拦截 (ast-grep×14 + eslint×1 + 复合×5) |
| 环境自诊断 | doctor.mjs |
12/12 通过 |
| 构建验证 | vite build + bundle-stats.mjs |
产物完整零密钥 (90 chunks / 909KB gzip) |
- 认领任务 Pick an issue：按 标签规范 筛选
bug/feature/documentation，评论认领。 - 派生分支 Branch：
git checkout -b feat/your-topic（main受保护，禁止 force-push）。 - 本地门禁 Local gates：
pnpm typecheck && pnpm test（与 CI 同款，本地绿 = CI 绿）。 - 提交 PR：按 PR 模板 勾选自检清单；标题遵循 Conventional Commits（
feat:/fix:/docs:/ci:…）。 - 标签必选：PR 必须携带 1 类型 + 1 模块标签。
完整规范见 CONTRIBUTING.md；行为准则见 CODE_OF_CONDUCT.md。
完整说明见 CICD.md；工作流定义
.github/workflows/。
| 事件 Event | 工作流 Workflow | 说明 Description |
|---|---|---|
push → main / develop |
ci.yml |
全量门禁（typecheck / lint / unit-test / scan / build+纪律三件套） |
pull_request → main / develop |
ci.yml |
PR 必需状态检查 |
| CI 成功后自动 | pages.yml |
GitHub Pages 部署 → https://token.yyc3.vip |
push tag v*.*.* |
release.yml |
版本发布流水线（GitHub Release + 制品归档） |
完整定义与机器可读清单见 LABELS.md 与
.github/labels.json（可用 github-label-sync 一键同步）。
类型标签 | Type Labels: feature · enhancement · bug · documentation · performance · security · ci · breaking-change
优先级 | Priority: priority:critical (P0) · priority:high (P1) · priority:medium (P2) · priority:low (P3)
状态 | Status（维护者专用 maintainer-only）: status:needs-triage · status:triaged · status:in-progress · status:blocked · status:needs-review · status:awaiting-feedback · status:duplicate · status:wontfix
模块 | Module（可叠加 ≤ 3 个）: mod:monitor（监控中心）· mod:ops（运维管理）· mod:ai（AI 智能）· mod:family（AI Family）· mod:devstd（开发规范）· mod:admin（系统管理）· mod:infra（基础设施）· mod:icons（图标体系）· mod:docs（开发者文档）
使用规则 | Rules
- 提交 Issue 必选：1 类型 + 1 模块 + 1 优先级；模板预置
status:needs-triage。 - 提交 PR 必选：1 类型 + 1 模块；标题遵循 Conventional Commits。
breaking-change必须叠加priority:critical|high并附迁移说明。- 状态标签仅维护者流转，贡献者勿动。
| 邮箱 Email | 用途 Purpose |
|---|---|
| dev@yanyucloud.com | 开发通用 Development general |
| docs@yanyucloud.com | 文档与知识库 Docs & knowledge base |
| ops@yanyucloud.com | 运维 Operations |
| admin@yanyucloud.com | 管理员 Administration |
| sec@yanyucloud.com | 安全报告 Security reports（请勿公开披露） |
Apache License 2.0 © 2025-2026 YanYuCloudCube™ · 言语（河南）智能科技有限公司
YANYUCLOUDCUBE、YYC³ 及相关标识为言语（河南）智能科技有限公司注册商标/商标，协议授权不包含商标使用权。
「YanYuCloudCube」 「admin@0379.email」 「Words Initiate Quadrants, Language Serves as Core for the Future」 「All things converge in cloud pivot; Deep stacks ignite a new era of intelligence」
© 2025-2026 YanYuCloudCube™. All Rights Reserved.