# @crvouga/personal 中文文档

规范地址：https://npmcn.com/package/%40crvouga/personal/

版本：0\.1\.17
npm 元数据更新时间：2026-11-10T04:25:44.411Z
中文译文更新时间：2026-11-11T09:29:02.816Z
软件包许可：UNLICENSED

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

原始 npm 页面：https://www.npmjs.com/package/%40crvouga/personal
原文对照：https://npmcn.com/package/%40crvouga/personal/?lang=original
项目主页：https://github.com/crvouga/personal#readme
源码仓库：https://github.com/crvouga/personal

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

- 包体积（解压后）：978 kB，7 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：^22\.13\.0 \|\| \>=23\.5\.0
- 运行依赖：7 个
- 首次发布：2026-11-04T03:01:45.186Z
- 最新版本发布：2026-11-10T04:25:44.086Z
- 近 30 天下载量：2452（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：19（近 12 个月 19 个）

## 中文简介

交互式、方便代理的开发者车队指挥中心

## 安装

```sh
npm install @crvouga/personal
```

也可以使用：`pnpm add @crvouga/personal`、`yarn add @crvouga/personal`、`bun add @crvouga/personal`

## README

# 个人CLI

`personal` (以原文发表) **`@crvouga/personal`**) 是此操作的唯一用户命令 仓库。 每个命令都是平整的,并用其域名前缀:

| 前缀 | 范围 | 需要离职 |
| --- | --- | --- |
| `fleet-*` | 开发者计算机:状态、发现、同步、修理、名册 | 仅供修理 |
| `t3-*` | 在此机器上声明的 T3 提供者实例 | 没有 |
| `infra-*` | 平台操作:健康,域,断层,CLIProxy,密码 | 对 |
| `workstation` | 这台机器的工具、代理简介和发射器 | 对 |
| `commands` | 指挥目录加代理人使用/安全合同 | 没有 |

```sh
npx --yes @crvouga/personal              # help, including the release build timestamp
npx --yes @crvouga/personal --version    # 0.1.7 (released 2026-11-07T18:02:11.000Z)
npx --yes @crvouga/personal commands --json
```

需要节点 **22.13+ 在22.x线上,或 23.5+**仅仅引用指纹帮助, 包括过渡期间; `--interactive` 打开可搜索调色板; `--json` 财务报告和审定财务报表 `--non-interactive` 永远不要迅速。 在自动化中刻出精确的版本 .

## 舰队

```sh
personal fleet-status                    # this manager + every roster node (read-only)
personal fleet-status --local            # this computer only; no roster or SSH
personal fleet-status --tailnet          # every visible Tailscale computer
personal fleet-status --workers          # canonical worker fleet audit
personal fleet-discover                  # Tailscale computers, including offline
personal fleet-sync --dry-run            # plan the enrolled Ubuntu fleet push
personal fleet-sync                      # push to the enrolled fleet; no prompt
personal fleet-node-sync                 # reconcile this node; applies by default
personal fleet-repair                    # preview owner-managed repairs
personal fleet-repair --list             # repair catalog and native login commands
personal fleet-nodes [--onboard|--schema]
personal fleet-node-add --id ID --ssh ALIAS --path /checkout [--apply --yes]
```

