Skip to content

词汇表

从安装走到第一条消息需要的每个词——终端、npm、供应商、API key——都用不需要编程背景的话讲一遍,按出现顺序分组。

这一页只做一件事:把走完「从安装到第一条消息」会用到的每个词,用不需要编程背景的话讲一遍。按出现顺序分三组。遇到不认识的词回到这里查,查完接着走。

装之前

终端

那个靠打字对话的窗口:macOS 上叫「终端」(聚焦搜索里输“终端”就能打开),Windows 上是 PowerShell(开始菜单搜 PowerShell),Linux 上你大概率已经有了。Cetas 平时就住在里面。

Node.js

让 Cetas 跑起来的运行时 —— 可以理解成“引擎”。版本要 24 或更高;没装过就去 nodejs.org 下载 LTS 版本,一路下一步。装完 Node.js,npm 命令也就有了。

npm

Node.js 自带的包管理器,角色类似手机上的应用商店,只是装的是开发者工具。npm install -g @posoco/cetas 的意思就是:从这个商店把 Cetas 装成全机可用。

项目目录(工作区)

你打算让 Cetas 干活的那一个文件夹。它读文件、改文件、执行命令,都只发生在这个文件夹里 —— 所以启动前要先进入它。没有现成的项目,新建一个空文件夹也完全可以。

仓库

受版本管理(通常是 git)的代码或文档目录。如果你还没有仓库,忽略这个词:空文件夹一样能开始。

模型与供应商

供应商(Provider)

给你提供模型的公司,比如 DeepSeek、OpenAI、Kimi。Cetas 本身不带模型,它调用你选的供应商。第一次用,需要去其中一家注册账号。

API key

供应商发给你的一串字符,相当于「钥匙 + 账号」:证明这些调用是你发起的,费用记在你的账上。在供应商网站的「API Keys」页面创建。Cetas 只把它存到你自己的电脑上。

OAuth

另一种登录方式:不用复制 key,点一下浏览器登录,供应商直接把凭据交给 Cetas。/login 里出现“用浏览器打开”选项的就是它。

模型

供应商提供的那个“大脑”,比如 deepseek/deepseek-flash。同一家供应商通常有多个模型,能力和价格不同,/model 负责挑。

推理档位(effort)

同一个模型“想多深”的档位:越高越聪明,也越慢、越贵。

决策模型

一个独立的小模型,专门服务“做判断”的场合(比如权限闸门),和对话用的模型分开记账。第一次用可以完全不管它。

token 与上下文

模型按 token 计量和计费,大约一个汉字或小半个英文单词。上下文是一次会话里模型能“看见”的全部内容,超了会自动压缩,不用你管。

用的时候

权限姿态

会话级的安全开关,决定 agent 动手前要不要问你:readonly 只准看、workspace_write 写之前要确认、interactive / auto / yolo 逐步放手。第一天用 workspace_write 就好,见权限。

会话

你和 agent 的一次完整对话,自动记录在 <CETAS_HOME>/.cetas/sessions/ 下。/sessions 重开一段旧对话,/rewind 把它退回到出错之前 —— 不需要“保存”。

斜杠命令

以 / 开头的命令(/login、/model、/help)。它们立即执行,不经过模型,是确定性操作。

Cetas home(<CETAS_HOME>/.cetas)

所有持久状态的唯一目录:配置、凭据、会话、缓存全在这。<CETAS_HOME> 指你的用户目录——Windows 上是 %USERPROFILE%,macOS 和 Linux 上是 /Users/你 或 /home/你;环境变量 CETAS_HOME 非空时换到别处。备份 = 复制这个目录,见 Cetas Home。

MCP

把外部工具服务器(数据库、工单系统、内部 API)接进 agent 的协议,配置放 mcp.json。第一天不需要,见 MCP。

ACP

Agent Client Protocol —— 编辑器(比如 Zed)和 agent 之间的对话协议。想在编辑器里用 Cetas 时才需要,见编辑器。

技能(Skill)

一个带 SKILL.md 的文件夹,装着“某类活怎么干”的指令,任务需要时才加载,见技能。

子代理

主会话派出去干一件有边界工作的子 agent,工具和权限可以比主会话更窄 —— 比如“只读评审”,见子代理。

Navigation

Type to search…

↑↓ navigate↵ selectEsc close