docs: finalize documentation cleanup

- Update OPENVIKING_INTEGRATION with latest status
- Remove outdated plan files (now archived in docs/archive/)
- Clean up redundant documentation

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
iven
2026-03-16 10:00:01 +08:00
parent a7582cb135
commit 721e400bd0
11 changed files with 78 additions and 4528 deletions

View File

@@ -429,6 +429,84 @@ cd desktop
pnpm vitest run tests/desktop/memory*.test.ts
```
## 火山引擎 (Volcengine) 配置
### 激活 Embedding 模型
**重要**:火山引擎的 Embedding 模型需要在控制台单独激活。
1. **登录火山引擎控制台**
https://console.volcengine.com/ark
2. **激活 Embedding 模型**
- 进入「模型推理」→「模型服务」
- 搜索并激活以下模型之一:
- `Doubao-Embedding` (推荐1024 维)
- `Doubao-Embedding-Large` (2048 维)
3. **获取 Endpoint ID**
- 激活后,复制模型的 **Endpoint ID**
- 格式类似:`ep-xxxxxxxxxxxx`
4. **更新配置文件**
使用 Endpoint ID推荐
```json
{
"embedding": {
"dense": {
"api_base": "https://ark.cn-beijing.volces.com/api/v3",
"api_key": "your-api-key",
"provider": "volcengine",
"model": "ep-xxxxxxxxxxxx",
"dimension": 1024
}
}
}
```
或使用模型名称(需要在控制台激活):
```json
{
"embedding": {
"dense": {
"api_base": "https://ark.cn-beijing.volces.com/api/v3",
"api_key": "your-api-key",
"provider": "volcengine",
"model": "doubao-embedding",
"dimension": 1024
}
}
}
```
### 常见错误
| 错误 | 原因 | 解决方案 |
|------|------|----------|
| `ModelNotOpen` | 模型未激活 | 在控制台激活对应的 Embedding 模型 |
| `InvalidEndpointOrModel.NotFound` | Endpoint ID 不存在 | 检查 Endpoint ID 是否正确 |
| `404 Not Found` | API 路径错误 | 确认 `api_base` 为 `https://ark.cn-beijing.volces.com/api/v3` |
### 测试 Embedding 配置
```bash
# 启动服务器后,测试向量搜索
curl -X POST http://127.0.0.1:1933/api/v1/search/search \
-H "Content-Type: application/json" \
-d '{"query": "test query", "limit": 5}'
```
成功响应:
```json
{"status":"ok","result":[],"error":null}
```
失败响应(需要激活模型):
```json
{"status":"error","error":{"message":"Volcengine embedding failed: ModelNotOpen..."}}
```
## 故障排除
### Q: OpenViking CLI not found