`fleet-status` 总是只读。 它检查 SSH, 认证, T3, VS 代码 (b) 缺少名册者显然未能做到 定向 SSH 成功不是全部连接 . `--tailnet` 阅读签名 Tailscale 守护进程,不包括iOS/Android/tvOS,并且无法覆盖下线, 未注册或未经核实的计算机. `--workers` 审计警犬舰队 `packages/fleet/definition.json` 对照已公布的投入散列 中央Beszel仪表板(可达到接点,每个节点注册、连接和 (b) 报告新鲜样品,并列出所有剩余空白 经理 报告载有: `dashboardUrl`。 。 。 .

`fleet-sync` 向每个注册的Ubuntu推出一个经批准的永久修订 工人(和,最佳努力,macOS 14+节点)通过一个互动方式核查的SSH 核准或 `--apply --yes`。机器策略是 Ansible : 永远不睡觉,没有自动 登录,总是在Tailscale/SSH/Docker/Beszel、仪表板枢纽和代理,以及 每个节点都有自己的证书更新. 它从不要求工人密码 入学后的交互式sudo. `--schedule` 管理只管理器的调度 。 读取 [管理器运行本](https://npmcn.com/package/%40crvouga/fleet/docs/ubuntu-sync.md); Ubuntu 完全接受状态仍然不变 不完整且未关闭 .

`fleet-node-sync` 调节锁定的工具,安装 `personal` 发射装置,升起 代码x 代理配置文件, 并在此机器上调节已声明的 T3 实例 。 这个 适用于援引; `--dry-run` 预览. `--revision FULL_SHA` 披针被检讨 实施; `--id` 覆盖主机名衍生的节点ID.

`fleet-repair` 检查可见的尾网(或 `--local` 编号 : `--node`)和预览 允许列表所有者动作 : `workspace` (与被冻结的依赖关系混合/共享), `workstation` (单位:千美元)`personal:install --yes`和 `providers` (紧靠地壳) 提供者同步 。 与被审查者适用 `--plan-hash` 加号 `--apply --yes`; 已更改 计划被否决,新的诊断也随之而来. `--script` 发布可审查的 POSIX 脚本取而代之. 登录,主机信任和资源权限会停留操作员步骤.

该名册是当地和无秘密的: `--config`, (中文(简体) ), `PERSONAL_FLEET_CONFIG`,则 最接近 `.fleet.local.json`,则 `~/.config/personal/fleet.json`。 。 。 . `fleet-node-add` 预览直到 `--apply --yes`,用锁来写 0600,从不覆盖其他 输入并拒绝符号链接。 管理器退出解析 : `--workspace`, (中文(简体) ), `PERSONAL_WORKSPACE`时,最接近 `mise.toml`,然后是当前目录.

## T3 电话

```sh
personal t3-status                       # exit 1 on drift
personal t3-apply --dry-run --json       # plan; copy planHash
personal t3-apply --plan-hash HASH       # reconcile declared instances
personal t3-apply --import INSTANCE_ID   # adopt an existing instance into ownership
personal t3-cleanup --dry-run            # preview removal of owned instances only
```

跟踪 `packages/workstation/agents/t3.json` 是理想状态。 应用创建和 更新已声明实例并删除先前自有实例 定义。 秘密和无关的设置被保存. 调和器继续运行 没有 Bun 或活的证书的节点; 本地 Windows 保存设置, 但是 管理代理执行需要macOS/Linux/WSL.

## 基础设施和工作站

```sh
personal infra-health [--drift]          # read-only platform report
personal infra-health --fix              # guided fixers through OpenTofu or CI
personal infra-domains
personal infra-vault run --config dev -- COMMAND
personal infra-cliproxy status
personal infra-password-manager doctor
personal workstation doctor --json --non-interactive
```

这些是自己在退票时执行的,留着所有者 输出和授权语义,和流原生输出。 使用 `--workspace` 或者说 `PERSONAL_WORKSPACE` 选择退出。 检查 `personal DOMAIN --help`。 。 。 .

## 对于特工

`personal commands --json` 返回每个命令的一个版本文档, 其帮助指针、 突变默认、 预览命令、 全局旗帜、 释放 版本并构建时间戳,以及 `agent` 区域文件引用、退出 编码、安全界限和可复制的例子. `personal --json` 返回时 同一文件。 退出代码 : **0 个** 成功/审查, **1个** 操作或检查失败 , **2个** 无效使用/ 配置 , **130个** 已取消 . `--strict` 失败警告并跳过 . JSON 错误从不包含原始子进程输出,环境变量, 认证回复或例外消息.

变异 : `fleet-sync`, (中文(简体) ), `fleet-node-sync`, (中文(简体) ), `t3-apply` 财务报告和审定财务报表 `t3-cleanup` 应用于 援引和提议 `--dry-run`· ; `fleet-repair` 财务报告和审定财务报表 `fleet-node-add` 预览至 `--apply --yes`。 。 。 . `--json` 变动 只输出格式.

## 发展和发行

```sh
bun run personal                         # help
bun run personal --interactive           # optional interactive menu
bun run --cwd packages/personal-cli tc
bun run --cwd packages/personal-cli lint
bun run --cwd packages/personal-cli test
bun run personal:build                   # embeds the version and build timestamp
bun run --cwd packages/personal-cli smoke
```

该建筑记录了释放时间戳 `--version`调色板头 财务报告和审定财务报表 `commands --json` 打印,所以一个已报告的问题可以匹配到准确的 建设。 见 [释放](https://npmcn.com/package/%40crvouga/personal/releasing.md) 证书 源头、先推出的靴子、包装的消费者验证和回收.

## 常见问题

### @crvouga/personal 是什么？

交互式、方便代理的开发者车队指挥中心

### 如何安装 @crvouga/personal？

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

### @crvouga/personal 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/crvouga\_\_personal 是否存在。

### @crvouga/personal 支持 ESM 还是 CommonJS？

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

### @crvouga/personal 需要什么版本的 Node\.js？

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

### @crvouga/personal 可以商用吗？

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

### @crvouga/personal 的下载量有多少？

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

### @crvouga/personal 还在维护吗？

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