观远 BI · 马甲实战版
观远 BI(Guandata)实战增益层。标准查数、指标批量查询、本地分析、建卡发布、ETL、数据集和表单结构管理、工作流、指标写入路由官方六组件。专攻 ETL 整库治理、SmartETL 全链路重写、引擎报错、自定义图表与 HTML 看板排障、v7 发布兼容、移动端 phoneLayout、门店手机成绩单、SuperApp 的 LLM 中转及历史兼容、AI-native ADS 架构判断。餐饮会员公式见 majia-huiyuan。触发:观远、Guandata、会员、订单、复购率、RFM、ETL 治理、payload_json、自定义图表、HTML 看板、门店手机成绩单、换店滤空、phoneLayout、60004、SuperApp、ILLEGAL_JSON_RES、数据架构。 Skill: 观远 BI · 马甲实战版 Owner: maojiebc Summary: 观远 BI(Guandata)实战增益层。标准查数、指标批量查询、本地分析、建卡发布、ETL、数据集和表单结构管理、工作流、指标写入路由官方六组件。专攻 ETL 整库治理、SmartETL 全链路重写、引擎报错、自定义图表与 HTML 看板排障、v7 发布兼容、移动端 phoneLayout、门店手机成绩单、SuperApp 的 LLM 中转及历史兼容、AI-native ADS 架构判断。餐饮会员公式见 majia-huiyuan。触发:观远、Guandata、会员、订单、复购率、RFM、ETL 治理、payload_json、自定义图表、HTML 看板、门店手机成绩单、换店滤空、phoneLayout、60004、SuperApp、ILLEGAL_JSON_RES、数据架构。 Tags: agent-skill:3.2.3, agen
Rank
62
Safety
84
Downloads
3.5k
Updated
Oct 9, 2026
Version
3.2.3
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 3.5K downloads reported by the source. Last updated 10/9/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 9, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 9, 2026
- Adoption signal
- 3.5K downloadsadoption · observed Oct 9, 2026
- Latest release
- 3.2.3release · observed Sep 28, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s171vv4g1xczzsxtgd1wg0626x83khts:guanyuan-majia- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-maojiebc-guanyuan-majia/snapshot"
Documentation
CLAWHUB
160,000 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: majia-guanyuan
description: 观远 BI(Guandata)实战增益层。标准查数、指标批量查询、本地分析、建卡发布、ETL、数据集和表单结构管理、工作流、指标写入路由官方六组件。专攻 ETL 整库治理、SmartETL 全链路重写、引擎报错、自定义图表与 HTML 看板排障、v7 发布兼容、移动端 phoneLayout、门店手机成绩单、SuperApp 的 LLM 中转及历史兼容、AI-native ADS 架构判断。餐饮会员公式见 majia-huiyuan。触发:观远、Guandata、会员、订单、复购率、RFM、ETL 治理、payload_json、自定义图表、HTML 看板、门店手机成绩单、换店滤空、phoneLayout、60004、SuperApp、ILLEGAL_JSON_RES、数据架构。
license: MIT
metadata:
version: "3.2.3"
author: "超级马甲 / maojiebc"
homepage: https://github.com/maojiebc/majia-guanyuan
openclaw:
emoji: "📊"
homepage: https://github.com/maojiebc/majia-guanyuan
os:
- macos
- linux
requires:
bins:
- jq
- bash
install:
- kind: npm
package: "@guandata/guanskill"
bins:
- guancli
- guanvis
- guanetl
- guanwf
- guands
- guanmetric
---
# 观远 BI · 马甲实战版(V3.2.3)
> **结构说明(V1.5.0 引入 progressive disclosure)**:本文档是**路由层 + 关键规则**,详细操作手册下沉到 `references/`。每个 Part 的入口章节会指出"何时回到 references/ 查全表"。完整章节索引见末尾的 [📚 References 目录](#-references-目录)。
## 🧭 Part 选择
| 你想做 | 走 |
|---|---|
| 查数据、建卡、出报表、标准 ETL / 数据集 CRUD / 指标写 / 洞察问答 | **🧭 路由层** → 交给官方全家桶(`guancli` / `guanvis` / `guanetl` / `guanwf` / `guands` / `guanmetric`),见路由总表 |
| 扫整库 ETL 治理 / 新建/修改/删除 ETL / 字段使用度审计 / 修复 ETL 报错 | **Part B:ETL 治理与写入** |
| 把整条 SmartETL 链改写成 SQL 版 + 页面副本验收 + 差异定位 + 空快照阻塞 | **Part B-17:全链路重写方法论**(拆到 [references/part-b17-fullchain-rewrite.md](references/part-b17-fullchain-rewrite.md)) |
| 30+ 张表批量迁移 / 跨多日工程 / 复杂重构需要项目化追踪 | **B-17.11 ExecPlan 工作法**(同上文件 §11) |
| 自定义图表 HTML/CSS/JS 注入、固定卡片/overlay、payload_json 取数、路由清理 | **Part C:自定义图表开发与排障** |
| 从零生成 HTML 化经营分析应用(用户说"更高级 / 应用化 / 自定义模块 / 最完美 / 不限标准看板")| **Part C-12:HTML 应用化看板生成**(拆到 [references/part-c-html-dashboard.md](references/part-c-html-dashboard.md)) |
| 手机成绩单专供ETL / 红色异常提示 / 券转化明细 / 近7天营业额排序 / 核销未匹配订单 | **V2** [实践与口径](references/part-c-store-mobile-scorecard-v2.md)、[离线示例](examples/store-mobile-scorecard-v2/README.md)、[券关联排查](references/coupon-order-link-diagnosis.md) |
| 加盟店老板手机成绩单 / 门店移动看板 / 换店后财务空白 / GDPlugin 视图顺序错位 / 对比组家数泄露 / 要一份可离线点的移动样本 | **Part C 门店手机成绩单**(拆到 [references/part-c-store-mobile-scorecard.md](references/part-c-store-mobile-scorecard.md),离线 HTML: [examples/store-mobile-scorecard/](examples/store-mobile-scorecard/)) |
| **v7 BI 实例**上端到端搭多个 HTML 应用看板 / 手撸 `POST /api/page+/api/card` 被 `60004 此操作只能在草稿页面执行` 卡住 / CSV 散客 `会员ID IS NOT NULL` 算出 100% 假指标 / Spark `WITH 中文别名` 报 `PARSE_SYNTAX_ERROR` / ETL update 报 `1012 输出数据集目录中存在同名文件` | **Part D:V7 Page/Card 发布流水线 + 三态硬规则**(V2.1.6 新增,拆到 [references/v7-page-card-publish-pipeline.md](references/v7-page-card-publish-pipeline.md)) |
| **SuperApp / 超级应用 / 开放应用**开发流水线 / `guancli app create/publish` / `--app-id` 不传变成每次新建 / 数据集异步预览 3 步 / 表单结构先走 `guands form`;旧脚手架建表兼容问题按 §6/ **BI 中转 LLM 报 NOT_JSON_RES / ILLEGAL_JSON_RES**(响应被塞在 error_message)/ `/api/llm-config/list` 返回裸数组被脚手架 unwrap 吞 / 同源 fetch credentials 不带 cookie / 客户端模拟流式打字效果 / 任务池工作examples/store-mobile-scorecard-v2/etl/README.md
# 专供 ETL 参考 `pipeline.json` 声明10个逻辑源、28个计算节点及19个输出。每个SQL的 `input1`、`input2` 等按对应步骤的 `inputs` 顺序绑定。未携带任何租户数据集、目录、连接或页面ID。 商品排除项“示例排除商品”是脱敏占位,接入时须替换为本组织的有效商品分类规则。 字段使用业务别名,例如“订单日期”“total_实付”。接入时先核查本组织字段语义、类型、时区、订单状态、取餐方式、门店名称与编号映射,再通过官方 guanetl 组装隔离流程。文件不是 guanetl 完整导出包,不能直接覆盖生产ETL。前端视图契约由 build.mjs 的 `packViews` 和 scorecard.js 的列名识别共同展示。 财务与顾客订单用于有效门店并集;多数逐日输出保留70天,窗口去重、对比、异常证据与汤底覆盖分别聚合。订单和券号仅参与后端关联,不下发浏览器。会员证据与券转化为版本化JSON,在19个既有输出内扩展。 所有默认规则、阈值及口径限制见 [V2实践](../../../references/part-c-store-mobile-scorecard-v2.md)。SQL保留 Spark 3.4 语法;本公开包没有执行真实数据库查询,不承诺任意字段、POS或租户开箱即用。调度应绑定实际上游刷新,核查时间水位并观察自然运行;不要在公共模板硬编码生产调度或凭据。 本次新增 `dinein_repurchase.sql` 与 `repurchase_peers.sql`,结果并入门店档案而不增加前端视图数。顾客、周期会员与门店档案使用字符串门店编号,输入依赖以最新 pipeline 为准。 `DEMO_NEW_STORE`、`示例重新开业店` 和日期 `2026-03-19` 是重开店历史边界的合成占位,展示需要跨模块一致处理的特例;不是通用营业起点规则。接入时删除不适用特例或改为经核验的门店历史映射。财务参考还保留开业前微额测试日识别(全渠道合计1至2单、0至2元且无负数),须按本组织业务核验,不能随意删除正常营业日。 订单源在门店关联前须满足 JOIN 基数约束,见 [订单关联去重](../../../references/order-join-cardinality.md)。公共SQL没有执行目标租户查询;离线构建与测试不代表这些SQL已在任何新环境运行。
examples/store-mobile-scorecard-v2/README.md
# 门店手机成绩单 V2:专供 ETL、异常提示与券转化 这是一份可离线操作的移动端案例。门店、日期、业务数字、券名与异常证据全部为合成数据;不含企业数据、账号、平台资源 ID 或线上截图。V1 保留在相邻目录,作为历史版本。 下载 [单文件 HTML](store-mobile-scorecard.html) 后用浏览器打开即可,不需要登录、联网或大模型。源码修改后执行: ```sh node examples/store-mobile-scorecard-v2/build.mjs node examples/store-mobile-scorecard-v2/test.cjs ``` <img src="https://raw.githubusercontent.com/maojiebc/majia-guanyuan/main/examples/store-mobile-scorecard-v2/preview.png" alt="V2券转化明细,合成数据" width="390"/> ## 2026-09-23 同步 本次对齐当前线上移动版的前端与SQL口径。门店名称旁显示编号标签,随选店变化;长店名自动换行,编号缺失或归属不唯一时隐藏。保留字符串编号的前导零。 顾客状态按门店编号归属,90天观察期不足时不判断流失。会员和非会员新增固定近30天的堂食跨日复购率,以及同店型前25%参照;观察期不足、每组顾客不足50名或参照门店不足10家时暂不评定。城北店合成样本包含观察期不足场景。百分比以整数为主,小于1%的差异保留显示。 客单价翻倍的根因与上游修复见 [订单关联去重](../../references/order-join-cardinality.md)。公开包保持合成数据,生产门店特例已替换为明确的示例占位。 ## 可以直接体验 顶部先选分公司,再选门店;同分公司按固定近7天总营业额降序排列。示例城南店演示会员集中高额订单与堂食汤底缺失,示例镇中店没有异常警示,示例北区的城北店演示无券核销与会员识别覆盖不足。 昨日、近7天、近30天、本月同步改变数据范围,以及“昨日明细/近7天明细/近30天明细/本月明细”和对应的转化明细标题。每日明细有总额、堂食、外卖三个切片;标题、合计与表头固定,只滚动数据。日期与星期分行,周末浅色标记。近8周趋势的月份与日期分行,避免横轴挤在一起。 “跟其他门店比”分别展示近7天日均营业额、固定近30天会员订单占比。只给本店名次和中位数,不披露其他店的明细。会员占比参评要求和前后期变化条件见口径弹层,不用该占比决定顶部选店顺序。 异常警示主标题为红色,只有达到规则才出现。会员订单提示给出集中笔数、跨天数、金额占比及原始支付类别,不判断操作人身份或直接认定刷单;汤底异常区分堂食收银点选与外卖商品映射。页尾为业务分析用途说明,联系对象使用通用的“运营支持”。 优惠券转化明细分“营收贡献/优惠折扣”,展示核销张数、订单数、关联实付、客单、整单优惠、加权实付折扣和每优惠1元对应实付。叠券总计独立按订单去重,不能将券种行相加。未匹配、金额冲突、券作支付和非完成订单保留数量,不把未知金额当成0。 ## 文件与使用边界 | 文件 | 用途 | |---|---| | `scorecard.js` / `scorecard.css` | 当前前端交互与统一字号间距;离线筛选器适配在 JS 末尾 | | `build.mjs` | 固定种子生成三个门店的合成聚合数据,封装单文件 HTML | | `test.cjs` | 叠券去重、折扣加权、未知金额、跨周期隔离与异常边界检查 | | `etl/pipeline.json` | 10类逻辑输入、28个计算步骤与19个输出的依赖关系 | | `etl/*.sql` | Spark SQL 计算参考,`input1` 等顺序由 pipeline 声明 | | [完整实践说明](../../references/part-c-store-mobile-scorecard-v2.md) | 数据口径、性能取舍、移动规范与发布验证 | | [券关联排查](../../references/coupon-order-link-diagnosis.md) | “已核销但无关联订单”的分层追溯方式 | 演示数据按模块合成,用于验证交互和边界,不能作为真实经营基准。ETL 是字段与依赖参考,并非可直接覆盖任意租户的部署包:须先映射本地源字段,用官方 guanetl / guanvis 创建隔离副本,校验权限、筛选、调度及真实数据,再发布。不要把离线示例当作已接入真实数据或已证明加载速度提升。
examples/store-mobile-scorecard/README.md
# 门店手机成绩单 · 脱敏离线案例 > 当前迭代见 [V2](../store-mobile-scorecard-v2/README.md)。本文件保留 V1 约定与历史验证。 给加盟店老板看的手机成绩单样本。和桌面看板不是同一张页,也不是把桌面缩小。 **V1 版**(2026-09-14 封存):单卡内滚动,19 个 DATA_GRID,不取 RFM,外卖色 `#FFD100`。不要为了切店先出营业额拆成两张卡。 经验总结(产品规则、19 视图契约、换店滤空、列名识别、对比不写家数、发布链路): [`references/part-c-store-mobile-scorecard.md`](../../references/part-c-store-mobile-scorecard.md) ## 打开 双击 `store-mobile-scorecard.html`,或: ```bash open examples/store-mobile-scorecard/store-mobile-scorecard.html ``` 不需要观远、不需要登录、没有网络请求。页顶横条写明:虚构门店、虚构数字、锚点冻在 2026-03-20。 生产页用页面筛选器换店。本样本用页内「示例镇中店 / 示例城南店」代替,方便离线看换店后数字一起变。 ## 重新生成 改 `scorecard.js` / `scorecard.css` / `build.mjs` 之后: ```bash node examples/store-mobile-scorecard/build.mjs ``` 生成器会自检:除 RFM 外的视图都能按列名识别(`detectV.rfm === -1`);昨天合计 ≠ 近 7 天日均;两店数字不同;会员频次高于非会员且两店不同;对比组够 3 家(只用于算名次,页面不展示家数)。 ## 点击清单 打开后按这个表点一遍,每一项都应该仍有数: 1. 两店切换(店名、首屏、顾客、私域、商品一起变) 2. 昨天 / 近 7 天 / 近 30 天 / 本月 3. 每日明细 4. 堂食、外卖下钻 5. 近 30 天折线滑块、近 8 周柱 6. 跟其他门店比三张卡 + 弹层(看不见家数、看不见其他店名) 7. 顾客与会员(消费会员跟周期去重、新老客条、当前状态) 8. 会员和非会员(一级模块:人均贡献 + 右侧客单价,下方只有组内营业额) 9. 私域 KPI + 哪些券用得最多(一级模块,不折叠) 10. 饭点条(在热销上面)+ 热销展开、汤底堂食/外卖 11. 口径说明 ## 不要用它做什么 不要把这个 HTML 当成 guanvis 工程去 `pack` / `upload`。上线仍是:原生 Page + 门店筛选器 + HTML 父卡 + 19 个 DATA_GRID + 必要时补 `phoneLayout`。
examples/workshop513-咖啡连锁会员运营模拟案例/README.md
# ➡️ 已迁移:majia-huiyuan(独立仓库) 本案例(咖啡连锁会员运营模拟数据中台 · 54 数据集 / 25 ETL / 12 看板整库快照)已从本仓库独立,作为**开源会员运营家底**项目持续迭代: **👉 https://github.com/maojiebc/majia-huiyuan** - 独立仓库含完整的结构定义、200 行/表数据样本、口径 SQL、观远原始 JSON,并新增 AI Agent 友好层(`llms.txt` + `AGENTS.md`) - 本目录自 2026-07-12 起不再更新;历史版本可在本仓库 git 历史(≤ v3.1.6)中找回 - 分工:**工具在 majia-guanyuan,数据在 majia-huiyuan**
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/maojiebc/skills/guanyuan-majia",
"sourceUrl": "https://clawhub.ai/maojiebc/skills/guanyuan-majia",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T07:52:54.293Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-maojiebc-guanyuan-majia/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-maojiebc-guanyuan-majia/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-09T07:52:54.293Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "3.5K downloads",
"href": "https://clawhub.ai/maojiebc/guanyuan-majia",
"sourceUrl": "https://clawhub.ai/maojiebc/guanyuan-majia",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T07:52:54.293Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "3.2.3",
"href": "https://clawhub.ai/maojiebc/guanyuan-majia",
"sourceUrl": "https://clawhub.ai/maojiebc/guanyuan-majia",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-28T02:14:33.590Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-maojiebc-guanyuan-majia/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-maojiebc-guanyuan-majia/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 3.2.3",
"description": "对齐 guanskill 0.1.41 / guancli 1.0.63:单指标请求计划、指标创建恢复与编辑保护、ETL 输入类型修复和页面初始化保护。",
"href": "https://clawhub.ai/maojiebc/guanyuan-majia",
"sourceUrl": "https://clawhub.ai/maojiebc/guanyuan-majia",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-28T02:14:33.590Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
