magpie-page-token-widget 0.1.1 → 0.3.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +45 -0
- package/NOTICE +1 -1
- package/README.en.md +235 -0
- package/README.md +139 -82
- package/index.mjs +51 -0
- package/lib/atomic.mjs +66 -0
- package/lib/collector.mjs +510 -123
- package/lib/forward.mjs +63 -20
- package/lib/network.mjs +179 -0
- package/lib/normalize.mjs +66 -12
- package/lib/server.mjs +661 -79
- package/lib/state.mjs +200 -14
- package/lib/tailnet.mjs +204 -12
- package/mobile/app.js +2 -2
- package/mobile/index.html +1 -1
- package/mobile/style.css +3 -3
- package/package.json +6 -2
- package/scriptable/SetupUsageWidget.js +112 -58
- package/scriptable/UsageWidget.js +96 -24
- package/scripts/check-syntax.mjs +43 -0
- package/scripts/run-tests.mjs +28 -0
- package/ui/app.js +484 -30
- package/ui/index.html +53 -3
- package/ui/style.css +104 -1
- package/ui/timing.mjs +16 -0
package/README.md
CHANGED
|
@@ -1,27 +1,30 @@
|
|
|
1
1
|
# magpie-page-token-widget
|
|
2
2
|
|
|
3
|
+
> [English](README.en.md) · 中文 · 当前版本 0.3.3(变更见 [CHANGELOG.md](CHANGELOG.md))
|
|
4
|
+
|
|
3
5
|
把 iPhone 桌面的额度组件接进 Magpie:装上这个插件,扫一次码,手机上就能显示 Codex、MiniMax、GLM 各家套餐的剩余额度与真实 Token 用量。
|
|
4
6
|
|
|
5
|
-
装这个插件不需要再跑安装脚本、装 Node.js
|
|
7
|
+
装这个插件不需要再跑安装脚本、装 Node.js、建计划任务,也不需要你自己开端口转发:默认是 Tailscale 模式,插件自己把服务跑起来、自己建好尾网里的转发,手机扫一次码就配对好了。
|
|
6
8
|
|
|
7
9
|
> 数据来自你自己的 Magpie,脚本里不含任何密钥。组件显示的仍是 Magpie 的口径。
|
|
8
10
|
|
|
9
|
-
|
|
11
|
+
插件页长这样:上面是扫码配对,下面依次是状态、数据更新、网络连接、设备管理、显示哪些订阅、高级设置。
|
|
10
12
|
|
|
11
13
|
## 它做什么
|
|
12
14
|
|
|
13
15
|
- 插件页给出一个二维码。用 iPhone 的相机扫一下,Safari 打开配对页,下载组件脚本,用 Scriptable 打开它,长按桌面加组件就行了。
|
|
14
16
|
- 组件里显示每家订阅的剩余额度、5 小时与周额度窗口的百分比、重置倒计时、今日 Token、七日趋势和各家排行。参数可以选订阅(`codex`、`minimax`、`glm`,或 `codex@账号名`),也可以把百分比换成已用(`|used`)。
|
|
15
|
-
-
|
|
16
|
-
- 勾一个厂商=这个厂商的所有账号都显示;只勾一个账号=只有这个账号。勾选框显示的就是手机上会出现的卡片。
|
|
17
|
+
- 插件页是一个配置中心,分五块:**订阅展示**(勾选手机上要出现的卡片)、**数据更新**(多久读一次)、**网络连接**(尾网状态、连接路径、本机网卡)、**设备管理**(已配对的手机,可单独撤销)、**高级设置**(端口和网关这些看一眼就行的参数)。
|
|
17
18
|
- 点一下手机上的组件,Safari 会打开手机版用量页:每家订阅的剩余额度、今日与近七日的 Token、模型/厂商/客户端排行,和电脑上看到的是同一份数据。
|
|
18
|
-
- 服务只读 Magpie
|
|
19
|
+
- 服务只读 Magpie 的本地接口。默认(本机监听 + Tailscale 转发)时,服务只在本机打开,手机经尾网的转发进来,令牌存放在 Magpie 自己的目录里。
|
|
19
20
|
|
|
20
21
|
## 需要什么
|
|
21
22
|
|
|
22
23
|
- Magpie(桌面版,插件宿主是 Bun)。
|
|
23
|
-
- Tailscale:电脑和 iPhone 都在同一个尾网里,插件靠它找到地址。
|
|
24
24
|
- iPhone 上的 [Scriptable](https://scriptable.app/)。
|
|
25
|
+
- Tailscale:**只有默认模式需要**。电脑和 iPhone 都在同一个尾网里,插件靠它找到地址、自己建转发。改用自己的服务器或可信内网地址时,Tailscale 不再是必需品。
|
|
26
|
+
|
|
27
|
+
三种连接方式(默认 Tailscale、自定义外部地址、局域网直连)见下面的「三种连接方式」。
|
|
25
28
|
|
|
26
29
|
## 安装
|
|
27
30
|
|
|
@@ -45,142 +48,196 @@ magpie plugin add ./magpie-page-token-widget
|
|
|
45
48
|
4. 在「文件」App 里打开刚下载的 `UsageWidget.js`,选「共享 → 用 Scriptable 打开」。
|
|
46
49
|
5. 长按 iPhone 桌面空白处,添加 Scriptable 小组件,选择 `UsageWidget`。
|
|
47
50
|
|
|
48
|
-
|
|
51
|
+
配对码只能用一次,而且只活十分钟:十分钟之后它就废了,插件页会自己换一个新的出来(不用手点),所以第一次配对不用先去点「重新生成配对码」;用掉之后旧码立刻作废。**每配一台手机,它都会拿到属于自己的那枚只读令牌**,服务端只留这枚令牌的哈希,明文只在配对的那一次出现,之后再也拿不出来。一台手机作废,只停这一台。
|
|
49
52
|
|
|
50
|
-
|
|
53
|
+
0.1 时代那枚给所有手机共用的共享令牌已经没有了:升级之后它立刻作废,手里还拿着旧令牌的手机要重新扫一次码配对,重新拿到自己的令牌。
|
|
51
54
|
|
|
52
|
-
|
|
55
|
+
猜配对码是没有便宜的:同一个配对码连续猜错十次就锁五分钟,锁的是这个码本身,不是那台机器。原因是转发过来的手机在服务器看来都是本机的回环地址,按地址锁的话,尾网上任何一个人猜错十次就能把所有人的配对都关上。请求头里的 `X-Forwarded-For` 谁都能写,服务器不看它。
|
|
53
56
|
|
|
54
|
-
|
|
57
|
+
服务还有一本总账:五分钟里猜错一百次(不管猜的是哪个码),配对页、组件脚本和配对接口一起先关上,等五分钟满了自动恢复。电脑上点一次「重新生成配对码」会把总账清空,手动马上就能再配。真正让配对码难猜的不是这两道门,而是它有九十六位随机数、只活十分钟、只能用一次。
|
|
55
58
|
|
|
56
|
-
|
|
59
|
+
手机脚本把令牌存在 Scriptable 的钥匙串里,同一台 iPhone 上的三个组件共用这一枚令牌。
|
|
57
60
|
|
|
58
|
-
|
|
61
|
+
不想扫码也行:插件页的「设备管理」里可以给某台手机单独发一枚令牌,把它和「服务地址」填进 `scriptable/SetupUsageWidget.js`(在 Scriptable 里新建一个脚本粘贴运行)也行。服务地址可以填 Tailscale 地址(`http://100.x.x.x:8791`)、自己内网里的地址(`http://192.168.1.50:8791`),也可以填你自己配好的 HTTPS 域名(`https://my-server`)。**公网上的明文 HTTP 地址会被拒绝**,理由和规则见下面「三种连接方式」。
|
|
59
62
|
|
|
60
|
-
|
|
61
|
-
|---|---|---|
|
|
62
|
-
| 小号 | 单家额度、重置倒计时、今日 Token | `codex`(默认)、`minimax`、`glm`;某账号写作 `codex@账号名`;加 `|used` 改显已用 |
|
|
63
|
-
| 中号 | 每页最多 6 个;1–4 个并排,5–6 个两行三列;今日 Token | 留空;`page=2` 查看第二页 |
|
|
64
|
-
| 大号 | 每页最多 6 个;两列卡片,显示主额度、重置时间及第二窗口百分比;今日与近七日 Token | 留空;`page=2` 查看第二页 |
|
|
63
|
+
## 设备管理
|
|
65
64
|
|
|
66
|
-
|
|
65
|
+
「设备管理」里列出所有配过的设备:名字、什么时候配的、最后一次是什么时候、什么时候撤销的。每一条都能改名字,都能单独撤销;撤销一台手机,别的手机照常读数。想加一台新手机,点「给这台手机一个令牌」,把生成的那枚明文令牌填进手机即可(只显示这一次)。
|
|
67
66
|
|
|
68
|
-
|
|
67
|
+
## 数据更新
|
|
69
68
|
|
|
70
|
-
|
|
69
|
+
服务不会每个手机请求都去读一遍 Magpie。它拿着一份快照,快照一分钟内是新鲜的,直接给;过期了才去读,而且所有同时来的请求共用同一次读取。
|
|
71
70
|
|
|
72
|
-
|
|
71
|
+
读的时候最多等两三秒:读回来了就立刻给新的;还没回来就先给旧的,标成「旧数据」,后台继续读。
|
|
73
72
|
|
|
74
|
-
|
|
75
|
-
magpie plugin options magpie-page-token-widget '{"port":8890}'
|
|
76
|
-
```
|
|
73
|
+
平时多久读一次可以选:
|
|
77
74
|
|
|
78
|
-
|
|
75
|
+
| 策略 | 说明 |
|
|
76
|
+
|---|---|
|
|
77
|
+
| 智能更新(默认) | 有人看的时候每分钟一次;十分钟没人看改成五分钟一次;半小时没人看就基本不自己读了,等有人来再说 |
|
|
78
|
+
| 每分钟 | 固定每分钟读一次 |
|
|
79
|
+
| 每两分钟 | 固定每两分钟读一次 |
|
|
80
|
+
| 每五分钟 | 固定每五分钟读一次 |
|
|
79
81
|
|
|
80
|
-
|
|
82
|
+
在插件页改一下就立刻生效,不用重启 Magpie。
|
|
81
83
|
|
|
82
|
-
|
|
84
|
+
## 网络连接
|
|
83
85
|
|
|
84
|
-
|
|
86
|
+
「网络连接」里能看到:Tailscale 装没装、连上没有、本机的尾网地址、MagicDNS 名字、同一尾网里的 iPhone,以及现在这通连接走的是哪条路。
|
|
85
87
|
|
|
86
|
-
|
|
87
|
-
magpie plugin rm magpie-page-token-widget
|
|
88
|
-
```
|
|
88
|
+
连接分三种,看的时候别混:
|
|
89
89
|
|
|
90
|
-
|
|
90
|
+
- **直连(Direct)**:Tailscale 在两台机器之间直接加密通信,通常是同一个局域网里自动找到对方地址之后走这条路,最快。
|
|
91
|
+
- **经由尾网中继设备(Peer Relay)**:两台机器之间没有直连路径,借了尾网里第三台设备转发。
|
|
92
|
+
- **经由 Tailscale 中继服务器(DERP)**:连不上也没有中继设备时,流量走 Tailscale 自己的中继服务器兜底,最慢但最稳。
|
|
91
93
|
|
|
92
|
-
|
|
94
|
+
读不出来的时候显示「还不知道」,不猜。「诊断连接」按钮会真的 ping 一次那台手机,把结果写出来;平时不会自己 ping,省得一直起 Tailscale 子进程。
|
|
93
95
|
|
|
94
|
-
|
|
95
|
-
- 令牌是本机随机生成的,只读,存在 Magpie 的配置目录里;只有本机的插件页和拿着配对码的手机能拿到。
|
|
96
|
-
- 服务只在本机(127.0.0.1)上监听,手机是经 Tailscale 的转发进来的,没有公网入口,也不需要防火墙规则。
|
|
96
|
+
本机的网卡也在这一块里列着:网卡名、IPv4、IPv6、子网前缀、是 Tailscale 网卡还是 Wi-Fi/有线/虚拟网卡。**这些地址只给电脑上的你看,手机接口拿不到。** 列出它们是为了排障:手机连不上的时候,先看看这台电脑在局域网里的地址,再看尾网地址是不是变了。
|
|
97
97
|
|
|
98
|
-
|
|
98
|
+
**默认仍然走 Tailscale**,不会因为这台电脑有个 192.168.x.x 就让手机改走局域网直连。原因是:局域网直连要处理明文 HTTP(或另配 HTTPS)、DHCP 换地址、iOS 的本地网络权限等等一串事情,做不好就是新的安全口子;而且尾网地址在手机和电脑上都是稳的。
|
|
99
99
|
|
|
100
|
-
|
|
101
|
-
node --test test/service.test.mjs
|
|
102
|
-
```
|
|
100
|
+
想走自己的路,请看下面那一节:那是自己选、自己填、自己负责的,不是自动发生的。
|
|
103
101
|
|
|
104
|
-
|
|
102
|
+
## 三种连接方式
|
|
105
103
|
|
|
106
|
-
|
|
104
|
+
这是三件事,看的时候别混。控制台「网络连接」里随时能看出当前用的是哪一种。
|
|
107
105
|
|
|
108
|
-
|
|
106
|
+
### 一、默认:Tailscale
|
|
109
107
|
|
|
110
|
-
|
|
108
|
+
- 装好就是这样,什么都不用配。插件找到本机的尾网地址,自己在尾网里建一条转发(`tailscale serve --tcp`),手机从 100.x 的地址连进来。
|
|
109
|
+
- 控制台留在 127.0.0.1,只有手机那一侧在尾网上。尾网里的请求不会被当成本机的请求,所以手机看不到控制台,也拿不到控制台的令牌。
|
|
110
|
+
- 端口上已经有别人的转发时,插件不会动它,控制台会说明转发没建起来。
|
|
111
|
+
- 手机连不上时先看三件事:iPhone 在不在这个尾网里、Tailscale 是不是登录着、两端之间有没有直连路径。
|
|
112
|
+
- 走哪条路看「本机连接路径」:**直连(Direct)**是两端直接加密通信,通常是同一个局域网里自动找到对方地址,最快;**经由尾网中继设备(Peer Relay)**是借了尾网里第三台设备转发;**经由 Tailscale 中继服务器(DERP)**是既连不上也没有中继设备时的兜底,最慢但最稳。这三条路都不保证一定通——DERP 是最后的退路,不是「一定能连上」的保证。
|
|
111
113
|
|
|
112
|
-
|
|
114
|
+
### 二、自定义外部地址:自己的服务器、反向代理或自建 Headscale
|
|
113
115
|
|
|
114
|
-
|
|
116
|
+
在「网络连接」的输入框里填一个地址,手机配对时拿到的就是这个地址,组件和手机上的用量页都用它。填了以后插件不再建 Tailscale 转发,这件事上不再需要 Tailscale 的任何东西。
|
|
115
117
|
|
|
116
|
-
|
|
117
|
-
- Tailscale, with the computer and the iPhone in the same tailnet.
|
|
118
|
-
- [Scriptable](https://scriptable.app/) on the iPhone.
|
|
118
|
+
能填什么:
|
|
119
119
|
|
|
120
|
-
|
|
120
|
+
| 地址 | 能不能用 | 说明 |
|
|
121
|
+
|---|---|---|
|
|
122
|
+
| `https://my-server` / `https://my-server.example.com` | 能 | HTTPS 地址可以写任何域名。令牌和用量在传输里是加密的。 |
|
|
123
|
+
| `http://192.168.1.50:8791`、`http://10.0.0.7:8791`、`http://172.16.3.9:8791` | 能 | RFC1918 的私网地址。 |
|
|
124
|
+
| `http://100.64.0.5:8791` | 能 | Tailscale(和自建 Headscale)的地址段。 |
|
|
125
|
+
| `http://[fd00::1]:8791`、`http://[::1]:8791` | 能 | IPv6 的 ULA 和本机回环。 |
|
|
126
|
+
| `http://box.local:8791`、`http://myserver:8791` | 能 | 保留给内网的域名,或本机解析器里的单段名字。 |
|
|
127
|
+
| `http://example.com`、`http://93.184.216.34:8791` | **不能** | 公网上的明文 HTTP:令牌会在路上被看见。 |
|
|
121
128
|
|
|
122
|
-
|
|
123
|
-
magpie plugin add magpie-page-token-widget
|
|
124
|
-
```
|
|
129
|
+
服务器上的检查和手机上的安装器用的是同一套规则,所以两边不会给出相反的结论。
|
|
125
130
|
|
|
126
|
-
|
|
131
|
+
升级到 0.3.3 之后,配置里存着的地址会重新按这套规则过一遍:以前填过的**公网上的明文 HTTP 地址不再被接受**,插件会把它从配置里去掉,并在控制台上写明原因,然后回到 Tailscale 的转发。内网地址、Tailscale 地址和 HTTPS 地址都不受影响,手机上已经配好的令牌也不用重新配对。
|
|
127
132
|
|
|
128
|
-
|
|
133
|
+
反向代理的要求:
|
|
129
134
|
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
+
- **这一版不支持带路径的地址。** 请用一个独立域名,把它的**根路径**转到插件服务,然后填 `https://my-server`。填 `https://my-server/widget` 会被明确拒绝,而不是半通不通。
|
|
136
|
+
- 代理要转到**手机那一侧的端口**(默认 8791),不是控制台的端口(默认 8790):控制台永远只留在本机,代理只应该把手机那一侧放出去。
|
|
137
|
+
- 代理必须把原来的 `Host` 原样传过去(`proxy_set_header Host $host;`)。插件靠它认出「这个请求是冲着我来的」,伪造的 `Host` 会被拒绝。
|
|
138
|
+
- 插件**不信任** `X-Forwarded-Proto`、`X-Forwarded-Host` 这些请求头:谁都能写它们。走 HTTPS 还是 HTTP,只看你在控制台里填的那个地址。
|
|
139
|
+
- 代理自己终结 HTTPS、再用 HTTP 回源到插件,是可以的:插件只按你填的地址判断对错,不看中间那一段。
|
|
135
140
|
|
|
136
|
-
|
|
141
|
+
要当心的事:
|
|
137
142
|
|
|
138
|
-
|
|
143
|
+
- 走明文 HTTP 时,令牌就在里面走。除非地址是上面表里那些可信内网,否则只在自己信得过的网里用。
|
|
144
|
+
- 手机直连局域网地址时,iPhone 会问「本地网络」的权限,要允许。
|
|
145
|
+
- 地址会动:路由器换了地址,手机就找不到了,那时候来控制台改一下。
|
|
146
|
+
- 防火墙:手机要从局域网进来,Windows 的防火墙可能会挡住这个口,第一次要放行一次(只放行「专用网络」就够了)。
|
|
139
147
|
|
|
140
|
-
|
|
148
|
+
### 三、LAN 直连:手机不进尾网
|
|
141
149
|
|
|
142
|
-
|
|
150
|
+
不想用 Tailscale,只在同一个局域网里用:让手机那一侧直接在这台电脑的局域网地址上开一个口,手机走局域网地址连进来。
|
|
143
151
|
|
|
144
|
-
|
|
152
|
+
- 开的只有**手机那一侧**这个口,控制台永远关在本机(127.0.0.1),手机接口里没有控制台。
|
|
153
|
+
- 在「网络连接」里点某个网卡后面的「手机从这里连」,或者自己填地址(`http://192.168.1.50:8791`)并在「这台电脑的网卡」里选一个地址,插件就在那个地址上打开手机那一侧的端口。
|
|
154
|
+
- iPhone 会问「本地网络」的权限,要允许;Windows 防火墙第一次要放行一次。
|
|
155
|
+
- 电脑的局域网地址会变(DHCP),手机就找不到了,这时候回控制台重新选一次。
|
|
156
|
+
- 这条路是明文 HTTP,令牌在里面走。
|
|
157
|
+
|
|
158
|
+
**怎么彻底关掉它**:点「网络连接」里的**「恢复 Tailscale 默认连接」**。这个动作会清掉自己填的地址、清掉文件里记着的网络设置、**把局域网那个口真的关掉**(不是只改配置),再把 Tailscale 的转发建回来。关完之后控制台会写明现在生效的是哪一种连接方式。
|
|
159
|
+
|
|
160
|
+
## 手机上的用量页
|
|
145
161
|
|
|
146
|
-
|
|
162
|
+
点一下桌面上的组件,Safari 会打开手机版的用量页:每家订阅的剩余额度、今日与近七日的 Token、模型/厂商/客户端排行,和电脑上看到的是同一份数据。
|
|
163
|
+
|
|
164
|
+
页面用组件里的那个只读令牌打开,令牌只走地址栏的 `#token=` 一段,页面打开后立刻把它抹掉,之后由 Scriptable 自己记着。手机版页面只在尾网这一侧提供(填了自己的地址以后,就是在你自己的网上),电脑上的控制台仍然只在本机。
|
|
165
|
+
|
|
166
|
+
## 组件参数
|
|
167
|
+
|
|
168
|
+
| 尺寸 | 内容 | Widget Parameter |
|
|
147
169
|
|---|---|---|
|
|
148
|
-
|
|
|
149
|
-
|
|
|
150
|
-
|
|
|
170
|
+
| 小号 | 单家额度、重置倒计时、今日 Token | `codex`(默认)、`minimax`、`glm`;某账号写作 `codex@账号名`;加 `\|used` 改显已用 |
|
|
171
|
+
| 中号 | 每页最多 6 个;1–4 个并排,5–6 个两行三列;今日 Token;有周限额时和重置时间写在同一行(5–6 个订阅挤成两行时只留 5 小时额度) | 留空;`page=2` 查看第二页 |
|
|
172
|
+
| 大号 | 每页最多 6 个;两列卡片,显示主额度、重置时间及第二窗口百分比;今日与近七日 Token | 留空;`page=2` 查看第二页 |
|
|
151
173
|
|
|
152
|
-
|
|
174
|
+
参数里的账号名是现在的账号名。控制台「显示哪些订阅」里,每一行都写着组件认得的参数,照抄过去就行。账号改了名字以后参数会找不到,小号组件不会再空着:它会先给你看第一张卡,旁边写一句「没有找到 xxx」。
|
|
153
175
|
|
|
154
|
-
|
|
176
|
+
数字前面永远写着方向:「剩余」还是「已用」。进度条在亮色和暗色里都是同一种墨(只是深浅不同),夜里不会发亮成警报;只有数字在快用完的时候才会变成橙色或红色。
|
|
155
177
|
|
|
156
|
-
##
|
|
178
|
+
## 生命周期
|
|
157
179
|
|
|
158
|
-
|
|
180
|
+
组件随 Magpie 运行。关掉 Magpie 之后,手机上显示的是最后一次拿到的结果,重新打开 Magpie 就会更新。这和原来那个用计划任务常驻的服务不同,是"插件"这个形态的取舍。
|
|
181
|
+
|
|
182
|
+
Magpie 停止或重载这个插件时,插件会走一遍自己的清理:关掉自己开的监听、撤掉自己建的转发。进程被强杀时做不了这一步,见下面「卸载」。
|
|
183
|
+
|
|
184
|
+
## 端口
|
|
185
|
+
|
|
186
|
+
服务默认听 8790,手机那一侧是 8791。端口上冲突时换一个:
|
|
159
187
|
|
|
160
188
|
```bash
|
|
161
189
|
magpie plugin options magpie-page-token-widget '{"port":8890}'
|
|
162
190
|
```
|
|
163
191
|
|
|
164
|
-
|
|
192
|
+
改完要重启 Magpie。默认(Tailscale)模式下,插件会在尾网里给这个端口建一条转发(`tailscale serve --tcp`),手机从 100.x 地址连进来;端口上已经有别人的转发时,插件不会动它。
|
|
193
|
+
|
|
194
|
+
转发指向的是手机那一侧的端口(默认比服务端口大 1,即 8791),控制台留在 127.0.0.1:8790。尾网里的请求落在这条转发上,不会被当成本机的请求,所以手机看不到控制台,也拿不到令牌。改用自己的外部地址以后,就不再建这条转发。
|
|
195
|
+
|
|
196
|
+
插件会把自己建的转发记在配置文件里(端口和指向哪里)。重启之后它认得自己的转发,不会重复建;老版本留下的转发会被搬到手机那一侧;别人的转发它既不碰也不删——只凭端口相同不算「是我的」。插件正常停止或卸载、并且那条转发仍然指向它记下的地方时,它才会把转发撤掉。
|
|
165
197
|
|
|
166
|
-
|
|
198
|
+
`tailscale serve --bg --tcp=8790` 是 Tailscale 里的长期设置:进程被强杀(崩溃、断电)时它留在那儿,不会自己消失。这种情况下插件下次启动会发现它还在、而且指向自己,会接着用;要自己收掉就 `tailscale serve --tcp=8790 off`,然后 `tailscale serve status` 看看还剩什么。
|
|
167
199
|
|
|
168
|
-
|
|
200
|
+
端口和网关都是 Magpie 启动这个插件时给的参数:端口是插件自己听在哪儿的地址,网关是插件去读的那个 Magpie。插件自己搬不了家,所以它们留在 Magpie 的启动参数里。想换端口或网关,在 Magpie 的插件设置里改:
|
|
169
201
|
|
|
170
|
-
|
|
202
|
+
`magpie plugin options magpie-page-token-widget '{"port":8890,"gatewayURL":"http://127.0.0.1:3500"}'`
|
|
203
|
+
|
|
204
|
+
改完重启 Magpie;手机那边的地址带着端口,换了端口手机要重新配对一次。
|
|
205
|
+
|
|
206
|
+
插件读的是 Magpie 自己的本地接口,默认是 `http://127.0.0.1:3425`。**这个网关地址必须指着本机**(`127.0.0.1`、`::1` 或 `localhost`):插件只去读这台电脑上的 Magpie,填成别的地址会被明确拒绝(控制台会写出原因),而不是把你的请求发到那台机器上去。控制台的**高级设置**里能看见现在读的是哪里(只是看一眼),但改它要去 Magpie 的插件设置里:这个地址换了要重启 Magpie 才算数,在插件页里改一半反而容易糊涂。
|
|
207
|
+
|
|
208
|
+
## 兼容性
|
|
209
|
+
|
|
210
|
+
- 需要 Magpie `0.1.3681` 以上(`package.json` 里写着)。
|
|
211
|
+
- 额度读的是 Magpie 已经缓存好的那份(`/v1/magpie/quotas?kept=1`),不额外去问供应商。
|
|
212
|
+
- 今天的 Token 读 `/v1/magpie/usage?period=today`,一次请求就拿到总数、分时、各厂商和各账号。**老版本 Magpie 没有这个接口时会自动退回老办法**(`/v1/magpie/usage/requests?period=today` 加逐账号的请求),组件上的数字照常有。退回只在网关明确回答「这个接口没有」(404、405、501)时才发生;网关临时出错(500、超时、断网)不会去逐账号重问,而是保留上一次读到的数字并标成「旧数据」。「这个接口没有」这件事会被记住一阵子,不会每次刷新都去问一遍。
|
|
213
|
+
- 七日趋势和模型/厂商排行读 `/v1/magpie/usage/requests?period=7d&limit=1`:这个接口才带 `by.model`、`by.agent` 这些分组,换成别的接口会把排行和趋势丢掉,所以保留。
|
|
214
|
+
- 周期参数 `week` 在 Magpie 里不认(会被当成 30 天),七日要用 `7d`。
|
|
215
|
+
|
|
216
|
+
## 卸载
|
|
171
217
|
|
|
172
218
|
```bash
|
|
173
219
|
magpie plugin rm magpie-page-token-widget
|
|
174
220
|
```
|
|
175
221
|
|
|
176
|
-
|
|
222
|
+
插件被移除时,插件会关掉自己开的监听、撤掉自己建的转发(只撤它自己记着的那条)。但有一件事做不到:进程被强杀(崩溃、断电、被强退)时来不及做这些,Tailscale 里的转发会留着,需要自己收一次:
|
|
223
|
+
|
|
224
|
+
```bash
|
|
225
|
+
tailscale serve --tcp=8790 off
|
|
226
|
+
```
|
|
177
227
|
|
|
178
|
-
##
|
|
228
|
+
## 隐私
|
|
179
229
|
|
|
180
|
-
|
|
230
|
+
- 服务只读 Magpie 的本地接口(默认 `127.0.0.1:3425`,只能是本机),不写 Magpie 的配置,不碰登录信息。
|
|
231
|
+
- 令牌是本机随机生成的,只读,存在 Magpie 的配置目录里;服务端只留哈希。没有共享令牌:一台手机一枚,撤销哪一枚就只停哪一台。只有这台电脑上的插件页,和带着配对码的手机,才能拿到令牌。
|
|
232
|
+
- 局域网地址只出现在电脑上的控制台里,手机接口不提供。
|
|
233
|
+
- 默认(Tailscale)模式下,服务只在本机(127.0.0.1)上监听,手机是经尾网的转发进来的,没有公网入口,也不需要防火墙规则。改用自己的地址以后,手机那一侧会在你选的地址上开一个口(**只有手机那一侧**,控制台永远关在本机),这时防火墙要放行一次,而且那条路是明文 HTTP。
|
|
181
234
|
|
|
182
|
-
##
|
|
235
|
+
## 开发
|
|
183
236
|
|
|
184
237
|
```bash
|
|
185
|
-
|
|
238
|
+
npm test
|
|
186
239
|
```
|
|
240
|
+
|
|
241
|
+
测试里不会碰真的 Tailscale:所有和 Tailscale 命令打交道的测试都用一个自己的假命令(`test/helpers.mjs` 里的 `mockTailscale`),也不会去改真的 `tailscale serve` 设置。Magpie 网关同样是测试自己起的一个。
|
|
242
|
+
|
|
243
|
+
`lib/collector.mjs` 和 `lib/normalize.mjs` 来自 [ScriptableTokenWidgets](https://github.com/liuzq1103/ScriptableTokenWidgets),`lib/vendor/qrcode-generator.cjs` 是 [qrcode-generator](https://github.com/kazuhikoarase/qrcode-generator)。详见 [NOTICE](NOTICE)。
|
package/index.mjs
CHANGED
|
@@ -1,11 +1,49 @@
|
|
|
1
1
|
import path from 'node:path';
|
|
2
2
|
import { fileURLToPath } from 'node:url';
|
|
3
|
+
import { readFileSync } from 'node:fs';
|
|
3
4
|
import { startServer } from './lib/server.mjs';
|
|
5
|
+
import { removeForwardSync } from './lib/forward.mjs';
|
|
4
6
|
|
|
5
7
|
const root = path.dirname(fileURLToPath(import.meta.url));
|
|
6
8
|
|
|
7
9
|
let running;
|
|
8
10
|
let current;
|
|
11
|
+
let directory;
|
|
12
|
+
|
|
13
|
+
// The service is shut down and the forwarding of the tailnet is taken away.
|
|
14
|
+
// This is what the host asks for when the plugin is unloaded, and what the
|
|
15
|
+
// host asks for when the settings change.
|
|
16
|
+
async function shutdown() {
|
|
17
|
+
const previous = running;
|
|
18
|
+
running = undefined;
|
|
19
|
+
current = undefined;
|
|
20
|
+
if (!previous) return { ok: true, stopped: false };
|
|
21
|
+
const service = await previous.catch(() => null);
|
|
22
|
+
await service?.close?.();
|
|
23
|
+
return { ok: true, stopped: true };
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
// The last way out. When the program ends, the sockets go with it, but the
|
|
27
|
+
// forwarding of Tailscale is a setting of Tailscale and would stay behind.
|
|
28
|
+
// It is taken away here, and only when it still points where this plugin
|
|
29
|
+
// left it: a forwarding of somebody else is never touched.
|
|
30
|
+
export function cleanupForward(directory, runner) {
|
|
31
|
+
try {
|
|
32
|
+
if (!directory) return { ok: false, error: '没有数据目录。' };
|
|
33
|
+
const file = path.join(directory, 'token-widget', 'state.json');
|
|
34
|
+
const record = JSON.parse(readFileSync(file, 'utf8'))?.forward;
|
|
35
|
+
if (!record) return { ok: true, skipped: true };
|
|
36
|
+
return removeForwardSync(record.publishedPort, record, runner);
|
|
37
|
+
} catch (error) {
|
|
38
|
+
return { ok: false, error: String(error?.message || error) };
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
function cleanupOnExit() {
|
|
43
|
+
cleanupForward(directory);
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
process.once('exit', cleanupOnExit);
|
|
9
47
|
|
|
10
48
|
// The host calls this again when the options change, and calls it once when
|
|
11
49
|
// the plugin is loaded. The service is restarted whenever the hand-over
|
|
@@ -15,6 +53,7 @@ export default {
|
|
|
15
53
|
async server(input, options) {
|
|
16
54
|
if (!input?.directory) throw new Error('The Magpie plugin host is required.');
|
|
17
55
|
options ||= {};
|
|
56
|
+
directory = input.directory;
|
|
18
57
|
const wanted = JSON.stringify([input.directory, options]);
|
|
19
58
|
if (wanted !== current) {
|
|
20
59
|
const previous = running;
|
|
@@ -35,4 +74,16 @@ export default {
|
|
|
35
74
|
await running;
|
|
36
75
|
return {};
|
|
37
76
|
},
|
|
77
|
+
// A host that asks the plugin to stop gets the service closed and the
|
|
78
|
+
// forwarding of the tailnet taken away. A host that does not ask still
|
|
79
|
+
// ends up in the same state when the program ends.
|
|
80
|
+
async stop() {
|
|
81
|
+
return shutdown();
|
|
82
|
+
},
|
|
83
|
+
async uninstall() {
|
|
84
|
+
return shutdown();
|
|
85
|
+
},
|
|
86
|
+
async close() {
|
|
87
|
+
return shutdown();
|
|
88
|
+
},
|
|
38
89
|
};
|
package/lib/atomic.mjs
ADDED
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
import { readdir, rename, rm, stat, writeFile } from 'node:fs/promises';
|
|
2
|
+
import { randomBytes } from 'node:crypto';
|
|
3
|
+
import path from 'node:path';
|
|
4
|
+
|
|
5
|
+
// A file is written somewhere else first and then moved onto its place, so a
|
|
6
|
+
// reader never sees half a file. The name of the temporary file is one of its
|
|
7
|
+
// own for every write, so two writes cannot pull the same file away from
|
|
8
|
+
// under each other.
|
|
9
|
+
//
|
|
10
|
+
// Windows refuses to move a file onto a place that another program happens to
|
|
11
|
+
// hold open (a scanner, a viewer), and it says EPERM for that. The move is
|
|
12
|
+
// therefore tried a few times before the write is given up on.
|
|
13
|
+
const MOVES = 4;
|
|
14
|
+
const PAUSE_MS = 40;
|
|
15
|
+
|
|
16
|
+
const pause = ms => new Promise(resolve => { setTimeout(resolve, ms).unref?.(); });
|
|
17
|
+
|
|
18
|
+
export async function writeAtomic(file, data, { mode = 0o600 } = {}) {
|
|
19
|
+
const temporary = `${file}.${process.pid}.${randomBytes(6).toString('hex')}.tmp`;
|
|
20
|
+
try {
|
|
21
|
+
await writeFile(temporary, data, { mode });
|
|
22
|
+
for (let attempt = 1; ; attempt += 1) {
|
|
23
|
+
try {
|
|
24
|
+
await rename(temporary, file);
|
|
25
|
+
return;
|
|
26
|
+
} catch (error) {
|
|
27
|
+
if (attempt >= MOVES || (error?.code !== 'EPERM' && error?.code !== 'EACCES' && error?.code !== 'EBUSY')) {
|
|
28
|
+
throw error;
|
|
29
|
+
}
|
|
30
|
+
await pause(PAUSE_MS);
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
} catch (error) {
|
|
34
|
+
await rm(temporary, { force: true }).catch(() => {});
|
|
35
|
+
throw error;
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
// When the program is killed between the write and the move, the temporary
|
|
40
|
+
// file stays behind. Nothing ever reads it, but it is litter, so it is swept
|
|
41
|
+
// away when the service starts.
|
|
42
|
+
export async function sweepTemporaries(file, { olderThanMs = 60 * 60 * 1000 } = {}) {
|
|
43
|
+
const folder = path.dirname(file);
|
|
44
|
+
const name = path.basename(file);
|
|
45
|
+
const prefix = `${name}.`;
|
|
46
|
+
let names = [];
|
|
47
|
+
try {
|
|
48
|
+
names = await readdir(folder);
|
|
49
|
+
} catch {
|
|
50
|
+
return 0;
|
|
51
|
+
}
|
|
52
|
+
let swept = 0;
|
|
53
|
+
for (const entry of names) {
|
|
54
|
+
if (!entry.startsWith(prefix) || !entry.endsWith('.tmp')) continue;
|
|
55
|
+
const stale = path.join(folder, entry);
|
|
56
|
+
try {
|
|
57
|
+
const info = await stat(stale);
|
|
58
|
+
if (Date.now() - info.mtimeMs < olderThanMs) continue;
|
|
59
|
+
await rm(stale, { force: true });
|
|
60
|
+
swept += 1;
|
|
61
|
+
} catch {
|
|
62
|
+
// A file that cannot be looked at is left where it is.
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
return swept;
|
|
66
|
+
}
|