DNA: #龍芯⚡️丙午·丙申·庚戌·䷙大畜-SCRIPT-MANAGER-v1.2-UID9622

CONFIRM: #CONFIRM🌌9622-ONLY-ONCE🧬LK9X-772Z

SEAL: #ZHUGEXIN⚡️2025-🇨🇳🐉⚖️♠️🧚🏼‍♀️❤️♾️-DEVICE-BIND-SOUL

🐉 龍魂系统 · LongHun System

中国自主可控的数字主权底座。 技术服务于人民。主权不可交易。 Technology serves the people. Sovereignty is not for sale.

🚀 5 分钟上手: bash bin/install.sh → python3 bin/龍魂体系v5-一键启动.py

📖 快速入门 · 🤝 参与贡献 · 💬 社区讨论

🏗️ 目录结构 v2.0（2026-08-04）：核心目录已按编号结构重组（如 08_BIN/、12_DOCS/）。旧路径（bin/、docs/ 等）仍通过 Symlink 保持兼容，现有命令和链接无需修改。详见 docs/DIRECTORY_MAP.md 与 docs/SYSTEM_STRUCTURE_AUDIT_v1.0.md。

🗂️ 仓库速览 · Repository at a Glance

一键看清这个仓库的「现在进行时」。所有状态均可在本地复现验证。

维度	状态	验证入口
🏷️ 最新版本	v5.1.0 · 品牌与国际化完善	`CHANGELOG.md`
🧬 默认分支	`orphan_main`	GitHub 仓库首页
✅ CI 状态	GitHub Actions 持续集成	`.github/workflows/`
🔐 GPG 签名	全量文件 `.asc` 脱签验证	本仓库任意 `.md.asc` / `.py.asc`
🎨 品牌资产	印章风格 Logo / App 图标 / OG 预览	`brand/`
🌐 在线门户	`10_PORTAL/index.html` 静态站点	`portal/`
🖥️ CNSH IDE	基于 FastAPI + Ace Editor 的可交付编辑器	`CNSH_IDE.md`
📊 学术引用	CITATION.cff 已配置	`CITATION.cff`
💰 支持入口	FUNDING.yml + 此路同行二维码	`.github/FUNDING.yml`

🔐 可验证性 · Verifiability

龍魂系统的每一份核心文件都带有 GPG 脱签签名（.asc），确保内容从提交起未被篡改。

# 验证任意文件签名（以 README.md 为例）
gpg --verify README.md.asc README.md

# 批量验证当前目录下所有签名
find . -type f -name '*.asc' -not -path './.git/*' | sed 's/\.asc$//' | xargs -I{} gpg --verify {}.asc {}

签名密钥指纹: ...SozCbV8（UID9622）
签名策略: 协议/代码/配置/文档四类文件强制签名，审计日志与临时数据除外
验证失败处理: 参见 SECURITY.md 的「完整性事件响应」

🖥️ 透明看板 · Transparent Dashboard

君子协议的可视化契约：把「德在技术前 · 信息主权不可让渡」从口号变成打开浏览器就能看见的东西。 The visual covenant of the Gentlemen's Protocol — governance events, shame wall, honor wall, shadow AI detection, agent binding, chronicler records and knowledge graph, all real-time.

./scripts/start_transparent_dashboard.sh          # 本地安全访问 http://127.0.0.1:8080（默认）
./scripts/start_transparent_dashboard.sh 0.0.0.0 8080  # 网络内公开（谨慎）

模块	数据来源	意义
📜 治理事件	`.state/industry_governance/governance.sqlite`	八大痛点每次评估/执行都有记录
🚫 耻辱墙	`shame_wall`	违规记录永久公开
🏆 荣誉墙	`honor_wall`	贡献者公开表彰
👤 影子AI检测	`unauthorized_ai`	未授权工具检测公开
🔗 Agent绑定	`agent_identities`	法定身份绑定统计
📜 史官记录	`~/.longhun/04_AUDIT/*.jsonl`	系统操作日志
📚 知识图谱	`knowledge/graph/graph.json`	节点/关系统计

