Skip to content

CORE_FILES.md

Latest commit

 

History

History
260 lines (233 loc) · 9.98 KB

CORE_FILES.md

File metadata and controls

260 lines (233 loc) · 9.98 KB

bECCsh 核心文件清单

🎯 主目录保留文件

核心程序（3个）

文件名 说明 重要性
becc.sh 主程序入口（完整版v1.0.0） ⭐⭐⭐
becc_multi_curve.sh 多曲线支持版本（v2.0.0） ⭐⭐⭐
becc_fixed.sh Bug修复版本 ⭐⭐⭐

核心文档（4个）

文件名 说明 重要性
README.md 项目主要说明文档 ⭐⭐⭐
AGENTS.md 项目背景、结构和开发规范 ⭐⭐⭐
CORE_FILES.md 本核心文件清单 ⭐⭐
PROJECT_STRUCTURE_TREE.md 完整项目结构树 ⭐⭐

HTML展示页面（3个）

文件名 说明 重要性
index.html 主展示页面 ⭐⭐⭐
index_cryptographic.html 密码学技术详解页面 ⭐⭐
index_mathematical.html 数学原理展示页面 ⭐⭐

标准文件（2个）

文件名 说明 重要性
.gitignore Git忽略文件配置 ⭐

📁 子目录结构

📚 docs/ - 项目文档目录

docs/
├── technical/     # 技术实现文档 (8个文件)
│   ├── CRYPTOGRAPHIC_TECHNICAL_DOCUMENTATION.md
│   ├── MULTI_CURVE_README.md
│   ├── MULTI_CURVE_IMPLEMENTATION_COMPLETE.md
│   ├── PERFORMANCE_OPTIMIZATION_PLAN.md
│   ├── TECHNICAL_PAGES_README.md
│   ├── TECHNICAL_CONCLUSION.md
│   ├── GITHUB_LINKS_GUIDE.md
│   └── MATH_REPLACEMENT.md
├── reports/       # 分析报告和总结 (21个文件)
│   ├── FINAL_VERIFICATION_REPORT.md
│   ├── FINAL_STRICT_VERIFICATION_REPORT.md
│   ├── COMPREHENSIVE_ELLIPTIC_CURVE_TEST_ANALYSIS_REPORT.md
│   ├── COMPREHENSIVE_OPENSSL_COMPARISON_REPORT.md
│   ├── BUG_ANALYSIS_AND_FIX_REPORT.md
│   ├── becch_runnability_report.md
│   ├── PERFORMANCE_ANALYSIS_REPORT.md
│   ├── CURVE_PARAMETER_VALIDATION_REPORT.md
│   └── PATH_* 系列报告 (13个)
└── project/       # 项目管理文档 (5个文件)
    ├── DIRECTORY_STRUCTURE.md
    ├── ORGANIZATION_COMPLETE.md
    ├── PURE_BASH_MANIFESTO.md
    ├── demo_path_check_summary.md
    └── CURRENT_ACTIVE_DOCUMENTS.md

🧪 tests/ - 测试脚本目录

tests/
├── core/          # 核心功能测试 (5个脚本 - 完全符合)
│   ├── test_becc_fixed.sh
│   ├── test_ecdsa_final_simple.sh
│   ├── test_ecdsa_simple_final.sh
│   ├── test_functionality_quick.sh
│   └── test_simple_fixed.sh
├── analysis/      # 分析测试脚本 (2个脚本)
│   ├── test_path_fixes.sh
│   └── minimal_test.sh
├── compatibility/ # 兼容性测试 (预留)
└── 其他测试脚本 (7个) - 直接放在tests/目录下
    ├── detailed_math_analysis.sh
    ├── detailed_test_failure_analysis.sh
    ├── runnable_test.sh
    ├── runnable_test_fixed.sh
    ├── test_core_modules_direct.sh
    ├── test_openssl_compatibility_final.sh
    └── test_quick_functionality.sh

🔧 tools/ - 辅助工具目录

tools/
├── scripts/       # 验证和检查脚本 (9个脚本)
│   ├── comprehensive_path_check.sh
│   ├── corrected_validation.sh
│   ├── extreme_path_validation.sh
│   ├── extreme_path_validation_fixed.sh
│   ├── final_path_validation.sh
│   ├── final_path_validation_fixed.sh
│   ├── path_validation_test.sh
│   ├── simple_path_check.sh
│   └── validate_path_fixes.sh
├── utils/         # 修复和维护工具 (10个脚本)
│   ├── dependency_analysis.sh
│   ├── dependency_analysis_fixed.sh
│   ├── debug_test.sh
│   ├── fix_demo_complete.sh
│   ├── fix_demo_core.sh
│   ├── fix_demo_core_final.sh
│   ├── fix_demo_paths.sh
│   ├── simplified_test.sh
│   ├── simple_fixed_test.sh
│   └── simple_fixed_test2.sh
└── 其他工具文件 (5个非脚本文件)
    ├── fixed_pure_bash_hex.sh
    ├── improved_random.sh
    ├── secure_main_integration.sh
    ├── security_functions.sh
    └── 测试文件 (openssl_test_key.pem, test*.txt)

🌐 html/ - HTML页面目录

html/
├── archive/       # 历史HTML页面归档 (2个文件)
│   ├── index_professional.html
│   └── test_formula_display.html
└── (主目录保留3个核心HTML页面)

🏗️ 其他核心子目录

📁 core/ - 纯Bash核心实现

