📚 语法参考（16 章规范同步）

本页目录

第4章：值类型系统
第5章：指令结构（主语·谓语·宾语·修饰语）
第6章：控制流
第7章：变量与绑定
第8章：函数与模块
附录A：保留关键字
附录B：DNA 格式速查表
附录C：与自然语言的边界
附录D：CNSH vs JSON vs YAML vs Python vs Prompt

第4章：值类型系统

DNA: #龍芯⚡️丙午·丙申·丁卯·丙午·䷚颐-CNSH-CHAPTER-04-v1.0

创建者: 诸葛鑫（UID9622）

协议: CC BY-NC-SA 4.0（核心思想层）

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

三色: 🟢 已定稿

---

4.1 基本类型

类型	关键字	示例	说明
字符串	`字符串`	`"龍魂"`	中文双引号
整数	`整数`	`42`	十进制
小数	`小数`	`3.14`	浮点
布尔	`真` `假`	`真`	逻辑值
空值	`无`	`无`	空
列表	`列表`	`[1, 2, 3]`	有序集合
映射	`映射`	`{名称: 值}`	键值对

4.2 类型声明

整数 龙年 = 2026
字符串 欢迎词 = "欢迎来到龙魂"
小数 圆周率 = 3.14159
布尔 是否开启 = 真
列表 数字 = [1, 2, 3, 5, 8]
映射 配置 = {引擎: "CNSH", 版本: "1.0"}

4.3 类型推断

# 声明时省略类型，由解析器推断
龙年 = 2026          # 整数
名称 = "龍魂"         # 字符串

4.4 类型转换

转换 数字 = 文本转整数 "2026"     # 2026
转换 文本 = 整数转文本 2026        # "2026"

转换函数	说明
`文本转整数`	字符串 → 整数
`整数转文本`	整数 → 字符串
`文本转小数`	字符串 → 小数
`转布尔`	值 → 布尔

4.5 类型检查

检查类型 "龍魂"         # 字符串
检查类型 42             # 整数
检查类型 [1,2,3]        # 列表

类型一致 42 整数        # 真

4.6 数字根校验（龍魂特色）

龍魂体系的核心数学锚点是洛书369不动点：sn=369, log369=5.911, perm369=108。CNSH 提供数字根校验：

数字根 2026    # 2+0+2+6 = 10 → 1+0 = 1
数字根 369     # 3+6+9 = 18 → 1+8 = 9

用途	说明
权重校验	关键参数用数字根交叉验证
决策闸门	三闸门决策流场（数字根→身份→伦理）
数据一致性	两条记录数字根一致 → 强关联

4.7 本章小结

7 种基本类型：字符串/整数/小数/布尔/空值/列表/映射
支持类型声明、推断、转换、检查
数字根校验是龍魂特有的数值验证手段

4.8 练习

1. 声明一个映射，存储你的个人信息 2. 把 "2026" 转成整数并加 1 3. 计算你的出生年份的数字根

---

章节导航

---

GPG: A2D0092CEE2E5BA87035600924C3704A8CC26D5F

第5章：指令结构（主语·谓语·宾语·修饰语）

DNA: #龍芯⚡️丙午·丙申·丁卯·丙午·䷚颐-CNSH-CHAPTER-05-v1.0

创建者: 诸葛鑫（UID9622）

协议: CC BY-NC-SA 4.0（核心思想层）

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

三色: 🟢 已定稿

---

5.1 核心概念

CNSH 指令遵循中文自然语序：

[主语] [谓语] [宾语] [修饰语]

成分	说明	示例
主语	执行主体	`宝宝` `系统` `用户`
谓语	动作/操作	`输出` `读取` `执行` `审计`
宾语	操作对象	`文件` `数据` `命令`
修饰语	条件/参数	`在路径下` `用三色判定`

5.2 基本指令

# 最简单的指令
输出 "Hello"

# 完整结构
宝宝 输出 "Hello" 在控制台

# 带审计
系统 审计 本次操作 用三色判定

5.3 指令类型

类型	谓语示例	用途
输出类	`输出` `打印` `回显`	输出信息
输入类	`读取` `接收` `获取`	获取输入
执行类	`执行` `运行` `调用`	执行命令
审计类	`审计` `检查` `验证`	审计追溯
控制类	`如果` `否则` `循环`	控制流

5.4 八类指令与八卦对应（龍魂特色）

龍魂体系以八卦分类命令（lh6 命令总目），CNSH 指令同样映射：

