codecin 6.0.1__tar.gz → 6.2.2__tar.gz

{codecin-6.0.1 → codecin-6.2.2}/CHANGELOG.md

@@ -5,6 +5,182 @@
 
 ---
 
+## [6.2.2] - 2026-10-24
+
+一次以「注册服务与输入设备」为主题的小版本：`registry` 服务端由 Go 迁移到
+Python；CIN 的键盘监听与查询输入（`input` / `input_str`）统一为同一套按键
+事件监听，行输入改由引擎自行编辑；虚拟键盘支持扩展为 Windows / Linux /
+macOS 全平台；修复 `pic publish` 因 Cdifit 认证接口调用方式错误而返回 502
+的问题。
+
+### 新增 (Added)
+
+#### 屏幕/触摸键盘 (虚拟键盘, 全平台)
+
+- 新增内建 `vkb_show()` / `vkb_hide()`（SYS 158/159）与标准库包装
+  `g_vkb_show()` / `g_vkb_hide()`：弹出/收起当前图形会话的屏幕键盘，
+  成功返回 `0`，不可用返回 `-1`。
+- **Windows**：经 WinRT `IInputPaneInterop` → `IInputPane2::TryShow/TryHide`
+  为顶层窗口弹出/收起系统触摸键盘 (TabTip / 输入体验)。绑定窗口优先
+  GUI 窗口；终端 raw 模式绑定可见的控制台窗口，ConPTY (Windows Terminal)
+  或无可控制台时退回前台窗口；GUI 窗口关闭 / 程序退出时自动收起键盘。
+- **Linux**：按 `onboard` → `matchbox-keyboard` → `xvkbd` 顺序探测并启动
+  屏幕键盘；收起时结束本进程启动的实例，并对桌面常驻实例兜底执行
+  `onboard -x` / `pkill`。无 `DISPLAY` / `WAYLAND_DISPLAY` 或均未安装时
+  返回 `-1`，程序退出时清理自启进程。
+- **macOS**：以 App 方式打开系统「辅助功能键盘」(Accessibility Keyboard)，
+  收起时结束对应进程；系统路径不存在或未启用时返回 `-1`。
+- 键盘监听补全虚拟键盘/输入法输入通道：Windows 窗口过程新增 `WM_UNICHAR`
+  (含 `UNICODE_NOCHAR` 能力探测) 与 `WM_IME_CHAR`，与既有
+  `WM_KEYDOWN`(VK_PACKET) / `WM_CHAR` 共用同一按键队列，`get_key` /
+  `key_wait` 无需区分按键来源；支持代理对与 emoji。
+- 终端侧确认 `VK_PACKET + UnicodeChar` (`KEYEVENTF_UNICODE` 注入) 按字符
+  入队，并补充对应回归测试。
+
+#### 统一的交互式行输入 (查询输入)
+
+- `input()` / `input_str()`（`IN` 指令 / SYS 131）在真实终端与 GUI 窗口中
+  改由引擎的 **raw 键码队列** 直接读取，与 `get_key` / `key_wait` 使用同一
+  套事件监听：不再临时把终端切回行规程（Windows `ReadConsoleW` / Unix
+  canonical 模式），也不再依赖操作系统自带行编辑。
+- 内置跨平台行编辑器：字符输入（UTF-8 / 代理对 / emoji）、退格、Delete、
+  左右方向键、Home/End、Ctrl+A/E/U/K/W、Ctrl+左右（按词移动）、Enter；
+  `Ctrl+D` 空行为 EOF，`Ctrl+C` 恢复终端后按 SIGINT / CTRL_C_EVENT 中断。
+  Windows 控制台（已开启 VT 输出）与 Unix 终端共用同一套 ANSI 重绘实现，
+  CJK 等宽字符按 2 列计算光标。
+- GUI 窗口打开时，窗口过程注入的按键（含虚拟键盘/输入法）直接作为查询
+  输入来源；窗口关闭后 `input()` 立即按 EOF 返回，不再永久阻塞。
+- 无真实终端且无 GUI 窗口（管道 / 重定向 / 测试捕获）时保持原有字节流
+  读取路径，输出字节与旧版本完全一致。
+
+### 变更 (Changed)
+
+- 交互式终端上首次执行 `input()` / `input_str()` 时，与键盘监听一样切换为
+  **直写输出**：提示与随后的 `print` 立即落到标准输出，不再等程序结束一次
+  性回传；管道 / 重定向 / 测试捕获仍保持纯缓冲语义。
+- **`registry` 服务端由 Go 迁移为 Python**：仅使用标准库 `http.server`
+  (`ThreadingHTTPServer`，不依赖 Flask)，终端输出与日志由 `rich` 渲染；
+  对外 HTTP API、存储布局与校验规则保持不变，默认监听端口为 `18080`，
+  Dockerfile / nginx / systemd 服务文件同步更新。
+- 服务端测试由 Go 改为 `registry/test_server.py`（pytest）；部署方式更新为
+  Python 3.10+ 虚拟环境 + `requirements.txt`，文档同步改写。
+
+### 修复 (Fixed)
+
+- 修复 `pic publish` 提交时返回 **502**：registry 调用 Cdifit 用户信息接口
+  误用了 `POST /api/v4/session/oauth/userinfo`（实际为 `GET`，POST 得到
+  `404 page not found`，被服务端包装成 `502 auth_unavailable`）。
+- 修复无效/过期 Token 被误报为 502：Cdifit 以 `HTTP 200 + code=401` 返回
+  鉴权失败，服务端现将其映射为客户端 `401`；`pic_api.userinfo()` 同步改为
+  `GET`，并让 `code=401/403` 触发 Token 刷新，而非作为未知状态码上报。
+- 修复 SYS 号 158/159 被 `syscallSupported` 上限拦截，导致 `vkb_show` /
+  `vkb_hide` 报 `unsupported SYS call id`。
+- 修正 `registry/README.md` 中 Docker 端口映射为 `18080:18080`。
+
+---
+
+## [6.2.0] - 2026-10-23
+
+一次以「工具链生态」为主题的发布：新增 **mkn**（Maven 风格构建）、**pic**
+（pip 风格包管理，package.codecin.org.cn 中央注册/分发 + Cdifit 浏览器登录）
+与 **cvm**（JVM 风格虚拟机/模块运行时），三者共享清单、依赖解析与可复现归档格式；
+CIN 语言与 UCBC 指令集不变。
+
+### 新增 (Added)
+
+#### mkn：项目构建与依赖 (Maven 风格)
+
+- 新增 `codecin/mkn.py` 与 `mkn` 命令：`new` / `init` / `build`(=`compile`) /
+  `run` / `test` / `package` / `install` / `deploy` / `add` / `tree` /
+  `verify` / `clean` 完整生命周期。
+- `mkn.toml`（`[project]` / `[build]` / `[dependencies]`）：标准目录
+  `src/main.cin`、`src/test/**`、`target/`；依赖支持版本约束、Git 仓库与本地路径。
+- 依赖统一解析到项目 `pic_modules/`（`mkn` 复用 `pic` 的安装实现），并写入
+  `pic.lock`；本地仓库为 `$MKN_HOME/repository/<name>/<version>`。
+- 自动区分应用/库：入口及 import 闭包中没有 `function main` 时，`mkn build`
+  产出可重定位 `.co` 对象而不是误报缺少 `main`。
+- `mkn package` 生成确定性 `.mkn` 归档（含自动生成的 `pic.toml`、源码、
+  `target/*.bin|.co` 与 `META-INF/SHA256SUMS`）。
+
+#### pic：中央注册/分发 + 浏览器登录 (pip 风格)
+
+- 新增 `codecin/pic.py`、`codecin/pic_api.py`、`codecin/pic_login.py`、
+  `codecin/pic_registry.py` 与 `pic` 命令：`login` / `logout` / `whoami` /
+  `init` / `build` / `publish` / `install` / `uninstall` / `list` / `show` /
+  `freeze` / `search` / `registry` / `doctor`。
+- **独立中央服务器 `package.codecin.org.cn`**：新增 `registry/` Go 服务，
+  提供包记录、版本列表、`.cinpkg` 制品上传/下载、yank、搜索与健康检查；
+  Cdifit (`https://www.cdifit.cn`) 仅用于登录/Token 校验，不再存储包数据。
+- **首次使用登录**：`pic login` 在 `127.0.0.1` 随机端口启动临时 Web 服务并
+  打开浏览器；登录页使用相对布局（flex + `min(92vw, 26rem)`，无绝对定位），
+  支持密码与 2FA；令牌写入 `$PIC_HOME/auth.json` (0600)，服务随后关闭。
+  无 `auth.json` 时首次运行任意 `pic` 命令会自动进入登录流程；`PIC_OFFLINE=1`
+  可离线绕过。
+- **登录安全**：只绑定 loopback；同源 `Origin` + 随机 CSRF 校验；
+  `Cache-Control: no-store` / `X-Frame-Options: DENY`；密码不落盘、不写日志。
+- **发布**：`pic publish --repo <git-url> --name <name>` 校验清单、生成
+  `.cinpkg`、创建 `v<version>` 标签，向中央服务器提交元数据并上传制品；
+  `--push` 推送标签，`--no-tag` 改用 Git 提交记录。
+- **按名称安装**：从中央记录选版本 → 优先下载 `.cinpkg` 并校验 SHA-256，
+  否则回退 Git 拉取 → 重算源码/清单摘要与 `rev` 校验；任一不匹配则删除并拒绝。
+  仍然支持 `name@version`、`git+URL@ref`、本地路径、`.cinpkg`、`--project`
+  与 `-e/--editable`。
+- **详细输出**：`pic publish` 输出 8 步（认证/清单/Git/构建/标签/本地缓存/
+  中央注册/完成），`pic install` 输出解析/锁定/路径/来源/提交/入口/import 提示；
+  `search`/`registry list` 显示服务器与结果数。
+- **本地回退**：`PIC_OFFLINE=1` 或 `config.toml` 的 `offline=true` 时使用
+  `registry.json` 本地注册表；`pic registry add/remove` 保留为本地回退。
+- 安装存储 `$PIC_HOME`（默认 `~/.pic`）：`auth.json`、`config.toml`、
+  带自愈能力的 `index.json`、`packages/<name>/<version>/`、`cache/git/` 与
+  `cache/artifacts/`；归档安装前校验 `META-INF/SHA256SUMS`，解包拒绝绝对路径、
+  盘符、`..` 与符号链接。
+
+#### CVM：虚拟机与 `.cvm` 模块 (JVM 风格)
+
+- 新增 `codecin/cvm.py` 与 `cvm` 命令：`build` / `run` / `inspect` /
+  `verify` / `install` / `which` / `list` / `env`；对外运行时概念为 **CVM**，
+  `CPU` 仅保留为内部执行核。
+- `.cvm` 模块（zip）：`CVM-INF/MANIFEST.TOML` + `code/program.bin` (BIN v3) +
+  `META-INF/SHA256SUMS`；清单记录格式版本、引擎、ABI、模块名/版本与构建信息。
+- 模块路径类似 `CLASSPATH`：`CVM_MODULE_PATH` + `$CVM_HOME/modules`；
+  `cvm install` / `which` 支持按名称解析模块。
+- 支持从 `.cin/.asm/.pl/.bin` 或含 `mkn.toml` 的项目构建模块；校验和/字节码
+  magic 任一不匹配都会在装载阶段失败。
+
+#### 包导入与共享基础设施
+
+- CIN `import` 新增包解析：`import "hello"` 导入包入口，
+  `import "hello/util.cin"` 导入包内文件；搜索顺序为
+  相对路径 → 内置标准库 → 项目 `pic_modules/`/`.mkn/deps`/`.pic/packages` →
+  `CIN_PATH` → 全局 `$PIC_HOME/packages/<name>/<current>`。
+- 新增 `codecin/packaging/`：零依赖 TOML 读写（兼容 Python 3.8）、清单与语义化
+  版本约束、包存储、Git 封装、确定性 zip/安全解包/校验和。
+- 新增 `codecin/toolkit.py`：工具 CLI 的 UTF-8 标准输出初始化。
+- 新增 console scripts：`mkn = codecin.mkn:main`、`pic = codecin.pic:main`、
+  `cvm = codecin.cvm:main`；`codecin --help` 增加工具链提示。
+
+### 变更 (Changed)
+
+- 版本号提升至 **6.2.0**（`codecin/__init__.py` 单一真源，
+  `codecin/native/engine/version_gen.go` 同步）。
+- 裸名字 import 仍**优先命中内置标准库**（如 `import "math.cin"`），避免既有程序
+  被同名第三方包劫持；第三方包推荐使用无 `.cin` 后缀的包名形式。
+- `pic` 首次运行（除 `login`/`logout`/`doctor`）要求登录 Cdifit；无 `auth.json`
+  时自动打开临时本地登录页。离线开发/CI 使用 `PIC_OFFLINE=1` 或
+  `pic --offline ...` 保持旧行为；`mkn` 按名称解析依赖同样走该登录。
+- `mkn`/`pic`/`cvm` 的错误统一为 `prog: error: ...` 并返回退出码 1，不打印
+  Python traceback；`--help`/`--version` 退出码 0。
+
+### 兼容性
+
+- 现有 `codecin <program>` 参数、`.cin/.pl/.asm/.bin/.crom/.co/.colib` 格式、
+  ABI v2、BIN v3、CROM v4 全部不变；`tests/test_features_import.py` 的原有用例
+  保持通过。
+- 原生库版本自报仍为旧值时不影响执行；`codecin --build-info` 会提示不一致，
+  重建原生库后即可一致。
+
+---
+
 ## [6.0.1] - 2026-10-18
 
 ### 修复 (Fixed)

{codecin-6.0.1/codecin.egg-info → codecin-6.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codecin
-Version: 6.0.1
+Version: 6.2.2
 Summary: Code CIN - 高级语言与运行时 (CIN/PL/ASM 工具链 + Go 原生 VM + ARM64/RISC-V/FP/Vector 指令集)
 Author: ByUsi Studio, 北啊呢
 License-Expression: MIT
@@ -34,6 +34,54 @@ Code CIN 是一门简洁的类 C 高级语言及其跨平台运行时（VM）。
 
 模块化包结构（`codecin/`，Go 侧 `codecin/native/`），全线日志与错误输出基于 **rich**（彩色表格、面板、traceback），`--debug` / `--log-level DEBUG` 提供超详细诊断。
 
+## v6.2.0 工具链：mkn / pic / cvm
+
+v6.2.0 在 `codecin` 之外提供三个独立命令，覆盖**构建 → 分发 → 运行**：
+
+| 命令 | 类比 | 作用 |
+|------|------|------|
+| `mkn` | Maven | 项目清单、标准目录、生命周期、依赖解析、打包与本地仓库 |
+| `pic` | pip | `package.codecin.org.cn` 中央注册/分发 + Cdifit 登录：发布登记标识名/Git 地址/版本列表/安全摘要并上传 `.cinpkg`，安装后可直接 `import` |
+| `cvm` | JVM | Code CIN 虚拟机：构建/校验/运行 `.cvm` 模块，支持模块路径；`CPU` 仅作为内部执行核 |
+
+```bash
+# 项目构建
+mkn new demo && cd demo
+mkn build
+mkn run
+mkn test
+mkn package                     # target/demo-0.1.0.mkn
+
+# 包管理 (首次使用会打开临时本地网页登录 Cdifit)
+pic login
+pic init hello
+pic publish --repo https://github.com/you/cin-hello --name hello
+pic install hello@^1.0          # 或 git+https://...、本地路径、.cinpkg
+pic install hello --project     # 安装到项目 pic_modules/，可直接 import
+pic whoami
+pic logout
+
+# 虚拟机
+cvm build src/main.cin -o app.cvm
+cvm verify app.cvm
+cvm run app.cvm -- arg1 arg2
+cvm env
+```
+
+`pic` 的中央注册/分发服务器是 **`package.codecin.org.cn`**（元数据、
+`.cinpkg` 制品、版本/安全摘要）；**Cdifit (`https://www.cdifit.cn`) 只负责
+登录和 Token 校验**。服务端实现见 [registry/README.md](registry/README.md)，
+客户端可用 `PIC_REGISTRY_URL` 覆盖服务器地址。
+
+安装后的包无需修改源码即可导入：
+
+```cin
+import "hello"                  // 包入口 (pic.toml 的 entry)
+import "hello/util.cin"         // 包内文件
+```
+
+完整设计、格式与验收标准见 [V6.2.0-PLAN.md](V6.2.0-PLAN.md)。
+
 ## 文档
 
 **官方文档站**位于独立仓库

{codecin-6.0.1 → codecin-6.2.2}/README.md

@@ -16,6 +16,54 @@ Code CIN 是一门简洁的类 C 高级语言及其跨平台运行时（VM）。
 
 模块化包结构（`codecin/`，Go 侧 `codecin/native/`），全线日志与错误输出基于 **rich**（彩色表格、面板、traceback），`--debug` / `--log-level DEBUG` 提供超详细诊断。
 
+## v6.2.0 工具链：mkn / pic / cvm
+
+v6.2.0 在 `codecin` 之外提供三个独立命令，覆盖**构建 → 分发 → 运行**：
+
+| 命令 | 类比 | 作用 |
+|------|------|------|
+| `mkn` | Maven | 项目清单、标准目录、生命周期、依赖解析、打包与本地仓库 |
+| `pic` | pip | `package.codecin.org.cn` 中央注册/分发 + Cdifit 登录：发布登记标识名/Git 地址/版本列表/安全摘要并上传 `.cinpkg`，安装后可直接 `import` |
+| `cvm` | JVM | Code CIN 虚拟机：构建/校验/运行 `.cvm` 模块，支持模块路径；`CPU` 仅作为内部执行核 |
+
+```bash
+# 项目构建
+mkn new demo && cd demo
+mkn build
+mkn run
+mkn test
+mkn package                     # target/demo-0.1.0.mkn
+
+# 包管理 (首次使用会打开临时本地网页登录 Cdifit)
+pic login
+pic init hello
+pic publish --repo https://github.com/you/cin-hello --name hello
+pic install hello@^1.0          # 或 git+https://...、本地路径、.cinpkg
+pic install hello --project     # 安装到项目 pic_modules/，可直接 import
+pic whoami
+pic logout
+
+# 虚拟机
+cvm build src/main.cin -o app.cvm
+cvm verify app.cvm
+cvm run app.cvm -- arg1 arg2
+cvm env
+```
+
+`pic` 的中央注册/分发服务器是 **`package.codecin.org.cn`**（元数据、
+`.cinpkg` 制品、版本/安全摘要）；**Cdifit (`https://www.cdifit.cn`) 只负责
+登录和 Token 校验**。服务端实现见 [registry/README.md](registry/README.md)，
+客户端可用 `PIC_REGISTRY_URL` 覆盖服务器地址。
+
+安装后的包无需修改源码即可导入：
+
+```cin
+import "hello"                  // 包入口 (pic.toml 的 entry)
+import "hello/util.cin"         // 包内文件
+```
+
+完整设计、格式与验收标准见 [V6.2.0-PLAN.md](V6.2.0-PLAN.md)。
+
 ## 文档
 
 **官方文档站**位于独立仓库

{codecin-6.0.1 → codecin-6.2.2}/codecin/__init__.py

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

{codecin-6.0.1 → codecin-6.2.2}/codecin/cin.py

@@ -253,6 +253,9 @@ HOST_BUILTINS = {
     'mouse_x': (Syscall.MOUSEX, 0, 'int'),
     'mouse_y': (Syscall.MOUSEY, 0, 'int'),
     'mouse_button': (Syscall.MOUSEBTN, 0, 'int'),
+    # 虚拟键盘 (Windows 屏幕/触摸键盘 TabTip; 其他平台 -1)
+    'vkb_show': (Syscall.VKBSHOW, 0, 'int'),
+    'vkb_hide': (Syscall.VKBHIDE, 0, 'int'),
     # 音频扩展 (播放进度与蜂鸣合成)
     'audio_pos': (Syscall.AUDIOPOS, 0, 'int'),
     'beep': (Syscall.AUDIOBEEP, 2, 'int'),
@@ -590,7 +593,9 @@ def tokenize(source: str,
 # ==================== import 预处理 (B3) ====================
 # import "path.cin" 仅在文件顶部/列首识别。解析规则:
 #   * "./x.cin" / "../x.cin"  -> 相对当前 .cin 文件所在目录;
-#   * 其余形式                -> codecin 内置标准库 codecin/lib/。
+#   * 其余形式                -> 依次查找 codecin 内置标准库、项目依赖目录、
+#                                CIN_PATH、已安装的 pic 包;
+#   * 包名 (无 .cin 后缀) 直接 import 该包的入口 (v6.2.0)。
 # 同一文件每个编译仅包含一次, 循环引用报错。
 
 _IMPORT_RE = re.compile(r'^import\s+["\']([^"\']+)["\']\s*;?\s*$')
@@ -603,19 +608,193 @@ _LIB_DIR = os.path.join(_CODECIN_ROOT, 'lib')
 #: 相对引用的前缀: 必须以 "." 开头
 _RELATIVE_PREFIXES = ('./', '../', '.\\', '..\\')
 
+#: 项目内依赖目录 (按优先级): mkn / pic --project / 旧式隐藏目录
+_PROJECT_DEP_DIRS = ('pic_modules', os.path.join('.mkn', 'deps'),
+                     os.path.join('.pic', 'packages'))
+
+#: 包名合法性 (与 packaging.model 保持一致, 这里不 import 以避免启动开销)
+_PKG_NAME_RE = re.compile(r'^[A-Za-z][A-Za-z0-9_-]{0,63}$')
+
 
 def _is_relative_import(name: str) -> bool:
     """``import "./x.cin"`` / ``import "../x.cin"`` 视为相对引用。"""
     return name.startswith(_RELATIVE_PREFIXES)
 
 
+def _cin_path_dirs() -> List[str]:
+    """``CIN_PATH`` 环境变量中的 import 搜索目录 (``os.pathsep`` 分隔)。"""
+    raw = os.environ.get('CIN_PATH', '')
+    return [os.path.abspath(p) for p in raw.split(os.pathsep) if p.strip()]
+
+
+def _project_roots(source_dir: str) -> List[str]:
+    """从源文件目录向上收集包含 mkn.toml / pic.toml 的项目根 (近到远)。"""
+    roots: List[str] = []
+    path = os.path.abspath(source_dir)
+    while True:
+        if (os.path.isfile(os.path.join(path, 'mkn.toml'))
+                or os.path.isfile(os.path.join(path, 'pic.toml'))):
+            roots.append(path)
+        parent = os.path.dirname(path)
+        if parent == path:
+            break
+        path = parent
+    return roots
+
+
+def _package_roots(source_dir: str) -> List[str]:
+    """候选包根目录 (按优先级): 项目依赖 -> CIN_PATH -> 全局 pic 存储。"""
+    roots: List[str] = []
+    for project in _project_roots(source_dir):
+        for rel in _PROJECT_DEP_DIRS:
+            candidate = os.path.join(project, rel)
+            if os.path.isdir(candidate):
+                roots.append(candidate)
+    roots.extend(_cin_path_dirs())
+
+    home = os.environ.get('PIC_HOME') or os.path.join(
+        os.path.expanduser('~'), '.pic')
+    packages = os.path.join(home, 'packages')
+    if os.path.isdir(packages):
+        # 全局存储是 <name>/<version>/; 具体版本由解析器按 current 选择
+        roots.append(packages)
+    return roots
+
+
+def _entry_from_package(pkg_dir: str, pkg: str,
+                        hinted_file: Optional[str] = None) -> Optional[str]:
+    """在包目录中解析入口文件: pic.toml 的 entry 优先, 再按约定回退。"""
+    base = pkg_dir
+    link = os.path.join(base, '.pic-link')
+    if os.path.isfile(link):
+        try:
+            with open(link, encoding='utf-8') as f:
+                target = f.read().strip()
+            if target:
+                base = os.path.abspath(target)
+        except OSError:
+            pass
+    if not os.path.isdir(base):
+        return None
+
+    if hinted_file:
+        for rel in (hinted_file, os.path.join('src', hinted_file)):
+            candidate = os.path.normpath(os.path.join(base, rel))
+            if os.path.isfile(candidate):
+                return candidate
+
+    manifest = os.path.join(base, 'pic.toml')
+    if os.path.isfile(manifest):
+        try:
+            from .packaging.model import load_package_manifest
+            meta = load_package_manifest(base, require_entry=False)
+            if meta.entry_path:
+                return meta.entry_path
+        except Exception:
+            # 清单损坏不应让 import 变成不可诊断的异常:
+            # 继续按目录约定查找, 最终在找不到时给出统一错误
+            pass
+
+    mkn_manifest = os.path.join(base, 'mkn.toml')
+    if os.path.isfile(mkn_manifest):
+        try:
+            from .packaging.model import load_mkn_manifest
+            project = load_mkn_manifest(base)
+            entry = project.entry_path
+            if entry:
+                return entry
+        except Exception:
+            pass
+
+    for rel in (os.path.join('src', f'{pkg}.cin'), f'{pkg}.cin',
+                os.path.join('src', 'main.cin'), 'main.cin'):
+        candidate = os.path.normpath(os.path.join(base, rel))
+        if os.path.isfile(candidate):
+            return candidate
+    return None
+
+
+def _version_dirs(pkg_dir: str, root: str) -> List[str]:
+    """全局存储 ``<name>/<version>`` 下的版本目录 (current 优先)。"""
+    try:
+        versions = [
+            v for v in os.listdir(pkg_dir)
+            if os.path.isdir(os.path.join(pkg_dir, v))
+            and re.fullmatch(r'\d+\.\d+\.\d+(?:[-+].*)?', v)
+        ]
+    except OSError:
+        return []
+    current = None
+    if os.path.basename(root) == 'packages':
+        index_path = os.path.join(os.path.dirname(root), 'index.json')
+        try:
+            import json
+            with open(index_path, encoding='utf-8') as f:
+                index = json.load(f)
+            record = (index.get('packages') or {}).get(
+                os.path.basename(pkg_dir)) or {}
+            current = record.get('current')
+        except (OSError, ValueError, TypeError):
+            current = None
+    versions.sort(reverse=True)
+    if current in versions:
+        versions.remove(current)
+        versions.insert(0, current)
+    return [os.path.join(pkg_dir, v) for v in versions]
+
+
+def _resolve_package_import(name: str,
+                            source_dir: str) -> Optional[str]:
+    """按包名解析 import; 找不到返回 None。"""
+    normalized = name.replace('\\', '/')
+    parts = [p for p in normalized.split('/') if p]
+    if not parts:
+        return None
+
+    pkg = parts[0]
+    hinted: Optional[str] = None
+    if len(parts) == 1 and pkg.endswith('.cin'):
+        # `import "hello.cin"` 也允许命中名为 hello 的包
+        pkg = pkg[:-4]
+        hinted = parts[0]
+    if not _PKG_NAME_RE.match(pkg):
+        return None
+    sub = '/'.join(parts[1:]) if len(parts) > 1 else ''
+
+    for root in _package_roots(source_dir):
+        pkg_dir = os.path.join(root, pkg)
+        if not os.path.isdir(pkg_dir):
+            continue
+        version_dirs = _version_dirs(pkg_dir, root)
+        if sub:
+            for base in [pkg_dir, os.path.join(pkg_dir, 'src'),
+                         *(os.path.join(v, 'src') for v in version_dirs),
+                         *version_dirs]:
+                candidate = os.path.normpath(
+                    os.path.join(base, *sub.split('/')))
+                if os.path.isfile(candidate):
+                    return candidate
+            continue
+        entry = _entry_from_package(pkg_dir, pkg, hinted)
+        if entry:
+            return entry
+        for version_dir in version_dirs:
+            entry = _entry_from_package(version_dir, pkg, hinted)
+            if entry:
+                return entry
+    return None
+
+
 def _resolve_import(name: str, source_dir: str) -> str:
     """解析 import 目标路径。
 
-    规则 (B3):
+    规则 (B3 + v6.2.0 包导入):
       * ``import "./x.cin"`` / ``import "../x.cin"`` —— 相对**当前 .cin 文件**所在目录;
-      * 其余任何形式 (``import "x.cin"``、``import "lib/x.cin"``) —— 直接解析到
-        **codecin 内置标准库** ``codecin/lib/`` (``lib/`` 前缀保留为兼容写法)。
+      * 其余形式先查 **codecin 内置标准库** ``codecin/lib/`` (``lib/`` 前缀保留
+        为兼容写法), 保持 "裸名字不会命中兄弟文件" 的既有语义;
+      * 再查项目依赖目录 (``pic_modules`` / ``.mkn/deps`` / ``.pic/packages``)、
+        ``CIN_PATH`` 与全局 pic 包存储; ``import "hello"`` 直接导入包入口,
+        ``import "hello/util.cin"`` 导入包内文件。
     """
     if _is_relative_import(name):
         cand = os.path.normpath(os.path.join(source_dir, name))
@@ -630,9 +809,16 @@ def _resolve_import(name: str, source_dir: str) -> str:
     for cand in candidates:
         if os.path.isfile(cand):
             return cand
+
+    package = _resolve_package_import(name, source_dir)
+    if package:
+        return package
+
     raise CompilerError(
-        f"Import file not found: {name!r} (内置标准库, 已查找 "
-        f"{os.path.join(_LIB_DIR, name)})")
+        f"Import file not found: {name!r} (内置标准库已查找 "
+        f"{os.path.join(_LIB_DIR, name)}; 也未在项目 pic_modules/"
+        f"CIN_PATH/已安装 pic 包中找到)。"
+        f"如需导入第三方包, 先运行 `pic install <name>`。")
 
 
 def _collect_module_lines(path: str, loaded: set, active: set,

{codecin-6.0.1 → codecin-6.2.2}/codecin/cli.py

@@ -28,6 +28,11 @@ HELP_INTRO = f"""{Colors.colorize(f'Code CIN v{__version__}', Colors.CYAN, True)
   .pl    Code CIN 汇编语言 (PL 关键字风格)
   .asm   Code CIN 汇编
   .bin   UCBC 字节码 (由 --compile 生成)
+
+{Colors.colorize('Toolchain (v6.2.0):', Colors.YELLOW)}
+  mkn   项目构建/依赖 (Maven 风格)
+  pic   去中心化包管理 (pip 风格, 安装后可直接 import)
+  cvm   CVM 虚拟机/模块运行时 (JVM 风格)
 """