乾源黄历

乾源黄历是一个完全本地化、无外部网络请求的原创黄历工具。所有农历换算、干支、节气、宜忌、冲煞、吉神凶煞、十二时辰吉凶均由浏览器端脚本在本地完成。打开页面即可使用，断网亦可运行，不收集任何用户数据。

/qianyuan-huangli
├── index.html            # 首页：今日摘要 + 月历导航
├── tongsheng.html        # 每日通胜：日级详情 + 十三时辰
├── select-date.html      # 择日服务：按事项区间筛选候选日
├── help.html             # 帮助与说明（本页）
├── README.md             # 项目说明文档
├── site.config.json      # 站点配置
├── assets/
│   ├── qianyuan.png      # 站点 Logo / favicon
│   ├── wechat.jpg        # 联系微信二维码
│   ├── css/styles.css    # 全部样式
│   ├── js/core.js        # 通用工具 + 黄历数据封装 + 择日评分
│   ├── js/home.js        # 首页逻辑
│   ├── js/tongsheng.js   # 通胜页逻辑
│   ├── js/select-date.js # 择日页逻辑
│   └── vendor/huangli.js # 本地历法计算引擎（离线）
└── scripts/              # （已清空，不再依赖外部同步脚本）

cd qianyuan-huangli

# 方式一：Python
python -m http.server 8080

# 方式二：Node.js
npx serve .

# 方式三：直接双击 index.html 亦可运行

启动后浏览器访问 http://127.0.0.1:8080/。

• 基础分 50；
• 目标事项出现在当日「宜」中 +22，出现在「忌」中 −28；
• 值日天神为黄道 +8，黑道 −6；天神吉 +4，凶 −4；
• 值星为「开 / 成 / 定」+6，为「破 / 危 / 闭」−6；
• 每出现一个吉时 +1，最多 +6；
• 与需要避开的生肖犯冲 −18；
• 得分归一到 0–100，≥82 上选，≥70 可优先，≥58 可参考，其余谨慎参考。

本工具输出的黄历与择日结果是基于传统历法规则的程序化计算，仅供文化研究、生活参考与内容展示使用，不等同于人工八字合盘、专业命理咨询或法律、医疗、金融决策建议。重大事项请结合实际情况与专业人士意见综合判断。

• 站点名称与版本号
• 本地历法引擎路径
• 页面清单
• 择日默认区间与最大区间
• 支持事项与口语别名映射

• 纯 HTML / CSS / 原生 JavaScript，无框架、无构建步骤；
• 无任何 CDN、统计脚本、外部字体或网络请求；
• 可直接部署到网站、对象存储或本地离线使用；
• 移动端自适应，手机浏览器打开即可。