卦	指令域	谓语示例
乾（启动）	启动/初始化	`启动` `初始化`
坤（状态）	状态/查询	`查询` `状态`
震（审计）	审计/追溯	`审计` `检查`
巽（安全）	安全/加密	`加密` `校验`
坎（主权）	主权/身份	`验证身份` `授权`
离（技能）	技能/引擎	`调用` `运行`
艮（同步）	同步/归档	`同步` `归档`
兑（部署）	部署/发布	`部署` `发布`

5.5 实战示例

# 从 README.md 读取 DNA
读取 "README.md" 提取 DNA

# 如果提取成功则审计
如果 DNA存在
  审计 该DNA 用三色判定
否则
  输出 "未找到DNA"

5.6 与自然语言的边界

场景	用 CNSH	用散文
给 AI 下指令	✅	❌
写代码逻辑	✅	❌
讨论需求	❌	✅
写文档说明	❌	✅

5.7 本章小结

指令 = 主语 + 谓语 + 宾语 + 修饰语，中文自然语序
5 类指令类型：输出/输入/执行/审计/控制
8 类指令域对应八卦：乾启动 · 坤状态 · 震审计 · 巽安全 · 坎主权 · 离技能 · 艮同步 · 兑部署

5.8 练习

1. 写一条指令：让系统读取 MEMORY.md 并提取最近 10 条记录 2. 写一条审计指令：检查 DNA.md 的 GPG 签名 3. 把指令按八卦归类：部署网站 属于哪一卦？

---

章节导航

---

GPG: A2D0092CEE2E5BA87035600924C3704A8CC26D5F

第6章：控制流

DNA: #龍芯⚡️丙午·丙申·丁卯·丙午·䷚颐-CNSH-CHAPTER-06-v1.0

创建者: 诸葛鑫（UID9622）

协议: CC BY-NC-SA 4.0（核心思想层）

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

三色: 🟢 已定稿

---

6.1 条件判断

CNSH 用中文条件字：

如果 条件
  指令1
否则 如果 条件2
  指令2
否则
  指令3

整数 分数 = 85
如果 分数 >= 90
  输出 "优秀"
否则 如果 分数 >= 60
  输出 "及格"
否则
  输出 "加油"

6.2 条件操作符

操作符	含义	示例
`等于`	==	`分数等于 85`
`不等于`	!=	`分数不等于 60`
`大于`	>	`分数大于 80`
`小于`	<	`分数小于 60`
`大于等于`	>=	`分数大于等于 90`
`小于等于`	<=	`分数小于等于 100`
`并且`	and	`A 并且 B`
`或者`	or	`A 或者 B`
`非`	not	`非条件`

6.3 循环

循环 数字 在 [1,2,3,4,5]
  输出 数字

# 次数循环
循环 5 次
  输出 "第几次"

循环类型	语法	说明
遍历列表	`循环 X 在 [列表]`	遍历元素
次数循环	`循环 N 次`	固定次数
条件循环	`循环当条件`	条件满足持续

6.4 中断与继续

循环 数字 在 [1,2,3,4,5]
  如果 数字 等于 3
    跳过          # continue
  如果 数字 等于 5
    停止          # break
  输出 数字

6.5 三色分支（龍魂特色）

审计场景专用分支：

三色 判定 审计结果
  🟢 输出 "通过，放行"
  🟡 输出 "待核，标记"
  🔴 输出 "红线，熔断"

6.6 熔断条件分支

如果 触发P0
  熔断 执行         # 立即停止，L0/∞ 级
否则 如果 触发L1
  熔断 数据         # 拒绝请求 + MELTDOWN
否则 如果 触发L2
  熔断 人格         # 禁用当前人格
否则 如果 触发L3
  熔断 行为         # 锁定当前任务
否则
  继续 执行

6.7 本章小结

条件：如果 / 否则如果 / 否则
条件操作符全中文：等于/大于/并且/或者/非
循环：遍历 / 次数 / 条件
三色分支直接内建审计判定
四级熔断（∞L0/L1/L2/L3）可写为控制流

6.8 练习

1. 写一个判断闰年的程序 2. 用循环输出 1-10 的偶数 3. 写一个三色审计：分数>=60 🟢，>=50 🟡，否则 🔴

---

章节导航

---

GPG: A2D0092CEE2E5BA87035600924C3704A8CC26D5F

第7章：变量与绑定

DNA: #龍芯⚡️丙午·丙申·丁卯·丙午·䷚颐-CNSH-CHAPTER-07-v1.0

