玄机子 · Diviner
东方问卜交互站点 + Cloudflare Pages Functions，问卜者可在前台自主择选推演模型（法器）。
功能概览
- 问卜法器：六爻、梅花易数、四柱八字、小六壬、灵犀塔罗、观象灵签、择吉黄历、周公解梦、木鱼，各有仪式流程与程序化音效。
- 法器（模型）选择器：输入框上方下拉列出 8 尊推演模型，选择记忆于本地。所选 id 随请求呈递服务端，单线路直连，不做跨模型静默兜底；失败时提示另择法器。
- 排盘引擎：农历⇄公历、年柱（立春分年）、月柱（节气换月）、日柱与时柱由
calendar.js 查表与代码换算；六爻的本卦、变卦、纳甲、世应、六亲与梅花的本互变三卦、体用，也由引擎依八宫与数理排定。模型只解读定盘，不重算。
- 联网参详：可选开启。服务端先检索资料并以进程帧播报，回答中的来源附链接；未配置 Brave key 时回退 DuckDuckGo。
- 中英双语：右上角切换；英文模式下服务端也以英文作答。
- 本机记忆：会话保存在浏览器本地；命主档案随系统提示词携带。
- 观象台后台：
/admin.html 用 ADMIN_PASSWORD 登录，查看问卜记录，可按日期、模型筛选。
目录
index.html 问卜前台
styles.css 主题样式
script.js 前端逻辑、MODEL_CATALOG、排盘引擎
calendar.js 历法查表库
locales.js 中英双语词典
admin.html 观象台后台
admin.js 观象台后台脚本（CSP 禁止内联脚本）
functions/api/chat.js 问卜接口：路由表、限流、联网查证编排、流式转发
functions/api/_search.js 联网查证（Brave / DuckDuckGo）
functions/api/health.js 后台线路状态
functions/api/admin/records.js 后台记录接口
tests/calendar-baseline.mjs 历法基准校验
tests/chat-protocol.test.mjs 问卜协议回归（模拟上游）
tests/divination-chart.test.mjs 卦盘基准：六十四卦、八宫世应、纳甲、六亲、六神、旬空、三钱抛掷、梅花数理
tests/security-headers.test.mjs 页面安全策略回归：CSP 下发、无内联事件与内联脚本
tests/icons.test.mjs 图标回归：页面用到的图标都在子集里
.github/workflows/ci.yml CI
wrangler.toml Pages 配置（仅 KV / AI binding）
_headers 安全头与缓存策略
.dev.vars.example 本地环境变量模板
免费模型配置说明.md 线路与配置说明
AGENTS.md 工程约定与维护说明
assets/ logos/ zan.jpg
Cloudflare 配置
在 Pages 项目 → Settings → Variables and Secrets 中至少设置：
B_AI_API_KEY
GROQ_API_KEY
ZHIPU_API_KEY
ADMIN_PASSWORD
可选：GROQ_MODEL、ZHIPU_MODEL（覆盖默认上游模型名）、BRAVE_API_KEY（联网查证）。
Workers AI 绑定名为 AI（保留备用，当前不作推演线路）。模型 id 到上游的映射只写在 Pages Function 里，不会下发到浏览器。
KV：问卜档案写入绑定 CHAT_LOGS，wrangler.toml 已沿用原 namespace。若部署到其他 Cloudflare 账号，请换成该账号下新建的 namespace ID。
本地开发
cp .dev.vars.example .dev.vars
# 在 .dev.vars 中填本地测试 Key（已被 .gitignore，切勿提交）
npx wrangler pages dev . --ai AI
测试
node --test tests/calendar-baseline.mjs tests/chat-protocol.test.mjs tests/divination-chart.test.mjs tests/security-headers.test.mjs tests/icons.test.mjs
CI（.github/workflows/ci.yml）另做全部 Functions 与前端脚本的语法检查。
部署
npx wrangler pages deploy . --project-name=diviner --commit-dirty=true
推送 main 分支也会触发 Pages 的 Git 集成部署。
使用边界
本项目适合作为传统文化体验、反思和娱乐工具。历法、医疗、法律、金融等高风险事项不要仅依据模型生成内容作决定。
