@crvouga/personal

中文文档
0.1.17发布于 2026/11/10UNLICENSEDES Module构建来源已验证近 30 天下载 2452

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

中文使用文档
文档目录5 节
  1. 舰队
  2. T3 电话
  3. 基础设施和工作站
  4. 对于特工
  5. 发展和发行

个人CLI

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

前缀范围需要离职
fleet-*开发者计算机:状态、发现、同步、修理、名册仅供修理
t3-*在此机器上声明的 T3 提供者实例没有
infra-*平台操作:健康,域,断层,CLIProxy,密码对
workstation这台机器的工具、代理简介和发射器对
commands指挥目录加代理人使用/安全合同没有
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 永远不要迅速。 在自动化中刻出精确的版本 .

舰队

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 管理只管理器的调度 。 读取 管理器运行本; 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 电话

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.

基础设施和工作站

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 变动 只输出格式.

发展和发行

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 打印,所以一个已报告的问题可以匹配到准确的 建设。 见 释放 证书 源头、先推出的靴子、包装的消费者验证和回收.

版本与发布记录

@crvouga/personal 共发布 19 个版本,首次发布于 2026/11/04;过去 12 个月发布了 19 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.1.17latest2026/11/101 天前
0.1.162026/11/101 天前
0.1.152026/11/101 天前
0.1.142026/11/101 天前
0.1.132026/11/101 天前
0.1.122026/11/092 天前

关于 @crvouga/personal 的常见问题

@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 和提交记录判断。