来自 · TORCHSTELLAR

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

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

开始使用查看 GitHub

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

开始方式

三种开始方式。

想最快开始，直接运行 one create；想先挑组合，去模板页；想让 AI 接手，就先安装官方规则。

方式一

直接运行 one create

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

可复制命令

$ one create

不需要先记参数

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

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

查看 one create

方式二

去模板页选择

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

模板页入口

1cli.dev/zh/templates/

按产品类型浏览

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

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

进入模板页

方式三

交给 AI 执行

先运行 one skills install，把 One CLI 的规则装进 Codex、Claude Code、Cursor 等本地 AI 编程工具。

给 agent 的一句话

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

直接描述要做什么

AI 按 One CLI 规则创建或迁移项目

按项目类型补依赖

查看 AI 指南

常用命令

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

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

one create one add one configure one templates one serve one skills

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。

同步默认值会按模板补齐运行、部署和 AI 说明文件。

查看 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 对话。

仅本机访问默认随机端口，只允许本机浏览器访问，不会直接暴露到局域网。

一次性 token启动时打印带 token 的 URL，进程退出后旧链接失效。

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

查看 one serveone-cli/serve

$one serve

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

·URL 自带一次性访问 token

·按 Ctrl-C 退出，旧链接失效

one skills

让 AI 助手，
知道项目怎么做。

one skills install 会把 One CLI 自带的工作流安装或刷新到本机 AI 编程工具里。AI 先读项目说明，再按场景新建、追加、迁移或补依赖。直接运行会让你选择目标；--yes 才会安装到所有检测到的工具。

创建或迁移按你的描述新建项目，或把已有项目纳入 One CLI 管理。

可交互选择直接运行会让你选择 AI 工具；--yes 会安装到检测到的所有工具。

自动补依赖按项目类型处理依赖：JS/TS 看包管理器，Go 看各子项目。

查看 AI 指南one-cli/skills

$one skills install

>检测本机 AI 编程工具

·选择要安装到哪些工具

·同步命令、模板和依赖规则

AGENT-READY WORKSPACE

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

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

Skills 说明怎么操作

`one skills install` 把 One CLI 的工作流安装到本机 AI 编程工具。agent 可以按说明创建 workspace、追加模板、迁移项目或补齐依赖，而不是每次从 prompt 里猜流程。

one skills install

Manifest 记录项目事实

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

one.manifest.json

AI 指南跟着模板更新

成功执行 `one add` 后，One CLI 会生成或更新 `AGENTS.md` / `CLAUDE.md` 的受管理内容块，把模板的工程规则写进 workspace；已有自定义内容不会被强行覆盖。

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

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