wangchuanli
86631ae7ab
## 项目定名 - 目录 wb_usage_portal → workbuddy-portal - Python 包 wb_usage → workbuddy_portal（含 session cookie 名） - 界面品牌统一为 WorkBuddy Portal；项目标识收敛到 config 单一来源 ## 容器化 - Dockerfile：多阶段构建，依赖层与源码解耦；非 root(uid 1000)；内置健康检查 - docker-compose.yml：单服务 + 绑定挂载 data/logs + 日志轮转 + TZ - docker/entrypoint.sh：幂等初始化 → exec serve（LF 行尾，已由 .gitattributes 锁定） - docker/healthcheck.py：纯标准库探活 /login（slim 镜像无 curl） - .dockerignore / .env.example；数据目录可用 WB_DATA_DIR 等环境变量覆盖 ## 文档 - docs/USER-GUIDE.md 用户使用手册（含 9 张真实界面截图） - docs/DEPLOYMENT.md 部署运维（Docker / 裸机 / 反代 / 备份 / 推 Gitea 注册表） - docs/ARCHITECTURE.md 架构与设计说明（含已知坑与红线、验证体系） - docs/API.md 接口参考（路径 / 参数 / 返回结构 / 错误码） - docs/FAQ.md 常见问题；docs/CHANGELOG.md 变更日志 ## 修复缺陷（8） 1. /records/export 必然 500：生成器在请求上下文销毁后才迭代，改用自建连接 2. 大屏页图表全白：相对路径把 echarts.min.js 解析成 /vendor/... → 404 3. /users 500：路由已注册但模板缺失 4. 明细页日期筛选失效：视图传 f.frm、模板读 f.from 5. 配置页维护按钮全死：调用了不存在的 WBU.bindMaint() 6. 审计只能看最近 40 条：LIMIT 写死 7. 明细页多跑一条无用 SELECT：day_list() 取了没人用 8. 登录页锁定阈值未从配置注入 ## 安全加固 - 新增 safe_next()：拒绝 //evil.com 等协议相对 URL 的开放重定向 - 缺 CSRF 的写请求统一 400 - 默认开启云端 HTTPS 证书校验（ssl_verify=1）；Cookie 是账号凭证 - 登录失败计数表加上限与 TTL - /logout 拆分为 POST(执行) + GET(仅提示)，防 <img src=/logout> 静默退出 - settings 内部簿记键 slot:* 读写两侧过滤，不再从 /api/settings 泄漏 ## 内部质量与工具 - 设置项写时校验 + 读时兜底，杜绝「一个手滑的数字让采集整个跑不起来」 - 全局 ValueError → 400：手写 query string 不再暴露 500 页面 - CSV 导出改 csv.writer 流式写入（原手工拼串，字段含逗号会串列） - bundle 明细加 20000 上限并回传 recordsTotal/recordsTruncated，不静默丢数据 - tools/smoke.py 离线回归 99 项；tools/check_live.py 真实 HTTP 56 项 - tools/shots.py Playwright 逐页截图 + JS 报错收集 ## 验证 - compileall 通过；smoke 99/99；对容器实例 check_live 56/56；截图 0 JS 报错 - 容器内采集实测成功（trigger=startup 补跑：新增 11 条）
125 行
6.4 KiB
HTML
125 行
6.4 KiB
HTML
{% extends "base.html" %}
|
||
{% block title %}概览 · {{ project_title }}{% endblock %}
|
||
{% block body %}
|
||
|
||
<div class="pagehead">
|
||
<div>
|
||
<h1>概览</h1>
|
||
<p class="lead">存档 {{ '{:,}'.format(totals.records) }} 条记录，覆盖 {{ totals.firstDay }} ~ {{ totals.lastDay }}</p>
|
||
</div>
|
||
<div class="actions">
|
||
<a class="btn" href="{{ url_for('views.dashboard') }}">打开用量大屏</a>
|
||
<button class="btn primary" id="btnCollect" type="button">立即采集一次</button>
|
||
</div>
|
||
</div>
|
||
<div id="collectMsg" class="flash" style="display:none"></div>
|
||
|
||
<div class="kpis">
|
||
<div class="kpi" style="--c:var(--cyan)">
|
||
<span>累计积分</span><b>{{ '%.2f'|format(totals.credits) }}</b>
|
||
<i>{{ totals.days }} 个活跃日 · 单次均价 {{ '%.2f'|format(totals.credits / totals.calls if totals.calls else 0) }}</i>
|
||
</div>
|
||
<div class="kpi" style="--c:var(--violet)">
|
||
<span>调用次数</span><b>{{ '{:,}'.format(totals.calls) }}</b>
|
||
<i>计费 {{ '{:,}'.format(totals.billableCalls) }} · 免费 {{ '{:,}'.format(totals.freeCalls) }}
|
||
（{{ '%.1f'|format(totals.freeCalls / totals.calls * 100 if totals.calls else 0) }}%）</i>
|
||
</div>
|
||
<div class="kpi" style="--c:var(--green)">
|
||
<span>今日积分</span><b>{{ '%.2f'|format(today_stat.credits) }}</b>
|
||
<i>{{ today_stat.calls }} 次调用{% if today_stat.partial %} · 残日截至 {{ today_stat.partial.hhmm }}{% endif %}
|
||
{% if yesterday.credits %}
|
||
· 昨日整日 {{ '%.2f'|format(yesterday.credits) }}
|
||
{% endif %}</i>
|
||
</div>
|
||
<div class="kpi" style="--c:var(--amber)">
|
||
<span>近 30 天积分</span><b>{{ '%.2f'|format(stat30.credits) }}</b>
|
||
<i>{% if stat30.delta %}<span class="delta {{ 'dn' if stat30.delta.credits < 0 }}">环比 {{ '%+.1f'|format(stat30.delta.credits) }}%</span>
|
||
· 前一区间 {{ '%.0f'|format(stat30.prev.credits) }}{% else %}无可比区间{% endif %}</i>
|
||
</div>
|
||
<div class="kpi" style="--c:var(--blue)">
|
||
<span>模型 / 客户端</span><b>{{ totals.models }} / {{ totals.clients }}</b>
|
||
<i>按积分排序见下表</i>
|
||
</div>
|
||
<div class="kpi" style="--c:{{ 'var(--green)' if mf.health.cookie else 'var(--red)' }}">
|
||
<span>采集健康</span><b>{{ '正常' if mf.health.cookie else '缺 Cookie' }}</b>
|
||
<i>{% if mf.health.lastRunAt %}最近采集 {{ mf.health.lastRunAt[5:16] }}{% else %}尚无采集记录{% endif %}</i>
|
||
</div>
|
||
</div>
|
||
|
||
<div class="grid2">
|
||
<section class="card">
|
||
<h2>调度状态</h2>
|
||
<table class="kv">
|
||
<tr><th>调度线程</th><td>{% if sch.running %}<span class="tag ok">运行中</span> 每 {{ sch.interval }}s 轮询{% else %}<span class="tag bad">未运行</span>{% endif %}</td></tr>
|
||
<tr><th>调度开关</th><td>{% if sch.enabled %}<span class="tag ok">已启用</span>{% else %}<span class="tag bad">已停用</span>{% endif %}</td></tr>
|
||
<tr><th>每日时刻</th><td>{{ sch.times | join(' · ') if sch.times else '—' }}{% if sch.catch_up %} <span class="tag">含启动补跑</span>{% endif %}</td></tr>
|
||
<tr><th>下次执行</th><td class="mono">{{ sch.next_run or '—' }}</td></tr>
|
||
<tr><th>采集互斥锁</th><td>{% if sch.lock %}<span class="tag warn">采集中</span>{% else %}<span class="tag ok">空闲</span>{% endif %}</td></tr>
|
||
<tr><th>Cookie</th><td>{% if mf.health.cookie %}<span class="tag ok">已配置</span>{% else %}<span class="tag bad">未配置</span> <a href="{{ url_for('views.config_page') }}">去配置</a>{% endif %}</td></tr>
|
||
<tr><th>服务器时间</th><td class="mono">{{ sch.now }}</td></tr>
|
||
</table>
|
||
<p class="hint">调度在 Web 进程内运行，不再需要计划任务或外部自动化。所有时刻与开关都在
|
||
<a href="{{ url_for('views.tasks') }}">任务管理</a>里改。</p>
|
||
</section>
|
||
|
||
<section class="card">
|
||
<div class="cardhead">
|
||
<h2>模型消耗 TOP</h2>
|
||
<span class="hint">按积分降序，取前 {{ models|length }} 名</span>
|
||
</div>
|
||
<div class="tablewrap">
|
||
<table class="tbl">
|
||
<thead><tr><th>模型</th><th class="num">调用</th><th class="num">积分</th><th class="num">单次均价</th><th class="num">免费占比</th></tr></thead>
|
||
<tbody>
|
||
{% for m in models %}
|
||
<tr><td>{{ m.name }}</td><td class="num">{{ m.calls }}</td>
|
||
<td class="num">{{ '%.2f'|format(m.credits) }}</td>
|
||
<td class="num">{{ '%.2f'|format(m.avgPerCall) }}</td>
|
||
<td class="num">{{ '%.0f%%'|format(m.freeRate * 100) }}</td></tr>
|
||
{% else %}
|
||
<tr><td colspan="5" class="empty">还没有数据，先点右上角「立即采集一次」</td></tr>
|
||
{% endfor %}
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
<p class="hint">客户端构成：{% for c in clients %}{{ c.name }} {{ '%.1f%%'|format(c.credits / totals.credits * 100 if totals.credits else 0) }}{% if not loop.last %} · {% endif %}{% else %}—{% endfor %}</p>
|
||
</section>
|
||
</div>
|
||
|
||
<section class="card">
|
||
<div class="cardhead">
|
||
<h2>最近采集</h2>
|
||
<a class="btn ghost sm" href="{{ url_for('views.tasks') }}">查看全部</a>
|
||
</div>
|
||
<div class="tablewrap">
|
||
<table class="tbl">
|
||
<thead><tr><th>#</th><th>触发</th><th>开始</th><th class="num">耗时</th><th class="num">云端</th>
|
||
<th class="num">新增</th><th class="num">重复</th><th class="num">冲突</th><th class="num">总数</th><th>结论</th></tr></thead>
|
||
<tbody>
|
||
{% for r in runs %}
|
||
<tr>
|
||
<td><a href="{{ url_for('views.logs', run=r.id) }}">{{ r.id }}</a></td>
|
||
<td><span class="tag {{ 'info' if r.trigger=='schedule' else ('accent' if r.trigger=='startup' else 'mute') }}">{{ r.trigger }}</span></td>
|
||
<td class="mono">{{ r.started_at[5:] if r.started_at else '—' }}</td>
|
||
<td class="num">{{ ((r.duration_ms or 0) / 1000) | round(1) }}s</td>
|
||
<td class="num">{{ r.fetched if r.fetched is not none else '—' }}</td>
|
||
<td class="num">{{ r.added }}</td>
|
||
<td class="num">{{ r.dup }}</td>
|
||
<td class="num">{% if r.conflicts %}<span class="tag warn">{{ r.conflicts }}</span>{% else %}0{% endif %}</td>
|
||
<td class="num">{{ r.total }}</td>
|
||
<td>{{ r.message or '—' }}</td>
|
||
</tr>
|
||
{% else %}
|
||
<tr><td colspan="10" class="empty">还没有采集记录，点右上角「立即采集一次」</td></tr>
|
||
{% endfor %}
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
</section>
|
||
|
||
{% endblock %}
|
||
|
||
{% block scripts %}
|
||
<script src="{{ url_for('static', filename='js/app.js') }}"></script>
|
||
{% endblock %}
|