# Changelog

本项目遵循语义化版本。`ziping-strength-v1` 的规则结果不会在补丁版本中静默改变。

## [0.8.0] - 2026-08-03

### Added

- 增加 `luck-analysis-v1` 与 `analyzeLuckCycles`，逐步输出大运干支十神、藏干、十二长生和根气事实。
- 输出大运与原局四柱构成的天干五合与相克，以及地支六合、完整三合、六冲、六害、子卯刑、自刑和完整三刑。
- 抽取共用干支关系规则表，使 `relations-v1` 与 `luck-analysis-v1` 复用同一套可测试定义。
- 增加大运关系、合化候选、完整三支组合和根气测试。

### Changed

- 版本更新为 `0.8.0`；大运关系模块只输出事实，合化只标记候选，不判断吉凶或改写原局旺衰。

## [0.7.0] - 2026-08-03

### Added

- 增加 `annual-cycle-v1` 与 `calculateAnnualCycles`，按公历锚点年范围生成流年干支时间线。
- 每个流年以本年立春为包含的起点、次年立春为不包含的结束点，中国标准时间精确到秒。
- 增加立春前后一秒、连续流年、六十甲子换轮和输入范围测试。

### Changed

- 版本更新为 `0.7.0`；流年模块只输出时间与干支事实，不生成吉凶或事件断语。

## [0.6.0] - 2026-08-03

### Added

- 增加 `luck-cycle-v1` 与 `calculateLuckCycles`，确定性计算大运顺逆、节令边界、起运年龄、交运时间和十年干支序列。
- 支持调用方直接指定 `direction`，或通过 `year-stem-and-sex` 规则按年干阴阳和 `sexForRule` 确定顺逆。
- 增加“三天一岁”秒级换算 API `convertThreeDaysToOneYear`，并输出起运前阶段、`appliedRules`、`trace` 和 `warnings`。
- 增加阴阳年男女顺逆、显式方向、节令零距离和起运换算测试。

### Changed

- 版本更新为 `0.6.0`；大运模块只输出时间与干支事实，不生成吉凶、喜忌或事件断语。

## [0.5.0] - 2026-08-03

### Added

- 增加 `ziping-strength-v2`，显式组合 `season-context-v1`、`relations-v1`、`roots-v1` 与基础干藏证据重新计算五档旺衰。
- 增加 `analyzeChartV2`、`analyzePillarsV2` 和标准结果字段 `analysisV2`。
- v2 evidence 逐条输出事实来源、采用状态、决策方向和决策量。

### Changed

- 版本更新为 `0.5.0`；`analysis` 继续保留原有 `ziping-strength-v1` 结果，避免静默改变旧模型。

## [0.4.0] - 2026-08-03

### Added

- 增加 `roots-v1`，输出日主是否有根，以及每处根所在柱位、藏干和本气/中气/余气层级。
- 增加独立的 `detectRoots` 与 `detectPillarRoots` API。

### Changed

- `calculateBazi` 与 `calculateFromPillars` 增加 `roots`；不修改 `ziping-strength-v1` 的既有结果。

## [0.3.0] - 2026-08-03

### Added

- 增加 `season-context-v1`，输出前后节气和月柱节令边界的秒级距离。
- 增加日主在年、月、日、时四支的十二长生，明确采用阳干顺排、阴干逆排。
- 增加按月支四季划分的五行旺相休囚死，并公开季末土旺尚未建模的边界。
- 增加 `getTwelveGrowthStage`、`getSeasonalStates` 和 `calculateSeasonContext` API。

### Changed

- `calculateBazi` 增加 `seasonContext` 和对应 trace；不修改 `ziping-strength-v1` 的既有结果。

## [0.2.0] - 2026-08-03

### Added

- 增加立春、惊蛰、子时换日、闰日和年末的机器可读回归向量。
- 增加回归向量的来源、验证等级和维护规则说明。
- 增加 npm 发布账号作者元数据。
- 增加 `relations-v1`，检测天干五合与相克，以及地支六合、完整三合、六冲、六害和刑。
- `calculateBazi` 与 `calculateFromPillars` 返回结构化 `relations`，并保留准确柱位。
- 增加独立的 `detectRelations` 与 `detectPillarRelations` API。
- npm 压缩包同时发布完整的 `src/` TypeScript 源码。

### Changed

- README 补充测试边界与版本记录入口。
- 干支关系只作为事实输出，不修改 `ziping-strength-v1` 的既有结果。

## [0.1.0] - 2026-08-03

### Added

- 首次发布八字四柱排盘、五行、阴阳、十神和藏干结构。
- 提供 `ziping-strength-v1` 旺衰分析、证据、置信度和推导链。
- 支持 00:00 与 23:00 两种换日规则。
- 同时发布 ESM、CommonJS 和 TypeScript 类型声明。