家谱 v22：改按 family-chart 官方用法接，并放开代数上限

用户指出「只需要按照 json 格式，把以我为中心的关联数据全部取出来，
全都封装进去就行了，id 用用户表的 id，性别名字生日头像都是现成的，
只需要把配偶、父母和孩子放进去用 id 关联」——并强调「之前一定是你
调用的方法不对」。

== 验证结论（先量再改）==
用**官方示例自己的数据**（donatso 的 data.json，13 人，格式完全官方）
跑了一遍：库画出 11 人，**配偶 Andrea 的父母 Zadro/Zadra 一个都没画**。
那两位就在数据里、rels.parents 也指向他们、格式与官方示例一字不差。
→ 说明「按格式全塞进去就能画全」在**姻亲**这一项上不成立：
  库的算法只走「树根的祖先链 + 后代 + 树根的兄弟姐妹 + 各人配偶」，
  **不会从配偶继续向上/向下 walk**。这是库的算法边界，不是格式/关联问题。

== 但用户的批评有一半是对的：调用方式确实有我没做足的地方 ==
官方示例是：<div id="FamilyChart" class="f3"> + 引 family-chart.css。
我之前**既没加 f3 类、也没引库 CSS**，而是自己在 app.css 里手补
`.kin-chart svg.main_svg{width:100%;height:100%}` 去绕开 300×150 那个坑 ——
属于"用歪门邪道达到同样效果"。现在按官方来：
  · 容器加 `f3` 类（库的 CSS 全部以 .f3 作用域）
  · 引入官方 family-chart.css（新增 vendor 文件）
  · 在 app.css 里把库的深色主题变量覆盖成家书宣纸色
    （--male-color / --background-color / --text-color 等）
  · 自己的 svg 撑满那条规则删掉（官方 CSS 已提供）

== 放开代数上限（用户要求「全部取出来」）==
官方示例**不调** setAncestryDepth / setProgenyDepth —— 库在"未设置"时
会跳过深度截断，等于不限代数。我之前写死了 2/3，真实家庭一超过就被砍。
现在不设这两个值。服务端 familyMap 的 up/down 也从 (2,2) 放到 (9,9)
（这两个参数只影响**代数标号**，超出会压到边界档导致曾祖辈与祖辈混层；
遍历本身是走遍整个连通图的，人员收录数不受影响）。

== 工具同步 ==
- familybook_deploy.sh：新增 v22 三条契约（vendor CSS 在 / 模板引了它 /
  容器有 f3 类），并加**反向断言**「不许再出现 setAncestryDepth|setProgenyDepth」；
  旧的"卡片尺寸/间距"断言同步。
- _fb_kin_geom_falsify.py：注入②的原锚点（setProgenyDepth）已随本次删除，
  换成「禁掉上溯循环」——树根退回「我」，伯父/堂兄/堂嫂/堂侄/侄子那批旁支
  会离开画面，J 项必须红。3/3 全抓住。
- ⚠️ 又踩一次「注释撞断言字面量」：新写的注释里提到 setProgenyDepth 函数名，
  把「不许再设代数上限」这条反向断言直接打红。改注释避开字面量后恢复。

== 战绩 ==
e2e 549/0 · 桌面几何 368/0 · 移动端 516/0 · 交互 97/0 · 升级专测 123/0
家谱可视化 24/0 · 家谱版面 10/0 · 反向验证 3/3 · 静态断言空跑 RC=0
部署 + 线上自检全过。

assets/css/app.css

@@ -432,14 +432,15 @@ textarea.input { min-height: 76px; resize: vertical; }
 }
 
 /* ---------------- 家谱（以我为中心） ----------------
-   v21：改用 family-chart 库渲染。库把 data[0].id 当 main_id，
-   所以把「最高祖先」排第一位以画出尽可能多的血亲旁支；
+   v22：按 family-chart **官方用法**接（容器 class="f3" + 引 family-chart.css），
+   库把 data[0].id 当 main_id，所以把「最高祖先」排第一位以画出尽可能多的血亲旁支；
    加载后再把镜头平移回「我」，兼顾"看到全树"与"以自己为中心"。
 
-   免费版 family-chart 的算法只画「树根的祖先链 + 后代 + 树根的兄弟姐妹 + 各人配偶」，
-   **不会从配偶继续向上/向下 walk**，因此岳父岳母、舅子、外甥等姻亲旁支
-   在单棵树里天然画不出来（换树根、调 depth 都救不了）。
-   这是库的能力边界，不是调用方式问题；如要姻亲，需要 Premium 或多树拼接。 */
+   ⚠️ 免费版 family-chart 的算法只画「树根的祖先链 + 后代 + 树根的兄弟姐妹 + 各人配偶」，
+      **不会从配偶继续向上/向下 walk**。这一点已用**官方示例自己的数据**验证过：
+      官方 data.json 里 13 人（含配偶 Andrea 的父母 Zadro/Zadra，格式完全按官方），
+      库只画出 11 人 —— 配偶方那两位长辈一个都没画。
+      所以「把数据按格式全塞进去就能画全」在姻亲这一项上不成立，是库的算法边界。 */
 
 .kin-tools { display: flex; gap: 8px; justify-content: flex-end; margin: 0 0 10px; }
 