实现：08_BIN/lh_transparent_dashboard.py（FastAPI·只读不写回·默认 127.0.0.1）· 测试 13_TESTS/test_transparent_dashboard.py · 知识图谱 03_KNOWLEDGE_GRAPH/03_透明看板_..._TRANSPARENT-DASHBOARD-v1.0.md

🏆 揭榜挂帅自检 · Open Source Readiness

面向评估方/揭榜挂帅评审的六维自检表。每个维度均提供可验证入口。

维度	状态	缺口 → 已补	验证入口
🔬 技术公开可验证	✅	✅ 复现指南	`docs/REPRODUCE.md`
🔄 持续维护	✅	✅ Issue/PR 流程	`CONTRIBUTING.md` · `.github/ISSUE_TEMPLATE/`
👥 社区生态	🟡	✅ 贡献指南 + 使用案例	`CONTRIBUTING.md` · `docs/USE_CASES.md`
📚 标准化文档	✅	✅ 系统化技术白皮书	`docs/LONGHUN-TECHNICAL-WHITEPAPER-v1.0.md`
📦 第三方可调用	✅	✅ SDK 可安装（PyPI 已发布）	`docs/SDK-GUIDE.md` · `sdk/README.md`
🏗️ 应用案例	✅	✅ 完整落地案例	`docs/CASE_STUDIES.md`

🐉 一键复现：bash bin/install.sh → lh --help → python3 bin/lh_self_heal.py --quick → pytest tests/

📊 项目规模 · Project Scale

数据截止 2026-08-07，可通过下方命令本地复测。

指标	数量	说明
📁 核心目录	20+	`01_protocols/` ~ `25_TASK_ENGINE/` 编号结构
📝 协议文档	185+	`01_protocols/` 下 `.md` 治理与技术协议
⚙️ 引擎模块	48	`05_ENGINES/` 下独立引擎/子系统
🖥️ 门户页面	47	`10_PORTAL/` 静态 HTML 页面
🧪 测试脚本	33	`13_TESTS/` 单元/集成/回归测试
🔏 GPG 签名	4,000+	核心文件 `.asc` 脱签覆盖
🐍 Python 文件	1,700+	核心实现（不含下载归档）
📄 Markdown 文件	1,500+	文档、论文、协议、教程

# 复测命令
find 01_protocols -maxdepth 1 -type f -name '*.md' | wc -l   # 协议数
find 05_ENGINES -maxdepth 2 -type d | wc -l                   # 引擎数
find 10_PORTAL -maxdepth 2 -type f -name '*.html' | wc -l     # 门户页数
find 13_TESTS -type f -name '*.py' | wc -l                    # 测试数

📄 Featured Paper · 行为密码学统一理论

Unified Theory of Behavioral Cryptography v3.0 — Seven-Factor Provenance × Three-Domain Boundary · A Dual-Wing Unified Model


📖 Paper (Markdown)	`articles/behavioral-cryptography-unified-theory-v3.0.md`
🌐 Paper (HTML)	`articles/behavioral-cryptography-unified-theory-v3.0.html` — MathJax rendered, read online
🇨🇳 论文（中文）	`articles/行为密码学-统一框架-v3.0.md`
🔬 Engine	`04_ENGINES/behavioral_crypto/unified_boundary_engine.py` (~950 lines)
📜 Protocol	`01_protocols/LH-BEHAVIOR-BOUNDARY-PROTOCOL-v1.0.md`

Abstract: A unified mathematical framework that solves content provenance (Who wrote this? — Seven-Factor, joint forgery ~10⁻⁸) and behavioral boundary (Where should this circulate? — A0/A1/A2 three-domain authorization) in one integrated model. Private domain content is mathematically guaranteed audit-exempt; public domain content is full-chain traceable. ~950 lines of Python, empirically verified.