创建者: 诸葛鑫（UID9622）

协议: CC BY-NC-SA 4.0（核心思想层）

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

三色: 🟢 已定稿

---

7.1 变量声明

整数 计数 = 0
字符串 名称 = "龍魂"
列表 任务 = []
映射 配置 = {}

7.2 命名规范（龍魂二元体系）

对齐 CNSH_命令与变量命名规范-v2.0.md：

前缀	层级	用途	示例
`龍_`	系统级	龍魂保留命名空间	`龍_系统` `龍_引擎` `龍_用户`
`数据_`	数据级	用户数据处理	`数据_用户` `数据_日志`
无前缀	局部级	临时变量	`计数` `名称`

铁律：系统核心变量禁止用英文缩写；品牌/核心类名繁体「龍」永存（如 龍_系统），兼容性通用变量中文蛇形。

7.3 赋值

# 直接赋值
计数 = 计数 + 1

# 复合赋值
计数 加 1
计数 减 1
计数 乘 2
计数 除 2

复合操作符	含义
`加`	+=
`减`	-=
`乘`	*=
`除`	/=
`连接`	字符串拼接

7.4 作用域

全局: 龍_系统 = "在线"

函数 处理任务
  局部: 临时值 = 100    # 函数内可见
  输出 龍_系统           # 全局可见

输出 临时值              # ❌ 超出作用域

作用域	声明	可见范围
全局	`全局: 名称 = 值`	整个程序
局部	`局部: 名称 = 值`	当前块/函数
默认	`名称 = 值`	当前块

7.5 常量

常量 圆周率 = 3.14159
常量 系统版本 = "v1.0"
# 常量不可重新赋值

7.6 敏感数据处理（龍魂数据铁律）

# 敏感数据端侧加密
数据_用户 = 加密 "手机号内容" 用国密算法
# 云上只存密文，日志只打哈希指纹
记录 日志 数据_用户 的 哈希指纹

数据级别	处理
D1 绝密	永不入云，请求即熔断
D2 机密	端侧国密加密，云上只存密文
D3 内部	日志脱敏
D4 公开	自由流动

7.7 本章小结

变量 = 名称 = 值，类型可选
命名：龍_ 系统级 / 数据_ 数据级 / 无前缀局部级
复合赋值：加/减/乘/除/连接
作用域：全局/局部/当前块
敏感数据端侧加密，日志只存哈希指纹

7.8 练习

1. 声明一个全局 龍_系统 变量和局部变量 2. 用复合赋值累加 1-10 的和 3. 写一个加密存储用户手机号的示例

---

章节导航

---

GPG: A2D0092CEE2E5BA87035600924C3704A8CC26D5F

第8章：函数与模块

DNA: #龍芯⚡️丙午·丙申·丁卯·丙午·䷚颐-CNSH-CHAPTER-08-v1.0

创建者: 诸葛鑫（UID9622）

协议: CC BY-NC-SA 4.0（核心思想层）

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

三色: 🟢 已定稿

---

8.1 函数定义

函数 计算面积(半径)
  返回 3.14159 * 半径 * 半径

# 调用
面积 = 调用 计算面积(10)
输出 面积    # 314.159

8.2 参数

函数 问候(名称, 语气 = "友好")
  输出 "你好，" + 名称 + "，语气：" + 语气

调用 问候("龍魂")              # 用默认语气
调用 问候("龍魂", 语气="正式")  # 覆盖默认

8.3 返回值

函数 计算(左, 右, 操作)
  如果 操作 等于 "加"
    返回 左 + 右
  否则
    返回 左 * 右

结果 = 调用 计算(3, 4, "加")     # 7

8.4 模块

CNSH 程序可以按模块组织：

模块 文件处理
  函数 读取文件(路径)
    返回 读取 路径

  函数 写入文件(路径, 内容)
    写入 内容 到 路径

# 导入使用
导入 文件处理
调用 文件处理.读取文件("README.md")

8.5 系统函数库（内建）

函数	说明
`输出`	输出到控制台
`读取`	读取文件/输入
`审计`	三色审计
`生成DNA`	生成 DNA 追溯码
`验证DNA`	校验 DNA 格式
`加密` `解密`	国密/AES 加密
`数字根`	洛书369 数字根计算
`同步` `归档`	数据同步与归档

8.6 函数与 DNA

每个函数体建议绑定 DNA，形成可追溯单元：

