# @fluid-app/fluid-cli-genealogy 中文文档

规范地址：https://npmcn.com/package/%40fluid-app/fluid-cli-genealogy/

版本：0\.1\.674
npm 元数据更新时间：2026-11-15T00:20:07.326Z
中文译文更新时间：2026-11-15T01:37:20.551Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40fluid-app/fluid-cli-genealogy
原文对照：https://npmcn.com/package/%40fluid-app/fluid-cli-genealogy/?lang=original

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

- 包体积（解压后）：190 kB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24\.0\.0
- 运行依赖：3 个
- 首次发布：2026-10-10T04:42:02.802Z
- 最新版本发布：2026-11-15T00:20:07.147Z
- 近 30 天下载量：132670（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：676（近 12 个月 676 个）

## 中文简介

家谱树的流体CLI插件——父母、子女、腿、安置和移动

## 安装

```sh
npm install @fluid-app/fluid-cli-genealogy
```

也可以使用：`pnpm add @fluid-app/fluid-cli-genealogy`、`yarn add @fluid-app/fluid-cli-genealogy`、`bun add @fluid-app/fluid-cli-genealogy`

## README

# @fluid-app/fluid-cli-遗传学

家谱树的流体CLI插件:父母、子女、腿、安置和 移动,超过公司的分系 API(v2026-10).

```bash
npm install -g @fluid-app/fluid-cli @fluid-app/fluid-cli-genealogy
fluid login
fluid genealogy trees
fluid genealogy show --member <member-id>            # seat in the placement tree, with counts
fluid genealogy ancestors <node> --as-of 2026-09-01T00:00:00Z
fluid genealogy children <node> --limit 50           # prints next_cursor if more remain
fluid genealogy grandchildren <node>
fluid genealogy legs <node>                          # legs ranked by headcount
fluid genealogy strong-leg <node>
fluid genealogy tree <node> --depth 3                # indented text downline
fluid genealogy move <node> --to <parent> --dry-run  # preview only
fluid genealogy move <node> --to <parent> --yes
```

节点是一棵树上的成员座. 命令使用节点UUID,或 `--member <member-id>` 与 `--tree <key-or-id>` (默认) `placement`用于 那个成员的位置。 在树上没有座椅或数个座椅的委员是错误的.

读取: `show`, (中文(简体) ), `counts`, (中文(简体) ), `parent`, (中文(简体) ), `root`, (中文(简体) ), `ancestors`, (中文(简体) ), `sponsor`, (中文(简体) ), `enroller`, (中文(简体) ), `children`, (中文(简体) ), `siblings`, (中文(简体) ), `frontline`, (中文(简体) ), `personally-enrolled`, (中文(简体) ), `grandchildren`, (中文(简体) ), `level --depth N`, (中文(简体) ), `descendants --depth N`, (中文(简体) ), `subtree --depth N`, (中文(简体) ), `level-counts --depth N`, (中文(简体) ), `relation <node> <other> [--kind]`, (中文(简体) ), `placements`, (中文(简体) ), `holding-tank`, (中文(简体) ), `trees`更深的读取深度1 -7。 清单按每一页排列; `--limit` 上限总计和输出 `next_cursor` 恢复为 `--cursor`。 。 。 .

腿只用人头数来衡量:每条腿数孩子的座椅外加其座椅 `downline_count`API没有腿体积。 计数包括: 被抛弃的成员。 API没有每条腿的计数终点,所以 `legs`, (中文(简体) ), `strong-leg` 财务报告和审定财务报表 `weak-leg` 阅读每个直接孩子的计数 请求。 他们拒绝一个有200多个直系子女的节点;通过 `--limit <n>` 最多数 `n`. 儿童读出一个直接的孩子 他的会员被抛弃了 而节点自己的计数保留着它 没有 单读一个节点的孩子的计数,所以 `legs` 读取节点 计算,然后孩子和每个孩子的计算 两次,然后节点的计算 诵读的时候,才用它;不然,只用它 页:1 当节点的孩子比列出的多时,输出 携带 `unlisted` (单位:千美元)`children`, (中文(简体) ), `seats`, (中文(简体) ), `ranked`, (中文(简体) ), `unknown_empty_legs`A级 未列入名单的单身儿童按其确切大小和 `unlisted: true`,在 在只有一条腿的时候 留下了一条腿 未列出空名腿 无法从未列入名单的儿童的腿上得知. `strong-leg` 财务报告和审定财务报表 `weak-leg` 只在未列入名单的儿童无法改变时才命名一条腿;a 强壮的腿 拥有比他们都多的席位 仍然保持. 不然他们就回来了 `leg: null` 与 `best_listed`在列表中选择 脚.

读者需要公司管理 `members.view` (或遗产) `users.view`(三); 公司 API 令牌(`C-...`有了这个许可,也行。 正在命名一棵树 键,包括默认值 `placement`,检查它与 `GET /api/company/v2026-10/genealogy/tree-keys`,只列出每棵树的 编号、密钥和名称及需要相同 `members.view`没有它,关键是 在树的定义中抬头,需要 `developer.view`一个API 没有 `tree-keys` 端点(它回答404)倒回同样的方式. 仅 `fluid genealogy trees`,打印全部树定义,需要 `developer.view`,因为 这些定义包含公司配置. `legs` 读取一棵树的腿名 从这些定义中也:无 `developer.view` 它仍然排列 被占用的腿,但不能列出空的 命名腿,所以 `weak-leg` 返回时 `leg: null` 与 `best_listed` (一个看不见的空腿可能是弱者)和 报告载有 `leg_names_known: false`。 。 。 .

写作: `place`, (中文(简体) ), `move`, (中文(简体) ), `move-requests approve|reject`他们需要一个管理员 用户登录: 运行 `fluid login` 作为公司管理者 `members.manage` (计: `place` 财务报告和审定财务报表 `move`)或(或) `team_moves.approve` (计: `move-requests approve|reject`) (中文(简体) ). API 公司代号`C-...`)以403"A公司拒绝 需要管理员的身份..." 写入更改直播 他们要求证实,除非你经过 `--yes`。 。 。 . `move --validate` (或 `--dry-run`)不写预览. `move-requests list|show` 财务报告和审定财务报表 `move-jobs list|show` 读取移动收据.