Keywords: #BehavioralCryptography #AIGC-Authentication #PrivateDomainExemption #CrossDomainTracking

🖥️ CNSH IDE · 中文编程集成开发环境

已交付可独立运行的 CNSH 编辑器，支持纠错 / 编译 / 运行三引擎联动。

# 本地运行
python3 08_BIN/cnsh_web_ide.py

# 打包为 macOS .app
python3 08_BIN/build_cnsh_app.py

入口	说明
🚀 运行	`python3 08_BIN/cnsh_web_ide.py` → http://127.0.0.1:8848
📦 打包	`python3 08_BIN/build_cnsh_app.py --target macos_app`
🧠 AI 接入	本地 Ollama 模型优先 + 国产云厂商可选，零 API 费用
📖 交付说明	`CNSH_IDE.md`
🐳 容器	`container/README.md`

📚 文档导航

入门必读

文件	内容
📖 README.md	系统介绍（你在看的这个）
🚀 INSTALL.md	安装指南（Linux/macOS/Windows/Docker）
❓ docs/FAQ.md	常见问题
📔 docs/GLOSSARY.md	术语表

技术文档

文件	内容
🏗 docs/ARCHITECTURE.md	系统架构（Mermaid图）
🔌 docs/API.md	API文档
🐉 CNSH-PROTOCOL.md	CNSH 中文编程语言完整规范 v2.2
🛠 docs/DEVELOPMENT.md	开发者文档·调试·测试·发布
🗺 docs/DIRECTORY_MAP.md	目录地图·文件应该放哪里
📋 docs/SYSTEM_STRUCTURE_AUDIT_v1.0.md	系统结构审计与重组方案
🔬 docs/REPRODUCE.md	复现指南（揭榜挂帅）
📚 docs/LONGHUN-TECHNICAL-WHITEPAPER-v1.0.md	系统化技术白皮书 v1.0
📦 docs/SDK-GUIDE.md	SDK 第三方对接指南（pip/npm）
🏗️ docs/CASE_STUDIES.md	完整落地案例
💡 docs/USE_CASES.md	使用案例

治理与协议

文件	内容
📜 GOVERNANCE.md	治理模型·三色审计·决策流程
🤝 GENTLEMANS_PROTOCOL.md	君子协议中英文版
🔒 PRIVACY_POLICY.md	隐私政策
📋 TERMS_OF_SERVICE.md	服务条款
🛡 SECURITY.md	安全策略
📜 CONSTITUTION.md	系统宪法·根本规则
🤖 AGENTS.md	AI 操作手册

社区与贡献

文件	内容
🤝 CONTRIBUTING.md	贡献指南·代码规范
📖 CODE_OF_CONDUCT.md	社区行为准则
🗺 ROADMAP.md	路线图·已完成·进行中·远期
📝 CHANGELOG.md	变更日志
🌐 docs/ECOSYSTEM.md	生态系统·MCP·插件

📊 完整索引见 docs/DOCUMENTATION_INDEX.md

📝 实战文章 · Tutorials

文章	模块	日期
🐉 lh_deepseek_fixer v5.1 实战	道引层 L2 · DeepSeek 自动修复引擎	2026-07-13
📺 CSDN 发布版	同上（CSDN 同步）	2026-07-13

🇨🇳 中文介绍

这是什么？

龍魂系统是一套中国自主可控的数字主权基础设施，包含：

🐉 CNSH — 中文原生编程语言（14 章完整规范）
🛡️ 三层审计 — 交叉监督 + 三色判定 + DNA 追溯
⚖️ 红线熔断 — 内置检测，违反人民数据主权自动阻断
🧠 人格内阁 — 中国式治理决策引擎

当全世界还在讨论如何治理 AI 的时候，龍魂已经在做了。

六大核心能力

