包与模块

标准库随 Ku 分发；自己的模块和第三方包通过 import 使用。当前没有官方托管的公共包目录，仓库内的 registry 是可自行部署的参考服务。

项目结构

hello/
  ku.mod
  src/
    main.ku
    util.ku

ku.mod:

name = "hello"
version = "0.1.0"
root = "src"
main = "main.ku"

src/util.ku:

fn Greeting(): str {
    return "Hello Ku"
}

src/main.ku:

import { Greeting } from "util"

fn main() {
    println(Greeting())
}

在项目目录执行 ku check、ku run，输出 Hello Ku。用户导出名以 ASCII 大写字母开头，小写名留在文件内部。

导入路径

写法	解析位置
"std.json"	随 Ku 分发的标准库
"util"	当前 package 的 root 目录
"./util.ku"	当前文件所在目录
"@math/vector"	已声明的 math 依赖内的模块

本地开发依赖通过 dep.name.source = "file://绝对路径" 固定来源；跨包依赖需在 ku.mod 声明，不能任意越过包根目录读取源码。

Registry 与 lock

registry 依赖需要明确的 HTTPS 地址与固定的 Ed25519 公钥。ku package resolve 更新求解与 lock；--locked 按已有 lock 解析，--offline 只使用本地缓存。ku package pack 生成包，publish / yank 会向配置的 registry 写入，需要相应凭据。

完整字段、版本范围与自托管接入见仓库Package 参考。不要把这里的本地示例视为已经部署公共包服务。