一个人用的控制台,也值得认真做:把整条流水线搬进浏览器
这台机器上的自动发文系统,原来只能靠 SSH 敲命令。
抓一批:curl -X POST :8130/crawl。写一篇:curl -X POST :8130/flush。看状态:systemctl status,再 tail -f 三个日志。手机上根本没法弄。
后来做了个控制台,地址是 /blog-agent/。一个人用的东西,也值得认真做——因为你每天都要用它,做得好一点,一年能省几百次情绪。
一、页面结构
五个标签页,各管一件事:
| 标签 | 内容 |
|---|---|
| 概览 | 当前主题、队列待写、最近发布、今日花费、三个动作按钮 |
| 运行 | 流水线四阶段实时状态、跟她说、任务队列 |
| 服务 | 八个服务的状态/端口/内存/重启按钮 |
| 文章 | 26 篇文章列表,可搜索、可删除 |
| 设置 | 换主题、公冰蓝点评开关 |
没有框架,没有构建,一个 api.py 里塞了一段 HTML + CSS + JS,服务端直接吐出来。为什么?
因为这是内网工具,不是产品。用 Vue 要 npm、要打包、要 node_modules,出问题还要查 sourcemap。一个文件 60KB,改了直接 systemctl restart,三十秒生效。工具的复杂度要配得上它的规模。
二、动作按钮必须走同一条路
这里踩过一个典型的坑:
控制台有「抓 + 写 + 发」按钮。我一开始偷懒,让它去执行老的 shell 脚本:
1 | if path == '/blog-agent/run': |
结果点完之后,界面上流水线四个阶段一动不动。
原因很简单:pipeline.sh 直接调 rewrite.py、publish.sh,完全绕过 core。而阶段状态是 core 记的,所以永远不会变。
修法是把按钮接到 core 上:
1 | if path == '/blog-agent/run': |
core_async 起一个后台线程去 POST,立刻返回,前端靠轮询看进度。
教训:一个动作只能有一条执行路径。 有两条,就一定会有一条是坏的,而且坏了没人知道。
三、轮询:写完就不管是最容易犯的错
第一版轮询是这样的:
1 | function startPolling(){ |
三个问题:
- 只在
location.hash存在时才启动(点标签进「运行」时 hash 是空的,根本不启动) - 一旦发现不忙就
clearInterval,之后再也不刷新 - 切走再切回来,什么都不发生
重写之后:
1 | function pollTick(){ |
原则是:页面上显示的东西,只要用户看得见,就得是新的。「不忙就停」是省流量,省掉的是正确性。
四、服务重启时页面不能死
以前 systemctl restart blog-agent-api,打开着的页面就废了:数据全是「—」,按钮点了没反应,得手动刷新。
现在加了断线重连:
1 | function get(p){ |
配合顶部一条黄色状态条「正在重连服务…」,以及每 4 秒探一次 /status,通了自动重新加载。
用户感知是:卡两秒,然后自己好了。
五、数字要说得准
控制台显示「队列 0」,可队列里明明躺着两份日报。
因为读的是 jobs 表里 pending 的数量,而日报要等 flush 才进 jobs 表。中间那段时间,界面在骗人。
改法:
1 | queue_files = glob.glob(os.path.join(QUEUE, '*.md')) |
现在显示:
1 | 空闲 · 队列 2(待写 0)· 已发 19 篇 |
队列是盘上真实的文件,待写是已入队的任务,两个概念分开说,用户才不会困惑。
六、删除文章要删得干净
「文章」页加了个删除按钮。点下去要做的不是 rm 完了事:
- 校验 slug(
^[A-Za-z0-9\-_]+$,挡住../../etc/passwd) - 删
.md git add -A && git commit && git pushhexo generate重建- 原子发布到
/var/www
整个流程 20 秒,用户看到一个按钮变成「删除中…」,然后列表刷新。
这里也踩过坑:确认框的文案里混进了一个真实换行,导致整个 JS 语法错误,页面所有按钮全死。后来养成了习惯——改完控制台一定要:
1 | python3 -m ast # Python 语法 |
七、给个开关,别让我去改代码
「公冰蓝会不会自动点评」这件事,一开始写死在代码里。后来改成设置页的一个开关:
1 | A · 发布后自动点评 D · 只手动 |
后端就一行判断:
1 | if mode == 'off' and not force: |
能被产品化地打开关闭的行为,就不要写死在代码里。 改代码要重启、要验证、要记得改回来;点开关不用。
八、现在它长这样
1 | 概览 主题 健身 · 队列 0 · 已发 19 篇 |
它不漂亮,但它准。准的意思是:显示的每个数字,都能在服务器上找到对应的文件、进程或数据库行。
九、还缺什么
- 手机端没有专门的布局,现在只是靠 CSS 挤
- 没有操作审计,「谁在什么时候点了什么」查不到
- 没有历史曲线,花费和队列只有当前值
第 2 条我打算补,因为过几天我自己就会忘「昨天那个删除是几点做的」。