函数 关键计算
  DNA: #龍芯⚡️丙午·丙申·丁卯·丙午·䷚颐-引擎-计算-v1.0-UID9622-ABCD1234
  返回 数字根(369)

8.7 本章小结

函数 = 函数名称(参数) + 返回
支持默认参数、命名参数
模块化组织：模块 + 导入
内建系统函数库覆盖 IO/审计/DNA/加密/数理

8.8 练习

1. 写一个函数：判断一个数是否为偶数 2. 定义 模块用户管理，含注册/登录两个函数 3. 给关键函数绑定 DNA

---

章节导航

---

GPG: A2D0092CEE2E5BA87035600924C3704A8CC26D5F

附录A：保留关键字

DNA: #龍芯⚡️丙午·丙申·丁卯·丙午·䷚颐-CNSH-APPENDIX-A-v1.0

创建者: 诸葛鑫（UID9622）

协议: CC BY-NC-SA 4.0（核心思想层）

三色: 🟢 已定稿

---

A.1 全部保留关键字

以下关键字不可用作变量名、函数名、模块名。

指令类

输出 打印 回显 读取 接收 获取 执行 运行 调用
启动 初始化 停止 恢复 查询 状态 同步 归档 部署 发布

控制类

如果 否则 否则如果 循环 当 在 次 停止 跳过 返回
尝试 捕获 最终 抛出 熔断 降级 回退

声明类

函数 模块 导入 变量 常量 全局 局部 上下文 环境 会话

类型类

字符串 整数 小数 布尔 真 假 无 列表 映射

审计类

审计 检查 验证 判定 三色 通过 待核 拒绝
生成DNA 验证DNA 数字根 GPG签名 校验SHA

八卦类（保留字）

乾 坤 震 巽 坎 离 艮 兑

其他

加密 解密 转换 解析 执行Python 执行Shell 脚本
管道 确认 密钥 记录 输出摘要

A.2 机器可读版

见 spec/reserved_keywords.txt，供解析器直接加载。

A.3 使用规则

规则	示例
变量名不可用关键字	~~`输出 = 1`~~ ❌
加前缀可避开	`数据_输出 = 1` ✅
关键字大小写固定	全中文，无大小写问题

---

GPG: A2D0092CEE2E5BA87035600924C3704A8CC26D5F

附录B：DNA 格式速查表

DNA: #龍芯⚡️丙午·丙申·丁卯·丙午·䷚颐-CNSH-APPENDIX-B-v1.0

创建者: 诸葛鑫（UID9622）

协议: CC BY-NC-SA 4.0（核心思想层）

三色: 🟢 已定稿

---

B.1 两种合法格式

# 日期格式（社区通用）
#龍芯⚡️丙午·丙申·丁卯·丙午·䷚颐-申时-CNSH-SPEC-CREATE-v1.0-UID9622-A7B8C9D0

# 干支四柱格式（龍魂内部）
#龍芯⚡️丙午·丙申·癸酉·癸亥·䷵归妹-CNSH-SPEC-CREATE-v1.0-UID9622-A7B8C9D0

B.2 12 时辰表

时辰	时段	时辰	时段
子	23-01	午	11-13
丑	01-03	未	13-15
寅	03-05	申	15-17
卯	05-07	酉	17-19
辰	07-09	戌	19-21
巳	09-11	亥	21-23

B.3 常用模块名

模块	用途
`CNSH-SPEC`	CNSH 规范
`CNSH-COMPILER`	编译器
`DATA-AUDIT`	数据审计
`DEPLOY`	部署
`MEMORY`	记忆系统
`ENGINE-*`	引擎模块

B.4 常用动作名

动作	含义
`CREATE`	创建
`EDIT` / `REV`	修改
`DEPLOY`	部署
`PUBLISH`	发布
`AUDIT`	审计
`SIGN`	签名
`ARCHIVE`	归档

B.5 验证清单

✅ 前缀 = #龍芯⚡️
✅ 日期有效
✅ 时辰在12时辰列表
✅ 模块大写+下划线
✅ 版本 vX.X
✅ UID = UID9622
✅ 哈希 = 8位十六进制

B.6 快速生成/验证

lh6 dna 生成 --module CNSH-SPEC --action CREATE
lh6 dna 验证 "#龍芯⚡️丙午·丙申·丁卯·丙午·䷚颐-申时-CNSH-SPEC-CREATE-v1.0-UID9622-A7B8C9D0"

---

GPG: A2D0092CEE2E5BA87035600924C3704A8CC26D5F

