Skip to content
/ 6keys Public

A neural consciousness framework (六鑰臨界) based on critical transition theory and topological indicators.

License

BSD-3-Clause, Unknown licenses found

Licenses found

BSD-3-Clause
LICENSE
Unknown
LICENSE-PAPER
Notifications You must be signed in to change notification settings

orcaguru/6keys

Six Keys Criticality (六鑰臨界)

基於臨界轉換理論的神經意識狀態分析框架
A Neural Consciousness State Analysis Framework Based on Critical Transition Theory

License: BSD 3-Clause Python 3.8+ Documentation Status Docker Conda

📥 論文下載 | Paper Download

🔥 📄 中文版論文PDF下載
🔥 📄 English Paper PDF Download
📋 📄 完整版論文 (備用)

🧭 快速導航 | Quick Navigation

用戶類型 推薦路徑 說明
🆕 新手用戶 🚀 快速開始❓ 常見問題💬 問答集 5分鐘上手指南
🧠 理論研究者 📚 完整論文🧮 數學推導💬 深度問答 深入理論背景
👨‍💻 程式開發者 📚 API文檔🔧 開發者指南 技術實現細節
🔬 實驗驗證者 🧪 實驗指南📊 可視化教程 實驗設計方法

🌐 語言版本: 🇨🇳 中文文檔 | 🇺🇸 English Docs | 📖 完整導航: 📚 文檔中心


🇺🇸 For English Visitors

Welcome! This project provides comprehensive English documentation.

User Type Recommended Path Description
🆕 New Users 🚀 Quick Start❓ FAQ💬 Q&A Collection 5-minute getting started guide
🧠 Researchers 📚 Complete Paper🧮 Mathematical Derivations💬 In-depth Q&A In-depth theoretical background
👨‍💻 Developers 📚 API Docs🔧 Developer Guide Technical implementation details
🔬 Experimenters 🧪 Experiment Guide📊 Visualization Tutorial Experimental design methods

📖 English Documentation Hub: 📚 English Docs Center | 🏠 Main Navigation: 📚 All Documentation | 📖 GitBook Documentation: 📚 GitBook Center

🎯 項目概述

Six Keys Criticality 是一個基於臨界轉換理論的神經意識狀態分析框架。通過六個核心指標(ζ₁-ζ₆)量化神經網絡的臨界性特徵,為意識研究提供理論視角和實用工具。

🔑 六個核心指標

指標 名稱 描述
ζ₁ FELC 自由能極限環 (Free Energy Limit Cycle)
ζ₂ TEB 資訊-能耗效率 (Thermodynamic Efficiency Balance)
ζ₃ RFI Ricci曲率臨界流 (Ricci Flow Index)
ζ₄ ECGP 因果滲流 (Effective Causal Graph Percolation)
ζ₅ PWC 相位拓撲環流 (Phase-Wrapped Circulation)
ζ₆ ACI 神經-星膠耦合臨界 (Astrocyte-Coupling Index)

💬 核心問答預覽 | Core Q&A Preview

想快速了解六鑰臨界理論?以下是最常被問到的核心問題:

🧠 Q1: 什麼是「六鑰臨界」?為什麼是六個指標?

A: 六鑰臨界是基於臨界轉換理論的意識分析框架。選擇六個指標是因為:

  • 數學約束:SO(7)群的6維李代數結構
  • 生物對應:對應大腦的六個核心功能模組
  • 臨界性:每個指標都捕捉不同尺度的臨界轉換特徵

六個指標協同工作,形成完整的意識狀態描述空間。

⚡ Q2: 這個理論如何解釋麻醉過程中的意識消失?

A: 麻醉過程中,六個指標會依序失效:

  1. ζ₁ (FELC) 首先受影響 - 能量代謝改變
  2. ζ₆ (ACI) 隨後下降 - 神經-膠質耦合減弱
  3. ζ₄ (ECGP) 關鍵崩潰 - 因果連接斷裂
  4. 其他指標連鎖反應,系統脫離臨界狀態

這解釋了為什麼意識消失是突然的,而非漸進的。

🎵 Q3: 為什麼音樂能引發強烈情緒反應?

A: 音樂通過多個維度同時影響六鑰系統:

  • 節拍 → ζ₁ (能量相位) → 身體律動感
  • 和聲張力 → ζ₆ (拓撲纏繞) → 情緒高潮
  • 旋律 → ζ₂ (資訊尺度) → 期待與滿足

當和聲解析時,ζ₆的拓撲纏繞瞬間釋放,產生「雞皮疙瘩」效應。

🔬 Q4: 這個理論可以被實驗驗證嗎?

