# 超群学道网 (cq2.cn) — 机器可读完整文档 > 本文档面向 AI 搜索引擎、爬虫及数据集成方,提供超群学道网的完整技术文档。 > 更新日期:2026-08-18 --- ## 1. 站点概述 **超群学道网** 是面向全球华人的传统文化与民俗工具站群,涵盖黄历、万年历、八字排盘、取名、解梦、节气、星座、生肖、汉字字典、诗词古籍、对联、民俗志等 20+ 个内容模块。 - **运营主体**:重庆学道科技有限公司 - **主域名**:www.cq2.cn - **泛域名**:*.cq2.cn(每个内容模块独立子域名) - **技术栈**:nginx + PHP 8.3 + MySQL 8 + Redis + Laravel 13 - **静态化策略**:核心内容预生成真静态 HTML,TTFB < 100ms - **内容来源**:权威开放数据集(makemeahanzi、chinese-poetry、ctext)+ AI 辅助解读 + 人工审核 - **多端支持**:PC、H5、微信小程序、App(移动端源码独立仓库) --- ## 2. 站群子站完整列表 ### 2.1 门户与万年历 | 子域名 | 模块 | 内容 | 特色功能 | |---|---|---|---| | www.cq2.cn | 门户首页 | 全站聚合入口 | 热点地图、搜索词云、模块导航 | | wnl.cq2.cn | 万年历 | 月历 + PWA 单屏页 | 前端 lunar.js 实时算、可离线 | ### 2.2 黄历与择吉 | 子域名 | 模块 | 内容 | 特色功能 | |---|---|---|---| | rl.cq2.cn | 老黄历 | 1900-2100 黄历数据 | 每日评级、特殊凶日、术语 tooltip、罗盘、公农历互转 | | rl.cq2.cn | 择吉 | 24 种择吉项目 | 结婚、搬家、出行等场景化择日 | ### 2.3 命理与运势(仅 Web/App,小程序 403) | 子域名 | 模块 | 内容 | 特色功能 | |---|---|---|---| | bz.cq2.cn | 八字排盘 | 四柱/神煞/刑冲/大运流年 | 合婚、真太阳时、会员存盘、命盘海报 | | qm.cq2.cn | 取名 | 八字喜用联动 | 辈分避讳、测名报告、证书海报 | | jm.cq2.cn | 解梦 | 1,519 条周公解梦 | AI 解梦(配额闸) | | xz.cq2.cn | 星座 | 12 星座运势 | 5 维 4 周期前端算、144 配对页、塔罗/水逆 | | sx.cq2.cn | 生肖 | 12 生肖今日运势 | 144 配对页、前端 crc32 与 PHP 对拍一致 | | cg.cq2.cn | 称骨算命 | 批语落库可编辑 | 42 种骨重 | | haoma.cq2.cn | 数理 | 纯前端多体系引擎 | 号码不上传即隐私卖点 | | wx.cq2.cn | 五行穿衣 | 每日五行穿搭 | standalone=false,另有 www 顶层 /wuxing 文化中心 | ### 2.4 字典与文化 | 子域名 | 模块 | 内容 | 特色功能 | |---|---|---|---| | zi.cq2.cn | 汉字字典 | 9,533 字 | 拼音、部首、笔画、五行、五笔、电报码、字形演变 | | ci.cq2.cn | 词语词典 | 58,559 词 | 拼音、释义、出处、近义/反义词 | | shu.cq2.cn | 古籍书库 | 42 部 / 1,174 章 | AI 白话解读、分屏对照阅读、逐字注音 | | shici.cq2.cn | 诗词歌赋 | 10,827 首 | 按体裁分版面、逐字注音(国语/粤语)、诵读 | | dl.cq2.cn | 对联大全 | 对联分类 | AI 对对联(配额+冷却)、春联海报 | | mj.cq2.cn | 诗词名句库 | 名句聚合 | 按主题分类 | | msu.cq2.cn | 民俗志 | 各地民俗/世界非遗 | 分级审核 | ### 2.5 百家姓与历史 | 子域名 | 模块 | 内容 | 特色功能 | |---|---|---|---| | bjx.cq2.cn | 百家姓寻根 | 472 姓 | 字辈族谱 UGC 众包(先审后发) | | mr.cq2.cn | 历代名人库 | 782 条 | 朝代浏览、照片版权合规 | | jt.cq2.cn | 历史上的今天 | 366 天 / 1,111 条 | 红线类目仅 admin 可清审 | ### 2.6 文章与工具 | 子域名 | 模块 | 内容 | 特色功能 | |---|---|---|---| | gj.cq2.cn | 学道文化箱 | 聚合入口 | standalone=false | | mi.cq2.cn | 灯谜歇后语 | 灯谜 + 歇后语 | 分类浏览 | | jfzh.cq2.cn | 简繁异名对照 | 820 条 | 客户端分页/筛选 | ### 2.7 其他 | 子域名 | 模块 | 内容 | 特色功能 | |---|---|---|---| | user.cq2.cn | 会员中心 | 会员功能 | 强制走此域名 | | api.cq2.cn | API 合作 | 开放数据订阅 | 未开工 | | m.cq2.cn | 移动版 | 预留 | module=null | --- ## 3. 内容数据统计 | 模块 | 数据量 | 说明 | |---|---|---| | 汉字字典 | 9,533 字 | makemeahanzi 数据集 + 补字 | | 词语词典 | 58,559 词 | 含成语、词语、释义 | | 诗词歌赋 | 10,827 首 | chinese-poetry 数据集 + AI 解读 | | 古籍章回 | 1,174 章 | 42 部典籍,AI 白话解读 | | 周公解梦 | 1,519 条 | 分类词条 + AI 解梦 | | 简繁异名 | 820 条 | 词级 + 字级转换 | | 对联 | 数千副 | 分类 + AI 生成 | | 百家姓 | 472 姓 | 字辈族谱 UGC | | 历代名人 | 782 条 | 朝代分类 | | 历史上的今天 | 1,111 条 | 366 天日期页 | | 民俗志 | 数百条 | 分级审核 | | 灯谜歇后语 | 数百条 | 分类 | | 黄历数据 | 1900-2100 | 7 万+ 日历数据 | | 星座配对 | 144 页 | 12×12 全排列 | | 生肖配对 | 144 页 | 12×12 全排列 | | 五行文化 | 120 年 | 1924-2043 年份页 | | 省考数据 | 43 条 | 31 省覆盖 | **总静态 HTML 文件**:约 73,800 页 --- ## 4. 机器友好接口 ### 4.1 JSON API(门户域名) | 接口 | URL | 方法 | 说明 | |---|---|---|---| | 黄历 JSON | `/api/v1/almanac/{YYYY-MM-DD}` | GET | 指定日期黄历数据 | | 万年历月历 | `/api/v1/almanac/month/{YYYY-MM}` | GET | 月历数据 | | 农历转公历 | `/api/v1/lunar-to-solar` | GET | 农历→公历换算 | | 节气列表 | `/api/v1/jieqi` | GET | 二十四节气 | | 节气详情 | `/api/v1/jieqi/{key}` | GET | 单节气详情 | | 历史上的今天 | `/api/v1/history/day` | GET | 当日历史事件 | | 历史月历 | `/api/v1/history/month` | GET | 月度历史事件 | | 法定节假日 | `/api/v1/holidays` | GET | ?ym=\|year=®ion=cn | | 天气 | `/api/v1/weather` | GET | GeoIP 定位天气 | | 公共事件 | `/api/v1/public-events` | GET | 考试/公考倒计时 | | 考试阶段 | `/api/v1/exam/phases` | GET | 阶段清单 | | 汉字列表 | `/api/v1/hanzi` | GET | ?page=&q= | | 汉字详情 | `/api/v1/hanzi/{slug}` | GET | 单字详情 | | 词语列表 | `/api/v1/word` | GET | ?page=&q= | | 词语详情 | `/api/v1/word/{slug}` | GET | 单词详情 | | 诗词列表 | `/api/v1/poem` | GET | ?page=&q= | | 诗词详情 | `/api/v1/poem/{slug}` | GET | 单首诗词 | | 古籍列表 | `/api/v1/book` | GET | 书目 | | 古籍详情 | `/api/v1/book/{slug}` | GET | 书籍详情 | | 古籍章节 | `/api/v1/book/{slug}/{chapter}` | GET | 章节内容 | | 名人列表 | `/api/v1/person` | GET | ?page=&dynasty= | | 名人详情 | `/api/v1/person/{slug}` | GET | 单人详情 | | 对联列表 | `/api/v1/couplet` | GET | ?page=&category= | | 对联详情 | `/api/v1/couplet/{slug}` | GET | 单副对联 | | 名句列表 | `/api/v1/mingju` | GET | ?page=&theme= | | 名句详情 | `/api/v1/mingju/{slug}` | GET | 单句详情 | | 灯谜列表 | `/api/v1/riddle` | GET | ?page=&kind= | | 灯谜详情 | `/api/v1/riddle/{slug}` | GET | 单条灯谜 | | 百家姓列表 | `/api/v1/surname` | GET | ?page= | | 百家姓详情 | `/api/v1/surname/{slug}` | GET | 单姓详情 | | 百家姓字辈 | `/api/v1/surname/{slug}/contributions` | GET | 按省分组众包 | | 简繁对照列表 | `/api/v1/jfzh` | GET | ?page= | | 简繁对照详情 | `/api/v1/jfzh/{id}` | GET | 单条详情 | | 文章列表 | `/api/v1/article` | GET | ?category= | | 文章详情 | `/api/v1/article/{slug}` | GET | 单篇详情 | | 民俗志列表 | `/api/v1/minsu` | GET | ?page=®ion= | | 民俗志详情 | `/api/v1/minsu/{slug}` | GET | 单条详情 | | 城市列表 | `/api/v1/cities` | GET | 历法参照城市 | | 全站搜索 | `/api/v1/search` | GET | ?q=&module= | ### 4.2 Markdown 接口 | 接口 | URL | 说明 | |---|---|---| | 黄历 Markdown | `/huangli/{YYYY-MM-DD}.md` | 指定日期黄历 | | 解梦 Markdown | `/jiemeng/{slug}.md` | 解梦词条 | | 节气 Markdown | `/jieqi/{key}.md` | 节气详情 | | 汉字 Markdown | `/zi/{slug}.md` | 汉字详情 | | 词语 Markdown | `/ci/{slug}.md` | 词语详情 | | 对联 Markdown | `/duilian/{slug}.md` | 对联详情 | | 历史上的今天 Markdown | `/jintian/{MM-DD}.md` | 历史事件 | | 名人 Markdown | `/person/{slug}.md` | 名人详情 | | 百家姓 Markdown | `/surname/{slug}.md` | 姓氏详情 | | 民俗志 Markdown | `/minsu/{slug}.md` | 民俗详情 | | 古籍章节 Markdown | `/book/{slug}/{chapterSlug}.md` | 章节内容 | | 文章 Markdown | `/wenzhang/{cat}/{slug}.md` | 文章详情 | | 诗词 Markdown | `/shici/{slug}.md` | 诗词详情 | | 八字工具 Markdown | `/bazi.md` | 八字排盘科普 | | 八字合婚 Markdown | `/bazi/hehun.md` | 合婚科普 | | 取名工具 Markdown | `/qiming.md` | 取名科普 | | 测名 Markdown | `/qiming/ceming.md` | 测名科普 | | 五行取名 Markdown | `/qiming/wuxing.md` | 五行取名科普 | | 择吉 Markdown | `/zeji/{item}.md` | 择吉科普 | | 星座配对 Markdown | `/xingzuo/pei-{a}-{b}.md` | 星座配对 | | 星座配对 Hub Markdown | `/xingzuo/pei-{a}.md` | 单星座配对汇总 | **子域名 Markdown 接口**:所有子域名均可通过 `/{path}.md` 访问 Markdown 版本。 ### 4.3 前端异步接口(限流) | 接口 | URL | 方法 | 说明 | |---|---|---|---| | 广告投放 | `/api/v1/ads` | GET | 按区域返回广告代码 | | TTS 发音 | `/api/v1/tts` | GET | 文字转语音 | | 文章诵读 | `/api/v1/article/recite` | POST | 生成整篇音频 | | AI 对对联 | `/api/v1/duilian/pair` | POST | 出上联对下联 | | AI 解梦 | `/api/v1/jiemeng/ai` | POST | 自然语言解梦 | | 解梦搜索 | `/api/v1/jiemeng/search` | GET | 词条搜索 | | 内容打点 | `/api/v1/stat/hit` | POST | 阅读数 | | 内容点赞 | `/api/v1/stat/like` | POST | 点赞 | | 收藏 | `/api/v1/stat/favorite` | POST | 需登录 | | 访客追踪 | `/api/v1/track/visit` | POST | 热点地图数据 | | GeoIP | `/api/v1/geo/me` | GET | 当前位置 | | 热点地图 | `/api/v1/geo/heat` | GET | 世界访客分布 | | 热门地区 | `/api/v1/geo/top` | GET | 热门地区排名 | | 搜索词云 | `/api/v1/search/cloud` | GET | 搜索热词 | | 搜索日志 | `/api/v1/search/log` | POST | 记录搜索词 | | 我的日历 | `/api/v1/member/events/on-date` | GET | 个人事项 | | 月度事项 | `/api/v1/member/events/on-month` | GET | 月度事项 | | 公共事件 | `/api/v1/events/public` | GET | 考试等公共事件 | | 关注事件 | `/api/v1/events/follow` | POST | 关注公共事件 | | 考试选项 | `/api/v1/exam/options` | GET | 阶段/省级选项 | | 订阅考试 | `/api/v1/exam/subscribe` | POST | 考试提醒订阅 | | 取消订阅 | `/api/v1/exam/unsubscribe` | POST | 取消考试提醒 | ### 4.4 客户端 API(app.cq2.cn/v2/...) 面向微信小程序 + App 的 first-party 接口,使用 Sanctum token 鉴权。 **认证**: - `POST /v2/auth/wechat` — 微信登录 - `POST /v2/auth/baidu` — 百度小程序登录 - `POST /v2/auth/qq` — QQ 小程序登录 - `POST /v2/auth/douyin` — 抖音小程序登录 - `POST /v2/auth/alipay` — 支付宝小程序登录 - `POST /v2/auth/login` — 用户名/手机+密码 - `POST /v2/auth/sms` — 手机验证码登录/注册 **会员(需 token)**: - `GET /v2/me` — 个人信息 - `PATCH /v2/me/profile` — 更新资料 - `POST /v2/me/avatar` — 上传头像 - `GET /v2/me/points` — 积分 - `GET /v2/me/visits` — 访问记录 - `POST /v2/me/signin` — 签到 - `GET /v2/me/invite` — 邀请码 - `POST /v2/me/share` — 分享上报 - `POST /v2/me/subscribe` — 订阅消息授权 - `GET /v2/me/favorites` — 收藏列表 - `POST /v2/me/favorite` — 收藏/取消 - `GET /v2/me/notifications` — 通知列表 - `POST /v2/me/notifications/read` — 标记已读 - `GET /v2/me/feedback` — 反馈列表 - `POST /v2/me/feedback` — 提交反馈 - `POST /v2/surname/contribute` — 字辈众包 - `GET /v2/me/events` — 个人日历事项 - `GET /v2/me/event-names` — 常用事项名 - `POST /v2/me/events` — 新增事项 - `PATCH /v2/me/events/{id}` — 更新事项 - `DELETE /v2/me/events/{id}` — 删除事项 - `POST /v2/me/events/{id}/toggle` — 切换事项状态 - `GET /v2/exam/subscriptions` — 考试订阅列表 - `POST /v2/exam/subscribe` — 订阅考试 - `POST /v2/exam/unsubscribe` — 取消订阅 - `POST /v2/auth/logout` — 登出 - `POST /v2/pay/jsapi` — 微信支付下单 - `GET /v2/pay/status/{no}` — 订单状态 **模块清单**: - `GET /v2/modules` — 按平台过滤的模块列表 - `GET /v2/meta/stat-types` — 打点白名单 - `GET /v2/meta/recite-types` — 可诵读类型 - `GET /v2/meta/subscribe-templates` — 订阅消息模板 **内容(只读)**: - `GET /v2/almanac/{date}` — 黄历日 - `GET /v2/almanac/month/{ym}` — 黄历月 - `GET /v2/lunar-to-solar` — 农历转公历 - `GET /v2/jieqi` — 节气列表 - `GET /v2/jieqi/{key}` — 节气详情 - `GET /v2/history/day` — 历史上的今天 - `GET /v2/daily` — 每日推荐 - `GET /v2/weather` — 天气 - `GET /v2/public-events` — 公共事件 - `GET /v2/public-events/{id}` — 事件详情 - `GET /v2/exam/phases` — 考试阶段 - `GET /v2/hanzi` — 汉字列表 - `GET /v2/hanzi/{slug}` — 汉字详情 - `GET /v2/word` — 词语列表 - `GET /v2/word/{slug}` — 词语详情 - `GET /v2/poem` — 诗词列表 - `GET /v2/poem/{slug}` — 诗词详情 - `GET /v2/book` — 古籍列表 - `GET /v2/book/{slug}` — 古籍详情 - `GET /v2/book/{slug}/{chapter}` — 章节详情 - `GET /v2/person` — 名人列表 - `GET /v2/person/{slug}` — 名人详情 - `GET /v2/couplet` — 对联列表 - `GET /v2/couplet/{slug}` — 对联详情 - `GET /v2/mingju` — 名句列表 - `GET /v2/mingju/{slug}` — 名句详情 - `GET /v2/riddle` — 灯谜列表 - `GET /v2/riddle/{slug}` — 灯谜详情 - `GET /v2/surname` — 百家姓列表 - `GET /v2/surname/{slug}` — 百家姓详情 - `GET /v2/surname/{slug}/contributions` — 字辈众包 - `GET /v2/jfzh` — 简繁对照列表 - `GET /v2/jfzh/{id}` — 简繁对照详情 - `GET /v2/article` — 文章列表 - `GET /v2/article/{slug}` — 文章详情 - `GET /v2/minsu` — 民俗志列表 - `GET /v2/minsu/{slug}` — 民俗志详情 - `GET /v2/cities` — 历法参照城市 - `GET /v2/holidays` — 法定节假日 - `GET /v2/search` — 全站搜索 **互动**: - `POST /v2/tts/generate` — 生成 TTS 音频 - `POST /v2/stat/hit` — 内容打点 - `POST /v2/duilian/pair` — AI 对对联 **命理(仅 web/app,小程序 403)**: - `POST /v2/bazi/chart` — 八字排盘 - `POST /v2/qiming/suggest` — 取名建议 - `POST /v2/chenggu` — 称骨算命 - `GET /v2/xingzuo/{key}/daily` — 星座运势 - `GET /v2/shengxiao/{key}/daily` — 生肖运势 - `GET /v2/dream` — 解梦列表 - `GET /v2/dream/{slug}` — 解梦详情 --- ## 5. URL 命名规范 ### 5.1 子域名 URL - **首页**:`/{sub}.cq2.cn/` - **详情**:`/{sub}.cq2.cn/{slug}.html` - **分页**:`/{sub}.cq2.cn/page-{N}.html` - **搜索**:`/{sub}.cq2.cn/find.html?q=` - **Markdown**:`/{sub}.cq2.cn/{slug}.md` ### 5.2 www 顶层路径 - **黄历**:`/huangli/{YYYY-MM-DD}.html` - **万年历**:`/wannianli/{YYYY-MM}.html` - **择吉**:`/zeji/{item}.html` - **解梦**:`/jiemeng/{slug}.html` - **八字**:`/bazi`、`/bazi/hehun.html` - **取名**:`/qiming`、`/qiming/wuxing.html`、`/qiming/ceming.html` - **节气**:`/jieqi/{key}.html` - **号码**:`/haoma` - **星座**:`/xingzuo/{key}.html`、`/xingzuo/pei-{a}-{b}.html` - **生肖**:`/shengxiao/{key}.html`、`/shengxiao/pei-{a}-{b}.html` - **称骨**:`/chenggu` - **五行穿衣**:`/wuxingyi` - **五行文化**:`/wuxing/{year}.html`(1924-2043) - **节假日**:`/fangjia/{year}.html` - **汉字**:`/zi/{slug}.html` - **词语**:`/ci/{slug}.html` - **诗词**:`/shici/{slug}.html` - **民间故事**:`/mjgs/{slug}.html` - **古代文学**:`/gdwx/{slug}.html` - **神话传说**:`/shenhua/{slug}.html` - **哲学名言**:`/mingyan/{slug}.html` - **艺术赏析**:`/yishu/{slug}.html` - **对联**:`/duilian/{slug}.html`、`/duilian/c-{key}.html` - **灯谜**:`/caimi/{slug}.html` - **名句**:`/mingju/t-{slug}.html` - **百家姓**:`/surname/{slug}.html` - **名人**:`/person/{slug}.html`、`/person/d-{dynasty}.html` - **历史上的今天**:`/jintian/{MM-DD}.html` - **民俗志**:`/minsu/{slug}.html` - **古籍**:`/book/{slug}.html`、`/book/{slug}/{chapter}.html` - **简繁对照**:`/jfzh/{id}.html` - **文章典故**:`/wenzhang/{cat}/{slug}.html` - **搜索**:`/search?q=` --- ## 6. 数据来源 | 数据类型 | 来源 | 说明 | |---|---|---| | 汉字字形 | makemeahanzi | 9,533 字开源数据集 | | 诗词 | chinese-poetry | 10,827 首古诗词 | | 古籍原文 | ctext.org | 道德经、论语、孟子、墨子、诗经 | | 星座运势 | 前端算法 | 5 维 4 周期实时计算 | | 生肖运势 | 前端 crc32 | 与 PHP 算法对拍一致 | | 黄历算法 | 6tail/lunar-php | 台港通勝口径 | | 五行 | 传统命理 | 标注流派出处 + 免责 | | AI 解读 | MiMo-V2.5 | AI 白话解读 + 人工审核 | | TTS 发音 | MiMo + 千问 | 三语发音(国语/粤语/英语) | --- ## 7. 更新频率 | 内容类型 | 更新频率 | 说明 | |---|---|---| | 黄历 | 每日 | almanac:generate 预生成 1900-2100 | | 万年历 | 每月 | wannianli:static 生成月历页 | | 星座运势 | 每周 | 前端实时算,静态索引周更 | | 生肖运势 | 每日 | 前端实时算,静态索引周更 | | 历史上的今天 | 每日 | 静态页按日期生成 | | 法定节假日 | 年度 | 年初更新全年数据 | | 诗词/文章 | 人工审核后 | reviewed=true 才公开 | | 古籍解读 | 人工审核后 | AI 生成 + 人工校对 | | 汉字/词语 | 按需 | dict:static 增量更新 | | 对联 | 按需 | duilian:static 更新 | | Sitemap | 部署时 | sitemap:generate 全量重建 | --- ## 8. 技术细节 ### 8.1 静态化 - 核心内容预生成真静态 HTML,nginx `try_files $uri /index.php` 直出 - 动态部分(搜索、广告、打点、个性化)走 JS 异步 - 静态页绝不烘焙登录态/会员数据/当天日期 - 子域名 URL 干净:`zi.cq2.cn/0001.html`(非 `/zi/0001.html`) ### 8.2 内容结构 - 结论先行(SEO 友好) - JSON-LD 结构化数据(FAQ、文章、人物等) - 简繁自动判定(浏览器语言 > IP 属性) - 跨子域 cookie 持久化 ### 8.3 SEO - 每个页面独立 canonical - sitemap.xml 按子域名分片 - robots.txt 全子域名覆盖 - llms.txt + llms-full.txt 机器可读文档 - 百度主动推送(按子域名分组) ### 8.4 安全 - UGC 三道防线:本地敏感词 → 微信 msgSecCheck → 人工审核 - 反机器人:PoW + 限流 + 蜜罐 - 命理模块小程序 403(平台红线) - AIGC 内容双标识 --- ## 9. 联系与引用 - **站点**:https://www.cq2.cn - **运营**:重庆学道科技有限公司 - **数据引用**:请注明「数据来源:超群学道网 (cq2.cn)」 - **API 合作**:api.cq2.cn(未开工,欢迎邮件咨询) - **内容纠错**:各内容页表单提交 --- ## 10. 免责声明 本站内容仅供娱乐参考,不构成任何专业建议。命理、运势、取名等模块均标注流派出处,不同流派可能存在差异。AI 生成内容已标注,经人工审核后发布。请理性看待传统文化内容。