@fluid-app/fluid-cli-genealogy

中文文档
0.1.674发布于 2026/11/15TypeScriptES Module近 30 天下载 13.3万

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

中文使用文档

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

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

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_countAPI没有腿体积。 计数包括: 被抛弃的成员。 API没有每条腿的计数终点,所以 legs, (中文(简体) ), strong-leg 财务报告和审定财务报表 weak-leg 阅读每个直接孩子的计数 请求。 他们拒绝一个有200多个直系子女的节点;通过 --limit <n> 最多数 n. 儿童读出一个直接的孩子 他的会员被抛弃了 而节点自己的计数保留着它 没有 单读一个节点的孩子的计数,所以 legs 读取节点 计算,然后孩子和每个孩子的计算 两次,然后节点的计算 诵读的时候,才用它;不然,只用它 页:1 当节点的孩子比列出的多时,输出 携带 unlisted (单位:千美元)children, (中文(简体) ), seats, (中文(简体) ), ranked, (中文(简体) ), unknown_empty_legsA级 未列入名单的单身儿童按其确切大小和 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 打印它,并发送什么.

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停止 运行保留它写的批次; 运行镜像以完成 .

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 共发布 676 个版本,首次发布于 2026/10/10;过去 12 个月发布了 676 个版本。

版本发布日期距今
0.1.674latest2026/11/15今天
0.1.6732026/11/15今天
0.1.6722026/11/15今天
0.1.6712026/11/141 天前
0.1.6702026/11/141 天前
0.1.6692026/11/141 天前

关于 @fluid-app/fluid-cli-genealogy 的常见问题

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