源码系统概览
文章正文
人生K线（life-kline）是一套把传统八字命理转译成金融 K 线图的开源项目，输入出生年月日时即可生成从幼年到百岁的运势走势。本文基于其 GitHub 公开源码做技术与架构层面的梳理，仅用于编程实现与文化研究的参考。
源码简介
该项目以 Apache-2.0 协议开源，定位为基于 AI 大模型与传统八字命理的人生运势可视化工具。核心思路是用 K 线图的形式表达人生大运流年：绿色代表运势上升阶段，红色代表运势下降阶段，让用户像看股票一样直观浏览自己的运势曲线。
仓库主体是一个前后端分离的应用，前端基于 React 与 TypeScript 构建交互界面，后端使用 Node.js 与 Express 提供 API 与 SQLite 数据存储。它内置了八字排盘、运势计算、多维度分析（性格、事业、财运、感情、健康、币圈）以及案例库与知识库等模块。
适用场景
适合对传统文化与数据可视化感兴趣的前端或全栈开发者，用于学习如何将结构化命理规则转译为图表组件。
适合想搭建个人运势展示页、做玄学文化类内容产品的团队，作为二次开发的起点参考。
也适合作为 AI 应用工程案例，研究自托管大模型与云服务两种 API 网关模式的切换实现。
功能亮点
K 线可视化：把八字大运流年渲染成可交互的走势图，支持关键节点高亮标注。
多维度分析：内置性格、事业、财富、感情、健康以及币圈等专题分析维度。
类社交信息流：首页提供信息流风格组件，可提交出生信息并生成分析卡片。
双模式 API 网关：支持自托管 OpenAI 兼容接口与官方云服务两种模式，通过环境变量切换。
后台运营：包含定价、积分、兑换码等管理页面，便于做产品化探索。
技术架构与部署指南
| 维度 | 本套源码 | 同类通用方案 |
|---|---|---|
| 技术栈 | 前端：React 18 + TypeScript + Vite + framer-motion + recharts | 依具体方案选型，需自行搭建与维护 |
| 部署方式 | 克隆仓库后分别安装前端与后端依赖，前端使用 Vite 启动开发服务器，后端使用 Node 运行 Express 服务，V | 多托管于第三方平台或订阅云服务 |
| 功能侧重 | K 线可视化：把八字大运流年渲染成可交互的走势图，支持关键节点高亮标注。 | 功能通用，定制深度有限 |
| 数据归属 | 数据自持，部署在自有服务器，不出站 | 数据通常留存于服务商侧 |
| 成本模式 | 获取后自主部署，无持续授权费用 | 通常按订阅或调用量计费 |
技术栈与运行环境
前端：React 18 + TypeScript + Vite + framer-motion + recharts
后端：Node.js + Express + better-sqlite3
数据库：SQLite（better-sqlite3 本地文件库）
运行环境：Node.js 18+ / npm，支持 Windows、macOS、Linux
其他依赖：lunar-javascript（农历排盘）、bcryptjs（密码哈希）、jsonwebtoken（JWT）、dotenv、html2canvas（导出图片）
安装与部署提示
克隆仓库后分别安装前端与后端依赖，前端使用 Vite 启动开发服务器，后端使用 Node 运行 Express 服务，Vite 已配置将 /api 代理到本地 3000 端口。
复制 .env.example 为 .env，填入站点名称、API 模式（self 或 cloud）以及对应的大模型 API 地址与密钥，JWT 等敏感配置必须修改为自有随机值。
数据库采用 better-sqlite3，首次启动会自动初始化；知识文章与示例案例可通过 scripts 目录下的生成与导入脚本批量写入本地库。
截图与演示说明
首页（HomePage）提供出生信息输入与 K 线结果展示，输入姓名、性别、出生时间后进入分析流程。
仪表盘（DashboardPage）汇总用户的运势概况、积分与历史分析记录。
案例库（CasesLibrary / CaseDetail）内置早发、晚成、大起大落三类典型示例，附带完整 K 线数据与关键节点标注。
知识库（KnowledgeHub / KnowledgeArticle）按快速入门、K线逻辑、八字基础、大运流年、方法误区等分类组织内容。
后台定价页（AdminPricingPage）与兑换码页（AdminVoucherPage）用于配置积分套餐与生成兑换码，属于运营模块，部署时建议加访问控制。
常见问题
问：这个项目需要联网调用大模型吗？
答：取决于 API 模式。选择 self 模式时连接你自己配置的 OpenAI 兼容接口；选择 cloud 模式时调用官方云服务，需在配置中填写对应密钥。
问：可以完全本地离线运行吗？
答：排盘与运势计算逻辑在本地完成，但 AI 分析部分依赖外部大模型接口，离线环境下无法生成解读文本。
安全风险提示
路径：docs/API-GATEWAY-INTEGRATION.md / 类型：文档示例含密钥占位 / 证据：文档与 README 中出现 API_KEY、JWT_SECRET 等占位字段 / 建议：部署前务必替换为真实环境变量，切勿把含真实密钥的 .env 提交到公开仓库。
路径：server/prompts/ / 类型：提示词混淆保护 / 证据：采用 Base64 + XOR 对命理分析提示词做中等强度混淆 / 建议：该方式仅为增加阅读门槛，并非安全加密，公开的加密脚本与密钥管理逻辑仍可能被还原，切勿依赖其保护核心资产。
特别提示：本源码用于文化研究与编程学习，相关运势内容仅供娱乐参考，请勿将其结论用于健康、投资、婚姻等真实决策；下载后请务必进行安全审计，删除恶意代码后再部署使用！
下载说明
源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。
本项目涉及 AI 生成内容与传统玄学文化元素，请遵守所在地法律法规，仅用于娱乐与文化研究，不得宣传迷信或用于欺诈性算命收费。
GitHub项目开源地址：https://github.com/miounet11/life-kline