Metadata-Version: 2.4
Name: cnsh
Version: 2.1.0
Summary: CNSH 中文原生脚本语言 · 运行时 + 多目标编译器 + 龍魂字体（Chinese Native Script for Harmony）
Author-email: "Zhuge Xin (UID9622)" <uid9622@longhun.system>
License: MulanPSL-2.0
Project-URL: Homepage, https://gitee.com/uid9622/cnsh
Project-URL: Repository, https://gitee.com/uid9622/cnsh
Keywords: CNSH,中文编程,chinese-programming,LongHun,龍魂
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Compilers
Classifier: Natural Language :: Chinese (Simplified)
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: web
Requires-Dist: fastapi; extra == "web"
Requires-Dist: uvicorn; extra == "web"
Dynamic: license-file

> DNA: #龍芯⚡️丙午·丁酉·乙未·亥时·䷏豫-CNSH-RELEASE-v2.1.0-UID9622
> 作者：诸葛鑫（UID9622 · 龍芯北辰） · 许可：工程层 MulanPSL v2 · 思想层 CC BY-NC-SA 4.0 · 字体 SIL OFL 1.1

# CNSH · 中文原生脚本语言（Chinese Native Script for Harmony）

用中文写程序。`你好，龍魂世界！` 不是口号，是 `cnsh run examples/hello.cnsh` 的真实输出。

## 30 秒上手

```bash
# 方式一：pip（推荐）
pip install cnsh
cnsh run examples/hello.cnsh

# 方式二：从 Gitee 源码
git clone https://gitee.com/uid9622/cnsh.git
cd cnsh
pip install .
cnsh run examples/hello.cnsh
```

## 怎么调用

安装后得到 `cnsh` 命令，六个子命令：

| 命令 | 作用 | 例子 |
|:---|:---|:---|
| `cnsh run <文件.cnsh>` | 解释执行 | `cnsh run examples/fib.cnsh` |
| `cnsh compile <文件> --target <语言>` | 编译成其他语言 | `cnsh compile fib.cnsh --target python -o fib.py` |
| `cnsh test` | 跑测试 | `cnsh test` |
| `cnsh init <项目名>` | 新建项目骨架 | `cnsh init 我的项目` |
| `cnsh publish` | 打包项目 | `cnsh publish` |
| `cnsh lsp` | 起编辑器语言服务 | `cnsh lsp` |

也可以不当命令用，当 Python 库调：

```python
from cnsh_v21 import toolchain   # 工具链入口
```

## 多目标编译 · 实测状态（2026-09-18 实机验证）

| 目标语言 | 状态 |
|:---|:---:|
| Python | ✅ 已验证 |
| JavaScript | ✅ 已验证 |
| Rust | ✅ 已验证 |
| C | ✅ 已验证 |
| C++ / Objective-C / Swift | 🟡 规划中（v3.0 交付） |

## 龍魂字体 LonghunFont（SIL OFL 1.1 开源）

`fonts/` 目录开箱即用：

| 文件 | 用途 |
|:---|:---|
| `LonghunFont-Regular.otf` / `.ttf` | 桌面安装（macOS 双击 / Windows 右键安装 / Linux 放 `~/.fonts` 后 `fc-cache`） |
| `LonghunFont-Regular.woff2` | 网页 `@font-face` |
| `LonghunFont-WuwuColor.otf` | 彩色字形版 |
| `LonghunFont.css` | 网页直接引入 |

网页用法：

```css
@font-face {
  font-family: 'LonghunFont';
  src: url('fonts/LonghunFont-Regular.woff2') format('woff2');
}
body { font-family: 'LonghunFont', sans-serif; }
```

详细安装说明见 [fonts/README.md](fonts/README.md)。

## 文档地图

- [docs/SPEC-v4.0 最新融合规范](docs/LH-CNSH-LANGUAGE-SPEC-v4.0.md)
- [docs/spec/](docs/spec/) — 完整规范 v2.0.0（入门 0-3 章 / 参考 4-8 章 / 审计 9-12 章 / Shell 13-16 章 / 附录 + BNF）
- [examples/](examples/) — 10 个 .cnsh 示例（hello / fib / 类型 / 异步 / 加密 / FFI…）

## 许可（三层，各归各）

- **工程层（代码）**：MulanPSL v2
- **思想层（规范文档）**：CC BY-NC-SA 4.0，禁止用于 AI 训练，引用请署名（见 ATTRIBUTION.md）
- **字体**：SIL OFL 1.1（fonts/OFL.txt）

## 支持这个项目（纯自愿 · 零黑箱）

觉得有用，可以请作者喝杯咖啡：

| SOL | Tron |
|:---:|:---:|
| ![SOL](assets/donate-solana.png) | ![Tron](assets/donate.png) |

---
*发行版本 v2.1.0 · 源自龍魂系统主仓（longhun-system）· GPG 签名链与完整审计轨迹在主仓保留*
