K38.ai NEXT — Architecture

Phase 0 · 架构评审中

nousresearch/hermes · 零外部依赖 · AI-native SPA · 新加坡服务器 · v2026-07-25

项目边界 · k38-next /var/www/k38-next/ · 纯静态 SPA 用户 Browser Desktop / Mobile Cloudflare DNS + CDN SSL Termination HTTPS nginx Reverse Proxy SG Server :443 K38.ai NEXT 核心应用 纯 HTML + CSS + JS SPA index.html 入口 router.js History API utils.js 工具库 theme.css Design Tokens k38-canvas.js Canvas 引擎 Web Components k38-nav/card/footer/... rewrite · try_files 静态资源 /assets/css/base.css /assets/css/layout.css /assets/fonts/*.woff2 /assets/img/* 加载 页面 (Hash 路由) #home · Landing #product · 产品 #login · 登录 #docs · 文档 #research · 调研 渲染 旧版降级 /var/www/k38-archive/ nginx /legacy/ → 旧版 设计系统 DESIGN.md Design Tokens · WCAG AA AI 审查流水线 CC → 520 → Kimi → Gemini P0 fixes → 5-reviews → Pass 密码门 #research only sessionStorage 持久化 审查状态 CC ⚙️ 工程 ⚠️ 520 💰 成本 ⚠️ Kimi 🎨 设计 ⚠️ Gemini 🏛️ 终审 P0 修复待办 Hash→History API 功能色·Light Theme 图例 前端 页面 设计系统 基础设施 安全 外部 备用/降级

系统架构 · 三组件体系

  • 🚀 前端层 — 纯静态 SPA (HTML+CSS+JS)
  • 🎯 路由层 — History API + nginx try_files
  • 🎨 设计层 — CSS Custom Properties Design Tokens
  • 🖥️ 组件层 — Web Components (k38-nav/card/footer)
  • 🌀 动画层 — 手写 Canvas 引擎 (3-5种方案候选中)

部署 · 新加坡服务器

  • 🌐 域名 — k38.ai (公开) / k.k38.ai (密码保护)
  • 📂 路径 — /var/www/k38-next/
  • 🔁 切换 — nginx root 指向 k38-next
  • 📦 降级 — 旧版 /legacy/ 路径保留
  • 🔄 CI — scp → chmod → curl 三行部署

Phase 1 计划 · 核心修改项

  • • 🔴 P0 — Hash路由改为 History API + nginx try_files
  • • 🔴 P0 — 补全功能色 (success/warning/error)
  • • 🟠 P1 — 自托管 Inter + PingFang SC 字体
  • • 🟠 P1 — Canvas 引擎移动端电池优化
  • • 🟠 P1 — 补 Light Theme 完整 token 集
  • • 🟢 P2 — 简化组件 (合并 k38-modal + k38-form)