docs(readme): flatten Latest Updates into single-line per-version list

Condense v0.6.0 highlights into one line and remove the collapsible
<details> wrapper so the full release history is visible by default
across all four READMEs (EN/CN/JA/KO).
This commit is contained in:
wizardchen
2026-05-21 17:13:28 +08:00
committed by lyingbug
parent cdfc9ce23a
commit b0094ff479
4 changed files with 48 additions and 661 deletions

177
README.md
View File

@@ -57,155 +57,18 @@ The framework supports auto-syncing knowledge from Feishu, Notion, and Yuque (mo
## ✨ Latest Updates
**v0.6.0 Highlights:**
- **Tenant RBAC (Role-Based Access Control)** — the headline of this release. WeKnora now enforces a 4-tier per-tenant role matrix (`Owner` / `Admin` / `Contributor` / `Viewer`) on every mutating route, with per-KB resource ownership: `chunk → knowledge → kb → creator_id`. Contributors are full owners of resources they create and read-only on other people's resources; Admins manage the whole tenant; Owners can additionally delete the tenant. See [`docs/RBAC说明.md`](./docs/RBAC说明.md).
<table>
<tr>
<td width="50%" align="center"><b>Tenant Member Management</b><br/><img src="./docs/images/rbac-member-management.png" alt="Tenant Member Management" width="100%"></td>
<td width="50%" align="center"><b>Workspace Switcher</b><br/><img src="./docs/images/rbac-workspace-switcher.png" alt="Workspace Switcher" width="100%"></td>
</tr>
<tr>
<td width="50%" align="center"><b>Self-Service Workspace Creation</b><br/><img src="./docs/images/rbac-create-workspace.png" alt="Create Workspace" width="100%"></td>
<td width="50%" align="center"><b>Pending Invitations</b><br/><img src="./docs/images/rbac-pending-invitation.png" alt="Pending Invitations" width="100%"></td>
</tr>
</table>
- **Tenant Member Management & Multi-Workspace UX** — invite / remove members, role updates, `/leave` endpoint, invite-only gate; pending-invitations dialog + global invitation bell; tenant switcher in the user menu with role-aware UI gates; last-active workspace persisted across logins; rich workspace-aware notifications on login / tenant switch.
- **Self-Service Workspaces** — any user can create their own tenant (capped via env knob); cross-tenant superusers see an Admin role chip in the UI when switched.
- **Per-Tenant RBAC Audit Log** — every RBAC-relevant event is recorded with a daily retention sweep (default 90 days, indexed on `created_at`); cross-tenant superuser actions are pinned to the source tenant.
- **`weknora` CLI v0.3 / v0.4 (GA)** — graduates from preview to GA with verb-noun subtrees across every major resource: `agent` (CRUD + invoke / check / status), `chunk`, `session`, `search` (chunks / kb / docs / sessions), `kb` (edit / pin / empty / check / status), `doc` (download / upload --recursive / view / wait), `auth` (refresh / token), `context`, `link` / `unlink`. New `weknora mcp serve` ships a curated stdio MCP server so AI clients (Claude Code, Cursor, …) can drive WeKnora directly. Globals: `--format`, `--json` field-select, `--jq`, `--paginate`, `--all-pages`, `--input`, `--log-level`, `--from-url`, NDJSON output, transparent 401 retry, signal-aware contexts.
- **KB Retrieval Fan-out Across Vector Stores** — a single KB can now bind to multiple vector stores; the retrieval engine fans out queries across all bound stores and merges results. KB editor validates bindings on create / copy / delete to prevent inconsistent state.
- **AES-256-GCM At-Rest for MCP & Data Source Credentials** — graceful key-rotation handling; sensitive fields redacted in API responses; new `/credentials` subresource pattern prevents credential loss on edit.
- **Docreader gRPC Hardening** — docreader connection supports TLS + Token auth; gRPC port no longer published to the host by default; `grpcio` floor bumped to 1.78.0 to match the generated proto.
- **More Backends**: Zhipu AI embedder; Huawei Cloud OBS object storage; configurable vLLM URL for the MinerU doc parser; Apache Doris compatibility modes with mode-switch guards; whitelist that lets docreader skip re-uploading trusted image URLs.
- **User Preferences (Server-Side)** — per-user font / theme / memory-feature toggle persisted on the server; per-user KB pinning replaces the previous tenant-wide pin model; "Shared by me" label and creator name surfaced across knowledge bases and agents.
- **Other Improvements**: User favorites + recents; member quick-nav entry; refreshed sidebar density; inline-editable tenant info with description; knowledge document tag selector redesign; UI build version on the System Info page; Moonshot models pin `temperature=1` for `moonshot-v1-*` / `kimi-k2.5` / `k2.6` (which reject other values with HTTP 400); MinerU markdown image syntax unescape so downstream image extraction works; `ErrSessionNotFound` / `ErrKnowledgeBaseNotFound` map to HTTP 404 across all handlers; session access scoped by user; Go bumped to 1.26.0.
- **Bug Fixes**: `audit_log.Stop()` deadlock when `Start()` is never called; organization searchable join no longer bypasses invite code expiry; chunker no longer merges top-level heading chunks; infinite-scroll race condition causing missing documents fixed; indexed documents complete immediately instead of waiting for an extra sweep; offline + legacy browser support on the frontend; chat history rendering / pagination stability; test-connection falls back to the stored API key when test-connecting an existing model.
<details>
<summary><b>Earlier Releases</b></summary>
**v0.5.2 Highlights:**
- **Wiki Mode at Scale**: Wiki ingest now handles tens-of-thousands-document KBs via a generic task queue with dead-letter handling; the page-link graph gains a subgraph API + interactive exploration UI.
- **MCP Human-in-the-Loop Approval**: Sensitive MCP tool calls pause the agent and wait for explicit user approval in the chat UI.
- **More LLM / Vector DB / Storage / Search**: Anthropic (Claude), Apache Doris 4.1, Tencent VectorDB, Kingsoft Cloud KS3, and SearXNG are all new backends — pairing with the Vector Store management UI and per-KB indexing strategy toggles.
- **Deeper Observability**: Langfuse spans expanded across retrieval / rerank / agent stages; end-to-end TTFB logged on both ends of the chat stream; LLM call timeouts hardened to keep worker pools healthy.
- **Adaptive 3-Tier Chunking**: Documents are auto-routed to heading-aware / heuristic / recursive strategies, with a live preview panel in the KB editor. See [`docs/CHUNKING.md`](./docs/CHUNKING.md).
- **Global Command Palette**: A ⌘K palette replaces the standalone search page and can start a new chat directly from any result.
- **More Connectors & Mobile**: Yuque connector (full + incremental sync) joins Feishu / Notion; lightweight WeChat Mini Program client under `miniprogram/`.
- **`weknora` CLI (Preview)**: An early version of the official command-line client lives under `cli/` — feedback welcome.
- **Other Improvements**: Per-tenant RRF tuning, a dedicated query-understanding model, batch KB management, user-scoped session pinning, a tenant-wide IM channels overview, per-user font / theme preferences, a new OpenMaiC Classroom agent skill, and a full API-docs / Swagger / Client-SDK overhaul.
- **Bug Fixes**: Embedder `(nil, nil)` SIGSEGV fixed; Mimo / DeepSeek `reasoning_content` round-trip restored; multi-turn agent history rebuilt from DB (with attachment replay); OIDC login fixed; many Wiki ingest reliability fixes; FAQ no longer hallucinates summaries from filenames on empty PDFs.
**v0.4.0 Highlights:**
- **[Knowledge Assistant](https://weknora.weixin.qq.com/platform)**: Cloud-hosted knowledge assistant service for quick onboarding without local deployment
- **WeKnora Cloud**: WeKnora Cloud provider with hosted LLM models and document parsing service, credential management and status checks
- **[Chrome Extension](https://chromewebstore.google.com/detail/jpemjbopikggjlmikmclgbmkhhopjdgd)**: Browser extension for web page knowledge capture
- **[ClawHub Skill](https://clawhub.ai/lyingbug/weknora)**: ClawHub Skill marketplace integration for one-click agent skill installation
- **WeChat IM Integration**: WeChat channel adapter with QR code login and long-polling message support
- **Attachment Processing**: File attachment support in chat pipeline with content formatting and metadata injection
- **Azure OpenAI Provider**: Full Azure OpenAI support for chat, VLM, and embedding models with deployment name preservation and dimensions parameter
- **Alibaba Cloud OSS Storage**: Object storage support via S3-compatible mode with configuration UI, connectivity test, and multi-language i18n
- **Notion Connector**: Notion data source integration with API client, markdown renderer, and Connector interface
- **Baidu & Ollama Web Search**: Added Baidu and Ollama as web search providers
- **VectorStore Management**: Full VectorStore CRUD with entity, repository, service layer, connection testing, and API endpoints
- **Bug Fixes**: Fixed Azure OpenAI endpoint handling, embedding truncation, IM citation tag stripping, neo4j Go 1.24 Windows compatibility, and OSS signature issues
**v0.3.6 Highlights:**
- **ASR (Automatic Speech Recognition)**: Integrated ASR model support with audio file upload, in-document audio preview, and transcription capabilities
- **Data Source Auto-Sync (Feishu)**: Complete data source management with Feishu Wiki/Drive auto-sync, incremental and full sync, sync logs, and tenant isolation
- **OIDC Authentication**: OpenID Connect login support with auto-discovery, custom endpoints, and user info mapping
- **IM Quote/Reply Context**: Quoted messages extracted in IM channels and injected into LLM prompts for contextual replies; anti-hallucination for non-text quotes
- **Thread-Based IM Sessions**: Per-thread session mode for IM channels (Slack, Mattermost, Feishu, Telegram), enabling multi-user collaboration within threads
- **Document Summarization**: AI-generated document summaries with configurable input limits and a dedicated summary section in document detail view
- **Tavily Web Search**: Added Tavily as a web search provider; refactored web search provider architecture for extensibility
- **MCP Auto-Reconnection**: Automatic reconnection for MCP tool calls when server connection is lost
- **Parallel Tool Calling**: Concurrent execution of multiple agent tool calls via errgroup for faster complex task handling
- **Agent @Mention Scope Restriction**: User @mentions restricted to agent's allowed knowledge base scope, preventing unauthorized access
- **Login Page Performance**: Removed all backdrop-filter blur effects, reduced animations, added GPU compositing hints for faster page load
**v0.3.5 Highlights:**
- **Telegram, DingTalk & Mattermost IM Integration**: Added Telegram bot (webhook/long-polling, streaming via editMessageText), DingTalk bot (webhook/Stream mode, AI Card streaming), and Mattermost adapter; IM channel coverage now includes WeCom, Feishu, Slack, Telegram, DingTalk, and Mattermost
- **IM Slash Commands & QA Queue**: Pluggable slash-command system (/help, /info, /search, /stop, /clear) with a bounded QA worker pool, per-user rate limiting, and Redis-based multi-instance coordination
- **Suggested Questions**: Agents surface context-aware suggested questions based on configured knowledge bases; image knowledge automatically enqueues question generation
- **VLM Auto-Describe MCP Tool Images**: When MCP tools return images, the agent generates text descriptions via the configured VLM model, enabling image content to be used by text-only LLMs
- **Novita AI Provider**: New LLM provider with OpenAI-compatible API supporting chat, embedding, and VLLM model types
- **MCP Tool Name Stability**: Tool names now based on service name (stable across reconnections) instead of UUID; unique name constraint added; frontend formats names into human-readable form
- **Channel Tracking**: Knowledge entries and messages record source channel (web/api/im/browser_extension) for traceability
- **Bug Fixes**: Fixed agent empty response when no knowledge base is configured, UTF-8 truncation in summaries for Chinese/emoji documents, API key encryption loss on tenant settings update, vLLM streaming reasoning content propagation, and rerank empty passage errors
**v0.3.4 Highlights:**
- **IM Bot Integration**: WeCom, Feishu, and Slack IM channel support with WebSocket/Webhook modes, streaming, and knowledge base integration
- **Multimodal Image Support**: Image upload and multimodal image processing with enhanced session management
- **Manual Knowledge Download**: Download manual knowledge content as files with proper filename sanitization
- **NVIDIA Model API**: Support NVIDIA chat model API with custom endpoint and VLM model configuration
- **Weaviate Vector DB**: Added Weaviate as a new vector database backend for knowledge retrieval
- **AWS S3 Storage**: Integrated AWS S3 storage adapter with configuration UI and database migrations
- **AES-256-GCM Encryption**: API keys encrypted at rest with AES-256-GCM for enhanced security
- **Built-in MCP Service**: Built-in MCP service support for extending agent capabilities
- **Hybrid Search Optimization**: Grouped targets and reused query embeddings for better retrieval performance
- **Final Answer Tool**: New final_answer tool with agent duration tracking for improved agent workflows
**v0.3.3 Highlights:**
- **Parent-Child Chunking**: Hierarchical parent-child chunking strategy for enhanced context management and more accurate retrieval
- **Knowledge Base Pinning**: Pin frequently-used knowledge bases for quick access
- **Fallback Response**: Fallback response handling with UI indicators when no relevant results are found
- **Passage Cleaning for Rerank**: Passage cleaning for rerank model to improve relevance scoring accuracy
- **Storage Auto-Creation**: Storage engine connectivity check with auto-creation of buckets
- **Milvus Vector DB**: Added Milvus as a new vector database backend for knowledge retrieval
**v0.3.2 Highlights:**
- 🔍 **Knowledge Search**: New "Knowledge Search" entry point with semantic retrieval, supporting bringing search results directly into the conversation window
- ⚙️ **Parser & Storage Engine Configuration**: Configure document parser engines and storage engines for different sources in settings, with per-file-type parser selection in knowledge base
- 🖼️ **Image Rendering in Local Storage**: Support image rendering during conversations in local storage mode, with optimized streaming image placeholders
- 📄 **Document Preview**: Embedded document preview component for previewing user-uploaded original files
- 🎨 **UI Optimization**: Knowledge base, agent, and shared space list page interaction redesign
- 🗄️ **Milvus Support**: Added Milvus as a new vector database backend for knowledge retrieval
- 🌋 **Volcengine TOS**: Added Volcengine TOS object storage support
- 📊 **Mermaid Rendering**: Support mermaid diagram rendering in chat with fullscreen viewer, zoom, pan, toolbar and export
- 💬 **Batch Conversation Management**: Batch management and delete all sessions functionality
- 🔗 **Remote URL Knowledge**: Support creating knowledge entries from remote file URLs
- 🧠 **Memory Graph Preview**: Preview of user-level memory graph visualization
- 🔄 **Async Re-parse**: Async API for re-processing existing knowledge documents
**v0.3.0 Highlights:**
- 🏢 **Shared Space**: Shared space with member invitations, shared knowledge bases and agents across members, tenant-isolated retrieval
- 🧩 **Agent Skills**: Agent skills system with preloaded skills for smart-reasoning agent, sandboxed execution environment for security isolation
- 🤖 **Custom Agents**: Support for creating, configuring, and selecting custom agents with knowledge base selection modes (all/specified/disabled)
- 📊 **Data Analyst Agent**: Built-in Data Analyst agent with DataSchema tool for CSV/Excel analysis
- 🧠 **Thinking Mode**: Support thinking mode for LLM and agents, intelligent filtering of thinking content
- 🔍 **Web Search Providers**: Added Bing and Google search providers alongside DuckDuckGo
- 📋 **Enhanced FAQ**: Batch import dry run, similar questions, matched question in search results, large imports offloaded to object storage
- 🔑 **API Key Auth**: API Key authentication mechanism with Swagger documentation security
- 📎 **In-Input Selection**: Select knowledge bases and files directly in the input box with @mention display
- ☸️ **Helm Chart**: Complete Helm chart for Kubernetes deployment with Neo4j GraphRAG support
- 🌍 **i18n**: Added Korean (한국어) language support
- 🔒 **Security Hardening**: SSRF-safe HTTP client, enhanced SQL validation, MCP stdio transport security, sandbox-based execution
-**Infrastructure**: Qdrant vector DB support, Redis ACL, configurable log level, Ollama embedding optimization, `DISABLE_REGISTRATION` control
**v0.2.0 Highlights:**
- 🤖 **Agent Mode**: New ReACT Agent mode that can call built-in tools, MCP tools, and web search, providing comprehensive summary reports through multiple iterations and reflection
- 📚 **Multi-Type Knowledge Bases**: Support for FAQ and document knowledge base types, with new features including folder import, URL import, tag management, and online entry
- ⚙️ **Conversation Strategy**: Support for configuring Agent models, normal mode models, retrieval thresholds, and Prompts, with precise control over multi-turn conversation behavior
- 🌐 **Web Search**: Support for extensible web search engines with built-in DuckDuckGo search engine
- 🔌 **MCP Tool Integration**: Support for extending Agent capabilities through MCP, with built-in uvx and npx launchers, supporting multiple transport methods
- 🎨 **New UI**: Optimized conversation interface with Agent mode/normal mode switching, tool call process display, and comprehensive knowledge base management interface upgrade
-**Infrastructure Upgrade**: Introduced MQ async task management, support for automatic database migration, and fast development mode
</details>
- **v0.6.0** — Tenant RBAC (4-tier role matrix `Owner` / `Admin` / `Contributor` / `Viewer` + per-KB ownership + per-tenant audit log), tenant member management & multi-workspace UX, self-service workspaces; `weknora` CLI v0.4 GA with `mcp serve`; KB retrieval fan-out across vector stores; AES-256-GCM credential encryption + docreader gRPC TLS + Token; Zhipu embedder + Huawei OBS; server-side user preferences; Go 1.26.0. See [`docs/RBAC说明.md`](./docs/RBAC说明.md) and [`CHANGELOG.md`](./CHANGELOG.md).
- **v0.5.2** — Wiki ingest scales to 40k-document KBs (task queue + DLQ); MCP human-in-the-loop tool approval; Anthropic / Apache Doris / Tencent VectorDB / KS3 / SearXNG backends; adaptive 3-tier chunking with live preview; global ⌘K command palette; Yuque connector + WeChat Mini Program; `weknora` CLI preview.
- **v0.5.1** — Knowledge-base batch management; tenant-wide IM channels overview; session search + user-scoped pinning; unified Model / Web Search / MCP settings cards; per-agent LLM timeout; desktop tenant switching.
- **v0.5.0** — Wiki Mode GA — agents auto-generate structured, interlinked Markdown wiki pages with a knowledge graph; wiki browser + visual graph in the UI.
- **v0.4.0** — WeKnora Cloud (hosted LLM + parsing); Chrome Extension; ClawHub Skill; WeChat IM; attachment processing; Azure OpenAI / Alibaba OSS; Notion connector; Baidu + Ollama web search; VectorStore management.
- **v0.3.6** — ASR (audio); Feishu data-source auto-sync; OIDC; IM quote-reply context + thread-based sessions; document summarization; Tavily search; parallel tool calling; agent @mention scope restriction.
- **v0.3.5** — Telegram / DingTalk / Mattermost IM; IM slash commands + QA queue; suggested questions; VLM auto-describe MCP tool images; Novita AI; channel tracking.
- **v0.3.4** — WeCom / Feishu / Slack IM; multimodal image support; NVIDIA model API; Weaviate; AWS S3; AES-256-GCM API-key encryption; built-in MCP service; hybrid-search optimization; `final_answer` tool.
- **v0.3.3** — Parent-child chunking; KB pinning; fallback response; passage cleaning for rerank; storage auto-creation; Milvus.
- **v0.3.2** — Knowledge Search entry; per-source parser & storage engine config; image rendering in local storage; document preview; Volcengine TOS; Mermaid rendering; batch session management; memory graph preview.
- **v0.3.0** — Shared Space; Agent Skills + sandboxed execution; custom agents; Data Analyst agent; thinking mode; Bing / Google web search; API Key auth; Helm chart; Korean i18n; Qdrant.
- **v0.2.0** — Agent Mode (ReACT); multi-type knowledge bases (FAQ + document); conversation strategy config; DuckDuckGo web search; MCP tool integration; new UI with agent mode switching; MQ async task management.
## 📱 Interface Showcase
@@ -406,22 +269,6 @@ make dev-frontend
**Detailed Documentation:** [Development Environment Quick Start](./docs/开发指南.md)
### 📁 Directory Structure
```
WeKnora/
├── client/ # go client
├── cmd/ # Main entry point
├── config/ # Configuration files
├── docker/ # docker images files
├── docreader/ # Document parsing app
├── docs/ # Project documentation
├── frontend/ # Frontend app
├── internal/ # Core business logic
├── mcp-server/ # MCP server
├── migrations/ # DB migration scripts
└── scripts/ # Shell scripts
```
## 🤝 Contributing

View File

@@ -56,154 +56,18 @@
## ✨ 最新更新
**v0.6.0 版本亮点:**
- **租户 RBAC多租户角色权限体系** —— 本版本的核心特性。WeKnora 现已在所有写入路由上强制执行四级租户内角色矩阵(`Owner` / `Admin` / `Contributor` / `Viewer`),并通过 `chunk → knowledge → kb → creator_id` 的归属链实现按知识库的资源所有权。Contributor 对自己创建的资源完全自治对他人资源只读Admin 管理整个租户Owner 额外拥有删除租户的权限。详见 [`docs/RBAC说明.md`](./docs/RBAC说明.md)
<table>
<tr>
<td width="50%" align="center"><b>成员管理</b><br/><img src="./docs/images/rbac-member-management.png" alt="成员管理" width="100%"></td>
<td width="50%" align="center"><b>工作区切换器</b><br/><img src="./docs/images/rbac-workspace-switcher.png" alt="工作区切换器" width="100%"></td>
</tr>
<tr>
<td width="50%" align="center"><b>自助创建工作区</b><br/><img src="./docs/images/rbac-create-workspace.png" alt="创建新空间" width="100%"></td>
<td width="50%" align="center"><b>待处理邀请</b><br/><img src="./docs/images/rbac-pending-invitation.png" alt="待处理邀请" width="100%"></td>
</tr>
</table>
- **租户成员管理 + 多工作区 UX**:邀请 / 移除成员、修改角色、`/leave` 退出端点、可选的 invite-only 准入开关;待处理邀请弹窗 + 全局邀请铃铛;用户菜单内的租户切换器与按角色显隐的 UI 守卫;登录后自动恢复到上次活跃工作区;登录 / 切换工作区时展示富文本工作区通知。
- **自助创建工作区**:任何用户都可以自助创建租户(通过环境变量限制每用户上限);跨租户超级管理员在 UI 内会展示 Admin 角色徽章。
- **每租户 RBAC 审计日志**:所有 RBAC 相关事件均会记录,默认 90 天滚动清理(`created_at` 列建索引);跨租户超管的操作会固定记录到目标租户。
- **`weknora` CLI v0.3 / v0.4(正式版)**:从 Preview 升级为正式版,按 verb-noun 模式覆盖所有主资源:`agent`CRUD + invoke / check / status`chunk``session``search`chunks / kb / docs / sessions`kb`edit / pin / empty / check / status`doc`download / upload --recursive / view / wait`auth`refresh / token`context``link / unlink`。新增 `weknora mcp serve` 提供策划式 stdio MCP 服务,方便 Claude Code / Cursor 等 AI 客户端直接驱动 WeKnora。全局参数`--format``--json` 字段选择、`--jq``--paginate``--all-pages``--input``--log-level``--from-url`NDJSON 输出,透明的 401 重试,信号感知 context。
- **多向量库扇出检索**:单个知识库可绑定多个向量库,检索引擎自动 fan-out 到所有绑定的向量库并合并结果。知识库创建 / 复制 / 删除时会校验向量库绑定关系,避免不一致状态。
- **MCP 与数据源凭据 AES-256-GCM 静态加密**:支持平滑的密钥轮换;接口响应自动脱敏;新增 `/credentials` 子资源模式,避免编辑时凭据丢失。
- **Docreader gRPC 加固**app → docreader 连接支持 TLS + Token 鉴权;默认不再把 docreader gRPC 端口暴露到宿主机;`grpcio` 最低版本提升到 1.78.0 以匹配生成的 proto。
- **更多后端集成**:智谱 AI Embedding华为云 OBS 对象存储MinerU 文档解析支持自定义 vLLM URLApache Doris 新增兼容模式开关与守卫docreader 支持 URL 白名单(白名单内的图片不再重新上传)。
- **服务端用户偏好**:字体 / 主题 / 记忆功能开关持久化到服务端;知识库置顶改为用户维度(替换原租户维度);知识库与 Agent 列表显示创建人名称与「我分享的」标识。
- **其他改进**:用户收藏与最近访问;成员快捷导航入口;侧边栏密度精修;租户信息支持行内编辑(含描述字段);知识文档标签选择器重设计;系统信息页展示 UI 构建版本Moonshot 模型自动对 `moonshot-v1-*` / `kimi-k2.5` / `k2.6` 强制 `temperature=1`(这些模型拒绝其它取值,会返回 HTTP 400修复 MinerU markdown 图片语法过度转义导致下游图片提取失败;`ErrSessionNotFound` / `ErrKnowledgeBaseNotFound` 全部正确映射为 HTTP 404会话访问按用户隔离安全加固Go 升级至 1.26.0。
- **重要修复**`audit_log.Stop()``Start()` 未调用时不再死锁;组织可搜索加入不再绕过邀请码过期校验;分块器不再合并顶层标题块;修复无限滚动加载丢失文档的竞态;建索引完成的文档立即标记完成;前端离线 / 旧浏览器兼容;对话历史渲染与分页稳定性提升;模型测试连接在编辑既有模型时会回退到已存储的 API Key。
<details>
<summary><b>更早版本</b></summary>
**v0.5.2 版本亮点:**
- **Wiki 模式规模化**Wiki 入库通过通用任务队列 + 死信队列支撑万级文档知识库;页面链接图新增子图 API + 交互式探索 UI。
- **MCP 工具人机审批Human-in-the-Loop**:敏感的 MCP 工具调用会暂停 Agent并在对话 UI 中等待用户显式审批。
- **更多模型 / 向量库 / 存储 / 搜索后端**:新增 AnthropicClaude、Apache Doris 4.1、腾讯云 VectorDB、金山云 KS3、SearXNG配合向量数据库管理 UI 与按知识库独立开关的索引策略使用。
- **观测性深化**Langfuse Span 扩展至 retrieval / rerank / agent 各阶段;对话流首尾两端记录端到端 TTFBLLM 调用兜底超时加固,避免 worker 池被卡死请求永久阻塞。
- **自适应三层分块**:文档自动路由到 标题感知 / 启发式 / 递归 三种策略,知识库编辑器内嵌实时调试面板。详见 [`docs/CHUNKING.md`](./docs/CHUNKING.md)。
- **全局命令面板**⌘K 面板取代原独立搜索页,可直接从结果开启新对话。
- **更多数据源与移动端**:新增语雀连接器(全量 + 增量同步),与飞书 / Notion 并列;附带轻量级微信小程序客户端(位于 `miniprogram/`)。
- **`weknora` CLI早期版本**:位于 `cli/` 的官方命令行客户端早期版本,欢迎反馈。
- **其他改进**:租户级 RRF 调参;查询理解专用模型;知识库批量管理与置顶分组;用户维度的会话置顶与关键词搜索;租户级 IM 频道总览;按用户保存的字体 / 主题偏好;新增 OpenMaiC 微课堂 Agent 技能API 文档 / Swagger / Client SDK 全量整改。
- **重要修复**:修复 Embedder 在连接失败时返回 `(nil, nil)` 导致 SIGSEGV 的问题Mimo / DeepSeek 类提供商 `reasoning_content` 正确回传Agent 多轮历史改为从 DB 重建并修复附件跨轮丢失;修复 OIDC 登录;多个 Wiki 入库可靠性问题;空 PDF 不再凭文件名编造摘要。
**v0.4.0 版本亮点:**
- **[知识助理](https://weknora.weixin.qq.com/platform)**:云端托管的知识助理服务,无需本地部署即可快速体验
- **WeKnora Cloud**WeKnora Cloud 模型服务集成,提供托管大模型和文档解析能力,支持凭证管理与状态检查
- **[Chrome 插件](https://chromewebstore.google.com/detail/jpemjbopikggjlmikmclgbmkhhopjdgd)**:浏览器插件支持网页知识快速采集
- **[ClawHub Skill](https://clawhub.ai/lyingbug/weknora)**ClawHub Skill 技能市场集成,一键安装 Agent 技能
- **微信 IM 集成**:微信频道适配器,支持扫码登录和长轮询消息接收
- **附件处理**:对话流水线支持文件附件,增强错误处理和内容格式化,注入图片/附件元数据
- **Azure OpenAI 提供商**:全面支持 Azure OpenAI 的 Chat、VLM 和 Embedding 模型,保留部署名称映射,支持 dimensions 参数配置
- **阿里云 OSS 存储**:通过 S3 兼容模式支持阿里云 OSS 对象存储,提供配置界面、连通性测试和多语言国际化支持
- **Notion 连接器**Notion 数据源集成,包含 API 客户端、Markdown 渲染器和 Connector 接口实现
- **百度 & Ollama 网页搜索**:新增百度和 Ollama 作为网页搜索引擎
- **VectorStore 管理**:完整的 VectorStore CRUD 功能,包含实体、仓库、服务层、连通性测试和 API 端点
- **重要修复**:修复 Azure OpenAI 端点处理、Embedding 截断、IM 引用标签清理、neo4j Go 1.24 Windows 兼容性及 OSS 签名问题
**v0.3.6 版本亮点:**
- **ASR 语音识别**:集成 ASR 模型,支持音频文件上传、文档内音频预览和语音转写能力
- **数据源自动同步(飞书)**:完整的数据源管理功能,支持飞书 Wiki/云文档自动同步(增量/全量),同步日志与租户隔离
- **OIDC 统一认证**:支持 OpenID Connect 登录,自动发现端点、自定义端点配置及用户信息字段映射
- **IM 引用回复上下文**IM 频道中提取引用消息并注入 LLM 提示词,实现上下文关联回复;非文本引用防幻觉处理
- **IM 线程会话模式**IM 频道支持按线程维度独立会话Slack、Mattermost、飞书、Telegram线程内多用户协作
- **文档自动摘要**AI 生成文档摘要,可配置最大输入长度,文档详情页展示专属摘要区域
- **Tavily 网页搜索**:新增 Tavily 搜索引擎;重构 Web Search Provider 架构,提升可扩展性
- **MCP 自动重连**MCP 工具调用断线自动重连
- **并行工具调用**Agent 模式支持通过 errgroup 并发执行多个工具调用,加速复杂任务处理
- **Agent @提及范围限制**:用户 @提及限制在 Agent 授权的知识库范围内,防止越权访问
- **登录页性能优化**:移除全部 backdrop-filter blur精简动画元素新增 GPU 合成加速提示
**v0.3.5 版本亮点:**
- **Telegram、钉钉 & Mattermost IM集成**新增Telegram机器人webhook/长轮询流式editMessageText回复、钉钉机器人webhook/Stream模式AI卡片流式输出和Mattermost适配器IM频道现已覆盖企业微信、飞书、Slack、Telegram、钉钉、Mattermost共6个平台
- **IM斜杠命令与QA队列**:可插拔斜杠命令框架(/help、/info、/search、/stop、/clear配合有界QA工作池、用户级限流和基于Redis的多实例分布式协调
- **推荐问题**Agent基于关联知识库自动生成上下文相关的推荐问题在对话界面开场前展示图片知识自动触发问题生成任务
- **VLM自动描述MCP工具返回图片**当MCP工具返回图片时Agent通过配置的VLM模型自动生成文字描述使不支持图片输入的LLM也能理解图片内容
- **Novita AI提供商**新增Novita AI通过OpenAI兼容接口支持Chat、Embedding和VLLM模型类型
- **MCP工具名称稳定性**工具名称改为基于service.Name跨重连保持稳定新增唯一名称约束和碰撞防护前端将snake_case工具名格式化为可读形式
- **来源频道标记**知识条目和消息新增channel字段记录来源web/api/im/browser_extension便于追溯
- **重要修复**修复无知识库时Agent空响应、中文/emoji文档摘要UTF-8截断、租户设置更新时API密钥加密丢失、vLLM流式推理内容缺失、Rerank空段落过滤等问题
**v0.3.4 版本亮点:**
- **IM机器人集成**支持企业微信、飞书、Slack IM频道WebSocket/Webhook双模式流式回复与知识库集成
- **多模态图片支持**:图片上传与多模态图片处理,增强会话管理能力
- **手动知识下载**:支持手动知识内容导出下载,文件名清洗与格式化处理
- **NVIDIA模型API**支持NVIDIA聊天模型API自定义端点及VLM模型配置
- **Weaviate向量数据库**新增Weaviate向量数据库后端用于知识检索
- **AWS S3存储**集成AWS S3存储适配器配置界面及数据库迁移
- **AES-256-GCM加密**API密钥静态加密采用AES-256-GCM增强安全性
- **内置MCP服务**支持内置MCP服务扩展Agent能力
- **混合检索优化**:按目标分组并复用查询向量,提升检索性能
- **Final Answer工具**新增final_answer工具及Agent耗时跟踪优化Agent工作流
**v0.3.3 版本亮点:**
- **父子分块策略**:层级化的父子分块策略,增强上下文管理和检索精度
- **知识库置顶**:支持置顶常用知识库,快速访问
- **兜底回复**无相关结果时的兜底回复处理及UI指示
- **Rerank段落清洗**Rerank模型段落清洗功能提升相关性评分准确度
- **存储桶自动创建**:存储引擎连通性检查增强,支持自动创建存储桶
- **Milvus向量数据库**新增Milvus向量数据库后端用于知识检索
**v0.3.2 版本亮点:**
- 🔍 **知识搜索**:新增"知识搜索"入口,支持语义检索,可将检索结果直接带入对话窗口
- ⚙️ **解析引擎与存储引擎配置**:设置中支持配置各个来源的文档解析引擎和存储引擎信息,知识库中支持为不同类型文件选择不同的解析引擎
- 🖼️ **本地存储图片渲染**:本地存储模式下支持对话过程中图片的渲染,流式输出中图片占位效果优化
- 📄 **文档预览**:使用内嵌的文档预览组件预览用户上传的原始文件
- 🎨 **交互优化**:知识库、智能体、共享空间列表页面交互全面优化
- 🗄️ **Milvus支持**新增Milvus向量数据库后端用于知识检索
- 🌋 **火山引擎TOS**新增火山引擎TOS对象存储支持
- 📊 **Mermaid渲染**对话中支持Mermaid图表渲染全屏查看器支持缩放、导航和导出
- 💬 **对话批量管理**:支持批量管理和一键删除所有会话
- 🔗 **远程URL创建知识**支持从远程文件URL创建知识条目
- 🧠 **记忆图谱预览**:用户级记忆图谱可视化预览
- 🔄 **异步重新解析**支持异步API重新解析已有知识文档
**v0.3.0 版本亮点:**
- 🏢 **共享空间**共享空间管理支持成员邀请、知识库和Agent跨成员共享租户隔离检索
- 🧩 **Agent Skills**Agent技能系统预置智能推理技能基于沙盒的安全隔离执行环境
- 🤖 **自定义Agent**支持创建、配置和选择自定义Agent知识库选择模式全部/指定/禁用)
- 📊 **数据分析Agent**内置数据分析AgentDataSchema工具支持CSV/Excel分析
- 🧠 **思考模式**支持LLM和Agent思考模式智能过滤思考内容
- 🔍 **搜索引擎扩展**新增Bing和Google搜索引擎与DuckDuckGo并列可选
- 📋 **FAQ增强**:批量导入预检、相似问题、搜索结果匹配问题字段、大批量导入卸载至对象存储
- 🔑 **API Key认证**API Key认证机制Swagger文档安全配置
- 📎 **输入框内选择**:输入框中直接选择知识库和文件,@提及显示
- ☸️ **Helm Chart**完整的Kubernetes部署Helm Chart支持Neo4j图谱
- 🌍 **国际化**:新增韩语(한국어)支持
- 🔒 **安全加固**SSRF安全HTTP客户端、增强SQL验证、MCP stdio传输安全、沙盒化执行
-**基础设施**Qdrant向量数据库支持、Redis ACL、可配置日志级别、Ollama嵌入优化、`DISABLE_REGISTRATION`控制
**v0.2.0 版本亮点:**
- 🤖 **Agent模式**新增ReACT Agent模式支持调用内置工具、MCP工具和网络搜索通过多次迭代和反思提供全面总结报告
- 📚 **多类型知识库**支持FAQ和文档两种类型知识库新增文件夹导入、URL导入、标签管理和在线录入功能
- ⚙️ **对话策略**支持配置Agent模型、普通模式模型、检索阈值和Prompt精确控制多轮对话行为
- 🌐 **网络搜索**支持可扩展的网络搜索引擎内置DuckDuckGo搜索引擎
- 🔌 **MCP工具集成**支持通过MCP扩展Agent能力内置uvx、npx启动工具支持多种传输方式
- 🎨 **全新UI**优化对话界面支持Agent模式/普通模式切换,展示工具调用过程,知识库管理界面全面升级
-**底层升级**引入MQ异步任务管理支持数据库自动迁移提供快速开发模式
</details>
- **v0.6.0** —— 租户 RBAC四级角色矩阵 `Owner` / `Admin` / `Contributor` / `Viewer` + 按 KB 归属 + 每租户审计日志)、租户成员管理与多工作区 UX、自助创建工作区`weknora` CLI v0.4 正式版 + `mcp serve`KB 检索跨向量库扇出MCP / 数据源凭据 AES-256-GCM 加密 + docreader gRPC TLS + Token新增智谱 Embedding 与华为云 OBS服务端用户偏好Go 1.26.0。详见 [`docs/RBAC说明.md`](./docs/RBAC说明.md) 与 [`CHANGELOG.md`](./CHANGELOG.md)。
- **v0.5.2** —— Wiki 入库支撑万级文档知识库(任务队列 + 死信队列MCP 工具人机审批Anthropic / Apache Doris / 腾讯云 VectorDB / 金山云 KS3 / SearXNG 后端;自适应三层分块 + 实时调试面板;全局 ⌘K 命令面板;语雀连接器 + 微信小程序;`weknora` CLI 早期版本。
- **v0.5.1** —— 知识库批量管理;租户级 IM 频道总览;会话搜索 + 用户级置顶;模型 / 网页搜索 / MCP 统一卡片化设置;按 Agent LLM 调用超时;桌面端租户切换
- **v0.5.0** —— Wiki 模式正式版 —— Agent 从原始文档自治生成结构化、相互链接的 Markdown Wiki 页面及知识图谱Wiki 浏览器 + 可视化图谱。
- **v0.4.0** —— WeKnora Cloud托管模型 + 解析Chrome 插件ClawHub Skill微信 IM附件处理Azure OpenAI / 阿里云 OSSNotion 连接器;百度 + Ollama 网页搜索VectorStore 管理。
- **v0.3.6** —— ASR 语音飞书数据源自动同步OIDCIM 引用回复 + 线程会话文档自动摘要Tavily 搜索并行工具调用Agent @提及范围限制
- **v0.3.5** —— Telegram / 钉钉 / Mattermost IMIM 斜杠命令 + QA 队列推荐问题VLM 自动描述 MCP 返回图片Novita AI来源频道标记。
- **v0.3.4** —— 企业微信 / 飞书 / Slack IM多模态图片NVIDIA 模型 APIWeaviateAWS S3AES-256-GCM API Key 加密;内置 MCP 服务;混合检索优化;`final_answer` 工具。
- **v0.3.3** —— 父子分块知识库置顶兜底回复Rerank 段落清洗存储桶自动创建Milvus。
- **v0.3.2** —— 知识搜索入口;按来源配置解析与存储引擎;本地存储图片渲染;文档预览;火山引擎 TOSMermaid 渲染;对话批量管理;记忆图谱预览。
- **v0.3.0** —— 共享空间Agent Skills + 沙盒执行;自定义 Agent数据分析 Agent思考模式Bing / Google 搜索API Key 认证Helm Chart韩语 i18nQdrant。
- **v0.2.0** —— Agent 模式ReACT多类型知识库FAQ + 文档对话策略配置DuckDuckGo 网页搜索MCP 工具集成;全新 UI + Agent 模式切换MQ 异步任务管理。
## 📱 功能展示
@@ -393,22 +257,6 @@ make dev-frontend
**详细文档:** [开发环境快速入门](./docs/开发指南.md)
### 📁 项目目录结构
```
WeKnora/
├── client/ # go客户端
├── cmd/ # 应用入口
├── config/ # 配置文件
├── docker/ # docker 镜像文件
├── docreader/ # 文档解析项目
├── docs/ # 项目文档
├── frontend/ # 前端项目
├── internal/ # 核心业务逻辑
├── mcp-server/ # MCP服务器
├── migrations/ # 数据库迁移脚本
└── scripts/ # 启动与工具脚本
```
## 🤝 贡献指南

View File

@@ -56,155 +56,18 @@ Feishu、Notion、Yuqueなどの外部プラットフォームからのナレッ
## ✨ 最新アップデート
**v0.6.0 バージョンのハイライト:**
- **テナント RBACロールベースアクセス制御** — 本リリースの目玉機能。WeKnora は全ての書き込み系ルートに対し、テナント単位で 4 階層のロールマトリクス(`Owner` / `Admin` / `Contributor` / `Viewer`)を強制します。`chunk → knowledge → kb → creator_id` の所有権チェーンにより、KB 単位のリソース所有権を実現。Contributor は自分が作ったリソースには完全な権限を持ち、他人のリソースには読み取り専用。Admin はテナント全体を管理、Owner はさらにテナント削除権限を持ちます。詳細は [`docs/RBAC说明.md`](./docs/RBAC说明.md) を参照
<table>
<tr>
<td width="50%" align="center"><b>テナントメンバー管理</b><br/><img src="./docs/images/rbac-member-management.png" alt="テナントメンバー管理" width="100%"></td>
<td width="50%" align="center"><b>ワークスペース切替</b><br/><img src="./docs/images/rbac-workspace-switcher.png" alt="ワークスペース切替" width="100%"></td>
</tr>
<tr>
<td width="50%" align="center"><b>セルフサービスでのワークスペース作成</b><br/><img src="./docs/images/rbac-create-workspace.png" alt="ワークスペース作成" width="100%"></td>
<td width="50%" align="center"><b>保留中の招待</b><br/><img src="./docs/images/rbac-pending-invitation.png" alt="保留中の招待" width="100%"></td>
</tr>
</table>
- **テナントメンバー管理 + マルチワークスペース UX**:メンバー招待 / 削除 / ロール変更、`/leave` エンドポイント、招待制invite-onlyゲート保留中招待ダイアログ + グローバル招待ベル;ユーザーメニュー内のテナント切替とロール認識型 UI ガード;最後にアクティブだったワークスペースをログイン間で復元;ログイン / テナント切替時のリッチなワークスペース通知。
- **セルフサービスでのワークスペース作成**:任意のユーザーが自身のテナントを作成可能(環境変数で上限制御);クロステナント・スーパー管理者には UI 上で Admin ロールチップを表示。
- **テナントごとの RBAC 監査ログ**:全 RBAC 関連イベントを記録、毎日のリテンションスイープでデフォルト 90 日保持(`created_at` にインデックス);クロステナント・スーパー管理者のアクションは発行元テナントにピン留め。
- **`weknora` CLI v0.3 / v0.4GA**:プレビューから GA へ昇格。主要リソースを verb-noun サブツリーで網羅:`agent`CRUD + invoke / check / status`chunk``session``search`chunks / kb / docs / sessions`kb`edit / pin / empty / check / status`doc`download / upload --recursive / view / wait`auth`refresh / token`context``link / unlink`。新規 `weknora mcp serve` がキュレーション済み stdio MCP サーバーを提供し、Claude Code / Cursor などの AI クライアントから WeKnora を直接操作可能。グローバルオプション:`--format``--json` フィールド選択、`--jq``--paginate``--all-pages``--input``--log-level``--from-url`、NDJSON 出力、透過的 401 リトライ、シグナル対応コンテキスト。
- **複数ベクター DB を横断する KB 検索ファンアウト**1 つの KB を複数のベクター DB にバインド可能。検索エンジンは全バインド先に対しクエリをファンアウトし結果をマージ。KB エディタは create / copy / delete 時にバインディングを検証し不整合を防止。
- **MCP / データソース資格情報の AES-256-GCM 静的暗号化**スムーズなキーローテーションをサポートAPI レスポンスで機密フィールドを自動マスク;新しい `/credentials` サブリソースパターンで編集時の資格情報喪失を防止。
- **Docreader gRPC ハードニング**app → docreader 接続が TLS + Token 認証をサポートdocreader gRPC ポートをデフォルトでホストに公開しない;生成プロト互換のため `grpcio` 最低バージョンを 1.78.0 に。
- **新規バックエンド統合**Zhipu AI Embedder華為雲 OBS オブジェクトストレージMinerU ドキュメントパーサーで vLLM URL を設定可能Apache Doris に互換モードと切替ガードdocreader URL ホワイトリスト(ホワイトリスト内画像は再アップロードしない)。
- **サーバーサイドユーザー設定**:フォント / テーマ / メモリ機能トグルをサーバーに永続化KB ピン留めをユーザー単位に変更従来はテナント全体共有KB / Agent 一覧に作成者名と「自分が共有」ラベルを表示。
- **その他の改善**:ユーザーお気に入り + 最近使用メンバー向けクイックナビサイドバー密度のリフレッシュテナント情報のインライン編集description フィールド付きナレッジドキュメントタグセレクタ再設計System Info ページに UI ビルドバージョン表示Moonshot 系モデル(`moonshot-v1-*` / `kimi-k2.5` / `k2.6` — 他の値で HTTP 400 を返す)に対し `temperature=1` を強制MinerU markdown 画像構文の過剰エスケープ修正で下流の画像抽出が機能;`ErrSessionNotFound` / `ErrKnowledgeBaseNotFound` を全ハンドラで HTTP 404 にマッピングセッションアクセスをユーザー単位にスコープGo を 1.26.0 にアップグレード。
- **バグ修正**`Start()` 未呼び出し時の `audit_log.Stop()` デッドロック;検索可能な組織参加が招待コード期限切れをバイパスしていた問題;チャンカーの最上位見出しチャンク統合バグ;無限スクロール競合でドキュメントが欠落する問題;インデックス完了済みドキュメントの即時完了;フロントエンドオフライン / レガシーブラウザ対応;チャット履歴レンダリング / ページネーション安定性向上;既存モデルのテスト接続時に保存済み API キーへフォールバック。
<details>
<summary><b>過去のリリース</b></summary>
**v0.5.2 バージョンのハイライト:**
- **Wiki モードのスケール強化**Wiki インジェストが汎用タスクキュー + デッドレターキューにより万件規模の KB に対応。ページリンクグラフはサブグラフ API + インタラクティブ探索 UI を追加。
- **MCP ツールの Human-in-the-Loop 承認**:センシティブな MCP ツール呼び出しで Agent が一時停止し、チャット UI でユーザーの明示承認を待機。
- **新規 LLM / ベクター DB / ストレージ / 検索**AnthropicClaude、Apache Doris 4.1、Tencent VectorDB、金山雲 KS3、SearXNG をバックエンドとして追加。Vector Store 管理 UI と KB ごとのインデックス戦略 ON/OFF と組み合わせて利用可能。
- **オブザーバビリティ強化**Langfuse Span を retrieval / rerank / agent 各ステージに拡張;チャットストリームの両端で end-to-end TTFB を記録LLM 呼び出しのフォールバックタイムアウトを強化し worker プールの恒久ブロックを防止。
- **適応型 3 段階チャンキング**:見出しベース / ヒューリスティック / 再帰 の 3 戦略に自動振り分け、KB エディタにライブプレビューパネルを内蔵。詳細は [`docs/CHUNKING.md`](./docs/CHUNKING.md)。
- **グローバルコマンドパレット**⌘K パレットが独立検索ページを置き換え、結果から直接新規チャットを起動可能。
- **データソースとモバイル**Yuque コネクタ(フル + 増分同期)が Feishu / Notion と並んで利用可能、軽量な WeChat ミニプログラムクライアントを `miniprogram/` 配下に同梱。
- **`weknora` CLIプレビュー版**`cli/` 配下に公式コマンドラインクライアントの早期版を同梱、フィードバック歓迎。
- **その他の改善**:テナント単位の RRF 調整クエリ理解用の専用モデルKB の一括管理;ユーザー単位のセッションピン留めとキーワード検索;テナント全体の IM チャネル概観;ユーザー単位で保存されるフォント / テーマ設定OpenMaiC マイクロクラスルームの新規 Agent スキルAPI ドキュメント / Swagger / Client SDK の全面リフレッシュ。
- **バグ修正**Embedder が接続失敗時に `(nil, nil)` を返して SIGSEGV に至る問題を修正Mimo / DeepSeek 系プロバイダーの `reasoning_content` ラウンドトリップ復元Agent 多ターン履歴を DB から再構築(添付ファイル replay 含むOIDC ログイン修正Wiki インジェストの信頼性向上多数;空 PDF でファイル名から要約を捏造しないよう修正。
**v0.4.0 バージョンのハイライト:**
- **[知識アシスタント](https://weknora.weixin.qq.com/platform)**:クラウドホスティング型知識アシスタントサービス、ローカルデプロイ不要で即座に利用可能
- **WeKnora Cloud**WeKnora Cloud プロバイダー統合、LLM モデルとドキュメント解析サービス、クレデンシャル管理とステータスチェック
- **[Chrome 拡張機能](https://chromewebstore.google.com/detail/jpemjbopikggjlmikmclgbmkhhopjdgd)**ブラウザ拡張機能でWebページからのナレッジ取り込み
- **[ClawHub Skill](https://clawhub.ai/lyingbug/weknora)**ClawHub Skill マーケットプレイス統合でワンクリックスキルインストール
- **WeChat IM 統合**WeChat チャネルアダプター。QR コードログインとロングポーリングメッセージをサポート
- **添付ファイル処理**:チャットパイプラインでのファイル添付サポート、コンテンツフォーマットと画像/添付ファイルメタデータの注入
- **Azure OpenAI プロバイダー**Azure OpenAI の Chat、VLM、Embedding モデルを完全サポート。デプロイメント名の保持と dimensions パラメータの設定に対応
- **Alibaba Cloud OSS ストレージ**S3互換モードによる阿里雲 OSS オブジェクトストレージをサポート。設定 UI、接続テスト、多言語 i18n を提供
- **Notion コネクタ**Notion データソース統合。API クライアント、Markdown レンダラー、Connector インターフェースの実装
- **Baidu & Ollama Web 検索**Baidu と Ollama を Web 検索プロバイダーとして追加
- **VectorStore 管理**:完全な VectorStore CRUD 機能。エンティティ、リポジトリ、サービスレイヤー、接続テスト、API エンドポイント
- **重要なバグ修正**Azure OpenAI エンドポイント処理、Embedding 切り詰め、IM 引用タグのストリップ、neo4j Go 1.24 Windows 互換性、OSS 署名問題を修正
**v0.3.6 バージョンのハイライト:**
- **ASR自動音声認識**ASRモデルを統合し、音声ファイルのアップロード、ドキュメント内音声プレビュー、音声文字起こし機能をサポート
- **データソース自動同期Feishu**完全なデータソース管理機能、Feishu Wiki/ドライブの自動同期(増分/全量)、同期ログ、テナント分離
- **OIDC認証**OpenID Connectログインをサポート、自動ディスカバリ、カスタムエンドポイント設定、ユーザー情報マッピング
- **IM引用返信コンテキスト**IMチャネルで引用メッセージを抽出してLLMプロンプトに注入し、文脈に基づく回答を実現。非テキスト引用の幻覚防止処理
- **IMスレッドベースセッション**IMチャネルSlack、Mattermost、Feishu、Telegramでスレッド単位のセッションモードをサポート、スレッド内でのマルチユーザーコラボレーション
- **ドキュメント自動要約**AI生成のドキュメント要約、入力サイズの設定が可能、ドキュメント詳細画面に専用の要約セクション
- **Tavily Web検索**Tavilyを新しいWeb検索プロバイダーとして追加、Web検索プロバイダーアーキテクチャを拡張性向上のためリファクタリング
- **MCP自動再接続**サーバー接続断絶時のMCPツール呼び出しの自動再接続ロジック
- **並列ツール呼び出し**Agentモードでerrgroupを使用して複数のツール呼び出しを並行実行、複雑なタスク処理を高速化
- **Agent @メンション範囲制限**:ユーザーの@メンションをAgentが許可されたナレッジベースの範囲内に制限、不正アクセスを防止
- **ログインページパフォーマンス**backdrop-filter blurをすべて削除、アニメーション要素を削減、GPUコンポジティングヒントを追加
**v0.3.5 バージョンのハイライト:**
- **Telegram、DingTalk & Mattermost IM統合**Telegramボットwebhook/ロングポーリング、editMessageTextストリーミング、DingTalkボットwebhook/Streamモード、AIカードストリーミング、Mattermost アダプターを新規追加。IMチャネルはWeChat Work、Feishu、Slack、Telegram、DingTalk、Mattermost の6プラットフォームをカバー
- **IMスラッシュコマンドとQAキュー**:プラグイン式スラッシュコマンドフレームワーク(/help、/info、/search、/stop、/clear、有界QAワーカープール、ユーザー単位レート制限、RedisベースのマルチインスタンスDistributed Coordination
- **推奨質問**Agentが関連ナレッジベースに基づいてコンテキスト対応の推奨質問を自動生成し、チャットインターフェースに表示。画像ナレッジは質問生成タスクを自動キュー登録
- **VLMによるMCPツール画像自動説明**MCPツールが画像を返した場合、設定されたVLMモデルを使用してテキスト説明を自動生成し、テキストのみのLLMでも画像内容を利用可能に
- **Novita AIプロバイダー**OpenAI互換APIでchat、embedding、VLLMモデルタイプをサポートする新しいLLMプロバイダー
- **MCPツール名の安定性**ツール名をUUIDではなくservice.Nameから生成再接続後も安定。衝突防止制約を追加。フロントエンドでsnake_caseを人間が読みやすい形式に整形
- **チャネルトラッキング**ナレッジエントリとメッセージにchannelフィールド追加web/api/im/browser_extension
- **重要バグ修正**ナレッジベース未設定時のAgent空レスポンス、中国語/絵文字ドキュメントのUTF-8切り詰め、テナント設定更新時のAPIキー暗号化消失、vLLMストリーミング推論コンテンツ欠落、Rerankの空パッセージエラーを修正
**v0.3.4 バージョンのハイライト:**
- **IMボット統合**企業WeChat、Feishu、SlackのIMチャネルをサポート、WebSocket/Webhookモード、ストリーミング対応、ナレッジベース統合
- **マルチモーダル画像サポート**:画像アップロードとマルチモーダル画像処理、セッション管理の強化
- **手動ナレッジダウンロード**:手動ナレッジコンテンツのファイルダウンロード、ファイル名サニタイズ対応
- **NVIDIA モデルAPI**NVIDIAチャットモデルAPIをサポート、カスタムエンドポイントとVLMモデル設定
- **Weaviateベクトルデータベース**ナレッジ検索用にWeaviateベクトルデータベースバックエンドを追加
- **AWS S3ストレージ**AWS S3ストレージアダプターを統合、設定UIとデータベースマイグレーション
- **AES-256-GCM暗号化**APIキーをAES-256-GCMで静的暗号化、セキュリティ強化
- **組み込みMCPサービス**組み込みMCPサービスサポートでAgent機能を拡張
- **ハイブリッド検索最適化**:ターゲットのグループ化とクエリ埋め込みの再利用で検索性能を向上
- **Final Answerツール**新しいfinal_answerツールとAgentの所要時間追跡でワークフローを改善
**v0.3.3 バージョンのハイライト:**
- **親子チャンキング**:階層型の親子チャンキング戦略により、コンテキスト管理と検索精度を強化
- **ナレッジベースのピン留め**:よく使うナレッジベースをピン留めして素早くアクセス
- **フォールバックレスポンス**関連する結果がない場合のフォールバックレスポンス処理とUIインジケーター
- **Rerankパッセージクリーニング**Rerankモデルのパッセージクリーニング機能で関連性スコアの精度を向上
- **バケット自動作成**:ストレージエンジン接続チェックの強化、バケットの自動作成をサポート
- **Milvusベクトルデータベース**ナレッジ検索用にMilvusベクトルデータベースバックエンドを追加
**v0.3.2 バージョンのハイライト:**
- 🔍 **ナレッジ検索**:新しい「ナレッジ検索」エントリポイント、セマンティック検索をサポートし、検索結果を直接会話ウィンドウに持ち込み可能
- ⚙️ **パーサーとストレージエンジンの設定**:設定画面でソースごとのドキュメントパーサーとストレージエンジンを設定可能、ナレッジベースでファイルタイプ別のパーサー選択をサポート
- 🖼️ **ローカルストレージ画像レンダリング**:ローカルストレージモードで会話中の画像レンダリングをサポート、ストリーミング中の画像プレースホルダーを最適化
- 📄 **ドキュメントプレビュー**:ユーザーがアップロードした元のファイルをプレビューする組み込みドキュメントプレビューコンポーネント
- 🎨 **UI最適化**:ナレッジベース、エージェント、共有スペースリストページのインタラクションを再設計
- 🗄️ **Milvusサポート**ナレッジ検索用にMilvusベクトルデータベースバックエンドを追加
- 🌋 **Volcengine TOS**Volcengine TOSオブジェクトストレージサポートを追加
- 📊 **Mermaidレンダリング**チャットでMermaidダイアグラムのレンダリングをサポート、フルスクリーンビューアー、ズーム、パン、ツールバー、エクスポート機能付き
- 💬 **バッチ会話管理**:バッチ管理と全セッション一括削除機能
- 🔗 **リモートURLナレッジ**リモートファイルURLからナレッジエントリの作成をサポート
- 🧠 **メモリグラフプレビュー**:ユーザーレベルのメモリグラフ可視化プレビュー
- 🔄 **非同期再解析**既存のナレッジドキュメントの非同期再処理API
**v0.3.0 バージョンのハイライト:**
- 🏢 **共有スペース**共有スペース管理、メンバー招待、メンバー間でのナレッジベースとAgentの共有、テナント分離検索
- 🧩 **Agentスキル**Agentスキルシステム、スマート推論向けプリロードスキル、サンドボックスベースのセキュリティ分離実行環境
- 🤖 **カスタムAgent**カスタムAgentの作成・設定・選択をサポート、ナレッジベース選択モード全部/指定/無効)
- 📊 **データアナリストAgent**組み込みデータアナリストAgent、CSV/Excel分析用DataSchemaツール
- 🧠 **思考モード**LLMとAgentの思考モードをサポート、思考コンテンツのインテリジェントフィルタリング
- 🔍 **検索エンジン拡張**DuckDuckGoに加えてBingとGoogleの検索プロバイダーを追加
- 📋 **FAQ強化**:バッチインポートドライラン、類似質問、検索結果のマッチ質問フィールド、大量インポートのオブジェクトストレージオフロード
- 🔑 **API Key認証**API Key認証メカニズム、Swaggerドキュメントセキュリティ設定
- 📎 **入力内選択**:入力ボックスでナレッジベースとファイルを直接選択、@メンション表示
- ☸️ **Helm Chart**Kubernetesデプロイメント用の完全なHelm Chart、Neo4j GraphRAGサポート
- 🌍 **国際化**:韓国語(한국어)サポートを追加
- 🔒 **セキュリティ強化**SSRF安全HTTPクライアント、強化されたSQLバリデーション、MCP stdio転送セキュリティ、サンドボックスベース実行
-**インフラストラクチャ**Qdrantベクトルデータベースサポート、Redis ACL、設定可能なログレベル、Ollama埋め込み最適化、`DISABLE_REGISTRATION`制御
**v0.2.0 バージョンのハイライト:**
- 🤖 **Agentモード**新規ReACT Agentモードを追加、組み込みツール、MCPツール、Web検索を呼び出し、複数回の反復とリフレクションを通じて包括的なサマリーレポートを提供
- 📚 **複数タイプのナレッジベース**FAQとドキュメントの2種類のナレッジベースをサポート、フォルダーインポート、URLインポート、タグ管理、オンライン入力機能を新規追加
- ⚙️ **対話戦略**Agentモデル、通常モードモデル、検索閾値、Promptの設定をサポート、マルチターン対話の動作を精密に制御
- 🌐 **Web検索**拡張可能なWeb検索エンジンをサポート、DuckDuckGo検索エンジンを組み込み
- 🔌 **MCPツール統合**MCPを通じてAgent機能を拡張、uvx、npx起動ツールを組み込み、複数の転送方式をサポート
- 🎨 **新UI**対話インターフェースを最適化、Agentモード/通常モードの切り替え、ツール呼び出しプロセスの表示、ナレッジベース管理インターフェースの全面的なアップグレード
-**インフラストラクチャのアップグレード**MQ非同期タスク管理を導入、データベース自動マイグレーションをサポート、高速開発モードを提供
</details>
- **v0.6.0** — テナント RBAC4 階層ロールマトリクス `Owner` / `Admin` / `Contributor` / `Viewer` + KB 単位の所有 + テナントごとの監査ログ)、テナントメンバー管理とマルチワークスペース UX、セルフサービスでのワークスペース作成`weknora` CLI v0.4 GA + `mcp serve`KB 検索の複数ベクター DB ファンアウトMCP / データソース資格情報の AES-256-GCM 暗号化 + docreader gRPC TLS + TokenZhipu Embedder と華為雲 OBS の追加サーバーサイドユーザー設定Go 1.26.0。詳細は [`docs/RBAC说明.md`](./docs/RBAC说明.md) と [`CHANGELOG.md`](./CHANGELOG.md) を参照。
- **v0.5.2** — Wiki インジェストが万件規模 KB に対応(タスクキュー + DLQMCP 工具人機審批Anthropic / Apache Doris / Tencent VectorDB / 金山雲 KS3 / SearXNG バックエンド;適応型 3 段階チャンキング + ライブプレビュー;グローバル ⌘K コマンドパレットYuque コネクタ + WeChat ミニプログラム;`weknora` CLI プレビュー版。
- **v0.5.1** — KB 一括管理;テナント全体の IM チャネル概観;セッション検索 + ユーザー単位ピン留め;モデル / Web 検索 / MCP 統一カード設定Agent ごとの LLM タイムアウト;デスクトップ版テナント切替
- **v0.5.0** — Wiki モード GA — Agent が原文書から構造化・相互リンクされた Markdown Wiki ページとナレッジグラフを自動生成、Wiki ブラウザと可視化グラフを UI に搭載。
- **v0.4.0** — WeKnora Cloudホスティング LLM + 解析Chrome 拡張機能ClawHub SkillWeChat IM添付ファイル処理Azure OpenAI / Alibaba OSSNotion コネクタBaidu + Ollama Web 検索VectorStore 管理。
- **v0.3.6** — ASR音声Feishu データソース自動同期OIDCIM 引用返信 + スレッドベースセッションドキュメント自動要約Tavily 検索並列ツール呼び出しAgent @メンション範囲制限
- **v0.3.5** — Telegram / DingTalk / Mattermost IMIM スラッシュコマンド + QA キュー推奨質問VLM による MCP ツール画像自動説明Novita AIチャネルトラッキング。
- **v0.3.4** — 企業 WeChat / Feishu / Slack IMマルチモーダル画像NVIDIA モデル APIWeaviateAWS S3AES-256-GCM API キー暗号化;組み込み MCP サービス;ハイブリッド検索最適化;`final_answer` ツール。
- **v0.3.3** — 親子チャンキングKB ピン留めフォールバック応答Rerank パッセージクリーニングストレージバケット自動作成Milvus。
- **v0.3.2** — ナレッジ検索エントリ;ソース別パーサー / ストレージエンジン設定ローカルストレージ画像レンダリングドキュメントプレビューVolcengine TOSMermaid レンダリング;対話バッチ管理;メモリグラフプレビュー。
- **v0.3.0** — 共有スペースAgent Skills + サンドボックス実行;カスタム Agentデータ分析 Agent思考モードBing / Google 検索API Key 認証Helm Chart韓国語 i18nQdrant。
- **v0.2.0** — Agent モードReACT複数タイプのナレッジベースFAQ + ドキュメント対話戦略設定DuckDuckGo Web 検索MCP ツール統合;新 UI + Agent モード切替MQ 非同期タスク管理。
## 📱 機能デモ
@@ -387,23 +250,6 @@ make dev-frontend
**詳細ドキュメント:** [開発環境クイックスタート](./docs/开发指南.md)
### 📁 プロジェクトディレクトリ構造
```
WeKnora/
├── client/ # Goクライアント
├── cmd/ # アプリケーションエントリ
├── config/ # 設定ファイル
├── docker/ # Dockerイメージファイル
├── docreader/ # 文書解析プロジェクト
├── docs/ # プロジェクトドキュメント
├── frontend/ # フロントエンドプロジェクト
├── internal/ # コアビジネスロジック
├── mcp-server/ # MCPサーバー
├── migrations/ # データベースマイグレーションスクリプト
└── scripts/ # 起動およびツールスクリプト
```
## 🤝 貢献ガイド
[Issue](https://github.com/Tencent/WeKnora/issues) や Pull Request の提出を歓迎します。

View File

@@ -56,155 +56,18 @@ Feishu, Notion, Yuque 등 외부 플랫폼에서 지식 자동 동기화를 지
## ✨ 최신 업데이트
**v0.6.0 하이라이트:**
- **테넌트 RBAC(역할 기반 접근 제어)** — 이번 릴리스의 핵심 기능. WeKnora는 이제 모든 변경 라우트에 대해 4단계 테넌트 역할 매트릭스(`Owner` / `Admin` / `Contributor` / `Viewer`)를 강제하며, `chunk → knowledge → kb → creator_id` 체인으로 KB 단위 리소스 소유권을 구현합니다. Contributor는 자신이 만든 리소스에 대해 완전한 권한, 다른 사람의 리소스는 읽기 전용. Admin은 테넌트 전체를 관리, Owner는 추가로 테넌트 삭제 권한을 가집니다. 자세한 내용은 [`docs/RBAC说明.md`](./docs/RBAC说明.md).
<table>
<tr>
<td width="50%" align="center"><b>테넌트 멤버 관리</b><br/><img src="./docs/images/rbac-member-management.png" alt="테넌트 멤버 관리" width="100%"></td>
<td width="50%" align="center"><b>워크스페이스 전환기</b><br/><img src="./docs/images/rbac-workspace-switcher.png" alt="워크스페이스 전환기" width="100%"></td>
</tr>
<tr>
<td width="50%" align="center"><b>셀프 서비스 워크스페이스 생성</b><br/><img src="./docs/images/rbac-create-workspace.png" alt="워크스페이스 생성" width="100%"></td>
<td width="50%" align="center"><b>보류 중 초대</b><br/><img src="./docs/images/rbac-pending-invitation.png" alt="보류 중 초대" width="100%"></td>
</tr>
</table>
- **테넌트 멤버 관리 및 멀티 워크스페이스 UX**: 멤버 초대 / 삭제 / 역할 변경, `/leave` 엔드포인트, 초대 전용(invite-only) 게이트; 보류 중 초대 다이얼로그 + 글로벌 초대 알림 벨; 사용자 메뉴 내 테넌트 전환기와 역할 인식 UI 가드; 로그인 시 마지막 활성 워크스페이스 자동 복원; 로그인 / 테넌트 전환 시 워크스페이스 컨텍스트가 담긴 풍부한 알림.
- **셀프 서비스 워크스페이스 생성**: 모든 사용자가 자신의 테넌트를 만들 수 있음(환경 변수로 사용자별 상한 제어); 크로스 테넌트 슈퍼 관리자에게는 UI에서 Admin 역할 칩 표시.
- **테넌트별 RBAC 감사 로그**: 모든 RBAC 관련 이벤트를 기록, 일일 리텐션 스윕으로 기본 90일 보관(`created_at` 인덱싱); 크로스 테넌트 슈퍼 관리자 작업은 원본 테넌트에 고정.
- **`weknora` CLI v0.3 / v0.4(GA)**: 프리뷰에서 정식 버전으로 승격, 모든 주요 리소스에 대해 verb-noun 서브트리 커버리지: `agent`(CRUD + invoke / check / status), `chunk`, `session`, `search`(chunks / kb / docs / sessions), `kb`(edit / pin / empty / check / status), `doc`(download / upload --recursive / view / wait), `auth`(refresh / token), `context`, `link / unlink`. 새 `weknora mcp serve`로 큐레이팅된 stdio MCP 서버 제공, Claude Code / Cursor 같은 AI 클라이언트가 WeKnora를 직접 구동 가능. 글로벌 옵션: `--format`, `--json` 필드 선택, `--jq`, `--paginate`, `--all-pages`, `--input`, `--log-level`, `--from-url`, NDJSON 출력, 투명 401 재시도, 시그널 인식 컨텍스트.
- **여러 벡터 저장소에 걸친 KB 검색 팬아웃**: 단일 KB가 여러 벡터 저장소에 바인딩 가능; 검색 엔진이 모든 바인딩된 저장소에 쿼리를 팬아웃하고 결과를 병합. KB 에디터는 create / copy / delete 시 바인딩을 검증해 불일치 상태를 방지.
- **MCP 및 데이터 소스 자격 증명 AES-256-GCM 정적 암호화**: 매끄러운 키 로테이션 지원; API 응답에서 민감 필드 자동 마스킹; 편집 시 자격 증명 손실을 방지하는 새로운 `/credentials` 서브리소스 패턴.
- **Docreader gRPC 하드닝**: app → docreader 연결이 TLS + Token 인증 지원; 기본적으로 docreader gRPC 포트를 호스트에 노출하지 않음; 생성된 proto와 일치시키기 위해 `grpcio` 최소 버전을 1.78.0으로 상향.
- **신규 백엔드 통합**: Zhipu AI 임베더; 화웨이 클라우드 OBS 오브젝트 스토리지; MinerU 문서 파서용 vLLM URL 설정 가능; Apache Doris 호환성 모드 + 모드 전환 가드; docreader URL 화이트리스트(화이트리스트 내 이미지는 재업로드하지 않음).
- **서버 사이드 사용자 환경설정**: 폰트 / 테마 / 메모리 기능 토글을 서버에 영속화; KB 핀 고정을 사용자 단위로(기존 테넌트 전체 공유 모델 대체); KB / Agent 목록에 생성자 이름과 "내가 공유" 라벨 표시.
- **기타 개선**: 사용자 즐겨찾기 + 최근 사용; 멤버용 빠른 탐색 진입점; 사이드바 밀도 리프레시; 테넌트 정보 인라인 편집(description 필드 포함); 지식 문서 태그 선택기 재설계; System Info 페이지에 UI 빌드 버전 표시; Moonshot 모델(`moonshot-v1-*` / `kimi-k2.5` / `k2.6` — 다른 값은 HTTP 400 반환)에 대해 `temperature=1` 강제; MinerU markdown 이미지 구문 과도 이스케이프 수정으로 하류 이미지 추출 정상화; `ErrSessionNotFound` / `ErrKnowledgeBaseNotFound`를 모든 핸들러에서 HTTP 404로 매핑; 세션 액세스를 사용자 단위로 스코프; Go 1.26.0으로 업그레이드.
- **버그 수정**: `Start()` 미호출 시 `audit_log.Stop()` 데드락; 검색 가능한 조직 가입이 초대 코드 만료를 우회하던 문제; 청커가 최상위 헤딩 청크를 병합하던 버그; 무한 스크롤 경쟁으로 문서가 누락되던 문제; 인덱싱 완료된 문서가 즉시 완료되도록; 프론트엔드 오프라인 / 레거시 브라우저 지원; 채팅 히스토리 렌더링 / 페이지네이션 안정성 향상; 기존 모델 테스트 연결 시 저장된 API 키로 폴백.
<details>
<summary><b>이전 릴리스</b></summary>
**v0.5.2 하이라이트:**
- **Wiki 모드 대규모 확장**: Wiki 인제스트가 일반 작업 큐 + 데드레터 큐로 만 건 규모 KB까지 확장; 페이지 링크 그래프에 서브그래프 API + 인터랙티브 탐색 UI 추가.
- **MCP 도구 Human-in-the-Loop 승인**: 민감한 MCP 도구 호출은 Agent를 일시정지시키고 채팅 UI에서 사용자의 명시 승인을 대기.
- **새 LLM / 벡터 DB / 스토리지 / 웹 검색**: Anthropic(Claude), Apache Doris 4.1, Tencent VectorDB, Kingsoft Cloud KS3, SearXNG를 새 백엔드로 추가. Vector Store 관리 UI 및 KB별 인덱싱 전략 토글과 함께 사용 가능.
- **관측 가능성 심화**: Langfuse Span을 retrieval / rerank / agent 단계로 확장; 채팅 스트림 양쪽에서 end-to-end TTFB 기록; LLM 호출 폴백 타임아웃 강화로 worker 풀 영구 차단 방지.
- **적응형 3단계 청킹**: 헤딩 인식 / 휴리스틱 / 재귀 전략으로 자동 라우팅; KB 에디터에 실시간 미리보기 패널 내장. 자세한 내용은 [`docs/CHUNKING.md`](./docs/CHUNKING.md).
- **글로벌 명령 팔레트**: ⌘K 팔레트가 독립 검색 페이지를 대체, 결과에서 바로 새 채팅을 시작 가능.
- **데이터 소스와 모바일**: Yuque 커넥터(전체 + 증분 동기화) 추가, 경량 WeChat 미니프로그램을 `miniprogram/` 에 포함.
- **`weknora` CLI(프리뷰)**: `cli/` 에 공식 명령줄 클라이언트의 초기 버전 포함, 피드백 환영.
- **기타 개선**: 테넌트별 RRF 튜닝; 쿼리 이해 전용 모델; KB 일괄 관리; 사용자 단위 세션 고정과 키워드 검색; 테넌트 전체 IM 채널 개요; 사용자별 저장되는 글꼴 / 테마 설정; 새로운 OpenMaiC 마이크로 클래스룸 Agent 스킬; API 문서 / Swagger / Client SDK 전면 정비.
- **버그 수정**: Embedder가 연결 실패 시 `(nil, nil)` 을 반환해 SIGSEGV를 유발하던 문제 수정; Mimo / DeepSeek 계열 `reasoning_content` 라운드트립 복원; Agent 다중 턴 히스토리를 DB에서 재구성(첨부 replay 포함); OIDC 로그인 수정; Wiki 인제스트 신뢰성 다수 개선; 빈 PDF에서 파일명으로 요약을 환각하지 않도록 수정.
**v0.4.0 하이라이트:**
- **[지식 어시스턴트](https://weknora.weixin.qq.com/platform)**: 클라우드 호스팅 지식 어시스턴트 서비스, 로컬 배포 없이 빠르게 시작 가능
- **WeKnora Cloud**: WeKnora Cloud 프로바이더 통합, LLM 모델 및 문서 파싱 서비스, 자격 증명 관리 및 상태 확인
- **[Chrome 확장 프로그램](https://chromewebstore.google.com/detail/jpemjbopikggjlmikmclgbmkhhopjdgd)**: 브라우저 확장으로 웹페이지 지식 캡처
- **[ClawHub Skill](https://clawhub.ai/lyingbug/weknora)**: ClawHub Skill 마켓플레이스 통합으로 원클릭 스킬 설치
- **WeChat IM 통합**: WeChat 채널 어댑터. QR 코드 로그인 및 롱폴링 메시지 지원
- **첨부파일 처리**: 채팅 파이프라인에서 파일 첨부 지원, 콘텐츠 포맷팅 및 이미지/첨부 메타데이터 주입
- **Azure OpenAI 프로바이더**: Azure OpenAI의 Chat, VLM, Embedding 모델을 완전 지원. 배포 이름 보존 및 dimensions 파라미터 설정 지원
- **Alibaba Cloud OSS 스토리지**: S3 호환 모드를 통한 알리바바 클라우드 OSS 오브젝트 스토리지 지원. 설정 UI, 연결 테스트, 다국어 i18n 제공
- **Notion 커넥터**: Notion 데이터 소스 통합. API 클라이언트, Markdown 렌더러, Connector 인터페이스 구현
- **Baidu & Ollama 웹 검색**: Baidu 및 Ollama를 웹 검색 프로바이더로 추가
- **VectorStore 관리**: 완전한 VectorStore CRUD 기능. 엔티티, 리포지토리, 서비스 레이어, 연결 테스트, API 엔드포인트
- **주요 버그 수정**: Azure OpenAI 엔드포인트 처리, Embedding 잘림, IM 인용 태그 제거, neo4j Go 1.24 Windows 호환성, OSS 서명 문제 수정
**v0.3.6 하이라이트:**
- **ASR(자동 음성 인식)**: ASR 모델 통합으로 오디오 파일 업로드, 문서 내 오디오 미리보기, 음성 전사 기능 지원
- **데이터 소스 자동 동기화(Feishu)**: 완전한 데이터 소스 관리 기능, Feishu Wiki/드라이브 자동 동기화(증분/전체), 동기화 로그 및 테넌트 격리
- **OIDC 인증**: OpenID Connect 로그인 지원, 자동 디스커버리, 커스텀 엔드포인트 설정, 사용자 정보 매핑
- **IM 인용 답장 컨텍스트**: IM 채널에서 인용 메시지를 추출해 LLM 프롬프트에 주입하여 맥락 기반 답변 실현; 비텍스트 인용의 환각 방지 처리
- **IM 스레드 기반 세션**: IM 채널(Slack, Mattermost, Feishu, Telegram)에서 스레드 단위 세션 모드를 지원, 스레드 내 다중 사용자 협업
- **문서 자동 요약**: AI 생성 문서 요약, 최대 입력 크기 설정 가능, 문서 상세 페이지에 전용 요약 섹션
- **Tavily 웹 검색**: Tavily를 새로운 웹 검색 프로바이더로 추가; 웹 검색 프로바이더 아키텍처를 확장성 향상을 위해 리팩토링
- **MCP 자동 재연결**: 서버 연결 끊김 시 MCP 도구 호출 자동 재연결 로직
- **병렬 도구 호출**: Agent 모드에서 errgroup을 사용한 다중 도구 호출 병렬 실행으로 복잡한 작업 처리 속도 향상
- **Agent @멘션 범위 제한**: 사용자 @멘션을 Agent 허용 지식베이스 범위로 제한하여 무단 접근 방지
- **로그인 페이지 성능**: backdrop-filter blur 전체 제거, 애니메이션 요소 축소, GPU 합성 힌트 추가
**v0.3.5 하이라이트:**
- **Telegram, DingTalk & Mattermost IM 통합**: Telegram 봇(webhook/롱폴링, editMessageText 스트리밍), DingTalk 봇(webhook/Stream 모드, AI 카드 스트리밍), Mattermost 어댑터를 신규 추가. IM 채널이 기업WeChat, Feishu, Slack, Telegram, DingTalk, Mattermost 6개 플랫폼으로 확대
- **IM 슬래시 커맨드 및 QA 큐**: 플러그인 방식 슬래시 커맨드 프레임워크(/help, /info, /search, /stop, /clear), 유계 QA 워커 풀, 사용자별 레이트 리밋, Redis 기반 멀티 인스턴스 분산 조정
- **추천 질문**: Agent가 연결된 지식베이스를 기반으로 컨텍스트 맞춤 추천 질문을 자동 생성해 채팅 화면에 표시; 이미지 지식은 질문 생성 작업을 자동 큐 등록
- **VLM을 통한 MCP 도구 이미지 자동 설명**: MCP 도구가 이미지를 반환하면 설정된 VLM 모델로 텍스트 설명을 자동 생성해 텍스트 전용 LLM에서도 이미지 내용 활용 가능
- **Novita AI 프로바이더**: OpenAI 호환 API로 chat, embedding, VLLM 모델 타입을 지원하는 신규 LLM 프로바이더
- **MCP 도구명 안정성**: UUID 대신 service.Name 기반 도구명(재연결 후에도 안정), 고유명 제약 및 충돌 방지 추가; 프론트엔드에서 snake_case를 사람이 읽기 쉬운 형태로 변환
- **채널 추적**: 지식 항목과 메시지에 channel 필드 추가(web/api/im/browser_extension)로 출처 추적 가능
- **주요 버그 수정**: 지식베이스 미설정 시 Agent 빈 응답, 한국어/이모지 문서 요약의 UTF-8 잘림, 테넌트 설정 업데이트 시 API 키 암호화 손실, vLLM 스트리밍 추론 콘텐츠 누락, Rerank 빈 패시지 오류 수정
**v0.3.4 하이라이트:**
- **IM 봇 통합**: 기업WeChat, Feishu, Slack IM 채널 지원, WebSocket/Webhook 모드, 스트리밍 및 지식베이스 통합
- **멀티모달 이미지 지원**: 이미지 업로드 및 멀티모달 이미지 처리, 세션 관리 강화
- **수동 지식 다운로드**: 수동 지식 콘텐츠를 파일로 다운로드, 파일명 정리 및 포맷 처리
- **NVIDIA 모델 API**: NVIDIA 채팅 모델 API 지원, 커스텀 엔드포인트 및 VLM 모델 설정
- **Weaviate 벡터 데이터베이스**: 지식 검색을 위한 Weaviate 벡터 데이터베이스 백엔드 추가
- **AWS S3 스토리지**: AWS S3 스토리지 어댑터 통합, 설정 UI 및 데이터베이스 마이그레이션
- **AES-256-GCM 암호화**: API 키를 AES-256-GCM으로 정적 암호화하여 보안 강화
- **내장 MCP 서비스**: 내장 MCP 서비스 지원으로 Agent 기능 확장
- **하이브리드 검색 최적화**: 타겟 그룹화 및 쿼리 임베딩 재사용으로 검색 성능 향상
- **Final Answer 도구**: 새로운 final_answer 도구 및 Agent 소요 시간 추적으로 워크플로우 개선
**v0.3.3 하이라이트:**
- **부모-자식 청킹**: 계층적 부모-자식 청킹 전략으로 컨텍스트 관리 및 검색 정확도 강화
- **지식베이스 고정**: 자주 사용하는 지식베이스를 고정하여 빠른 접근 지원
- **폴백 응답**: 관련 결과가 없을 때 폴백 응답 처리 및 UI 표시기
- **Rerank 패시지 클리닝**: Rerank 모델의 패시지 클리닝 기능으로 관련성 점수 정확도 향상
- **버킷 자동 생성**: 스토리지 엔진 연결 확인 강화, 버킷 자동 생성 지원
- **Milvus 벡터 데이터베이스**: 지식 검색을 위한 Milvus 벡터 데이터베이스 백엔드 추가
**v0.3.2 하이라이트:**
- 🔍 **지식 검색**: 시맨틱 검색을 지원하는 새로운 "지식 검색" 진입점, 검색 결과를 대화 창으로 바로 가져오기 지원
- ⚙️ **파서 및 스토리지 엔진 설정**: 설정에서 소스별 문서 파서 엔진과 스토리지 엔진 구성 가능, 지식베이스에서 파일 타입별 파서 선택 지원
- 🖼️ **로컬 스토리지 이미지 렌더링**: 로컬 스토리지 모드에서 대화 중 이미지 렌더링 지원, 스트리밍 이미지 플레이스홀더 최적화
- 📄 **문서 미리보기**: 사용자가 업로드한 원본 파일을 미리 볼 수 있는 내장 문서 미리보기 컴포넌트
- 🎨 **UI 최적화**: 지식베이스, 에이전트, 공유 공간 목록 페이지 인터랙션 개편
- 🗄️ **Milvus 지원**: 지식 검색을 위한 Milvus 벡터 데이터베이스 백엔드 추가
- 🌋 **Volcengine TOS**: Volcengine TOS 오브젝트 스토리지 지원 추가
- 📊 **Mermaid 렌더링**: 채팅에서 Mermaid 다이어그램 렌더링 지원, 전체 화면 뷰어/줌/내비게이션/내보내기 기능 포함
- 💬 **대화 일괄 관리**: 일괄 관리 및 전체 세션 삭제 기능
- 🔗 **원격 URL 지식**: 원격 파일 URL로 지식 항목 생성 지원
- 🧠 **메모리 그래프 미리보기**: 사용자 레벨 메모리 그래프 시각화 미리보기
- 🔄 **비동기 재파싱**: 기존 지식 문서를 비동기로 재처리하는 API
**v0.3.0 하이라이트:**
- 🏢 **공유 공간**: 멤버 초대, 멤버 간 지식베이스/에이전트 공유, 테넌트 격리 검색을 지원하는 공유 공간
- 🧩 **Agent Skills**: 스마트 추론 에이전트를 위한 사전 로드 스킬과 샌드박스 기반 보안 격리 실행 환경 제공
- 🤖 **커스텀 에이전트**: 지식베이스 선택 모드(전체/지정/비활성화)와 함께 커스텀 에이전트 생성, 설정, 선택 지원
- 📊 **데이터 분석 에이전트**: 내장 데이터 분석 에이전트, CSV/Excel 분석용 DataSchema 도구
- 🧠 **사고 모드**: LLM과 에이전트의 사고 모드 지원 및 사고 내용 지능형 필터링
- 🔍 **웹 검색 제공자**: DuckDuckGo 외에 Bing, Google 검색 제공자 추가
- 📋 **FAQ 강화**: 일괄 임포트 드라이런, 유사 질문, 검색 결과 매칭 질문 필드, 대량 임포트 오브젝트 스토리지 오프로드
- 🔑 **API Key 인증**: API Key 인증 메커니즘, Swagger 문서 보안 설정
- 📎 **입력창 내 선택**: 입력창에서 지식베이스와 파일을 직접 선택, @멘션 표시
- ☸️ **Helm Chart**: Neo4j GraphRAG 지원을 포함한 Kubernetes 배포용 완전한 Helm Chart 제공
- 🌍 **국제화**: 한국어(한국어) 지원 추가
- 🔒 **보안 강화**: SSRF 안전 HTTP 클라이언트, 향상된 SQL 검증, MCP stdio 전송 보안, 샌드박스 기반 실행
-**인프라**: Qdrant 벡터 데이터베이스 지원, Redis ACL, 로그 레벨 설정, Ollama 임베딩 최적화, `DISABLE_REGISTRATION` 제어
**v0.2.0 하이라이트:**
- 🤖 **Agent 모드**: 내장 도구, MCP 도구, 웹 검색을 호출할 수 있는 새로운 ReACT Agent 모드 추가. 다중 반복 및 리플렉션을 통해 종합 요약 리포트 제공
- 📚 **다중 지식베이스 타입**: FAQ/문서 지식베이스 타입 지원 및 폴더 임포트, URL 임포트, 태그 관리, 온라인 입력 기능 추가
- ⚙️ **대화 전략**: Agent 모델, 일반 모드 모델, 검색 임계값, 프롬프트 설정 지원. 멀티턴 대화 동작을 정밀 제어
- 🌐 **웹 검색**: 확장 가능한 웹 검색 엔진 지원, DuckDuckGo 검색 엔진 내장
- 🔌 **MCP 도구 통합**: MCP를 통한 Agent 기능 확장 지원, uvx/npx 런처 내장, 다양한 전송 방식 지원
- 🎨 **새 UI**: Agent/일반 모드 전환, 도구 호출 과정 표시, 지식베이스 관리 인터페이스 전면 개선
-**인프라 업그레이드**: MQ 비동기 작업 관리 도입, 자동 DB 마이그레이션 및 고속 개발 모드 지원
</details>
- **v0.6.0** — 테넌트 RBAC(4단계 역할 매트릭스 `Owner` / `Admin` / `Contributor` / `Viewer` + KB 단위 소유 + 테넌트별 감사 로그), 테넌트 멤버 관리와 멀티 워크스페이스 UX, 셀프 서비스 워크스페이스 생성; `weknora` CLI v0.4 GA + `mcp serve`; 여러 벡터 저장소에 걸친 KB 검색 팬아웃; MCP / 데이터 소스 자격 증명 AES-256-GCM 암호화 + docreader gRPC TLS + Token; Zhipu 임베더와 화웨이 클라우드 OBS 추가; 서버 사이드 사용자 환경설정; Go 1.26.0. 자세한 내용은 [`docs/RBAC说明.md`](./docs/RBAC说明.md)과 [`CHANGELOG.md`](./CHANGELOG.md) 참고.
- **v0.5.2** — Wiki 인제스트가 만 건 규모 KB 지원(작업 큐 + DLQ); MCP 휴먼인더루프 도구 승인; Anthropic / Apache Doris / Tencent VectorDB / Kingsoft Cloud KS3 / SearXNG 백엔드; 적응형 3단계 청킹 + 라이브 미리보기; 글로벌 ⌘K 명령 팔레트; Yuque 커넥터 + WeChat 미니프로그램; `weknora` CLI 프리뷰.
- **v0.5.1** — 지식베이스 일괄 관리; 테넌트 전체 IM 채널 개요; 세션 검색 + 사용자 단위 핀; 모델 / 웹 검색 / MCP 통일 카드 설정; Agent별 LLM 타임아웃; 데스크탑 테넌트 전환.
- **v0.5.0** — Wiki 모드 GA — Agent가 원본 문서에서 구조화·상호 연결된 Markdown Wiki 페이지와 지식 그래프 자동 생성, Wiki 브라우저 및 시각화 그래프를 UI에 탑재.
- **v0.4.0** — WeKnora Cloud(호스팅 LLM + 파싱); Chrome 확장 프로그램; ClawHub Skill; WeChat IM; 첨부 처리; Azure OpenAI / Alibaba OSS; Notion 커넥터; Baidu + Ollama 웹 검색; VectorStore 관리.
- **v0.3.6** — ASR(음성); Feishu 데이터 소스 자동 동기화; OIDC; IM 인용 회신 + 스레드 기반 세션; 문서 자동 요약; Tavily 검색; 병렬 도구 호출; Agent @멘션 범위 제한.
- **v0.3.5** — Telegram / DingTalk / Mattermost IM; IM 슬래시 커맨드 + QA 큐; 추천 질문; VLM에 의한 MCP 도구 이미지 자동 설명; Novita AI; 채널 추적.
- **v0.3.4** — 기업 WeChat / Feishu / Slack IM; 멀티모달 이미지; NVIDIA 모델 API; Weaviate; AWS S3; AES-256-GCM API 키 암호화; 내장 MCP 서비스; 하이브리드 검색 최적화; `final_answer` 도구.
- **v0.3.3** — 부모-자식 청킹; KB 핀; 폴백 응답; Rerank 패시지 클리닝; 스토리지 버킷 자동 생성; Milvus.
- **v0.3.2** — 지식 검색 진입점; 소스별 파서 / 스토리지 엔진 설정; 로컬 스토리지 이미지 렌더링; 문서 미리보기; Volcengine TOS; Mermaid 렌더링; 대화 일괄 관리; 메모리 그래프 미리보기.
- **v0.3.0** — 공유 스페이스; Agent Skills + 샌드박스 실행; 커스텀 Agent; 데이터 분석 Agent; 사고 모드; Bing / Google 검색; API Key 인증; Helm Chart; 한국어 i18n; Qdrant.
- **v0.2.0** — Agent 모드(ReACT); 다중 타입 지식베이스(FAQ + 문서); 대화 전략 설정; DuckDuckGo 웹 검색; MCP 도구 통합; 새 UI + Agent 모드 전환; MQ 비동기 작업 관리.
## 📱 기능 데모
@@ -396,23 +259,6 @@ make dev-frontend
**상세 문서:** [개발 환경 빠른 시작](./docs/开发指南.md)
### 📁 디렉터리 구조
```
WeKnora/
├── client/ # go client
├── cmd/ # Main entry point
├── config/ # Configuration files
├── docker/ # docker images files
├── docreader/ # Document parsing app
├── docs/ # Project documentation
├── frontend/ # Frontend app
├── internal/ # Core business logic
├── mcp-server/ # MCP server
├── migrations/ # DB migration scripts
└── scripts/ # Shell scripts
```
## 🤝 기여하기
[Issue](https://github.com/Tencent/WeKnora/issues) 또는 Pull Request를 환영합니다.