stu-ai-demo/quickstart.md

Hair Keeper开发容器使用帮助

AI编程代理用法

命令行中：

• ccr code 打开一个新对话
• ccr code --resume 回到之前某个对话

对话中：

• ESC 连按2次可以查看和回溯到之前的某一轮对话
• alt+tab 切换模型是否打开思维链，默认是开启的，请关闭，因为思考模式很慢，只在极度复杂的任务时才打开
• \ 如果您的提示词过长，一行输入不下，可以在行末输入这个字符来换行
• @ 如果您需要引用项目中的文件，可以用这个符号
• /ide 输入这个命令，AI会和您的IDE进行联动，这样您在IDE中选中的代码会被自动发送给AI，AI在修改代码时也会在IDE中打开代码预览。

其他：

• CLAUDE.md 文件中的内容每次对话都会发送给AI，如果您有什么要强调的，可以写在这里面，您也可以输入/init 让AI自动扫描项目并编写CLAUDE.md，一般这里面写的都是项目的约定、编码习惯和开发目标。

项目与开发环境

常见命令：

• pnpm run dev 打开开发服务器
• pnpm run lint 检查代码中是否存在明显错误，建议每次AI进行了一次大修改，先用这个命令排查错误，有错误就粘贴给AI让它解决
• pnpm run build 构建和打包项目，耗时很长，如果AI尝试执行这个命令，阻止它并告诉它只需要执行pnpm run lint 排查错误
• pnpm prisma migrate dev --name add_some_tables 如果您对schema.prisma 进行了修改并希望修改能同步到数据库，执行这条命令，add_some_tables 请替换成能够描述您实际修改的标识符

访问容器内部服务（SSH转发）：

如果您是通过浏览器访问云开发容器，有时候可能需要访问云开发容器内部的本地服务，您可以通过SSH转发来实现。

例如我们可以通过这种方法来使用Prisma Studio（prisma提供的数据库管理工具）：

pnpm prisma studio --port 5555  # 在容器中执行
ssh -N -L 5555:127.0.0.1:5555 root@cloud.liuyh.com -p <Hair Keeper容器的SSH服务映射的外部端口>  # 在本地主机中执行，然后输入您开发环节的密码

然后您可以在本地输入 http://localhost:5555/ 访问容器内部运行的Prisma Studio。

虽然您访问的是本地地址，但是Prisma Studio服务是运行在远程服务器的容器中的，SSH则是连接两者的桥梁。

代码仓库快速入门

• git push origin main 推送本地代码到远程仓库，推送完成后您可以访问这个链接查看您的代码，也就是说您的代码在服务器上有了个备份，避免意外删除或丢失，通过远程仓库，您还可以与其他人合作开发一个项目，git能够解决代码的版本问题和不同成员修改的合并问题。

• git add -A && git commit -m "修改了xxx文件、新增了xxx功能" 在您对代码进行了一定的修改后，可以执行这条命令，相当于一个存档点，也便于您后续查看开发历史。在您进行了几次修改，准备结束今天的工作时，您可以执行git push origin main 将代码同步到远程仓库，避免代码丢失。