codecin 5.7.4__tar.gz → 5.8.2__tar.gz

{codecin-5.7.4 → codecin-5.8.2}/CHANGELOG.md

@@ -5,6 +5,261 @@
 
 ---
 
+## [5.8.2] - 2026-10-04
+
+一次以「真实压测程序暴露的错误信息与栈安全」为主线的修复发布。核心结论：
+5.5.3 的浮点下标修复在三条执行路径均有效（`a[(n * p) / 100]` 一类变量参与
+的浮点表达式同样覆盖）；用户在 Termux 上报告的 `address ffffffffffffc6f8
+out of bounds` 实为**局部大数组把栈推成负地址**——`int lat[10000]` 需要
+80 KB 局部空间，超过默认 64 KB 内存后 SP 绕回，越界检查检查的是绕回后的
+地址。为此新增带防护的帧分配系统调用（SYS 137），并全面改进运行时/编译期
+错误信息、补齐 CLI 直传参数与高精度计时。
+
+### 修复 (Fixed)
+
+#### 局部大数组撑爆栈（静默生成负地址）
+- **函数序言的帧分配改为带防护的系统调用**。此前 prologue 用裸 `ADDI sp, sp,
+  -frame_bytes` 递减栈指针，局部数组总大小超过可用内存时 SP 绕回为巨大无符号
+  值（如 0xFFFFFFFFFFFFC6F8），后续所有访问都指向"负地址"，报错只看到一句
+  out of bounds，看不出真因。现在两侧编译器（`cin.py` / `codegen.go`）改为
+  `SYS ALLOCFRAME`：VM 侧用**有符号比较**在分配前检查栈余量（含 4 KB 警戒
+  线），不足时直接报
+  `Stack overflow: frame needs N bytes, stack headroom only M bytes (...)
+  Try --mem-size (default 65536) or smaller local arrays`，
+  不再让绕回地址流入访存路径。Python 解释器、JIT、Go 原生三条路径语义一致。
+- **负地址越界提示兜底**：地址 >= 2^63 的越界报错（Python `memory.py` 与
+  Go `checkAddr`）追加
+  `(negative address: stack overflow or bad pointer?)`，把"看起来像随机大数"
+  的地址翻译成可排查的方向。
+
+#### 错误信息补全（问题 2/4/5）
+- **Heap exhausted 附用量与建议**：三处堆耗尽点（malloc / 字符串拼接 / 字符串
+  操作）在 Python 与 Go 两侧逐字一致地报
+  `Heap exhausted: need N bytes, free M bytes (heap 0x...0x...).
+  Try --mem-size (default 65536) or reduce allocations`。
+- **非常量数组长度的编译期报错附 hint**：
+  `array lengths must be compile-time constants; declare it as
+  \`const int NAME = ...\`; variable-length arrays are not supported —
+  use a fixed-size array plus a count variable`。
+- **`float(x)` / `int(x)` 报错附替代写法**：提示使用 `to_float(x)` / `to_int(x)`
+  或依赖混合表达式的隐式提升。
+
+#### 兼容层与文档
+- `gostd.cin` 头注释明确列出当前覆盖的包（strings / strconv / math / slices /
+  os.Args）与**未覆盖项**（time、os 文件读写、net/http、sync），并指向对应
+  内建（`time_ms/time_us/time_ns`、`file_*` 函数族），避免"Go 标准库兼容层"
+  的命名让人误以为常用包会逐步全覆盖。
+
+### 新增 (Added)
+
+#### CLI 程序名后直传参数
+- `codecin 压测.cin https://example.com 24` 现在可用：程序文件之后的裸参数
+  原样传给 CIN 程序（`arg_count()` / `arg(i)`），已知 CLI 选项放在程序之前或
+  之后均可识别；形如选项的直传参数给出 stderr 提示并用 `--` 显式分隔。
+  `--` 分隔符行为不变且优先级最高，`--help` 新增 Program arguments 说明段。
+
+#### 高精度计时 `time_us()` / `time_ns()`（SYS 138/139）
+- 微秒 / 纳秒级单调计时，补齐 `time_ms()` 只能测毫秒的短板（压测与微基准
+  基础设施）。两侧编译器同步登记，解释器 / JIT / 原生三条路径均可用；
+  与 ALLOCFRAME 同属核心 VM 机制，不触发沙箱门禁与原生路径限定。
+
+#### 显式类型转换 `to_int()` / `to_float()`
+- 数值类型（int/float/bool）间的显式转换，语义与隐式转换一致（float→int 向零
+  截断）。非数值参数在编译期报错并说明。
+
+---
+
+## [5.8.0] - 2026-10-04
+
+一次「图形、媒体与跨平台兼容」发布：新增 **GUI 窗口**（Windows Win32 /
+Linux X11）、**本地音频扩展**（真实音量 / 播放进度 / 合成蜂鸣）、**键盘输入
+多平台优化**（Unicode 码点、F11/F12、修饰键组合），并补齐 **命令行参数与
+行输入**（SYS 129..131）、**终端输出缓存的跨平台冲刷**（Windows VT/UTF-8
+初始化）与 **C/C++/Go 三语言标准库兼容层**（36 → 39 个）。随后在同一版本内
+继续增强：**音频控制全家桶**（查询 / 暂停恢复 / 音量读取，SYS 132..136）、
+**三兼容层 API 扩容**（40+ 新函数）、**工具链缺失检测与平台化安装提示**
+（environment）与 **`--libs` 内置库清单**（标注执行路径要求）。核心实现全部
+在 Go 原生引擎（纯标准库，零第三方依赖），三条执行路径语义与 5.7.x 保持一致。
+
+### 新增 (Added)
+
+#### GUI 窗口（SYS 119..125、128，全部 Go 原生实现）
+
+- **`gui_new(w, h, title)` / `gui_update()` / `gui_close()` / `gui_closed()` /
+  `gui_active()` / `mouse_x()` / `mouse_y()` / `mouse_button()`**：
+  - `gui_new` 成功返回 0 并把画布内建（`set_color` / `fill_rect` / `fill_circle` /
+    `draw_line` / `draw_text`）直接绑定为**窗口后备缓冲直画**，`gui_update`
+    处理事件并呈现一帧（主循环每帧调用）；`gui_close` 销毁窗口（画布保留，
+    仍可 `save_png`）；点 X / Alt+F4 / WM 删除协议由 `gui_closed` 报告。
+  - 平台后端：Windows 用 Win32（专用窗口线程 + 消息泵，`StretchDIBits`
+    呈现，`AdjustWindowRect` 精确客户区）；Linux 用**纯 Go X11 客户端**
+    （Unix socket / TCP 连接、MIT-MAGIC-COOKIE-1 认证、`PutImage` 分块呈现、
+    WM_DELETE_WINDOW 协议）；其他平台与无显示服务环境一律优雅失败
+    （`gui_new` 返回 -1，不报错不崩溃）。
+  - 鼠标：客户区坐标 + 键位掩码（bit0 左 / bit1 右 / bit2 中）；键盘事件注入
+    与终端共用的同一键码队列（`get_key` 可直接读）。
+  - 并发安全：快照复制防撕裂（呈现线程读 / VM 线程写）。
+- **`codecin/lib/gui.cin` 重构**：窗口封装 `g_new` / `g_update` / `g_close` /
+  `g_closed` / `g_active` / `g_clear` / `g_mouse_*`（含键位判定），并**保留**
+  5.7.x 的离屏绘图助手（`g_rgb` / `g_bar_chart` / `g_line_chart` / `g_grid` /
+  `g_rect_outline` / `g_save` / `g_show`）。
+
+#### 本地音频扩展（SYS 126、127）
+
+- **`audio_pos()`**：当前播放已进行毫秒；无播放 / 已播完 / 时长未知返回 -1。
+- **`beep(freq, ms)`**：合成 16-bit 单声道 22050Hz 正弦蜂鸣（10% / 5ms 淡入
+  淡出防爆音）；频率 20..20000 Hz、单次上限 10 秒，参数校验在三平台一致地
+  于触碰设备之前完成。
+- Windows 后端从 PlaySoundW 升级为 **waveOut 流式**：`audio_volume` 经
+  `waveOutSetVolume` 实时生效、`audio_stop` 即时中止（`waveOutReset`）；
+  Unix 后端向 `paplay` / `ffplay` / `afplay` 透传音量参数。
+
+#### 音频控制增强（SYS 132..136）
+
+- **`audio_duration()`**：当前播放总时长毫秒；无播放 / 自然播完 / 时长未知返回 -1
+  （播放与暂停期间返回同一总时长）。
+- **`audio_playing()`**：1 = 正在发声（已开始、未暂停、未播完），否则 0。
+- **`audio_pause()`**：暂停当前播放（Windows `waveOutPause`；Unix 向播放器
+  进程投递 SIGSTOP），成功 0；无播放 / 已暂停 / 平台失败为 -1。
+- **`audio_resume()`**：恢复暂停的播放，时间基线整体后移暂停时长——
+  `audio_pos` 无缝续走、自然结束时刻保持正确；成功 0 / 无暂停可恢复 -1。
+- **`audio_level()`**：读取当前音量 0..100（`audio_volume` 的读端）。
+- **`audio_pos` 暂停冻结**：暂停期间进度停在暂停时刻，不随真实时间前进；
+  `audio_stop` / 重新播放即解除暂停态。
+- 五个内建在两侧编译器同步登记，ISA 真源（`isa.py`）→ Go 生成物一致。
+
+#### 键盘输入多平台优化（键码表扩展）
+
+- 新增键码：**F11 / F12**（1031 / 1032）、**Ctrl+方向**（1101..1104）、
+  **Shift+方向**（1105..1108）、**Shift+Tab**（1109）。
+- **XTerm 修饰参数解析**：`CSI 1;5C`（Ctrl+Right）等修饰变体三端一致。
+- **Unicode 码点解码**（Linux / macOS / Termux）：终端 UTF-8 多字节序列解码为
+  码点（>255，如 "中" → 0x4E2D），非法序列回退按字节处理；Windows 端
+  UTF-16 代理对组合为同一码点。
+- **Windows 输入重写**：msvcrt `_getch` → `ReadConsoleInputW` 事件流
+  （UTF-16 字符 + VK 虚拟键，键抬起过滤、重复计数、扩展键），启用时关闭
+  QuickEdit 防误选卡死。
+- `codecin/lib/key.cin`：`K_F11` / `K_F12` / `K_CTRL_*` / `K_SHIFT_*` /
+  `K_SHIFT_TAB` 常量与 `k_is_function` / `k_is_modified_arrow` 判定；
+  `k_is_special` 范围同步扩展。
+
+#### 命令行参数与行输入（SYS 129..131，跨平台一致语义）
+
+- **`arg_count()` / `arg(i)`**：读取传给 CIN 程序的命令行参数（不含程序文件名；
+  越界 / 负下标返回空串）。传参约定三端统一：
+  - CLI：`codecin prog.cin -- a b c`（`--` 之后的参数全部交给 CIN 程序）；
+  - AOT 产物：直接取进程 `os.Args[1:]`；
+  - c-shared 库：新导出 `codecin_set_args`，Python 桥接层每次运行前注入
+    （空列表即清空，同进程多次运行不残留）。
+- **`input_str()`**：读入一行 UTF-8 文本（不含行尾；EOF 为空串）。优先消费
+  预读输入缓冲（与解释器 `input()` 的管道语义一致），耗尽后阻塞读标准输入；
+  Windows 控制台用 `ReadConsoleW`（UTF-16 → UTF-8，中文输入不乱码），其余平台
+  用 `bufio` 按行读；行尾 `\n` / `\r\n` 三平台统一剥离，与键盘 raw 模式
+  （监听激活时临时恢复行模式）互不干扰。
+- 新内建在两侧编译器同步登记（`arg_count` / `arg` / `input_str`）。
+
+#### 终端输出缓存与 Windows 控制台兼容
+
+- **阻塞读前冲刷输出缓冲**：原生引擎把输出缓冲到程序结束一次性回传；
+  当 `input_str()` / 数字输入将要阻塞读真实终端时先冲刷已缓冲输出，
+  `"你的名字: "` 这类交互提示立即可见。冲刷**仅在 stdout 为终端时生效**——
+  管道 / 重定向 / 测试捕获下输出字节序列与旧版本完全一致。
+- **Windows 控制台一次性初始化**（进程级、幂等、失败安全）：
+  `ENABLE_VIRTUAL_TERMINAL_PROCESSING`（ANSI/VT 转义序列在传统 conhost 上
+  与 Linux/macOS 行为一致）+ `SetConsoleOutputCP(65001)`（输出代码页切
+  UTF-8，中文 Windows 默认 GBK 下中文/Emoji 不再乱码）。
+- AOT 产物在打印输出前执行同一初始化；非 Windows 平台为空操作
+  （终端原生支持 VT 与 UTF-8）。
+
+#### C / C++ / Go 标准库兼容层（36 → 39 个，全部纯 CIN）
+
+- **`codecin/lib/cstd.cin`（`libc_*`）**：`<ctype.h>`（isdigit / toupper …，
+  字符码可用字符字面量 `'A'` 直接传入）、`<string.h>`（strlen / strcmp /
+  strstr / strchr / strrev / memcpy …）、`<stdlib.h>`（abs / atoi / qsort_asc）、
+  `<math.h>`（fabs / sqrt / pow / floor / ceil / fmod 商向零截断）与
+  `<stdio.h>`（puts / print）。
+- **`codecin/lib/cppstd.cin`（`stl_*`）**：`std::string`（find / rfind /
+  substr / append / to_string，npos 以 -1 表示）、`vector<int>` / `stack<int>` /
+  `queue<int>`（**数组 + 长度游标**表达，push/pop 返回新长度）、
+  `<utility>`（max / min / abs / swap / sort 固定升序）。
+- **`codecin/lib/gostd.cin`（`go_*`）**：`strings`（Contains / Index /
+  HasPrefix / Repeat / Count / ReplaceAll / EqualFold …）、`strconv`（Itoa /
+  Atoi / FormatFloat）、`math`、`slices`（Index / Contains / Max / Reverse …）
+  与 `os.Args`（经 `go_os_args_len` / `go_os_args_get`，依赖原生路径）。
+- 类型映射约定：C `char*` → `string`、C `char` → 字符码 `int`、C 数组参数 →
+  CIN 数组引用 + 显式长度；与 C/C++ 指针返回值不可表达的 API（如返回
+  `char*` 的 strchr）以**下标**语义对齐，头注释均注明差异。
+
+#### 兼容层 API 扩容（三库 40+ 新函数，纯 CIN、三路径一致）
+
+- **cstd**：`<ctype.h>` 补 iscntrl / isgraph / isblank / ispunct / toascii；
+  `<string.h>` 补 memmove / strspn / strcspn / strpbrk / strlwr / strupr；
+  `<stdlib.h>` 补 labs / rand / srand；`<math.h>` 补 sin / cos / tan /
+  round（C 语义半值远离零）/ trunc；`<stdio.h>` 补 putchar（配套内部
+  字符码 → 字符串转换）。
+- **cppstd**：`std::string` 补 starts_with / ends_with（C++20）/
+  find_first_of / find_last_of / at / front / back / insert / erase /
+  replace；`vector<int>` 补 find / count / insert / erase；`<algorithm>`
+  补 sort 降序版与 clamp。
+- **gostd**：`strings` 补 LastIndex / IndexAny / TrimLeft / TrimRight /
+  TrimPrefix / TrimSuffix；`strconv` 补 FormatInt（base 2..36）/
+  ParseInt（任意进制解析）；`math` 补 Round / Trunc；`slices` 补
+  LastIndex / Equal / Clone / Sort。
+
+#### 工具链缺失检测与平台化安装提示（environment）
+
+- **`codecin/environment.py`**：`find_tool` / `tool_available`（只读
+  `shutil.which` 探测，绝不自动安装）、`install_hint`（按当前平台给出可复制
+  执行的安装命令：Windows winget/MSYS2、macOS brew/xcode-select、Linux
+  apt/dnf/pacman、Termux pkg）、`missing_tool_message`（缺工具 + 用途 +
+  怎么装合一）、`native_runtime_hint`（原生库缺失时的三条出路指引）。
+- 接入点（所有缺失入口提示一致）：
+  - AOT 构建缺 Go：报错附 `install_hint('go')`（原先只有干巴巴的
+    "go 命令未找到"）；
+  - 解释路径（含 `--no-native`）调用宿主能力内建：报错附原生库安装指引；
+  - pip 安装（`setup.py`）缺 Go：打印安装命令并说明重装后获得原生加速。
+
+#### `--libs`：内置标准库清单与执行路径标注
+
+- 新 CLI 选项 **`--libs`**：列出 `codecin/lib/` 全部官方库并按**执行路径
+  要求**标注三类——纯 CIN（三路径一致）/ 兼容层（C/C++/Go 三语言标准库
+  兼容层）/ 需原生运行时（调用宿主能力内建，`--no-native` 与沙箱下不可用）。
+- 分类由**源码扫描**得出（是否引用 `HOST_BUILTINS` 内建名），与库头注释
+  保持单一事实来源；`gostd.cin` 的 `go_os_args_*` 原生依赖自动标注。
+
+#### 其他
+
+- 新内建在两侧编译器同步登记：Python `HOST_BUILTINS` 与 Go
+  `compiler.hostBuiltins`（并补上 5.6.0 遗漏的 `key_hit` / `get_key` /
+  `key_flush`）。
+- 新示例：`examples/gui_demo.cin`（无显示服务自动降级为提示后退出）、
+  `examples/local_audio.cin`、`examples/args_demo.cin`（`--` 传参与
+  `input_str`）。
+- 新测试：`tests/test_lib_compat.py`（三兼容层函数语义、参数注入管道、
+  预读缓冲行输入、无原生库可编译，解释 / 原生双路径参数化）。
+- 本轮新增：Go 侧 `engine/audio_test.go`（audio_duration / playing /
+  pause / resume 状态机、暂停冻结、自然播完回落）、`tests/test_environment.py`
+  （安装提示契约）、`tests/test_cli.py::test_list_libs_reports_categories`
+  （--libs 分类标注）；`examples/local_audio.cin` 增补音量读取与暂停 /
+  恢复演示。
+
+### 变更 (Changed)
+
+- **`lib/gui.cin` 签名变更**（窗口化重构）：`g_new(w, h)` → `g_new(w, h, title)`
+  （旧的无窗口画布用法请直接使用 `canvas(w, h)`）；`g_clear(w, h, rgb)` →
+  `g_clear(rgb)`（沿用最近一次窗口尺寸，从未开窗时返回 -1）。
+  图表助手内部已同步适配，`g_bar_chart` / `g_line_chart` / `g_save` /
+  `g_show` 调用方式不变。
+
+### 修复 (Fixed)
+
+- 音频自然播完后 `audio_pos` 不再恒返回总时长（正确恢复 -1）。
+- GUI：Windows 窗口线程改为常驻，`gui_close` 之后可以再次 `gui_new`；
+  窗口销毁（无论来自 `gui_close` 还是用户点 X）后清理失效句柄。
+- `guiSnapshot` 增加窗口打开校验（关闭后不再产出快照）。
+
+---
+
 ## [5.7.4] - 2026-09-28
 
 一次「静默错误清零 + 标准库扩容」的发布：修掉一族会**静默破坏内存/静默给错结果**的
