人效看板 · 本机网址与更新方法

沪联孟想团队每日人效看板。本机运行，页面点按钮就能刷新。<br>最后更新：2026-10-13

网址

http://127.0.0.1:8770/

这个地址只能在这台电脑上打开。 127.0.0.1 就是「本机」的意思，
换一台电脑、或者同事点这个链接，都会显示「无法访问此网站」。
它不是外网网址，是个只监听本机的本地服务。

打开方式

浏览器地址栏输入上面的地址即可。

服务已装成开机自启（Windows 计划任务 renxiao-dashboard-server），
登录系统后自动启动，不需要每次手动开。

如果服务没起来，双击：

team-dashboard\启动看板.cmd

更新数据

在看板页面右上角点「刷新数据」，等几秒，页面自动重载。

• 刷新数据 —— 只补今天，历史保留，约 3~25 秒
• 全量刷新 —— 重拉整个区间，约几分钟
• 日志 —— 看采集过程的实时输出

不用再双击什么 .cmd 文件了。

看板里有什么

从上到下五块，全部可交互：

1. 顶部状态条
左侧标题 + 区间摘要（天数 / 人数 / 上品 / 新增视频 / 消耗 / ROI 一行看全），
右侧元信息 + 状态灯 + 「刷新数据」「全量刷新」「日志」三个按钮。

2. KPI 卡片组（6 张）
消耗、GMV、ROI、新增视频等，超阈值的那张会自动变红/变橙。

3. 今日快照
当天新增视频（不含此前在投）、过审数、拒审数、当日消耗/GMV、在投人数，
带环比涨跌（红涨绿跌）。

4. 员工 × 日期矩阵（核心）
行是员工，列是每天，格子里的数字深浅代表高低。

• 顶部指标切换：上品量 / 计划搭建数 / 新增视频 / ROI / 消耗 / GMV / 在投分组，共 7 个口径
• 表头点一下换排序方向
• 时间范围 7 个预设：今天 / 近 7 天 / 近 14 天 / 近 30 天 / 本月 / 上月 / 全部
• 也可以直接在日期框里手填起止日
• 「← 上一段 / 下一段 →」：按当前区间长度整段翻页（比如看近 7 天，

点「下一段」就跳到再往后的 7 天），用来一屏一屏对比很顺手

5. 两张明细表

• 员工汇总表：点任意一行 → 右侧抽屉展开该员工的完整明细

（上品量含黄金档、计划搭建数、新增视频含过审、在投分组数、消耗/GMV/ROI、
区间每日明细）。按 Esc 或点遮罩关闭。

• 投放分组明细表：到产品级，不是员工级。列有投放人、消耗、GMV、ROI、

订单数、退货率、取消率、退货+取消、在投天数。退货率那列可点排序。
最多显示 200 行。

---

一些容易被忽略的细节

• 黄金档：员工抽屉里的上品量会单独标出「黄金 XX」，指黄金品级的上新数。

这和员工等级是两回事——等级是青铜 / 白银 / 黄金 / 星耀，
当前 23 人里青铜 18 人、黄金 3 人（汤圆、潘佳例、小豪）、星耀 1 人（闫闫闫）、白银 1 人。
等级显示在员工抽屉标题和汇总表里。

• 区间覆盖提示：如果你手填的日期超出已采集范围，页面上会直接提示

「起始日早于已采集的 X」「结束日晚于已采集的 X」，并说明想看更早的数据要重新采集。

• 分档着色只在真超标时出现：正常是不着色的，整屏花花绿绿反而看不出问题。
• 首列横向吸顶：表格往右拖，员工姓名列始终留在左边，不会横向滚丢。
• 双击打开的分享副本没有刷新按钮：dashboard.html 是单文件，

file:// 打开时浏览器不允许网页执行本地程序，所以「刷新数据 / 全量刷新 / 日志」
三个按钮会自动隐藏，不给你点不动的假按钮。想要按钮就走上面的网址。

当前数据

区间 2026-09-13 ~ 2026-10-13（31 天），23 名员工 / 1098 个投放分组。
数据采集于 2026-10-13。

指标	数值
消耗	¥ 3,278,497
GMV	¥ 9,910,723
ROI	3.02
上品量	655
计划搭建数	1,943
新增视频	2,078（过审 1,747）
订单数	126,934

金额全线用 time_type=2「同步时间」，与站点「视频投流 → 投放数据」页一致。
已做三层对账（团队层 / 员工层 / 抽屉清单），偏差 0.00%。

看板上显示的永远是最新一次采集的结果，和上面这张表有出入是正常的——<br>点一下「刷新数据」就会同步。

---

文件都在哪

team-dashboard\
├─ dashboard.html        ← 看板本体（单文件，可双击离线打开）
├─ server.mjs            ← 本机服务，提供刷新按钮
├─ collect.mjs           ← 数据采集（--today 为增量）
├─ verify.mjs            ← 三层对账
├─ build.mjs             ← 构建，构建时自动同步设计系统令牌
├─ data.json             ← 采集结果
├─ dashkit.css           ← 界面设计系统
├─ DASHKIT.md            ← 设计系统说明书
├─ dashkit-demo.html     ← 设计系统效果样例
└─ dashkit-check.mjs     ← 设计系统校验器

几个 .cmd 快捷入口：

文件	作用
启动看板.cmd	双击启动服务并自动开浏览器
today.cmd	采集当天增量
refresh.cmd	全量刷新
run-server.cmd	静默启动，供计划任务调用

---

2026-10-13 更新了什么

一、界面规范抽出来了（DashKit）

原来这套界面只存在于看板这一个 HTML 里。现在抽成了可复用的设计系统，
换任何智能体来做，界面都能保持一致。

四个文件都在 team-dashboard/：