树定义 : `trees create`, (中文(简体) ), `trees update <tree>` 财务报告和审定财务报表 `trees delete <tree>` (一键或UUID)写出公司的树登记. 他们需要一个管理员 登录到 `developer.update` (公司 API 令牌只有在它的作用下才能工作) 给予它。 每个可写字的字段都是一面旗帜: `--key`, (中文(简体) ), `--name`, (中文(简体) ), `--kind unilevel|binary|matrix`, (中文(简体) ), `--role`, (中文(简体) ), `--leg-names left,right`, (中文(简体) ), `--placement-rule`, (中文(简体) ), `--movement-approval immediate|require_approval`, (中文(简体) ), `--holding-tank-days`, (中文(简体) ), `--max-depth`, (中文(简体) ), `--max-movement-levels`, (中文(简体) ), `--movement-window-days`, (中文(简体) ), `--volume-on-move`, (中文(简体) ), `--volume-key`, (中文(简体) ), `--allow-multiple-positions true|false`, (中文(简体) ), `--authority authoritative|replica|unconfigured`, (中文(简体) ), `--owning-company-integration-id`, (中文(简体) ), `--upstream-tree-ref` 财务报告和审定财务报表 `--external-integration-market-id`· ; `none` 清除一个 无效的字段 。 创建需求 `--key`, (中文(简体) ), `--name`, (中文(简体) ), `--kind` 财务报告和审定财务报表 `--authority`· ; 二进制和矩阵树也需要 `--volume-on-move`二进制和矩阵树接受默认规则 `exact`, (中文(简体) ), `first_empty`, (中文(简体) ), `left`, (中文(简体) ), `right` 财务报告和审定财务报表 `defer`; 单层树 `exact`, (中文(简体) ), `under_enroller` 财务报告和审定财务报表 `mirror_enrollment` (其他规则因打出错误而被拒绝). `place --parent` 没有 `--leg` 也没有 `--rule` 使用树的默认规则。 只有权威 在二进制或矩阵树中放置也需要 企业的 `GENEALOGY_LEGGED_TREES` 旗帜。 更新只发送给定的旗帜, 时间 树的当前 `lock_version` 除非 `--lock-version` 披针 1; a 被占用的树只能重新命名 。 删除失败 `tree_has_nodes` 时 树占据任意位置,默认值 `enrollment` 财务报告和审定财务报表 `placement` 树 无法被删除。 每次写都显示请求并先问,除非 `--yes`· ; `--dry-run` 打印它,并发送什么.

```bash
fluid genealogy trees create --key team-binary --name "Team Binary" --kind binary \
  --authority authoritative --volume-on-move follows_structure --dry-run
fluid genealogy trees update team-binary --movement-approval require_approval --yes
fluid genealogy trees delete team-binary --yes
```

`trees mirror [tree]` (默认) `placement`倒灌放置树 从入学树 对于一个公司, 放置树用 `mirror_enrollment` 且无树荫;每个被派遣者 没有安放座椅 坐在他们报名的座位下 根 首先 不再匹配的无钉座椅 被重新命名 绑起 请坐 它有天分,需要管理员登录 `members.manage`成员写道:.

`--dry-run` 立即报告点数,不写字(最多5 000个) 入学席位)。 真正的运行先问 除非 `--yes`,然后队列 a 背景运行时没有座位限制并打印它( c)`mirror_run`附加时 `started: false` 当公司已经排队或运行时; 一次有一个. `--wait` 跟踪运行,打印进度行 每个读取在 stderr (每 `--interval` 秒,默认值 2,然后打印 如果完成运行,则退出非零 `failed` 或者说 `halted`停止 运行保留它写的批次; 运行镜像以完成 .

```bash
fluid genealogy trees mirror --dry-run
fluid genealogy trees mirror --yes --wait
fluid genealogy trees mirror-runs list --status running
fluid genealogy trees mirror-runs show <run-id>
```

每一个命令除了 `tree` 指纹 JSON。 打印 JSON 失败 `error` (与 API的软件 `type` 当有一个),在 stderr 并退出非零.

## 常见问题

### @fluid-app/fluid-cli-genealogy 是什么？

家谱树的流体CLI插件——父母、子女、腿、安置和移动

### 如何安装 @fluid-app/fluid-cli-genealogy？

在项目目录运行 npm install @fluid-app/fluid-cli-genealogy，或使用 pnpm add / yarn add / bun add。

### @fluid-app/fluid-cli-genealogy 支持 TypeScript 吗？

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

### @fluid-app/fluid-cli-genealogy 支持 ESM 还是 CommonJS？

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

### @fluid-app/fluid-cli-genealogy 需要什么版本的 Node\.js？

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

### @fluid-app/fluid-cli-genealogy 可以商用吗？

@fluid-app/fluid-cli-genealogy 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @fluid-app/fluid-cli-genealogy 的下载量有多少？

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

### @fluid-app/fluid-cli-genealogy 还在维护吗？

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