dsh-vt-web-chat 1.2.1 → 2.1.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.
Files changed (168) hide show
  1. package/README.md +75 -33
  2. package/client.js +1272 -739
  3. package/docs/research/01-chat-demo-embedding.md +322 -0
  4. package/index.js +36 -8
  5. package/locale/en.json +1 -1
  6. package/locale/zh.json +1 -1
  7. package/package.json +16 -5
  8. package/scripts/dev-server.mjs +54 -0
  9. package/scripts/sync-upstream.mjs +256 -0
  10. package/src/auth.js +65 -0
  11. package/src/maintenance.js +240 -0
  12. package/src/proxy.js +139 -0
  13. package/src/route.js +307 -0
  14. package/src/settings.js +74 -0
  15. package/webview/UPSTREAM.json +6 -0
  16. package/webview/dist/LICENSE +21 -0
  17. package/webview/dist/index.html +1 -0
  18. package/webview/dist/static/css/async/4959.1382f613.css +1 -0
  19. package/webview/dist/static/css/main.27198ffe.css +1 -0
  20. package/webview/dist/static/js/async/1031.575fa503.js +1 -0
  21. package/webview/dist/static/js/async/1085.769e13d5.js +1 -0
  22. package/webview/dist/static/js/async/1086.4d3be1fa.js +1 -0
  23. package/webview/dist/static/js/async/1097.4f798919.js +117 -0
  24. package/webview/dist/static/js/async/1299.0ef86619.js +1 -0
  25. package/webview/dist/static/js/async/1393.6ef1efab.js +1 -0
  26. package/webview/dist/static/js/async/1401.88487cba.js +1 -0
  27. package/webview/dist/static/js/async/1505.8913966f.js +1 -0
  28. package/webview/dist/static/js/async/160.81018107.js +55 -0
  29. package/webview/dist/static/js/async/1679.153f9f03.js +1 -0
  30. package/webview/dist/static/js/async/1690.fe25bdfe.js +1 -0
  31. package/webview/dist/static/js/async/2110.a1d33f2f.js +215 -0
  32. package/webview/dist/static/js/async/2152.97b0a90c.js +1 -0
  33. package/webview/dist/static/js/async/2168.9925ab2d.js +1 -0
  34. package/webview/dist/static/js/async/2312.4fd0ef8e.js +1 -0
  35. package/webview/dist/static/js/async/2348.41564e59.js +148 -0
  36. package/webview/dist/static/js/async/2356.631a6aca.js +1 -0
  37. package/webview/dist/static/js/async/2415.00900482.js +1 -0
  38. package/webview/dist/static/js/async/2461.15199935.js +1 -0
  39. package/webview/dist/static/js/async/2541.f8eac009.js +1 -0
  40. package/webview/dist/static/js/async/2607.abb8bc11.js +1 -0
  41. package/webview/dist/static/js/async/265.b43cee3f.js +1 -0
  42. package/webview/dist/static/js/async/2696.60d5ecf0.js +1 -0
  43. package/webview/dist/static/js/async/3014.c8e9b88f.js +1 -0
  44. package/webview/dist/static/js/async/3111.e2cca965.js +1 -0
  45. package/webview/dist/static/js/async/3251.0b9c608e.js +1 -0
  46. package/webview/dist/static/js/async/3339.ed293391.js +1 -0
  47. package/webview/dist/static/js/async/3376.3aa54d1a.js +93 -0
  48. package/webview/dist/static/js/async/3465.845187e8.js +1 -0
  49. package/webview/dist/static/js/async/3477.94bd21ab.js +5 -0
  50. package/webview/dist/static/js/async/3594.edfe4411.js +1 -0
  51. package/webview/dist/static/js/async/3806.28abb895.js +1 -0
  52. package/webview/dist/static/js/async/3909.4b4bd806.js +1 -0
  53. package/webview/dist/static/js/async/4138.104dbc81.js +1 -0
  54. package/webview/dist/static/js/async/426.6fedaabe.js +1 -0
  55. package/webview/dist/static/js/async/4387.151c5858.js +1 -0
  56. package/webview/dist/static/js/async/4468.d0c907eb.js +1 -0
  57. package/webview/dist/static/js/async/4471.b0874c8d.js +158 -0
  58. package/webview/dist/static/js/async/4568.cf5e547d.js +1 -0
  59. package/webview/dist/static/js/async/4580.f1bc120a.js +131 -0
  60. package/webview/dist/static/js/async/4695.8f4b8910.js +1 -0
  61. package/webview/dist/static/js/async/4959.deb41780.js +1 -0
  62. package/webview/dist/static/js/async/509.f3e093b4.js +59 -0
  63. package/webview/dist/static/js/async/5172.e1e3bd11.js +43 -0
  64. package/webview/dist/static/js/async/535.e10ba324.js +1 -0
  65. package/webview/dist/static/js/async/5546.89da376c.js +24 -0
  66. package/webview/dist/static/js/async/5597.3018e134.js +36 -0
  67. package/webview/dist/static/js/async/5636.61075f0b.js +174 -0
  68. package/webview/dist/static/js/async/5638.7cfdcd7e.js +1 -0
  69. package/webview/dist/static/js/async/5706.d34ac064.js +1 -0
  70. package/webview/dist/static/js/async/5856.d75c4e3b.js +1 -0
  71. package/webview/dist/static/js/async/6061.7cfcc3e9.js +1 -0
  72. package/webview/dist/static/js/async/6152.d3a64904.js +1 -0
  73. package/webview/dist/static/js/async/6297.6e694780.js +1 -0
  74. package/webview/dist/static/js/async/6325.cafe9e55.js +1 -0
  75. package/webview/dist/static/js/async/6332.682f48c9.js +1 -0
  76. package/webview/dist/static/js/async/6349.e9992b47.js +56 -0
  77. package/webview/dist/static/js/async/6389.1bb952e3.js +1 -0
  78. package/webview/dist/static/js/async/6443.95da1923.js +1 -0
  79. package/webview/dist/static/js/async/6526.56ce7dc4.js +1 -0
  80. package/webview/dist/static/js/async/6600.6e0dfb69.js +1 -0
  81. package/webview/dist/static/js/async/6689.d0bd8935.js +262 -0
  82. package/webview/dist/static/js/async/6751.54c80aba.js +1 -0
  83. package/webview/dist/static/js/async/680.5aa7dcb4.js +1 -0
  84. package/webview/dist/static/js/async/6948.9cd716f4.js +1 -0
  85. package/webview/dist/static/js/async/7262.f680270f.js +88 -0
  86. package/webview/dist/static/js/async/7515.20c14480.js +1 -0
  87. package/webview/dist/static/js/async/7536.34769b35.js +1 -0
  88. package/webview/dist/static/js/async/7630.ed725458.js +1 -0
  89. package/webview/dist/static/js/async/7853.0a4b794a.js +1 -0
  90. package/webview/dist/static/js/async/8180.4d4299ef.js +1 -0
  91. package/webview/dist/static/js/async/828.56686119.js +1 -0
  92. package/webview/dist/static/js/async/8379.1b75211c.js +1 -0
  93. package/webview/dist/static/js/async/8389.4f120664.js +1 -0
  94. package/webview/dist/static/js/async/8538.d5f92d14.js +24 -0
  95. package/webview/dist/static/js/async/8560.1bdf90ec.js +1 -0
  96. package/webview/dist/static/js/async/8794.759831e8.js +60 -0
  97. package/webview/dist/static/js/async/8821.2b444259.js +29 -0
  98. package/webview/dist/static/js/async/925.548cc1b9.js +1 -0
  99. package/webview/dist/static/js/async/9252.3c22a9cd.js +1 -0
  100. package/webview/dist/static/js/async/9261.1e796956.js +1 -0
  101. package/webview/dist/static/js/async/9324.b3518ebf.js +1 -0
  102. package/webview/dist/static/js/async/9354.4425ac3c.js +1 -0
  103. package/webview/dist/static/js/async/9501.a7851380.js +4 -0
  104. package/webview/dist/static/js/async/9560.d604e606.js +166 -0
  105. package/webview/dist/static/js/async/9640.5f6a6734.js +1 -0
  106. package/webview/dist/static/js/async/9765.ecc8b5dc.js +1 -0
  107. package/webview/dist/static/js/async/9821.b1897048.js +63 -0
  108. package/webview/dist/static/js/main.12b22c21.js +3 -0
  109. package/webview/dist/static/media/KaTeX_AMS-Regular.1608a09b.woff +0 -0
  110. package/webview/dist/static/media/KaTeX_AMS-Regular.4aafdb68.ttf +0 -0
  111. package/webview/dist/static/media/KaTeX_AMS-Regular.a79f1c31.woff2 +0 -0
  112. package/webview/dist/static/media/KaTeX_Caligraphic-Bold.b6770918.woff +0 -0
  113. package/webview/dist/static/media/KaTeX_Caligraphic-Bold.cce5b8ec.ttf +0 -0
  114. package/webview/dist/static/media/KaTeX_Caligraphic-Bold.ec17d132.woff2 +0 -0
  115. package/webview/dist/static/media/KaTeX_Caligraphic-Regular.07ef19e7.ttf +0 -0
  116. package/webview/dist/static/media/KaTeX_Caligraphic-Regular.55fac258.woff2 +0 -0
  117. package/webview/dist/static/media/KaTeX_Caligraphic-Regular.dad44a7f.woff +0 -0
  118. package/webview/dist/static/media/KaTeX_Fraktur-Bold.9f256b85.woff +0 -0
  119. package/webview/dist/static/media/KaTeX_Fraktur-Bold.b18f59e1.ttf +0 -0
  120. package/webview/dist/static/media/KaTeX_Fraktur-Bold.d42a5579.woff2 +0 -0
  121. package/webview/dist/static/media/KaTeX_Fraktur-Regular.7c187121.woff +0 -0
  122. package/webview/dist/static/media/KaTeX_Fraktur-Regular.d3c882a6.woff2 +0 -0
  123. package/webview/dist/static/media/KaTeX_Fraktur-Regular.ed38e79f.ttf +0 -0
  124. package/webview/dist/static/media/KaTeX_Main-Bold.b74a1a8b.ttf +0 -0
  125. package/webview/dist/static/media/KaTeX_Main-Bold.c3fb5ac2.woff2 +0 -0
  126. package/webview/dist/static/media/KaTeX_Main-Bold.d181c465.woff +0 -0
  127. package/webview/dist/static/media/KaTeX_Main-BoldItalic.6f2bb1df.woff2 +0 -0
  128. package/webview/dist/static/media/KaTeX_Main-BoldItalic.70d8b0a5.ttf +0 -0
  129. package/webview/dist/static/media/KaTeX_Main-BoldItalic.e3f82f9d.woff +0 -0
  130. package/webview/dist/static/media/KaTeX_Main-Italic.47373d1e.ttf +0 -0
  131. package/webview/dist/static/media/KaTeX_Main-Italic.8916142b.woff2 +0 -0
  132. package/webview/dist/static/media/KaTeX_Main-Italic.9024d815.woff +0 -0
  133. package/webview/dist/static/media/KaTeX_Main-Regular.0462f03b.woff2 +0 -0
  134. package/webview/dist/static/media/KaTeX_Main-Regular.7f51fe03.woff +0 -0
  135. package/webview/dist/static/media/KaTeX_Main-Regular.b7f8fe9b.ttf +0 -0
  136. package/webview/dist/static/media/KaTeX_Math-BoldItalic.572d331f.woff2 +0 -0
  137. package/webview/dist/static/media/KaTeX_Math-BoldItalic.a879cf83.ttf +0 -0
  138. package/webview/dist/static/media/KaTeX_Math-BoldItalic.f1035d8d.woff +0 -0
  139. package/webview/dist/static/media/KaTeX_Math-Italic.5295ba48.woff +0 -0
  140. package/webview/dist/static/media/KaTeX_Math-Italic.939bc644.ttf +0 -0
  141. package/webview/dist/static/media/KaTeX_Math-Italic.f28c23ac.woff2 +0 -0
  142. package/webview/dist/static/media/KaTeX_SansSerif-Bold.8c5b5494.woff2 +0 -0
  143. package/webview/dist/static/media/KaTeX_SansSerif-Bold.94e1e8dc.ttf +0 -0
  144. package/webview/dist/static/media/KaTeX_SansSerif-Bold.bf59d231.woff +0 -0
  145. package/webview/dist/static/media/KaTeX_SansSerif-Italic.3b1e59b3.woff2 +0 -0
  146. package/webview/dist/static/media/KaTeX_SansSerif-Italic.7c9bc82b.woff +0 -0
  147. package/webview/dist/static/media/KaTeX_SansSerif-Italic.b4c20c84.ttf +0 -0
  148. package/webview/dist/static/media/KaTeX_SansSerif-Regular.74048478.woff +0 -0
  149. package/webview/dist/static/media/KaTeX_SansSerif-Regular.ba21ed5f.woff2 +0 -0
  150. package/webview/dist/static/media/KaTeX_SansSerif-Regular.d4d7ba48.ttf +0 -0
  151. package/webview/dist/static/media/KaTeX_Script-Regular.03e9641d.woff2 +0 -0
  152. package/webview/dist/static/media/KaTeX_Script-Regular.07505710.woff +0 -0
  153. package/webview/dist/static/media/KaTeX_Script-Regular.fe9cbbe1.ttf +0 -0
  154. package/webview/dist/static/media/KaTeX_Size1-Regular.e1e279cb.woff +0 -0
  155. package/webview/dist/static/media/KaTeX_Size1-Regular.eae34984.woff2 +0 -0
  156. package/webview/dist/static/media/KaTeX_Size1-Regular.fabc004a.ttf +0 -0
  157. package/webview/dist/static/media/KaTeX_Size2-Regular.57727022.woff +0 -0
  158. package/webview/dist/static/media/KaTeX_Size2-Regular.5916a24f.woff2 +0 -0
  159. package/webview/dist/static/media/KaTeX_Size2-Regular.d6b476ec.ttf +0 -0
  160. package/webview/dist/static/media/KaTeX_Size3-Regular.9acaf01c.woff +0 -0
  161. package/webview/dist/static/media/KaTeX_Size3-Regular.a144ef58.ttf +0 -0
  162. package/webview/dist/static/media/KaTeX_Size3-Regular.b4230e7e.woff2 +0 -0
  163. package/webview/dist/static/media/KaTeX_Size4-Regular.10d95fd3.woff2 +0 -0
  164. package/webview/dist/static/media/KaTeX_Size4-Regular.7a996c9d.woff +0 -0
  165. package/webview/dist/static/media/KaTeX_Size4-Regular.fbccdabe.ttf +0 -0
  166. package/webview/dist/static/media/KaTeX_Typewriter-Regular.6258592b.woff +0 -0
  167. package/webview/dist/static/media/KaTeX_Typewriter-Regular.a8709e36.woff2 +0 -0
  168. package/webview/dist/static/media/KaTeX_Typewriter-Regular.d97aaf4a.ttf +0 -0
