laomeng-zhc-agent
老孟中文编程(ZHC)智能体身份技能。当需要把 ZHC 语言服务接入编辑器或智能体运行时,或需要以智能体身份驱动 ZHC 的编译、运行、诊断、Office 导出闭环,或需要按分级门禁与冻结台账维护 ZHC 生态版本时使用本技能。适用于 LSP 接入、桥后端排障、产物降级判断、生态演进合规校验场景。
老孟中文编程 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 由红转绿。LSP 协议、桥报文与元数据计数无改动;frozen同步改为 2026-11-16。本版统一版本序列:四包 × 两渠道同号 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,此后不再单独编号。配套编辑器扩展 0.2.6;语言服务serverInfo.version与扩展版本对齐(0.2.7),并由门禁L3-LSP-1.2强制核验。本目录不含内核与脚本,合流不动任何包体指纹,语义零变更。1.0.3(2026-11-11,已被 1.0.5 取代) 配套编辑器扩展声明同步 0.2.6;契约维持 ZHC-AGENT-1.0 / ZHC-LSP-1.0 / ZHC-LANG-1.5 / OFFICE-WEB 2.4。
本包为完整可运行包,含语言内核
scripts/zhc.py(190000 B)、语言服务scripts/zhc_lsp.py、桥scripts/桥/zhc_bridge.py、无操作系统垫片scripts/run_noos.js与可运行示例scripts/示例/*.zc。 同一技能另在 SkillHub(skillhub.cn)同步发布。 本包保留:SKILL.md、README.md、LICENSE.txt、references/ 六份文档、scripts/ 内核与服务、assets/ 标志。
老孟中文编程 · 智能体身份(ZHC Agent)
本技能是 ZHC 生态的智能体侧:它不教你写中文代码(那是语言身份 laomeng-zhc 的职责),
它教你如何把 ZHC 装进一个自动化运行环境并稳定跑通——语言服务接入、编译调度、
桥后端排障、产物降级识别,以及生态演进时不得越过的合规线。
身份边界
语言身份 laomeng-zhc | 智能体身份(本技能) | |
|---|---|---|
| 关心 | 语法、类型、内置函数、错误码 | 协议面、进程、路径、产物、门禁 |
| 产出 | 能通过诊断的中文源码 | 可复现的运行环境与可审计的版本 |
| 判据 | --诊断 返回 {"ok": true} | LSP 诊断零漂移、桥报文合规、门禁全 PASS |
两套身份共用同一份内核,差异只在标志(智能体标志带朱点)与关注面。
何时使用
- 把 ZHC 接入 VS Code 之外的编辑器(Neovim、JetBrains、Sublime、TextMate);
- 起 LSP 服务、排查"无诊断/补全只有关键字/中文变问号";
- 让 ZHC 程序导出 xlsx/docx/html,并判断是否发生降级;
- 升级 ZHC 版本、改语言面之前做合规校验;
- 把 ZHC 塞进 CI 或批量流水线,需要可判定的通过/失败口径。
环境就绪三步
python -X utf8 scripts/zhc.py --api # 反射语言面
python -X utf8 scripts/zhc.py scripts/示例/基础.zc --诊断 # 期望 {"ok": true}
python -X utf8 scripts/zhc.py scripts/示例/基础.zc --run # 期望打印结果
三步全过才算就绪。任一步失败先读中文报错原文,不要凭经验猜。
关键路径约束
- 内核与语言服务必须同级:
zhc.py与zhc_lsp.py放同一目录,否则 LSP 启动即退出。 可用环境变量ZHC_HOME指定内核目录。 - 桥必须在
桥/子目录:默认查找「与zhc.py同级的桥目录」,且路径在编译期烧入产物; 换机器需重编译,或用ZHC_BRIDGE_HOME覆盖。 - Python 解释器必须 UTF-8 模式:统一加
-X utf8;否则中文源码与产物可能乱码。 - 产物落在源文件目录,不是
cwd。
三条高频故障与判据
| 现象 | 判据 | 处置 |
|---|---|---|
E014 参数名非法 | 函数参数缺 名:类型 | 补类型,如 函数 平方(甲:整数) 返回 整数 |
E202 无法识别的语句起始 '结束' | 误用 结束循环 | 语言无 break/continue,改条件或标志位退出 |
| 导出拿到 CSV 而非 xlsx | 报文含 "降级": true | 桥不可用;向用户回报真实格式,不得谎称 Excel |
引用文件索引
| 文件 | 何时读 |
|---|---|
references/快速参考.md | 需要关键字/类型/内置函数/错误码速查 |
references/错误码表_E_1.5.md | 拿到具体 E 码,要释义与成因 |
references/契约_1.8_全量参考.md | 要改语言面,先看契约约束 |
references/LSP协议.md | 接入语言服务、排查诊断不通 |
references/桥报文协议.md | 导出失败、要判降级、要手写报文自测 |
references/智能体工作流.md | 首次搭建流水线、需要完整动作序列 |
演进红线(改代码前必读)
- 每版只增不改:已冻结关键字、内置签名、样本语义不得动。
- 正常不回退:版本只进不退;仅故障触发回退,且必须留账。
- 契约先行:先升契约版本并跑祖先级回归至零漂移,再动内核。
- 冻结必留痕:快照 + SHA256 + 案卷,登记冻结清单,禁止口头声明。
- 架构自检全绿才冻结:C01~C09 全 PASS;有 WARN/FAIL 不得立新条目。
资源清单
SKILL.md
README.md
LICENSE.txt
assets/
logo-agent-256.png 图形标志 256px(带朱点)
lockup-agent.png 横式组合标志
references/
快速参考.md 契约_1.8_全量参考.md 错误码表_E_1.5.md
LSP协议.md 桥报文协议.md 智能体工作流.md
scripts/
zhc.py 语言内核(190000 B,单文件无依赖)
zhc_lsp.py 语言服务(LSP over stdio)
桥/zhc_bridge.py Office / 网页产物桥
run_noos.js 无操作系统环境运行垫片
示例/ 基础.zc / 语法骨架.zc / 导出表格.zc
已验证口径(实测,可复现)
scripts/示例/基础.zc --run输出1 到 100 之和是 5050。scripts/示例/导出表格.zc --run:桥可用时产出库存.xlsx(1654 字节);桥不可用时产出 CSV 并回降级:true。- 三个示例
--诊断均返回{"ok": true}。 - 语言面计数:关键字 44、保留词 72、类型名 11、内置函数 39、错误码 39。
Related skills
- Downloads
- Security audit
- Review
- Last updated
- 2d ago
- Current version
- v1.0.15
- License
- MIT-0
