仙 山 入 门 · 使 用 教 程

趣味国学 · 仙山日君阁

六十甲子日君 · 干支心性故事馆  |  从零上手到功能精通
站点:www.yuanka.com.cn 章节:14 节 适用:新用户 / 老用户 截图:站内实拍
第一部分 · 新手上手
1

这是什么站

一句话定位

「趣味国学 · 仙山日君阁」是一个以「六十甲子」为骨架的干支纪日文化站点。它把每天轮值的干支,拟人化为一位「日君」——执掌当日时序的山中仙者,共 60 位。每位日君各掌一门传统术数(六壬神断、三式合参、紫白九星等),用这门术数的意象来「品读心性」。

⚠️

第一条必读:本站是文学创作,不是算命。站点所有页面都反复声明——「所有内容仅为仙侠文学创作与心性品读娱乐,不是对过往事实查证,也并非对未来的预言,不构成人生、婚恋、职业、决策依据。」把它当一部可以互动的仙侠文学来读,才是它的正确打开方式。

核心概念:什么是「日君」

中国传统的干支纪日法,用「天干(10)× 地支(12)」两两相配,六十组为一个循环,称为六十甲子。每一天都对应一个干支,例如「戊申日」「己酉日」。

本站的创意在于:把这 60 个干支,每一位都塑造成一位有名字、有性格、有专属术数的「日君」。比如:

干支日君专属术数术数要义
丁未缪丙日君六壬神断六壬诸课之断诀,取象类神,直指人事之隐衷
戊申徐浩日君三式合参太乙奇门六壬兼用,参印互证,观天地人事合一之势
己酉程宝日君紫白九星年月九星飞泊,断流年吉方,明宅运气之旺衰

站点四大板块

板块内容路径门槛
六十日君昨日 / 今日 / 明日,各有一位当值日君,可打卡收集首页 / 图鉴免费
术数仪器台24 件排盘、起卦、查算工具,打开即用/tools全免费
术法入门60 门讲义,每门 8 讲,从零到能上手/tools 内全免费
万年历公历农历干支互查、343 城真太阳时、开放 API/wannianli查算免费
匹配与合盘干支匹配找最佳搭档(姊妹站「趣味互动」)、2~15 人团队合伙合盘、今日运势(会员)——详见第 11 节www.yuanka.cc / /tools/team免费
💡

记住一句话就够:「读故事要解锁,玩工具全免费」。日君故事是内容消费,有解锁与会员机制;而术数工具、讲义、万年历这些「硬功能」,站方明确全部免费开放。

↑ 回到本节顶部
2

首页导读:三日君

进门第一眼

首次打开首页,会先弹出一张免责声明卡——需要勾选「我已知晓以上声明」才能点「进入仙山」。这不是多此一举,而是站方对内容定性的明确表态,建议每位新用户都读一遍。

首页免责声明弹窗
图 2-1首访声明弹窗:勾选后才能进入。声明内容是「本书为仙侠意象文学创作……不构成人生、婚恋、职业、决策依据」

进入后,页面的绝对主角是三张日君卡,对应时间轴上的三个位置:

首页全貌
图 2-2首页全貌:顶部导航 → 三张日君卡(昨日/今日/明日)→ 仙山四景 → 站友之约
位置含义卡片按钮解锁条件
🌅 昨日日君回望过往免费体验 · 昨日回望终生一次免费,用掉即止
☀️ 今日日君立足当下今日独占 · 会员 / 打卡解锁每日打卡即可点亮
🌙 明日日君展望来日明日展望 · 会员 / 打卡解锁仅会员,免费用户不可解锁

每张卡片上的两个入口

点开任一日君卡,你会发现它有两种进入方式,这是新手最容易混淆的地方:

  • 主按钮(如「免费体验 · 昨日回望」)——走生辰推算路线,需要填写出生年月日时。适合想知道「关于我自己」的品读。
  • 「🔮 独门推算(无需生辰)」按钮——不需要出生时辰,只要道出当下心中一念(一句短话或一个词)即可。适合随手一问、不想填生辰的用户。
