From 1e514e663139c05e216286fd99ff0f89717c74ec Mon Sep 17 00:00:00 2001 From: liuyh Date: Wed, 4 Feb 2026 15:37:48 +0800 Subject: [PATCH] =?UTF-8?q?=E5=A2=9E=E5=8A=A0quickstart.md=20Hair=20Keeper?= =?UTF-8?q?=E5=BC=80=E5=8F=91=E5=AE=B9=E5=99=A8=E4=BD=BF=E7=94=A8=E5=B8=AE?= =?UTF-8?q?=E5=8A=A9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .cloud-dev/Dockerfile | 1 + quickstart.md | 48 +++++++++++++++++++++++++++++++++++++++---- 2 files changed, 45 insertions(+), 4 deletions(-) diff --git a/.cloud-dev/Dockerfile b/.cloud-dev/Dockerfile index 59c1c41..6466ac2 100644 --- a/.cloud-dev/Dockerfile +++ b/.cloud-dev/Dockerfile @@ -45,6 +45,7 @@ RUN apt-get update && apt-get install -y \ telnet \ redis-tools \ iputils-ping \ + dnsutils \ potrace \ imagemagick \ zsh \ diff --git a/quickstart.md b/quickstart.md index 9225334..469c570 100644 --- a/quickstart.md +++ b/quickstart.md @@ -1,4 +1,44 @@ -## Claude Code编程工具常见用法 -常见指令和操作： -- `/ide`：与当前终端所在的ide集成，比如说与code server集成，那么claude code会在code server中展示要修改的文件内容，你在code server中选中的代码也会自动发送给claude code -- 按`Tab`键来切换思考模式，默认是打开的，但是一般复杂任务才打开思考模式，所以请关闭思考模式，关闭的时候终端右下角会有提示`Thinking off (tab to toggle)` \ No newline at end of file +# 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提供的数据库管理工具）： + +```bash +pnpm prisma studio --port 5555 # 在容器中执行 +ssh -N -L 5555:127.0.0.1:5555 root@cloud.liuyh.com -p # 在本地主机中执行，然后输入您开发环节的密码 +``` +然后您可以在本地输入 [http://localhost:5555/](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` 将代码同步到远程仓库，避免代码丢失。 +