文件	作用
dashkit.css	样式本体，87 个变量 / 60+ 个组件类 / 16 个章节
DASHKIT.md	说明书：三条铁律、令牌表、组件清单、易错点、自检清单
dashkit-demo.html	效果样例，零内联样式，双击即看，不用起服务
dashkit-check.mjs	校验器，node dashkit-check.mjs，退出码非 0 即不合格

**给别的智能体时，把 dashkit.css 和 DASHKIT.md 一起给它，
让它引用 css，而不是重新描述界面。**

二、为什么不能靠描述

口头描述必然跑偏——每个智能体对「简洁专业」「淡雅蓝」的理解都不一样，
做出来每张表间距不一样、圆角不一样。
唯一可靠的办法是给文件不给描述：颜色、间距、圆角、字号全由一个文件决定，
没有自由发挥的余地。

三、途中抓到的两个真 bug

1. 状态灯红点是隐形的

看板的状态灯用了 --green 和 --red，但这两个变量从来没定义过。
全站十几个变量唯独漏了它们——采集失败时的红点是透明的，
真出故障你根本看不出来。

这类问题光看代码发现不了，得把「用了的变量」和「定义的变量」做差集才能查出来。

2. 规范自己违规

说明书第一条铁律是「颜色只准用变量，禁止写死」，
但 v1 的 dashkit.css 自己就有 59 处硬编码色值。
规范自己违规，规范就等于没用——别人打开这个文件照着学，必然也硬编码。
现已全部令牌化，组件区色值字面量归零。

四、加了机械校验器

说明书靠自觉，校验器才靠得住。node dashkit-check.mjs 会检查：

• 组件区有没有偷写色值
• 变量用了没定义（就是上面 bug 1 的克星）
• 暗色模式覆不覆盖所有颜色变量
• 示例页有没有偷写内联样式
• 关键组件有没有被删

改完 dashkit.css 请跑一遍，别靠肉眼。

五、看板与设计系统绑死

看板必须单文件（要能离线双击打开），样式无法外链。
但内联的那份必须从 dashkit.css 取——否则两边迟早分叉。

现在 build.mjs 构建时自动同步令牌，输出会打印「令牌已同步」。
改完 css 重建看板即可。

六、顺手修的界面问题

• 暗色模式原先漏了 8 个颜色变量（警示、正常、涨跌），

深色下会沿用亮色值，基本看不清。现已 52 个全覆盖。

• 示例页原来有三处内联样式，现在收进 css，真正做到零内联——

这才能证明 css 确实独立可用。

---

三条铁律（做看板的都要守）

1. 颜色只准用 CSS 变量，禁止写死十六进制色值
2. 红涨绿跌（--up 红 / --down 绿），中国大陆习惯，与欧美相反
3. 所有数字列加 class="num"，用等宽数字对齐，不许用空格凑

配色取向（为什么长这样）

主色 #1D4ED8 不是纯蓝，正常色 #0F6E56 不是纯绿，警示 #B45309 不是纯橙——
都压过饱和度。纯色在白底上会发光、显廉价。

这是这套界面看起来稳的根本原因，以后改色别改成纯色。

表格最容易做错的 7 处

1. border-collapse 必须写 separate —— 写成 collapse 表头吸顶直接失效
2. 首列必须 position: sticky; left: 0 —— 横向滚动时姓名列要留在原地
3. 首列必须给背景色 —— 只设 sticky 不设底色，下方内容会透出来
4. z-index 分层：表头 2 / 首列 1 / 两者交叉处 3，弄错会互相盖住
5. .filter 是 sticky 的，z-index 20，要压在表格之上
6. th,td 的 padding 是 8px 10px，别自己调
7. 响应式只改列数变量，不要重写布局规则

---

注意

• 服务只监听 127.0.0.1，不对外网开放，也没有鉴权。

别把端口改成 0.0.0.0——那等于同网络里谁都能触发采集、读取经营数据。

• 需要登录爆单369 的会话才能采集。会话过期的话采集会失败，日志里会提示。

数据从哪来

爆单369 后台的只读接口，只取数、不写入、不改动任何线上数据。
采集用到 team_id=147（沪联孟想团队）。

接口	用途
/promote/order/feed-count	团队层汇总
/promote/order/feed-group-list	员工 / 分组维度明细
/promote/order/feed-list	订单级明细，用于算退货率、取消率
/promote/report/user-list	人员信息

几个口径说明：

• 金额一律用 time_type=2「同步时间」，与站点后台「视频投流 → 投放数据」

页完全一致。用别的口径看板和后台就会对不上。

• video_num 是当天新增视频数（不含此前在投的）。
• video_run_num 是当前在跑快照，包含历史在投。

「今日快照」和「在投视频量」用的就是它。

• 拒审是 status=6。拒审率的分母是 status = 2 + 3 + 4 + 6，

排除待支付和结算中——这两个状态还没出结果，算进去会稀释拒审率。

接口有并发限制，采集器并发数压在 3，打太快会被限流。

出问题了怎么办

现象	原因 / 怎么办
点刷新没反应、日志为空	服务没起。双击 启动看板.cmd，或查计划任务 renxiao-dashboard-server
采集失败、提示需登录	爆单369 的会话过期了，重新登录后台让 collect.mjs 拿到新会话
数字和后台对不上	先确认后台看的是「视频投流 → 投放数据」页（time_type=2），口径不同必然对不上
日期范围选不了更早的	已采集范围就这么多，页面上会提示。想看更早的重跑 collect.mjs
页面显示旧数据没更新	浏览器缓存。看板已设 Cache-Control: no-store，若仍如此按 Ctrl+F5 强刷

---

记录于 2026-10-13 · 数据区间 2026-09-13 ~ 2026-10-13（31 天 / 23 人）