USAGE.md

使用指南

快速开始

1. 启动应用

python run.py

2. 开始学习

输入任何Python相关问题，例如：

• "什么是变量？"
• "如何使用for循环？"
• "解释一下函数的概念"

命令参考

基本命令

命令	说明
/help	显示帮助信息
/quit 或 /exit	退出程序
/clear	清屏并重新显示欢迎信息

会话管理

命令	说明
/save	保存当前学习会话
/load <文件名>	加载历史会话
/history	显示最近10条对话历史

学习功能

命令	说明
/examples	显示Python代码示例
/topics	显示学习主题建议
/run <代码>	执行Python代码

学习主题

基础主题

• 🐍 Python基础语法
• 📊 数据类型和变量
• 🔄 控制流程（if/for/while）
• 🎯 函数和模块

进阶主题

• 📚 面向对象编程
• 🗂️ 文件操作
• 🌐 网络编程
• 📈 数据分析（pandas/numpy）

应用主题

• 🖼️ GUI编程（tkinter）
• 🕷️ 网页爬虫
• 🔧 自动化脚本
• 🎮 游戏开发

代码示例

变量和数据类型

name = 'Python'
age = 30
print(f'语言: {name}, 年龄: {age}年')

列表操作

fruits = ['苹果', '香蕉', '橙子']
fruits.append('葡萄')
print(fruits)

循环语句

for i in range(5):
    print(f'第{i+1}次循环')

函数定义

def greet(name):
    return f'你好, {name}!'

print(greet('Python学习者'))

字典操作

student = {'姓名': '小明', '年龄': 18, '成绩': 95}
print(student['姓名'])

使用技巧

1. 渐进式学习

• 从基础概念开始
• 逐步深入复杂主题
• 多动手实践

2. 有效提问

• 好的问题: "如何使用for循环遍历列表？"
• 更好的问题: "如何使用for循环遍历列表，并在遍历时修改列表元素？"

3. 代码实践

• 使用 /run 命令测试代码
• 尝试修改示例代码
• 解决实际问题

4. 会话管理

• 定期保存学习会话
• 回顾之前的对话历史
• 建立学习档案

故障排除

常见问题

Q: 程序启动失败 A: 检查是否设置了 MOONSHOT_API_KEY 环境变量

Q: 代码执行超时 A: 在配置文件中调整 code_timeout 参数

Q: 会话保存失败 A: 检查 sessions 目录是否存在写入权限

Q: 语法高亮异常 A: 确保终端支持ANSI颜色代码

获取帮助

1. 使用 /help 命令查看内置帮助
2. 查看项目文档
3. 提交Issue报告问题

最佳实践

学习建议

1. 循序渐进: 从基础开始，逐步深入
2. 多练习: 理论结合实践
3. 记录笔记: 保存重要的对话和代码
4. 定期复习: 回顾之前的学习内容

使用建议

1. 合理提问: 问题要具体明确
2. 主动实践: 多使用代码执行功能
3. 保存进度: 定期保存学习会话
4. 探索功能: 尝试所有可用命令