@xiaofanzhao/dsh-plugin-knowledge-base 0.2.0 → 0.2.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +17 -3
- package/client.js +2000 -1934
- package/lib/preview.mjs +81 -24
- package/lib/routes.mjs +14 -9
- package/lib/vision.mjs +53 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -163,6 +163,7 @@ git push origin v0.1.0
|
|
|
163
163
|
|
|
164
164
|
- **缩略图栏**:点哪页跳哪页,当前页有描边;工具栏最左边的按钮可以收起它
|
|
165
165
|
- **单页 / 连续**:单页像放映(整页装下、居中、不裁切),连续是滚动阅读
|
|
166
|
+
- **首屏很快**:先渲染前 6 页给看,剩下的在后台继续补,几秒后自动出现(不用等整本渲完)
|
|
166
167
|
- **大屏**:铺满整个窗口,`← →` / `PageUp PageDown` 翻页,`Esc` 或右上角「恢复」回面板
|
|
167
168
|
- **文字版**:「原版式 / 文字」随时切换,文字版用于快速读、也是 AI 检索的来源
|
|
168
169
|
|
|
@@ -177,12 +178,19 @@ git push origin v0.1.0
|
|
|
177
178
|
→ 当正文存起来 → 切块 → 关键词 + 向量 → 可被搜索、可被 AI 读取
|
|
178
179
|
```
|
|
179
180
|
|
|
180
|
-
**怎么开**:知识库页面 → 右上角**齿轮** → 「图片理解(可选)」→ 填 Key(留空则复用向量检索那把)→ 勾选启用 → **测试连接** → 保存 → 点「重建全部索引」给已有图片补描述。
|
|
181
|
+
**怎么开**:知识库页面 → 右上角**齿轮** → 「图片理解(可选)」→ 选**服务商**(自动填好地址和模型,也可以选「自定义」手填)→ 填 Key(留空则复用向量检索那把)→ 勾选启用 → **测试连接** → 保存 → 点「重建全部索引」给已有图片补描述。
|
|
181
182
|
|
|
182
|
-
|
|
183
|
+
内置预设(选完自动填地址 + 模型):
|
|
184
|
+
|
|
185
|
+
| 服务商 | 接口地址 | 视觉模型 |
|
|
183
186
|
|---|---|---|
|
|
184
187
|
| 阿里云百炼 | `https://dashscope.aliyuncs.com/compatible-mode/v1` | `qwen3-vl-plus` |
|
|
188
|
+
| 硅基流动 | `https://api.siliconflow.cn/v1` | `Qwen/Qwen2.5-VL-72B-Instruct` |
|
|
185
189
|
| OpenAI | `https://api.openai.com/v1` | `gpt-4o-mini` |
|
|
190
|
+
| 本机 Ollama | `http://127.0.0.1:11434/v1` | `qwen2.5vl:7b` |
|
|
191
|
+
| 自定义 | 任意 `POST /chat/completions` 的 OpenAI 兼容端点 | 自己填 |
|
|
192
|
+
|
|
193
|
+
> 只要求两点:`POST <baseUrl>/chat/completions` 能收 OpenAI 格式的 `messages`,且支持 `{"type":"image_url","image_url":{"url":"data:image/png;base64,..."}}`。满足就能用,不限于上表。
|
|
186
194
|
|
|
187
195
|
几点说明:
|
|
188
196
|
|
|
@@ -190,6 +198,7 @@ git push origin v0.1.0
|
|
|
190
198
|
- 每张图一次模型调用(图片会发给该服务商,注意这一点)
|
|
191
199
|
- 单次转换失败会在文档状态里留下原因(比如 `图片理解接口报错:HTTP 401`),修好后点「重建」重试
|
|
192
200
|
- 只对 `png / jpg / jpeg / gif / webp / bmp` 生效;扫描件 PDF 仍按「没有文字层」处理(可以把页面截成图再上传)
|
|
201
|
+
- 想确认这台机器配的服务真的能用: est/vision-live.mjs 会**真实请求一次**(默认跳过,需要 KB_TEST_LIVE=1)
|
|
193
202
|
|
|
194
203
|
## AI 工具
|
|
195
204
|
|
|
@@ -305,6 +314,11 @@ $env:ELECTRON_RUN_AS_NODE=1
|
|
|
305
314
|
# 向量检索链路:自带一个假 embeddings 服务,验证写入向量 + hybrid 检索 + 接口挂了降级
|
|
306
315
|
& "<DeepSeek Harness.exe>" test/vector.mjs
|
|
307
316
|
|
|
317
|
+
# 真实视觉联调(可选,会真的调一次接口并产生费用)
|
|
318
|
+
$env:KB_TEST_LIVE = "1"
|
|
319
|
+
& "<DeepSeek Harness.exe>" test/vision-live.mjs [可选:图片路径]
|
|
320
|
+
$env:KB_TEST_LIVE = ""
|
|
321
|
+
|
|
308
322
|
# 密钥扫描:确认仓库里没有 API Key / 私钥 / token(提交前跑一下)
|
|
309
323
|
& "<DeepSeek Harness.exe>" test/no-secrets.mjs
|
|
310
324
|
```
|
|
@@ -322,7 +336,7 @@ $env:KB_TEST_XLSX = "C:\path\to\any.xlsx"
|
|
|
322
336
|
|
|
323
337
|
- 老版 Office(`.doc/.ppt/.xls`)能看原版式,但不抽正文,搜不到里面的字
|
|
324
338
|
- 扫描件 PDF / 纯图片没有文字层,搜不到内容
|
|
325
|
-
- 转换上限:单文件 50 MB
|
|
339
|
+
- 转换上限:单文件 **50 MB**(超过会直接提示「超过 Office 转换上限」,十几毫秒就返回,不会卡在那里转圈);单次渲图 200 页
|
|
326
340
|
- 桌面端不允许插件页面开新窗口,所以「大屏」是应用内全屏,不是独立窗口
|
|
327
341
|
|
|
328
342
|
## License
|