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
|
@@ -0,0 +1,322 @@
|
|
|
1
|
+
# 01 · 用官方 chat-demo 重做「网页对话」
|
|
2
|
+
|
|
3
|
+
> 调研时间:2026-11-21
|
|
4
|
+
> 结论:已实现并验证。`vt-web-chat` 从「桌面端内嵌浏览器打开 chat.deepseek.com」改成
|
|
5
|
+
> 「插件自己托管官方 chat-demo 前端 + 宿主代理 DeepSeek API」,版本 `2.0.0`。
|
|
6
|
+
> 实现过程中新增了一项需求:会话保留策略(默认 30 天,可在设置里改),见 §10。
|
|
7
|
+
|
|
8
|
+
## 1. 现状与故障归因
|
|
9
|
+
|
|
10
|
+
`vt-web-chat` 1.2.1 用桌面壳的 guest 租约桥(Electron `<webview>`)打开 `chat.deepseek.com`。
|
|
11
|
+
三个问题都由「我们不是那个站点的宿主」直接导致:
|
|
12
|
+
|
|
13
|
+
| 现象 | 根因 | 能否在现方案里修 |
|
|
14
|
+
|---|---|---|
|
|
15
|
+
| 进入后提示使用环境异常 | 站点检测到 Electron 运行环境 | 只能替用户勾「不再提示」,改 UA 属于伪装,不做 |
|
|
16
|
+
| 经常要重新登录 | guest 分区是内存级(`dsh-sidebar-browser-<uuid>` 无 `persist:` 前缀),退出即丢 Cookie | 只有上游 DSH 改成磁盘分区才行,插件层改不动 |
|
|
17
|
+
| Web 环境(浏览器)不可用 | 租约桥只在桌面壳里存在 | 不可能 |
|
|
18
|
+
|
|
19
|
+
也就是说,只要页面还是 `chat.deepseek.com`,这三件事都不在我们的控制范围内。
|
|
20
|
+
|
|
21
|
+
## 2. 目标
|
|
22
|
+
|
|
23
|
+
1. 界面与交互是 DeepSeek 网页版那一套,但由我们的插件自己提供,不再依赖站点;
|
|
24
|
+
2. 用 DeepSeek API 计费与出结果,**不需要用户填 API Key**,直接用 DSH 里已登录的 DeepSeek 账户;
|
|
25
|
+
3. 不再有「使用环境异常」,不再需要反复登录,桌面端与 Web 端行为一致;
|
|
26
|
+
4. 与 DSH 自身的会话、系统提示词、工具彻底分开:这是一个「聊天用的 DeepSeek」,不是一个更弱的 agent。
|
|
27
|
+
|
|
28
|
+
## 3. 三方验证过的事实
|
|
29
|
+
|
|
30
|
+
| 事实 | 来源 | 对本计划的意义 |
|
|
31
|
+
|---|---|---|
|
|
32
|
+
| 官方开源前端是 [`deepseek-ai/chat-demo`](https://github.com/deepseek-ai/chat-demo)(MIT),纯静态、无后端,浏览器直连 API | 官方 README | 可以直接托管,不需要我们写后端 |
|
|
33
|
+
| 它走 **Anthropic 兼容的 Messages / Files API**,默认 `apiOrigin = https://api.deepseek.com`,由 `createConfig({ apiOrigin })` 注入 `__API_ORIGIN__` | `rspack.config.ts` | 构建时把 `apiOrigin` 指到我们的插件路由即可,不必改前端代码 |
|
|
34
|
+
| `output.publicPath: 'auto'`,资源按脚本相对位置加载 | 同上 | 可以挂在 `/webchat/` 这样的前缀下,不需要额外的 base 配置 |
|
|
35
|
+
| 官方 API 已开放「全家桶」能力:`deepseek_web_search` / `deepseek_read_url`、文件输入、ASR/TTS、思考 | [官方公告](https://api-docs.deepseek.com/news/news261113) | 网页版的搜索、深度思考、引用、语音都能 1:1 成立 |
|
|
36
|
+
| DSH 账号路由的 token 通过 `x-dsh-auth-token` 发往 `inferenceOrigin`(默认 `https://api.deepseek.com`),文件认证同一来源 | `dsh-deepseek-account` README | 宿主可以代发推理与文件请求,浏览器不需要 Key |
|
|
37
|
+
| 账号路由的模型目录来自 `GET https://api.deepseek.com/models`,按账号实际可用模型给 | `dsh-llm-deepseek-account` README | 模型不能硬编码,应跟随账号目录 |
|
|
38
|
+
| `webServer` 支持 `prefix` 路由 + Fetch `Response` 或 Node `handler`,静态与 POST 都能承载 | `dsh-host-webserver` README | 一个插件路由就能同时做静态托管与 API 代理 |
|
|
39
|
+
| DSH 的 `main` + `sidebar.panellist` 槽位可以挂一个整页面板,同源 `iframe` 可用 | `vt-web-chat` 现有实现 + 社区 [`chat-in-dsh`](https://github.com/YinkaiYu/chat-in-dsh) | 不需要桌面壳的 webview 租约,Web 端也成立 |
|
|
40
|
+
| `chat-in-dsh`(MIT)已经用这套架构跑通,产物 dist ≈ 4.25 MB、153 个文件 | 其仓库树 | 架构判定有独立证据;也提示「产物要 vendor 进仓库」 |
|
|
41
|
+
|
|
42
|
+
## 4. 目标架构
|
|
43
|
+
|
|
44
|
+
```mermaid
|
|
45
|
+
flowchart LR
|
|
46
|
+
subgraph R["DSH 渲染进程(桌面壳或浏览器)"]
|
|
47
|
+
P["main 槽位面板<br/>iframe src=/webchat/"]
|
|
48
|
+
D["chat-demo 前端<br/>(官方构建产物)"]
|
|
49
|
+
P --> D
|
|
50
|
+
end
|
|
51
|
+
subgraph H["Host 半边(插件进程内)"]
|
|
52
|
+
S["webServer prefix 路由 /webchat"]
|
|
53
|
+
ST["静态托管<br/>dist + 目录穿越校验"]
|
|
54
|
+
PX["API 代理<br/>注入账号 token"]
|
|
55
|
+
S --> ST
|
|
56
|
+
S --> PX
|
|
57
|
+
end
|
|
58
|
+
A["ctx.deepseekAccount<br/>resolveToken()"]
|
|
59
|
+
C["ctx.credentials<br/>DEEPSEEK_API_KEY"]
|
|
60
|
+
U["https://api.deepseek.com"]
|
|
61
|
+
D -- "POST /webchat/anthropic/v1/messages" --> S
|
|
62
|
+
D -- "GET /webchat/models" --> S
|
|
63
|
+
D -- "POST /webchat/v1/tools/asr|tts" --> S
|
|
64
|
+
PX --> A
|
|
65
|
+
PX -. 无账号时 .-> C
|
|
66
|
+
PX --> U
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
请求路径与凭据:
|
|
70
|
+
|
|
71
|
+
1. 浏览器侧的 `chat-demo` 只认 `/webchat` 这一个 origin,不持有任何密钥;
|
|
72
|
+
2. 宿主把 `/webchat/<path>` 拼回 `https://api.deepseek.com/<path>`,带上 `x-dsh-auth-token`;
|
|
73
|
+
3. 账号不可用时退回 `DEEPSEEK_API_KEY`(`Authorization: Bearer`),两者都没有就返回明确的 401 文案;
|
|
74
|
+
4. 流式响应按字节回灌,不缓冲整段;`files` 的 multipart 用流式转发,避免大文件进内存。
|
|
75
|
+
|
|
76
|
+
## 5. 关键决策(需要确认)
|
|
77
|
+
|
|
78
|
+
| 决策 | 选项 | 建议 |
|
|
79
|
+
|---|---|---|
|
|
80
|
+
| 实现归属 | A 自研 v2 替换 `vt-web-chat` / B 市场收录 `chat-in-dsh` / C 两者并存 | **A**。我们已有「网页对话」入口与用户预期,自研可控文案、i18n、自检与发版节奏;B 只作为架构参照 |
|
|
81
|
+
| 构建产物 | A vendor `dist` 提交进仓库 / B 安装时构建 / C 要求用户自己 build | **A**,符合仓库约定 §5「构建产物提交进仓库」,安装即用 |
|
|
82
|
+
| 上游同步 | A pin commit + patches + 同步脚本 / B 跟随 main | **A**。上游是官方活跃仓库,patch 面越小越好 |
|
|
83
|
+
| 与 DSH 会话的关系 | A 完全独立 / B 支持单向导入 DSH 会话 / C 双向同步 | **A + 可选 B**。双向同步会让两套系统提示词互相污染 |
|
|
84
|
+
| 模型 | A 跟随账号目录(`/models`) / B 固定 `deepseek-flash` | **A**,`/models` 本来就代理到账号目录,顺手即可 |
|
|
85
|
+
| v1 范围 | 对话/流式/思考/搜索/引用/文件/Markdown+Mermaid+KaTeX/深浅色 | 语音(ASR/TTS)与桌面麦克风桥放 v1.1 |
|
|
86
|
+
|
|
87
|
+
## 6. 分阶段执行计划
|
|
88
|
+
|
|
89
|
+
### P0 · 可行性与协议验证(0.5 天,先做,失败即止损)
|
|
90
|
+
|
|
91
|
+
目的是用最小代码量证明「账号 token 能顶替 API Key 驱动官方前端」,再谈界面。
|
|
92
|
+
|
|
93
|
+
- [ ] 把官方 `dist` 原样放到 `/webchat` 静态路由,验证:
|
|
94
|
+
- 桌面端 `main` 面板 iframe 能加载并渲染;
|
|
95
|
+
- Web 端(浏览器)同样能加载;
|
|
96
|
+
- 资源、字体、异步 chunk 在 `/webchat/` 前缀下 200。
|
|
97
|
+
- [ ] 用一个 30 行的代理验证 `POST /anthropic/v1/messages` 流式成功(账号 token / API Key 各一次)。
|
|
98
|
+
- [ ] 验证 `GET /models` 返回账号目录,确认默认模型 id 与 `deepseek-flash` 的关系。
|
|
99
|
+
- [ ] 验证 `deepseek_web_search`、`deepseek_read_url`、`thinking` 扩展参数被接受,且响应块能原样回传第二轮。
|
|
100
|
+
- [ ] 记录失败点:哪些端点需要额外头(`anthropic-version`、`anthropic-beta: files-api-2025-04-14`)。
|
|
101
|
+
|
|
102
|
+
**通过标准**:一句话提问能在面板里流式回答,且带思考与搜索引用。
|
|
103
|
+
**失败退路**:若账号 token 只允许部分端点,则退回「API Key 优先 + 账号尽力」并在设置页说明。
|
|
104
|
+
|
|
105
|
+
### P1 · 插件骨架(1 天)
|
|
106
|
+
|
|
107
|
+
- [ ] 目录调整:`plugins/vt-web-chat/` 下新增 `webview/dist/`(产物)、`patches/`、`scripts/sync-upstream.mjs`。
|
|
108
|
+
- [ ] Host 半边重写:`index.js` 只留 `apply`,路由与代理拆到 `src/route.js`(静态)、`src/proxy.js`(转发)、`src/auth.js`(凭据)。
|
|
109
|
+
- [ ] 静态托管:MIME 表、`..` 穿越拒绝、`index.html` 现读注入引导脚本(避免升级后引用旧 chunk)。
|
|
110
|
+
- [ ] 请求准入:复用 `ctx.get('connection').requestRejection(req)`,桌面 `dsh-app:` 放行(与 `vt-quick-chat` 同一套)。
|
|
111
|
+
- [ ] Client 半边重写:`client.js` 从 915 行降到 ≈150 行,只做面板 + iframe + 错误边界 + 空态(凭据缺失时给「去登录」/「去模型设置」)。
|
|
112
|
+
- [ ] 保留 `sidebar.panellist` 的 `order: -10`(贴着「新会话」),`main` 的 key 不变,用户升级后入口位置不变。
|
|
113
|
+
- [ ] locale:`zh` / `en` 文案改为「由 API 驱动的网页对话」,去掉 webview 相关描述。
|
|
114
|
+
|
|
115
|
+
**通过标准**:`dsh plugin add` 后重启即用;无凭据时面板给出可操作提示而不是白屏。
|
|
116
|
+
|
|
117
|
+
### P2 · 前端适配与体验对齐(1–2 天)
|
|
118
|
+
|
|
119
|
+
- [ ] 构建补丁(保持在个位数、可重放):
|
|
120
|
+
- `apiOrigin` 指向 `/webchat`;
|
|
121
|
+
- 去掉/隐藏「API Key」设置项与首屏 key gate(用引导脚本塞占位值也可以,改代码更干净);
|
|
122
|
+
- 品牌位(左上角标识)改成我们的口径,避免用户以为是官网直连;
|
|
123
|
+
- 语言跟随宿主 locale,主题跟随 DSH 深浅色。
|
|
124
|
+
- [ ] 首页引导脚本:一次性写入 `locale` / `thinking` 默认值,之后完全交给上游自己的设置。
|
|
125
|
+
- [ ] 上传与语音:文件走 `/webchat/anthropic/v1/files`;语音按需补 `/webchat/v1/tools/{asr,tts}`。
|
|
126
|
+
- [ ] 桌面麦克风桥:桌面壳只给主框架授权,面板从 `window.top` 取流(`chat-in-dsh` 已验证的路径)。
|
|
127
|
+
- [ ] 自检路由 `GET /webchat/api/self-test`:入口页、主 chunk、一次真实 messages 往返。
|
|
128
|
+
|
|
129
|
+
**通过标准**:在面板里能完成「发问 → 思考 → 搜索引用 → 上传 PDF → 多轮」且第二轮上下文正确。
|
|
130
|
+
|
|
131
|
+
### P3 · 验证、清理与发布(0.5–1 天)
|
|
132
|
+
|
|
133
|
+
- [ ] 测试:代理单测(鉴权选择、路径拼接、错误帧)、静态穿越、凭据缺失、`models` 回退。
|
|
134
|
+
- [ ] 删除 `webview` 租约相关代码与桌面端耦合,README 重写(含迁移说明)。
|
|
135
|
+
- [ ] 版本 `1.2.1 → 2.0.0`(行为与载体都变了,属于破坏性升级)。
|
|
136
|
+
- [ ] `pnpm market` → tag `vt-web-chat-v2.0.0` → CI 发布。
|
|
137
|
+
- [ ] 迁移说明:旧面板登录的是官网账号,历史在官网;新面板历史是自己的 IndexedDB,
|
|
138
|
+
需要旧历史时用官网「设置 → 数据管理 → 导出所有历史对话」再在新面板导入。
|
|
139
|
+
|
|
140
|
+
## 7. 风险与对策
|
|
141
|
+
|
|
142
|
+
| 风险 | 影响 | 对策 |
|
|
143
|
+
|---|---|---|
|
|
144
|
+
| 账号 token 覆盖的端点比预期窄 | 文件或语音不可用 | P0 逐端点实测;不可用的能力在 v1 直接不暴露 |
|
|
145
|
+
| 上游 chat-demo 迭代导致 patch 失效 | 升级成本上升 | pin commit;patch 只碰 `apiOrigin`、key gate、品牌位三处 |
|
|
146
|
+
| Web 模式端口变化导致 IndexedDB 历史「消失」 | 用户以为丢数据 | 文档写明;建议固定端口;提供导出/导入(上游自带 ZIP) |
|
|
147
|
+
| dist 4.25 MB 进仓库 | 仓库与 npm 包体积 | 可接受;`.gitignore` 不排除 `dist`,与「产物提交」约定一致 |
|
|
148
|
+
| 计费口径误解(用户以为和官网额度共担) | 客诉 | 面板内一行说明:走 API 计费 |
|
|
149
|
+
| iframe 内的麦克风/剪贴板被桌面壳拒绝 | 语音输入不可用 | 主框架授权桥 + `allow` 属性;降级为不可用而非报错 |
|
|
150
|
+
|
|
151
|
+
## 8. 工作量与收益
|
|
152
|
+
|
|
153
|
+
| 项 | 现状 | v2 之后 |
|
|
154
|
+
|---|---|---|
|
|
155
|
+
| Client 代码 | 915 行(webview 租约、站点 localStorage 改写、恢复上次会话) | ≈150 行(面板 + iframe) |
|
|
156
|
+
| 桌面端依赖 | 强(无租约则只有说明卡) | 无 |
|
|
157
|
+
| Web 端 | 不可用 | 可用 |
|
|
158
|
+
| 登录 | 每次重启重登 | 用 DSH 账号,无需再登 |
|
|
159
|
+
| 环境异常提示 | 需要替用户勾「不再提示」 | 不存在 |
|
|
160
|
+
|
|
161
|
+
合计约 3–4.5 个工作日,其中 P0 是关键止损点。
|
|
162
|
+
|
|
163
|
+
## 9. 待确认问题
|
|
164
|
+
|
|
165
|
+
1. 是否同意「自研 v2 替换」而不是直接收录 `chat-in-dsh`?
|
|
166
|
+
2. 新面板的历史与 DSH 会话保持完全独立,可以接受吗?
|
|
167
|
+
3. 入口是否继续沿用左侧面板列表的「网页对话」(贴着「新会话」),还是改成主内容区的独立页签?
|
|
168
|
+
|
|
169
|
+
## 10. 实现记录与踩到的坑
|
|
170
|
+
|
|
171
|
+
### 10.1 落地形态
|
|
172
|
+
|
|
173
|
+
- 宿主:`index.js` 只注册 `/webchat` prefix 路由,细节拆到 `src/route.js`(静态 / 设置 / 自检 / 准入)、
|
|
174
|
+
`src/proxy.js`(转发)、`src/auth.js`(凭据)、`src/settings.js`(保留策略)、
|
|
175
|
+
`src/maintenance.js`(入口页注入)。
|
|
176
|
+
- 客户端:`client.js` 从 915 行降到约 300 行,只做整页面板 iframe、侧栏入口、设置页档位。
|
|
177
|
+
- 上游改动只有两处:`rspack.config.ts` 的 `apiOrigin` 改为可注入(`CHAT_DEMO_API_ORIGIN`),
|
|
178
|
+
`src/i18n/{zh,en}.ts` 的 `appName` 改成 `DeepSeek Chat`。其余一行未动。
|
|
179
|
+
|
|
180
|
+
### 10.2 会话保留策略(新增需求)
|
|
181
|
+
|
|
182
|
+
- 存储:`$DSH_HOME/vt-web-chat/settings.json`,字段 `retentionDays`,取值 `30 | 60 | 90 | 0`(0 = 永不)。
|
|
183
|
+
- UI:`settings.section` 槽位里四个档位按钮,点一下即保存。
|
|
184
|
+
- 执行位置:**前端启动之前**。入口页产物只有一个 defer 入口脚本,
|
|
185
|
+
服务端把 `<script src=...>` 摘下来,等清理完再挂回,
|
|
186
|
+
否则用户会先看到即将被删的会话,再在列表里凭空消失。
|
|
187
|
+
- 判定字段:`sessionSummaries.updatedAt`(缺失时退回 `createdAt`),早于 `now - days` 即删除;
|
|
188
|
+
同时删 `sessions` / `sessionSummaries`,附件只删「不再被任何存活会话引用」的。
|
|
189
|
+
- 事务安全:所有判断在事务外算好,事务里只发同步请求,避免 IndexedDB 事务因 await 失活。
|
|
190
|
+
- 兜底:清理最多等 3 秒,超时就不清理直接进界面,不能因为存储异常白屏。
|
|
191
|
+
- 可观测:结果写在 `window.__vtWebChatRetention` 上(`{ removed }` 或 `{ removed: -2, error }`)。
|
|
192
|
+
|
|
193
|
+
### 10.3 踩过的坑
|
|
194
|
+
|
|
195
|
+
| 坑 | 现象 | 处理 |
|
|
196
|
+
|---|---|---|
|
|
197
|
+
| 上游返回 gzip,只转发 `content-type` | 浏览器把压缩字节当文本解析,SSE 永远解析不出,界面卡在 typing | 请求上游加 `accept-encoding: identity`;同时把 `content-encoding` 一起透传 |
|
|
198
|
+
| `Locale` 合法值是 `zh-CN` / `en-US` | 写 `en` 不生效,界面语言不跟随 | 客户端把宿主语言收敛成这两个值,经 `?lang=` 传入 |
|
|
199
|
+
| 仓库是 pnpm workspace | 在 `plugins/**/build` 里 `pnpm install` 被工作区接管,不生成局部 `node_modules` | 上游构建放到 `os.tmpdir()`,见 `scripts/sync-upstream.mjs` |
|
|
200
|
+
| `git clone --branch <sha>` | 只认分支/标签,传 commit 直接失败 | 空仓库 + `git fetch --depth 1 origin <sha>` + `checkout FETCH_HEAD` |
|
|
201
|
+
| 根 `.gitignore` 里有 `dist/` | 产物会被忽略,发布包里没有前端 | 追加 `!plugins/*/webview/dist/**` 例外(约定 §5 要求产物入库) |
|
|
202
|
+
| 同一 URL 的 `ego_navigate` | 只复用文档、不重新执行,注入脚本的验证结果看起来「没跑」 | 验证注入逻辑时用 `location.reload()` |
|
|
203
|
+
|
|
204
|
+
### 10.4 验证结果
|
|
205
|
+
|
|
206
|
+
- `node --test test/`:12 条通过(注入、重定向、MIME、越界、设置读写、准入、凭据顺序、401、转发目标、SSE 回灌)。
|
|
207
|
+
- 真实 API:`/models` 返回账号目录;`/anthropic/v1/messages` 普通与 `stream: true` 均成功;
|
|
208
|
+
文件上传(multipart 流式)与文件列表成功。
|
|
209
|
+
- 浏览器真机:面板加载官方界面 → 发消息 → 思考/流式 → 回答落库 → 会话自动命名。
|
|
210
|
+
- 保留策略:塞入一条 40 天前的会话,重载后 `__vtWebChatRetention={removed:1}`,
|
|
211
|
+
该会话与其摘要被删,昨天的会话与真实对话保留。
|
|
212
|
+
|
|
213
|
+
## 11. 与 DSH 悬浮岛的避让
|
|
214
|
+
|
|
215
|
+
### 11.1 问题
|
|
216
|
+
|
|
217
|
+
macOS 桌面在侧栏收起时会**隐藏整列**,改在主内容区左上角挂一个 `shell.leading` 座位
|
|
218
|
+
(展开侧栏 + 新对话两个控件),它会盖在主面板上。我们面板里是 iframe,DeepSeek 前端
|
|
219
|
+
自己的侧栏头(应用名 + 收起按钮)和收起态按钮组都在左上角,于是两层控件叠在一起。
|
|
220
|
+
|
|
221
|
+
### 11.2 DSH 提供的约定
|
|
222
|
+
|
|
223
|
+
`dsh-client-ui-layout` 的文档写得很明确:
|
|
224
|
+
|
|
225
|
+
> While the seat is mounted the frame publishes `--dsh-frame-leading-clearance`
|
|
226
|
+
> (the inline inset the seat's band occupies, measured from the frame's left edge);
|
|
227
|
+
> a main panel whose content reaches the top-left corner pads by it so nothing lands
|
|
228
|
+
> under the lights or the controls.
|
|
229
|
+
|
|
230
|
+
配套 CSS 事实:`.frame[data-sidebar-collapsed]{--dsh-frame-leading-clearance:160px}`
|
|
231
|
+
(全屏 84px),座位 `.leadingSeat{position:absolute;top:11px;left:88px}`。
|
|
232
|
+
|
|
233
|
+
### 11.3 采用的方案
|
|
234
|
+
|
|
235
|
+
iframe 读不到宿主的 CSS 变量,所以分两步:
|
|
236
|
+
|
|
237
|
+
1. **父页测量**(`client.js`):找 `[class*="leadingSeat"]`,取其 `getBoundingClientRect().bottom + 8`;
|
|
238
|
+
找不到时退回读容器继承的 `--dsh-frame-leading-clearance`,非零则按 48px 保守让开。
|
|
239
|
+
结果通过 `postMessage({type:'vt-webchat:seat', inset})` 发给面板;
|
|
240
|
+
面板 `onLoad` 与收到 `vt-webchat:hello` 时各补发一次,侧栏开合由 MutationObserver 驱动重算。
|
|
241
|
+
2. **面板内落位**(`src/maintenance.js`):收到后设 `html[data-vtwc-seat]` 与 `--vtwc-seat`,
|
|
242
|
+
注入的样式把 `#root > [class*="frame-"]` 整体下移同高度并缩短高度,
|
|
243
|
+
同时给顶部补底色:侧栏展开时用
|
|
244
|
+
`linear-gradient(to right, sidebar-fill 0 261px, bg-base 261px)`,收起时用 `bg-base`,
|
|
245
|
+
所以不会出现一条白缝或异色条。
|
|
246
|
+
|
|
247
|
+
只用 `#root > [class*="frame-"]` 一条结构选择器,不依赖上游哈希类名;默认收起侧栏用
|
|
248
|
+
`vtwc:sider-default-applied` 标记只强制一次,之后尊重用户的手动开合。
|
|
249
|
+
|
|
250
|
+
### 11.4 验证
|
|
251
|
+
|
|
252
|
+
- 默认收起:清空存储后进入 → `sider-collapsed=true`、无侧栏节点;手动设为 `false` 后再进入 → 保持展开。
|
|
253
|
+
- 避让:发 `inset:56` → `.frame` 的 `top=56`、`height=757`;收起态按钮组落到 y≈68,
|
|
254
|
+
展开态侧栏头落到 y≈62,均在座位(11–51)下方;顶带与两侧底色一致,无缝。
|
|
255
|
+
|
|
256
|
+
## 12. 桌面壳的准入:为什么会出现「请求来源不受信任」
|
|
257
|
+
|
|
258
|
+
### 12.1 现象
|
|
259
|
+
|
|
260
|
+
在真实 DSH 里发消息,回答位置显示 `{"error":"请求来源不受信任"}`;设置页打开是空白。
|
|
261
|
+
|
|
262
|
+
### 12.2 准入失败的真因
|
|
263
|
+
|
|
264
|
+
`ctx.connection.requestRejection(request)` 是两段判断:
|
|
265
|
+
|
|
266
|
+
1. Host/Origin 栅栏(`src/api-request-trust.ts`):Origin 必须与请求 authority 一致,
|
|
267
|
+
`sec-fetch-site: cross-site` 直接拒绝,返回 **403**;
|
|
268
|
+
2. 浏览器会话 Cookie:缺失返回 **401**。
|
|
269
|
+
|
|
270
|
+
桌面端渲染进程加载的是 `dsh-app://` 自定义协议页面(进程参数 `--standard-schemes=dsh-app`),
|
|
271
|
+
而我们把面板 iframe 指向 `http://127.0.0.1:<port>`(`__DSH_TRANSPORT__.streamBaseUrl`),
|
|
272
|
+
对 `dsh-app:` 页面来说这是**跨站**,于是 iframe 里的请求既没有 DSH Cookie,
|
|
273
|
+
又被判定为 cross-site,栅栏直接 403。1.x 时代的 webview 由 Electron 主进程发起,不受这条限制。
|
|
274
|
+
|
|
275
|
+
### 12.3 解法:入口页下发能力令牌
|
|
276
|
+
|
|
277
|
+
- 插件进程启动时生成一个随机 UUID(`CAPABILITY`),随入口页 HTML 注入面板;
|
|
278
|
+
- 注入脚本在应用启动前包一层 `window.fetch`,给所有 `/webchat/` 请求加 `x-vtwc-cap`;
|
|
279
|
+
- 宿主准入顺序改为:**令牌 + 回环地址 + Origin 同源** → 放行;否则再走 DSH 栅栏
|
|
280
|
+
(`undefined` 与 401 放行,403 拒绝)。
|
|
281
|
+
|
|
282
|
+
安全性:令牌不可猜;跨源页面虽然能 `no-cors` 请求到公开的 `/webchat/`,但读不到响应正文,
|
|
283
|
+
拿不到令牌;非回环来源即使带对令牌也不认;入口页因此改成 `no-store`(令牌随进程变化,不能被缓存复用)。
|
|
284
|
+
|
|
285
|
+
### 12.4 设置页空白
|
|
286
|
+
|
|
287
|
+
`settings.section` 的文案字典里放了**函数值**(`(days) => ...`)。语言服务不保证透传函数,
|
|
288
|
+
取回空串后组件里 `t('settings.days')(value)` 抛出 `TypeError`,而 DSH 没有给设置区提供错误边界,
|
|
289
|
+
整页就被卸载成空白。
|
|
290
|
+
|
|
291
|
+
处理:字典改回纯字符串(档位用 `settings.days30/60/90`,当前状态用 `{n}` 占位符替换),
|
|
292
|
+
组件内的取词函数对任何异常都回落内置字典,并给设置区块补一个最小的错误边界——
|
|
293
|
+
再出错也只显示一行提示,不会让整个设置页空白。
|
|
294
|
+
|
|
295
|
+
### 12.5 验证
|
|
296
|
+
|
|
297
|
+
- 单测:栅栏一律 403 的替身下,无令牌 403、带令牌 200、错令牌/非回环 403。
|
|
298
|
+
- 真机等价复现:`VT_WEB_CHAT_REJECT=403 node scripts/dev-server.mjs` 把栅栏设成固定拒绝,
|
|
299
|
+
面板仍能正常发消息并收到回答(回答「收到」,会话自动命名),说明令牌链路覆盖了桌面壳场景。
|
|
300
|
+
|
|
301
|
+
## 13. 设置区选中态的对比度
|
|
302
|
+
|
|
303
|
+
现象:暗色模式下「会话保留」选中的档位是浅色药丸,文字也是浅色,几乎看不见。
|
|
304
|
+
|
|
305
|
+
根因是 token 语义用反了。`design-platform.css` 里:
|
|
306
|
+
|
|
307
|
+
| token | 亮色 | 暗色 |
|
|
308
|
+
|---|---|---|
|
|
309
|
+
| `--dsw-alias-brand-primary` | `bluish-1000`(近黑 #0f1115) | `bluish-50`(近白 #f9fafb) |
|
|
310
|
+
| `--dsw-alias-label-primary-inverted` | `bluish-00`(白) | `bluish-800`(深灰 #353638) |
|
|
311
|
+
|
|
312
|
+
DSH 的 `brand-primary` 是**前景色**而不是固定的蓝色:亮色近黑、暗色近白。
|
|
313
|
+
所以「品牌色做底」时,字必须配 `label-primary-inverted`(DSH 的徽标也是这么配的),
|
|
314
|
+
而不是硬编码 `#fff`——亮色下对,暗色下就变成白字白底。
|
|
315
|
+
|
|
316
|
+
处理:选中态改为 `background: brand-primary` + `color: label-primary-inverted`,
|
|
317
|
+
两处 fallback 只留给没有主题变量的场合。用真实主题 CSS 在本地做了亮/暗两版对照:
|
|
318
|
+
|
|
319
|
+
- 亮色:黑底白字,对比充分;
|
|
320
|
+
- 暗色:近白底深灰字,对比充分。
|
|
321
|
+
|
|
322
|
+
`client.js` 是纯 JS 客户端 bundle,改完刷新窗口即可生效,不必重启宿主。
|
package/index.js
CHANGED
|
@@ -1,13 +1,41 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Host half of dsh-vt-web-chat.
|
|
3
3
|
*
|
|
4
|
-
*
|
|
5
|
-
*
|
|
6
|
-
* package is mounted as an ordinary Loader entry, and a Client bundle is
|
|
7
|
-
* discovered through that entry.
|
|
4
|
+
* 只做两件事:在 `/webchat` 下托管官方 chat-demo 的前端产物,并替浏览器把请求转给
|
|
5
|
+
* DeepSeek——浏览器不持有凭据,用户也不需要再登录一次。
|
|
8
6
|
*
|
|
9
|
-
*
|
|
10
|
-
*
|
|
11
|
-
* model request.
|
|
7
|
+
* 网页版与 DSH 会话互不干涉:前端的会话存在自己的 IndexedDB 里,它不会进 DSH 的会话
|
|
8
|
+
* 列表,DSH 的会话也不会出现在它里面。两边系统提示词与工具不同,混合只会让双方都失真。
|
|
12
9
|
*/
|
|
13
|
-
|
|
10
|
+
import { createHandler, ROUTE_PREFIX } from './src/route.js';
|
|
11
|
+
|
|
12
|
+
/** webServer 是硬依赖;账号与凭证服务在请求时软取,缺失只会退化成 401 提示。 */
|
|
13
|
+
export const inject = ['webServer'];
|
|
14
|
+
|
|
15
|
+
/**
|
|
16
|
+
* 注册插件路由。
|
|
17
|
+
* @param ctx - Host 插件上下文。
|
|
18
|
+
*/
|
|
19
|
+
export function apply(ctx) {
|
|
20
|
+
const handle = createHandler(ctx);
|
|
21
|
+
ctx.effect(
|
|
22
|
+
() =>
|
|
23
|
+
ctx.webServer.register({
|
|
24
|
+
kind: 'prefix',
|
|
25
|
+
path: ROUTE_PREFIX,
|
|
26
|
+
// 处理器是异步的;异常必须在这里收住,否则会变成一个没有响应的请求。
|
|
27
|
+
handler: (req, res) => {
|
|
28
|
+
handle(req, res).catch((error) => {
|
|
29
|
+
console.error('[dsh-vt-web-chat] request failed', error);
|
|
30
|
+
if (!res.headersSent) {
|
|
31
|
+
res.writeHead(500, { 'content-type': 'application/json; charset=utf-8' });
|
|
32
|
+
res.end(JSON.stringify({ error: error instanceof Error ? error.message : String(error) }));
|
|
33
|
+
} else if (!res.writableEnded) {
|
|
34
|
+
res.destroy();
|
|
35
|
+
}
|
|
36
|
+
});
|
|
37
|
+
},
|
|
38
|
+
}),
|
|
39
|
+
'vt-web-chat: /webchat route',
|
|
40
|
+
);
|
|
41
|
+
}
|
package/locale/en.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"meta": {
|
|
3
3
|
"title": "Web Chat",
|
|
4
|
-
"description": "Adds a
|
|
4
|
+
"description": "Adds a Web Chat panel under New Session that runs DeepSeek's official open-source chat UI, proxied through your signed-in DSH account, with a configurable chat-retention policy."
|
|
5
5
|
}
|
|
6
6
|
}
|
package/locale/zh.json
CHANGED
package/package.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-vt-web-chat",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "2.0.0",
|
|
4
4
|
"type": "module",
|
|
5
|
-
"description": "Adds a Web Chat
|
|
5
|
+
"description": "Adds a Web Chat panel that runs DeepSeek's official open-source chat UI inside DeepSeek Harness, with requests proxied through your signed-in account and a configurable local chat-retention policy.",
|
|
6
6
|
"license": "MIT",
|
|
7
7
|
"author": "Vontean",
|
|
8
8
|
"homepage": "https://github.com/Vontean/vt-dsh-plugin/tree/main/plugins/vt-web-chat#readme",
|
|
@@ -18,9 +18,9 @@
|
|
|
18
18
|
"dsh-plugin",
|
|
19
19
|
"deepseek-harness",
|
|
20
20
|
"web-chat",
|
|
21
|
-
"chat",
|
|
22
|
-
"
|
|
23
|
-
"
|
|
21
|
+
"chat-demo",
|
|
22
|
+
"deepseek",
|
|
23
|
+
"retention"
|
|
24
24
|
],
|
|
25
25
|
"engines": {
|
|
26
26
|
"dsh": ">=0.2.1-rc.5 <0.3.0"
|
|
@@ -34,11 +34,20 @@
|
|
|
34
34
|
"files": [
|
|
35
35
|
"index.js",
|
|
36
36
|
"client.js",
|
|
37
|
+
"src/",
|
|
38
|
+
"scripts/",
|
|
39
|
+
"webview/dist/",
|
|
40
|
+
"webview/UPSTREAM.json",
|
|
37
41
|
"cordis.patch.yml",
|
|
38
42
|
"locale/*.json",
|
|
39
43
|
"icon.svg",
|
|
40
|
-
"README.md"
|
|
44
|
+
"README.md",
|
|
45
|
+
"docs/"
|
|
41
46
|
],
|
|
47
|
+
"scripts": {
|
|
48
|
+
"sync-upstream": "node scripts/sync-upstream.mjs",
|
|
49
|
+
"dev": "node scripts/dev-server.mjs"
|
|
50
|
+
},
|
|
42
51
|
"dsh": {
|
|
43
52
|
"bundle": {
|
|
44
53
|
"patch": "./cordis.patch.yml"
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* 开发用本地服务器:把插件的 `/webchat` 路由单独跑起来,用来验证
|
|
4
|
+
* 「静态产物 + 上游代理 + 保留策略」这条链路,不必重启 DSH。
|
|
5
|
+
*
|
|
6
|
+
* 它不模拟 DSH 的准入校验(没有 Connection 服务时自动放行),
|
|
7
|
+
* 所以只在开发机上用,不要对外暴露。
|
|
8
|
+
*
|
|
9
|
+
* 用法:
|
|
10
|
+
* DEEPSEEK_API_KEY=sk-... node scripts/dev-server.mjs [端口]
|
|
11
|
+
* 也可用 VT_WEB_CHAT_SETTINGS 指向一个临时设置文件。
|
|
12
|
+
*/
|
|
13
|
+
import http from 'node:http';
|
|
14
|
+
import { createHandler } from '../src/route.js';
|
|
15
|
+
|
|
16
|
+
const port = Number(process.argv[2] ?? 8799);
|
|
17
|
+
|
|
18
|
+
const apiKey = process.env.DEEPSEEK_API_KEY ?? '';
|
|
19
|
+
// VT_WEB_CHAT_REJECT=403 时,模拟桌面壳里被 Host/Origin 栅栏拒绝的场景。
|
|
20
|
+
const rejectStatus = Number(process.env.VT_WEB_CHAT_REJECT ?? 0);
|
|
21
|
+
const ctx = {
|
|
22
|
+
get(name) {
|
|
23
|
+
if (name === 'credentials') {
|
|
24
|
+
return {
|
|
25
|
+
async resolve() {
|
|
26
|
+
return apiKey.length > 0 ? { value: apiKey } : undefined;
|
|
27
|
+
},
|
|
28
|
+
};
|
|
29
|
+
}
|
|
30
|
+
if (name === 'connection' && rejectStatus > 0) {
|
|
31
|
+
return { requestRejection: () => rejectStatus };
|
|
32
|
+
}
|
|
33
|
+
return undefined;
|
|
34
|
+
},
|
|
35
|
+
};
|
|
36
|
+
|
|
37
|
+
const handle = createHandler(ctx);
|
|
38
|
+
const server = http.createServer((req, res) => {
|
|
39
|
+
handle(req, res).catch((error) => {
|
|
40
|
+
console.error('[dev] request failed', error);
|
|
41
|
+
if (!res.headersSent) {
|
|
42
|
+
res.writeHead(500, { 'content-type': 'application/json; charset=utf-8' });
|
|
43
|
+
res.end(JSON.stringify({ error: String(error?.message ?? error) }));
|
|
44
|
+
} else if (!res.writableEnded) {
|
|
45
|
+
res.destroy();
|
|
46
|
+
}
|
|
47
|
+
});
|
|
48
|
+
});
|
|
49
|
+
|
|
50
|
+
server.listen(port, '127.0.0.1', () => {
|
|
51
|
+
console.log(`web chat dev server: http://127.0.0.1:${port}/webchat/`);
|
|
52
|
+
console.log(`credential: ${apiKey.length > 0 ? 'DEEPSEEK_API_KEY' : 'none (proxy will answer 401)'}`);
|
|
53
|
+
console.log(`self-test: http://127.0.0.1:${port}/webchat/api/self-test`);
|
|
54
|
+
});
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* 把官方 chat-demo 构建成插件内的静态产物 `webview/dist/`。
|
|
4
|
+
*
|
|
5
|
+
* 为什么在临时目录里构建:本仓库是 pnpm workspace,外来项目一旦落在 workspace 内,
|
|
6
|
+
* `pnpm install` 会被工作区接管、不生成局部 node_modules。放到系统临时目录里就没有这层干扰。
|
|
7
|
+
*
|
|
8
|
+
* 上游改动只有一行:`rspack.config.ts` 的默认导出改成读 `CHAT_DEMO_API_ORIGIN`,
|
|
9
|
+
* 好让前端把请求打到插件自己的 `/webchat` 路由,而不是直连 api.deepseek.com。
|
|
10
|
+
*
|
|
11
|
+
* 用法:
|
|
12
|
+
* node scripts/sync-upstream.mjs # 按 PIN 构建
|
|
13
|
+
* node scripts/sync-upstream.mjs --ref main # 跟到某个分支/tag(仅用于评估升级)
|
|
14
|
+
*/
|
|
15
|
+
import { execFileSync } from 'node:child_process';
|
|
16
|
+
import fs from 'node:fs';
|
|
17
|
+
import os from 'node:os';
|
|
18
|
+
import path from 'node:path';
|
|
19
|
+
import { fileURLToPath } from 'node:url';
|
|
20
|
+
|
|
21
|
+
/** 上游固定版本;升级时改这里并重新构建。 */
|
|
22
|
+
const PIN = '8ad7b56e196b87d8a3215dc09476d6d146ad3f0e';
|
|
23
|
+
const REPO = 'https://github.com/deepseek-ai/chat-demo.git';
|
|
24
|
+
/** 前端认的接口前缀,必须与宿主路由一致。 */
|
|
25
|
+
const API_PREFIX = '/webchat';
|
|
26
|
+
|
|
27
|
+
const here = path.dirname(fileURLToPath(import.meta.url));
|
|
28
|
+
const pluginDir = path.resolve(here, '..');
|
|
29
|
+
const distTarget = path.join(pluginDir, 'webview', 'dist');
|
|
30
|
+
const work = path.join(os.tmpdir(), 'vt-web-chat-chat-demo');
|
|
31
|
+
|
|
32
|
+
const ref = (() => {
|
|
33
|
+
const index = process.argv.indexOf('--ref');
|
|
34
|
+
return index === -1 ? PIN : process.argv[index + 1];
|
|
35
|
+
})();
|
|
36
|
+
|
|
37
|
+
const run = (command, args, cwd, env = {}) => {
|
|
38
|
+
process.stderr.write(`$ ${command} ${args.join(' ')}\n`);
|
|
39
|
+
execFileSync(command, args, { cwd, stdio: 'inherit', env: { ...process.env, ...env } });
|
|
40
|
+
};
|
|
41
|
+
|
|
42
|
+
// 1. 取上游。`git clone --branch` 只认分支和标签,所以按 ref 浅拉取一个 commit:
|
|
43
|
+
// 空仓库 + 显式 fetch,既支持 SHA 也支持分支名。
|
|
44
|
+
if (!fs.existsSync(path.join(work, '.git'))) {
|
|
45
|
+
fs.rmSync(work, { recursive: true, force: true });
|
|
46
|
+
fs.mkdirSync(work, { recursive: true });
|
|
47
|
+
run('git', ['init', '--quiet'], work);
|
|
48
|
+
run('git', ['remote', 'add', 'origin', REPO], work);
|
|
49
|
+
}
|
|
50
|
+
run('git', ['fetch', '--depth', '1', 'origin', ref], work);
|
|
51
|
+
run('git', ['checkout', '--force', '--detach', 'FETCH_HEAD'], work);
|
|
52
|
+
|
|
53
|
+
// 2. 只改一处:把 apiOrigin 变成可注入的构建参数。
|
|
54
|
+
const configPath = path.join(work, 'rspack.config.ts');
|
|
55
|
+
const config = fs.readFileSync(configPath, 'utf8');
|
|
56
|
+
const anchor = 'export default defineConfig(createConfig())';
|
|
57
|
+
const patched = 'export default defineConfig(createConfig({ apiOrigin: process.env.CHAT_DEMO_API_ORIGIN }))';
|
|
58
|
+
if (config.includes(anchor)) {
|
|
59
|
+
fs.writeFileSync(configPath, config.replace(anchor, patched));
|
|
60
|
+
process.stderr.write('patched rspack config: apiOrigin from env\n');
|
|
61
|
+
} else if (!config.includes('CHAT_DEMO_API_ORIGIN')) {
|
|
62
|
+
throw new Error('rspack.config.ts 的默认导出行找不到,请检查上游是否改了构建配置');
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
// 2b. 品牌位:上游把应用名写成「API 使用 demo」,在面板里读起来像一份样例。
|
|
66
|
+
// 只替换 i18n 里的两个 appName 值,锚点找不到就显式失败,避免静默沿用旧名。
|
|
67
|
+
const brandPatches = [
|
|
68
|
+
['src/i18n/zh.ts', "appName: 'API 使用 demo'", "appName: 'DeepSeek Chat'"],
|
|
69
|
+
['src/i18n/en.ts', "appName: 'API usage demo'", "appName: 'DeepSeek Chat'"],
|
|
70
|
+
];
|
|
71
|
+
for (const [file, from, to] of brandPatches) {
|
|
72
|
+
const target = path.join(work, file);
|
|
73
|
+
const text = fs.readFileSync(target, 'utf8');
|
|
74
|
+
if (text.includes(from)) {
|
|
75
|
+
fs.writeFileSync(target, text.replace(from, to));
|
|
76
|
+
process.stderr.write(`patched ${file}: appName\n`);
|
|
77
|
+
} else if (!text.includes(to)) {
|
|
78
|
+
throw new Error(`${file} 的 appName 锚点变了,请检查上游 i18n 结构`);
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
// 3. 安装与构建。
|
|
83
|
+
run('pnpm', ['install', '--ignore-scripts'], work);
|
|
84
|
+
run('pnpm', ['build'], work, { CHAT_DEMO_API_ORIGIN: API_PREFIX, NODE_ENV: 'production' });
|
|
85
|
+
|
|
86
|
+
// 4. 产物替换:整目录替换,避免旧 chunk 残留。
|
|
87
|
+
const built = path.join(work, 'dist');
|
|
88
|
+
if (!fs.existsSync(path.join(built, 'index.html'))) {
|
|
89
|
+
throw new Error('构建完成但没有 dist/index.html');
|
|
90
|
+
}
|
|
91
|
+
fs.rmSync(distTarget, { recursive: true, force: true });
|
|
92
|
+
fs.mkdirSync(path.dirname(distTarget), { recursive: true });
|
|
93
|
+
fs.cpSync(built, distTarget, { recursive: true });
|
|
94
|
+
|
|
95
|
+
// 5. 记录来源,方便日后核对产物出自哪次构建。
|
|
96
|
+
fs.writeFileSync(
|
|
97
|
+
path.join(pluginDir, 'webview', 'UPSTREAM.json'),
|
|
98
|
+
`${JSON.stringify({ repo: REPO, ref, apiOrigin: API_PREFIX, builtAt: new Date().toISOString() }, null, 2)}\n`,
|
|
99
|
+
);
|
|
100
|
+
|
|
101
|
+
const bytes = fs
|
|
102
|
+
.readdirSync(distTarget, { recursive: true })
|
|
103
|
+
.map((entry) => path.join(distTarget, entry))
|
|
104
|
+
.filter((file) => fs.statSync(file).isFile())
|
|
105
|
+
.reduce((total, file) => total + fs.statSync(file).size, 0);
|
|
106
|
+
process.stderr.write(`dist ready: ${(bytes / 1024 / 1024).toFixed(1)} MB\n`);
|