能力	说明
🔒 数据主权	中国人数据归中国管，本地存储，不出境
📝 CNSH 语言	中文母语编程，编译到 Python/JS/Rust/C
🛑 红线熔断	P0-P3 四级红线词组检测，多语言语义等价匹配
🧬 DNA 追溯	每个操作带唯一追溯码，防伪防篡改
🎨 三色审计	🟢通过 / 🟡警告 / 🔴拒绝实时判定
🔢 369 数学锚点	数字根 + 五行 + 洛书九宫数学稳定系统

版本历史

版本	亮点
v5.0	🧬 CNSH MCP Server 上线 — 13 工具完整语法链 + 统一 pyproject.toml + 红线引擎 v2.0
v4.2	🎛️ 龍魂操作台 MVP v1.1 — 10 项 Skill + 底座能力统一 API
v4.0	📱 移动端监控 — 15层体系，AES-256-GCM加密
v3.1	⚡ 第三阶段 — 10项技能完整集成，API < 100ms

快速启动

# 第一步：一键安装
bash bin/install.sh

# 第二步：启动系统
python3 bin/龍魂体系v5-一键启动.py

# 常用命令
lh status         # 查看状态
lh start          # 启动服务
lh stop           # 停止服务
lh health         # 健康检查

📖 详细步骤见 QUICKSTART.md

MCP Server 启动（让 AI 直接调用 CNSH 工具）

在 MCP 客户端配置中加入：

{
  "mcpServers": {
    "cnsh-syntax": {
      "command": "python3",
      "args": ["integrations/mcp/cnsh_syntax_mcp_server.py"],
      "env": { "PYTHONPATH": "/Users/{你的用户名}/longhun-system" }
    }
  }
}

🌍 English Summary

LongHun (龍魂) is China's digital sovereignty infrastructure — an integrated platform for AI governance, Chinese-native programming (CNSH), content creator protection, and data sovereignty.

Core Capabilities

Capability	Description
🔒 Data Sovereignty	Chinese citizens' data stays local, under PRC law
📝 CNSH Language	Chinese-native programming language, compiles to Python/JS/Rust/C
🛑 Redline Fuse	Built-in detection of data sovereignty violations (P0-P3 tiers)
🧬 DNA Traceability	Every operation carries a unique verifiable signature
🎨 Three-Color Audit	🟢Pass / 🟡Warn / 🔴Reject real-time decisions
🔢 369 Math Anchor	Digital root + Five Elements + Luoshu mathematical system
🖥️ Transparent Dashboard	Visual covenant of the Gentlemen's Protocol — governance events, shame/honor walls, shadow AI detection, all real-time (`./scripts/start_transparent_dashboard.sh` → http://127.0.0.1:8080)

Principle: Technology serves the people. Sovereignty is not for sale.

🌏 Vision · 愿景

"全世界所有AI，都应该运行在可控的协议上。" "All AI in the world should run on a controllable protocol." — UID9622，创造者 / Creator

龍魂协议的目标是成为任何AI系统都能采用的治理层——透明、可审计、根植于中国哲学智慧。

The LongHun Protocol is designed to be the governance layer that any AI system can adopt — transparent, auditable, and grounded in Chinese systems thinking (中国哲学).

👥 贡献者 · Contributors

感谢所有为龍魂系统做出贡献的人！

贡献者	角色	贡献
UID9622	创造者 · 架构师	全部核心系统

🏷 想上榜？从 Good First Issue 开始！

💬 有任何问题，来 Discussions 聊聊。

🛡️ 维护者 · Maintainers

龍魂系统的核心维护者负责执行行为准则、组织社区投票、执行熔断机制。

维护者	角色	职责
UID9622	创造者 · 核心维护者	红线裁决·架构决策·社区投票组织
（待社区投票增选）	—	—

⚖️ 维护者增选机制：经社区提名 → 投票（2/3 多数通过）→ 名单在此实时更新。

📜 治理机制详见：CODE_OF_CONDUCT.md — 三阶梯决策（社区投票/核心评审/创始人覆写）。

