shield_lock
JinDaGe
← Back to skills
extension
Category: Data & AnalyticsNo API key required

运营聚光账户勤奋度看板

This skill should be used when a user wants to build, refresh, or extend a "运营聚光账户勤奋度看板" (operations diligence dashboard for Xiaohongshu 聚光 accounts) — including scaffolding a brand-new dashboard for another team/group, ingesting daily Excel exports, or applying the established data-caliber and visual-design rules. It packages the verified data pipeline, self-contained HTML template, and the full spec of requirements accumulated across iterations.

personAuthor: user_5a834f52hubcommunity
downloadDownload package

运营聚光账户勤奋度看板（可复用脚手架）

Overview

为「小红书聚光平台运营账户勤奋度」搭建/维护单一静态看板。看板用纯前端 HTML + ECharts（自含，无需后端），数据源是每日导出的 Excel 操作记录。本 skill 固化了从「腰客组」实战中沉淀的全部数据口径铁律与视觉/交互细节，使得搭其他小组看板时直接复用、不再重新美化。

When to use

  • 用户说「给 XX 组搭勤奋度看板」「新建运营聚光账户勤奋度看板」「更新面板数据」「把新日期数据入库」等。
  • 用户给了一个 Excel（列表视图 sheet，含操作类型/层级分布、附身登录、日预算、当日消费、归属运营、账户标记等列）。
  • 需要复用在意过的细节：红白黑高级感、近 7 日走势图 + 运营筛选、8 卡 KPI、4 张可视化图、客户分层三筛选联动、连续未登录排序、数据居中等。
  • 数据源含可选「组别 / 归属运营」两列时，看板提供组 → 运营 两级级联全局筛选（缺列归「未分类」，向后兼容旧数据源；本看板已去除「部门」维度，仅按组/运营统计与筛选）。

Resources

  • assets/gen_data.py —— 数据处理管线（pandas 解析 Excel → data/snapshots.json、daily_login_history.json、account_platform_map.json、dashboard_data.json）。已参数化：OUTDIR 取脚本自身目录，第 1 参数必填为 Excel 路径，第 2 参数可强制数据日期。不要改动核心口径逻辑（平台计入、三分法、分层、保留窗口），只在顶部常量区按需调整。
  • assets/gen_html.py —— HTML 生成器。读取 data/snapshots.json 内嵌全部快照，输出 index.html（自含 echarts.min.js）。组名参数化：顶部 GROUP_NAME 变量控制 <title> 与 <h1>，改为目标小组名即可。
  • assets/echarts.min.js —— 图表库，与上面两个 py 放在同一目录。
  • references/spec.md —— 完整需求与定义总纲（外显名称、7 条数据口径铁律、色调规范、全部功能区与交互细节、历史逐步新增清单、可直接粘贴的「建看板指令」）。搭建前必读，遇到细节争议以此为准。

Workflow

1. 脚手架（新小组首次）

  1. 在工作区新建看板目录（如 运营勤奋度看板/）。
  2. 把 assets/ 下三个文件（gen_data.py、gen_html.py、echarts.min.js）整体复制到该目录。
  3. 编辑 gen_html.py 顶部 GROUP_NAME 改为目标小组名（如「朱莉组」）。
  4. 运行环境：Python（需 pandas，可直接用 WorkBuddy 托管的 Python 运行时运行 python gen_data.py …）；Node.js（用于 node --check 校验生成的 JS 语法）。

2. 入库每日数据

  • 数据日期铁律：用户每日上午导出的 Excel 是前一天完整记录 → 文件名日期 = 拉取日 = 数据日 + 1。绝不用文件名当数据日，必须以用户口述为准，用第 2 参数强制： 
    python gen_data.py <Excel路径> "YYYY-MM-DD"
  • 例外：用户明确「文件名即当天数据」的补发历史，才用当天日期（仍用第 2 参数强制，不依赖文件名解析）。
  • 运营名归一化：若节点名与实际运营不一致（如「刘勇」=「柴峰」），在 gen_data.py 的 OP_NAME_MAP 早映射（读取后立刻套用再分组）。
  • 每次入库后自动保留近 365 天、裁剪旧数据。

3. 生成与校验

python gen_html.py

生成后必须：

  • 提取内联 <script> 用 NODE_OPTIONS= node --check _chk.js 校验 JS 语法；
  • 可选 headless 渲染校验（DOM + ECharts 桩）确认无运行时报错。

4. 部署

CloudStudio 静态站，固定链接（重部署链接不变）。部署命令通过 workbuddy_cloudstudio_deploy 工具：action=deploy、directory=看板目录、port=3000。瞬时 400 可重试。