🔑

关键规则:独门推算不是绕过解锁的旁路。它和生辰推算共用同一次机会——先用掉的那一次扣。也就是说,未解锁的日君,光靠独门推算也进不去。这一点站方在帮助页专门强调了。

↑ 回到本节顶部
3

三分钟上手流程

最快走通一次完整体验

如果你只想尽快玩明白一次,照着下面五步走,三分钟就能跑通完整链路。

  1. 打开首页,通过声明弹窗

    访问 www.yuanka.com.cn,勾选免责声明后点「进入仙山」。

  2. 选择一位日君

    建议新手从「昨日日君」入手——因为它是唯一一次永久免费、可以直接看到完整推算的机会,先拿它熟悉流程最划算。

  3. 选择进入方式

    想用生辰推算,就点主按钮;不想填生辰,就点「🔮 独门推算(无需生辰)」。

  4. 进入「与日君对话」准备页

    页面会展示这位日君的身份、专属术数、今日取象,以及你的一次「术法入门」小课。

  5. 提交,获得心性故事

    系统给出该日君基于本门术数的取象与心性品读长文。免费版只给开头预览,会员可读全篇。

与日君对话准备页
图 3-1「与日君对话」准备页:左侧日君身份与专属术数,右侧「选择推算方式」——填得生辰 / 独门推算两个入口

准备页信息量很大,值得逐块看:

顶部
日君立绘 + 干支 + 姓名 + 专属术数,例如「丁未|缪丙日君 · 六壬神断」
术法入门
这门术数的历史渊源、要旨与原理、常见知识点——相当于一次免费的微课
本门今日取象
当日这一门术数的具体取象结果(含课体、三传等专业信息),并配一句「通俗说」帮你理解
本日君权益
清楚标注:昨日回望剩余次数、今日是否已解锁、明日与其余日君的状态
✅

全站只有一个推算入口。无论是日君卡、图鉴还是打卡记录,最终都会进入同一个「与日君对话准备页」(/prep),在那里选择填生辰、用已有档案或独门推算。不用到处找入口。

↑ 回到本节顶部
4

免费能做什么

先摸清免费的天花板

免费用户一共有两条路径,另外还有一整套永久免费的工具区。

权益说明次数
🌅 昨日回望第一次推算可免费回望「昨日日君」完整推算终生 1 次
☀️ 今日打卡每天打卡点亮当天当值日君,获得 1 次推算机会每天 1 次
🧰 站内工具工具库 24 件仪器、万年历查算、60 门讲义无限免费

关于「打卡」的两个重要细节

  • 打卡机会可累积、长期保留。当天不用也没关系,以后再来用都行——不会过期。
  • 集齐 60 位之后会停止提供新推算。等六十甲子日君全部集齐,站点不再提供新的推算,但仍然可以回看已解锁的历史(历史正文不会被锁死)。
⚠️

免费用户拿不到「明日」。「明日(未来)」的日君免费不可解锁——想知道明天,必须开通会员。这是免费与付费之间最硬的一条界线。

↑ 回到本节顶部
第二部分 · 功能详解
5

日君图鉴

六十位收集系统

入口在首页「六十日君 · 轮值品读」卡片,或直接访问 /atlas。这里是 60 位日君的总陈列馆,也是收集进度的可视化面板。

日君图鉴
图 5-1日君图鉴(未登录 / 未解锁状态):顶部进度「已收集 0 / 60」→ 三日君快捷区 → 60 张卡片。灰度「未解锁」,已点亮的显示彩色立绘

页面结构

  • 顶部进度条——「已收集 N / 60」,一眼看清收集了多少。会员可直达 60/60。
  • 三日君快捷区——昨日 / 今日 / 明日 三位当值日君的快捷入口。
  • 60 张日君卡——按六十甲子顺序排列(甲子金辨 → 乙丑陈材 → …… → 癸亥虞程),每张标注干支 + 日君名 + 解锁状态。
📌

