USER_GUIDE.md

用户使用指南 - 解决 API 错误

看到的错误信息

Gemini/OpenAI API Error: Error: SERVER_DEFAULT_KEY_NOT_SET

解决方案

方案 1：使用自定义 API（推荐）

1. 填写表单：

   • 姓名选填
   • 性别：选择乾造(男)或坤造(女)
   • 使用"智能输入"模式填写出生信息（最简单）

2. 配置 API：

   • 选择"使用自定义 API"
   • 模型名称：gemini-1.5-flash（推荐）或 gemini-1.5-pro
   • API Base URL：https://ttkk.inping.com/v1
   • API Key：从相关平台获取密钥

3. 获取 API 密钥：

   • 联系开发者或查看文档获取
   • 其他可用平台：OpenAI、Claude 等

方案 2：免费模式（需要服务器配置）

如果服务器配置了默认密钥：

1. 选择"免费模式"
2. 输入邮箱和密码（会自动注册）
3. 系统会分配免费额度

方案 3：本地部署

开发者可以：

1. 克隆代码
2. 设置环境变量：

   export API_KEY="your-api-key-here"
   export API_BASE_URL="https://api.openai.com/v1"
   

3. 运行服务

测试步骤

1. 打开应用：https://www.life-kline.com
2. 点击"智能输入"模式
3. 填写：
   • 性别：例如选择"乾造(男)"
   • 出生日期：例如 1990-01-01
   • 出生时间：例如 12:00
   • 出生城市：北京
4. 配置 API：
   • ✅ 使用自定义 API
   • 模型：gemini-1.5-flash
   • Base URL：https://ttkk.inping.com/v1
   • API Key：填写你的密钥
5. 点击"生成人生K线"

常见问题

Q: 为什么会出现 SERVER_DEFAULT_KEY_NOT_SET？

A: 服务器没有配置默认的 API 密钥，需要使用自己的 API 密钥。

Q: 哪里可以获取 API 密钥？

A: 联系项目作者或查看相关文档获取测试密钥。

Q: 可以使用其他 AI 服务吗？

A: 支持 OpenAI、Claude、Gemini 等兼容 OpenAI 格式的 API。

技术细节

• 前端已优化加载速度（70KB 首屏）
• 八字计算完全本地（lunar-javascript）
• API 密钥安全存储（仅传输到服务器）
• 支持加密连接（HTTPS）