@@ -316,7 +571,7 @@ struct 缺陷与两处**同一程序两条路径结论不同**的分歧，并把
 
 ### 修复 (Fixed)
 
-- `python cpu.py --help` 的首行版本号长期停留在 `Code CIN v5.3`，现直接取
+- `codecin --help` 的首行版本号长期停留在 `Code CIN v5.3`，现直接取
   `codecin.__version__`（此前是全仓唯一残留的版本串）。
 - `--build-exe` 在程序文件不存在时抛裸 `FileNotFoundError` traceback，现在与普通路径
   一样给出 `Build Error` 面板。
@@ -367,7 +622,7 @@ struct 缺陷与两处**同一程序两条路径结论不同**的分歧，并把
 ### 新增 (Added)
 
 - **AOT 静态编译: 编译成独立可执行文件 (Windows / Linux / macOS)**：
-  `python cpu.py program.cin --build-exe app` 或 `codecin build program.cin -o app`，
+  `codecin program.cin --build-exe app` 或 `codecin build program.cin -o app`，
   支持 `--target OS/ARCH` 交叉编译（windows/amd64|arm64、linux/amd64|arm64、darwin/amd64|arm64）。
   产物内嵌 UCBC 字节码与初始内存镜像，由内置 Go VM 执行，**不依赖 Python、Go 工具链、
   libc 或任何动态库**（`CGO_ENABLED=0`，Linux 产物无 `PT_INTERP`）；入口 shell 模板由