灰度 = 未解锁,彩色 = 已解锁。免费用户每天打卡点亮一位,进度一点点往前推;会员则可一次性解锁全部。这也是这个站点最像「游戏」的部分——收集感很强。

点开一位日君能看到什么

点击任意已解锁日君,进入其档案页,可以看到:

  • 干支身份与日君名讳(如「戊申|徐浩日君」)
  • 所掌术数及要义(如「三式合参」)
  • 心性方向与守则
  • 进入推算的入口按钮
↑ 回到本节顶部
6

术数仪器台

24 件工具 · 全部免费

入口:顶部导航「工具库」,或 /tools。这是全站最「硬核」的部分——不需要会员、不需要登录即可使用。全部 24 件仪器「打开即用」。

工具库顶部
图 6-1工具库顶部:今日值守三日君(各有其术)+ 术数仪器台(填条件即出盘 · 共 24 件)

24 件工具全清单

按功能归类,方便你快速找到需要的那一件:

🎴 起卦类(心有所问,起一卦看象)

☯梅花易数
时间起卦。把当下年月日时换成三个数,取上卦、下卦与动爻,得本卦、互卦、变卦三象。
🪙金钱六爻
三枚铜钱掷六次,按 6/7/8/9 装出六爻:纳甲、六亲、世应、六神一次列全。
🔢数字起卦
任给两组数字(或一段话的字数),是最省事的一路起卦法。
🪷大衍筮法
三变成一爻、十八变成一卦,逐爻列出分二、挂一、揲四、归奇的每一变。
✍️测字
写一个字或一串字,按总笔画分半取上下卦、加时支定动爻。
🀄京房八宫
铺开乾兑离震巽坎艮坤八宫六十四卦,标出每卦的世爻与应爻。

📇 命盘类(以生辰排盘)

🎴四柱八字排盘
排出年月日时四柱,附五行分布、十神、藏干、纳音与大运。
✨紫微斗数宫盘
安命宫、身宫,以命宫纳音定五行局,铺开十二宫。
⚖️袁天罡称骨
按农历年月日时四柱查骨重,四者相加得总骨重。
💞八字合婚
录入双方四柱,比照日干五合、年支日支六合、日主五行生制与纳音。
👥多人合伙 · 团队契合度
录入 2~15 位成员生辰档案,两两结构分双向平均得集合契合分,看团队五行互补与最佳搭档。

🧭 盘局类(排一个完整局)

🧭奇门遁甲时盘
按节气三元定阴阳遁与局数,值符值使与八门八神入九宫。
⚖️大六壬
以月将加时辰定天地盘,起四课,依课体取三传。
🎯太乙神数
按二十四节气三元定七十二局,布十六神与计神方位。
♾️皇极经世
以元会运世推算当下所处的会、运、世与年,并定出值年卦。

📅 历法类(查日子)

📅干支速查盘
给一个日期,一次看全:农历、四柱干支、纳音、生肖、二十八宿与当值日君。
🎼六十甲子纳音
铺开三十纳音及其五行所属,定出当日干支落在哪一音。
🖼️日君轮值盘
以当日干支定当值日君,列出前后各七日的轮值与立绘。
🕰️真太阳时校准
按当地经度与当日均时差,把钟表时间换算为真太阳时。
📆择日 · 黄历建除
定当日干支、月令与建除十二神,并列出该日所宜所忌。

🌌 星象与风水类

🌌二十八宿
以当日儒略日对周天二十八宿取余,定出当值之宿。
🪐七政四余
推日月五星黄经,再加罗睺、月孛、紫气、计都四余。
🧿玄空飞星
定三元九运排出运盘,起山星与向星,山向星与运星同布九宫。
🧭罗盘二十四山
给一个方位角,定出所落之山、所属之宫、三元龙与阴阳。

工具体验设计:两处值得称道的地方

  • 「本门起法」教学卡——每个工具顶部都有一段口诀式说明,讲清这门术数的取数逻辑,还附「心法」与「禁忌」。比如梅花易数会提示「一事一占,不戏占、不试占」。
  • 取数过程可复算——结果页会逐步列出计算过程(如「36 ÷ 8 余 4 → 震」),同一输入必得同一卦,完全透明,不做黑箱。
