开始使用开始

来自 · TORCHSTELLAR

从一个产品想法
到能上线的项目。
一条命令开始。

让 AI 从标准工程底座开始开发：网站、后台、文档、环境配置和上线流程，一次准备好。

开始使用查看 GitHub

$curl -fsSL https://1cli.dev/install.sh | bash

开始方式

三种开始方式。

想最快开始，直接运行 one create；想先挑组合，去模板页；想让 AI 接手，可以把生成的 CLI 命令交给它执行。

方式一

直接运行 one create

适合先搭一个项目根目录。直接输入 one create，按提示填写目录和环境；之后再用 one add 继续添加网站、后台或文档。

可复制命令

$ one create

不需要先记参数

按提示填写目标目录和环境方式

创建后再用 one add 继续添加项目

查看 one create

方式二

去模板页选择

模板页已经按网站、后台、文档、移动端和桌面端整理好。选现成示例，或自定义组合，再复制生成的 One CLI 命令。

模板页入口

1cli.dev/zh/templates/

按产品类型浏览

现成示例和自定义组合都支持

复制命令后自己运行或交给 AI

进入模板页

方式三

交给 AI 执行

把目标和 One CLI 命令交给 Codex、Claude Code、Cursor 等 AI 编程工具；已有工作区先阅读 README 和 one.manifest.json。

给 agent 的一句话

请使用 One CLI，帮我创建一个名为 media-stack 的移动端项目，并安装依赖。

直接描述要做什么

AI 使用 One CLI 创建工作区或追加模板

按项目类型补依赖

查看 AI 指南

常用命令

把复杂建项目，拆成几步。

人可以直接输入命令，按提示选择；脚本和 AI 再补全模板名、项目名、--yes、-o json 这些明确参数。

one create one add one configure one templates one serve one help

one create

一条命令，
先把项目搭起来。

one create 可以直接运行进入向导，也可以带目录名和模板页生成的 --preset，一次生成网站、后台、文档或库。

交互创建直接输入 one create，会引导你填写目标目录和环境方式。

模板创建模板页会把选择结果转成 one create my-app --preset ...。

自动化模式CI 或 AI 使用 --yes 和 -o json，方便确认输出和错误。

查看 one create 去模板页选择one-cli/create

$one create

>打开创建向导

·填写目标目录和环境方式

·生成项目说明、自动化流程和本地启动入口

one add

项目已经有了，
也能继续加。

one add 只在已有 One 项目里使用。你可以直接输入 one add 进入交互式选择，也可以在脚本里写明模板名、项目名和部署方式。

交互添加直接输入 one add，会让你选择模板、项目名和可选部署方式。

自动化模式CI 或 AI 才需要写 one add nextjs-app --name web --yes。

同步默认值按模板生成项目代码，并登记本地开发命令。

查看 one addone-cli/add

$one add

>确认当前目录属于 One 项目

·打开模板和项目名选择器

·写入新目录并登记到项目清单

one configure

把密钥和上线信息，
放在安全位置。

one configure 保存本机要用的环境、部署和镜像账号。直接运行会进入配置向导；脚本里才需要写 env/infisical、deploy/*、container/docker 这些完整路径。

本机保存配置写到 ~/.config/one；密钥文件只有本人可读。

远程环境远程 env 指 Infisical 云服务或你自己的 Infisical；不需要额外启动 One CLI 服务。

后续复用one env、one run、one deploy 会自动读取当前配置。

查看 CLI 参考one-cli/configure

$one configure

>打开 env / deploy / container 配置向导

·保存本机配置档和凭据

·供 one env、one run、one deploy 后续读取

one templates

选一个起点，
不用猜模板名。

one templates 会在终端里列出当前内置模板清单，适合人先看有哪些后端、前端、文档、移动端、桌面端和库模板。

当前 10 个包含后端、前端、移动端、桌面端、文档和 TS / Go 库。

人类可读直接运行会显示模板名、分类和用途。

两种用途模板名给 one add 用；模板页组合给 one create 用。

查看 templates 打开模板页one-cli/templates

$one templates

>列出可以直接使用的模板

·显示模板 ID、分类和用途

·复制模板名给 one add 使用

one serve

用浏览器，
手动填写敏感配置。

one serve 启动只绑定 127.0.0.1 的本地配置页，用来编辑 one configure 管理的配置档。它适合让人手动录入密钥，避免把明文暴露给 agent 对话。

仅本机访问默认随机端口，只监听 loopback，不会直接暴露到局域网。

校验 Host拒绝未知 Host header，封住通向 loopback 的 DNS rebinding 路径。

远程机器在远端跑 one serve，再用 ssh -L 做端口转发访问。

查看 one serveone-cli/serve

$one serve

>打开本机浏览器里的配置页

·使用无需登录 token 的普通 loopback URL

·按 Ctrl-C 停止本地进程

one help

让 AI 助手，
找到正确的命令。

使用 one help --all 查看完整命令目录，再通过子命令的 --help 获取参数说明。AI 可以结合 README 和 one.manifest.json 里的项目事实选择操作。

完整目录列出当前版本支持的全部命令。

参数说明使用子命令的 --help 确认参数和用法。

结构化结果执行时使用 -o json，根据 error.code 处理失败。

查看命令参考one-cli/help

$one help --all

>查看当前版本支持的命令

·确认子命令参数

·结合项目说明选择操作

AGENT-READY WORKSPACE

让 agent 先读事实，再动项目。

One CLI 不是另一个聊天入口。它把 manifest、项目配置和结构化错误组织成一套工程契约，让 Codex、Claude Code、Cursor 这类 AI 编程工具能先确认项目事实，再选择命令、修改代码和处理失败。

命令帮助说明怎么操作

agent 通过 `one help --all` 和子命令的 `--help` 确认当前版本支持的命令、参数和用法，再执行工作区操作。

one help --all

Manifest 记录项目事实

`one.manifest.json` 记录项目、模板、toolchain 和环境边界。agent 先读这份事实，再决定进入哪个子项目、调用哪个命令。

one.manifest.json

项目说明由团队维护

One CLI 负责模板和 manifest。AGENTS.md、CLAUDE.md 等说明由团队自行维护，创建工作区和添加项目时都不会自动生成或修改。

AGENTS.md / CLAUDE.md

错误给出下一步

命令支持 JSON 输出，错误包含 `code`、`context` 和 `remediation[]`。agent 不需要解析自由文本，可以按结构化信息选择恢复动作。

error.remediation[]

所有命令都有下一步

命令没跑通，不用自己猜。

从创建、添加，到运行、上线，One CLI 遇到问题时都会先说明卡在哪里，再给你下一步可以做什么。新手能直接照着走，AI 工具也能接着处理。

创建项目

目录不对或目标已存在，会告诉你怎么继续

添加项目

模板、名称、位置不对，会给出修复命令

运行和上线

缺少配置或工具，会提示先补什么

接给 AI

同样结果可以输出 JSON，方便工具处理

>one add --name web --yes

未检测到 One CLI 项目，请在项目根目录执行。
  - 当前目录缺少 one.manifest.json；
    请先创建工作区，或 cd 到已有工作区：
    one create <dir>

这只是其中一个例子。创建、添加、运行、上线等命令遇到问题时，也会用同样的方式给出原因和下一步。

停止手工拼工程底座。

安装一个 Go 二进制，选择模板，把清晰的项目上下文交给人和 AI agent。

开始使用 GitHub

从一个产品想法到能上线的项目。一条命令开始。