docs(claude): restructure documentation management and add feedback system

- Restructure §8 from "文档沉淀规则" to "文档管理规则" with 4 subsections
  - Add docs/ structure with features/ and knowledge-base/ directories
  - Add feature documentation template with 7 sections (概述/设计初衷/技术设计/预期作用/实际效果/演化路线/头脑风暴)
  - Add feature update trigger matrix (新增/修改/完成/问题/反馈)
  - Add documentation quality checklist
- Add §16
This commit is contained in:
iven
2026-03-16 13:54:03 +08:00
parent 8e630882c7
commit adfd7024df
44 changed files with 10491 additions and 248 deletions

View File

@@ -86,10 +86,11 @@ c8202d0 feat(viking): add local server management for privacy-first deployment
- [x] 火山引擎 API 密钥配置
- [x] OpenViking 服务器启动验证
- [x] 基础 API 测试(健康检查、会话创建、消息添加)
- [x] **火山引擎 Embedding 模型激活** (`ep-20260316102010-cq422`)
- [x] **向量搜索功能验证**
### 进行中
- [ ] 火山引擎 Embedding 模型激活
- [ ] 多 Agent 协作 UI 产品化
### 待办
@@ -110,48 +111,30 @@ c8202d0 feat(viking): add local server management for privacy-first deployment
| 消息添加 | ✅ | `POST /api/v1/sessions/{id}/messages` |
| 向量搜索 | ⚠️ | 需要激活 Embedding 模型 |
### 解决:火山引擎 Embedding 模型激活
### ✅ 已解决:火山引擎 Embedding 模型激活
**错误信息**
```
The model or endpoint doubao-embedding does not exist or you do not have access to it.
**Endpoint ID**: `ep-20260316102010-cq422`
**配置文件** (`~/.openviking/ov.conf`)
```json
{
"embedding": {
"dense": {
"api_base": "https://ark.cn-beijing.volces.com/api/v3",
"api_key": "3739b6b2-2bff-4a13-9f82-c0674dd4a05e",
"provider": "volcengine",
"model": "ep-20260316102010-cq422",
"dimension": 1024
}
}
}
```
**解决方案**
1. **登录火山引擎控制台**
https://console.volcengine.com/ark
2. **激活 Embedding 模型**
- 进入「模型推理」→「模型服务」
- 搜索并激活以下任一模型:
- `Doubao-Embedding` (推荐)
- `Doubao-Embedding-Large`
3. **获取 Endpoint ID**
- 激活后,复制模型的 Endpoint ID
- 格式类似:`ep-xxxxxxxxxxxx`
4. **更新配置文件** (`~/.openviking/ov.conf`)
```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
}
}
}
```
5. **重启服务器**
```bash
taskkill //F //IM openviking-server.exe
cd ~/.openviking && openviking-server
```
**验证结果**
- 向量搜索 API: ✅ 正常
- 会话创建: ✅ 正常
- 消息添加: ✅ 正常
- TypeScript 测试: ✅ 21 passed
### 备选方案:使用 OpenAI Embedding