{codecin-5.7.4/codecin.egg-info → codecin-5.8.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codecin
-Version: 5.7.4
+Version: 5.8.2
 Summary: Code CIN - 高级语言与运行时 (CIN/PL/ASM 工具链 + Go 原生 VM + ARM64/RISC-V/FP/Vector 指令集)
 Author: ByUsi Studio, 北啊呢
 License-Expression: MIT
@@ -443,9 +443,9 @@ codecin --version
 
 3. 运行:
    ```
-   python cpu.py basic.cin                          # 唯一 CLI 入口 (自动用 Go 原生库)
+   codecin basic.cin                          # 唯一 CLI 入口 (自动用 Go 原生库)
    codecin basic.cin                                # 安装后等价的 console script
-   python cpu.py --help
+   codecin --help
    ```
 
 > **Python 只是 CLI 外壳**: 语言实现 (`codecin/native/` 下的 Go 编译器与字节码 VM) 全部在 Go 侧,
@@ -485,11 +485,11 @@ ruff check codecin cpu.py script tests
 
 ```bash
 # 本机平台
-python cpu.py program.cin --build-exe program          # Windows 自动补 .exe
+codecin program.cin --build-exe program          # Windows 自动补 .exe
 
 # 交叉编译 (只需要安装 Go 工具链)
-python cpu.py program.cin --build-exe app-linux --build-target linux/amd64
-python cpu.py program.cin --build-exe app-mac   --build-target darwin/arm64
+codecin program.cin --build-exe app-linux --build-target linux/amd64
+codecin program.cin --build-exe app-mac   --build-target darwin/arm64
 ```
 
 | 目标 | 说明 |
@@ -506,10 +506,10 @@ python cpu.py program.cin --build-exe app-mac   --build-target darwin/arm64
 ### 命令行选项
 
 **基础执行**
-- `python cpu.py program.cin` - 运行CIN程序
-- `python cpu.py program.pl` - 运行PL程序
-- `python cpu.py program.asm` - 运行ASM程序
-- `python cpu.py program.bin` - 运行字节码
+- `codecin program.cin` - 运行CIN程序
+- `codecin program.pl` - 运行PL程序
+- `codecin program.asm` - 运行ASM程序
+- `codecin program.bin` - 运行字节码
 
 **执行路径**
 - `--no-native` - 禁用 Go 原生库, 强制纯 Python

{codecin-5.7.4 → codecin-5.8.2}/README.md

@@ -425,9 +425,9 @@ codecin --version
 
 3. 运行:
    ```
-   python cpu.py basic.cin                          # 唯一 CLI 入口 (自动用 Go 原生库)
+   codecin basic.cin                          # 唯一 CLI 入口 (自动用 Go 原生库)
    codecin basic.cin                                # 安装后等价的 console script
-   python cpu.py --help
+   codecin --help
    ```
 
 > **Python 只是 CLI 外壳**: 语言实现 (`codecin/native/` 下的 Go 编译器与字节码 VM) 全部在 Go 侧,
@@ -467,11 +467,11 @@ ruff check codecin cpu.py script tests
 
 ```bash
 # 本机平台
-python cpu.py program.cin --build-exe program          # Windows 自动补 .exe
+codecin program.cin --build-exe program          # Windows 自动补 .exe
 
 # 交叉编译 (只需要安装 Go 工具链)
-python cpu.py program.cin --build-exe app-linux --build-target linux/amd64
-python cpu.py program.cin --build-exe app-mac   --build-target darwin/arm64
+codecin program.cin --build-exe app-linux --build-target linux/amd64
+codecin program.cin --build-exe app-mac   --build-target darwin/arm64
 ```
 
 | 目标 | 说明 |
@@ -488,10 +488,10 @@ python cpu.py program.cin --build-exe app-mac   --build-target darwin/arm64
 ### 命令行选项
 
 **基础执行**
-- `python cpu.py program.cin` - 运行CIN程序
-- `python cpu.py program.pl` - 运行PL程序
-- `python cpu.py program.asm` - 运行ASM程序
-- `python cpu.py program.bin` - 运行字节码
+- `codecin program.cin` - 运行CIN程序
+- `codecin program.pl` - 运行PL程序
+- `codecin program.asm` - 运行ASM程序
+- `codecin program.bin` - 运行字节码
 
 **执行路径**
 - `--no-native` - 禁用 Go 原生库, 强制纯 Python

{codecin-5.7.4 → codecin-5.8.2}/codecin/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "5.7.4"
+__version__ = "5.8.2"
 __author__ = "ByUsi Studio"
 
 from .config import Config

{codecin-5.7.4 → codecin-5.8.2}/codecin/aot.py

@@ -362,8 +362,9 @@ def build(bytecode: bytes,
         try:
             proc, detail = _run_go_build(cmd, mod, env, logger)
         except FileNotFoundError as e:
-            raise AotError('未找到 go 命令; AOT 构建需要 Go 工具链 '
-                           '(https://go.dev/dl/)') from e
+            from .environment import missing_tool_message
+            raise AotError(missing_tool_message(
+                'go', 'AOT 构建独立可执行文件')) from e
         except subprocess.TimeoutExpired as e:
             raise AotError('go build 超时') from e
         if proc.returncode != 0:

{codecin-5.7.4 → codecin-5.8.2}/codecin/cin.py

@@ -210,6 +210,8 @@ HOST_BUILTINS = {
     'chdir': (Syscall.CHDIR, 1, 'int'),
     # 时间与系统信息
     'time_ms': (Syscall.TIMEMS, 0, 'int'),
+    'time_us': (Syscall.TIMEUS, 0, 'int'),
+    'time_ns': (Syscall.TIMENS, 0, 'int'),
     'sleep_ms': (Syscall.SLEEPMS, 1, 'int'),
     'cpu_count': (Syscall.CPUCOUNT, 0, 'int'),
     'arch_name': (Syscall.ARCHNAME, 0, 'string'),
@@ -242,11 +244,30 @@ HOST_BUILTINS = {
     'key_hit': (Syscall.KEYHIT, 0, 'int'),
     'get_key': (Syscall.KEYGET, 0, 'int'),
     'key_flush': (Syscall.KEYFLUSH, 0, 'int'),
+    # GUI 窗口 (Windows Win32 / Linux X11, 其他平台优雅失败)
+    'gui_new': (Syscall.GUINEW, 3, 'int'),
+    'gui_update': (Syscall.GUIUPDATE, 0, 'int'),
+    'gui_close': (Syscall.GUICLOSE, 0, 'int'),
+    'gui_closed': (Syscall.GUICLOSED, 0, 'int'),
+    'gui_active': (Syscall.GUIACTIVE, 0, 'int'),
+    'mouse_x': (Syscall.MOUSEX, 0, 'int'),
+    'mouse_y': (Syscall.MOUSEY, 0, 'int'),
+    'mouse_button': (Syscall.MOUSEBTN, 0, 'int'),
+    # 音频扩展 (播放进度与蜂鸣合成)
+    'audio_pos': (Syscall.AUDIOPOS, 0, 'int'),
+    'beep': (Syscall.AUDIOBEEP, 2, 'int'),
+    # 音频控制增强 (查询 / 暂停恢复 / 音量读取)
+    'audio_duration': (Syscall.AUDIODUR, 0, 'int'),
+    'audio_playing': (Syscall.AUDIOPLAYING, 0, 'int'),
+    'audio_pause': (Syscall.AUDIOPAUSE, 0, 'int'),
+    'audio_resume': (Syscall.AUDIORESUME, 0, 'int'),
+    'audio_level': (Syscall.AUDIOLEVEL, 0, 'int'),
+    # 命令行参数与行输入 (跨平台一致)
+    'arg_count': (Syscall.ARGC, 0, 'int'),
+    'arg': (Syscall.ARGV, 1, 'string'),
+    'input_str': (Syscall.READLINE, 0, 'string'),
 }
 
-# 内建函数最少参数个数 (按各分支实际索引的最大下标 + 1 得出)。
-# 缺失参数旧代码会直接 IndexError 崩溃 (如 sqrt()、substr("a",1)),
-# 现在统一报 CompilerError。必须与 Go 侧 compiler.builtinMinArgs 保持一致。
 BUILTIN_MIN_ARGS = {
     'println': 0, 'print': 0,
     'sqrt': 1, 'sin': 1, 'cos': 1, 'tan': 1,
@@ -934,7 +955,11 @@ class Parser:
                 return ('int', self.enums[node[1]])
             raise CompilerError(
                 f"Constant expression uses non-constant name '{node[1]}' "
-                f"at {self._loc()}")
+                f"at {self._loc()} "
+                "(hint: array lengths must be compile-time constants; "
+                f"declare it as `const int {node[1]} = ...`; "
+                "variable-length arrays are not supported — use a fixed-size "
+                "array plus a count variable)")
         if kind == 'neg':
             ctype, value = self._const_value_ast(node[1])
             if ctype == 'string':
@@ -1977,12 +2002,15 @@ class CodeGen:
             self.locals[pname] = (ptype, poff, False)
 
         self.label(f.name)
-        # prologue: 保存调用方 FP, 建立帧指针, 分配局部空间
+        # prologue: 保存调用方 FP, 建立帧指针, 分配局部空间。
+        # 帧分配走 SYS ALLOCFRAME (带栈溢出防护): 此前直接 ADDI SP 减帧长,
+        # 局部大数组会把 SP 推到负地址 —— 轻则报晦涩的越界地址
+        # (如 address ffff...c6f8), 重则静默覆盖全局/堆内存。
         self.emit('PUSH', self.reg(29))
         self.emit('MOV', self.reg(29), self.reg(32))   # FP = SP
         if self.frame_bytes:
-            self.emit('ADDI', self.reg(0), self.reg(32), self.imm(-self.frame_bytes))
-            self.emit('MOV', self.reg(32), self.reg(0))
+            self.emit('MOV', self.reg(0), self.imm(self.frame_bytes))
+            self.emit('SYS', self.imm(Syscall.ALLOCFRAME))
 
         # struct 局部变量: 堆分配对象 (槽里存对象指针, 与全局 struct 同一模型)
         for _name, (t, loff, _is_block) in list(self.locals.items()):
@@ -3524,6 +3552,18 @@ class CodeGen:
                       'rtrim': Syscall.RTRIM}[name]
             self.emit('SYS', self.imm(sys_id))
             return 'string'
+        if name in ('to_int', 'to_float'):
+            # 显式类型转换: to_int(x) 向零截断 (与 int x = 1.9 一致),
+            # to_float(x) 整数提升为浮点。参数类型静态已知, 非数值报编译错。
+            t = self.gen_value(args[0])
+            target = 'int' if name == 'to_int' else 'float'
+            if t not in ('int', 'float', 'bool'):
+                raise CompilerError(
+                    f"{name}() expects a numeric argument, got {t} "
+                    f"at {self._loc()}"
+                    + (f" (hint: use atoi() to parse a string)" if t == 'string' else ""))
+            self._convert(t, target)
+            return target
         if name == 'atoi':
             self.gen_value(args[0])
             self.emit('SYS', self.imm(Syscall.ATOI))
@@ -3543,6 +3583,12 @@ class CodeGen:
             return 'int'
 
         # 用户函数 (已在 _gen_call 开头优先分派; 走到这里说明名字未知)
+        if name in ('int', 'float'):
+            # 常见迁移习惯: C/Python 风格的显式转换函数。给出可操作的替代写法。
+            raise CompilerError(
+                f"Unknown function: {name} (hint: use "
+                f"to_{name}(x) for explicit conversion, or rely on implicit "
+                "promotion in mixed int/float expressions)")
         raise CompilerError(f"Unknown function: {name}")
 
     @staticmethod

{codecin-5.7.4 → codecin-5.8.2}/codecin/cli.py

@@ -17,7 +17,11 @@ from .console import Colors, Console, Panel
 HELP_INTRO = f"""{Colors.colorize(f'Code CIN v{__version__}', Colors.CYAN, True)}
 
 {Colors.colorize('Usage:', Colors.YELLOW)}
-  python cpu.py <program.[cin|pl|asm|bin]> [options]
+  codecin [options] <program.[cin|pl|asm|bin]> [args...]
+
+{Colors.colorize('Program arguments:', Colors.YELLOW)}
+  program 之后的裸参数原样传给 CIN 程序 (arg_count()/arg(i) 读取);
+  CLI 选项放在 program 之前或之后均可识别, 形如选项的参数请用 `--` 显式分隔。
 
 {Colors.colorize('Supported formats:', Colors.YELLOW)}
   .cin   CIN 高级语言 (函数/struct/数组/浮点/字符串)
@@ -48,6 +52,9 @@ def build_parser() -> argparse.ArgumentParser:
                         '包路径) 后退出; 与 --json 合用输出机器可读 JSON')
     p.add_argument('--json', action='store_true', dest='json_output',
                    help='配合 --build-info 输出 JSON (需与 --build-info 同时使用)')
+    p.add_argument('--libs', action='store_true', dest='list_libs',
+                   help='列出内置标准库并标注执行路径要求 '
+                        '(纯 CIN / C·C++·Go 兼容层 / 需原生运行时) 后退出')
 
     # 执行路径
     p.add_argument('--no-native', action='store_true',
@@ -216,9 +223,55 @@ def _run_aot_build(ns: argparse.Namespace, console, program_file: str,
     return 0
 
 
+def _extract_program_args(args: List[str], parser: argparse.ArgumentParser):
+    """把程序文件之后的裸参数透传给 CIN 程序 (arg_count()/arg(i))。
+
+    规则 (向后兼容): 第一个非选项 token 是程序文件; 此后遇到已知 CLI 选项
+    (及其取值) 仍归 CLI 解析, 其余裸 token 归程序参数。`--` 分隔的参数已在
+    main 里摘出, 优先级更高。返回 (cli_args, program_args)。
+    """
+    takes_value = {}
+    for act in parser._actions:  # noqa: SLF001 - argparse 无公开枚举接口
+        for s in getattr(act, 'option_strings', []):
+            takes_value[s] = getattr(act, 'nargs', None) != 0
+    cli_args: List[str] = []
+    prog_args: List[str] = []
+    seen_prog = False
+    i, n = 0, len(args)
+    while i < n:
+        tok = args[i]
+        # --opt=value 形式按其选项名识别
+        optname = tok.split('=', 1)[0] if tok.startswith('--') else tok
+        if optname in takes_value:
+            cli_args.append(tok)
+            if takes_value[optname] and '=' not in tok:
+                i += 1
+                if i < n:
+                    cli_args.append(args[i])
+            i += 1
+            continue
+        if not seen_prog:
+            cli_args.append(tok)
+            seen_prog = True
+            i += 1
+            continue
+        prog_args.append(tok)
+        i += 1
+    return cli_args, prog_args
+
+
 def main(argv: Optional[List[str]] = None) -> int:
     args = list(sys.argv[1:] if argv is None else argv)
 
+    # `--` 之后的参数原样传给 CIN 程序 (arg_count()/arg(i) 读取), 不参与
+    # CLI 自身解析; 与 Go `os.Args[1:]`、C `argv[1..]` 的习惯一致。
+    if '--' in args:
+        sep = args.index('--')
+        program_args = args[sep + 1:]
+        args = args[:sep]
+    else:
+        program_args = []
+
     # 中文 Windows 默认 stdout/stderr 是 GBK, 输出非 GBK 字符 (emoji 等) 会直接
     # UnicodeEncodeError; 且重定向产物字节与 Go 路径 (恒 UTF-8) 不一致。
     # 统一切成 UTF-8, 无法编码的字符以 ? 替换而不是崩溃。
@@ -234,8 +287,20 @@ def main(argv: Optional[List[str]] = None) -> int:
 
     console = Console()
     parser = build_parser()
+
+    # 程序文件之后的裸参数透传给 CIN 程序 (问题反馈 #3): 已知 CLI 选项
+    # (含取值) 仍归 argparse, 其余 token 归 arg_count()/arg(i)。
+    cli_args, direct_args = _extract_program_args(args, parser)
+    if direct_args:
+        for tok in direct_args:
+            if tok.startswith('-') and tok not in ('-',) \
+                    and not tok.lstrip('-').split('=')[0].isdigit():
+                sys.stderr.write(
+                    f"note: {tok!r} 不是 CLI 选项, 已作为程序参数传递 "
+                    f"(arg_count/arg); 如需强制传参请用 `-- {tok}`\n")
+
     try:
-        ns = parser.parse_args(args)
+        ns = parser.parse_args(cli_args)
     except SystemExit as e:
         # argparse 错误 (未知选项/非法数值): 已打印 usage, 返回其退出码
         return int(e.code) if e.code is not None else 2
@@ -253,6 +318,11 @@ def main(argv: Optional[List[str]] = None) -> int:
             sys.stdout.write(format_build_info() + "\n")
         return 0
 
+    if ns.list_libs:
+        from .stdlib import format_library_report
+        sys.stdout.write(format_library_report() + "\n")
+        return 0
+
     if ns.program is None:
         console.print(Panel("No program file specified.\n"
                             "Use --help for usage information.",
@@ -261,6 +331,8 @@ def main(argv: Optional[List[str]] = None) -> int:
 
     config = Config()
     _apply_namespace(config, ns)
+    # 直传参数与 `--` 后参数合并 (直传在前, 位置顺序与命令行一致)
+    config.program_args = direct_args + program_args
     config.validate()
 
     program_file = ns.program
@@ -300,7 +372,7 @@ def main(argv: Optional[List[str]] = None) -> int:
 
     try:
         # 管道/重定向输入预读到 input_buffer: 让 input() 在原生与解释器路径下
-        # 都能读到 `"42" | python cpu.py t.cin` 这样的标准输入 (交互 TTY 不预读)。
+        # 都能读到 `"42" | codecin t.cin` 这样的标准输入 (交互 TTY 不预读)。
         try:
             if sys.stdin is not None and not sys.stdin.isatty():
                 cpu.input_buffer = sys.stdin.read() or ""

{codecin-5.7.4 → codecin-5.8.2}/codecin/config.py

@@ -1,7 +1,7 @@
 """运行配置与命令行参数解析。"""
 
-from dataclasses import dataclass
-from typing import Optional
+from dataclasses import dataclass, field
+from typing import List, Optional
 
 
 @dataclass
@@ -41,6 +41,8 @@ class Config:
     mmu: bool = False
     # A4: 远程调试服务端口 (None = 不启动)
     debug_server_port: Optional[int] = None
+    # 传给 CIN 程序的命令行参数 (cli 里 `--` 之后的参数; 供 arg_count()/arg(i))
+    program_args: List[str] = field(default_factory=list)
 
     # 命令行解析请使用 codecin/cli.py build_parser() (argparse, 单一来源)。
     # Config 仅承载运行配置, 由 cli._apply_namespace 填充。