dsh-vt-web-chat 1.2.0 → 2.0.0
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/README.md +66 -33
- package/client.js +355 -794
- package/docs/research/01-chat-demo-embedding.md +322 -0
- package/index.js +36 -8
- package/locale/en.json +1 -1
- package/locale/zh.json +1 -1
- package/package.json +15 -6
- package/scripts/dev-server.mjs +54 -0
- package/scripts/sync-upstream.mjs +106 -0
- package/src/auth.js +65 -0
- package/src/maintenance.js +240 -0
- package/src/proxy.js +139 -0
- package/src/route.js +307 -0
- package/src/settings.js +74 -0
- package/webview/UPSTREAM.json +6 -0
- package/webview/dist/LICENSE +21 -0
- package/webview/dist/index.html +1 -0
- package/webview/dist/static/css/async/4959.1382f613.css +1 -0
- package/webview/dist/static/css/main.27198ffe.css +1 -0
- package/webview/dist/static/js/async/1031.575fa503.js +1 -0
- package/webview/dist/static/js/async/1085.769e13d5.js +1 -0
- package/webview/dist/static/js/async/1086.4d3be1fa.js +1 -0
- package/webview/dist/static/js/async/1097.4f798919.js +117 -0
- package/webview/dist/static/js/async/1299.0ef86619.js +1 -0
- package/webview/dist/static/js/async/1393.6ef1efab.js +1 -0
- package/webview/dist/static/js/async/1401.88487cba.js +1 -0
- package/webview/dist/static/js/async/1505.8913966f.js +1 -0
- package/webview/dist/static/js/async/160.81018107.js +55 -0
- package/webview/dist/static/js/async/1679.153f9f03.js +1 -0
- package/webview/dist/static/js/async/1690.fe25bdfe.js +1 -0
- package/webview/dist/static/js/async/2110.a1d33f2f.js +215 -0
- package/webview/dist/static/js/async/2152.97b0a90c.js +1 -0
- package/webview/dist/static/js/async/2168.9925ab2d.js +1 -0
- package/webview/dist/static/js/async/2312.4fd0ef8e.js +1 -0
- package/webview/dist/static/js/async/2348.41564e59.js +148 -0
- package/webview/dist/static/js/async/2356.631a6aca.js +1 -0
- package/webview/dist/static/js/async/2415.00900482.js +1 -0
- package/webview/dist/static/js/async/2461.15199935.js +1 -0
- package/webview/dist/static/js/async/2541.f8eac009.js +1 -0
- package/webview/dist/static/js/async/2607.abb8bc11.js +1 -0
- package/webview/dist/static/js/async/265.b43cee3f.js +1 -0
- package/webview/dist/static/js/async/2696.60d5ecf0.js +1 -0
- package/webview/dist/static/js/async/3014.c8e9b88f.js +1 -0
- package/webview/dist/static/js/async/3111.e2cca965.js +1 -0
- package/webview/dist/static/js/async/3251.0b9c608e.js +1 -0
- package/webview/dist/static/js/async/3339.ed293391.js +1 -0
- package/webview/dist/static/js/async/3376.3aa54d1a.js +93 -0
- package/webview/dist/static/js/async/3465.845187e8.js +1 -0
- package/webview/dist/static/js/async/3477.94bd21ab.js +5 -0
- package/webview/dist/static/js/async/3594.edfe4411.js +1 -0
- package/webview/dist/static/js/async/3806.28abb895.js +1 -0
- package/webview/dist/static/js/async/3909.4b4bd806.js +1 -0
- package/webview/dist/static/js/async/4138.104dbc81.js +1 -0
- package/webview/dist/static/js/async/426.6fedaabe.js +1 -0
- package/webview/dist/static/js/async/4387.151c5858.js +1 -0
- package/webview/dist/static/js/async/4468.d0c907eb.js +1 -0
- package/webview/dist/static/js/async/4471.b0874c8d.js +158 -0
- package/webview/dist/static/js/async/4568.cf5e547d.js +1 -0
- package/webview/dist/static/js/async/4580.f1bc120a.js +131 -0
- package/webview/dist/static/js/async/4695.8f4b8910.js +1 -0
- package/webview/dist/static/js/async/4959.deb41780.js +1 -0
- package/webview/dist/static/js/async/509.f3e093b4.js +59 -0
- package/webview/dist/static/js/async/5172.e1e3bd11.js +43 -0
- package/webview/dist/static/js/async/535.e10ba324.js +1 -0
- package/webview/dist/static/js/async/5546.89da376c.js +24 -0
- package/webview/dist/static/js/async/5597.3018e134.js +36 -0
- package/webview/dist/static/js/async/5636.61075f0b.js +174 -0
- package/webview/dist/static/js/async/5638.7cfdcd7e.js +1 -0
- package/webview/dist/static/js/async/5706.d34ac064.js +1 -0
- package/webview/dist/static/js/async/5856.d75c4e3b.js +1 -0
- package/webview/dist/static/js/async/6061.7cfcc3e9.js +1 -0
- package/webview/dist/static/js/async/6152.d3a64904.js +1 -0
- package/webview/dist/static/js/async/6297.6e694780.js +1 -0
- package/webview/dist/static/js/async/6325.cafe9e55.js +1 -0
- package/webview/dist/static/js/async/6332.682f48c9.js +1 -0
- package/webview/dist/static/js/async/6349.e9992b47.js +56 -0
- package/webview/dist/static/js/async/6389.1bb952e3.js +1 -0
- package/webview/dist/static/js/async/6443.95da1923.js +1 -0
- package/webview/dist/static/js/async/6526.56ce7dc4.js +1 -0
- package/webview/dist/static/js/async/6600.6e0dfb69.js +1 -0
- package/webview/dist/static/js/async/6689.d0bd8935.js +262 -0
- package/webview/dist/static/js/async/6751.54c80aba.js +1 -0
- package/webview/dist/static/js/async/680.5aa7dcb4.js +1 -0
- package/webview/dist/static/js/async/6948.9cd716f4.js +1 -0
- package/webview/dist/static/js/async/7262.f680270f.js +88 -0
- package/webview/dist/static/js/async/7515.20c14480.js +1 -0
- package/webview/dist/static/js/async/7536.34769b35.js +1 -0
- package/webview/dist/static/js/async/7630.ed725458.js +1 -0
- package/webview/dist/static/js/async/7853.0a4b794a.js +1 -0
- package/webview/dist/static/js/async/8180.4d4299ef.js +1 -0
- package/webview/dist/static/js/async/828.56686119.js +1 -0
- package/webview/dist/static/js/async/8379.1b75211c.js +1 -0
- package/webview/dist/static/js/async/8389.4f120664.js +1 -0
- package/webview/dist/static/js/async/8538.d5f92d14.js +24 -0
- package/webview/dist/static/js/async/8560.1bdf90ec.js +1 -0
- package/webview/dist/static/js/async/8794.759831e8.js +60 -0
- package/webview/dist/static/js/async/8821.2b444259.js +29 -0
- package/webview/dist/static/js/async/925.548cc1b9.js +1 -0
- package/webview/dist/static/js/async/9252.3c22a9cd.js +1 -0
- package/webview/dist/static/js/async/9261.1e796956.js +1 -0
- package/webview/dist/static/js/async/9324.b3518ebf.js +1 -0
- package/webview/dist/static/js/async/9354.4425ac3c.js +1 -0
- package/webview/dist/static/js/async/9501.a7851380.js +4 -0
- package/webview/dist/static/js/async/9560.d604e606.js +166 -0
- package/webview/dist/static/js/async/9640.5f6a6734.js +1 -0
- package/webview/dist/static/js/async/9765.ecc8b5dc.js +1 -0
- package/webview/dist/static/js/async/9821.b1897048.js +63 -0
- package/webview/dist/static/js/main.7c5f914e.js +3 -0
- package/webview/dist/static/media/KaTeX_AMS-Regular.1608a09b.woff +0 -0
- package/webview/dist/static/media/KaTeX_AMS-Regular.4aafdb68.ttf +0 -0
- package/webview/dist/static/media/KaTeX_AMS-Regular.a79f1c31.woff2 +0 -0
- package/webview/dist/static/media/KaTeX_Caligraphic-Bold.b6770918.woff +0 -0
- package/webview/dist/static/media/KaTeX_Caligraphic-Bold.cce5b8ec.ttf +0 -0
- package/webview/dist/static/media/KaTeX_Caligraphic-Bold.ec17d132.woff2 +0 -0
- package/webview/dist/static/media/KaTeX_Caligraphic-Regular.07ef19e7.ttf +0 -0
- package/webview/dist/static/media/KaTeX_Caligraphic-Regular.55fac258.woff2 +0 -0
- package/webview/dist/static/media/KaTeX_Caligraphic-Regular.dad44a7f.woff +0 -0
- package/webview/dist/static/media/KaTeX_Fraktur-Bold.9f256b85.woff +0 -0
- package/webview/dist/static/media/KaTeX_Fraktur-Bold.b18f59e1.ttf +0 -0
- package/webview/dist/static/media/KaTeX_Fraktur-Bold.d42a5579.woff2 +0 -0
- package/webview/dist/static/media/KaTeX_Fraktur-Regular.7c187121.woff +0 -0
- package/webview/dist/static/media/KaTeX_Fraktur-Regular.d3c882a6.woff2 +0 -0
- package/webview/dist/static/media/KaTeX_Fraktur-Regular.ed38e79f.ttf +0 -0
- package/webview/dist/static/media/KaTeX_Main-Bold.b74a1a8b.ttf +0 -0
- package/webview/dist/static/media/KaTeX_Main-Bold.c3fb5ac2.woff2 +0 -0
- package/webview/dist/static/media/KaTeX_Main-Bold.d181c465.woff +0 -0
- package/webview/dist/static/media/KaTeX_Main-BoldItalic.6f2bb1df.woff2 +0 -0
- package/webview/dist/static/media/KaTeX_Main-BoldItalic.70d8b0a5.ttf +0 -0
- package/webview/dist/static/media/KaTeX_Main-BoldItalic.e3f82f9d.woff +0 -0
- package/webview/dist/static/media/KaTeX_Main-Italic.47373d1e.ttf +0 -0
- package/webview/dist/static/media/KaTeX_Main-Italic.8916142b.woff2 +0 -0
- package/webview/dist/static/media/KaTeX_Main-Italic.9024d815.woff +0 -0
- package/webview/dist/static/media/KaTeX_Main-Regular.0462f03b.woff2 +0 -0
- package/webview/dist/static/media/KaTeX_Main-Regular.7f51fe03.woff +0 -0
- package/webview/dist/static/media/KaTeX_Main-Regular.b7f8fe9b.ttf +0 -0
- package/webview/dist/static/media/KaTeX_Math-BoldItalic.572d331f.woff2 +0 -0
- package/webview/dist/static/media/KaTeX_Math-BoldItalic.a879cf83.ttf +0 -0
- package/webview/dist/static/media/KaTeX_Math-BoldItalic.f1035d8d.woff +0 -0
- package/webview/dist/static/media/KaTeX_Math-Italic.5295ba48.woff +0 -0
- package/webview/dist/static/media/KaTeX_Math-Italic.939bc644.ttf +0 -0
- package/webview/dist/static/media/KaTeX_Math-Italic.f28c23ac.woff2 +0 -0
- package/webview/dist/static/media/KaTeX_SansSerif-Bold.8c5b5494.woff2 +0 -0
- package/webview/dist/static/media/KaTeX_SansSerif-Bold.94e1e8dc.ttf +0 -0
- package/webview/dist/static/media/KaTeX_SansSerif-Bold.bf59d231.woff +0 -0
- package/webview/dist/static/media/KaTeX_SansSerif-Italic.3b1e59b3.woff2 +0 -0
- package/webview/dist/static/media/KaTeX_SansSerif-Italic.7c9bc82b.woff +0 -0
- package/webview/dist/static/media/KaTeX_SansSerif-Italic.b4c20c84.ttf +0 -0
- package/webview/dist/static/media/KaTeX_SansSerif-Regular.74048478.woff +0 -0
- package/webview/dist/static/media/KaTeX_SansSerif-Regular.ba21ed5f.woff2 +0 -0
- package/webview/dist/static/media/KaTeX_SansSerif-Regular.d4d7ba48.ttf +0 -0
- package/webview/dist/static/media/KaTeX_Script-Regular.03e9641d.woff2 +0 -0
- package/webview/dist/static/media/KaTeX_Script-Regular.07505710.woff +0 -0
- package/webview/dist/static/media/KaTeX_Script-Regular.fe9cbbe1.ttf +0 -0
- package/webview/dist/static/media/KaTeX_Size1-Regular.e1e279cb.woff +0 -0
- package/webview/dist/static/media/KaTeX_Size1-Regular.eae34984.woff2 +0 -0
- package/webview/dist/static/media/KaTeX_Size1-Regular.fabc004a.ttf +0 -0
- package/webview/dist/static/media/KaTeX_Size2-Regular.57727022.woff +0 -0
- package/webview/dist/static/media/KaTeX_Size2-Regular.5916a24f.woff2 +0 -0
- package/webview/dist/static/media/KaTeX_Size2-Regular.d6b476ec.ttf +0 -0
- package/webview/dist/static/media/KaTeX_Size3-Regular.9acaf01c.woff +0 -0
- package/webview/dist/static/media/KaTeX_Size3-Regular.a144ef58.ttf +0 -0
- package/webview/dist/static/media/KaTeX_Size3-Regular.b4230e7e.woff2 +0 -0
- package/webview/dist/static/media/KaTeX_Size4-Regular.10d95fd3.woff2 +0 -0
- package/webview/dist/static/media/KaTeX_Size4-Regular.7a996c9d.woff +0 -0
- package/webview/dist/static/media/KaTeX_Size4-Regular.fbccdabe.ttf +0 -0
- package/webview/dist/static/media/KaTeX_Typewriter-Regular.6258592b.woff +0 -0
- package/webview/dist/static/media/KaTeX_Typewriter-Regular.a8709e36.woff2 +0 -0
- package/webview/dist/static/media/KaTeX_Typewriter-Regular.d97aaf4a.ttf +0 -0
package/src/route.js
ADDED
|
@@ -0,0 +1,307 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `/webchat` 的全部 HTTP 面。
|
|
3
|
+
*
|
|
4
|
+
* 三类请求,边界各不相同:
|
|
5
|
+
* 1. 静态资源(前端产物)—— 公开。里面没有任何用户数据,历史存在浏览器 IndexedDB。
|
|
6
|
+
* 2. 设置接口 —— 需要 DSH 准入,只读写保留策略。
|
|
7
|
+
* 3. 上游代理 —— 需要 DSH 准入,会花账号额度,必须由 Host 注入凭据。
|
|
8
|
+
*/
|
|
9
|
+
import { randomUUID } from 'node:crypto';
|
|
10
|
+
import fs from 'node:fs/promises';
|
|
11
|
+
import fsSync from 'node:fs';
|
|
12
|
+
import path from 'node:path';
|
|
13
|
+
import { fileURLToPath } from 'node:url';
|
|
14
|
+
import { safeGet } from './auth.js';
|
|
15
|
+
import { injectBootstrap } from './maintenance.js';
|
|
16
|
+
import { proxyRequest, writeJson } from './proxy.js';
|
|
17
|
+
import { readSettings, writeSettings } from './settings.js';
|
|
18
|
+
|
|
19
|
+
/** 插件路由前缀;前端构建时也用它作为 apiOrigin。 */
|
|
20
|
+
const ROUTE_PREFIX = '/webchat';
|
|
21
|
+
|
|
22
|
+
/** 前端产物目录。 */
|
|
23
|
+
const DIST = fileURLToPath(new URL('../webview/dist/', import.meta.url));
|
|
24
|
+
|
|
25
|
+
/** 产物里出现的扩展名;没列到的按二进制下发。 */
|
|
26
|
+
const MIME = Object.freeze({
|
|
27
|
+
'.html': 'text/html; charset=utf-8',
|
|
28
|
+
'.js': 'text/javascript; charset=utf-8',
|
|
29
|
+
'.css': 'text/css; charset=utf-8',
|
|
30
|
+
'.json': 'application/json; charset=utf-8',
|
|
31
|
+
'.map': 'application/json; charset=utf-8',
|
|
32
|
+
'.svg': 'image/svg+xml',
|
|
33
|
+
'.png': 'image/png',
|
|
34
|
+
'.jpg': 'image/jpeg',
|
|
35
|
+
'.jpeg': 'image/jpeg',
|
|
36
|
+
'.webp': 'image/webp',
|
|
37
|
+
'.gif': 'image/gif',
|
|
38
|
+
'.ico': 'image/x-icon',
|
|
39
|
+
'.woff': 'font/woff',
|
|
40
|
+
'.woff2': 'font/woff2',
|
|
41
|
+
'.ttf': 'font/ttf',
|
|
42
|
+
});
|
|
43
|
+
|
|
44
|
+
/** 会被改写的入口页。 */
|
|
45
|
+
const INDEX_FILE = 'index.html';
|
|
46
|
+
|
|
47
|
+
/**
|
|
48
|
+
* 面板能力令牌:进程级随机值,随入口页下发给面板。
|
|
49
|
+
*
|
|
50
|
+
* 为什么需要它:面板是 iframe,宿主是浏览器还是桌面壳、有没有浏览器 Cookie、
|
|
51
|
+
* 算不算 cross-site,都会让 DSH 的请求栅栏给出不同结论。与其逐种情况放宽,
|
|
52
|
+
* 不如让入口页在渲染时下发一个不可猜的令牌,面板把它带在每个请求上。
|
|
53
|
+
* 静态产物本身公开,但跨源页面读不到响应正文,所以拿不到令牌。
|
|
54
|
+
*/
|
|
55
|
+
const CAPABILITY = randomUUID();
|
|
56
|
+
|
|
57
|
+
/** 令牌请求头。 */
|
|
58
|
+
const CAPABILITY_HEADER = 'x-vtwc-cap';
|
|
59
|
+
|
|
60
|
+
/**
|
|
61
|
+
* 判断请求是否来自可信的 DSH 客户端。
|
|
62
|
+
*
|
|
63
|
+
* 插件路由不在 DSH 的 `/api` 信任栅栏内,必须自己问一次 Connection;
|
|
64
|
+
* 桌面壳的渲染进程用 `dsh-app:` 协议,不带浏览器 Cookie,直接放行。
|
|
65
|
+
* @param ctx - Host 插件上下文。
|
|
66
|
+
* @param req - Node 请求。
|
|
67
|
+
* @returns 是否放行。
|
|
68
|
+
*/
|
|
69
|
+
function admitted(ctx, req) {
|
|
70
|
+
const origin = String(req.headers?.origin ?? '');
|
|
71
|
+
if (origin.startsWith('dsh-app:')) return true;
|
|
72
|
+
|
|
73
|
+
// 能力令牌:只认回环来源,且 Origin 必须为空或与 Host 同authority。
|
|
74
|
+
if (String(req.headers?.[CAPABILITY_HEADER] ?? '') === CAPABILITY && fromLoopback(req) && sameOrigin(req)) {
|
|
75
|
+
return true;
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
const connection = safeGet(ctx, 'connection');
|
|
79
|
+
if (connection === undefined || typeof connection.requestRejection !== 'function') return true;
|
|
80
|
+
try {
|
|
81
|
+
const rejection = connection.requestRejection(req);
|
|
82
|
+
// `requestRejection` 是两段判断:先过 Host/Origin 栅栏(不过给 403),
|
|
83
|
+
// 再要求浏览器会话 Cookie(缺失给 401)。
|
|
84
|
+
// 桌面壳的渲染进程走 IPC 而不走 Cookie,它的合法请求恰好是 401。
|
|
85
|
+
return rejection === undefined || rejection === 401;
|
|
86
|
+
} catch {
|
|
87
|
+
return false;
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
/**
|
|
92
|
+
* 请求是否来自本机回环。
|
|
93
|
+
* @param req - Node 请求。
|
|
94
|
+
* @returns 是否为回环地址。
|
|
95
|
+
*/
|
|
96
|
+
function fromLoopback(req) {
|
|
97
|
+
const address = req.socket?.remoteAddress ?? '';
|
|
98
|
+
return address === '127.0.0.1' || address === '::1' || address === '::ffff:127.0.0.1';
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
/**
|
|
102
|
+
* Origin 是否为空或与 Host 一致。
|
|
103
|
+
* @param req - Node 请求。
|
|
104
|
+
* @returns 是否同源。
|
|
105
|
+
*/
|
|
106
|
+
function sameOrigin(req) {
|
|
107
|
+
const origin = req.headers?.origin;
|
|
108
|
+
if (typeof origin !== 'string' || origin.length === 0) return true;
|
|
109
|
+
try {
|
|
110
|
+
return new URL(origin).host === String(req.headers?.host ?? '');
|
|
111
|
+
} catch {
|
|
112
|
+
return false;
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
/**
|
|
117
|
+
* 读取请求体并解析 JSON。
|
|
118
|
+
* @param req - Node 请求。
|
|
119
|
+
* @returns 解析后的对象;空体给空对象。
|
|
120
|
+
*/
|
|
121
|
+
async function readJson(req) {
|
|
122
|
+
const chunks = [];
|
|
123
|
+
let total = 0;
|
|
124
|
+
for await (const chunk of req) {
|
|
125
|
+
total += chunk.length;
|
|
126
|
+
if (total > 64 * 1024) throw new Error('请求体过大');
|
|
127
|
+
chunks.push(chunk);
|
|
128
|
+
}
|
|
129
|
+
if (total === 0) return {};
|
|
130
|
+
return JSON.parse(Buffer.concat(chunks).toString('utf8'));
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
/**
|
|
134
|
+
* 把 URL 路径解析成产物目录内的文件。
|
|
135
|
+
* @param relativePath - 去掉 `/webchat` 前缀后的路径。
|
|
136
|
+
* @returns 绝对路径;试图越界时 undefined。
|
|
137
|
+
*/
|
|
138
|
+
function resolveStatic(relativePath) {
|
|
139
|
+
const decoded = decodeURIComponent(relativePath === '/' ? `/${INDEX_FILE}` : relativePath);
|
|
140
|
+
const target = path.resolve(DIST, `.${decoded.startsWith('/') ? '' : '/'}${decoded}`);
|
|
141
|
+
const root = path.resolve(DIST);
|
|
142
|
+
if (target !== root && !target.startsWith(`${root}${path.sep}`)) return undefined;
|
|
143
|
+
return target;
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
/**
|
|
147
|
+
* 下发一个文件;入口页先注入启动闸门。
|
|
148
|
+
* @param req - Node 请求。
|
|
149
|
+
* @param res - Node 响应。
|
|
150
|
+
* @param file - 绝对路径。
|
|
151
|
+
*/
|
|
152
|
+
async function sendStatic(req, res, file) {
|
|
153
|
+
let stat;
|
|
154
|
+
try {
|
|
155
|
+
stat = await fs.stat(file);
|
|
156
|
+
} catch {
|
|
157
|
+
res.writeHead(404, { 'content-type': 'text/plain; charset=utf-8' }).end('not found');
|
|
158
|
+
return;
|
|
159
|
+
}
|
|
160
|
+
if (!stat.isFile()) {
|
|
161
|
+
res.writeHead(404, { 'content-type': 'text/plain; charset=utf-8' }).end('not found');
|
|
162
|
+
return;
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
const isIndex = path.basename(file) === INDEX_FILE;
|
|
166
|
+
const ext = path.extname(file).toLowerCase();
|
|
167
|
+
const etag = `W/"${stat.size.toString(16)}-${Math.trunc(stat.mtimeMs).toString(16)}"`;
|
|
168
|
+
|
|
169
|
+
if (!isIndex && req.headers['if-none-match'] === etag) {
|
|
170
|
+
res.writeHead(304, { etag }).end();
|
|
171
|
+
return;
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
let body = await fs.readFile(file);
|
|
175
|
+
if (isIndex) {
|
|
176
|
+
const { html } = injectBootstrap(body.toString('utf8'), CAPABILITY);
|
|
177
|
+
// 入口页标题面向面板里的用户,不沿用上游的「API 使用 demo」。
|
|
178
|
+
body = Buffer.from(
|
|
179
|
+
html.replace(/<title>.*?<\/title>/iu, '<title>DeepSeek Chat</title>'),
|
|
180
|
+
'utf8',
|
|
181
|
+
);
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
res.writeHead(200, {
|
|
185
|
+
'content-type': MIME[ext] ?? 'application/octet-stream',
|
|
186
|
+
'content-length': body.length,
|
|
187
|
+
// 入口页内嵌了能力令牌,按进程变化:绝不能被缓存复用,否则刷新后令牌就对不上了。
|
|
188
|
+
'cache-control': isIndex ? 'no-store' : 'no-cache',
|
|
189
|
+
...(isIndex ? {} : { etag }),
|
|
190
|
+
});
|
|
191
|
+
res.end(body);
|
|
192
|
+
}
|
|
193
|
+
|
|
194
|
+
/**
|
|
195
|
+
* 自检:产物、设置、凭据三条链路各自给出结论。
|
|
196
|
+
* @param ctx - Host 插件上下文。
|
|
197
|
+
* @returns 自检结果。
|
|
198
|
+
*/
|
|
199
|
+
async function selfTest(ctx) {
|
|
200
|
+
const checks = [];
|
|
201
|
+
const add = (name, ok, detail) => checks.push({ name, ok, detail });
|
|
202
|
+
|
|
203
|
+
try {
|
|
204
|
+
const index = await fs.readFile(path.join(DIST, INDEX_FILE), 'utf8');
|
|
205
|
+
const entry = /src="([^"]+\.js)"/u.exec(index)?.[1];
|
|
206
|
+
add('index', entry !== undefined, entry ?? '没有入口脚本');
|
|
207
|
+
if (entry !== undefined) {
|
|
208
|
+
add('entry', fsSync.existsSync(path.join(DIST, entry)), entry);
|
|
209
|
+
}
|
|
210
|
+
} catch (error) {
|
|
211
|
+
add('index', false, error instanceof Error ? error.message : String(error));
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
const settings = await readSettings();
|
|
215
|
+
add('settings', true, `retentionDays=${settings.retentionDays}`);
|
|
216
|
+
|
|
217
|
+
const account = safeGet(ctx, 'deepseekAccount');
|
|
218
|
+
const credentials = safeGet(ctx, 'credentials');
|
|
219
|
+
add('account-service', account !== undefined, account === undefined ? '未挂载' : '可用');
|
|
220
|
+
add('credentials-service', credentials !== undefined, credentials === undefined ? '未挂载' : '可用');
|
|
221
|
+
|
|
222
|
+
return { ok: checks.every((check) => check.ok), checks };
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
/**
|
|
226
|
+
* 建立 `/webchat` 的请求处理器。
|
|
227
|
+
* @param ctx - Host 插件上下文。
|
|
228
|
+
* @returns Node 请求处理器。
|
|
229
|
+
*/
|
|
230
|
+
export function createHandler(ctx) {
|
|
231
|
+
return async function handle(req, res) {
|
|
232
|
+
const url = new URL(req.url ?? '/', 'http://127.0.0.1');
|
|
233
|
+
const { pathname, search } = url;
|
|
234
|
+
const method = (req.method ?? 'GET').toUpperCase();
|
|
235
|
+
const isRead = method === 'GET' || method === 'HEAD';
|
|
236
|
+
|
|
237
|
+
// 相对路径的资源要靠这个斜杠才能解析到 /webchat/ 下。
|
|
238
|
+
if (pathname === ROUTE_PREFIX) {
|
|
239
|
+
res.writeHead(301, { location: `${ROUTE_PREFIX}/${search}` }).end();
|
|
240
|
+
return;
|
|
241
|
+
}
|
|
242
|
+
if (!pathname.startsWith(`${ROUTE_PREFIX}/`)) {
|
|
243
|
+
writeJson(res, 404, { error: 'not found' });
|
|
244
|
+
return;
|
|
245
|
+
}
|
|
246
|
+
|
|
247
|
+
const rest = pathname.slice(ROUTE_PREFIX.length);
|
|
248
|
+
|
|
249
|
+
// ---- 设置:只读写保留策略 ----
|
|
250
|
+
if (rest === '/api/settings') {
|
|
251
|
+
if (!admitted(ctx, req)) {
|
|
252
|
+
writeJson(res, 403, { error: '请求来源不受信任' });
|
|
253
|
+
return;
|
|
254
|
+
}
|
|
255
|
+
if (isRead) {
|
|
256
|
+
writeJson(res, 200, await readSettings());
|
|
257
|
+
return;
|
|
258
|
+
}
|
|
259
|
+
if (method === 'POST') {
|
|
260
|
+
try {
|
|
261
|
+
const input = await readJson(req);
|
|
262
|
+
writeJson(res, 200, await writeSettings(input));
|
|
263
|
+
} catch (error) {
|
|
264
|
+
writeJson(res, 400, { error: error instanceof Error ? error.message : String(error) });
|
|
265
|
+
}
|
|
266
|
+
return;
|
|
267
|
+
}
|
|
268
|
+
writeJson(res, 405, { error: 'method not allowed' });
|
|
269
|
+
return;
|
|
270
|
+
}
|
|
271
|
+
|
|
272
|
+
// ---- 自检 ----
|
|
273
|
+
if (rest === '/api/self-test' && isRead) {
|
|
274
|
+
if (!admitted(ctx, req)) {
|
|
275
|
+
writeJson(res, 403, { error: '请求来源不受信任' });
|
|
276
|
+
return;
|
|
277
|
+
}
|
|
278
|
+
writeJson(res, 200, await selfTest(ctx));
|
|
279
|
+
return;
|
|
280
|
+
}
|
|
281
|
+
|
|
282
|
+
// ---- 上游代理:三条前缀都是会花额度的路径 ----
|
|
283
|
+
const proxied = rest.startsWith('/anthropic/') || rest === '/models' || rest.startsWith('/v1/tools/');
|
|
284
|
+
if (proxied) {
|
|
285
|
+
if (!admitted(ctx, req)) {
|
|
286
|
+
writeJson(res, 403, { error: '请求来源不受信任' });
|
|
287
|
+
return;
|
|
288
|
+
}
|
|
289
|
+
await proxyRequest(ctx, req, res, { pathname, search });
|
|
290
|
+
return;
|
|
291
|
+
}
|
|
292
|
+
|
|
293
|
+
// ---- 静态产物 ----
|
|
294
|
+
if (!isRead) {
|
|
295
|
+
res.writeHead(405, { allow: 'GET, HEAD' }).end();
|
|
296
|
+
return;
|
|
297
|
+
}
|
|
298
|
+
const file = resolveStatic(rest);
|
|
299
|
+
if (file === undefined) {
|
|
300
|
+
res.writeHead(403, { 'content-type': 'text/plain; charset=utf-8' }).end('forbidden');
|
|
301
|
+
return;
|
|
302
|
+
}
|
|
303
|
+
await sendStatic(req, res, file);
|
|
304
|
+
};
|
|
305
|
+
}
|
|
306
|
+
|
|
307
|
+
export { ROUTE_PREFIX, DIST };
|
package/src/settings.js
ADDED
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 插件的本地设置:目前只有「会话保留天数」。
|
|
3
|
+
*
|
|
4
|
+
* 落在 `$DSH_HOME/vt-web-chat/settings.json`,与 `dsh-vt-quick-chat` 的存放口径一致:
|
|
5
|
+
* 一个插件一个小目录,坏了删掉即可回到默认值,不碰 DSH 自己的配置。
|
|
6
|
+
*/
|
|
7
|
+
import fs from 'node:fs/promises';
|
|
8
|
+
import os from 'node:os';
|
|
9
|
+
import path from 'node:path';
|
|
10
|
+
|
|
11
|
+
/** 可选的保留档位(天);0 表示永不清理。 */
|
|
12
|
+
const RETENTION_CHOICES = Object.freeze([30, 60, 90, 0]);
|
|
13
|
+
|
|
14
|
+
/** 默认保留 30 天。 */
|
|
15
|
+
const DEFAULT_RETENTION_DAYS = 30;
|
|
16
|
+
|
|
17
|
+
/** 设置文件所在目录。 */
|
|
18
|
+
function settingsDir() {
|
|
19
|
+
const home = process.env.DSH_HOME ?? path.join(os.homedir(), '.dsh');
|
|
20
|
+
return path.join(home, 'vt-web-chat');
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
/** 设置文件路径;允许用环境变量整体覆盖,便于开发与测试。 */
|
|
24
|
+
export function settingsFile() {
|
|
25
|
+
return process.env.VT_WEB_CHAT_SETTINGS ?? path.join(settingsDir(), 'settings.json');
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
/** 默认设置。 */
|
|
29
|
+
export function defaultSettings() {
|
|
30
|
+
return { retentionDays: DEFAULT_RETENTION_DAYS };
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* 把任意输入收敛成合法设置。
|
|
35
|
+
* @param value - 读盘或请求体里的原始值。
|
|
36
|
+
* @returns 合法设置;非法字段回落到默认值。
|
|
37
|
+
*/
|
|
38
|
+
export function normalizeSettings(value) {
|
|
39
|
+
const base = defaultSettings();
|
|
40
|
+
if (value === null || typeof value !== 'object' || Array.isArray(value)) return base;
|
|
41
|
+
const days = value.retentionDays;
|
|
42
|
+
if (typeof days === 'number' && RETENTION_CHOICES.includes(days)) {
|
|
43
|
+
base.retentionDays = days;
|
|
44
|
+
}
|
|
45
|
+
return base;
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
/**
|
|
49
|
+
* 读取设置。
|
|
50
|
+
* @returns 设置对象;文件缺失或损坏时给默认值,不抛错。
|
|
51
|
+
*/
|
|
52
|
+
export async function readSettings() {
|
|
53
|
+
try {
|
|
54
|
+
const raw = await fs.readFile(settingsFile(), 'utf8');
|
|
55
|
+
return normalizeSettings(JSON.parse(raw));
|
|
56
|
+
} catch {
|
|
57
|
+
return defaultSettings();
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
* 写入设置。
|
|
63
|
+
* @param value - 待保存的设置(会先 normalize)。
|
|
64
|
+
* @returns 落盘后的设置。
|
|
65
|
+
*/
|
|
66
|
+
export async function writeSettings(value) {
|
|
67
|
+
const settings = normalizeSettings(value);
|
|
68
|
+
const file = settingsFile();
|
|
69
|
+
await fs.mkdir(path.dirname(file), { recursive: true });
|
|
70
|
+
await fs.writeFile(file, `${JSON.stringify(settings, null, 2)}\n`, 'utf8');
|
|
71
|
+
return settings;
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
export { RETENTION_CHOICES, DEFAULT_RETENTION_DAYS };
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 DeepSeek
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in
|
|
13
|
+
all copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
21
|
+
THE SOFTWARE.
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
<!doctype html><html lang="zh-CN"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta name="theme-color" content="#ffffff"><title>API 使用 demo</title><meta content="0.1.3" name="application-version"><script defer src="static/js/main.7c5f914e.js"></script><link href="static/css/main.27198ffe.css" rel="stylesheet"></head><body><div id="root"></div></body></html>
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
@font-face{font-family:KaTeX_AMS;font-style:normal;font-weight:400;src:url(../../../static/media/KaTeX_AMS-Regular.a79f1c31.woff2)format("woff2"),url(../../../static/media/KaTeX_AMS-Regular.1608a09b.woff)format("woff"),url(../../../static/media/KaTeX_AMS-Regular.4aafdb68.ttf)format("truetype")}@font-face{font-family:KaTeX_Caligraphic;font-style:normal;font-weight:700;src:url(../../../static/media/KaTeX_Caligraphic-Bold.ec17d132.woff2)format("woff2"),url(../../../static/media/KaTeX_Caligraphic-Bold.b6770918.woff)format("woff"),url(../../../static/media/KaTeX_Caligraphic-Bold.cce5b8ec.ttf)format("truetype")}@font-face{font-family:KaTeX_Caligraphic;font-style:normal;font-weight:400;src:url(../../../static/media/KaTeX_Caligraphic-Regular.55fac258.woff2)format("woff2"),url(../../../static/media/KaTeX_Caligraphic-Regular.dad44a7f.woff)format("woff"),url(../../../static/media/KaTeX_Caligraphic-Regular.07ef19e7.ttf)format("truetype")}@font-face{font-family:KaTeX_Fraktur;font-style:normal;font-weight:700;src:url(../../../static/media/KaTeX_Fraktur-Bold.d42a5579.woff2)format("woff2"),url(../../../static/media/KaTeX_Fraktur-Bold.9f256b85.woff)format("woff"),url(../../../static/media/KaTeX_Fraktur-Bold.b18f59e1.ttf)format("truetype")}@font-face{font-family:KaTeX_Fraktur;font-style:normal;font-weight:400;src:url(../../../static/media/KaTeX_Fraktur-Regular.d3c882a6.woff2)format("woff2"),url(../../../static/media/KaTeX_Fraktur-Regular.7c187121.woff)format("woff"),url(../../../static/media/KaTeX_Fraktur-Regular.ed38e79f.ttf)format("truetype")}@font-face{font-family:KaTeX_Main;font-style:normal;font-weight:700;src:url(../../../static/media/KaTeX_Main-Bold.c3fb5ac2.woff2)format("woff2"),url(../../../static/media/KaTeX_Main-Bold.d181c465.woff)format("woff"),url(../../../static/media/KaTeX_Main-Bold.b74a1a8b.ttf)format("truetype")}@font-face{font-family:KaTeX_Main;font-style:italic;font-weight:700;src:url(../../../static/media/KaTeX_Main-BoldItalic.6f2bb1df.woff2)format("woff2"),url(../../../static/media/KaTeX_Main-BoldItalic.e3f82f9d.woff)format("woff"),url(../../../static/media/KaTeX_Main-BoldItalic.70d8b0a5.ttf)format("truetype")}@font-face{font-family:KaTeX_Main;font-style:italic;font-weight:400;src:url(../../../static/media/KaTeX_Main-Italic.8916142b.woff2)format("woff2"),url(../../../static/media/KaTeX_Main-Italic.9024d815.woff)format("woff"),url(../../../static/media/KaTeX_Main-Italic.47373d1e.ttf)format("truetype")}@font-face{font-family:KaTeX_Main;font-style:normal;font-weight:400;src:url(../../../static/media/KaTeX_Main-Regular.0462f03b.woff2)format("woff2"),url(../../../static/media/KaTeX_Main-Regular.7f51fe03.woff)format("woff"),url(../../../static/media/KaTeX_Main-Regular.b7f8fe9b.ttf)format("truetype")}@font-face{font-family:KaTeX_Math;font-style:italic;font-weight:700;src:url(../../../static/media/KaTeX_Math-BoldItalic.572d331f.woff2)format("woff2"),url(../../../static/media/KaTeX_Math-BoldItalic.f1035d8d.woff)format("woff"),url(../../../static/media/KaTeX_Math-BoldItalic.a879cf83.ttf)format("truetype")}@font-face{font-family:KaTeX_Math;font-style:italic;font-weight:400;src:url(../../../static/media/KaTeX_Math-Italic.f28c23ac.woff2)format("woff2"),url(../../../static/media/KaTeX_Math-Italic.5295ba48.woff)format("woff"),url(../../../static/media/KaTeX_Math-Italic.939bc644.ttf)format("truetype")}@font-face{font-family:KaTeX_SansSerif;font-style:normal;font-weight:700;src:url(../../../static/media/KaTeX_SansSerif-Bold.8c5b5494.woff2)format("woff2"),url(../../../static/media/KaTeX_SansSerif-Bold.bf59d231.woff)format("woff"),url(../../../static/media/KaTeX_SansSerif-Bold.94e1e8dc.ttf)format("truetype")}@font-face{font-family:KaTeX_SansSerif;font-style:italic;font-weight:400;src:url(../../../static/media/KaTeX_SansSerif-Italic.3b1e59b3.woff2)format("woff2"),url(../../../static/media/KaTeX_SansSerif-Italic.7c9bc82b.woff)format("woff"),url(../../../static/media/KaTeX_SansSerif-Italic.b4c20c84.ttf)format("truetype")}@font-face{font-family:KaTeX_SansSerif;font-style:normal;font-weight:400;src:url(../../../static/media/KaTeX_SansSerif-Regular.ba21ed5f.woff2)format("woff2"),url(../../../static/media/KaTeX_SansSerif-Regular.74048478.woff)format("woff"),url(../../../static/media/KaTeX_SansSerif-Regular.d4d7ba48.ttf)format("truetype")}@font-face{font-family:KaTeX_Script;font-style:normal;font-weight:400;src:url(../../../static/media/KaTeX_Script-Regular.03e9641d.woff2)format("woff2"),url(../../../static/media/KaTeX_Script-Regular.07505710.woff)format("woff"),url(../../../static/media/KaTeX_Script-Regular.fe9cbbe1.ttf)format("truetype")}@font-face{font-family:KaTeX_Size1;font-style:normal;font-weight:400;src:url(../../../static/media/KaTeX_Size1-Regular.eae34984.woff2)format("woff2"),url(../../../static/media/KaTeX_Size1-Regular.e1e279cb.woff)format("woff"),url(../../../static/media/KaTeX_Size1-Regular.fabc004a.ttf)format("truetype")}@font-face{font-family:KaTeX_Size2;font-style:normal;font-weight:400;src:url(../../../static/media/KaTeX_Size2-Regular.5916a24f.woff2)format("woff2"),url(../../../static/media/KaTeX_Size2-Regular.57727022.woff)format("woff"),url(../../../static/media/KaTeX_Size2-Regular.d6b476ec.ttf)format("truetype")}@font-face{font-family:KaTeX_Size3;font-style:normal;font-weight:400;src:url(../../../static/media/KaTeX_Size3-Regular.b4230e7e.woff2)format("woff2"),url(../../../static/media/KaTeX_Size3-Regular.9acaf01c.woff)format("woff"),url(../../../static/media/KaTeX_Size3-Regular.a144ef58.ttf)format("truetype")}@font-face{font-family:KaTeX_Size4;font-style:normal;font-weight:400;src:url(../../../static/media/KaTeX_Size4-Regular.10d95fd3.woff2)format("woff2"),url(../../../static/media/KaTeX_Size4-Regular.7a996c9d.woff)format("woff"),url(../../../static/media/KaTeX_Size4-Regular.fbccdabe.ttf)format("truetype")}@font-face{font-family:KaTeX_Typewriter;font-style:normal;font-weight:400;src:url(../../../static/media/KaTeX_Typewriter-Regular.a8709e36.woff2)format("woff2"),url(../../../static/media/KaTeX_Typewriter-Regular.6258592b.woff)format("woff"),url(../../../static/media/KaTeX_Typewriter-Regular.d97aaf4a.ttf)format("truetype")}.katex{text-indent:0;text-rendering:auto;font:1.21em/1.2 KaTeX_Main,Times New Roman,serif}.katex *{border-color:currentColor;-ms-high-contrast-adjust:none!important}.katex .katex-version:after{content:"0.16.22"}.katex .katex-mathml{clip:rect(1px,1px,1px,1px);border:0;width:1px;height:1px;padding:0;position:absolute;overflow:hidden}.katex .katex-html>.newline{display:block}.katex .base{white-space:nowrap;width:-webkit-min-content;width:-moz-min-content;width:min-content;position:relative}.katex .base,.katex .strut{display:inline-block}.katex .textbf{font-weight:700}.katex .textit{font-style:italic}.katex .textrm{font-family:KaTeX_Main}.katex .textsf{font-family:KaTeX_SansSerif}.katex .texttt{font-family:KaTeX_Typewriter}.katex .mathnormal{font-family:KaTeX_Math;font-style:italic}.katex .mathit{font-family:KaTeX_Main;font-style:italic}.katex .mathrm{font-style:normal}.katex .mathbf{font-family:KaTeX_Main;font-weight:700}.katex .boldsymbol{font-family:KaTeX_Math;font-style:italic;font-weight:700}.katex .amsrm,.katex .mathbb,.katex .textbb{font-family:KaTeX_AMS}.katex .mathcal{font-family:KaTeX_Caligraphic}.katex .mathfrak,.katex .textfrak{font-family:KaTeX_Fraktur}.katex .mathboldfrak,.katex .textboldfrak{font-family:KaTeX_Fraktur;font-weight:700}.katex .mathtt{font-family:KaTeX_Typewriter}.katex .mathscr,.katex .textscr{font-family:KaTeX_Script}.katex .mathsf,.katex .textsf{font-family:KaTeX_SansSerif}.katex .mathboldsf,.katex .textboldsf{font-family:KaTeX_SansSerif;font-weight:700}.katex .mathitsf,.katex .mathsfit,.katex .textitsf{font-family:KaTeX_SansSerif;font-style:italic}.katex .mainrm{font-family:KaTeX_Main;font-style:normal}.katex .vlist-t{border-collapse:collapse;table-layout:fixed;display:inline-table}.katex .vlist-r{display:table-row}.katex .vlist{vertical-align:bottom;display:table-cell;position:relative}.katex .vlist>span{height:0;display:block;position:relative}.katex .vlist>span>span{display:inline-block}.katex .vlist>span>.pstrut{width:0;overflow:hidden}.katex .vlist-t2{margin-right:-2px}.katex .vlist-s{vertical-align:bottom;width:2px;min-width:2px;font-size:1px;display:table-cell}.katex .vbox{flex-direction:column;align-items:baseline;display:inline-flex}.katex .hbox{width:100%}.katex .hbox,.katex .thinbox{flex-direction:row;display:inline-flex}.katex .thinbox{width:0;max-width:0}.katex .msupsub{text-align:left}.katex .mfrac>span>span{text-align:center}.katex .mfrac .frac-line{border-bottom-style:solid;width:100%;display:inline-block}.katex .hdashline,.katex .hline,.katex .mfrac .frac-line,.katex .overline .overline-line,.katex .rule,.katex .underline .underline-line{min-height:1px}.katex .mspace{display:inline-block}.katex .clap,.katex .llap,.katex .rlap{width:0;position:relative}.katex .clap>.inner,.katex .llap>.inner,.katex .rlap>.inner{position:absolute}.katex .clap>.fix,.katex .llap>.fix,.katex .rlap>.fix{display:inline-block}.katex .llap>.inner{right:0}.katex .clap>.inner,.katex .rlap>.inner{left:0}.katex .clap>.inner>span{margin-left:-50%;margin-right:50%}.katex .rule{border:0 solid;display:inline-block;position:relative}.katex .hline,.katex .overline .overline-line,.katex .underline .underline-line{border-bottom-style:solid;width:100%;display:inline-block}.katex .hdashline{border-bottom-style:dashed;width:100%;display:inline-block}.katex .sqrt>.root{margin-left:.277778em;margin-right:-.555556em}.katex .fontsize-ensurer.reset-size1.size1,.katex .sizing.reset-size1.size1{font-size:1em}.katex .fontsize-ensurer.reset-size1.size2,.katex .sizing.reset-size1.size2{font-size:1.2em}.katex .fontsize-ensurer.reset-size1.size3,.katex .sizing.reset-size1.size3{font-size:1.4em}.katex .fontsize-ensurer.reset-size1.size4,.katex .sizing.reset-size1.size4{font-size:1.6em}.katex .fontsize-ensurer.reset-size1.size5,.katex .sizing.reset-size1.size5{font-size:1.8em}.katex .fontsize-ensurer.reset-size1.size6,.katex .sizing.reset-size1.size6{font-size:2em}.katex .fontsize-ensurer.reset-size1.size7,.katex .sizing.reset-size1.size7{font-size:2.4em}.katex .fontsize-ensurer.reset-size1.size8,.katex .sizing.reset-size1.size8{font-size:2.88em}.katex .fontsize-ensurer.reset-size1.size9,.katex .sizing.reset-size1.size9{font-size:3.456em}.katex .fontsize-ensurer.reset-size1.size10,.katex .sizing.reset-size1.size10{font-size:4.148em}.katex .fontsize-ensurer.reset-size1.size11,.katex .sizing.reset-size1.size11{font-size:4.976em}.katex .fontsize-ensurer.reset-size2.size1,.katex .sizing.reset-size2.size1{font-size:.833333em}.katex .fontsize-ensurer.reset-size2.size2,.katex .sizing.reset-size2.size2{font-size:1em}.katex .fontsize-ensurer.reset-size2.size3,.katex .sizing.reset-size2.size3{font-size:1.16667em}.katex .fontsize-ensurer.reset-size2.size4,.katex .sizing.reset-size2.size4{font-size:1.33333em}.katex .fontsize-ensurer.reset-size2.size5,.katex .sizing.reset-size2.size5{font-size:1.5em}.katex .fontsize-ensurer.reset-size2.size6,.katex .sizing.reset-size2.size6{font-size:1.66667em}.katex .fontsize-ensurer.reset-size2.size7,.katex .sizing.reset-size2.size7{font-size:2em}.katex .fontsize-ensurer.reset-size2.size8,.katex .sizing.reset-size2.size8{font-size:2.4em}.katex .fontsize-ensurer.reset-size2.size9,.katex .sizing.reset-size2.size9{font-size:2.88em}.katex .fontsize-ensurer.reset-size2.size10,.katex .sizing.reset-size2.size10{font-size:3.45667em}.katex .fontsize-ensurer.reset-size2.size11,.katex .sizing.reset-size2.size11{font-size:4.14667em}.katex .fontsize-ensurer.reset-size3.size1,.katex .sizing.reset-size3.size1{font-size:.714286em}.katex .fontsize-ensurer.reset-size3.size2,.katex .sizing.reset-size3.size2{font-size:.857143em}.katex .fontsize-ensurer.reset-size3.size3,.katex .sizing.reset-size3.size3{font-size:1em}.katex .fontsize-ensurer.reset-size3.size4,.katex .sizing.reset-size3.size4{font-size:1.14286em}.katex .fontsize-ensurer.reset-size3.size5,.katex .sizing.reset-size3.size5{font-size:1.28571em}.katex .fontsize-ensurer.reset-size3.size6,.katex .sizing.reset-size3.size6{font-size:1.42857em}.katex .fontsize-ensurer.reset-size3.size7,.katex .sizing.reset-size3.size7{font-size:1.71429em}.katex .fontsize-ensurer.reset-size3.size8,.katex .sizing.reset-size3.size8{font-size:2.05714em}.katex .fontsize-ensurer.reset-size3.size9,.katex .sizing.reset-size3.size9{font-size:2.46857em}.katex .fontsize-ensurer.reset-size3.size10,.katex .sizing.reset-size3.size10{font-size:2.96286em}.katex .fontsize-ensurer.reset-size3.size11,.katex .sizing.reset-size3.size11{font-size:3.55429em}.katex .fontsize-ensurer.reset-size4.size1,.katex .sizing.reset-size4.size1{font-size:.625em}.katex .fontsize-ensurer.reset-size4.size2,.katex .sizing.reset-size4.size2{font-size:.75em}.katex .fontsize-ensurer.reset-size4.size3,.katex .sizing.reset-size4.size3{font-size:.875em}.katex .fontsize-ensurer.reset-size4.size4,.katex .sizing.reset-size4.size4{font-size:1em}.katex .fontsize-ensurer.reset-size4.size5,.katex .sizing.reset-size4.size5{font-size:1.125em}.katex .fontsize-ensurer.reset-size4.size6,.katex .sizing.reset-size4.size6{font-size:1.25em}.katex .fontsize-ensurer.reset-size4.size7,.katex .sizing.reset-size4.size7{font-size:1.5em}.katex .fontsize-ensurer.reset-size4.size8,.katex .sizing.reset-size4.size8{font-size:1.8em}.katex .fontsize-ensurer.reset-size4.size9,.katex .sizing.reset-size4.size9{font-size:2.16em}.katex .fontsize-ensurer.reset-size4.size10,.katex .sizing.reset-size4.size10{font-size:2.5925em}.katex .fontsize-ensurer.reset-size4.size11,.katex .sizing.reset-size4.size11{font-size:3.11em}.katex .fontsize-ensurer.reset-size5.size1,.katex .sizing.reset-size5.size1{font-size:.555556em}.katex .fontsize-ensurer.reset-size5.size2,.katex .sizing.reset-size5.size2{font-size:.666667em}.katex .fontsize-ensurer.reset-size5.size3,.katex .sizing.reset-size5.size3{font-size:.777778em}.katex .fontsize-ensurer.reset-size5.size4,.katex .sizing.reset-size5.size4{font-size:.888889em}.katex .fontsize-ensurer.reset-size5.size5,.katex .sizing.reset-size5.size5{font-size:1em}.katex .fontsize-ensurer.reset-size5.size6,.katex .sizing.reset-size5.size6{font-size:1.11111em}.katex .fontsize-ensurer.reset-size5.size7,.katex .sizing.reset-size5.size7{font-size:1.33333em}.katex .fontsize-ensurer.reset-size5.size8,.katex .sizing.reset-size5.size8{font-size:1.6em}.katex .fontsize-ensurer.reset-size5.size9,.katex .sizing.reset-size5.size9{font-size:1.92em}.katex .fontsize-ensurer.reset-size5.size10,.katex .sizing.reset-size5.size10{font-size:2.30444em}.katex .fontsize-ensurer.reset-size5.size11,.katex .sizing.reset-size5.size11{font-size:2.76444em}.katex .fontsize-ensurer.reset-size6.size1,.katex .sizing.reset-size6.size1{font-size:.5em}.katex .fontsize-ensurer.reset-size6.size2,.katex .sizing.reset-size6.size2{font-size:.6em}.katex .fontsize-ensurer.reset-size6.size3,.katex .sizing.reset-size6.size3{font-size:.7em}.katex .fontsize-ensurer.reset-size6.size4,.katex .sizing.reset-size6.size4{font-size:.8em}.katex .fontsize-ensurer.reset-size6.size5,.katex .sizing.reset-size6.size5{font-size:.9em}.katex .fontsize-ensurer.reset-size6.size6,.katex .sizing.reset-size6.size6{font-size:1em}.katex .fontsize-ensurer.reset-size6.size7,.katex .sizing.reset-size6.size7{font-size:1.2em}.katex .fontsize-ensurer.reset-size6.size8,.katex .sizing.reset-size6.size8{font-size:1.44em}.katex .fontsize-ensurer.reset-size6.size9,.katex .sizing.reset-size6.size9{font-size:1.728em}.katex .fontsize-ensurer.reset-size6.size10,.katex .sizing.reset-size6.size10{font-size:2.074em}.katex .fontsize-ensurer.reset-size6.size11,.katex .sizing.reset-size6.size11{font-size:2.488em}.katex .fontsize-ensurer.reset-size7.size1,.katex .sizing.reset-size7.size1{font-size:.416667em}.katex .fontsize-ensurer.reset-size7.size2,.katex .sizing.reset-size7.size2{font-size:.5em}.katex .fontsize-ensurer.reset-size7.size3,.katex .sizing.reset-size7.size3{font-size:.583333em}.katex .fontsize-ensurer.reset-size7.size4,.katex .sizing.reset-size7.size4{font-size:.666667em}.katex .fontsize-ensurer.reset-size7.size5,.katex .sizing.reset-size7.size5{font-size:.75em}.katex .fontsize-ensurer.reset-size7.size6,.katex .sizing.reset-size7.size6{font-size:.833333em}.katex .fontsize-ensurer.reset-size7.size7,.katex .sizing.reset-size7.size7{font-size:1em}.katex .fontsize-ensurer.reset-size7.size8,.katex .sizing.reset-size7.size8{font-size:1.2em}.katex .fontsize-ensurer.reset-size7.size9,.katex .sizing.reset-size7.size9{font-size:1.44em}.katex .fontsize-ensurer.reset-size7.size10,.katex .sizing.reset-size7.size10{font-size:1.72833em}.katex .fontsize-ensurer.reset-size7.size11,.katex .sizing.reset-size7.size11{font-size:2.07333em}.katex .fontsize-ensurer.reset-size8.size1,.katex .sizing.reset-size8.size1{font-size:.347222em}.katex .fontsize-ensurer.reset-size8.size2,.katex .sizing.reset-size8.size2{font-size:.416667em}.katex .fontsize-ensurer.reset-size8.size3,.katex .sizing.reset-size8.size3{font-size:.486111em}.katex .fontsize-ensurer.reset-size8.size4,.katex .sizing.reset-size8.size4{font-size:.555556em}.katex .fontsize-ensurer.reset-size8.size5,.katex .sizing.reset-size8.size5{font-size:.625em}.katex .fontsize-ensurer.reset-size8.size6,.katex .sizing.reset-size8.size6{font-size:.694444em}.katex .fontsize-ensurer.reset-size8.size7,.katex .sizing.reset-size8.size7{font-size:.833333em}.katex .fontsize-ensurer.reset-size8.size8,.katex .sizing.reset-size8.size8{font-size:1em}.katex .fontsize-ensurer.reset-size8.size9,.katex .sizing.reset-size8.size9{font-size:1.2em}.katex .fontsize-ensurer.reset-size8.size10,.katex .sizing.reset-size8.size10{font-size:1.44028em}.katex .fontsize-ensurer.reset-size8.size11,.katex .sizing.reset-size8.size11{font-size:1.72778em}.katex .fontsize-ensurer.reset-size9.size1,.katex .sizing.reset-size9.size1{font-size:.289352em}.katex .fontsize-ensurer.reset-size9.size2,.katex .sizing.reset-size9.size2{font-size:.347222em}.katex .fontsize-ensurer.reset-size9.size3,.katex .sizing.reset-size9.size3{font-size:.405093em}.katex .fontsize-ensurer.reset-size9.size4,.katex .sizing.reset-size9.size4{font-size:.462963em}.katex .fontsize-ensurer.reset-size9.size5,.katex .sizing.reset-size9.size5{font-size:.520833em}.katex .fontsize-ensurer.reset-size9.size6,.katex .sizing.reset-size9.size6{font-size:.578704em}.katex .fontsize-ensurer.reset-size9.size7,.katex .sizing.reset-size9.size7{font-size:.694444em}.katex .fontsize-ensurer.reset-size9.size8,.katex .sizing.reset-size9.size8{font-size:.833333em}.katex .fontsize-ensurer.reset-size9.size9,.katex .sizing.reset-size9.size9{font-size:1em}.katex .fontsize-ensurer.reset-size9.size10,.katex .sizing.reset-size9.size10{font-size:1.20023em}.katex .fontsize-ensurer.reset-size9.size11,.katex .sizing.reset-size9.size11{font-size:1.43981em}.katex .fontsize-ensurer.reset-size10.size1,.katex .sizing.reset-size10.size1{font-size:.24108em}.katex .fontsize-ensurer.reset-size10.size2,.katex .sizing.reset-size10.size2{font-size:.289296em}.katex .fontsize-ensurer.reset-size10.size3,.katex .sizing.reset-size10.size3{font-size:.337512em}.katex .fontsize-ensurer.reset-size10.size4,.katex .sizing.reset-size10.size4{font-size:.385728em}.katex .fontsize-ensurer.reset-size10.size5,.katex .sizing.reset-size10.size5{font-size:.433944em}.katex .fontsize-ensurer.reset-size10.size6,.katex .sizing.reset-size10.size6{font-size:.48216em}.katex .fontsize-ensurer.reset-size10.size7,.katex .sizing.reset-size10.size7{font-size:.578592em}.katex .fontsize-ensurer.reset-size10.size8,.katex .sizing.reset-size10.size8{font-size:.694311em}.katex .fontsize-ensurer.reset-size10.size9,.katex .sizing.reset-size10.size9{font-size:.833173em}.katex .fontsize-ensurer.reset-size10.size10,.katex .sizing.reset-size10.size10{font-size:1em}.katex .fontsize-ensurer.reset-size10.size11,.katex .sizing.reset-size10.size11{font-size:1.19961em}.katex .fontsize-ensurer.reset-size11.size1,.katex .sizing.reset-size11.size1{font-size:.200965em}.katex .fontsize-ensurer.reset-size11.size2,.katex .sizing.reset-size11.size2{font-size:.241158em}.katex .fontsize-ensurer.reset-size11.size3,.katex .sizing.reset-size11.size3{font-size:.281351em}.katex .fontsize-ensurer.reset-size11.size4,.katex .sizing.reset-size11.size4{font-size:.321543em}.katex .fontsize-ensurer.reset-size11.size5,.katex .sizing.reset-size11.size5{font-size:.361736em}.katex .fontsize-ensurer.reset-size11.size6,.katex .sizing.reset-size11.size6{font-size:.401929em}.katex .fontsize-ensurer.reset-size11.size7,.katex .sizing.reset-size11.size7{font-size:.482315em}.katex .fontsize-ensurer.reset-size11.size8,.katex .sizing.reset-size11.size8{font-size:.578778em}.katex .fontsize-ensurer.reset-size11.size9,.katex .sizing.reset-size11.size9{font-size:.694534em}.katex .fontsize-ensurer.reset-size11.size10,.katex .sizing.reset-size11.size10{font-size:.833601em}.katex .fontsize-ensurer.reset-size11.size11,.katex .sizing.reset-size11.size11{font-size:1em}.katex .delimsizing.size1{font-family:KaTeX_Size1}.katex .delimsizing.size2{font-family:KaTeX_Size2}.katex .delimsizing.size3{font-family:KaTeX_Size3}.katex .delimsizing.size4{font-family:KaTeX_Size4}.katex .delimsizing.mult .delim-size1>span{font-family:KaTeX_Size1}.katex .delimsizing.mult .delim-size4>span{font-family:KaTeX_Size4}.katex .nulldelimiter{width:.12em;display:inline-block}.katex .delimcenter,.katex .op-symbol{position:relative}.katex .op-symbol.small-op{font-family:KaTeX_Size1}.katex .op-symbol.large-op{font-family:KaTeX_Size2}.katex .accent>.vlist-t,.katex .op-limits>.vlist-t{text-align:center}.katex .accent .accent-body{position:relative}.katex .accent .accent-body:not(.accent-full){width:0}.katex .overlay{display:block}.katex .mtable .vertical-separator{min-width:1px;display:inline-block}.katex .mtable .arraycolsep{display:inline-block}.katex .mtable .col-align-c>.vlist-t{text-align:center}.katex .mtable .col-align-l>.vlist-t{text-align:left}.katex .mtable .col-align-r>.vlist-t{text-align:right}.katex .svg-align{text-align:left}.katex svg{fill:currentColor;stroke:currentColor;fill-rule:nonzero;fill-opacity:1;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;height:inherit;width:100%;display:block;position:absolute}.katex svg path{stroke:none}.katex img{border-style:none;min-width:0;max-width:none;min-height:0;max-height:none}.katex .stretchy{width:100%;display:block;position:relative;overflow:hidden}.katex .stretchy:after,.katex .stretchy:before{content:""}.katex .hide-tail{width:100%;position:relative;overflow:hidden}.katex .halfarrow-left{width:50.2%;position:absolute;left:0;overflow:hidden}.katex .halfarrow-right{width:50.2%;position:absolute;right:0;overflow:hidden}.katex .brace-left{width:25.1%;position:absolute;left:0;overflow:hidden}.katex .brace-center{width:50%;position:absolute;left:25%;overflow:hidden}.katex .brace-right{width:25.1%;position:absolute;right:0;overflow:hidden}.katex .x-arrow-pad{padding:0 .5em}.katex .cd-arrow-pad{padding:0 .55556em 0 .27778em}.katex .mover,.katex .munder,.katex .x-arrow{text-align:center}.katex .boxpad{padding:0 .3em}.katex .fbox,.katex .fcolorbox{box-sizing:border-box;border:.04em solid}.katex .cancel-pad{padding:0 .2em}.katex .cancel-lap{margin-left:-.2em;margin-right:-.2em}.katex .sout{border-bottom-style:solid;border-bottom-width:.08em}.katex .angl{box-sizing:border-box;border-top:.049em solid;border-right:.049em solid;margin-right:.03889em}.katex .anglpad{padding:0 .03889em}.katex .eqn-num:before{content:"(" counter(katexEqnNo) ")";counter-increment:katexEqnNo}.katex .mml-eqn-num:before{content:"(" counter(mmlEqnNo) ")";counter-increment:mmlEqnNo}.katex .mtr-glue{width:50%}.katex .cd-vert-arrow{display:inline-block;position:relative}.katex .cd-label-left{text-align:left;display:inline-block;position:absolute;right:calc(50% + .3em)}.katex .cd-label-right{text-align:right;display:inline-block;position:absolute;left:calc(50% + .3em)}.katex-display{text-align:center;margin:1em 0;display:block}.katex-display>.katex{text-align:center;white-space:nowrap;display:block}.katex-display>.katex>.katex-html{display:block;position:relative}.katex-display>.katex>.katex-html>.tag{position:absolute;right:0}.katex-display.leqno>.katex>.katex-html>.tag{left:0;right:auto}.katex-display.fleqn>.katex{text-align:left;padding-left:2em}body{counter-reset:katexEqnNo mmlEqnNo}
|