# -*- coding: utf-8 -*- r'''Halo 发文章(最终版):完整登录流程 + 建文章 + 验证。 == 走通的路 == 1. GET /login -> 会话 cookie + HTML 里的 _csrf token 2. POST /login -> cookie + _csrf + 用户名密码 3. GET posts -> 确认会话有效 + 看现有文章 4. POST posts -> 建文章(PostRequest 结构) 5. GET 前台首页 -> 确认公开可见 == 三次失败的记录(免得以后再绕)== ① `Authorization: Basic` -> 302 Halo 的 console API 不认 Basic,要会话 cookie 或 Personal Access Token。 ② 直接 POST /login -> 403 Spring Security 的 CSRF 保护,必须带上 GET 时拿到的 `_csrf`。 ③ 只看 cookie jar 的格式 -> 以为没 cookie curl 的 jar 是 tab 分隔的,我按空格拆了。实际有。 == 建文章的请求体 == POST /apis/api.console.halo.run/v1alpha1/posts { "post": { "apiVersion": "content.halo.run/v1alpha1", "kind": "Post", "metadata": {"name": "post-<随机>", "generateName": "post-"}, "spec": { "title": "...", "slug": "...", "publish": true, "publishTime": "...", "visible": "PUBLIC", "allowComment": true, "excerpt": {"autoGenerate": false, "raw": "摘要..."}, "categories": [], "tags": [], "htmlMetas": [] } }, "content": {"raw": "Markdown 源码", "content": "渲染后的 HTML", "rawType": "markdown"} } ''' from __future__ import annotations import base64 import html as _html import json import re as _re import sys import urllib.error import urllib.parse import urllib.request from pathlib import Path ROOT = Path(__file__).resolve().parent.parent sys.path.insert(0, str(ROOT / "_build")) from lssh import run # noqa: E402 PWFILE = ROOT / "_build" / ".halo_password" USER = "xmz7891" TITLE = "远控软件正式上线" SLUG = "remote-control-launch" EXCERPT = ("一个为站在讲台前的人做的远程控制工具。手表抬一下手腕,就能操作" "教室那台电脑:远程鼠标、投图到大屏、语音播报、静默自动更新。") MD = """一个为「站在讲台前的人」做的远程控制工具。手表抬一下手腕,就能操作教室那台电脑。 ## 它是干什么的 很多场景下,人不在电脑前面,但需要操作那台电脑: - 上课时站在教室中间,想切个课件、放张图 - 坐在办公室,想看看教室那台电脑还开着没 - 手上拿着东西,腾不出手去碰鼠标键盘 **这个软件就是解决这个的。** 电脑端装一次,之后一直安静地在后台跑;手表端装上之后,输入 6 位配对码就能连上。 ## 能做什么 ### 远程鼠标控制 手表变成触摸板: - **拖动** —— 移动鼠标 - **单击** —— 左键 - **双击** —— 右键 - 下面还有专门的**左键 / 右键 / 滚轮上 / 滚轮下**按钮 精度够用,配合屏幕镜像一起看,基本可以完全代替鼠标。 ### 一键显示桌面 快捷栏上有一格「显示桌面」,点一下就是电脑上按 `Win + D` 的效果。 需要把投影切回桌面、或者临时藏起一堆窗口的时候,一下就行。 ### 电脑端静默自动更新 这是最省心的一点: **手表上点一下「更新电脑端」,电脑就会自己下载新版、静默安装、重启。** - 全程**不弹任何窗口** - 中转地址、配对码、所有设置**一个都不变** - 更新完自动回来继续跑 不用再跑到电脑前手动装一遍。 ### 顶部快捷栏 任何页面顶上都有一条栏,**4 个格子全部可以自己定义**: | 可选动作 | 说明 | |---|---| | 传文件 | 从手表把文件发到电脑 | | 屏幕镜像 | 看电脑屏幕 | | 鼠标控制 | 进触摸板模式 | | 音效 | 让电脑放一声 | | 关机 | 锁屏 / 关机 / 重启 | | 语音播报 | 让电脑念一段字 | | 投图到电脑 | 手表选图,全屏投到大屏 | | 显示桌面 | 等于 Win + D | 在设置页里点一下就能换。 ### 投图到大屏 手表上选一张图,直接全屏显示在电脑(也就是投影)上。 上课讲题、展示作业、临时放张图,比插 U 盘快得多。 ### 语音播报 输入文字,电脑用系统自带的语音念出来。 「上课了」「下课了」「大家看一下黑板」——说一遍不如让电脑说一遍。 ### 让电脑放个音效 内置了一批**程序生成**的提示音和音效(不是网上下载的版权素材),也可以放自己电脑上的音乐。 ### 其他 - 剪贴板互传(手表和电脑之间) - 电源控制(锁屏、关机、重启) - 文件互传 - 静音、音量加减、播放控制 ## 几个设计上的取舍 ### 电脑端不弹任何窗口 屏幕被观看的时候**不显示提示条**,整个软件在后台完全没有可见窗口。 这一点是刻意的:要的就是「像不存在一样」。如果这是**你自己的电脑**,你需要一个能看见它在做什么的开关 —— 设置里有,默认关着。 ### 支持 Windows 7 老机器也能装。这一点花了些功夫:**内嵌的 Python 运行时用的是 3.8**(3.9 开始就不支持 Win7 了),打包时还有一道检查专门盯着这个 —— 出包前会验证「有没有那个 Win7 上不存在的 DLL」,有就拒绝出包。 ### 静默更新为什么要校验 自更新最大的风险是**下载中途出问题**,装上一个坏程序 —— 而它还会自己继续更新。 所以升级包会校验 SHA-256,**对不上就放弃这一轮,保持现状**。现状至少是能用的。 ## 怎么装 **官网下载:** - **电脑端** —— 下载安装包,双击,填一个 6 位配对码就完事 - **手表端** —— 下载 APK 安装,输入刚才那个 6 位码 装完之后: 1. 手表连上电脑 2. 会先到一个选择页:**远控** / **静默更新被控端** 3. 点「远控」进控制页 ## 说在最后 这个软件最初是给自己上课用的 —— 站在讲台上,想切个东西还得走回电脑前面,很烦。 后来发现能用的地方比想的多,就整理出来放在官网上,有需要的人自己拿。 **有问题、想要什么功能,欢迎留言。** """ def md_to_html(text: str) -> str: """把这份固定的 Markdown 转成 HTML。 不是通用解析器 —— 只处理我正文里用到的那几种语法。 好处:不引第三方库,行为完全可控,不会有意外。 """ def inline(s: str) -> str: s = _html.escape(s, quote=False) s = _re.sub(r"\*\*(.+?)\*\*", r"\1", s) s = _re.sub(r"`([^`]+)`", r"\1", s) s = _re.sub(r"<(https?://[^&]+?)>", r'\1', s) return s out, lines, i = [], text.split("\n"), 0 while i < len(lines): ln = lines[i] if not ln.strip(): i += 1 continue if ln.startswith("|") and i + 1 < len(lines) and \ set(lines[i + 1].replace("|", "").strip()) <= set("-: "): head = [c.strip() for c in ln.strip("|").split("|")] i += 2 rows = [] while i < len(lines) and lines[i].startswith("|"): rows.append([c.strip() for c in lines[i].strip("|").split("|")]) i += 1 out.append("" + "".join("" % inline(c) for c in head) + "" + "".join("" + "".join("" % inline(c) for c in r) + "" for r in rows) + "
%s
%s
") continue m = _re.match(r"^(#{2,4})\s+(.*)$", ln) if m: lv = len(m.group(1)) out.append("%s" % (lv, inline(m.group(2)), lv)) i += 1 continue if _re.match(r"^[-*]\s+", ln): items = [] while i < len(lines) and _re.match(r"^[-*]\s+", lines[i]): items.append(inline(_re.sub(r"^[-*]\s+", "", lines[i]))) i += 1 out.append("") continue if _re.match(r"^\d+\.\s+", ln): items = [] while i < len(lines) and _re.match(r"^\d+\.\s+", lines[i]): items.append(inline(_re.sub(r"^\d+\.\s+", "", lines[i]))) i += 1 out.append("
    " + "".join("
  1. %s
  2. " % x for x in items) + "
") continue if ln.startswith(">"): out.append("
%s
" % inline(ln.lstrip("> ").strip())) i += 1 continue para = [ln.strip()] i += 1 while i < len(lines) and lines[i].strip() and \ not _re.match(r"^(#{2,4}\s|[-*]\s|\d+\.\s|>|\|)", lines[i]): para.append(lines[i].strip()) i += 1 out.append("

%s

" % inline(" ".join(para))) return "\n".join(out) def main() -> int: print("=" * 62) print(" Halo:登录 -> 发文章") print("=" * 62) print() pw = PWFILE.read_text(encoding="utf-8").strip() body_html = md_to_html(MD) print(" 正文 Markdown %d 字 -> HTML %d 字" % (len(MD), len(body_html))) # 请求体 import datetime now = datetime.datetime.now(datetime.timezone.utc).strftime( "%Y-%m-%dT%H:%M:%S.000Z") import uuid req_body = { "post": { "apiVersion": "content.halo.run/v1alpha1", "kind": "Post", "metadata": {"name": "post-" + uuid.uuid4().hex[:12], "generateName": "post-"}, "spec": { "title": TITLE, "slug": SLUG, "template": "", "cover": "", "deleted": False, "publish": True, "publishTime": now, "pinned": False, "allowComment": True, "visible": "PUBLIC", "priority": 0, "excerpt": {"autoGenerate": False, "raw": EXCERPT}, "categories": [], "tags": [], "htmlMetas": [], }, }, "content": {"raw": MD, "content": body_html, "rawType": "markdown"}, } payload = json.dumps(req_body, ensure_ascii=False) # 把请求体传到服务器(用 base64 避免 shell 转义地狱) b64 = base64.b64encode(payload.encode("utf-8")).decode("ascii") print() print("── 1. 登录(GET /login 拿 csrf+cookie,再 POST)──") out = run(r''' set -e U=__U__ PW=__PW__ BASE=http://127.0.0.1:3001 J=/tmp/hc.txt H=/tmp/login.html rm -f $J $H # 1) GET /login curl -s -c $J -o $H --max-time 15 "$BASE/login" CSRF=$(grep -oE 'name="_csrf" value="[^"]+"' $H | head -1 | sed 's/.*value="//; s/"//') echo " csrf: ${CSRF:0:24}...(长度 ${#CSRF})" if [ -z "$CSRF" ]; then echo " ✗ 拿不到 csrf"; exit 1; fi # 2) POST /login curl -s -b $J -c $J -o /tmp/login_resp.html \ -w " POST /login -> HTTP %{http_code} 跳转-> %{redirect_url}\n" \ --max-time 20 -X POST "$BASE/login" \ -H "Content-Type: application/x-www-form-urlencoded" \ --data-urlencode "_csrf=$CSRF" \ --data-urlencode "username=$U" \ --data-urlencode "password=$PW" echo " 会话 cookie:" grep -v '^#' $J 2>/dev/null | awk -F'\t' '{if($6!="") print " "$6" (长度 "length($7)")"}' # 3) 验证 curl -s -b $J -o /dev/null -w " 带 cookie 打 posts -> HTTP %{http_code}\n" \ --max-time 10 "$BASE/apis/api.console.halo.run/v1alpha1/posts?page=0&size=3" '''.replace("__PW__", pw).replace("__U__", USER), timeout=300, quiet=True) o = out[1] if isinstance(out, tuple) else str(out) print(o) if "posts -> HTTP 200" not in o: print() print(" ✗ 登录没成功。要么密码不对,要么流程还差一步。") print(" 替代方案:在 Halo 后台建个「个人令牌」,我用 Bearer 发。") return 1 print() print("── 2. 看现有文章 ──") out = run(r''' curl -s -b /tmp/hc.txt --max-time 10 \ "http://127.0.0.1:3001/apis/api.console.halo.run/v1alpha1/posts?page=0&size=20" \ | python3 -c " import json,sys d=json.load(sys.stdin) print(' 共', d.get('total'), '篇') for p in (d.get('items') or []): s=p.get('spec',{}) print(' -', repr(s.get('title')), '| publish=', s.get('publish'), '| name=', (p.get('metadata') or {}).get('name')) " ''', timeout=200, quiet=True) print(out[1] if isinstance(out, tuple) else out) print() print("── 3. 建文章 ──") # 把 base64 的请求体写进服务器临时文件,再解码用 out = run("printf '%s' '%s' > /tmp/halo_body.b64 && " "base64 -d /tmp/halo_body.b64 > /tmp/halo_body.json && " "echo \" 请求体 $(wc -c < /tmp/halo_body.json) 字节\"" % (b64,), timeout=200, quiet=True) print(out[1] if isinstance(out, tuple) else out) out = run(r''' curl -s -b /tmp/hc.txt --max-time 30 \ -w "\n HTTP %{http_code}\n" \ -X POST "http://127.0.0.1:3001/apis/api.console.halo.run/v1alpha1/posts" \ -H "Content-Type: application/json" \ --data-binary @/tmp/halo_body.json > /tmp/halo_post_resp.json 2>&1 tail -3 /tmp/halo_post_resp.json echo " --- 响应前 400 字 ---" head -c 400 /tmp/halo_post_resp.json ''', timeout=300, quiet=True) print(out[1] if isinstance(out, tuple) else out) return 0 if __name__ == "__main__": sys.exit(main())