附录C：与自然语言的边界

DNA: #龍芯⚡️丙午·丙申·丁卯·丙午·䷚颐-CNSH-APPENDIX-C-v1.0

创建者: 诸葛鑫（UID9622）

协议: CC BY-NC-SA 4.0（核心思想层）

三色: 🟢 已定稿

---

C.1 核心边界

场景	用 CNSH	用自然语言
给 AI 下确定性指令	✅	❌
写可执行逻辑	✅	❌
审计/追溯	✅	❌
讨论需求/意图	❌	✅
描述背景/情感	❌	✅
头脑风暴	❌	✅

一句话：CNSH 是"给机器看的规则"，自然语言是"给人看的想法"。两者不是替代关系，是分工关系。

C.2 为什么不能全用自然语言

自然语言问题	例子
歧义	"把那个东西处理一下" — 哪个？怎么处理？
不可复现	每次解释不同，结果不同
不可审计	无法追溯谁写了什么
不可验证	无法自动判定对错

C.3 CNSH 如何保留自然语言可读性

# 一眼能看懂（中文自然语序）
如果 文件不存在
  创建 文件
  写入 "初始内容" 到 文件
否则
  输出 "文件已存在"

CNSH 选择结构化中文而非纯自然语言，既保留了可读性，又获得了确定性。

C.4 混合使用模式

# 注释用自然语言说明"为什么"
# 这段逻辑是为了防止重复写入导致数据覆盖
如果 文件存在
  追加 "新内容" 到 文件

C.5 判断标准

写 CNSH 前问自己三问：

1. 这句话机器能无歧义执行吗？ 2. 这句话能自动验证对错吗？ 3. 这句话能追溯到创建者吗？

三个都是 ✅ → 用 CNSH。否则 → 用自然语言。

---

GPG: A2D0092CEE2E5BA87035600924C3704A8CC26D5F

附录D：CNSH vs JSON vs YAML vs Python vs Prompt

DNA: #龍芯⚡️丙午·丙申·丁卯·丙午·䷚颐-CNSH-APPENDIX-D-v1.0

创建者: 诸葛鑫（UID9622）

协议: CC BY-NC-SA 4.0（核心思想层）

三色: 🟢 已定稿

---

D.1 总览对比

特性	CNSH	Python	JSON	YAML	Prompt
中文原生	✅	❌	❌	❌	✅
可解析（机器）	✅	✅	✅	✅	❌
可追溯（DNA）	✅	❌	❌	❌	❌
零门槛	✅	❌	❌	❌	✅
可执行	✅	✅	❌	❌	❌
确定性	✅	✅	✅	✅	❌
审计内建	✅	❌	❌	❌	❌
多用途	指令+数据+审计	计算	数据	配置	指令

D.2 同一任务五种写法

任务：如果分数大于等于 60 输出"及格"，否则"加油"

# Python
if score >= 60:
    print("及格")
else:
    print("加油")

# CNSH
如果 分数 大于等于 60
  输出 "及格"
否则
  输出 "加油"

// JSON（只能表达数据，不能执行）
{"condition": "score>=60", "output": ["及格", "加油"]}

# YAML（同上，配置为主）
condition: score>=60
output:
  - 及格
  - 加油

# Prompt（自然语言，非确定性）
如果分数大于等于60，你就输出及格，否则输出加油。

D.3 各自的定位

语言	定位	什么时候用
CNSH	人机协作指令+审计语言	给 AI 下指令、审计追溯、龍魂体系
Python	通用计算语言	复杂算法、后端、生态
JSON	数据交换格式	API 传输、存储
YAML	配置文件格式	配置文件、CI/CD
Prompt	自然语言交互	讨论意图、对话

D.4 CNSH 的互补定位

CNSH 不是替代品，而是补齐了其他语言的空白：

其他语言缺什么 → CNSH 补什么
├── 中文原生 → 中文开发者零门槛
├── 可追溯 → 每行绑定 DNA
├── 审计内建 → 三色判定即语法
├── 熔断内建 → 安全保护即语法
└── 指令+数据+审计 → 一种语言全覆盖

D.5 建议组合

场景	推荐组合
龍魂内部指令	CNSH + Shell
数据交换	CNSH 定义结构 → JSON 传输
复杂算法	CNSH 调用 Python
配置	CNSH 或 YAML（按团队）
对外 API	JSON（标准）

---

GPG: A2D0092CEE2E5BA87035600924C3704A8CC26D5F