docs: update PROJECT_STATE with session bug fixes; add alist-serve-resource skill

docs/PROJECT_STATE.md

@@ -27,18 +27,21 @@ Base: **`AlistAccess`**（`p3lzkresswyowqg`），与旧 `accessDB` 完全隔离
 - 表/字段/链接列 ID 全表：`docs/DATABASE_SCHEMA.md`（已更新为 7 表）
 - NocoDB API token（workspace 级，来自 nc_api_tokens 表 n8n 那行）：在 `docs/API_INTEGRATION.md` / SETUP.md 有记（或查 NocoDB UI）
 
-### 3. W1 客户开通 workflow — **已实测跑通** ✅
+### 2. W1 客户开通 workflow — **已实测跑通** ✅
 - 文件：`n8n/W1-customer-provision.json`
 - 流程：Webhook → Extract customerId → **Load Env(step 2, 用 $env)** → Fetch 记录 → 判断 create/update → Create Role → Find Role Id → Create User(role:[roleId]) → Find User Id → Write Back
 - 关键：AList user/create 传 **空 role 数组会被拒**（自动填 guest→报 "admin or guest user can not be created"）。必须先 Create Role 拿自增 id，再 Create User 带 `role:[id]`
-- 已 import n8n；用户曾在 UI 微调 step 2（见下方「n8n env 访问结论」模板）
+- **base_path 已硬编码 `'/'`**（不是 `/Class`，否则 JoinPath 双重前缀 → 403）：commit 1ac1f17
+- **Loop guard**：新增 "Skip if already synced" IF 节点（sync_status=synced 时短路，不写回 NocoDB → 打破 webhook 循环）；同时去掉 last_sync 写入（时间戳每次必变会破坏 guard）
+- Load Env 已同步为 `$env` 版本（process.env 在 Code 节点不可用）：commit 58c2f57
 
-### 4. W2 CustomerProduct 权限同步 — **已改好待测试** ⏳
+### 3. W2 CustomerProduct 权限同步 — **已改好，需重新 import 测试** ⏳
 - 文件：`n8n/W2-customerproduct-sync.json`
-- 流程：Webhook → Extract customerProductId → Load Env → **Compute Effective Grants**(登录 AList→读 customer→读全部 active CP→读 Product 的 M2M Resources→**per-Resource MAX(expires_at)** 合并→读 AList role 现状→diff→算 newScopes) → AList Update Role Scopes → Write Back CP Sync Status
-- 已修：compute 节点 `***` 损坏行、所有 HTTP 表达式改引用 `$('Load Env').item.json.X`
-- ⚠️ 待用户 import + 测用例 2（1 Product 2 Resource）、用例 3（重叠取 max expiry）
-- **AccessGrants 表尚未在 W2 中被写入**（设计上它是物化结果，当前版本只更新 role scopes + CP sync 状态 —— 后续版本再物化进 AccessGrants？确认设计）
+- 流程：Webhook → Extract customerProductId → Load Env → **Compute Effective Grants**(登录 AList→读 customer→读全部 active CP→读 Product 的 M2M Resources→**per-Resource MAX(expires_at)** 合并→读 AList role 现状→diff→算 newScopes) → Skip if no change → AList Update Role Scopes → Write Back CP Sync Status
+- **已修 bug（commit 36a6b3b）**：查询 active CP 的 where 语法从 `(customer,eq,${id})` → `(customer.Id,eq,${id})`。NocoDB link 字段用 display name 直接 eq 返回 0 条；必须用 `customer.Id` 子字段或外键列 `nc_jitu___Customers_id`
+- **已修 bug**：link API 返回 `{Id,name}` 不含 `alist_path` → 新增 resById 反查（先加载全量 Resources 按 Id 索引，再按 link 结果的 Id 反查 alist_path）
+- **Loop guard**：新增 "Skip if no change" IF + No-op 死端（scopes 无 diff 且已 synced 时短路）；去掉 last_sync
+- ⚠️ 待用户重新 import + 测试
 
 ## 🔴 下一步（按序）
 1. **用户测试 W2**（import 覆盖 → 用例 2、3 → AList 前端实测客户登录看目录）→ 报错贴 execution 错误
@@ -59,6 +62,8 @@ Base: **`AlistAccess`**（`p3lzkresswyowqg`），与旧 `accessDB` 完全隔离
 - **NocoDB**（`nocodb-selfhosted` skill 已更新）：
   - SingleSelect 不能建表内联选项；要先建空列再 PATCH `{"colOptions":{options},"dtxp":"a,b,c"}`
   - Link 字段用 `type:"bt"`（belongs-to）建，`hm` 会把列名搞乱
+  - **Link 字段 where 查询**：`(linkField,eq,id)` 匹配的是 display name，永远返回 0 条。必须用 `(linkField.Id,eq,id)` 子字段语法或外键列 `nc_jitu___*_id`。已验证：`(customer,eq,5)`→0 条；`(customer.Id,eq,5)`→对。
+  - **Link API 返回结构**：`/links/{col}/records/{id}` 只返回 `{Id,name}`（display 列），不含业务字段。如需 alist_path 等字段，要按 Id 反查全表
   - base/table/column ID 全在 DATABASE_SCHEMA.md
 - **n8n env 访问（v1.123.72）**（memory 已记）：
   - Code 节点内 `$env` ✅（**用户实测可用**，如 `$env.NOCODB_URL`）