noya2012/Text-Based-DFS-Coq-Dependency-Analyzer
GitHub: noya2012/Text-Based-DFS-Coq-Dependency-Analyzer
基于Coq证明助手的Collatz猜想形式化框架,专注于mod 6=2轨道上R0优势增长的机器检验证明。
Stars: 1 | Forks: 0
# Coq 中的 Collatz 猜想 (3n+1 / Syracuse):mod 6 = 2 轨道上的 R0 优势形式化
[](https://coq.inria.fr)
[](https://opensource.org/licenses/MIT)
[](https://github.com/noya2012/collatz-conjecture-coq-framework/releases)
[](https://github.com/noya2012/collatz-conjecture-coq-framework/commits/main)
针对 Collatz (3n+1 / Syracuse) 组合框架的机器检验 Coq 开发,聚焦于 **mod 6 = 2 (mod6=2)** 轨道和定量操作计数(**R0 = 除以 2**,**R1 = 3n+1**)。
*作者:JN.Z (JNZ)*
**许可证**:MIT License · **版本**:1.0 · **最后更新**:2026 年 2 月
**联系方式**:请在 GitHub 上提出 issue 或讨论。
## 概览
- **主要验证目标**:`collatz_part_19.v`(顶层定理:`global_mod62_advantage_growth_canonical`)
- **一键检查命令**:`coqc collatz_part_19.v`
- **证明路线图**:参见 [证明路线图](#proof-roadmap) 中的表格
- **依赖工具(可选)**:`full_dependency_analysis/` 下的脚本
- **文档与可视化**:GitHub Wiki + [文档](#documentation) 中的交互式可视化链接
## 范围与声明
### 此处证明了什么(机器检验)
- 一个结构化的 Collatz 序列 (3n+1) 形式框架,包括规范分解和操作计数。
- 在 **mod 6 = 2 (mod6=2)** 轨道上(如本开发中所定义/证明),宏观步骤构造产生了净 **R0 优势**增长(除以 2 操作超过 3n+1 操作)的**可证明下界**。
### 不作声明的内容
- 本仓库**不是**完整 Collatz 猜想的完整 Coq 证明(即,它并不声称证明每个起始值都会到达 1)。
- 陈述范围限于 `.v` 文件中的定义和形式模型;请在该意义上解释“轨道”和“宏观步骤”。
## 关于此项目
本仓库展示了 **Collatz 猜想**(也称为 **3n+1 问题**、**3x+1 猜想**或 **Syracuse 问题**)的 **Coq 形式化框架**——这是**数论**和**离散数学**中最著名的未解问题之一。
利用新颖的**组合分析框架**结合**形式化验证**技术,本项目提供了 Collatz 序列关键结构特性的机器检验证明。该工作聚焦于 **mod‑6≡2 (mod 6 = 2, mod6=2)** 不变轨道,并建立了关于操作优势的严格定量界限。
### 关键研究关键词
`Collatz Conjecture` · `3n+1 Problem` · `Coq Proof Assistant` · `Formal Verification` · `Number Theory` · `Discrete Mathematics` · `Dynamical Systems` · `Combinatorial Analysis` · `Mathematical Logic` · `Theorem Proving`
## 项目概述
本仓库利用**组合分析框架**开发了 **Collatz 猜想**(**3n+1 问题**)的综合 **Coq 形式化**。该方法识别 **Collatz 序列**中的重复模式(**R1R0** 和 **R0R0 模式**),构建**图论模型**,并将局部性质结合成全局定理,从而在 **Coq proof assistant** 中实现了一个完整的**证明系统**。
**关键结果(在此形式化中)**:在 **mod 6 = 2 (mod6=2)** 轨道上,**R0 操作**(除以 2)相对于 **R1 操作**(3n+1)的优势至少呈线性增长,在框架内给出了机器检验的定量下界。
主要技术贡献包括:
1. **规范表示理论**:参数化 对建立一对一的规范表示,通过 `valid_R1R0_entry_number(d,n)` 和 `valid_R0R0_entry_number(d,n)` 离散化连续整数空间
2. **R0 优势的精确量化**:提出精确的定量公式:
- R1R0 分支:r0s = d+1,r1s = d(优势 = 1)
- R0R0 分支:r0s = d+1,r1s = 1(优势 = d)
3. **mod‑6≡2 轨道不变量**:系统地证明了 mod‑6≡2 是轨道不变量,将无限序列空间约束到一个结构化子轨道
4. **宏观步骤迭代设计**:将宏观步骤定义为 R0R0 和 R1R0 链的组合单元,将复杂的单步分析转化为模块化结构
5. **五阶段渐进式证明路径**:基础构建 → 模式分析 → 模式变换 → R0 优势理论 → 全局收敛
## 关键定理与突破
### 里程碑式定理系统
#### 1. 完全分类定理 – `complete_number_classification` (collatz_part_3.v)
- 每个 ≥1 的自然数都可以唯一地分类为 R1R0 或 R0R0 入口数
- 建立了 Collatz 序列的代数基础
#### 2. 结构控制定理 – `build_k_steps_structure` (collatz_pargbut_6.v)
- k 步扩展恰好使用 k 次除以 2 操作和最多 k 次奇数分支操作
- 序列长度以 2k 为上界,创建了一个精确的计数框架
#### 3. 规范数值界限定理 – `build_k_steps_numeric_canonical` (collatz_part_14.v)
- **整个系统的基石**,为每个正整数提供唯一的规范表示
- 给出严格的数值约束:$2\cdot3^d\cdot n \leq S < 2\cdot3^d\cdot(n+1)$
- 清晰地识别了规范构造的操作模式
#### 4. mod‑6≡2 轨道宏观步骤定理 – `mod62_macrostep_iterated_lower_bound_canonical` (collatz_part_19.v)
- 证明了在 mod‑6≡2 轨道上,每个宏观步骤产生净优势 $\geq 2$
- $t$ 次宏观步骤迭代后的总贡献下界为 $2\cdot t$
#### 5. 全局优势增长定理 – `global_mod62_advantage_growth_canonical` (collatz_part_19.v:811‑854)
- **形式化的顶层成就和关键突破**
- 六层嵌套存在量词:$\exists(K,k,m_2,m_t,ops,chains)$
- 同时构造并约束满足十一个条件的六个对象
- 结论:对于任何输入 $m$ 和迭代次数 $t$,存在一个满足所有约束的构造,其优势下界为 $2\cdot t$
- 依赖于 143 个前置定理,最大深度为 17 层
### R0 优势定理系统层级
```
Level 6: Global layer – global_mod62_advantage_growth_canonical
↑
Level 5: Orbit layer – mod62_macrostep_iterated_lower_bound_canonical
↑
Level 4: Conversion layer – direct_conversion_to_mod6_2_orbit_canonical
↑
Level 3: Iterated chain layer – canonical_mod62_iterated_chains
↑
Level 2: Macrostep layer – canonical_mod62_macrostep_chains
↑
Level 1: Foundation layer – build_k_steps_numeric_canonical (Canonical Numerical Bounds Theorem)
↑
Base: Closed‑form lemmas + sub‑pattern derivations
```
## 证明路线图
| 部分 | 加载文件 | 重点 | 独特结果 |
|------|------------|-------|------------------|
| `collatz_part_1.v` | `log2_p.v` | 核心定义:`CollatzOp`、`collatz_step`、序列构建器 | `build_k_steps` 基础和计数辅助函数 |
| `collatz_part_2.v` | `collatz_part_1.v` | 奇偶代数和基本数论引理 | `even_or_odd`、`even_div_pow2`、除以 2 保持 `valid_input` |
| `collatz_part_3.v` | `collatz_part_2.v` | R1R0/R0R0 模式的入口数特征 | `complete_number_classification` 加上每个入口的归纳原理 |
| `collatz_part_4.v` | `collatz_part_3.v` | 序列有效性不变量 | `sequence_validity_preservation`、前缀有效性引理 |
| `collatz_part_5.v` | `collatz_part_4.v` | 追加 `R0`/`R1R0` 对对计数的影响 | `count_operations_app_R0`、`count_operations_app_R1R0`、`count_sum_c2` |
| `collatz_part_6.v` | `collatz_part_5.v` | `build_k_steps` 的全局结构 | `build_k_steps_structure`、`build_k_steps_increment_basic`、长度界限 |
| `collatz_part_7.v` | `collatz_part_6.v` | 局部两步行为 | `R1R0_single_step`、`sequence_end_app`、`nth_sequence_value_app` |
| `collatz_part_8.v` | `collatz_part_7.v` | R1R0 模式循环的闭合性 | `sequence_end_two_steps`、`R1R0_pattern_closure` |
| `collatz_part_9.v` | `collatz_part_8.v` | R1R0 块的迭代 | `valid_R1R0_produces_R1R0_general`、`repeat_R1R0_output_even` |
| `collatz_part_10.v` | `collatz_part_9.v` | R0 块的对称分析 | `valid_R0_produces_R0_general`、`repeat_R0_consecutive_count` |
| `collatz_part_11.v` | `collatz_part_10.v` | 模式完整性和闭式解 | `build_k_steps_pattern_completeness`、`repeat_R1R0_output_closed_form`、`R1R0_bounds_summary` |
| `collatz_part_12.v` | `collatz_part_11.v` | R0R0 界限和组合估计 | `R0R0_bounds_summary`、`build_k_steps_numeric_bounds_exists`、`build_k_steps_full_bounds` |
| `collatz_part_13.v` | `collatz_part_12.v` | 分解的唯一性 | `pow2_times_odd_unique`、`R1R0_decomposition_unique`、R0R0 唯一性引理 |
| `collatz_part_14.v` | `collatz_part_13.v` | 具有唯一性和界限的规范分类 | `complete_number_canonical_classification`、`build_k_steps_numeric_canonical` |
| `collatz_part_15.v` | `collatz_part_14.v` | 规范块的对数深度控制 | `canonical_d_log2_global`、`build_k_steps_numeric_canonical_length_log2` |
| `collatz_part_16.v` – `collatz_part_19.v` | 前置文件 | 规范链、宏观步骤迭代、全局优势增长 | `canonical_chain`、`mod62_macrostep_iterated_lower_bound_canonical`、`global_mod62_advantage_growth_canonical` |
**探索与替代证明文件**:
- `collatz_part_6_1.v`:带有存在量词的扩展结构定理,`build_k_steps_length_min`,`build_k_steps_structure` 的替代证明
- `collatz_part_16_1.v`:确定性模式循环定理,`collatz_pattern_cycle_deterministic`,探索存在性分支模式
- `collatz_part_18_1.v`:替代链记录构造,宏观步骤分析的存在性证明变体
**扩展文件**:
- `log2_p.v`:提供对数事实
- `collatz_part_121.v`–`collatz_part_122.v`:使用单一模式组合扩展库的单调性结果
## 项目结构
```
collatz/
├── collatz_part_1.v # Core definitions and foundations
├── collatz_part_2.v # Parity algebra and number theory
├── collatz_part_3.v # Pattern classification
├── collatz_part_4.v # Sequence validity
├── collatz_part_5.v # Operation counting
├── collatz_part_6.v # Global structure
├── collatz_part_7.v # Local behaviour
├── collatz_part_8.v # Pattern closure
├── collatz_part_9.v # R1R0 block analysis
├── collatz_part_10.v # R0 block analysis
├── collatz_part_11.v # Pattern completeness
├── collatz_part_12.v # Combinatorial bounds
├── collatz_part_13.v # Uniqueness proofs
├── collatz_part_14.v # Canonical classification
├── collatz_part_15.v # Logarithmic bounds
├── collatz_part_16.v # Canonical chain definitions
├── collatz_part_16_1.v # Exploration: deterministic pattern cycle, existential proof variants
├── collatz_part_17.v # Chain concatenation and advantage preservation
├── collatz_part_18.v # Chain record structure
├── collatz_part_18_1.v # Exploration: alternative chain constructions
├── collatz_part_19.v # Macro‑step iteration and global advantage growth
├── collatz_part_6_1.v # Exploration: extended structure theorems with existential quantifiers
├── collatz_part_121.v # Extension: monotonicity 1
├── collatz_part_122.v # Extension: monotonicity 2
├── log2_p.v # Logarithmic utilities
├── _CoqProject # Coq project configuration
└── README.md # Original English documentation
```
## 快速开始
### 安装要求
**依赖:**
- **Coq Proof Assistant**:8.10.2 或更高版本
- **OCaml**:从源代码构建 Coq 所需(如果使用预构建二进制文件则可选)
- **GNU Make**:自动化构建所需(Windows 上可选)
- **Python 3.8+**:依赖分析工具所需(可选)
**安装选项:**
1. **使用 opam(推荐)**:
```
opam install coq
```
2. **使用 Docker**:
```
docker pull coqorg/coq
```
3. **Windows 二进制文件**:从 [Coq Release Page](https://github.com/coq/coq/releases) 下载
### 构建说明
生成 makefile 并构建所有目标:
```
coq_makefile -f _CoqProject -o Makefile
make
```
**Windows 用户**:如果 `make` 不可用,直接调用 Coq:
```
# 编译主要结果
coqc collatz_part_19.v
# 按顺序编译所有文件
coqc log2_p.v
coqc collatz_part_1.v
# ... 按依赖顺序继续
```
### 验证
要验证形式化:
**1. 编译主要结果:**
```
# 主要验证目标
coqc collatz_part_19.v
```
**2. 运行依赖分析(可选):**
```
cd full_dependency_analysis
python dependency_extractor.py
```
**3. 生成精简代码索引(可选):**
```
cd full_dependency_analysis
python code_lite_generator.py
```
**4. 检查关键定理的依赖深度:**
```
cd full_dependency_analysis
python major_theorem_dependency_analyzer.py global_mod62_advantage_growth_canonical --to-file
```
或使用自动化批处理脚本:
```
full_dependency_analysis\run_lite_analysis.cmd
```
### 快速参考
使用 `full_dependency_analysis/code_lite.txt` 获取关键定义和语句的无证明索引,便于在证明工作中快速查找符号
- 有关关键定理的详细信息,请参阅各个 `.v` 文件和方法论文档
- 依赖分析报告位于 `full_dependency_analysis/theorems_dependence/`
## 主要贡献
此形式化建立了 Collatz 序列众多局部和全局性质的严格证明,包括:
- **主合成定理**:序列模式的完整结构分析
- **生成形式定理**:模式出现的数学表征
- **分解与组合定理**:序列操作的操作性质
- **上界定理**:模式行为的精确数值界限
- **模式连续性与保持性**:变换过程中的不变性质
这些贡献为 Collatz 猜想的动力学和数值优化方面提供了重要见解,推进了数学界对这一挑战性问题的理解。
## 方法论价值
1. **系统化方法**:从基础分解到全局结论的完整工程系统
2. **精确定量**:追求精确等式和紧致上界,超越渐近描述
3. **构造性存在性**:所有证明均附带显式构造算法,支持可计算验证
4. **模块化可组合性**:通过引理复用实现大规模形式化项目
在传统 Collatz 研究的基础上,此形式化通过形式化验证方法为该领域提供了新的分析工具和证明范式。它不仅证明了 Collatz 猜想的关键子命题,更重要的是**为数学形式化领域贡献了系统的技术框架**,展示了将直观数学洞察转化为机器可验证证明的有效途径。
## 文档
- **项目 Wiki**:[GitHub Wiki](https://github.com/noya2012/collatz-conjecture-coq-framework/wiki) - 包含核心见解、定量结果、定理路线图和概念参考的交互式文档
- **交互式可视化**:[Collatz Sequence Visualization](https://noya2012.github.io/collatz-conjecture-coq-framework/cz_ms_cc_visualization.html) - Collatz 序列模式和宏观步骤分析的交互式可视化
- **定理索引**:[`docs/theorems_and_corollaries.txt`](docs/theorems_and_corollaries.txt) - 关键定理/推论及其位置的索引
## 贡献
- **问题 / 反馈**:开启一个 GitHub issue(或讨论)并注明您使用的 Coq 版本。
- **Pull requests**:小型、集中的 PR 最易于审查(一次一个定理重构或一个工具改进)。
- **可复现性**:如果您修改了证明脚本,请保持 `coqc collatz_part_19.v` 作为主要验证目标正常工作。
## 相关资源
- **原始研究仓库**:[noya2012/collatz-prof1](https://github.com/noya2012/collatz-prof1)
- **Coq proof assistant**:[https://coq.inria.fr/](https://coq.inria.fr/)
- **Collatz 猜想概述**:[Wikipedia](https://en.wikipedia.org/wiki/Collatz_conjecture)
- **Terence Tao 的进展 (2019)**:几乎所有 Collatz 轨道都达到几乎有界的值
## 当前版本
### 版本 1.0 (2026 年 1 月)
- 综合 Coq 形式化的初始版本
- 核心定理系统:5 个里程碑定理
- R0 优势定理系统:6 层分级证明架构
- 关键突破:`global_mod62_advantage_growth_canonical` 定理
- 依赖分析框架,包含 7 个 Python 工具
- 完整的中英文文档
## 更新日志
### 版本 1.0 (2026 年 2 月)
- 核心突破:`global_mod62_advantage_growth_canonical` 定理
- R0 优势定理系统:6 层分级证明架构
- 序列模式上限定理和精确数值上界
- 模式连续性与保持性定理
### 版本 0.5 (2026 年 2 月)
- 序列可分解和可组合定理
- 序列模式生成形式定理
- 主要合成定理精炼
### 版本 0.4 (2026 年 1 月)
- 组合分析框架建立
- 三角无向图分解方法
- 密集的定理证明期(1 月 20-30 日)
### 版本 0.3 (2025 年 10 月)
- **10 月 10 日**:项目迁移至 `collatz-conjecture-coq-framework`,"Collatz Project" 创建
- **10 月 14 日**:完成 Collatz Lite 形式化,包括规范分解定理、模式分类、数值界限和对数上界分析
- **10 月 15-18 日**:规范理论建立,mod62 分类系统,`canonical_mod62` 定理系列
### 版本 0.2 (2025 年 5 月 - 6 月)
- BKS (`build_k_steps`) 理论基础建立
- 核心操作定义:R1R0、R0R0
- 初步局部性质探索
### 版本 0.1 (2024 年 11 月 - 12 月)
- `collatz-prof1` 仓库创建(11 月 24 日)
- 原始想法文档整理
- 组合分析方法构思
### 前版本 (2023 年 3 月 - 2024 年 10 月)
- 最早论文撰写(2023 年 3 月 9 日)
- 原始想法形成与迭代
- 数值观察与模式发现
### 关键统计
- **定理和推论总数**:20+ 个主要定理
- **最大依赖深度**:17 层
- **Coq 源文件总数**:19 个核心文件 + 扩展
- **Coq 代码行数**:10,000+(不含证明)
### Coq 社区
- **Coq Zulip Chat**:https://coq.zulipchat.com/ (实时讨论)
- **Coq GitHub Discussions**:https://github.com/coq/coq/discussions (问答)
- **Coq Stack Overflow**:https://stackoverflow.com/questions/tagged/coq (技术问答)
- **Coq Discord**:https://discord.com/invite/X9d5uZc (社区聊天)
### Coq 学习资源
- **Coq Standard Library Docs**:https://coq.inria.fr/doc/
- **Coq Platform**:https://coq.inria.fr/platform/ (发行版)
- **Coq Club Mailing List**:https://sympa.inria.fr/sympa/info/coq-club
### 相关 Coq 形式化
- **Coq-BB5** (mxdys):[GitHub](https://github.com/ccz181078/Coq-BB5) | Busy Beaver 函数值的形式化验证。通过机器检验证明建立 BB(5)=47,176,870。
- **H10** (Larchey-Wendler, Forster; Universität des Saarlandes):[GitHub](https://github.com/uds-psl/H10) | Hilbert 第十问题不可判定性的 Coq 形式化,发表于 FSCD 2019。
*此形式化代表了通过严格数学分析和计算机辅助证明验证对 Collatz 猜想进行的持续研究。*
标签:3n+1问题, Collatz猜想, Coq, DFS, DNS解析, MIT许可, WebSocket, 依赖分析, 函数式编程, 定理证明, 开源项目, 形式化验证, 数学, 数论, 漏洞数据库, 符号执行, 算法分析, 逆向工具