# @callimacus/auth 中文文档

规范地址：https://npmcn.com/package/%40callimacus/auth/

版本：1\.8\.4
npm 元数据更新时间：2026-11-08T20:29:48.943Z
中文译文更新时间：2026-11-09T00:22:07.950Z
软件包许可：UNLICENSED

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40callimacus/auth
原文对照：https://npmcn.com/package/%40callimacus/auth/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：62.6 kB，20 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24\.0\.0
- 运行依赖：3 个
- 首次发布：2026-09-29T08:40:26.177Z
- 最新版本发布：2026-11-08T20:29:48.792Z
- 近 30 天下载量：2099（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：18（近 12 个月 18 个）

## 中文简介

Callimacus的公开靴子: `callimacus login` 配置私有的 SDK 注册(.npmrc) + API 访问。 完整的工具是私人的@callimacus/callimacus-cli.

## 安装

```sh
npm install @callimacus/auth
```

也可以使用：`pnpm add @callimacus/auth`、`yarn add @callimacus/auth`、`bun add @callimacus/auth`

## README

# @callimacus/auth (英语)

这个 **公开** callimacus的靴子 一个 `callimacus login` 配置所有东西 开发者需要在 Callimacus: 私人 SDK 下载(`~/.npmrc`(中文(简体) ) **财务报告和审定财务报表** API访问——前作设置为零.

这个包是故意小的,公开的,所以新客户端可以在他们运行之前运行它 有全权证书。 完整的操作员/租户配置 CLI 是 **私营** `@callimacus/callimacus-cli`,仅可安装 _之后_ 登录配置注册.

```sh
npx @callimacus/auth login
```

偏爱 `npx`此套件和 `@callimacus/callimacus-cli` 安装二进制 名称 `callimacus`,这样,全球安装这个可以赢得 `$PATH` 种族和民族 阴影整个工具。 由于1.2.0 完整的CLI 上载这些相同的命令,所以一次 它已经安装, 您不需要在 `$PATH` 完全没有.. `callimacus login` 无论是从工作.

**要求节点.js ~ 24(活动 LTS).** 支持的节点行为当前 LTS和较新的。 硬技术层为22.12.0- `commander` v15 仅为无害环境管理 ,然后通过 `require(esm)`,节点只支持从22.12.0 on-但 22号节点在维护中,不是被支持的目标.

## 首发

```sh
npx @callimacus/auth login          # sign in on the hosted page → writes ~/.npmrc + the API profile
npm i -g @callimacus/callimacus-cli # now installs (private, via the configured registry)
callimacus login                    # the full tool carries these commands too, from 1.2.0
callimacus configure …              # …alongside everything else
```

`login` 以和工作室相同的身份——密码,魔法密码或SSO——签入 在主机 WorkOS 的登录页面上: 它打印一个 URL + 短码并打开您的浏览器 (倒回"在无头盒上贴上这个URL"). 每个项目都有一个签名 你属于,每个人都会得到一个简介`--project <id>`,可重复,缩小. 从1.7.0开始,登录本身被保留下来——每个项目都不铸造密钥,而且一个项目是 输入命令第一次需要它。 这个 **登记标志** 转到用户级别 `~/.npmrc`; 数据 **第二届会议** (你的活页刷新) a) 每个主机存储一次 `~/.callimacus/config.json`,每个项目的概况 选一个没有秘密的.. _同一文件_ `@callimacus/callimacus-cli` 读,所以这个 一个登录也配置 CLI 。 每个命令向核心询问一个短命的访问符 用于项目`/cli/token`并缓存它,直到它活到现在, 与你在这个项目中的作用, 离开组织结束它。 会话持续时间 30天(闲了7天),那么 `login` 再次运行。 活动简介是第一个项目 选中( 已激活的在刷新时仍保持活动) ; `callimacus use <project>` 开关.

一个 **应用** 仍然需要自己的一对钥匙, 永远不要你的会话: `callimacus scaffold` 在其目录中将当前工程中的薄荷一并写入 `.env`浏览器应用程序 带 `callimacus scaffold --frontend`: 只有公用钥匙, 如 `VITE_CALLIMACUS_CLIENT_ID`, (中文(简体) ), 从来没有秘密。 CI 和 `callimacus configure` 继续像以前一样使用密钥对.

核心执行每个组织的每个项目的登录政策:一个需要特别业务干事或 您尚未完成的外交部注册、停放的租户或没有角色的成员 核心知道有原因 其他人仍然在陆地上 签名到项目 在工作室一次,然后运行 `login` 再来一次.

这需要一个Callimacus主机 在核心发布服务 `/cli/session`, (中文(简体) ), `/cli/credentials` 财务报告和审定财务报表 `/cli/token`; 在一个早于 `/cli/token`, (中文(简体) ), `login` 这么说的 财务报告和审定财务报表 `npx @callimacus/auth@1.6 login` 仍然是薄荷键对。 一个旧主机,或者一个没有启用的 CLI 签名,回答它 尚未配置 CLI 签名,并且 `login` 这么说的.

