first commit

2026-06-10 19:59:27 +08:00
commit d141623070
813 changed files with 61301 additions and 0 deletions
@@ -0,0 +1,70 @@
+# 知命阁（zhimingge）
+
+融合《周易》原文学习与 AI 智能解读的 Web 应用。
+
+**代码仓库**：[https://git.bz121.com/dekun/zhimingge.git](https://git.bz121.com/dekun/zhimingge.git)
+
+## 功能模块
+
+| 模块 | 路由 | 状态 |
+|------|------|------|
+| 易经学习 | `/learn` | 规划中 |
+| 六爻算卦 | `/liuyao` | 已有基础（首页） |
+| 生辰八字 | `/bazi` | 规划中 |
+| 综合测算 | `/combined` | 规划中 |
+
+## 文档
+
+- [产品说明文档（SPEC）](./docs/SPEC.md) — 功能规格、架构、实施分期
+- [Ubuntu 部署文档（DEPLOY）](./docs/DEPLOY.md) — PM2 部署至 `/opt/zhimingge`
+
+## 环境变量
+
+复制 `.env.example` 为 `.env.local` 并填写：
+
+```env
+OPENAI_API_KEY=你的密钥
+OPENAI_BASE_URL=https://op.bz121.com/v1
+OPENAI_MODEL=huihui_ai/gemma-4-abliterated:e4b
+```
+
+## 本地开发
+
+```bash
+git clone https://git.bz121.com/dekun/zhimingge.git
+cd zhimingge
+pnpm install
+cp .env.example .env.local
+pnpm run dev
+```
+
+访问 http://localhost:3000
+
+## 生产部署（摘要）
+
+```bash
+cd /opt/zhimingge
+pnpm install --frozen-lockfile
+pnpm run build
+pm2 start ecosystem.config.cjs
+pm2 save && pm2 startup
+```
+
+完整步骤见 [docs/DEPLOY.md](./docs/DEPLOY.md)。
+
+## 目录说明
+
+```
+zhimingge/
+├── app/              # Next.js 应用
+├── components/       # UI 组件
+├── content/zhouyi/   # 64 卦 Markdown 原文
+├── docs/             # 项目文档
+├── lib/              # 工具与数据
+├── ecosystem.config.cjs  # PM2 配置
+└── scripts/deploy.sh     # 服务器更新脚本
+```
+
+## 技术栈
+
+Next.js 15 · React 18 · Tailwind CSS · Vercel AI SDK · PM2