@@ -458,32 +459,44 @@ textarea.input { min-height: 76px; resize: vertical; }
 }
 .kin-chart:active { cursor: grabbing; }
 
+/* 库的 `.f3` 会自带一套**深色主题**（--background-color: rgb(33,33,33) / --text-color: #fff）。
+   家书是宣纸浅色，必须在这里把库的主题变量改掉；否则卡片文字会变白、看不出内容。
+   只覆盖颜色变量，**不动**库的结构规则（那些是撑满/定位必需的）。 */
+.kin-chart.f3 {
+  --male-color:   #F1E7D6;   /* 库的男卡底色，改成纸色（我们自己的 .kin-card 会再盖一层） */
+  --female-color: #F1E7D6;
+  --genderless-color: #F1E7D6;
+  --background-color: transparent;
+  --text-color: var(--ink);
+  font-family: inherit;
+}
+
 /* 隐藏 family-chart 自带的空导航栏（我们用自己的「看全部 / 回到我」按钮） */
 .kin-chart .f3-nav-cont { display: none !important; }
 
-/* ⚠️ 这条是**必须**的：库自带的 CSS 里写着 `.f3 svg.main_svg { width:100%; height:100% }`，
-   而我们的容器类名是 `.kin-chart`（不是 `.f3`），也没引库的 CSS ——
-   于是 SVG 根元素退化成浏览器默认的 **300×150**，所有画到框外的连线被裁掉
-   （卡片层是 HTML div，不受影响，所以"卡在、线没了"这个症状很隐蔽）。
-   实测：不写这条时 svg 只有 300×150（`_fb_kin_check_v17.py` 第②条会红）。 */
-.kin-chart svg.main_svg { width: 100%; height: 100%; display: block; z-index: 1; }
+/* 官方 CSS 已经给了 `.f3 svg.main_svg { width:100%; height:100% }`（撑满画布），
+   这里只补一个 display:block，避免 svg 作为 inline 元素多出基线空隙。 */
+.kin-chart svg.main_svg { display: block; z-index: 1; }
 
 /* family-chart 的 HTML 卡片层 #htmlSvg 与 SVG 连线层由库的 onZoom 同步 transform。
    卡片容器 .card_cont 已经 absolute + translate(x,y)；里面再放我们的 .kin-card。 */
 .kin-chart #htmlSvg { z-index: 2; }
 .kin-chart .card_cont { pointer-events: none; }
 
-/* 库给卡片套了一层 <div class="card"> / <div class="card-inner">，
-   我们只接管最里面那层（.kin-card）。把外层的中转容器归零，避免它自带的内边距/背景
-   让卡片看起来"胖了一圈"或有底色。 */
+/* ⚠️ 库的性别底色规则是 `.f3 div.card-male .card-inner`（3 段），
+   比 `.kin-chart .card_cont .card-inner`（3 段）**同级**，靠先后顺序定胜负 ——
+   所以这份覆盖必须写在**引库 CSS 之后**（app.css 在 layout 里就是这么排的）。
+   把外层中转容器全部归零，只留我们自己的 .kin-card。 */
 .kin-chart .card_cont > .card,
-.kin-chart .card_cont .card-inner {
+.kin-chart .card_cont .card-inner,
+.kin-chart.f3 .card_cont .card-inner {
   background: transparent;
   padding: 0;
   border-radius: 0;
   min-height: 0;
   width: auto;
   height: auto;
+  outline: none;
 }
 .kin-chart .card_cont .card-inner { display: block; }