5. 关键口径（详见 references/spec.md，务必一致）

  • 平台计入：账户标记含「聚光」即计入（含「聚光&乘风」双投），纯乘风排除。
  • 做功深度三分法（互斥加总=总户）：登录后台 = 附身登录>0 或 操作类型分布里除「登录/附身登录」外的任何操作动作>0（登录类动作集合 {登录, 附身登录}；"登录"本身不计入其他操作动作）。有效操作=登录后台 且 计划/单元/创意/关键词 任一>0；仅登录无有效操作=登录后台 且无上述有效操作（仅登录/附身登录、未做有效层级动作）；未登录=未登录后台（附身登录=0 且 无其它操作动作）。未登录数≡运营未登录数。
    • ⚠️ 关键修正（2026-08-28）：旧实现只认「附身登录>0」算登录后台，漏掉了「有其它操作动作但附身登录=0」的账户（如客户代做产生 暂停/修改出价）。现按口径A：操作类型分布里有非登录动作即算登录后台。客户代做但产生非登录动作的账户，归入 有效/仅登录（不再是未登录）。
  • 客户分层（按日预算）：≤100 尾客；100<≤200 腰客；>200 头客；缺失/0 归尾客。
  • 连续未登录预警阈值=3 天；筛选器保留尾客与有效操作选项。
  • 两级归属（组别 / 归属运营）：数据源可选含这两列，构成 组别 > 归属运营 层级；读取后立刻归一，缺列/空值归「未分类」（向后兼容仅含「归属运营」的旧数据源）；用通用 aggregate 分别按 归属运营 / 组别 聚合，构建跨全部快照的级联 org_tree。看板据此提供全局两级级联筛选栏（全部组/全部运营，级联联动 + 重置），选中后下方所有分区同步过滤，运营级汇总表头带「组」副标签。
  • 视觉：红白黑高级感、小红书红 #FF2442；有效操作=红、仅登录=金 #e6a23c、未登录=灰 #8e94a0、有效操作率折线=蓝 #3b6fe0；汇总表格数据居中；饼图标签用冒号；气泡图防重叠且坐标轴不遮挡。

建看板指令（自包含，可直接粘贴到新对话）

复制下面整段即可新建其他小组看板，所有口径/色调/交互已内嵌；完整溯源见 references/spec.md。

请帮我搭建「【XX组 · 运营聚光账户勤奋度看板】」，复用已确定的全部口径与展示细节，不要重新设计美化，直接沿用铁律与视觉规范：
【外显名称】title 与 h1 用「【XX组 · 运营聚光账户勤奋度看板】」。
【数据口径】1)平台计入：账户标记含"聚光"即计入(含聚光&乘风双投),纯乘风排除；2)做功深度三分法(互斥加总=总户)：登录后台=附身登录>0 或 操作类型分布里有除"登录/附身登录"外的任何操作动作(登录类动作集合={登录,附身登录})；有效操作=登录后台 且 计划/单元/创意/关键词 任一>0，仅登录无有效操作=登录后台 且无上述，未登录=未登录后台(附身登录=0且无其它操作动作)；未登录数≡运营未登录数；3)客户分层(按日预算)：≤100尾客，100<≤200腰客，>200头客，缺失/0归尾客；4)连续未登录预警阈值=3天；5)运营名归一化建 OP_NAME_MAP 早映射；6)数据日期：默认 文件名=拉取日=数据日+1，绝不用文件名当数据日，用 gen_data.py 第2参数强制；用户明确补发且"文件名即当天"才用当天；7)数据保留365天自动裁剪；8)归属两级(组别/归属运营)，本看板已去除部门维度，仅按组/运营统计与筛选。
【视觉/色调(红白黑高级感·小红书红白·必须沿用)】背景 linear-gradient(135deg,#fff6f7,#fbfbfd 46%,#f2f6fb) 叠加点状纹理+顶部4px红渐变条；卡片白底；主红#FF2442(浅红#ff7a90)、金#e6a23c、灰#8e94a0、蓝#3b6fe0；颜色语义：有效操作=红,仅登录=金,未登录=灰,有效操作率折线=蓝,消耗排行条=红→浅红渐变,头/腰/尾客点=红/金/灰；区块标题左侧3px红边；字体 PingFang SC/Microsoft YaHei/Segoe UI；KPI 4列窄屏2列。
【功能区与交互】顶部日期下拉回溯；顶部组/运营两级级联筛选栏(全局联动:默认全选,级联联动+重置,选中后所有分区同步过滤,运营汇总表头带组副标签,旧数据无组时仅现未分类)；顶部近7日走势图(柱:有效操作/仅登录/未登录账户数,tooltip含占比 + 折线:有效操作率=有效操作÷在投有消耗账户数,右轴;直接跟随全局归属筛选联动,不再单独放运营下拉)；全局概览8卡(4×2居中):聚光在投户/昨日总消耗/整体预算使用率/运营100%操作占比/运营未登录账户/完全脱岗账户/有效操作账户数/有效操作率；可视化4图：①运营消耗排行(横向红→浅红渐变,¥k) ②做功深度分布(按运营堆叠:红/金/灰) ③做功深度占比饼图(标签用冒号 {b}: {c} ({d}%)) ④气泡图(预算使用率×运营100%操作占比,气泡=昨日消耗;标签防重叠hideOverlap+白底+hover高亮+坐标轴不遮挡)；客户分层看板:分层卡片(头/腰/尾客红/金/灰点)+明细三筛选联动(层级×做功深度×归属运营,保留尾客与有效操作选项)；未登录预警列表(连续未登录≥3天)；每运营·详细账户表(列含 账户名/客户操作/做功深度/运营登录/操作归属/连续未登录；「连续未登录」列可升/降序排序,排序后重应用做功深度筛选)；汇总面板表格数据居中。
【交付】生成 index.html(自含 echarts)，部署到 CloudStudio 固定链接；每次改 JS 后 node --check 校验再部署。