@restregular/dsh-memory 0.1.2 → 0.3.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 +36 -3
- package/lib/provider/apply.js +20 -0
- package/lib/provider/embed-install.js +1002 -0
- package/lib/provider/index.js +300 -7
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -45,9 +45,25 @@ patch 里给 `dsh-memory-local` 传配置即可(默认值通常够用):
|
|
|
45
45
|
secrets: { enabled: true, mode: refuse } # 拒绝写入疑似凭据
|
|
46
46
|
```
|
|
47
47
|
|
|
48
|
-
###
|
|
48
|
+
### 向量检索(可选,默认不启用)
|
|
49
49
|
|
|
50
|
-
|
|
50
|
+
**不配任何东西也能用**:检索自动降级为纯词法匹配(IDF + CJK bigram),保存/搜索/注入全部正常。向量检索是**按配置启用**的——写了 `endpoint`、配了 `spawn`、或面板里装了本地后端,才会去碰网络;否则一个请求都不发(不会白试、不会刷错误日志)。
|
|
51
|
+
|
|
52
|
+
三条启用路径,任选一条:
|
|
53
|
+
|
|
54
|
+
**① 面板一键装(推荐给不想折腾的人)**:设置页「记忆」→「向量服务」卡片 → 点 **下载并配置**。插件会下载 llama.cpp CPU 版运行时 + bge-m3 量化模型(约 440MB)到 `retrieval.vector.autoInstall.dir`(默认:显式配了 `storeDir` 时用它上一级目录,否则 `~/.dsh/memory-vector`),解压后就地托管启动,下次开机自动拉起、退出自动关闭。
|
|
55
|
+
|
|
56
|
+
**② 云端 / 自建 OpenAI 兼容服务**(不用下模型):
|
|
57
|
+
|
|
58
|
+
```yaml
|
|
59
|
+
vector:
|
|
60
|
+
enabled: true
|
|
61
|
+
endpoint: 'https://api.example.com/v1/embeddings'
|
|
62
|
+
model: 'bge-m3' # 服务端要求的模型名
|
|
63
|
+
dims: 1024 # 必须与服务端输出维度一致
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
**③ 自己管进程(手填路径)**:
|
|
51
67
|
|
|
52
68
|
```yaml
|
|
53
69
|
vector:
|
|
@@ -60,7 +76,24 @@ patch 里给 `dsh-memory-local` 传配置即可(默认值通常够用):
|
|
|
60
76
|
threads: 6
|
|
61
77
|
```
|
|
62
78
|
|
|
63
|
-
|
|
79
|
+
- 路径 ①③ 都由插件托管进程:应用启动后台拉起、应用退出自动关闭;已在跑的实例(有 PID 文件)会被接管,没有 PID 文件的外部实例不接管。路径 ② 只调用、不启停(面板会标成「外部服务」)。
|
|
80
|
+
- 若 `autoInstall.dir`(或 `storeDir` 上一级)里已经存在 `llamacpp/` + `models/`,插件会**直接采用**,面板只显示状态,不需要重新下载。
|
|
81
|
+
- 面板的开关只在"进程确实由本应用托管"时出现;未配置给下载按钮,外部服务只显示连通性,配置里关掉了就只解释原因——不会出现一个永远灰着的开关。
|
|
82
|
+
|
|
83
|
+
### 维护与卸载
|
|
84
|
+
|
|
85
|
+
面板底部有一个「维护」区,不可撤销的操作都走**两步确认**(第一次点击只是把按钮换成"确认…"):
|
|
86
|
+
|
|
87
|
+
| 动作 | 做什么 | 安全边界 |
|
|
88
|
+
| --- | --- | --- |
|
|
89
|
+
| **卸载向量服务** | 删掉插件下载的 llama.cpp 运行时 + 模型 + 日志(约 480 MB) | 只删 `retrieval.vector.autoInstall.dir`(默认 storeDir 上一级)里的东西;**绝不碰记忆数据目录**;若 `spawn.exe` 指向该根目录之外(也就是你自己装的 llama.cpp),直接拒绝并说明原因 |
|
|
90
|
+
| **清空记忆数据** | 删除所有作用域的全部记录(走 store,JSONL 与 `.vec` 边车保持一致,不会删出半个库) | 两步确认,且接口要求显式 `confirm: "delete"`,缺了不执行 |
|
|
91
|
+
|
|
92
|
+
**卸载插件本身**:在 DSH 的「插件 / 插件市场」里移除本包和 `@restregular/dsh-memory-panel`。
|
|
93
|
+
|
|
94
|
+
> ⚠️ DSH 卸载插件只是在 profile 里 `pnpm remove` 并去掉 bundles 条目:它**不会**给插件任何提问机会,也**不会**自动删除向量服务文件或记忆数据。所以"要不要留向量服务""要不要留记忆数据"这两件事要在卸载**之前**到面板「维护」区处理——插件卸载后那个面板也就没了。
|
|
95
|
+
>
|
|
96
|
+
> 手动清理路径:向量服务在 `retrieval.vector.autoInstall.dir`(默认 `~/.dsh/memory-vector`;显式配了 `storeDir` 时是它的上一级目录),记忆数据在 `storeDir`。
|
|
64
97
|
|
|
65
98
|
## 说明
|
|
66
99
|
|
package/lib/provider/apply.js
CHANGED
|
@@ -82,6 +82,26 @@ export class CordisMemoryService extends Service {
|
|
|
82
82
|
return this.impl.stopEmbedServerManually()
|
|
83
83
|
}
|
|
84
84
|
|
|
85
|
+
/** Panel: download llama.cpp + the GGML model, then adopt and start them. */
|
|
86
|
+
installVectorBackend() {
|
|
87
|
+
this.impl.installVectorBackend()
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
/** Panel: abort an in-flight download. */
|
|
91
|
+
cancelVectorInstall() {
|
|
92
|
+
this.impl.cancelVectorInstall()
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
/** Panel: remove the runtime + model we installed (never the memory store). */
|
|
96
|
+
uninstallVectorBackend() {
|
|
97
|
+
return this.impl.uninstallVectorBackend()
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
/** Panel: delete every record in every scope. */
|
|
101
|
+
wipeAllRecords() {
|
|
102
|
+
return this.impl.wipeAllRecords()
|
|
103
|
+
}
|
|
104
|
+
|
|
85
105
|
search(query ) {
|
|
86
106
|
return this.impl.search(query)
|
|
87
107
|
}
|