这台机器上的自动发文系统,原来只能靠 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
2
if path == '/blog-agent/run':
start_script('pipeline.sh')

结果点完之后,界面上流水线四个阶段一动不动。

原因很简单:pipeline.sh 直接调 rewrite.py、publish.sh,完全绕过 core。而阶段状态是 core 记的,所以永远不会变。

修法是把按钮接到 core 上:

1
2
3
if path == '/blog-agent/run':
core_async('/pipeline', {})
return self._json(200, {'ok': True, 'started': 'pipeline'})

core_async 起一个后台线程去 POST,立刻返回,前端靠轮询看进度。

教训:一个动作只能有一条执行路径。 有两条,就一定会有一条是坏的,而且坏了没人知道。

三、轮询:写完就不管是最容易犯的错

第一版轮询是这样的:

1
2
3
4
5
function startPolling(){
pipeTimer = setInterval(() => {
get('/progress').then(d => { render(d); if (!d.busy) clearInterval(pipeTimer); });
}, 2000);
}

三个问题:

  1. 只在 location.hash 存在时才启动(点标签进「运行」时 hash 是空的,根本不启动)
  2. 一旦发现不忙就 clearInterval,之后再也不刷新
  3. 切走再切回来,什么都不发生

重写之后:

1
2
3
4
5
6
7
8
9
function pollTick(){
get('/progress').then(d => {
render(d);
schedulePoll(d && d.busy ? 2000 : 8000); // 忙 2 秒,闲 8 秒
});
}
document.addEventListener('visibilitychange', () => {
if (!document.hidden && onRunTab) startPolling();
});

原则是:页面上显示的东西,只要用户看得见,就得是新的。「不忙就停」是省流量,省掉的是正确性。

四、服务重启时页面不能死

以前 systemctl restart blog-agent-api,打开着的页面就废了:数据全是「—」,按钮点了没反应,得手动刷新。

现在加了断线重连:

1
2
3
4
5
6
function get(p){
const attempt = n => fetch(p).then(r => r.json()).catch(err =>
n > 1 ? new Promise(res => setTimeout(res, 500)).then(() => attempt(n - 1))
: (setOffline(true), Promise.reject(err)));
return attempt(3).then(d => (setOffline(false), d));
}

配合顶部一条黄色状态条「正在重连服务…」,以及每 4 秒探一次 /status,通了自动重新加载。

用户感知是:卡两秒,然后自己好了。

五、数字要说得准

控制台显示「队列 0」,可队列里明明躺着两份日报。

因为读的是 jobs 表里 pending 的数量,而日报要等 flush 才进 jobs 表。中间那段时间,界面在骗人。

改法:

1
2
3
queue_files = glob.glob(os.path.join(QUEUE, '*.md'))
pending = jobs_stat.get('write', 0) # 只算 write,别把点评算进来
return {'queue': len(queue_files), 'pending': pending, ...}

现在显示:

1
空闲 · 队列 2(待写 0)· 已发 19 篇

队列是盘上真实的文件,待写是已入队的任务,两个概念分开说,用户才不会困惑。

六、删除文章要删得干净

「文章」页加了个删除按钮。点下去要做的不是 rm 完了事:

  1. 校验 slug(^[A-Za-z0-9\-_]+$,挡住 ../../etc/passwd)
  2. 删 .md
  3. git add -A && git commit && git push
  4. hexo generate 重建
  5. 原子发布到 /var/www

整个流程 20 秒,用户看到一个按钮变成「删除中…」,然后列表刷新。

这里也踩过坑:确认框的文案里混进了一个真实换行,导致整个 JS 语法错误,页面所有按钮全死。后来养成了习惯——改完控制台一定要:

1
2
python3 -m ast           # Python 语法
node --check console.js # JS 语法

七、给个开关,别让我去改代码

「公冰蓝会不会自动点评」这件事,一开始写死在代码里。后来改成设置页的一个开关:

1
A · 发布后自动点评     D · 只手动

后端就一行判断:

1
2
if mode == 'off' and not force:
return [{'skipped': 'mentorMode=off'}]

能被产品化地打开关闭的行为,就不要写死在代码里。 改代码要重启、要验证、要记得改回来;点开关不用。

八、现在它长这样

1
2
3
4
5
6
概览    主题 健身 · 队列 0 · 已发 19 篇
今天 213,272 tok · ¥0.4809 · 66 次调用
运行 流水线 4 阶段,运行时带秒表
服务 8 个单元,绿点/红灯,单点重启
文章 26 篇,可搜可删
设置 主题、点评开关

它不漂亮,但它准。准的意思是:显示的每个数字,都能在服务器上找到对应的文件、进程或数据库行。

九、还缺什么

  • 手机端没有专门的布局,现在只是靠 CSS 挤
  • 没有操作审计,「谁在什么时候点了什么」查不到
  • 没有历史曲线,花费和队列只有当前值

第 2 条我打算补,因为过几天我自己就会忘「昨天那个删除是几点做的」。