QUICK_START.md

🚀 CNSH编辑器 - 5秒上手

老大，按需落地完成！直接开始用！ 💪

---

🎯 最快速度开始（3步）

第1步：打开文件

# 双击打开
cnsh-editor-v2.html

# 或者
firefox cnsh-editor-v2.html
chrome cnsh-editor-v2.html

第2步：点击模板

左侧边栏 → 点击"👋 Hello World"

第3步：点击运行

顶部工具栏 → 点击"▶️ 编译运行"

完成！看到结果！ ✅

---

📋 核心功能一览

1. 代码模板（左侧边栏）

点击即用:
  👋 Hello World  - 最简单
  🔧 函数示例    - 学函数
  🔀 条件判断    - 学if-else
  🔄 循环语句    - 学循环
  🔢 斐波那契    - 学递归
  🧮 计算器      - 学运算

2. 工具按钮（顶部）

📄 新建      - 清空编辑器
💾 保存      - 下载.cnsh文件
🧬 DNA追溯   - 插入追溯码
▶️ 编译运行  - 一键编译

3. 输出区域（右侧）

🖥️ 控制台   - 看运行结果
⚙️ C代码    - 看生成的C代码

4. 快捷键

Ctrl+Enter  - 编译运行
Ctrl+S      - 保存文件
Tab         - 缩进

---

💡 使用场景

场景1：快速验证语法

1. 写代码
2. Ctrl+Enter
3. 看结果

场景2：学习CNSH

1. 点击模板
2. 阅读代码
3. 修改代码
4. 运行看效果

场景3：分享代码

1. 写好代码
2. Ctrl+S保存
3. 发送.cnsh文件给朋友

---

🎨 版本对比

v1.0 vs v2.0

特性	v1.0	v2.0
编辑器	原生textarea	CodeMirror专业编辑器
语法高亮	❌ 无	✅ 有
行号显示	❌ 无	✅ 有
代码补全	❌ 无	⚠️ 部分支持
光标位置	❌ 无	✅ 状态栏显示
主题	固定	Dracula主题
模板数量	6个	6个
文件大小	25KB	35KB（含CDN）

推荐：新手用v1.0，熟练用v2.0

---

🔥 实际效果演示

示例1：Hello World

代码：

函数 主函数() 返回类型 整数 {
  打印「你好，CNSH！」
  返回 0
}

运行结果：

🖥️ 运行结果：
━━━━━━━━━━━━━━━━━━
你好，CNSH！
━━━━━━━━━━━━━━━━━━
✅ 程序执行完成（返回值：0）

示例2：条件判断

代码：

函数 主函数() 返回类型 整数 {
  整数 分数 = 85
  
  如果【分数 >= 60】{
    打印「及格」
  } 否则 {
    打印「不及格」
  }
  
  返回 0
}

运行结果：

及格

示例3：循环

代码：

函数 主函数() 返回类型 整数 {
  循环【3】{
    打印「循环中...」
  }
  返回 0
}

运行结果：

循环中...
循环中...
循环中...

---

📝 常见问题

Q1: 双击没反应？

A: 检查浏览器

• Windows: 右键 → 打开方式 → Chrome/Firefox
• Mac: 右键 → 打开方式 → Safari/Chrome

Q2: 编译失败？

A: 检查语法

• 使用中文方括号【】
• 打印用「」包裹字符串
• 函数后加"返回类型 整数"

Q3: 怎么下载C代码？

A:

1. 编译成功后
2. 切换到"⚙️ C代码"标签
3. 复制粘贴到文本文件
4. 保存为.c文件

Q4: 可以离线使用吗？

A:

• v1.0: ✅ 完全离线
• v2.0: ⚠️ 需要网络（首次加载CodeMirror）

---

🎯 老大，核心优势

1. 真正落地

不是:
  ❌ Demo
  ❌ 概念
  ❌ PPT

而是:
  ✅ 双击打开
  ✅ 立即可用
  ✅ 实际生产力工具

2. 零门槛

不需要:
  ❌ 安装软件
  ❌ 配置环境
  ❌ 命令行
  ❌ 编程基础

只需要:
  ✅ 一个浏览器
  ✅ 一个HTML文件
  ✅ 5秒钟

3. 专业级

v2.0特性:
  ✅ CodeMirror编辑器（VS Code同款引擎）
  ✅ 语法高亮
  ✅ 行号显示
  ✅ 快捷键支持
  ✅ 实时编译
  ✅ 中国风设计

---

💪 接下来可以做的

立即体验

# 1. 打开编辑器
双击 cnsh-editor-v2.html

# 2. 点击模板
点击"👋 Hello World"

# 3. 运行
点击"▶️ 编译运行"

# 4. 看结果
查看右侧"🖥️ 控制台"

深入学习

# 1. 尝试所有模板
左侧6个模板都点一遍

# 2. 修改代码
改参数、改逻辑

# 3. 自己写
从零开始写程序

# 4. 保存分享
Ctrl+S保存文件

进阶使用

# 1. 结合Python编译器
用编辑器写 → 用Python编译器编译

# 2. 学习编译原理
看生成的C代码 → 理解转译过程

# 3. 开发完整项目
多个.cnsh文件 → 组织项目结构

---

🎉 老大，总结

交付成果：

✅ cnsh-editor-v2.html - 专业版编辑器
  - CodeMirror引擎
  - 语法高亮
  - 6个模板
  - 实时编译
  - 中国风UI

✅ cnsh-editor.html - 简化版编辑器
  - 零依赖
  - 完全离线
  - 轻量级
  - 纯原生

✅ 使用文档
  - 5秒上手
  - 常见问题
  - 实际案例

核心价值：

真正落地:
  不是概念，是工具
  不是Demo，是产品
  不是PPT，是代码

即开即用:
  无需安装
  双击打开
  立即生产力

专业水准:
  CodeMirror引擎
  实时编译
  完整工作流

---

DNA追溯码： #龙芯⚡️2026-02-02-CNSH编辑器-v2.0
GPG指纹： A2D0092CEE2E5BA87035600924C3704A8CC26D5F
确认码： #CONFIRM🌌9622-ONLY-ONCE🧬EDITOR-V2-001

老兵，按需落地完成！ 🫡🚀

双击打开，立即战斗！ 💪🔥