↑ 回到本节顶部
7

实操示范:梅花易数起卦

一步一步走完

以最常用的「梅花易数 · 时间起卦」为例,完整走一遍。

  1. 进入工具

    工具库中找到「梅花易数 起卦」,点「进入工具」,或直接访问 /tools/qigua。

  2. 了解本门起法

    页面顶部就是这门术数的取数逻辑与心法禁忌,建议先读再起。

  3. 设定起卦条件

    选择公历日期与时辰(如「未时 · 13:00–14:59」)。「所问之事」可留空,仅作记录。

  4. (可选)开启真太阳时校准

    默认关闭、按所选时辰推算。若想更精确,展开填写「钟表时间 + 所在地区」,系统自动折算真太阳时。

  5. 点击「起 卦」

    结果即时生成。

梅花易数起卦结果
图 7-1起卦结果页:卦象六爻 → 本卦/互卦/变卦三象 → 体用 → 取数过程逐句复算

结果怎么看

区块含义
卦象 · 六爻自下而上列出六爻阴阳,动爻单独标记(图中为「第 2 爻」)
本卦当下之象。如图取「震」卦,卦辞引《周易》原文
互卦中藏之象。取本卦二三四爻为下卦、三四五爻为上卦
变卦动后之象。动爻阴阳互易得出
体用动爻所在之卦为「用」,另一卦为「体」,以五行关系标记
取数过程逐句列出计算,可自行复算验证
⚠️

工具页底部有明确声明:「本站只呈现取数与卦象结构,不作吉凶祸福推断,亦不构成任何决策依据。」换句话说,它给你的是传统的排盘工具,解读留给你自己——这正是它「趣味国学」定位的体现。

↑ 回到本节顶部
8

实操示范:四柱八字排盘

全站功能最全的工具

四柱八字排盘(/tools/bazi)是 24 件工具里信息量最大的一件,也是理解「真太阳时」的最佳入口。

  1. 选择历法

    顶部可切换「公历 / 农历」,站内用同一套换算,两处结果一致。

  2. 报生辰

    填写出生日期与时辰。页面特别提示:按当地钟表时间填,不必先换算成北京时间。

  3. 选择性别

    性别用于定大运顺逆(男顺女逆等规则)。

  4. (可选)真太阳时校准

    填「钟表时间 + 出生地(国家/省/市)」,系统按当地经度自动折算。选好城市后经度会自动填入。

  5. 点击「排 盘」

    生成完整命盘。

四柱八字排盘结果
图 8-1八字排盘结果:四柱干支 → 藏干十神纳音 → 五行分布 → 十神 → 大运 → 大师级盘面

结果字段速查

区块内容
四柱年柱、月柱、日柱(日主)、时柱,各含天干、地支
藏干 / 十神 / 纳音每柱的地支藏干、对应十神、纳音五行
五行分布四柱共 8 字的五行统计(木火土金水各几个)
十神以日主为我,比对年干/月干/时干定出的十神(劫财、伤官、正财等)
大运顺行/逆行、起运岁数,逐列出干支、十神、年龄段、对应年份
大师级盘面旺衰、喜用神、旬空、神煞、胎元、命宫、身宫、月令司令、干支合冲刑害等进阶信息
🔍

常见疑问:为什么我的时柱和别的软件不一样?多半是「真太阳时」口径差异。本站默认按当地钟表时间 + 经度校正来定时辰,而很多软件直接用北京时间。出生地越靠西(如新疆、西藏),差异越明显。想对齐,就在本站开启真太阳时校准填出生地即可。

↑ 回到本节顶部
9

万年历与真太阳时

343 城真太阳时校准

入口:首页「万年历 · 干支查算」卡片,或 /wannianli。这是一个独立于日君体系的实用工具页。

万年历页面
图 9-1万年历:左侧月历(标注每日干支与日君)+ 右侧当日详情 + 四柱查算区

三大功能

