laomeng-zhc
老孟中文编程(ZHC)语言内核与智能体协作技能。当需要编写、编译、运行、诊断 ZHC 源码(.zc 文件),或需要把表格数据导出为 CSV/XLSX/DOCX/HTML,或需要查询中文关键字、内置函数、中文错误码与契约版本时使用本技能。适用于纯中文编程教学、中文代码生成、中文报错诊断与 Office 文档产出场景。
老孟中文编程 ZHC
1.0.15(2026-11-16) 口径追平
ZHC-LANG-2.1冻结层:本包内核(zhc.py190000 B /92806D53…)已被 2026-11-16 09:54:16 新开的ZHC-LANG-2.1层收为正式基线zhc_基线_2.1.py,并与该层契约快照(56880 B /9C164AA6…,内部修订 2.6)逐字节同源——线上件重新有基线可依,C04 由红转绿。元数据frozen同步改为 2026-11-16。语言能力、计数口径(44/72/39/11/39)与用法零变化;本版统一版本序列:四包 × 两渠道同号 1.0.15。 1.0.14(2026-11-16) 渠道授权口径分叉:本包经 ClawHub 渠道发布,依平台统一规则以 MIT-0 授权。license字段与LICENSE.txt改为「MIT-0 授权 + 归属声明(事实记载)」,移除原条款中的署名、改名与限售限制;内核、契约、脚本与示例零改动,功能与用法与前版完全一致。 1.0.12(2026-11-15) 契约内部修订 2.4→2.6(契约族仍 1.8、语言面仍ZHC-LANG-2.0),内核零改动(zhc.py190000 字节 /9822E53484CE/92806D53…,与 1.0.11 期逐字节相同)。本次修订仅收敛③错误结构两字段与修订元信息,①语法集四项计数与七组关键字零改动,唯一码位 39 不变(E315 仍为空闲)。references 三件按内部修订 2.6 重渲染,四目录逐字节同源。技能序列扩为四包并统一版本号:新增laomeng-zhc-kb(老孟中文编程资料库)与laomeng-zhc-tutorial(老孟带你学编程,7 课示例回归 7/7rc=0)。修正智能体包元数据errorcodes: 38→39(码位在 1.0.11 已增至 39,元数据未跟)。
1.0.11(2026-11-15) 语言面契约升
ZHC-LANG-2.0(契约族仍 1.8、内部修订 2.4),内核实现有实质变更(zhc.py187195 字节 /72942f52…,相对基线 2.2 净增 +529 行 / −29 行):新增第三目标wasm32-unknown-unknown(no_std、无 WASI,三件垫片自管 1 MB 输出缓冲,导出main/memory/zhc_out_ptr/zhc_out_len/zhc_out_reset/zhc_out_cap);该目标下文件 I/O 内置改报 E314 并提示改用 x86-64 或 wasm32-wasi;新增scripts/run_noos.js作为该目标的宿主运行器(node run_noos.js 目标.wasm),随包分发。契约侧登记错误码 E314,唯一码位 38→39;①语法集四项计数与七组关键字零改动。references 三件按契约 1.8 现渲染,四目录逐字节同源。 1.0.10(2026-11-13) 语言面契约升ZHC-LANG-1.8(内部修订 2.4),内核零改动(zhc.py仍为基线 2.2,155671 字节,与 1.0.9 期逐字节相同)。契约仅白名单改动:新增门禁核对.第4级门禁_4.5(文件 I/O 跨目标字节级等价性,门禁 74/74 PASS)与已知局限[10]一条澄清;①语法集四项计数与七组关键字零改动,错误码位仍 38。references 三件按契约 1.8 现渲染,四目录逐字节同源。 1.0.9(2026-11-12) 语言面契约升ZHC-LANG-1.7(内部修订 2.3),内核零改动(zhc.py与 1.6 期逐字节相同,仍为基线 2.2)。契约仅两处白名单改动:①①语法集.语句形态中函数定义行由函数 名 接受 (参数:类型,…) -> 类型 … 结束更正为函数 名(参数:类型,…) 返回 类型 … 结束(->在词法层不存在、接受无语法消费点,系 契约 1.0~1.6 七份契约一路传抄的笔误,实现侧从未支持该写法,故改契约不改实现);② 新增①语法集.预留关键字字段,显式标注接受为预留(无语法作用)、禁止用于函数定义,误写即被 E208 拦下。关键字全表与「关键字 44 / 保留词 72 / 内置 39 / 类型 11 / 错误码 39」口径零改动。references 换为契约_1.7_全量参考.md(契约_1.6_全量参考.md退役);错误码表_E_1.5.md仅标题行契约源指向随版更新。语言服务悬停文案同步更正(函数/外部两处写法),配套编辑器扩展升 0.2.7,serverInfo.version同步 0.2.7。 1.0.8(2026-11-12) 内核实现层收敛两处契约-实现分歧,契约族仍为ZHC-LANG-1.6(契约_1.6.json/契约_1.6.md零字节改动,语义面七组零改动):①循环 … 结束缺省步长原写e_step = ("1LL", "int")漏解包,emit 插入 Python 元组 repr,生成 C 的_s = ('1LL', 'int');退化为逗号表达式、取到多字符常量后首轮越界退出,已改为e_step = "1LL",全库逐行检索该形态仅此一处;②定义 x 为 类型 = 初值原stmt_define()未消费等号、报 E203,现先accept_op("=")分流,无等号分支判据原样保留。二者均按契约_1.7_全量参考.md第 26/30 行形态实现。验证:27 项 release 级矩阵(1 到 5→1 2 3 4 5、1..100 累加 →5050、边界表达式、文本/逻辑/浮点初值、错误路径 E202/E203/E309 对齐)、7 件选摘示例输出逐字一致、显式步长与当循环无回归;门禁 4.3 全量重跑 PASS 114 / FAIL 0(231.9 秒);壳侧cargo test --release --locked4 passed、GUI 点击层复跑通过、壳源码一行未动、zhc-studio.exe指纹未变。冻结快照升为ZHC-LANG-1.7(基线件zhc_基线_2.2.py,155671 B / SHA256ea7ec452…92fa03),契约版本维持 2.2 —— 本版不改契约,只让实现追上 1.6 已宣告的语义。 1.0.7(2026-11-11) 语言面契约追平至ZHC-LANG-1.6(契约族版本 1.6 / 内部修订 2.2,内核零改动:zhc.py与 1.5 逐字节相同,SHA256 未变)。契约①语法集新增保留词总数/纯关键字/组内关键字/组外纯关键字/字段口径五个字段,把关键字总数降为兼容别名(只增不改)——「关键字 44 / 保留词 72」的层级自此由契约自身承载,不再只靠文档层约定。references 换为契约_1.7_全量参考.md(四目录同源),错误码表_E_1.5.md沿用(码位 38 未变,码表版本线独立于契约线)。SKILL 元数据补reserved: 72与keywords: 44并列,消除「本技能关键字 72」这一读法。本版起架构自检新增 C13(契约计数字段自洽),检查项由 12 增至 13。1.0.6(2026-11-11) 语言规模口径消歧并全局统一:references 头部与计数行一律表述为「关键字 44 / 保留词 72 / 内置 39 / 类型 11 / 错误码 39」。此前把保留词总数 72(=纯关键字 44 + 同属保留词的内置函数名 28)直接写成「关键字 72」,与并列的「内置 39」发生重复计数;本版按
契约_1.5的①语法集.分组(43 组内)+空=44 纯关键字、全表 72 保留词逐项核定后改正。同时 references 头部契约版本追平至ZHC-LANG-1.5(完整包原 1.4、本目录原 1.0),两渠道 references 恢复同源。1.0.5(2026-11-11) 文档版序列并入统一版本序列:本版与完整包同号为
1.0.5,此后文档版不再单独编号(1.0.4 未单独发布文档版,其契约追平内容已含在 1.0.2 / 1.0.3)。配套编辑器扩展 0.2.6;语言服务serverInfo.version已与扩展版本对齐并纳入门禁L3-LSP-1.2强制核验。本目录不含内核,故本次合流不动任何包体指纹,语义零变更。1.0.3(2026-11-11,已被 1.0.5 取代) 配套编辑器扩展声明同步 0.2.6;补记语言服务
serverInfo.version已与扩展版本对齐(此前固化 0.2.2)。文档版序列独立于完整包,语义零变更。1.0.2(2026-11-11) 契约追平至
ZHC-LANG-1.5:references 换为契约_1.5_全量参考.md与错误码表_E_1.5.md;配套编辑器扩展声明同步 0.2.5;内核篇幅口径更新(152KB);编译器表述补第二目标 wasm32-wasip1。1.0.1(2026-11-10) 资源清单已去除本包实际未提供的条目,消除悬空引用;语言内核、桥与横式组合标志仅完整包内提供。
本包为完整可运行包,含语言内核
scripts/zhc.py(190000 B)、桥scripts/桥/zhc_bridge.py、可运行示例scripts/示例/*.zc。 语言服务scripts/zhc_lsp.py、四套编辑器语法与完整智能体接入文档由同行包laomeng-zhc-agent提供。 同一技能另在 SkillHub(skillhub.cn)同步发布。 本包保留:SKILL.md、README.md、LICENSE.txt、references/ 三份文档、scripts/ 内核与示例、assets/ 标志。
老孟中文编程(ZHC)
ZHC 是一门全中文语法的编程语言:关键字、内置函数、类型名、错误提示全部是中文,源码扩展名 .zc,编译器双目标产出 x86-64 原生程序 / wasm32-wasip1 静态 .wasm。操作符(+ - * / % == < > 且 或 非)、函数调用括号与字符串引号沿用通用符号,其余全部中文。
何时使用
- 用户要求"用中文编程""写个中文代码""老孟中文编程""ZHC"。
- 需要编译/运行
.zc源码,或解释一段中文源码的语义。 - 需要中文报错定位(E 码)与修复建议。
- 需要把程序内表格数据导出成 Excel / Word / HTML / CSV。
- 需要核对关键字、内置函数、类型名与契约版本。
不适用:需要 Python 生态第三方库的重度任务,直接用 Python。
快速上手
定义 合计 为 整数 0
循环 序 从 1 到 100 步 1
设 合计 为 合计 + 序
结束
输出 "1 到 100 之和是 ", 合计
编译执行:
python -X utf8 scripts/zhc.py 示例.zc --run
只做词法语法检查(JSON 诊断,供编辑器使用):
python -X utf8 scripts/zhc.py 示例.zc --诊断
打印类型与内置函数手册:
python -X utf8 scripts/zhc.py --api
语言速览(照此写,勿自创)
| 概念 | 写法 | 要点 |
|---|---|---|
| 变量定义 | 定义 合计 为 整数 0 | 类型词只能写在 为 之后(唯一形态);写成 定义 整数 a 为 48 会报 E012(变量名不得与类型词同名) |
| 赋值 | 设 合计 为 合计 + 序 | 已有变量用 设,禁止重复 定义 |
| 分支 | 如果 条件 则 … 结束 | 分支链:否则如果 条件 则 → 否则 |
| 前测循环 | 当 条件 则 … 结束 | 语言无 break / continue,靠条件或标志位退出 |
| 计数循环 | 循环 序 从 1 到 100 步 1 … 结束 | 步 可为负 |
| 函数 | 函数 平方(甲:整数) 返回 整数 … 结束 | 参数必须写 名:类型,多个用逗号分隔;无返回值省略 返回 类型 |
| 输出 | 输出 值, 值, 值 | 逗号分隔多值,自动拼接 |
| 注释 | # 说明 | 行注释 |
| 文本 | "老孟中文编程" | 双引号,支持 \n 转义 |
| 逻辑 | 真 / 假 | 与 且 或 非 组合 |
| 空值 | 空 | 指针/引用空值 |
类型名(11 个)
整数(int64) 浮点(double) 文本(str) 逻辑(bool) 字节(u8) 无符号(u64) 指针(ptr) 表(table) 记录(record) 列表(list) 任意值(any)
关键字(44 个)
分支:如果 则 否则如果 否则 结束 循环:当 循环 从 到 步 定义:定义 设 为 函数 返回 接受 外部 输入输出:输出 输入 逻辑:且 或 非 真 假 类型:整数 浮点 文本 逻辑 空 字节 无符号 指针 表 记录 列表 任意值 位运算:位与 位或 位异或 取反 左移 右移 容器:遍历 记作
内置函数(39 个,按用途分组)
| 分组 | 函数 |
|---|---|
| 系统 | 系统节拍 进程编号 睡眠 弹窗 取环境 |
| 内存 | 申请内存 释放内存 读字节 写字节 读字 写字 读双字 写双字 读四字 地址转文本 |
| 文件 | 读文件 写文件 追加文件 写行 文件大小 文件存在 |
| 参数 | 参数个数 取参数 |
| 文本 | 连接 转文本 文本长度 文本相同 释放文本 |
| 容器 | 新建 长度 取元素 置元素 追加 造列 |
| 数据 | 转JSON 解JSON |
| 桥 | 桥可用 桥调用 |
签名与说明以 zhc.py --api 输出为准,本表仅索引。
表与记录
定义 t 为 表
造列(t, "名称", 文本)
造列(t, "数量", 整数)
定义 r 为 记录
置元素(r, "名称", "螺丝")
置元素(r, "数量", 1200)
追加(t, r)
输出 转JSON(t)
Office 导出(OFFICE-WEB 2.4)
桥按「对象 + 动作 + JSON 参数」三段调用,参数路径字段名为 路径,格式由桥按动作决定:
定义 t 为 表
造列(t, "名称", 文本)
造列(t, "数量", 整数)
定义 r 为 记录
置元素(r, "名称", "螺丝")
置元素(r, "数量", 1200)
追加(t, r)
定义 p 为 记录
置元素(p, "表", t)
置元素(p, "路径", "库存.xlsx")
定义 报 为 文本 桥调用("表", "导出xlsx", 转JSON(p))
输出 报
动作清单:导出csv 导出xlsx 导出docx 导出html。导出 HTML 页面用 桥调用("页面", "导出html", …),可附 标题 字段。
运行前置:桥脚本必须位于 scripts/桥/zhc_bridge.py(本包内固定位置;编译器按「与 zhc.py 同级的 桥 目录」查找,路径编译期烧入产物)。若位移了桥目录,用环境变量覆盖:
set ZHC_BRIDGE_HOME=<桥所在目录>
set ZHC_PY=<python.exe 绝对路径>
桥可用() 返回 真 表示桥已起好;返回 假 时导出会自动降级为 CSV(报文中 降级: true 并给 B001),此时应修好桥再重跑以拿到 xlsx/docx。写盘失败返回 -1 并报 B005;桥应答超 30 秒记 B006。
错误处理
错误一律形如 [Exxx] 中文说明。码位 39 个(唯一码位,E315 空闲),区间:
| 区间 | 类别 |
|---|---|
| E001–E014 | 词法与字符(非法字符、未闭合引号、数字格式) |
| E201–E214 | 语法结构(缺 则/结束、语句不完整) |
| E301–E313 | 名称与类型(未定义引用、类型不匹配、重复定义) |
| E401 / E901 | 运行期与内部(除零、越界、编译内部异常) |
| B0xx | 桥协议与导出 |
逐条成因与修法见 references/错误码表_E_1.5.md。对外答复全程中文,不得把错误码翻成英文。
智能体工作流程
- 判类型:新建 / 修错 / 解释 / 导出,四选一。
- 查契约:要精确语义读
references/契约_1.8_全量参考.md;不确定的关键字一律先查表,禁止臆造。 - 小步验证:改一次跑一次
--诊断,再--run;只看首条错误,修完复跑。 - 导出前自检:
桥可用()→ 导出 → 读回报文确认。 - 交付口径:给完整可复制的
.zc代码块;报错引用原文中文;不输出伪代码。
禁止事项
- 不得使用英文关键字(
if/while/def)或 Python 式缩进块。 - 不得把
当写成while语义之外的变体,不得自创结束如果之类不存在的收尾词——统一用结束。 - 不得声称支持契约外的语法或库。
- 不得写错版本号:本技能对应语言面
ZHC-LANG-1.8,桥面OFFICE-WEB 2.4。
资源清单
| 路径 | 内容 |
|---|---|
scripts/zhc.py | 语言内核(编译 + 运行,单文件,无第三方依赖) |
scripts/桥/zhc_bridge.py | Office 导出桥(常驻子进程,需 openpyxl / python-docx) |
references/契约_1.8_全量参考.md | 语言契约全文(语法集、内置表、错误结构) |
references/错误码表_E_1.5.md | 错误码逐条成因与修法 |
references/快速参考.md | 一页速查 |
assets/logo-language-256.png | 字标(语言版) |
已验证口径
以下三条命令在本技能打包目录下实测通过(2026-11-09):
python -X utf8 scripts/zhc.py 示例.zc --诊断 # {"ok": true}
python -X utf8 scripts/zhc.py 示例.zc --run # 1 到 100 之和是 5050
python -X utf8 scripts/zhc.py 导出.zc --run # 桥可用 真 → 库存.xlsx 1654 字节
Related skills
- Downloads
- Security audit
- Review
- Last updated
- 2d ago
- Current version
- v1.0.15
- License
- MIT-0
