核心定位
majia-guanyuan 是架在观远官方全家桶（guancli/guanvis/guanetl/guanwf/guands）之上的实战增益层，不重复造标准轮子，专打官方DSL/命令覆盖不到的硬骨头。
Part B：ETL治理与写入
- 整库治理扫描：8维ETL判断+4维字段审计，识别循环依赖、复杂度爆炸、名实不符
- 10类BI引擎报错手册：
<> NULL吞行、CTE中文别名PARSE_SYNTAX_ERROR、UNION列数不匹配等 - SmartETL全链路重写/ExecPlan：30+表批量迁移工程管理，CTO张进方法论
- B-17.11 ExecPlan工作法：跨多日复杂重构的四活文档追踪（Progress/Surprises/Decision Log/Outcomes）
Part C：自定义图表开发
- HTML/CSS/JS注入排障：固定卡片/overlay、z-index层级管理、路由清理
- payload_json取数：runtime契约解析、JSON截断错误诊断
- Part C-12 HTML应用化看板：descriptor patch实现selector→custom chart dataView联动、五层视觉验收（反AI味红线设计底线）
Part D：V7发布流水线
- 草稿-发布状态机绕过：解决
60004错误、cdId映射断裂 - CSV三态硬规则：
IS NOT NULL AND <> ''判散客、TRUE/FALSE字符串布尔 - Spark中文别名禁用、ETL update
dsId注入防1012 - SmartETL节点化静默坑：
COUNT_DISTINCT/JOIN_DATA多键/FULL_OUTER - 移动端phoneLayout ZIP inject
Part E：SuperApp开放应用
- form建表反向工程：脚手架未暴露API的
POST /survey-engine/api/form/add实测路径 - LLM中转ILLEGAL_JSON_RES三路径解析：从error_message抠响应、bypass unwrap
- 原生fetch credentials绕开脚手架、客户端流式打字效果
AI-native ADS方法论（哲学层）
治理vs重搭判断、7字段约束（中文枚举/推荐预算/TIMESTAMP/权限冗余）、30%+30%+40%预算分配
餐饮BI公式实战库（V2.1.5）
60+ SQL/复购/RFM/AC/Comp、DWD宽表范式、39生产ETL索引、双源对账/评价pipeline
显著优点
- 来源全实证：CTO张进实战经验+60+张ETL生产验证+BI引擎报错原生捕获
- 工程化管理：ExecPlan工作法适配30+表跨日重构
- 反AI味设计底线：视觉验收硬约束，非功能通即交付
- 版本对齐机制：官方全家桶 weekly changelog 追踪，护城河零删减
潜在局限
- 环境锁定：Node≥20 +
@guandata/guanskill全家桶前置，无独立运行时 - 权限敏感：写操作需cookie/session认证，CI场景需PAT（guancli 1.0.38+）
- BI版本漂移：v7状态机/V8引擎差异可能导致部分硬规则失效
- 餐饮库领域限定：公式库脱敏自连锁餐饮，泛零售需适配
适合人群
- 观远BI重度用户（100+ETL实例）
- 数据中台工程师（ETL治理/重构项目）
- 前端开发者（custom chart/SuperApp扩展）
- 数据架构师（AI-native ADS重搭决策）
常规风险
- DELETE操作不可逆：
force=true级联删页、ETL删错顺序致2002/6001 - 状态机陷阱：draft/published cdId不映射，手撸API废弃
- JSON截断：长payload_json链路截断致runtime解析失败
- 类型严格化：Spark新引擎对老SQL兼容性收紧