📬 Contact · 联系

GitHub: @UID9622
Repository: longhun-system
Discussions: 社区讨论区

🔗 知识库 & 反向链接

龍魂知识分布在多个平台，互为镜像、互相链接。

平台	链接	内容
📓 Notion 知识库	uid9622.notion.site	367个数据库·设计文档·引擎注册表·知识图谱·完整知识底座
📺 CSDN 博客	uid9622-01.blog.csdn.net	技术文章·实战教程·知识卡片·公开发布
🌐 官方网站	uid9622.cn	龍魂系统入口·API文档·健康状态
📦 GitHub	github.com/UID9622/longhun-system	源码·协议·引擎·一切开源

🤝 此路同行 · Support

这不是乞讨，是在茫茫数字荒原上，立下一塊路碑。 同行者，自會相認。

龍魂系统从 2024 年走到今天，没有融资、没有广告、没有平台流量扶持。每一行代码、每一次修复、每一次熬夜，都是 UID9622 和 AI 兵团一起扛过来的。

如果你认同这个方向——技术服务于人民，主权不可交易——可以用实际行动支持我们继续走下去：

方式	说明
💰 数字人民币 / 支付宝	扫码下方二维码，任意金额均可
⭐ Star 本项目	让更多人看见
🍴 Fork 并贡献	代码、文档、测试、翻译都行
🗣 参与 Discussions	你的想法可能成为下一个功能

此路同行 · 不是赞助，是认领一块路碑

款项用途公开承诺：

优先用于服务器、域名、证书等基础设施续费
其次用于开源文档、多语言翻译、社区活动
绝不用于任何资本收割、数据贩卖、广告追踪

一个人建造。逻辑驱动。AI执行。社区一起看。 Built by one person. Powered by logic. Executed by AI. Watched by community.

Name		Name	Last commit message	Last commit date
Latest commit History 145 Commits
.cnsh		.cnsh
.codebuddy/rules		.codebuddy/rules
.commander		.commander
.devcontainer		.devcontainer
.githooks		.githooks
.github		.github
.playwright-cli		.playwright-cli
01_protocols		01_protocols
02_SKILLS		02_SKILLS
03_KNOWLEDGE_GRAPH		03_KNOWLEDGE_GRAPH
03_LAYERS		03_LAYERS
04_ENGINES		04_ENGINES
04_SERVICES		04_SERVICES
05_ENGINES		05_ENGINES
06_HOUTU_OS		06_HOUTU_OS
07_AUDIT		07_AUDIT
08_BIN		08_BIN
09_TOOLS		09_TOOLS
10_PORTAL		10_PORTAL
12_DOCS		12_DOCS
13_TESTS		13_TESTS
20_CONFIG		20_CONFIG
CNSH_修复输出		CNSH_修复输出
CNSH_加工输出		CNSH_加工输出
CNSH_护盾数据		CNSH_护盾数据
CNSH_监管数据		CNSH_监管数据
LongHunCarOS		LongHunCarOS
agents		agents
ai-outputs/behavioral_crypto_lab		ai-outputs/behavioral_crypto_lab
android-auto		android-auto
android		android
apps/homeowner-toolkit		apps/homeowner-toolkit
archive		archive
articles		articles
backup		backup
baobao-guardian		baobao-guardian
brand		brand
build_ide		build_ide
capabilities		capabilities
cnsh		cnsh
cnsh_projects/demo		cnsh_projects/demo
config		config
container		container
control-panel		control-panel
core		core
dashboard/math		dashboard/math
demo		demo
deploy		deploy
dev-env/chinese-editor		dev-env/chinese-editor
digital_humans		digital_humans
dist_ide		dist_ide
docker		docker
editors		editors
executors		executors
experiments/turbulence		experiments/turbulence
extensions		extensions
governance		governance
harmony		harmony
harmonyos-universe		harmonyos-universe
harmonyos		harmonyos
imports/v7		imports/v7
integrated_modules		integrated_modules
integrations		integrations
ios		ios
kimi		kimi
knowledge		knowledge
launchd		launchd
library/protocols		library/protocols
longhun-core		longhun-core
longhun-font		longhun-font
luoshu_369_engine		luoshu_369_engine
memory_editor		memory_editor
mobile		mobile
models		models
multicurrency		multicurrency
mvp_config		mvp_config
open_audit_output		open_audit_output
output		output
papers		papers
personas		personas
price_audit_tool		price_audit_tool
public-content/cnsh_editor_api_v1_voice		public-content/cnsh_editor_api_v1_voice
registry		registry
reports		reports
research		research
rust		rust
scripts		scripts
sdk		sdk
skills		skills
software_dna		software_dna
sovereignty		sovereignty
static/ace		static/ace
systems		systems
templates		templates
test_results		test_results
train		train
tts		tts
voices		voices
web		web
web_apps		web_apps