A: 完全可以!理論提供了具體的可測量預測:

  • 臨界閾值:意識轉換應在特定 D_w 值發生
  • 六鑰協調:所有指標應同步變化
  • 可逆性:意識恢復應沿相反路徑

目前正在進行多中心驗證實驗,初步結果支持理論預測。

🎯 想了解更多? 查看完整的 📖 六鑰臨界問答集 - 包含26個深度問題,涵蓋理論基礎、技術實現和實驗應用的完整知識體系。

📚 完整文檔中心: 📖 GitBook 文檔中心 - 包含完整論文、問答集和導覽系統的統一文檔平台。

🚀 快速開始 | Quick Start

📦 安裝

# 推薦方式:pip 安裝
pip install sixkeys

# 或從源碼安裝
git clone https://github.com/isyanghou/6Keys.git
cd 6Keys && pip install -e .

🎮 基本使用

import numpy as np
from sixkeys import SixKeysAnalyzer

# 創建分析器並分析數據
analyzer = SixKeysAnalyzer()
data = np.random.randn(1000, 64)  # 示例神經數據
results = analyzer.analyze(data)

# 查看六個核心指標
for key, value in results.items():
    print(f"{key}: {value:.4f}")

📖 詳細教程: 完整安裝指南 | 快速開始 | API文檔

📊 主要功能 | Key Features

🔑 核心指標 | Core Indicators

  • FELC (ζ₁): 自由能極限環分析 | Free Energy Limit Cycle Analysis
  • TEB (ζ₂): 資訊-能耗效率平衡 | Thermodynamic Efficiency Balance
  • RFI (ζ₃): Ricci曲率臨界流 | Ricci Flow Index
  • ECGP (ζ₄): 有效因果圖滲透 | Effective Causal Graph Percolation
  • PWC (ζ₅): 相位拓撲環流 | Phase-Wrapped Circulation
  • ACI (ζ₆): 神經-星膠耦合指標 | Astrocyte-Coupling Index

🛠️ 分析工具 | Analysis Tools

  • 統一框架: 六鑰臨界管道流形 (CTM) | Unified framework with Critical Transition Manifold
  • 多狀態分析: 清醒、輕度鎮靜、深度麻醉 | Multi-state analysis (awake, sedation, anesthesia)
  • 時間演化: 動態臨界轉換追蹤 | Temporal evolution and critical transition tracking
  • 統計驗證: 交叉驗證和顯著性檢驗 | Statistical validation and significance testing

📈 可視化功能 | Visualization Features

  • 雷達圖: 六維指標空間可視化 | Radar charts for six-dimensional indicator space
  • 相位圖: 臨界狀態相位軌跡 | Phase diagrams for critical state trajectories
  • 時間序列: 動態演化分析 | Time series analysis for dynamic evolution
  • 統計圖表: 箱線圖、分布圖等 | Statistical plots (boxplots, distributions, etc.)

🔧 技術特性 | Technical Features

  • 多平台支持: Windows, macOS, Linux | Multi-platform support
  • 容器化部署: Docker 和 Docker Compose | Containerized deployment
  • 批量處理: 大規模數據集分析 | Batch processing for large datasets
  • 可擴展性: 模組化設計,易於擴展 | Extensible modular design
  • 開源協議: BSD 3-Clause 許可證 | Open source with BSD 3-Clause license

📁 項目結構 | Project Structure

sixkeys/
├── sixkeys/              # 核心Python包
│   ├── core/            # 六個核心指標算法 (ζ₁-ζ₆)
│   ├── analysis/        # 分析工具
│   └── demos/           # 演示模組
├── docs/                # 完整文檔系統
│   ├── gitbook/        # GitBook 統一文檔中心
│   │   ├── paper-zh/   # 中文完整論文
│   │   ├── paper-en/   # English complete paper
│   │   ├── qa-zh/      # 中文問答集
│   │   └── qa-en/      # English Q&A
│   ├── zh/paper/       # 中文完整論文 (備用)
│   ├── en/paper/       # English complete paper (備用)
│   └── api/            # API參考文檔
├── examples/            # 使用示例
└── tests/              # 測試套件

📖 詳細結構: 完整項目結構說明

🔬 理論背景 | Theoretical Background

六鑰臨界理論基於臨界轉換理論、自由能原理、網絡拓撲學和資訊理論,通過六個核心指標量化神經系統的臨界狀態轉換。

📖 深入了解: 理論背景詳解 | 數學推導 | GitBook 文檔中心

🎨 可視化演示 | Visualization Demos

# 運行可視化演示
python examples/demo_visualization.py

