用途:在 Next.js 应用中挂载 ibl.ai SDK 的审计标签页,展示某个 mentor(智能体 UUID)范围内谁在何时改了什么,提供筛选、表格与分页。
主要能力:组件 AnalyticsAuditLogStats 来自 @iblai/iblai-js/web-containers,必填 props 为 tenantKey、mentorId、userId,可选 selectedMentorId 在运行期覆盖被审计的 mentor。内部由 useAuditLog 管理操作者筛选、日期范围和操作类型筛选。筛选栏含 actor 下拉、日期区间、操作选择(All/Create/Update/Delete);表格列 USER、ACTION、TIME(相对时间);操作摘要会人性化,如 Enabled <field> on <target>;分页每页 20,通过 limit/offset 服务端分页;内置空状态、错误状态和 403 状态(无 audit-read 权限时显示提示卡片)。
使用方式:需先完成 /iblai-auth,配置 MCP 服务器与技能(.mcp.json 中 @iblai/mcp),并向用户询问真实 mentorId。项目根目录需有 iblai.env,含 PLATFORM、DOMAIN、TOKEN,缺失时下载模板:curl -o iblai.env https://raw.githubusercontent.com/iblai/vibe/refs/heads/main/iblai.env。宿主页面负责解析 tenantKey 与 userId(通常从 localStorage 的 userData、app_tenant/current_tenant/tenant 读取)后传入组件。默认使用 pnpm,未安装则用 npm。自定义 UI 可用 useAuditLog 或 @iblai/data-layer 的 useGetAuditLogsQuery。完成后必须运行 /iblai-ops-test,再执行 pnpm build、pnpm test,并启动 pnpm dev 供用户在 http://localhost:3000 查看。
限制:不要给 ibl.ai SDK 组件添加自定义样式、颜色或 CSS 覆盖,不要实现暗黑模式,除非用户明确要求。RBAC 要求 Ibl.Analytics/Core/read(viewer)或 Ibl.*(tenant admin),不要在布局层拦截路由,应让组件渲染 403 提示。已知后端会丢弃 ?action=0(Create)筛选,useAuditLog 仅在客户端补偿重筛。响应中 action 是字符串,而筛选参数用整数码;changes 为 { 字段: [旧值, 新值] },布尔值序列化为 "True"/"False"。其余未在资料中说明的收费、平台、效果等信息暂未提供。