用途:为 React、Next.js 及 Web 应用集成 Velt 活动日志系统提供实现指南,共 13 条规则、7 个类别,按影响优先级排列,用于指导自动化代码生成与集成模式。
主要能力与规则分类:核心设置(CRITICAL,core-)包括在 Velt Console 启用活动日志、使用 VeltActivityLog 组件展示活动流 UI;数据访问(HIGH,data-)包括 React 用 useAllActivities 订阅实时活动、用 getAllActivities API 订阅、用 useActivityUtils 创建自定义活动、用 getActivityElement API 创建自定义活动;配置(MEDIUM,config-)包括 CRDT 活动防抖时间、审计追踪不可变性、用 action type 常量做类型安全过滤;线框变量(MEDIUM,wireframe-variables-)通过 velt-data、velt-if、velt-class、defaultCondition 属性及 Angular signal 输入绑定活动日志线框插槽;UI 线框(MEDIUM,ui-)在 VeltWireframe 内组合 VeltActivityLogWireframe 子组件树(Header、Filter、List、DateGroup、Item、ShowMore、Empty、Loading);REST API(LOW-MEDIUM,rest-)用于服务端活动管理;调试与测试(LOW-MEDIUM,debug-)排查记录不显示、加载状态为 null 等常见问题。
使用方式:每条规则文件包含原因说明、错误代码示例、正确代码示例与官方文档来源指针;可从 AGENTS.md 压缩索引开始,或查阅 AGENTS.full.md 完整展开版。
适用场景:添加实时活动流、订阅协作事件、创建非 Velt 事件的自定义活动记录、降低活动流噪声、合规审计、按功能或动作类型过滤、服务端管理活动记录、自定义活动日志线框、调试活动日志问题。
限制:资料未提供具体安装命令、收费与价格、平台支持范围及实际效果数据。