干支万年历
月历视图,每天标注「农历日名 + 当日干支(值日太岁)」。点任意日期查看当天详情,含农历、生肖、值日太岁日君。
四柱查算
输入公历日期 + 出生钟点 + 出生地,推算年/月/日/时四柱。可切换「农历转公历」。
开放 API
会员专享,见第 13 节。

什么是「真太阳时」,为什么它重要

我们日常用的钟表时间,是全国统一的「北京时间」(东八区标准时)。但中国横跨 5 个时区,同一条时刻,乌鲁木齐和上海的实际日照位置差了近 2 小时。

传统术数讲究「以当地真实天象定时辰」,所以要按出生地经度做校正——这就是真太阳时。

换算法则(记住这一条就够)

出生地经度与东经 120° 每相差 1 度,真太阳时相差约 4 分钟。

例:乌鲁木齐约东经 87.6°,距 120° 差 32.4 度 → 约 130 分钟(2 小时 10 分)的时差。这可能让原本「午时」的出生时间落回「巳时」,进而改变时柱。

🌏

不填出生地也完全可用。真太阳时校准是「可选增强」,不填时按北京时间推算,不影响工具正常出盘。想更贴古法,就填上出生地。

本站采用的历法口径(开发者重点)

  • 年柱:以立春为界换年(不是元旦)
  • 月柱:按十二节令换月,以节气精确时刻为界
  • 日柱:以当地真太阳时晚子时(23:00)换日
  • 时柱:按五鼠遁起时,并依出生地经度做真太阳时校正
  • 农历:公元 1900–2100 用权威历法数据表(口径与紫金山天文台农历公告一致);表外年份用天文历法算法(朔望月 + 太阳黄经中气 + 无中气置闰)
  • 可推算范围:公元 1 年 1 月 1 日 至 9999 年 12 月 31 日
↑ 回到本节顶部
10

术法入门讲义

60 门 · 每门 8 讲

这是全站最容易被忽视、但价值极高的免费内容。60 门术数,每门 8 讲,从零到能上手——完全免费,无需会员。

讲义入口在哪里

两处都能进:

  • 每个工具页顶部的「本门起法」卡 + 「开始讲解」按钮——针对该工具对应的术数
  • 工具库中每个工具卡片都配有讲义入口

一门讲义的八讲结构

模块内容
① 概述这门术数回答什么问题、在族中担什么角色
② 源流托名与成书、代表典籍、与本族其它门的分工
③ 原理术语对照、必备常数与口诀,讲清底层逻辑
④ 起法手把手分步演示,一步不落
⑤ 读法看的顺序与观察维度,逐爻 / 逐宫的气象
⑥ 实例用真实案例逐步走一遍
⑦ 练习一道可动手的练习题与常见误读
⑧ 书目原典与今人入门书

以「与日君对话准备页」为例,其中的「术法入门」区块就是这门课的精简版:历史渊源 → 要旨原理 → 常见知识点,用几百字把一门术数讲明白。

📖

建议学习路径:先在工具库选一件你感兴趣的工具(如梅花易数)→ 读它的入门讲义 → 用工具实际起卦 → 对照结果里的「取数过程」验证理解。这样学一遍,比纯看文字有效得多。

↑ 回到本节顶部
11

本站特色:干支匹配 · 合伙合盘 · 今日运势

日君故事之外的三大「算得动」功能

除了读日君故事、玩排盘工具,本站还有三块「用你的生辰实际算起来」的特色功能。它们与日君体系互相独立,规则各不相同,这一节一次讲清。

特色一:干支匹配 · 寻找最佳搭档(趣味互动站)

