dekun
e71baad554
Correct yin-yang eye colors with contrast strokes, and show light/dark switch in mobile header with Chinese labels. Co-authored-by: Cursor <cursoragent@cursor.com>
知命阁（zhimingge）
融合《周易》原文学习与 AI 智能解读的 Web 应用。
代码仓库：https://git.bz121.com/dekun/zhimingge.git
功能模块
| 模块 | 路由 | 状态 |
|---|---|---|
| 易经学习 | /learn |
规划中 |
| 六爻算卦 | /liuyao |
已有基础（首页） |
| 生辰八字 | /bazi |
规划中 |
| 综合测算 | /combined |
规划中 |
文档
- 产品说明文档（SPEC） — 功能规格、架构、实施分期
- Docker 部署文档（DOCKER） — 推荐 生产部署
- 宝塔反代与部署（BAOTA） — 宝塔面板 域名 + HTTPS + AI 流式反代
- Nginx 反代参考（NGINX） — 手写 Nginx 配置
- Ubuntu PM2 部署文档（DEPLOY） — 备选方案
环境变量
复制 .env.example 为 .env.local 并填写：
OPENAI_API_KEY=你的密钥
OPENAI_BASE_URL=https://op.bz121.com/v1
OPENAI_MODEL=huihui_ai/gemma-4-abliterated:e4b
本地开发
git clone https://git.bz121.com/dekun/zhimingge.git
cd zhimingge
pnpm install
cp .env.example .env.local
pnpm run dev
访问 http://localhost:3000（pnpm run dev 默认端口；生产 PM2 为 3130）
生产部署（Docker，推荐）
cd /opt/zhimingge
cp .env.example .env.local && nano .env.local # 填写 OPENAI_API_KEY
docker compose build
docker compose up -d
服务监听 3130 端口。完整说明见 docs/DOCKER.md。
日常更新：bash scripts/docker-deploy.sh
绑定域名（宝塔/Nginx）及 AI 流式反代配置见 docs/BAOTA.md。
PM2 部署（备选）
目录说明
zhimingge/
├── app/ # Next.js 应用
├── components/ # UI 组件
├── content/zhouyi/ # 64 卦 Markdown 原文
├── docs/ # 项目文档
├── lib/ # 工具与数据
├── Dockerfile # Docker 生产镜像
├── docker-compose.yml # Docker Compose 配置
├── ecosystem.config.cjs # PM2 配置（备选）
├── scripts/docker-deploy.sh # Docker 更新脚本
└── scripts/deploy.sh # PM2 更新脚本（备选）
技术栈
Next.js 15 · React 18 · Tailwind CSS · Vercel AI SDK · PM2