package/src/proxy.js ADDED
@@ -0,0 +1,139 @@
1
+ /**
2
+ * 把浏览器发到插件路由的请求转给 DeepSeek,并注入宿主凭据。
3
+ *
4
+ * 边界:浏览器只认识 `/webchat/<path>`,永远拿不到 token;
5
+ * 上游地址由宿主拼回 `https://api.deepseek.com/<path>`。
6
+ */
7
+ import { Readable } from 'node:stream';
8
+ import { pipeline } from 'node:stream/promises';
9
+ import { DEEPSEEK_BASE_URL, resolveAuth } from './auth.js';
10
+
11
+ /** 不向上游转发的逐跳头。 */
12
+ const HOP_BY_HOP = new Set([
13
+ 'connection',
14
+ 'keep-alive',
15
+ 'proxy-authenticate',
16
+ 'proxy-authorization',
17
+ 'te',
18
+ 'trailer',
19
+ 'transfer-encoding',
20
+ 'upgrade',
21
+ 'host',
22
+ 'content-length',
23
+ 'cookie',
24
+ ]);
25
+
26
+ /**
27
+ * 把 Headers 之外的请求头收敛成可转发的普通对象。
28
+ * @param req - Node 请求。
29
+ * @returns 小写键名的新对象。
30
+ */
31
+ function forwardableHeaders(req) {
32
+ const headers = {};
33
+ for (const [name, value] of Object.entries(req.headers)) {
34
+ if (HOP_BY_HOP.has(name) || value === undefined) continue;
35
+ headers[name] = Array.isArray(value) ? value.join(', ') : value;
36
+ }
37
+ return headers;
38
+ }
39
+
40
+ /**
41
+ * 转发一次请求。
42
+ * @param ctx - Host 插件上下文。
43
+ * @param req - Node 请求。
44
+ * @param res - Node 响应。
45
+ * @param options - `{ baseURL, pathname, search }`;pathname 含 `/webchat` 前缀。
46
+ * @returns 无返回;响应已写回。
47
+ */
48
+ export async function proxyRequest(ctx, req, res, { baseURL = DEEPSEEK_BASE_URL, pathname, search = '' }) {
49
+ const auth = await resolveAuth(ctx, baseURL);
50
+ if (auth === undefined) {
51
+ writeJson(res, 401, {
52
+ type: 'error',
53
+ error: {
54
+ type: 'authentication_error',
55
+ message:
56
+ '当前 DSH 没有可用的 DeepSeek 凭据:请先登录 DeepSeek 账户,或在「设置 → 模型」里配置 DeepSeek API Key。',
57
+ },
58
+ });
59
+ return;
60
+ }
61
+
62
+ const upstreamPath = pathname.slice('/webchat'.length) || '/';
63
+ const target = `${baseURL.replace(/\/+$/u, '')}${upstreamPath}${search}`;
64
+ const method = (req.method ?? 'GET').toUpperCase();
65
+
66
+ // 聊天的 SSE 会持续很久;客户端离开面板时必须一起取消,否则请求会挂在上游。
67
+ const controller = new AbortController();
68
+ const onClose = () => {
69
+ if (!res.writableEnded) controller.abort();
70
+ };
71
+ res.on('close', onClose);
72
+
73
+ const headers = {
74
+ 'anthropic-version': '2023-06-01',
75
+ 'anthropic-beta': typeof req.headers['anthropic-beta'] === 'string' ? req.headers['anthropic-beta'] : 'files-api-2025-04-14',
76
+ ...forwardableHeaders(req),
77
+ ...auth.headers,
78
+ };
79
+ if (headers.accept === undefined) headers.accept = 'text/event-stream';
80
+ // SSE 必须逐块到达浏览器;请求上游压缩会让整段响应被攒起来,还容易和头部转发脱节。
81
+ headers['accept-encoding'] = 'identity';
82
+
83
+ const init = { method, headers, signal: controller.signal };
84
+ if (method !== 'GET' && method !== 'HEAD') {
85
+ // 文件上传是 multipart,可能是几十 MB:直接流式转发,不读进内存。
86
+ init.body = Readable.toWeb(req);
87
+ init.duplex = 'half';
88
+ }
89
+
90
+ let upstream;
91
+ try {
92
+ upstream = await fetch(target, init);
93
+ } catch (error) {
94
+ if (controller.signal.aborted) return;
95
+ writeJson(res, 502, {
96
+ type: 'error',
97
+ error: { type: 'api_error', message: `无法连接 DeepSeek:${error instanceof Error ? error.message : String(error)}` },
98
+ });
99
+ return;
100
+ }
101
+
102
+ const responseHeaders = {
103
+ 'cache-control': 'no-store',
104
+ 'x-accel-buffering': 'no',
105
+ };
106
+ const contentType = upstream.headers.get('content-type');
107
+ if (contentType !== null) responseHeaders['content-type'] = contentType;
108
+ // 万一上游无视 identity 仍然压缩,编码头必须一起转发,否则浏览器拿到的是二进制。
109
+ const encoding = upstream.headers.get('content-encoding');
110
+ if (encoding !== null) responseHeaders['content-encoding'] = encoding;
111
+ res.writeHead(upstream.status, responseHeaders);
112
+
113
+ if (upstream.body === null || method === 'HEAD') {
114
+ res.end();
115
+ return;
116
+ }
117
+ try {
118
+ await pipeline(Readable.fromWeb(upstream.body), res);
119
+ } catch {
120
+ // 客户端中途关闭:上游已被 abort,这里只需收掉响应。
121
+ if (!res.writableEnded) res.destroy();
122
+ }
123
+ }
124
+
125
+ /**
126
+ * 写一个 JSON 响应。
127
+ * @param res - Node 响应。
128
+ * @param status - HTTP 状态码。
129
+ * @param value - 可序列化对象。
130
+ */
131
+ export function writeJson(res, status, value) {
132
+ const body = JSON.stringify(value);
133
+ res.writeHead(status, {
134
+ 'content-type': 'application/json; charset=utf-8',
135
+ 'cache-control': 'no-store',
136
+ 'content-length': Buffer.byteLength(body),
137
+ });
138
+ res.end(body);
139
+ }
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 };
@@ -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,6 @@
1
+ {
2
+ "repo": "https://github.com/deepseek-ai/chat-demo.git",
3
+ "ref": "8ad7b56e196b87d8a3215dc09476d6d146ad3f0e",
4
+ "apiOrigin": "/webchat",
5
+ "builtAt": "2026-11-22T07:53:16.901Z"
6
+ }
@@ -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.12b22c21.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}