ShenaAI 使用指南

从注册到 API 配置、智能体使用、数据浏览与电子书阅读的完整操作说明。ShenaAI 采用 BYOL（自带大模型）架构——平台提供国学知识库与确定性算法，算力由您自带。

⚠ 开始前必做三件事

配置自己的大模型 API（BYOL） — 平台不提供算力。务必先到用户中心 → 大模型配置填入你自己的 LLM API Key（DashScope / OpenAI / 智谱 / Ollama 等），否则智能体只返回知识数据与提示词，不生成 AI 结果。详见第③节。
构建本站 API（开发者 Key） — 如需用程序或第三方平台（Coze/Dify）调用，请到开发者中心创建 API Key，通过 X-API-Key 鉴权调用。详见第⑧节。
购买所需产品 / 数据 / 会员 — 到数据资产商城按需选购数据子集、智能体、专著电子书或套餐；A0 核心资产不裸卖。详见第⑥节。

① 快速开始（三步上手）

1登录用户中心 — 进入用户中心，用邮箱登录（内测期见第②节）。

2配置大模型 — 在用户中心「大模型配置（BYOL）」填入您自己的 LLM API Key（见第③节）。不配置也可用，但只返回知识数据+提示词。

3开始使用 — 前往智能体市场选择八字/六爻/中医等智能体，或在书城研读专著、在数据资产浏览样本。

② 账号与登录

账号类型：普通用户（按需付费）VIP（管理员授权）开发者（API）机构（合同）管理员

注册/登录：在用户中心用邮箱注册并登录。
找回密码：登录页「找回密码」用注册邮箱重置。

内测期说明：当前为内测阶段，仅管理员与 VIP 账号可登录使用；普通注册将在正式上线后开放。需要试用请邮件 business@shenaai.cc。

③ 配置大模型 API（BYOL）

ShenaAI 不提供算力。配置您自己的大模型后，所有智能体即可生成 AI 分析（user_llm 模式）；费用由您的 LLM 厂商直接计费，平台仅做安全代理转发。

方式 A：网页配置（推荐）

进入用户中心 → 找到「大模型配置（BYOL）」面板。
选择提供商（如「通义千问 DashScope」），填入 API Key，可选填模型名与自定义地址。
点击保存，系统会自动发一次测试请求校验 Key 是否可用，显示「✅ 已配置 · 已验证」即成功。

方式 B：接口配置

POST /api/v3/auth/llm-config
Authorization: Bearer <你的登录 token>
Content-Type: application/json

{
  "provider": "DASHSCOPE",
  "api_key":  "sk-你的key",
  "model":    "qwen-plus",
  "verify":   true
}

查看配置 GET /api/v3/auth/llm-config　移除配置 DELETE /api/v3/auth/llm-config

支持的提供商

提供商 provider	默认模型	说明
`DASHSCOPE`	qwen-plus	通义千问（阿里云 DashScope）
`OPENAI`	gpt-4o-mini	OpenAI 官方
`ZHIPU`	glm-4-flash	智谱 GLM
`DEEPSEEK` / `MOONSHOT`	OpenAI 兼容	DeepSeek / 月之暗面 Kimi
`BAIDU`	ERNIE-Speed-128K	文心一言，Key 格式 `API_KEY:SECRET_KEY`
`OLLAMA`	qwen2.5:7b	本地 Ollama，无需 Key
`CUSTOM`	需自填	OpenAI 兼容自定义地址（仅放行白名单域名）

三种运行模式

模式	触发条件	返回
`user_llm`	已配置 LLM Key	真实 AI 分析文字（自动附 AI 标识）
`data_only`	未配置 Key	知识库数据 + 拼好的提示词（自行拿去本地大模型运行）
`local_pkg`	下载数据包	完全本地运行，无需任何 API（见第⑤节）

安全提示：您的 API Key 经认证加密（Fernet）存储；平台对外部模型地址做 SSRF 校验，仅放行主流厂商域名。

