添加你的第一个项目

将你的代码文件夹导入 1DevTool,60 秒内开始工作。

在打开终端或运行 AI agent 之前,你需要先添加一个项目。项目会告诉 1DevTool 你正在处理哪个文件夹,这样它就能在正确的目录下打开你的 AI 终端、记住你的数据库连接,并把所有工具整齐地集中在一处。

什么是项目?

在 1DevTool 中,“项目”就是一个代码文件夹——可以是你的 Git 仓库,也可以是你本机(或远程服务器)上任何想要处理的文件夹。

每个项目在 1DevTool 中都有自己独立的空间,包括:

  • 颜色标记:在侧边栏中一眼就能认出它,当你同时打开多个项目时尤其有用
  • 保存状态的终端:终端会话在重启之间会被保留,因此不会丢失上下文
  • 数据库连接:每个项目都有自己的数据库列表,不会误把某个数据库连到错误的应用
  • 已打开的文件:关闭 1DevTool 时打开的文件,再次回来时依然在原处
  • HTTP 请求:保存的 API 请求只属于它所在的项目

你可以添加任意数量的项目,切换也是即时的——只需点击左侧边栏即可。

添加本地文件夹

这是最常见的起点。如果你的电脑上已经有一个代码文件夹:

  1. 点击左侧边栏底部的 + 按钮。你也可以在 Mac 上按 Cmd+N,在 Windows 上按 Ctrl+N。
  2. 弹出对话框后,点击 “Open Folder”。
  3. 在文件选择器中找到你的项目文件夹,然后点击 Open。
  4. 为项目命名。默认使用文件夹名称,通常就很合适。
  5. 选择一个颜色标记。该颜色会以小徽标的形式显示在侧边栏的项目旁边,方便你一眼区分不同项目。你可以随时更改。
  6. 点击 Add Project。

项目现在已出现在侧边栏中,点击它即可打开。

1DevTool 侧边栏中按颜色区分的项目

从 Git 克隆

如果你的项目托管在 GitHub、GitLab、Bitbucket 或其他任何 Git 平台上,可以直接在 1DevTool 中克隆——无需另外打开终端。

“克隆”指的是把远程仓库下载一份副本到你的电脑上。如果你以前没做过,1DevTool 会让它变得很简单:

  1. 点击侧边栏中的 + 按钮。
  2. 选择 “Clone from Git”。
  3. 粘贴你的仓库 URL。这就是 GitHub 上“Clone”按钮提供的 URL,形如 https://github.com/yourname/your-repo.git。
  4. 选择克隆后的文件夹在本机上的保存位置,例如 ~/Code/ 或 ~/Projects/ 都不错。
  5. 点击 Clone。

1DevTool 会下载该仓库,并自动将其添加为项目。你可以实时看到进度。完成后,就可以打开终端了。

注意: 克隆需要你的机器上已安装 Git。大多数电脑都已自带。你可以打开任意终端并运行 git --version 来检查,如果能看到版本号,就没问题。

Clone from Git 对话框

通过 SSH 添加远程服务器

如果你在远程服务器上开发——比如 VPS、DigitalOcean 或 AWS 上的云主机,或者远程工作站——也可以把它添加为项目。

1DevTool 通过 SSH(访问远程机器的标准安全方式)进行连接。连接成功后,你的远程文件夹用起来就和本地项目一样。

  1. 点击 + → “Add via SSH”。
  2. 填写服务器信息:
    • Host:服务器的 IP 地址或域名,例如 123.45.67.89 或 myserver.com
    • User:你在服务器上的用户名,例如 ubuntu 或 root
    • Port:通常是 22。只有在服务器使用非标准端口时才需要修改。
    • SSH Key:私钥文件的路径,例如 ~/.ssh/id_rsa。如果你使用密码登录,请留空,系统会提示你输入。
  3. 点击 Connect。

1DevTool 会连接到服务器,并允许你浏览远程文件系统。选择一个文件夹作为你的项目,它就会出现在侧边栏中。终端、数据库客户端和文件编辑器都能正常使用——只不过它们运行在远程机器上,而不是本地。

通过 SSH 添加项目

下一步

项目已就绪,现在该在其中打开一个 AI agent 了。

继续阅读 添加你的第一个 AI Agent →