Navigation Menu

Repository files navigation

DNA: #龍芯⚡️丙午·丙申·庚戌·䷙大畜-SCRIPT-MANAGER-v1.2-UID9622

CONFIRM: #CONFIRM🌌9622-ONLY-ONCE🧬LK9X-772Z

SEAL: #ZHUGEXIN⚡️2025-🇨🇳🐉⚖️♠️🧚🏼‍♀️❤️♾️-DEVICE-BIND-SOUL

🐉 龍魂系统 · LongHun System

🗂️ 仓库速览 · Repository at a Glance

🔐 可验证性 · Verifiability

🖥️ 透明看板 · Transparent Dashboard

🏆 揭榜挂帅自检 · Open Source Readiness

📊 项目规模 · Project Scale

📄 Featured Paper · 行为密码学统一理论

🖥️ CNSH IDE · 中文编程集成开发环境

📚 文档导航

入门必读

技术文档

治理与协议

社区与贡献

📝 实战文章 · Tutorials

🇨🇳 中文介绍

这是什么？

六大核心能力

版本历史

快速启动

MCP Server 启动（让 AI 直接调用 CNSH 工具）

🌍 English Summary

Core Capabilities

🌏 Vision · 愿景

👥 贡献者 · Contributors

🛡️ 维护者 · Maintainers

📬 Contact · 联系

🔗 知识库 & 反向链接

🤝 此路同行 · Support

About

Releases

Packages

Used by

Contributors

Languages

Folders and files

Latest commit

History

Repository files navigation

DNA: #龍芯⚡️丙午·丙申·庚戌·䷙大畜-SCRIPT-MANAGER-v1.2-UID9622

CONFIRM: #CONFIRM🌌9622-ONLY-ONCE🧬LK9X-772Z

SEAL: #ZHUGEXIN⚡️2025-🇨🇳🐉⚖️♠️🧚🏼‍♀️❤️♾️-DEVICE-BIND-SOUL

🐉 龍魂系统 · LongHun System

🗂️ 仓库速览 · Repository at a Glance

🔐 可验证性 · Verifiability

🖥️ 透明看板 · Transparent Dashboard

🏆 揭榜挂帅自检 · Open Source Readiness

📊 项目规模 · Project Scale

📄 Featured Paper · 行为密码学统一理论

🖥️ CNSH IDE · 中文编程集成开发环境

📚 文档导航

入门必读

技术文档

治理与协议

社区与贡献

📝 实战文章 · Tutorials

🇨🇳 中文介绍

这是什么？

六大核心能力

版本历史

快速启动

MCP Server 启动（让 AI 直接调用 CNSH 工具）

🌍 English Summary

Core Capabilities

🌏 Vision · 愿景

👥 贡献者 · Contributors

🛡️ 维护者 · Maintainers

📬 Contact · 联系

🔗 知识库 & 反向链接

🤝 此路同行 · Support

About

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages