codecin 6.2.2__tar.gz → 6.4.0__tar.gz

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

@@ -5,6 +5,149 @@
 
 ---
 
+## [6.4.0] - 2026-10-30
+
+一次以「pic 搜索 / 版本管理 / 分块导入」为主题的发布：CIN 的 `import` 现在可以
+按包、模块和版本选择（`rich:*` / `rich:table` / `rich::1.1.1:*`），不再只能
+整包导入；`pic install` 默认安装最新版本；中央注册服务器补齐搜索、统计、
+latest 指针、版本删除与浏览器后台管理页。
+
+### 新增 (Added)
+
+#### CIN 分块导入 (pic 包)
+
+- `import` 新增包规格语法，与 `pic install` 共用
+  `codecin/packaging/spec.py`：
+  - `import "rich"` —— 包入口（兼容旧写法）；
+  - `import "rich:*"` —— 入口 + 全部公开模块；
+  - `import "rich:table"` / `import "rich:table,markdown"` —— 指定模块；
+  - `import "rich::1.1.1:*"` / `import "rich::1.1.1:table"` —— 指定版本；
+  - `import "rich@1.1.1:table"` —— 旧式版本写法。
+- 通配 `*` 跳过 `main.cin`、`test/`、`demo/`、`internal/` 等非公开模块；
+  显式选择私有模块时先展开入口，避免 `rich` 的 `internal/table.cin`
+  依赖 `style.cin` 符号而编译失败。
+- 包版本解析支持全局存储 `$PIC_HOME/packages/<name>/<current>` 与显式
+  `::<版本>`；版本未安装时给出 `pic install <name>@<version>` 的可执行提示。
+- 新增 `pic modules <name>`：列出已安装/远程包内可导入模块，并给出
+  `import "<name>:*"`、`import "<name>:<module>"` 示例。
+
+#### pic 安装与搜索
+
+- **默认安装最新版本**：`pic install <name>` 不写版本时按中央注册表的
+  `latest` 指针（无指针时取最高未撤回版本）解析，即使本地已安装旧版本
+  也会升级；`--project` 安装同样适用。`name@^1.2` / `name@1.2.3` 保持
+  “满足约束即可”的旧语义。
+- `pic install` 支持 `name:*` / `name::<版本>:*` 规格；选择器只影响安装后
+  推荐的 `import` 写法，安装始终复制整个包。
+- `pic search` 大幅增强：
+  - 搜索范围扩展为包名 / 仓库 / 描述 / 关键词；
+  - 相关度排序（精确 > 前缀 > 包含 > 关键词 > 描述 > 仓库）；
+  - `--sort name|latest|updated|downloads|versions`、`--order asc|desc`、
+    `--limit` / `--offset` 分页、`--keyword` 过滤、`--json`；
+  - 输出 latest、版本数、下载量与描述。
+- 新增 `pic versions <name>`（latest / yanked / installed 标记）、
+  `pic info <name>`（仓库、描述、关键词、许可证、入口、模块、下载量、
+  版本列表）。搜索、`versions`、`info`、`registry list` 改为公开只读，
+  无需登录。
+
+#### pic 版本管理与后台
+
+- 中央注册服务器新增：
+  - `latest` 指针与 `POST /api/v1/packages/{name}/{version}/latest`；
+  - 版本/整包删除 `DELETE /api/v1/packages/{name}[/{version}]`；
+  - 统计 `GET /api/v1/stats`、当前用户 `GET /api/v1/me`；
+  - 制品下载计数与包级/版本级 `downloads`；
+  - 发布时保存描述、关键词、许可证、入口、模块列表。
+- 搜索 API 支持 `q` / `keyword` / `sort` / `order` / `limit` / `offset`，
+  返回 `total` / `count` / `offset` / `limit`，并包含描述、关键词、
+  下载量、已撤回版本数。
+- 新增 `/admin` 浏览器后台管理页（零外部前端依赖）：
+  - 统计卡片、包搜索/排序、包详情与版本表；
+  - 撤回/恢复版本、设置 latest、删除版本、删除整个包；
+  - 令牌保存在浏览器 `localStorage`，支持 URL fragment 传入；
+  - 管理员由 `PIC_ADMIN_EMAILS` / `PIC_ADMIN_IDS` 配置，未配置时发布者
+    仍可管理自己发布的包。
+- 新增 `pic yank` / `pic unyank` / `pic latest` / `pic use` / `pic admin`
+  （`--no-browser` / `--print-token`）命令。
+- latest 指向的版本被撤回时，解析自动回退到最高未撤回版本；
+  设置 latest 时拒绝已撤回版本。
+
+### 变更 (Changed)
+
+- 版本号提升至 **6.4.0**（`codecin/__init__.py` 单一真源，
+  `codecin/native/engine/version_gen.go` 同步；registry 服务端版本同步）。
+- `pic install <name>` 不再优先复用本地任意已安装版本；默认 latest 会
+  升级到服务端最新版本。需要固定旧版本时显式写 `name@<版本>`。
+- CIN `import "name"` / `import "name:*"` 默认选择**最高已安装版本**，
+  不再受 `$PIC_HOME/index.json` 的 `current` 指针影响（`current` 仍供
+  `pic show` / `pic use` 等本地命令使用）；显式 `name::<版本>` 不变。
+- 包记录新增可选字段 `latest` / `latest_pointer` / `description` /
+  `keywords` / `license` / `homepage` / `entry` / `modules` / `downloads`；
+  旧记录缺少这些字段时按默认值读取，向后兼容。
+- `DELETE /api/v1/packages/{name}` 由 405 改为可删除（发布者或管理员）；
+  删除不可恢复，后台页会二次确认。
+- 服务端搜索默认按相关度/名称排序，`pic search` 输出列由 `REPO` 改为
+  `VERSIONS` / `DOWNLOADS` / `DESCRIPTION`。
+
+### 修复 (Fixed)
+
+- 修复 `pic install <name>` 在本地已安装旧版本时不会升级的问题。
+- 修复 `pic search` 只能匹配包名/仓库、无法按描述/关键词搜索的问题。
+- 修复 `pic` 缺少版本列表、latest、撤回恢复与后台管理入口的问题。
+- 修复 `rich` 等包含私有模块的包在分块导入时缺少入口符号导致的
+  `Unknown function` 编译错误。
+- 修复服务端统计中已撤回版本仍可能被当作 latest 的问题。
+
+### 兼容性
+
+- 既有 `import "./x.cin"`、`import "math.cin"`、`import "hello"`、
+  `import "hello/util.cin"` 写法全部保持；不带冒号的包名仍先查内置标准库。
+- `pic install name@version`、`git+URL`、本地路径、`.cinpkg`、`mkn`
+  依赖解析行为不变；`mkn` 的空版本依赖同样默认最新。
+- 服务端旧包记录可直接读取；`pic.lock` 格式不变。
+
+## [6.3.1] - 2026-10-25
+
+一次以「终端缓存与实时输出」为主题的小版本：新增终端缓存技术，启动/编译期间
+提前键入的内容不再丢失，程序输出在执行过程中即可实时呈现，终端交互与动态特效
+更加生动流畅；同时保留完整输出缓存，管道 / 重定向 / 测试捕获行为保持不变。
+
+### 新增 (Added)
+
+#### 终端缓存技术
+
+- **输入缓存 (type-ahead)**：键盘监听 / 交互式行输入首次激活时，不再清空
+  终端里尚未被读取的残留输入，而是读入统一的键码队列 —— 用户在程序启动、
+  编译期间提前键入的字符不会丢失，`get_key` / `key_wait` / `input` /
+  `input_str` 可直接消费。
+  - Windows 端同时跳过鼠标、窗口、焦点与 key-up 事件继续读取，避免队列
+    被非按键事件卡住。
+  - 需要主动丢弃旧输入时调用 `key_flush()`：清空键码队列、解码中间态与
+    终端残留输入（Windows `FlushConsoleInputBuffer`，Unix 非阻塞排空）。
+- **输出缓存**：实时输出模式下，程序输出在逐条写往终端的同时仍完整保留在
+  执行结果中（`Result.Output`），新增 `streamed` 标记告知宿主"已实时显示、
+  不要重复打印"；API 调用方与测试仍可读取完整输出。
+- **运行前状态实时显示**：真实终端下依次输出 `Loading <文件> ...` →
+  `Loaded N instructions in X ms` → `Running ...`，编译/装载阶段不再黑屏
+  等待；`--log-level ERROR` 与管道输出保持干净。
+- **演示程序**：新增 `examples/terminal_cache_demo.cin`，覆盖打字机/旋转指示器/
+  进度条实时动画、动画期间提前输入的文字与原始键码读取，以及 `key_flush()`
+  显式清理；直接运行 `codecin examples/terminal_cache_demo.cin` 即可体验。
+
+### 变更 (Changed)
+
+- **执行与输出时效性优化**：Python CLI 与 AOT 产物（VM 后端及生成的原生
+  后端）在真实终端下改为边执行边写标准输出，`print` / 终端绘制类特效不再
+  等整个程序结束后一次性出现；管道 / 重定向 / 测试捕获仍保持"缓冲 + 结束
+  回传"，输出字节与旧版本完全一致。
+- **原生 ABI 扩展**：`codecin_run_v2` 的 `flags` 新增 bit1 = 实时输出请求；
+  结果缓冲 36 字节头中 `offset 2` 由保留字节改为 `streamed` 标志（`offset 3`
+  仍为保留字节），布局与长度不变。
+- 版本号提升至 **6.3.1**（`codecin/__init__.py` 单一真源，
+  `codecin/native/engine/version_gen.go` 同步）。
+
+---
+
 ## [6.2.2] - 2026-10-24
 
 一次以「注册服务与输入设备」为主题的小版本：`registry` 服务端由 Go 迁移到

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codecin
-Version: 6.2.2
+Version: 6.4.0
 Summary: Code CIN - 高级语言与运行时 (CIN/PL/ASM 工具链 + Go 原生 VM + ARM64/RISC-V/FP/Vector 指令集)
 Author: ByUsi Studio, 北啊呢
 License-Expression: MIT
@@ -34,14 +34,14 @@ Code CIN 是一门简洁的类 C 高级语言及其跨平台运行时（VM）。
 
 模块化包结构（`codecin/`，Go 侧 `codecin/native/`），全线日志与错误输出基于 **rich**（彩色表格、面板、traceback），`--debug` / `--log-level DEBUG` 提供超详细诊断。
 
-## v6.2.0 工具链：mkn / pic / cvm
+## v6.2.0+ 工具链：mkn / pic / cvm
 
 v6.2.0 在 `codecin` 之外提供三个独立命令，覆盖**构建 → 分发 → 运行**：
 
 | 命令 | 类比 | 作用 |
 |------|------|------|
 | `mkn` | Maven | 项目清单、标准目录、生命周期、依赖解析、打包与本地仓库 |
-| `pic` | pip | `package.codecin.org.cn` 中央注册/分发 + Cdifit 登录：发布登记标识名/Git 地址/版本列表/安全摘要并上传 `.cinpkg`，安装后可直接 `import` |
+| `pic` | pip | `package.codecin.org.cn` 中央注册/分发 + Cdifit 登录：发布登记标识名/Git 地址/版本列表/安全摘要并上传 `.cinpkg`，安装后可直接 `import`；支持搜索、版本管理与 `/admin` 后台 |
 | `cvm` | JVM | Code CIN 虚拟机：构建/校验/运行 `.cvm` 模块，支持模块路径；`CPU` 仅作为内部执行核 |
 
 ```bash
@@ -56,8 +56,14 @@ mkn package                     # target/demo-0.1.0.mkn
 pic login
 pic init hello
 pic publish --repo https://github.com/you/cin-hello --name hello
+pic install hello               # 不写版本 -> 最新版本
 pic install hello@^1.0          # 或 git+https://...、本地路径、.cinpkg
 pic install hello --project     # 安装到项目 pic_modules/，可直接 import
+pic search hello --json         # 搜索 (名称/描述/关键词, 分页/排序)
+pic versions hello              # 版本列表 (latest/yanked/installed)
+pic info hello                  # 包详情
+pic use hello 1.0.0             # 切换本地 current 版本
+pic admin                       # 后台管理页 (版本/撤回/删除/latest)
 pic whoami
 pic logout
 
@@ -73,15 +79,17 @@ cvm env
 登录和 Token 校验**。服务端实现见 [registry/README.md](registry/README.md)，
 客户端可用 `PIC_REGISTRY_URL` 覆盖服务器地址。
 
-安装后的包无需修改源码即可导入：
+安装后的包无需修改源码即可导入，并支持按模块/版本分块导入
+（不写版本时默认使用最高已安装版本）：
 
 ```cin
-import "hello"                  // 包入口 (pic.toml 的 entry)
-import "hello/util.cin"         // 包内文件
+import "hello"
+import "hello/util.cin"
+import "hello:*"               // 全部公开模块
+import "hello:util"            // 只导入 util 模块
+import "hello::1.0.0:*"        // 指定版本的全部公开模块
 ```
 
-完整设计、格式与验收标准见 [V6.2.0-PLAN.md](V6.2.0-PLAN.md)。
-
 ## 文档
 
 **官方文档站**位于独立仓库

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

@@ -16,14 +16,14 @@ Code CIN 是一门简洁的类 C 高级语言及其跨平台运行时（VM）。
 
 模块化包结构（`codecin/`，Go 侧 `codecin/native/`），全线日志与错误输出基于 **rich**（彩色表格、面板、traceback），`--debug` / `--log-level DEBUG` 提供超详细诊断。
 
-## v6.2.0 工具链：mkn / pic / cvm
+## v6.2.0+ 工具链：mkn / pic / cvm
 
 v6.2.0 在 `codecin` 之外提供三个独立命令，覆盖**构建 → 分发 → 运行**：
 
 | 命令 | 类比 | 作用 |
 |------|------|------|
 | `mkn` | Maven | 项目清单、标准目录、生命周期、依赖解析、打包与本地仓库 |
-| `pic` | pip | `package.codecin.org.cn` 中央注册/分发 + Cdifit 登录：发布登记标识名/Git 地址/版本列表/安全摘要并上传 `.cinpkg`，安装后可直接 `import` |
+| `pic` | pip | `package.codecin.org.cn` 中央注册/分发 + Cdifit 登录：发布登记标识名/Git 地址/版本列表/安全摘要并上传 `.cinpkg`，安装后可直接 `import`；支持搜索、版本管理与 `/admin` 后台 |
 | `cvm` | JVM | Code CIN 虚拟机：构建/校验/运行 `.cvm` 模块，支持模块路径；`CPU` 仅作为内部执行核 |
 
 ```bash
@@ -38,8 +38,14 @@ mkn package                     # target/demo-0.1.0.mkn
 pic login
 pic init hello
 pic publish --repo https://github.com/you/cin-hello --name hello
+pic install hello               # 不写版本 -> 最新版本
 pic install hello@^1.0          # 或 git+https://...、本地路径、.cinpkg
 pic install hello --project     # 安装到项目 pic_modules/，可直接 import
+pic search hello --json         # 搜索 (名称/描述/关键词, 分页/排序)
+pic versions hello              # 版本列表 (latest/yanked/installed)
+pic info hello                  # 包详情
+pic use hello 1.0.0             # 切换本地 current 版本
+pic admin                       # 后台管理页 (版本/撤回/删除/latest)
 pic whoami
 pic logout
 
@@ -55,15 +61,17 @@ cvm env
 登录和 Token 校验**。服务端实现见 [registry/README.md](registry/README.md)，
 客户端可用 `PIC_REGISTRY_URL` 覆盖服务器地址。
 
-安装后的包无需修改源码即可导入：
+安装后的包无需修改源码即可导入，并支持按模块/版本分块导入
+（不写版本时默认使用最高已安装版本）：
 
 ```cin
-import "hello"                  // 包入口 (pic.toml 的 entry)
-import "hello/util.cin"         // 包内文件
+import "hello"
+import "hello/util.cin"
+import "hello:*"               // 全部公开模块
+import "hello:util"            // 只导入 util 模块
+import "hello::1.0.0:*"        // 指定版本的全部公开模块
 ```
 
-完整设计、格式与验收标准见 [V6.2.0-PLAN.md](V6.2.0-PLAN.md)。
-
 ## 文档
 
 **官方文档站**位于独立仓库

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

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

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

@@ -19,6 +19,7 @@
   - 定长数组就地存放 (数据段/栈帧); int[][] 为指向行指针数组的指针。
 """
 
+import fnmatch
 import os
 import re
 import struct
@@ -656,7 +657,7 @@ def _package_roots(source_dir: str) -> List[str]:
         os.path.expanduser('~'), '.pic')
     packages = os.path.join(home, 'packages')
     if os.path.isdir(packages):
-        # 全局存储是 <name>/<version>/; 具体版本由解析器按 current 选择
+        # 全局存储是 <name>/<version>/; 默认选择最高已安装版本
         roots.append(packages)
     return roots
 
@@ -714,8 +715,27 @@ def _entry_from_package(pkg_dir: str, pkg: str,
     return None
 
 
-def _version_dirs(pkg_dir: str, root: str) -> List[str]:
-    """全局存储 ``<name>/<version>`` 下的版本目录 (current 优先)。"""
+def _semver_key(version: str) -> Tuple[int, int, int, int, str]:
+    """版本排序键: 稳定版高于同号预发布版。"""
+    base = version.split('+', 1)[0]
+    core, _, pre = base.partition('-')
+    parts = core.split('.')
+    out: List[int] = []
+    for index in range(3):
+        try:
+            out.append(int(parts[index]))
+        except (IndexError, ValueError):
+            out.append(0)
+    return out[0], out[1], out[2], 0 if pre else 1, pre
+
+
+def _version_dirs(pkg_dir: str) -> List[str]:
+    """全局存储 ``<name>/<version>`` 下的版本目录。
+
+    v6.4.x 起 **最高版本优先**：CIN 的 ``import "pkg"`` 默认使用最新
+    已安装版本，而不是 ``index.json`` 里的 ``current`` 指针（``current``
+    仍供 ``pic show`` / ``pic use`` 等本地命令使用）。
+    """
     try:
         versions = [
             v for v in os.listdir(pkg_dir)
@@ -724,28 +744,253 @@ def _version_dirs(pkg_dir: str, root: str) -> List[str]:
         ]
     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)
+    versions.sort(key=lambda value: (_semver_key(value), value), reverse=True)
     return [os.path.join(pkg_dir, v) for v in versions]
 
 
+#: 分块导入 ``pkg:*`` 时跳过的目录: 测试/示例/私有模块不参与通配
+_PACKAGE_WILDCARD_SKIP_DIRS = frozenset({
+    'internal', 'private', 'test', 'tests', '__tests__', 'demo', 'demos',
+    'example', 'examples', 'dist', 'build', 'target', 'node_modules',
+    '__pycache__', '.git', '.hg', '.svn', 'pic_modules', '.pic', '.mkn',
+})
+
+
+def _package_version(base: str) -> Optional[str]:
+    """读取包目录 ``pic.toml`` / ``mkn.toml`` 的版本; 非包目录返回 None。"""
+    if not os.path.isdir(base):
+        return None
+    try:
+        from .packaging.model import load_mkn_manifest, load_package_manifest
+        if os.path.isfile(os.path.join(base, 'pic.toml')):
+            return load_package_manifest(base, require_entry=False).version
+        if os.path.isfile(os.path.join(base, 'mkn.toml')):
+            return load_mkn_manifest(base).version
+    except Exception:  # noqa: BLE001 - 清单损坏时按"不是包"处理
+        return None
+    return None
+
+
+def _package_bases(pkg_dir: str) -> List[str]:
+    """一个包名目录下可用的包根 (项目目录本身 / 全局版本目录)。"""
+    bases: List[str] = []
+    if _package_version(pkg_dir) is not None:
+        bases.append(pkg_dir)
+    for version_dir in _version_dirs(pkg_dir):
+        if version_dir not in bases and _package_version(version_dir) is not None:
+            bases.append(version_dir)
+    return bases
+
+
+def _iter_package_cin_files(base: str) -> List[Tuple[str, str]]:
+    """返回包内全部 ``.cin`` (相对路径, 绝对路径), 按路径排序。"""
+    out: List[Tuple[str, str]] = []
+    for dirpath, dirnames, filenames in os.walk(base):
+        dirnames[:] = sorted(
+            d for d in dirnames
+            if d not in _PACKAGE_WILDCARD_SKIP_DIRS
+            and not d.startswith('.'))
+        for filename in sorted(filenames):
+            if not filename.endswith('.cin'):
+                continue
+            path = os.path.join(dirpath, filename)
+            rel = os.path.relpath(path, base).replace(os.sep, '/')
+            out.append((rel, path))
+    out.sort(key=lambda item: item[0])
+    return out
+
+
+def _module_defines_main(path: str) -> bool:
+    try:
+        with open(path, encoding='utf-8-sig', errors='replace') as f:
+            text = f.read(1 << 20)
+    except OSError:
+        return False
+    return re.search(r'\bfunction\s+main\s*\(', text) is not None
+
+
+def _module_is_internal(rel: str) -> bool:
+    lower = rel.lower()
+    return any(part in ('internal', 'private', 'test', 'tests', 'demo',
+                        'demos', 'example', 'examples')
+               for part in lower.split('/')[:-1])
+
+
+def _module_display(rel: str) -> str:
+    text = rel[:-4] if rel.endswith('.cin') else rel
+    return text[4:] if text.startswith('src/') else text
+
+
+def _available_modules(base: str) -> List[str]:
+    return [_module_display(rel) for rel, _path in _iter_package_cin_files(base)
+            if os.path.basename(rel) not in ('main.cin', 'test.cin')]
+
+
+def _match_module(base: str, selector: str) -> List[str]:
+    """把 ``table`` / ``internal/table.cin`` / ``table*`` 解析为包内文件。"""
+    files = _iter_package_cin_files(base)
+    if not files:
+        return []
+    selector = selector.strip().replace('\\', '/')
+    if not selector:
+        return []
+    want = selector if selector.endswith('.cin') else selector + '.cin'
+    has_glob = any(ch in selector for ch in '*?[')
+
+    if has_glob:
+        matches = []
+        for rel, path in files:
+            stem = rel[:-4] if rel.endswith('.cin') else rel
+            display = _module_display(rel)
+            if fnmatch.fnmatch(rel, want) or fnmatch.fnmatch(stem, selector) \
+                    or fnmatch.fnmatch(display, selector) \
+                    or fnmatch.fnmatch(os.path.basename(stem), selector):
+                matches.append((_module_is_internal(rel), len(rel), rel, path))
+        matches.sort()
+        return [path for _internal, _size, _rel, path in matches]
+
+    # 快路径: 常见位置直接命中
+    for rel in (want, 'src/' + want, 'src/internal/' + want,
+                'internal/' + want, 'lib/' + want):
+        path = os.path.normpath(os.path.join(base, rel))
+        if os.path.isfile(path):
+            return [path]
+
+    fuzzy = []
+    for rel, path in files:
+        stem = rel[:-4] if rel.endswith('.cin') else rel
+        display = _module_display(rel)
+        if rel == want or rel.endswith('/' + want) or stem == selector \
+                or display == selector or display.endswith('/' + selector) \
+                or (('/' not in selector)
+                    and os.path.basename(stem) == selector):
+            fuzzy.append((_module_is_internal(rel), len(rel), rel, path))
+    fuzzy.sort()
+    return [path for _internal, _size, _rel, path in fuzzy]
+
+
+class _PackageModuleNotFound(CompilerError):
+    def __init__(self, base: str, selector: str):
+        self.base = base
+        self.selector = selector
+        available = ', '.join(_available_modules(base)) or '(无)'
+        super().__init__(
+            f"Import module not found: {selector!r} in {base}; "
+            f"可用模块: {available}")
+
+
+def _path_is_internal(base: str, path: str) -> bool:
+    rel = os.path.relpath(path, base).replace(os.sep, '/')
+    return _module_is_internal(rel)
+
+
+def _package_chunks(base: str, pkg: str,
+                    spec) -> List[str]:
+    """按规格收集包内文件; ``*`` 返回入口 + 全部公开模块。"""
+    entry = _entry_from_package(base, pkg)
+    if not spec.has_selector:
+        if entry is None:
+            raise _PackageModuleNotFound(base, '(entry)')
+        return [entry]
+
+    if spec.is_all:
+        targets: List[str] = []
+        seen: Set[str] = set()
+
+        def add(path: str) -> None:
+            real = os.path.realpath(path)
+            if real not in seen:
+                seen.add(real)
+                targets.append(path)
+
+        if entry:
+            add(entry)
+        for rel, path in _iter_package_cin_files(base):
+            if _module_is_internal(rel):
+                continue
+            if os.path.basename(rel) in ('main.cin', 'test.cin'):
+                continue
+            if _module_defines_main(path):
+                continue
+            add(path)
+        if not targets and entry is None:
+            raise _PackageModuleNotFound(base, '*')
+        return targets
+
+    targets = []
+    seen = set()
+    needs_entry = False
+    for module in spec.modules:
+        matches = _match_module(base, module)
+        if not matches:
+            raise _PackageModuleNotFound(base, module)
+        if any(_path_is_internal(base, path) for path in matches):
+            # 私有模块可能依赖入口统一导入的内部符号 (如 rich 的
+            # internal/table.cin 使用 style.cin 的 rich_markup); 先展开
+            # 入口保证符号完整, 再由 loaded 去重。
+            needs_entry = True
+        for path in matches:
+            real = os.path.realpath(path)
+            if real not in seen:
+                seen.add(real)
+                targets.append(path)
+    if needs_entry and entry:
+        real = os.path.realpath(entry)
+        if real not in seen:
+            targets.insert(0, entry)
+    return targets
+
+
+def _resolve_package_chunks(spec, source_dir: str) -> Optional[List[str]]:
+    """按包规格解析 import; 没有同名包时返回 None。"""
+    found = False
+    version_mismatch: List[str] = []
+    module_errors: List[_PackageModuleNotFound] = []
+    for root in _package_roots(source_dir):
+        pkg_dir = os.path.join(root, spec.name)
+        if not os.path.isdir(pkg_dir):
+            continue
+        bases = _package_bases(pkg_dir)
+        if not bases:
+            continue
+        found = True
+        if spec.version:
+            matching = [base for base in bases
+                        if _package_version(base) == spec.version]
+            if not matching:
+                versions = sorted(
+                    (v for v in (_package_version(b) for b in bases) if v),
+                    reverse=True)
+                version_mismatch.append(
+                    f'{spec.name}: 已安装 {", ".join(versions) or "(未知)"}')
+                continue
+            bases = matching
+        for base in bases:
+            try:
+                return _package_chunks(base, spec.name, spec)
+            except _PackageModuleNotFound as e:
+                module_errors.append(e)
+
+    if not found:
+        return None
+    if version_mismatch and not module_errors:
+        detail = '; '.join(dict.fromkeys(version_mismatch))
+        raise CompilerError(
+            f"Import file not found: {spec.display!r} (已安装版本不匹配: "
+            f"{detail})。可运行 `pic install {spec.name}@{spec.version}` 安装该版本。")
+    if module_errors:
+        error = module_errors[0]
+        raise CompilerError(
+            f"Import file not found: {spec.display!r} ({error}); "
+            f"先运行 `pic install {spec.name}`，再用 `pic modules {spec.name}` "
+            f"查看可导入的模块。")
+    raise CompilerError(
+        f"Import file not found: {spec.display!r} (包目录存在但无法读取入口文件)")
+
+
 def _resolve_package_import(name: str,
                             source_dir: str) -> Optional[str]:
-    """按包名解析 import; 找不到返回 None。"""
+    """按包名/相对包内路径解析 import (旧写法); 找不到返回 None。"""
     normalized = name.replace('\\', '/')
     parts = [p for p in normalized.split('/') if p]
     if not parts:
@@ -765,7 +1010,7 @@ def _resolve_package_import(name: str,
         pkg_dir = os.path.join(root, pkg)
         if not os.path.isdir(pkg_dir):
             continue
-        version_dirs = _version_dirs(pkg_dir, root)
+        version_dirs = _version_dirs(pkg_dir)
         if sub:
             for base in [pkg_dir, os.path.join(pkg_dir, 'src'),
                          *(os.path.join(v, 'src') for v in version_dirs),
@@ -785,11 +1030,13 @@ def _resolve_package_import(name: str,
     return None
 
 
-def _resolve_import(name: str, source_dir: str) -> str:
-    """解析 import 目标路径。
+def _resolve_import(name: str, source_dir: str) -> List[str]:
+    """解析 import 目标 (可能多个文件, 用于分块导入)。
 
-    规则 (B3 + v6.2.0 包导入):
+    规则 (B3 + v6.2.x 包导入):
       * ``import "./x.cin"`` / ``import "../x.cin"`` —— 相对**当前 .cin 文件**所在目录;
+      * 包规格 ``rich`` / ``rich:*`` / ``rich:table`` / ``rich::1.1.1:*``
+        按模块分块解析 (见 :mod:`codecin.packaging.spec`);
       * 其余形式先查 **codecin 内置标准库** ``codecin/lib/`` (``lib/`` 前缀保留
         为兼容写法), 保持 "裸名字不会命中兄弟文件" 的既有语义;
       * 再查项目依赖目录 (``pic_modules`` / ``.mkn/deps`` / ``.pic/packages``)、
@@ -799,20 +1046,35 @@ def _resolve_import(name: str, source_dir: str) -> str:
     if _is_relative_import(name):
         cand = os.path.normpath(os.path.join(source_dir, name))
         if os.path.isfile(cand):
-            return cand
+            return [cand]
         raise CompilerError(
             f"Import file not found: {name!r} (相对引用, 已查找 {cand})")
 
+    if ':' in name:
+        from .packaging.spec import SpecError, parse_package_spec
+        try:
+            spec = parse_package_spec(name)
+        except SpecError:
+            spec = None
+        if spec is not None:
+            targets = _resolve_package_chunks(spec, source_dir)
+            if targets:
+                return targets
+            raise CompilerError(
+                f"Import file not found: {name!r} (未找到包 {spec.name!r})。"
+                f"先运行 `pic install {spec.name}`；指定版本用 "
+                f"`import \"{spec.name}::<版本>:*\"`。")
+
     candidates = [os.path.join(_LIB_DIR, name)]
     if name.startswith('lib/'):
         candidates.append(os.path.join(_LIB_DIR, name[len('lib/'):]))
     for cand in candidates:
         if os.path.isfile(cand):
-            return cand
+            return [cand]
 
     package = _resolve_package_import(name, source_dir)
     if package:
-        return package
+        return [package]
 
     raise CompilerError(
         f"Import file not found: {name!r} (内置标准库已查找 "
@@ -840,8 +1102,9 @@ def _collect_module_lines(path: str, loaded: set, active: set,
     for line in lines:
         m = _IMPORT_RE.match(line)
         if m:
-            target = _resolve_import(m.group(1), os.path.dirname(real))
-            _collect_module_lines(target, loaded, active, out)
+            targets = _resolve_import(m.group(1), os.path.dirname(real))
+            for target in targets:
+                _collect_module_lines(target, loaded, active, out)
             continue
         out.append((real, line))
     active.discard(real)