# 基石语言（jishi）

> 一门像 Python 一样简单易用的中文编程语言：中文关键字、中文报错、三执行器（树遍历 / Python VM / C VM）语义一致。

## 文档

- [概览](README.html)：项目概览、能力清单、架构、环境与测试
- [语言规格](docs/语言规格.html)：完整语法与语义规范（关键字/语句/表达式/标准库/报错）
- [设计决策](docs/设计决策.html)：关键设计权衡与踩坑记录
- [调试器](docs/调试器.html)：调试器用法与命令表：断点 / 单步 / 变量 / 调用栈（含已知边界）
- [工具链（LSP/REPL/格式化）](docs/工具链.html)：LSP 增量同步 / REPL 增强 / 格式化器的实测数据与已知边界
- [真实项目与行数比](docs/真实项目.html)：五类真实项目 + 行数比基线（口径、逐项数据）+ 别扭点清单
- [AI 系统提示词](docs/ai/system-prompt.html)：教 LLM 写基石的官方系统提示词
- [AI 提示词指南](docs/ai/prompt-guide.html)：AI
- [few-shot 示例库](examples/ai/few-shot.html)：20 个「任务描述 → 基石代码」few-shot 示例对
- [01 你好基石](docs/tutorial/01_你好基石.html)：教程章节
- [02 数与文本](docs/tutorial/02_数与文本.html)：教程章节
- [03 判断与循环](docs/tutorial/03_判断与循环.html)：教程章节
- [04 函数](docs/tutorial/04_函数.html)：教程章节
- [05 字典与结构化数据](docs/tutorial/05_字典与结构化数据.html)：教程章节
- [06 文件与标准库](docs/tutorial/06_文件与标准库.html)：教程章节
- [07 综合实战](docs/tutorial/07_综合实战.html)：教程章节
- [版本历史 · 说明](docs/版本历史/README.html)：归档区索引：为什么有这一块、判断「现在」该看哪几处
- [里程碑 · 0.1.x](docs/版本历史/里程碑.html)：0.1.x 逐里程碑明细（M0–M45）：每一版做了什么、踩了什么坑
- [里程碑 · 0.2.x（含 R 线）](docs/版本历史/里程碑-0.2.html)：0.2.x 逐轮明细（M46–M56 + R 线）：反向时间序
- [R 线交付记录](docs/版本历史/R线交付记录.html)：R0–R8.5 的交付记录：前端换 Rust、单二进制、wasm、退役 Python/Node
- [任务与状态（历史）](docs/版本历史/AGENTS当前任务与状态-历史明细.html)：AGENTS §3 的历史明细（已从主线文档搬出）