wizardchen
7ebb29cd3e
docs: add Chinese RBAC guide and link with shared space docs
...
Replace the English docs/rbac.md with a comprehensive Chinese
docs/RBAC说明.md and a wiki-style summary under docs/wiki/安全认证/.
Explain how tenant RBAC relates to the shared space feature (they
are orthogonal: tenant RBAC is the vertical defense, shared space
is the horizontal collaboration channel) and cross-link the two
docs in both the flat and wiki trees. Update inbound references in
.env.example, docker-compose.yml, and the auth legacy env test to
point at the new file name.
2026-05-21 12:28:31 +08:00
nullkey
c8b2129853
docs(api): restore auth.md and update README/wiki links
...
Fixes #958 .
- 新建 docs/api/auth.md：覆盖 10 个 /auth/* 端点
register / login / oidc 三件套（config/url/callback）/ refresh /
validate / logout / me / change-password。
说明各端点的鉴权方式（无 / refresh_token / Bearer JWT），并对齐
/auth/oidc/callback 的真实行为（始终 302 跳到 / 并把结果编码进
URL hash）。
- docs/api/README.md：
- 增加"最权威参考：Swagger UI"段落，引导读者优先访问
/swagger/index.html（swagger 由 swag 注解自动从代码生成）。
- "认证管理"行链接由仅指向 OIDC 流程文档改为同时指向 auth.md
与 OIDC 流程文档。
- 新增 "IM 渠道" 行指向 docs/IM集成开发文档.md。
- 新增 "数据源导入" 行指向 docs/数据源导入开发文档.md。
- docs/wiki/API参考/API文档概览.md：随 api/README.md 的"认证管理"
行同步更新即可——IM 与数据源在该文件原有的"相关主题"/"反向链接"
小节已经登记，不在 "API 分类" 表中重复。
2026-05-12 13:16:58 +08:00
langcaiye
02be05c095
feat: support Tencent VectorDB keyword retrieval
2026-05-10 00:02:05 +08:00
langcaiye
74b1342440
feat: add Tencent VectorDB retriever backend
2026-05-09 13:14:01 +08:00
wizardchen
fc6f160eff
fix(retriever/doris): code review cleanup
...
针对 4cce6f2e（接入 Apache Doris）的 code review 修复，主要修正若干阻断性
问题与可读性问题，并剔除不应进入主仓的本地工作流文件。
阻断性修复：
- docker-compose: Doris 镜像由 2.1.0 升至 4.1.0。原 2.1.0 不支持 HNSW
ANN、cosine_distance_approximate 与 Stream Load partial_columns，
按当前 DDL 一启动就会失败。
- DSN 字面量拼接改用 mysql.Config.FormatDSN()。原 fmt.Sprintf 在用户名/
密码包含 `@`/`:`/`/` 等字符时会跑偏。覆盖 health check 与 engine
factory 两处。
健壮性修复：
- 新增 validateEmbedding，写入与查询前拒绝 NaN/±Inf；strconv.FormatFloat
对非有限值会输出 "NaN"/"+Inf" 拼成无效 SQL。
- waitANNReady 改为后台 goroutine + 独立 context，避免新维度首次写入路径
阻塞最长 30s；ANN 未就绪时 Doris 会自动退化为 brute-force。
清理：
- annIndexReady 移除最终两个分支都 return true 的冗余写法。
- Save 移除冗余的双重 toDorisVectorEmbedding。
- testDorisConnection 把 "5.7.99 Doris-4.1.0" 解析为裸 "4.1.0"，与
Postgres/ES 的版本格式对齐。
剔除（不应合入主仓）：
- docs/wiki/集成扩展/Doris改动与上游同步.md：纯 fork 维护工作流文档。
- scripts/e2e-doris.sh：作者本地 E2E 验证清单。
测试：
- repository_test 用 require.Eventually 适配 ANN 异步轮询。
- 现有 doris 单测全部通过。
2026-05-09 00:31:03 +08:00
issunion
4cce6f2e99
feat(retriever): 接入 Apache Doris 4.1 作为向量数据库
...
为 RetrieveEngine 体系新增 Doris 后端，与现有 Qdrant/Milvus/Weaviate
等保持完整能力对齐：向量检索、关键词检索、健康检查、环境变量与多实例
DB 配置、前端类型注册、单元测试、Docker Compose 模板。
实现要点：
- 协议分工：主链路用 MySQL 协议（database/sql + go-sql-driver/mysql）
做 DDL / 查询 / 删除；批量更新走 Stream Load HTTP API，并启用
partial_update=true、merge_type=APPEND，自动按 1MiB 切分批次并处理
307 重定向。
- 表结构：UNIQUE KEY(id) + enable_unique_key_merge_on_write=true 以
支持 upsert/部分列更新；按维度分表（<base>_<dim>），每张表上建
HNSW ANN 索引（metric_type=cosine_distance）和 INVERTED 索引
（parser=chinese）。
- 分数语义：使用 cosine_distance_approximate，再以 1 - dist 转换为
"越大越相似"，与现有 KVHybridRetrieveEngine 约定一致。
- 异步索引：ANN 索引为后台构建，ensureTable 通过轮询 SHOW INDEX 等
待索引就绪后再放行写入，避免首次检索召回为空。
- ARRAY<FLOAT> 序列化：go-sql-driver/mysql 不支持数组占位符，
embeddingLiteral 将 []float32 转成 SQL 字面量字符串再拼接。
新增文件：
- internal/application/repository/retriever/doris/{structs,schema,
query,repository,streamload,repository_test}.go
- scripts/e2e-doris.sh：E2E 验证清单
- docs/wiki/集成扩展/Doris改动与上游同步.md：fork-and-rebase 工作流
与改动清单
修改文件（接线 + 文档）：
- internal/types/{retriever,tenant,vectorstore}.go：新增
DorisRetrieverEngineType、env 解析、表单 schema 与索引参数校验
- internal/container/{container,engine_factory}.go：环境变量驱动
与 VectorStore 配置驱动两条路径都支持 Doris
- internal/application/service/vectorstore{,_healthcheck}.go：连接
校验 + Ping/Version 健康检查
- docker-compose.yml：新增 doris-fe / doris-be 服务（profile=doris）
- .env.example：DORIS_* 环境变量与示例
- docs/{使用其他向量数据库,wiki/集成扩展/集成向量数据库}.md：
使用说明与索引/分数行为说明
依赖：go.mod/go.sum 新增 github.com/go-sql-driver/mysql（运行时）和
github.com/DATA-DOG/go-sqlmock（测试）。
测试：repository 层 SQL 形状、Stream Load HTTP 行为、whereBuilder
逻辑、embeddingLiteral 往返、健康检查错误路径均有单测覆盖。
2026-05-08 21:59:35 +08:00
aqilaziz
d48638427f
Fix authentication API documentation links
2026-05-08 16:48:07 +08:00
Liwx1014
2beb64c429
docs: add wiki documentation with cross-referenced links
...
- Create structured wiki from docs/ directory
- Add 17 markdown pages organized in 7 categories
- Include standard Markdown relative path links for navigation
- Add Mermaid knowledge graph visualization in Home.md
2026-04-15 20:38:31 +08:00