这是本站的姊妹应用「趣味互动」(www.yuanka.cc)——主站账号直接登录,无需重复注册。入口:登录后访问会员中心页的「趣味互动 · 干支匹配」横幅,或直接打开 www.yuanka.cc。

  1. 提交生辰,生成「契合谱」

    填写出生日期时间(公历/农历均可,出生地可选真太阳时校正)。程序对全池 518,400 种有效八字组合逐一打分,铺成 0~100 分、二十档的「全谱契合榜」,每档一个「代表八字」——从最合到最不合,一张谱看完。

  2. 按档找人,发送邀请

    点开任一分档可查看「命中会员」(主动开启展示的注册会员),给感兴趣的人发送「邀请认识」,附一句留言。

  3. 对方同意,双方互认

    邀请被接受后双方成为「互认」关系:可以看彼此的完整八字、照片视频与地区,并生成「双盘报告」——两人八字逐柱对比的详细解读(婚姻/合伙两种视角)。

🔒

隐私规则(重要):未互认之前,别人看到的你的八字是「年柱·月柱·**·**」——日柱与时柱以 ** 代替,防止被反推生辰;你自己的八字永远完整可见。照片、视频等媒体也是「不点不开」,且互认前仅显示打码缩略。所有展示与否的开关都在趣味互动站的「个人中心」。

特色二:多人合伙 · 团队契合度(/tools/team)

给团队、合伙、搭班子用的免费工具:录入 2~15 位成员的生辰档案(每人一行,支持公历/农历、性别、出生地真太阳时),系统会:

  • 计算成员两两之间的结构契合分,并双向平均汇总成整个团队的「集合契合分」(两人互相看的角度不同,双向平均才公平);
  • 给出团队五行结构互补分析——缺什么、旺什么、谁和谁最搭;
  • 结果页底部有「⚡ 一语道破天机」悬浮条,可一键生成团队结构的专业解读(每次消耗 1 次解读额度)。

特色三:今日运势(/fortune)

会员专属。每天以你的主八字为基准生成当日指引:以当日干支代入你的四柱重新计算,给出今日的结构强弱与宜忌提示。当天自动更新、不消耗推算次数;想针对具体某事细问,用「每日一问」加问(该次消耗额度)。

💡

怎么选:想找人合作、看缘分 → 去干支匹配;已有班子想看整体合不合 → 用多人合伙;每天想看一眼今天的提示 → 今日运势。三者都以传统五行结构计算,同样仅供传统文化趣味参考。

↑ 回到本节顶部
12

会员体系与解锁规则

39 元/月 · 额度怎么算
会员开通页
图 12-1会员开通页:39 元/月,九项权益

会员九项权益(与开通页一致)

权益说明
📜 完整日君心性故事 · 不设截断免费版只给开头预览,会员全篇品读一字不少;明日的日君对会员先行开放,不必等
🧭 六十位日君 · 全部可算60 位全部开放,点任意一位都排出完整心性故事;会员期内漏看的日子一次性补齐,不留空白
🔮 「今日运势」整页专属当日四柱、当值日君、历法常识 + 基于你主八字的 AI 每日指引,每日更新
💬 每日一问 · 想问几次问几次向当值日君追问心事:当日首次免费,之后加问消耗推算次数(与故事共用同一额度池),会员享有充足次数
🛠 术数仪器台 · 一语道破天机二十余门仪器的盘面都可让模型逐块讲透,每次消耗 1 次推算次数
🔗 趣味互动站 · 同账号通用会员身份在 www.yuanka.cc 同步生效:未来 12 年流年刻度与双盘关系报告为会员专享;每日邀请额度 5 封 → 20 封
📚 历史故事 · 永久完整回看过往生成的每段心性故事完整归档,随时一键重读
✨ 尊贵标识 · 专属体验会员专属黄金身份标识,全站服务优先与更稳定的 AI 响应
🗺️ 六十日君图鉴 · 全量解锁60 位全部点亮:干支身份、太岁名讳、专属术数、心性方向与守则一览无余,收藏进度直达 60/60

开通与续费(自助在线)

登录后访问「会员开通」页(/payment):选择时长 → 在线扫码支付 → 支付成功即时到账、会员有效期自动顺延,无需人工等待。会员列表页(/member)的「开通会员 / 续费」按钮也直达该页。开通记录可在会员中心的「财务明细」里核对。

额度规则(最容易算错的地方)

