# 奇语 Qi (qilang)

> 100% 中文关键字、编译到 LLVM 原生码的系统级编程语言。语法类似 Rust/Go 的中文化版本。官网 https://qilang-project.github.io/

## 骨架
包 主程序;
导入 标准库.输入输出 作为 IO;
函数 入口() { IO.打印行("你好"); }

## 关键规则
- 入口函数必须叫 入口。打印用 IO.打印行 / IO.打印。
- 保留字不能当变量名：结果 类型 选项 通道 尝试 返回 等待 异步 新建 选择 情况 在 作为 未来 继续 跳出 捕获 抛出 最终。要用改名如 结果值。
- 整数 = i64（不是 i32）。布尔字面量 真/假。
- 方法 Go 风格：函数 (自己 类型) 方法名(...) { }。
- 读取文件失败返回空串（不是 NULL），用 字符串::字节长度(x)==0 判失败；写入文件 1=成功。
- HTTP 模块大写：标准库.HTTP。
- 跨包 destructure 导入：导入 Web::{创建应用, 启动}。不支持 Web::函数()。
- 端口用随机高位 3076/6759/43510，不要 8080/3000。

## 类型
整数(i64) 浮点数(f64) 布尔(真/假) 字符串 字节 短整数 空

## 控制流
如果(cond){...}否则{...} | 当(cond){...} | 对于 i 在 0..10{...} | 匹配 v { 1=>..., _=>... }

## 异步
函数 双(v: 整数) : 未来<整数> { 返回 v*2; }  变量 r: 整数 = 等待 双(21);

## 框架
qi-web（Web，~122k RPS）: 导入 Web::{创建应用,配置,获取,文本,运行应用}; handler=函数(上下文):响应
qi-cli（Cobra 风格）: 导入 CLI::{创建应用,创建命令,执行}; handler=函数(上下文):整数
qi-harness（LLM agent）: 导入 Harness::{大模型,开启会话,创建代理,简单问,关闭代理}

## Agent skills
npx skills add https://github.com/qilang-project/qi-lang  (基础语言)
各框架仓库根目录有 SKILL.md。

## 命令
qi check 文件.qi (查语法) | qi run 文件.qi (运行) | qi compile 文件.qi -o out