morphos

Morphous 是一个基于 TanStack Start 构建的静态目录，收录灵感源自自然的设计系统。每个目录条目始于一种动物、植物、矿物、天气或景观 motif，包含透明的 motif 资产、明暗两套设计系统面板、录制提示词，以及兼容 shadcn/tweakcn 风格 CSS 变量的主题导出。 项目使用 Bun 进行包管理和脚本执行，并采用 TanStack Start、Vite、React 和 Tailwind CSS。产物为静态预渲染输出，位于 .output/public，通过 GitHub Actions 部署至 GitHub Pages，站点配置域名为 morphos.ameyanagi.com。 目录包存放于 public/systems/{slug}/ 下，通常包含 prompts.json、system.json、theme.css、theme.json、motif.png、design-system-light.png 和 design-system-dark.png。旧版包可能使用 system.json 中记录的等效资产名，如 animal.png 或 design-system.png。目录 UI 读取这些 public 包文件，并从每个系统目录暴露提示词和主题导出。 开发命令包括：bun run dev 启动本地开发服务器，bun run check 执行 linter 和类型检查，bun run test 运行测试，bun run ci 执行 linter、类型检查、测试和生产构建。bun run generate:previews 为画廊渲染生成轻量 WebP 预览图。bun run pages:prepare 验证静态构建产物并添加 GitHub Pages 部署文件。目录刷新与验证流程使用 bun run generate:catalog、bun run generate:previews 和 bun run validate:catalog。 资产生成由项目专属 Codex skill（位于 .codex/skills/morphous-catalog/SKILL.md）处理。图像通过 Codex image tool 生成后复制至各系统包中。Husky pre-commit hook 在安装 Bun 时配置，执行 generate:previews 和 check。 GitHub Pages 部署在推送到 main 分支时触发，也可手动启动：工作流使用 Bun 安装依赖，运行 CI，上传 .output/public 作为 Pages 产物，并通过 actions/deploy-pages 部署。公共 CNAME 和 .nojekyll 文件支持自定义域名和精确资产服务。拉取请求仅运行 CI 而不部署。项目采用 Apache-2.0 或 MIT 双重许可证。