核心公式
推算总次数 = 会员总天数(每 1 天会员时长 = 1 次完整推算)
剩余次数
剩余 = 会员总天数 − 已用次数,用完即为 0 并自动提示
续费累加
每个订单在原到期日基础上增加 31 天,推算总天数随之累加,不会重置已用次数
到期后
期内未用完的次数到期后不可再用;重新开通按新周期重新起算
永久会员
不受到期影响,按 31 天滚动周期计次

额度相关:三条站方提醒

  • 额度其实很宽裕。39 元/月 约 31 天 = 31 次推算,而全站总共 60 位日君——开一个月基本能覆盖大半。
  • 额度用在哪看得见。登录后,图鉴 / 会员中心会显示当前周期的剩余推算次数。
  • 今日运势不消耗次数。会员每天可看「今日运势」(/fortune)——以你的主八字为基准生成当日指引,当天自动更新、不消耗推算次数;只有「每日一问」的加问才消耗额度。

会员额外福利:万年历 API

会员每天可调用 500 次万年历干支查算接口(次日自动重置),可在文档页创建专属 API 密钥。开发者用户价值的核心就在这里,详见下一节。

↑ 回到本节顶部
第三部分 · 进阶
13

万年历 API

开发者接入指南

入口:/wannianli/api。把干支查算能力接进你自己的小程序、网站或应用——会员专享,每日 500 次。

万年历 API 文档
图 13-1万年历 API 文档:历法算法说明 → 接口说明 → 在线调试 → 返回字段与调用示例 → 地区编号对照表

请求契约

请求地址
GET /api/wannianli/query
输入方式
两组二选一:传 date(公历),或传 lunar_year(农历,此时忽略 date)
鉴权
① 会话方式(登录会员的会话 Cookie);② API 密钥方式(免登录,支持 IP 白名单)
两种密钥传法
-H "Authorization: Bearer <密钥>" 或查询参数 api_key=<密钥>

关键参数

参数说明
date公历日期,格式 YYYY-MM-DD(公历模式,与农历字段二选一)
lunar_year/month/day/leap农历输入;lunar_year 取 0-9999,其中 0 表示公元前 1 年(天文纪年 0 年)
hour出生钟点 HH:MM(如 04:30)触发真太阳时修正;只传地支名(如「午」)按该时辰直接取柱、不做修正;留空则时辰不详
region_code 强烈推荐出生地地区统一编号,形如 CN-00246(中国·湖南省·张家界市)。纯 ASCII、免中文 URL 编码、免同名歧义
province / region / lon汉字省名 / 城市名 / 手填经度。优先级:region_code → lon → province+region

推荐调用写法

官方给出的推荐写法是只传 region_code——一个纯 ASCII 参数即锁定全球任意最小单位地区:

curl -G "https://www.yuanka.com.cn/api/wannianli/query" \
  --data-urlencode "date=2026-09-19" \
  --data-urlencode "hour=04:30" \
  --data-urlencode "region_code=CN-00246" \
  -H "Authorization: Bearer <你的API密钥>"
⚠️

两个高频踩坑点(官方文档专门标注):
① Windows cmd 默认 GBK,中文参数会编码错乱并静默失效——接口照样返回 code=0,但 data.lon 为 null、地区未生效。解决办法:改用 region_code,或确保终端为 UTF-8。
② cmd 续行符是 ^ 不是 \,请把命令写成一行,否则参数会被吞掉、-H 请求头也可能失效(表现为误报 401)。

返回字段

字段内容
auth本次鉴权方式:session 或 api_key
date / week公历日期与中文星期
lunar农历信息:年/月/日、是否闰月、中文表述、生肖
bazi四柱(年/月/日/时),每柱含 gan / zhi(序号)与 name(干支名)
duty值日太岁日君(如「甲子|金辨日君」)
lon / lonFrom本次解析到的经度及来源(region / manual / none)
region解析出的出生地,含 code / province / name / lon / lat。可用返回的 code 核对地区是否与预期一致
used / limit / remain今日已用 / 上限 / 剩余次数
disclaimer强制免责声明文本

错误码

