演算天机
你求签，我算你。
《演算天机》是一部收录多种民间算命法的书，一卷一卷地开。首页是一张书桌：正中一本合上的线装书，四周摆着各卷的器物。目前开了三卷：签（摇签、掷筊请示）、卦（金钱卦）、卜（甲骨灼卜），另有星、鸟、字、历四件器物暗着，还没有开卷。你在桌上用实物完成仪式，书翻开着摊在旁边；它开口，就用行书写在扉页上，全是墨，记下你的每一次犹豫和重掷，猜你会不会失望。仪式一完，书滑到桌子中央、翻开，里面是它替你写的命书：签文、卦、兆、判词、坦白、账本、命盘、四种结局，用真的曲面卷页（WebGL）一页页翻着读。直到结局他才点破：在你求签的时候，他也在给你算命。
单局约两到三分钟，有四种结局，桌面为主，手机也能完整玩。命书的页脚是脚注，讲术语是什么、从哪里来。在线体验：https://suantianji.pages.dev
玩法
- 在书桌上点一件器物进卷：签筒（签）、龟壳与铜钱（卦）、龟甲（卜）；暗着的几件还没有开卷。
- 按朱印"问"开始，选想问的方向（功名 / 尘缘 / 身心），可以在桌上的纸笺上写下具体的问题。
- 摇签：手机直接晃，电脑按住签筒左右拖。
- 掷筊请示：一平一凸是圣杯，两平是笑杯（再掷），两凸是阴杯（神明不同意）。连得三个圣杯，这支签才算数。
- 观象：书摊开成命书，翻着读解签、判词、大师的坦白、行为账本，以及用你这一局的操作数据织成的命盘；想带走，就保存成分享图。
四种结局不看签的好坏，只看你怎么对待被给出的答案。可以试试：
- 留意书开口时露出的扉页上的字迹，它从你进卷起就在记录。
- 掷出阴杯时，偏要这支签。
- 一次次重求，直到求到第三支签。
- 犹豫的时候，看看画面左下角。
特点
- 零位图：画面全部由 SVG、CSS 和 Canvas 绘制，声音全部由 Web Audio 实时合成。
- Astro + Svelte，纯静态：Astro 管路由、静态页与 Markdown 讲解，仪式部分是 Svelte 组件；构建后是纯静态站（
dist/），functions/ 照常给 Cloudflare Pages 用。没有 UI 组件库，没有 CSS 框架。
- 真的翻页：命书的每一页是 Canvas 画的纹理，翻页用 three.js 做曲面卷页（圆柱 / 锥面卷曲、光照与投影、背面透字、惯性与回弹）；手机、减少动效、不支持 WebGL 时退回 2D，功能等价。
- 公共层 + 卷：书桌、书（封面、命书、翻页、书的话与动作）、桌上的器物、印章、声音、摇动控制、观人术、命盘、四态结局、分享图、通灵都在
src/core/；每一卷只写自己的器物、数据、规矩和命书的页（src/juan/<id>/），在 src/juan/index.js 注册。
- 按真实习俗：六十甲子签依甲子至癸亥排列，五行取纳音；掷筊规矩依闽台庙宇。
- 按真实物理：签筒的倾角、竹签的弹跳、落签都由物理模拟驱动，手机上用加速度计。
- 隐私：操作记录只存在你自己的设备上。只有勾选"通灵模式"时，你写下的问题才会发给云端 AI，且不保存。
本地运行
需要 Node 22.12 以上（package.json 的 engines）：
npm install
npm run dev # http://localhost:8788
npm run build # 构建到 dist/
npm run preview # 预览构建结果
开发服务器不带 Functions，通灵模式不可用（页面照常显示离线判词）。连同通灵模式（Workers AI）一起调试：
npm run build && npx wrangler pages dev dist --ai AI
本地调用 Workers AI 也会走你的 Cloudflare 账户。
部署自己的一份
-
建 D1 数据库并建表（通灵模式的按天限流计数）：
npx wrangler d1 create suantianji
npx wrangler d1 execute suantianji --remote --file migrations/0001_hits.sql
-
把 wrangler.toml 里的 database_id 换成上一步输出的值。
-
部署：
npm run build
npx wrangler pages deploy dist --project-name <你的项目名> --branch main
不建数据库、不配 AI binding 也能玩，只是通灵模式不可用，结局页照常显示离线判词。限流阈值在 functions/api/oracle.js 顶部（默认每个 IP 每天 10 次、全站 200 次）。
目录
| 路径 | 内容 |
|---|
src/pages/ | 路由：index.astro 书桌、qian/、gua/、bu/ 各卷仪式与源流、about.astro、404.astro |
src/core/ | 公共层：Paper.astro 页面外壳（ClientRouter，书桌常驻）、Codex.svelte 常驻的书桌（天头栏 + 桌子 + 页脚）、BookFrame.astro / PageData.astro 页面交给书桌的内容、Ritual.svelte 一卷的运行、Spread.svelte 每一屏的登记、book/ 书（封面、命书的页与 WebGL 翻页、书的动作）、desk/ 桌上的器物、gloss.js 书的话、Seal.svelte 印章、audio.js 声音、shake.svelte.js 摇动控制、profile.js 观人术、loom.js 命盘、poster.js 分享图、oracle.svelte.js 通灵、paper/ + scene/ 案上字盘、styles/ 样式 |
src/juan/index.js | 卷的注册表与卷的接口说明（七卷的元数据：签、卦、卜已开，星、鸟、字、历 open: false） |
src/juan/qian/ | 签卷：game.svelte.js 一局的流程与结局映射、各屏的 Svelte 组件、book.js 命书的页、tube.js 签筒物理、jiao.js 掷筊、zhu.json 注、fortune-db.json 六十一支签与四种结局判词（gua/、bu/ 同构） |
public/ | 原样发布的静态资源：fonts/ 按站内用字裁出的字体子集 |
functions/api/oracle.js | 通灵模式的 Pages Function |
tools/subset-fonts.py | 重新裁字体子集（改了中文文案后要跑，依赖见 requirements.txt） |
tools/check-db.mjs | 校验签簿：七言四句、六十甲子顺序、五行与吉凶配平（CI 也跑） |
docs/DESIGN.md | 设计规范 |
许可
致谢