## 图标

| 命令 | 它会做什么 |
| --- | --- |
| `login [--project <id>]…` | 在主机 WorkOS 页面(passkey, magic code 或 SSO)上签名一次, 为您所属的每个项目保留会话( 或仅指名为 `--project`),并收到注册符. `--all` 是默认的,为脚本所接受。 或者,没有实现 从 `CALLIMACUS_NPM_TOKEN` 在中央情报局. |
| `scaffold [--profile <name>] [--frontend]` | 脚手架当前项目: `.npmrc` 范围图, `.env` API 密钥( 当您与会话一起签名时, 包含在应用程序中) , `.gitignore`。关键在于证书 `whoami` 显示( e)`--profile`,则 `CALLIMACUS_PROFILE`,然后是环境对,然后是活动剖面. `--frontend` 用于浏览器应用程序 : `.env` 只获得公钥,因为 `VITE_CALLIMACUS_CLIENT_ID`名称 `init` 1.2.0——由于完整的CLI有不相干的内容而重新命名 `init`,指挥官默默地隐藏了一个重复的名字. |
| `whoami [--profile <name>]` | 显示活动 profile + 项目(或命名的), **是否为 `~/.npmrc` 已配置**。 。 。 . |
| `use <project>` | 切换活动的项目配置 . |
| `logout [project]` | 删除每个配置文件、会话和注册行 `~/.npmrc`;或,与一个名为(或 `--profile <name>`),只有该简介,离开会话和 `~/.npmrc` 对其他人. |
| `setup-ci [--print]` | 配置来自 `CALLIMACUS_NPM_TOKEN` (写作) `~/.npmrc`,或用 `--print`) (中文(简体) ). |

## 中情局

拥有多个项目的开发者有一个注册符(机器级)和一个 届会。 在CI中,跳过浏览器:

```yaml
env:
  CALLIMACUS_NPM_TOKEN: ${{ secrets.CALLIMACUS_NPM_TOKEN }}   # the registry token
steps:
  - run: npx @callimacus/auth setup-ci   # writes ~/.npmrc headlessly
  - run: npm ci
```

## 配置

| 新闻 var | 默认 | 目的 |
| --- | --- | --- |
| `CALLIMACUS_API_URL` | `https://api.callimacus.ai` | API 主机( R)`/cli/config`, (中文(简体) ), `/cli/session`, (中文(简体) ), `/cli/credentials`) (中文(简体) ). 覆盖德夫. |
| `CALLIMACUS_REGISTRY_URL` | `https://npm.callimacus.ai` | 私人登记处 `.npmrc` 点数. |
| `CALLIMACUS_NPM_TOKEN` | —— 说 | 非交互式的登记符 `login`编号 :`setup-ci`。旧名称 `CALLIMACUS_TOKEN` 仍被接受(带有贬值警告). |

## 页:1

-   **配置接口**: 写 `~/.callimacus/config.json` 在精确的计策中 `@callimacus/callimacus-cli` (数量) `lib/config.ts`)读取,所以两人共享一个简介.
-   **SDK env var 名称**数字 : `scaffold` 写入 `CALLIMACUS_CLIENT_ID` 编号 : `CALLIMACUS_CLIENT_SECRET` 改为 `.env` ——当前名称为: `@callimacus/callimacus-sdk` 内存包装器读取 (单位:千美元)`CALLIMACUS_PUBLIC_KEY`编号 :`PRIVATE_KEY` 但SDK记录了贬值警告.
-   **没有本地解析器**: 纯节点+ `commander` 财务报告和审定财务报表 `@clack/prompts` (节点24LTS) `npm i -g` 编号 : `npx` 在视窗上的工作, Linux, macOS, 还有 WSL. `0600`编号 :`0700` 文件模式在 Unix 上执行; 在 Windows 上执行 没有 op 文件依赖用户扫描的配置文件目录( 姿态相同 ) `aws`编号 :`gcloud`编号 :`gh`) (中文(简体) ).

## 常见问题

### @callimacus/auth 是什么？

Callimacus的公开靴子: callimacus login 配置私有的 SDK 注册\(\.npmrc\) \+ API 访问。 完整的工具是私人的@callimacus/callimacus-cli\.

### 如何安装 @callimacus/auth？

在项目目录运行 npm install @callimacus/auth，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 callimacus，可以用 npx callimacus 直接运行。

### @callimacus/auth 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @callimacus/auth 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @callimacus/auth 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @callimacus/auth 可以商用吗？

@callimacus/auth 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### @callimacus/auth 的下载量有多少？

根据 npm 官方下载统计，@callimacus/auth 在 2026/10/09 – 2026/11/07 这 30 天内被下载 2,099 次，日均约 70 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @callimacus/auth 还在维护吗？

最新版本 1\.8\.4 发布于 2026/11/09（今天）；至今共发布 18 个版本，其中过去 12 个月发布了 18 个；首次发布于 2026/09/29。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。