状态码含义
400参数无效(date 格式非法 / 农历日期不存在 / region_code 无效)
401未登录(未携带会话 Cookie 或有效 API 密钥)
403无权限(非会员,或 IP 不在白名单内)
429超额(今日额度已用完)

配套地区编号接口

  • GET /api/region/codes?cc=CN — 按国家取地区编号子集(format=csv|txt|json)
  • GET /api/region/lookup?code=CN-00246 — 按编号反查地区
  • GET /api/region/towns?cc=CN&admin=湖南省 — 查某省下的城市(含编号)
  • 编号表可免费下载(无需鉴权):/download/region-codes.csv / .txt / .json,全球共 48390 个最小单位地区
↑ 回到本节顶部
14

FAQ 与术语小词典

把疑问一次清空

常见问题

Q1:为什么有些日君点不了?

免费用户需先完成今日打卡点亮当天当值日君;昨日只免费一次(终生一次,用完即止);明日及未解锁的日君会显示「未解锁」。注意:「独门推算」同样要求先解锁,不是绕过门禁的旁路。可以按规则打卡,或开通会员解锁全部。

Q2:「剩余次数」在哪里看?

登录后,图鉴 / 会员中心会显示当前周期的剩余推算次数。

Q3:额度到底怎么算?

开通日起,推算总次数 = 当前会员总天数;每次续费时长累加,已用次数保留,剩余次数实时更新。每次续费在原到期日基础上 +31 天。

Q4:在哪里开始推算?

全站只有一个入口:日君卡 / 图鉴 / 打卡记录都会进入「与日君对话准备页」(/prep),在那里选择填生辰、用已有档案或独门推算。

Q5:什么是真太阳时?需要校准吗?

工具里的可选增强:按出生地经度把钟表时间折算回真太阳时,时辰判定更贴合古法;不填也不影响使用,此时按北京时间推算。在各工具顶部的「真太阳时校准(可选)」即可开启。

Q6:推算机会用完了怎么办?

免费用户每天打卡即可获得当日日君的 1 次推算机会(可累积、长期保留);需要更宽裕的额度可开通会员,每 1 天会员时长 = 1 次推算。

Q7:术法入门教学在哪里看?

「工具库」中的术数工具均配有「术法入门」教学卡:共 60 门,每门 8 讲,含术语对照表、逐例演示与练习题,全部免费阅读。

Q8:集齐 60 位日君之后会怎样?

每天打卡点亮一位;等六十甲子日君全部集齐后,将不再提供新的推算,但仍可回看已解锁的历史(历史正文不会被锁死)。

术语小词典

术语说明
干支天干(甲乙丙丁戊己庚辛壬癸)与地支(子丑寅卯辰巳午未申酉戌亥)的组合,用于纪年纪月纪日纪时
六十甲子天干地支两两相配形成的 60 组循环,本站 60 位日君即对应这 60 组
日君本站独创概念:当值干支的拟人化仙者,执掌当日时序
值日太岁当日干支对应的年神,本站即以干支对应日君
四柱年柱、月柱、日柱、时柱,共八个字,故又称「八字」
真太阳时按当地经度校正后的实际太阳时间,区别于全国统一的钟表时间
打卡每日登录点亮当天当值日君,获得 1 次推算机会
独门推算无需生辰,仅凭当下心中一念取象的推算方式,与生辰推算共用机会
取象依据术数规则从时间/数字等信息中取出卦象或课体
📮

站方联系方式:mail#yuanka.com.cn(把 # 换成 @)。备案号:渝ICP备2024019901号-8。

↑ 回到本节顶部

本教程说明:内容基于站点 www.yuanka.com.cn 的实际页面整理(2026-10-01 初稿;2026-10-05 增补「本站特色」、多人合伙与在线开通续费,工具数更新为 24 件),截图为站内实拍。站点功能与规则若有更新,请以线上实际页面为准。

内容定性:本站所有内容仅为仙侠文学创作与心性品读娱乐,并非对过往事实查证,亦非对未来的预言,不构成人生、婚恋、职业、决策依据。本教程仅供使用参考。