④ 使用智能体

平台共 62 个智能体：23 个国学知识智能体 + 39 个运营/治理/产业智能体（编成 7 组）。前往智能体市场选择使用。

以「八字研究」为例

免费排盘：真太阳时 + 四柱 + 藏干十神 + 神煞 + 纳音 + 格局 + 五行旺衰 + 大运起运（纯本地确定性算法，无需 AI）。
八字速览（免费）：排盘 + 200 字 AI 摘要。
完整研究 / 大运流年：全量排盘 + AI 深度多板块命理报告（需基础版及以上权益 + 已配置 LLM）。

深度报告内容较长，建议使用「流式报告」逐字输出，避免一次性长时间等待。速览/排盘则即时返回。

⑤ APP / 数据包下载与本地运行

若您希望完全离线、不调用任何 API，可下载数据包在本地运行（local_pkg 模式）。

进入数据目录与样本，浏览可下载的数据包（编号形如 DATA-P0xx，如八字微调数据集 DATA-P005）。
免费提供脱敏样本试用；完整数据包按授权/权益获取。
下载后，将智能体返回的 prompt 字段配合本地大模型（推荐本地 Ollama qwen2.5:7b / deepseek-r1:7b）运行即可。

数据红线：A0 核心原始资产（约 1012 万条）永不裸卖、不提供整库下载；对外仅提供脱敏样本、机构数据子集授权与能力 API。

⑥ 浏览数据资产

数据资产总览 — 查看各能力域、数据规模与授权方式。
数据资产商城 — 按商品浏览可购买的数据/能力产品。
能力查询接口（开发者）：POST /api/v3/capabilities/query 统一 RAG 检索；目录 GET /api/v3/developer/datasets。

⑦ 阅读电子书

进入书城，内含陈茂林专著矩阵与受控在线阅读器。

免费试读：每本书前 3 章免费阅读。
全文阅读：购买该书或开通会员后，在线读全文。
受控阅读：专著为受控在线阅读，不提供下载，以保护版权。
AI 伴读：可就书中内容提问；单次引用 ≤ 原文 15%，不提供整章/全文背诵，单本单日 ≤ 50 次。

也可使用专著研读智能体做主题式研读。

⑧ 开发者 API 接入

面向程序/第三方平台（Coze、Dify 等）调用。

进入开发者中心，选择套餐并创建 API Key。
调用时通过请求头 X-API-Key: <你的Key> 鉴权。
核心接口：统一能力查询 POST /api/v3/capabilities/query；第三方统一查询 POST /api/v3/integrations/v1/query。
接入清单与 OpenAPI：接入指南、API 文档（含 Swagger / ReDoc / openapi.json）。

POST /api/v3/integrations/v1/query
X-API-Key: 你的开发者Key
Content-Type: application/json

{ "domain": "yixue", "query": "乾卦的核心精神" }

Key 管理：POST /api/v3/developer/keys 创建，GET /api/v3/developer/keys 查看。

⑨ 计费与发票

支付方式：支付宝、微信（官方收款码）。下单后扫码支付并在订单页确认。
费用预估：POST /api/v3/billing/estimate；账单查询 GET /api/v3/usage/bill。
BYOL 算力费：智能体调用大模型的费用由您的 LLM 厂商直接向您计费，平台不重复收取算力费。
发票：在用户中心「申请发票」，支持个人 / 企业普票 / 专票。
退款：数字商品一经交付原则不退；技术故障 / 重复扣款 / 重大不符可 7 日内申请，详见退款规则。

⑩ 合规与免责

命理、中医、预测等内容仅作传统文化、民俗与学术研究参考，不构成医疗、法律、投资或命运承诺。
AI 生成内容均已按 GB 45438-2025 标识（ai_generated / 「AI辅助生成」）。
投诉举报：投诉处理规则，24 小时响应。
更多条款见服务条款与隐私政策。

仍有疑问？查看帮助中心常见问题或邮件 business@shenaai.cc。