# 安裝可視化依賴
pip install matplotlib seaborn scipy pandas

演示內容:

  • 六鑰雷達圖 - 六個指標的可視化比較
  • 公開數據重分析 - 現有數據集的重新分析
  • 交叉驗證分析 - 指標間相關性分析

📖 詳細說明: 可視化教程

💬 六鑰臨界問答集 | Six Keys Q&A Collection

📖 六鑰臨界問與答完整版 - 深度理論解析與實踐指南

📚 GitBook 文檔中心 - 完整的論文、問答集和導覽系統統一平台

🎯 問答集特色

  • 📊 26個核心問題 - 涵蓋理論基礎到實際應用的完整知識體系
  • 🔬 深度技術解析 - 包含數學推導、程式碼實現和實驗設計
  • 🌐 跨學科整合 - 融合神經科學、物理學、資訊理論和人工智能
  • 💻 實用代碼示例 - 提供可執行的Python代碼和詳細註解
  • 📈 視覺化展示 - 豐富的圖表、公式和結構化表格

🗂️ 主要內容分類

類別 問題範圍 適合對象
🧠 理論基礎 Q1-Q10 研究者、學者
🔧 技術實現 Q11-Q20 開發者、工程師
🔬 實驗應用 Q21-Q26 實驗者、臨床醫師

💡 推薦閱讀順序: 新手用戶建議從Q1開始順序閱讀,有經驗的研究者可直接跳轉到感興趣的專題。


📚 文檔和教程 | Documentation & Tutorials

🎯 按需求快速定位 | Quick Access by Needs

🆕 我是新手,想快速上手

推薦學習路徑:

  1. 🚀 快速開始 - 5分鐘上手
  2. ⚙️ 安裝指南 - 詳細安裝步驟 3.2. 💬 問答集 - 理論基礎與實踐指南
  3. ❓ 常見問題 - 解決常見疑問
  4. 📊 可視化教程 - 學習結果展示

🔗 遇到問題?❓ FAQ | 💬 聯繫我們

🧠 我想深入了解理論

推薦學習路徑:

  1. 🧠 理論背景 - 理論基礎概述
  2. 💬 問答集 - 深度理論解析與常見問題
  3. 📚 完整論文 - 中文完整論文
  4. 🧮 數學推導 - 詳細數學證明
  5. 🔬 實驗驗證 - 實驗設計方法

🌐 其他語言: 🇺🇸 English Paper | 🇺🇸 English Q&A

👨‍💻 我要開發和集成

推薦學習路徑:

  1. 📚 API文檔 - 完整API參考
  2. 🔧 開發者指南 - 開發環境設置
  3. 🏗️ 項目結構 - 代碼組織架構
  4. 🧪 測試指南 - 測試和驗證

🔗 開發資源: GitHub | Issues

🌟 核心文檔入口 | Core Documentation

文檔類型 連結 適合對象
📖 快速開始 開始使用 所有用戶
📚 完整論文 中文 | English 研究者
💬 問答集 中文問答 | English Q&A 所有用戶
📖 GitBook中心 統一文檔平台 所有用戶
🔧 API文檔 技術文檔 開發者
常見問題 FAQ 所有用戶

📖 完整導航: 📚 文檔中心 - 包含所有文檔的詳細索引和導航

📖 GitBook 統一平台: 📚 GitBook 文檔中心 - 論文、問答集和導覽系統的統一入口

🤝 貢獻指南 | Contributing

我們歡迎社群貢獻!請參閱 CONTRIBUTING.md 了解詳細信息。

# 開發環境設置
git clone https://github.com/isyanghou/6Keys.git
cd 6Keys && pip install -e ".[dev]"
pytest tests/  # 運行測試

📈 引用 | Citation

如果您在研究中使用了本項目,請引用:

@software{sixkeys2025,
  title={Six Keys Criticality: A Framework for Neural Consciousness State Analysis},
  author={Hou, You Yang},
  year={2025},
  url={https://github.com/isyanghou/6Keys},
  note={ORCID: 0009-0000-7041-8574}
}

📄 授權條款 | License

👤 作者 | Author

You Yang Hou
📧 isyanghou@gmail.com | 🆔 ORCID: 0009-0000-7041-8574


注意:本項目為研究性質,不適用於臨床診斷。使用前請詳閱相關文檔和免責聲明。

About

A neural consciousness framework (六鑰臨界) based on critical transition theory and topological indicators.

Topics

Resources

License

BSD-3-Clause, Unknown licenses found

Licenses found

BSD-3-Clause
LICENSE
Unknown
LICENSE-PAPER

Contributing

Stars

Watchers

Forks

Packages

No packages published