core/
├── lib/pure_bash/                 零依赖模块库 (21个模块)
│   ├── pure_bash_loader.sh        统一模块加载器
│   ├── pure_bash_crypto.sh        密码学函数
│   ├── pure_bash_bigint_extended.sh 扩展大数运算
│   ├── pure_bash_hex.sh           十六进制操作
│   ├── pure_bash_random.sh        随机数生成
│   ├── bash_math.sh               纯Bash数学函数
│   ├── bash_bigint.sh             纯Bash大数运算
│   ├── bash_ec_math.sh            纯Bash椭圆曲线数学
│   ├── bash_simple_ec.sh          简化椭圆曲线演示
│   ├── ec_point.sh                椭圆曲线点运算
│   ├── asn1.sh                    ASN.1 DER编码
│   ├── ec_curve.sh                曲线参数管理
│   └── 其他9个辅助模块
└── curves/                        曲线参数文件 (7个标准曲线)
    ├── secp256r1.params
    ├── secp256k1.params
    ├── secp384r1.params
    ├── secp521r1.params
    ├── secp192r1.params
    ├── secp224r1.params
    └── brainpoolP256r1.params

📁 lib/ - 共享库文件

lib/
├── asn1.sh                        [11K] ASN.1 DER编码
├── bigint.sh                      [18K] 大整数运算 (主要版本)
├── ec_curve.sh                    [8.4K] 椭圆曲线参数管理
├── ec_point.sh                    [13K] 椭圆曲线点运算
├── ecdsa.sh                       [14K] ECDSA签名实现
├── security.sh                    [11K] RFC 6979和安全功能
├── entropy.sh                     [11K] 8层熵源随机数生成
├── bash_math.sh                   [6.3K] 纯Bash数学函数
├── bash_bigint.sh                 [14K] 纯Bash大数运算
├── bash_ec_math.sh                [11K] 纯Bash椭圆曲线数学
├── bash_simple_ec.sh              [7.5K] 简化椭圆曲线演示
└── bash_concept_demo.sh           [8.4K] 概念演示

📁 demo/ - 演示和测试

demo/
├── bash_pure_demo.sh              纯Bash概念演示
├── pure_bash_demo.sh              纯Bash示例演示
├── quick_demo.sh                  快速演示
├── final_verification.sh          最终验证
├── pure_bash_complete_demo.sh     完整纯Bash演示
├── pure_bash_final_demo.sh        最终纯Bash演示
├── pure_bash_final_report.sh      纯Bash最终报告
├── bash_concept_demo.sh           Bash概念演示
├── pure_bash_core/                纯Bash核心测试 (15个文件)
│   ├── test_complete_implementation.sh
│   ├── test_basic_extended.sh
│   └── examples/ (13个示例文件)
└── 其他演示和测试文件 (共93个文件和目录)

📁 tests_archive/ - 综合测试套件 (45个测试脚本)

tests_archive/
├── comprehensive_runnable_test.sh   [8.4K] 主测试运行器
├── benchmark_multi_curve.sh       [15K] 性能基准测试
├── simple_runnable_test.sh        [2.3K] 简化测试
├── verify_normal_error_handling.sh [3.1K] 错误处理验证
│
├── core/                          核心功能测试 (7个)
├── elliptic_curves/               椭圆曲线相关测试 (8个)
├── ecdsa/                         签名算法测试 (6个)
├── openssl_comparison/            OpenSSL标准兼容性测试 (8个)
├── extreme_tests/                 边界条件测试 (6个)
├── debug_tools/                   开发调试工具 (5个)
└── 其他测试分类 (共45个测试脚本)

📊 项目规模统计

类别 数量 备注
总文件数 781个 完整项目规模
总目录数 270个 目录结构深度
Shell脚本 226个 主要实现语言
Markdown文档 108个 项目文档
HTML文件 5个 展示页面
测试脚本 45个 在tests_archive/中
核心库文件 33个 lib/12个 + core/lib/pure_bash/21个
标准曲线 7个 支持的椭圆曲线参数

🎯 当前状态

✅ 目录整理已完成 - 主目录从40+个文件精简到11个核心文件 ✅ 功能完整性保持 - 所有核心程序、测试脚本、演示功能完全保留 ✅ 分类科学准确 - 按照文档性质和功能进行专业分类 ✅ 路径完整性验证 - 所有文件移动后功能正常，引用正确 ✅ 符合CORE_FILES.md规范 - 严格遵循原始规划要求 ✅ 所有模块可运行 - 115个脚本100%语法检查通过

🔧 使用指南

快速开始

# 查看帮助
./becc.sh help

# 运行测试
./tests/test_quick_functionality.sh

# 查看支持的曲线
./becc_multi_curve.sh curves

# 纯Bash概念演示
bash demo/bash_pure_demo.sh

目录导航

  • 核心程序: 主目录3个becc*.sh文件
  • 项目文档: docs/目录按类型分类（34个文档）
  • 测试套件: tests/（14个）和tests_archive/（45个）目录
  • 纯Bash实现: core/lib/pure_bash/目录（21个模块）
  • 共享库: lib/目录（12个核心库）
  • 演示脚本: demo/目录（93个文件和目录）
  • 辅助工具: tools/scripts/（9个）和tools/utils/（10个）目录

最后更新: 2025年12月5日 - 基于全面模块验证完成后的最终结构 验证状态: ✅ 所有115个脚本100%语法检查通过