docs: date the v0.8.2 release and describe it in the READMEs

Move the CHANGELOG and release-notes date to 2026-09-24. In all four
READMEs, add the v0.8.2 entry to Latest Updates and bring the overview
and feature tables up to date: local browser, built-in MCP Server,
conversation control, artifacts library, sandbox terminal and desktop,
Lite host sandbox, model catalog, Confluence, Bocha / Serply, UI
languages and whitelist-only outbound. The MCP Server section now points
to the built-in server and marks the Python one deprecated.
main
wizardchen 2026-09-24 12:00:33 +08:00 committed by lyingbug
parent 5468e7c191
commit 9f57bbe4da
6 changed files with 64 additions and 48 deletions

View File

@ -2,7 +2,7 @@
All notable changes to this project will be documented in this file.
## [0.8.2] - 2026-09-23
## [0.8.2] - 2026-09-24
### New Features

View File

@ -57,13 +57,14 @@ https://github.com/user-attachments/assets/19b28ce2-a62f-4f54-b289-c983576259bc
*2:25 · 1080p · English narration & captions.*
It is organized around three core capabilities: **RAG-based Quick Q&A** for everyday lookups, a **ReAct Agent** that autonomously orchestrates retrieval, MCP tools, a **tenant skill catalog**, session-persistent **Docker / E2B / Cube sandboxes** and web search to handle complex multi-step tasks, and a brand-new **Wiki Mode** in which agents distill raw documents into a self-maintaining, interlinked markdown knowledge base with an interactive knowledge graph, complete with manual editing, revision history and one-click rollback. **Cross-session long-term memory** remembers who you are and what you keep asking about. Knowledge curation is equally hands-on: a **tree-structured folder view** preserves the directory layout of uploads, and **chunk editing with revision history** lets retrieval chunks be edited, diffed and reverted like documents. Combined with multi-source ingestion (Feishu wiki / Feishu Drive / GitLab / Tencent IMA / Notion / Yuque / DingTalk Docs / RSS, and growing), **website embed widgets** for publishing agents to external sites, **scoped API keys with a principal model** for programmatic integrations, **multi-instance storage backends** per workspace for flexible data placement, 20+ LLM provider integrations (including LiteLLM), full Langfuse observability plus a **runtime task-queue dashboard with worker-pool governance**, **enterprise-ready multi-workspace RBAC** (4-tier role matrix + per-resource ownership + per-workspace audit log), and a fully self-hostable modular architecture, WeKnora turns scattered documents into a queryable, reasoning-capable, continuously evolving knowledge asset.
It is organized around three core capabilities: **RAG-based Quick Q&A** for everyday lookups, a **ReAct Agent** that autonomously orchestrates retrieval, MCP tools, a **tenant skill catalog**, session-persistent **Docker / E2B / Cube sandboxes**, the user's own browser via **BrowserSkill** and web search to handle complex multi-step tasks, and a brand-new **Wiki Mode** in which agents distill raw documents into a self-maintaining, interlinked markdown knowledge base with an interactive knowledge graph, complete with manual editing, revision history and one-click rollback. **Cross-session long-term memory** remembers who you are and what you keep asking about. Knowledge curation is equally hands-on: a **tree-structured folder view** preserves the directory layout of uploads, and **chunk editing with revision history** lets retrieval chunks be edited, diffed and reverted like documents. Combined with multi-source ingestion (Feishu wiki / Feishu Drive / Confluence / GitLab / Tencent IMA / Notion / Yuque / DingTalk Docs / RSS, and growing), **website embed widgets** for publishing agents to external sites, a **built-in MCP Server** that publishes knowledge bases to Cursor, Claude and other AI tools, **scoped API keys with a principal model** for programmatic integrations, **multi-instance storage backends** per workspace for flexible data placement, 27 built-in model vendors backed by a generated model catalog (including LiteLLM), full Langfuse observability plus a **runtime task-queue dashboard with worker-pool governance**, **enterprise-ready multi-workspace RBAC** (4-tier role matrix + per-resource ownership + per-workspace audit log), and a fully self-hostable modular architecture, WeKnora turns scattered documents into a queryable, reasoning-capable, continuously evolving knowledge asset.
The framework supports auto-syncing knowledge from Feishu, GitLab, Tencent IMA, Notion, and Yuque (more data sources coming soon), handles 10+ document formats including PDF, Word, images, Excel and XMind, and can serve Q&A directly through IM channels like WeCom, Feishu, Slack, and Telegram. It is compatible with major LLM providers including OpenAI, DeepSeek, Qwen (Alibaba Cloud), Zhipu, Hunyuan, Gemini, MiniMax, NVIDIA, LiteLLM, and Ollama. Office files can be parsed in-process with **anydoc**. Its fully modular design allows swapping LLMs, vector databases, and storage backends, with support for local and private cloud deployment ensuring complete data sovereignty. WeKnora also integrates with **Langfuse** for comprehensive observability into agent reasoning, token usage, and pipeline tracing.
The framework supports auto-syncing knowledge from Feishu, Confluence, DingTalk Docs, GitLab, Tencent IMA, Notion, and Yuque (more data sources coming soon), handles 10+ document formats including PDF, Word, images, Excel and XMind, and can serve Q&A directly through IM channels like WeCom, Feishu, Slack, and Telegram. It is compatible with major LLM providers including OpenAI, DeepSeek, Qwen (Alibaba Cloud), Zhipu, Hunyuan, Gemini, MiniMax, NVIDIA, LiteLLM, and Ollama. Office files can be parsed in-process with **anydoc**. Its fully modular design allows swapping LLMs, vector databases, and storage backends, with support for local and private cloud deployment ensuring complete data sovereignty. WeKnora also integrates with **Langfuse** for comprehensive observability into agent reasoning, token usage, and pipeline tracing.
## ✨ Latest Updates
- **v0.8.2** — **Local Browser (BrowserSkill)**: agents drive the user's own Chrome / Edge through the open-source BrowserSkill extension, with a live task preview, pause / resume and hand-off for logins and CAPTCHAs; **built-in MCP Server** (per-workspace `/mcp/<endpoint_id>` endpoints over Streamable HTTP, each with its own token, knowledge-base scope, rate limit and tool groups; the Python `mcp-server/` is deprecated); a sidebar **Toolbox** for skills, MCP services and the browser connection; **conversation control** (append requirements to a running turn, fork from any earlier question, rewind in place with sandbox checkpoints, per-session reasoning effort); **artifacts library**; sandbox **interactive terminal** and **graphical desktop**; macOS **Lite host sandbox** with project folders; rebuilt **model catalog** (27 built-in vendors with generated context-window, max-output, reasoning and vision metadata); agent retrieval tools consolidated into `search_knowledge` / `read_document` / `list_documents`; Confluence and DingTalk Docs data sources; Bocha and Serply web search; Japanese UI; per-channel IM reply language; whitelist-only outbound mode. Breaking: DingTalk channels are Stream-only, and sandbox commands run as `root`. See [`CHANGELOG.md`](./CHANGELOG.md).
- **v0.8.0** — **Skill sandbox runtime** (session-persistent Docker / E2B / Cube backends with per-tenant network policy; Local host-process backend removed; Docker opt-in); **tenant skill catalog** (install from ClawHub / SkillHub / git / zip, per-sandbox snapshots, live progress, file browse/edit, personal and workspace env vars); **cross-session long-term memory** (profile / preference / fact / task / interest, auto-extract with confirm, `search_memory`); **in-process anydoc office parser**; official **DeepSeek Harness plugin** `@wxg-prc-cpg/dsh-weknora`; GitLab and Tencent IMA data sources; LiteLLM; Exa and Metaso web search; XMind parsing; chat artifacts, question outline and timestamps; context compaction and provider prompt-cache markers. Plus OIDC JWKS verification, optional complex passwords, document auto-tagging, and broad sandbox/security hardening. See [`CHANGELOG.md`](./CHANGELOG.md).
- **v0.7.2** — Launched the **official product documentation site** (VitePress; six sections, ~50 pages covering ~360 API endpoints and ~150 environment variables, with standalone Docker/Nginx deployment, quickstart sample data and a local MCP demo); **knowledge base folder tree** (upload paths stored as first-class data, browse/rename/re-file documents like a file manager); **chunk editing with revision history** (edit retrieval chunks in the UI, per-version diff and rollback, automatic reindexing, plus custom document metadata); **Wiki page revision history** (snapshots + line-level diff + one-click rollback + in-browser manual editing); **directly loadable file URLs** via `resource_urls=public` / `RESOURCE_URL_MODE` (third-party apps render images and files without a second authenticated proxy call); **Feishu Drive data source** and docx sync through the blocks API; batch document tagging; **MCP Server 1.1.x** (migrated to the mcp 2.x high-level API, official PyPI package `tencent-weknora-mcp`, new `create_knowledge_from_text` and `list_shared_knowledge_bases` for 29 tools total); AWS S3 default credential chain (IAM Role / IRSA); local HTML upload parsing; QQBot markdown replies; new PR CI checks for app / frontend / docreader / mcp-server. Plus large-scale router and `modelcontext` refactors, rerank and chunking quality work, and broad stability fixes. See [`CHANGELOG.md`](./CHANGELOG.md).
- **v0.7.1** — New **Yunzhijia (云之家) IM integration** (WebSocket + image messages + markdown replies); **Volcengine rerank** provider (with request batching) and **Zhipu AI web search** provider; **platform-scoped API keys** for control-plane automation (tenant management, system settings, runtime queues, audit logs); **per-KB activity audit trail**; FAQ management enhancements (filtering, tagging, export, import tracking); **Langfuse OTLP/OTel tracing** migration with W3C traceparent propagation; chat header actions with one-click **Markdown export** and wiki tool results in the references drawer; prompt-cache observability; session channel governance (admin-scoped IM/embed/API sessions); resilient Feishu large-wiki sync; and removal of the legacy Neo4j conversation-memory dependency. Plus broad slug-integrity, SSRF-transport, and state-sync hardening. See [`CHANGELOG.md`](./CHANGELOG.md).
@ -124,12 +125,15 @@ Fully modular pipeline from document parsing, vectorization, and retrieval to LL
| Capability | Details |
|------------|---------|
| Intelligent Reasoning | ReACT progressive multi-step reasoning, autonomously orchestrating knowledge retrieval, MCP tools, skill sandboxes, and web search |
| Intelligent Reasoning | ReACT progressive multi-step reasoning, autonomously orchestrating knowledge retrieval, MCP tools, skill sandboxes, the local browser, and web search |
| Quick Q&A | RAG-based Q&A over knowledge bases for fast and accurate answers |
| Wiki Mode | Agent-driven auto-generation of structured, interlinked markdown Wiki pages from raw documents; in-browser manual editing, page revision history, line-level diff and one-click rollback |
| Skill Catalog & Sandbox | Workspace skill catalog (ClawHub / SkillHub / git / zip) installed onto session-persistent Docker / E2B / Cube sandboxes; `shell_exec`, file tools, artifacts, per-config network policy; Local host-process backend removed |
| Skill Catalog & Sandbox | Workspace skill catalog (ClawHub / SkillHub / git / zip) installed onto session-persistent Docker / E2B / Cube sandboxes; `shell_exec`, file tools, artifacts, per-config network policy; Local host-process backend removed; an interactive terminal and a browser-based graphical desktop beside the chat; the macOS desktop app runs sessions in an OS sandbox (Seatbelt) bound to a project folder |
| Local Browser | Agents drive the user's own Chrome / Edge through the open-source BrowserSkill extension in a dedicated task window (open pages, click, fill forms, read content), with a live preview, pause / resume / end, and hand-off to the user for logins and CAPTCHAs |
| Conversation Control | Append requirements to a running turn, fork a conversation from any earlier question, rewind in place (resetting the sandbox workspace to the matching checkpoint), and choose reasoning effort per session |
| Artifacts Library | A sidebar page listing every generated file across conversations, with type filters, search, date grouping and version history |
| Long-term Memory | Cross-session memory (profile / preference / fact / task / interest) with auto-extract, user confirm, and on-demand `search_memory` |
| Tool Calling | Built-in tools, MCP tools (incl. OAuth2 remote services, mid-conversation OAuth), web search; `@Skill / @MCP` mentions to scope the agent runtime per turn |
| Tool Calling | Built-in tools, MCP tools (incl. OAuth2 remote services, mid-conversation OAuth), web search; `@Skill / @MCP` mentions to scope the agent runtime per turn; MCP tools are discovered and called on demand and can be enabled per tool |
| Conversation Strategy | Online Prompt editing, retrieval threshold tuning, multi-turn context awareness, per-agent citation output toggle |
| Suggested Questions | Auto-generated question suggestions and after-answer follow-ups based on knowledge base content |
| Temporary Attachments | Session-scoped image / document uploads with async parsing for one-off Q&A, with a combined image + attachment limit |
@ -145,7 +149,7 @@ Fully modular pipeline from document parsing, vectorization, and retrieval to LL
| Chunk Editing & Revisions | Edit retrieval chunks directly in the UI with per-version snapshots, diff and one-click rollback, and automatic reindexing after an edit; generated questions can be added, edited, deleted and regenerated; custom document metadata supported |
| Per-Upload Process Config | Override parser, chunking, multimodal (VLM / ASR), graph extraction, and question generation per upload batch via upload-confirm dialog or `process_config` API; reparse with new settings |
| Batch Reparse | Re-queue parsing for multiple documents at once with optional per-batch `process_config` |
| Data Source Import | Auto-sync from Feishu wiki / Feishu Drive / Lark / GitLab / Tencent IMA / Notion / Yuque / DingTalk Docs / RSS feeds (more data sources coming soon); incremental and full sync |
| Data Source Import | Auto-sync from Feishu wiki / Feishu Drive / Lark / Confluence / GitLab / Tencent IMA / Notion / Yuque / DingTalk Docs / RSS feeds (more data sources coming soon); incremental and full sync |
| Document Formats | PDF / Word / Txt / Markdown / HTML / EPUB / MHTML / Images / CSV / Excel / PPT / JSON / XMind |
| Auto-Tagging | After parse, pick matching tags from the knowledge base's existing set without creating tags or overwriting manual ones |
| Retrieval Strategies | BM25 sparse / Dense retrieval / GraphRAG / parent-child chunking / HNSW-accelerated pgvector (1024-dim) / multi-dimensional indexing |
@ -162,21 +166,21 @@ Fully modular pipeline from document parsing, vectorization, and retrieval to LL
| Object Storage | Local / MinIO / AWS S3 (IAM Role / IRSA default credential chain) / Volcengine TOS / Alibaba Cloud OSS / Kingsoft Cloud KS3 / Huawei Cloud OBS; **multiple storage instances per workspace** with per-KB binding and a default instance |
| IM Channels | WeCom / Feishu / Lark (Feishu International) / QQBot / Slack / Telegram / DingTalk / Mattermost / WeChat / Yunzhijia |
| Website Embed | Publish agents via embed widget with domain allowlists, rate limits, and secure-mode token exchange |
| Web Search | DuckDuckGo / Bing / Google / Tavily / Baidu / Ollama / SearXNG / Keenable / Zhipu AI / Exa / Metaso |
| Web Search | DuckDuckGo / Bing / Google / Tavily / Baidu / Ollama / SearXNG / Keenable / Zhipu AI / Exa / Metaso / Bocha / Serply |
| API Integration | Scoped API keys (capability-level grants + per-KB restriction + throttled last-used tracking) with an API integration playground; MCP OAuth and embed sessions isolated per principal; `resource_urls=public` returns directly loadable file/image URLs, removing the second authenticated proxy call |
| MCP Server | Official PyPI package `tencent-weknora-mcp` with 29 tools over stdio / SSE / HTTP transports |
| MCP Server | Built in: publish per-workspace endpoints at `/mcp/<endpoint_id>` (Streamable HTTP), each with its own token, knowledge-base scope, rate limit and tool groups (retrieval, `ask`, Wiki, opt-in write tools); the Python `tencent-weknora-mcp` package is deprecated |
**Platform**
| Capability | Details |
|------------|---------|
| Deployment | Local / Docker / Kubernetes (Helm) with private and offline support |
| UI | Web UI / RESTful API / CLI (`weknora`) / Chrome Extension / Website Embed Widget / WeChat Mini Program |
| UI | Web UI / RESTful API / CLI (`weknora`) / Chrome Extension / Website Embed Widget / WeChat Mini Program; UI in Chinese / English / Japanese / Korean / Russian |
| Access Control | Workspace RBAC with 4-tier role matrix (Owner / Admin / Contributor / Viewer), per-KB resource ownership, per-workspace audit log, invite-only workspaces, tenantless provisioning & gated self-service workspace creation, admin password reset (session revocation), cross-workspace superuser, scoped API keys |
| Security | AES-256-GCM at-rest encryption for API keys and MCP / data-source credentials with graceful key rotation; gRPC TLS + Token between app and docreader; Redis TLS; SSRF-safe HTTP client (data sources, URL import, redirect chains); secret redaction in responses; skill sandbox isolation (Docker opt-in / E2B / Cube) with per-config network policy; OIDC ID-token JWKS verification; optional complex-password policy |
| Security | AES-256-GCM at-rest encryption for API keys and MCP / data-source credentials with graceful key rotation; gRPC TLS + Token between app and docreader; Redis TLS; SSRF-safe HTTP client (data sources, URL import, redirect chains); secret redaction in responses; skill sandbox isolation (Docker opt-in / E2B / Cube) with per-config network policy; OIDC ID-token JWKS verification; optional complex-password policy; whitelist-only outbound mode (`SSRF_DNS_WHITELIST_ONLY`) |
| Observability | Integrated Langfuse (sole tracing backend) for ReAct loops, token tracking, tool calls, and pipeline tracing; built-in Langfuse-style document parsing trace timeline with stage-by-stage progress; system-admin runtime task-queue dashboard (queue depth, per-model concurrency, failed-task inspection & manual retry) |
| Task Management | MQ async tasks with per-stage worker-pool governance (core / post-process / enrichment / maintenance + elastic shared pool, plus an independent Wiki pool) and per-model background concurrency governors; automatic database migration on version upgrade |
| Model Management | Centralized config, declarative built-in models via YAML, per-knowledge-base model selection, per-model thinking-mode and embedding-dimension overrides, interactive model test debugger, multi-workspace built-in model sharing, WeKnora Cloud hosted models and parsing |
| Model Management | Centralized config, declarative built-in models via YAML, per-knowledge-base model selection, per-model thinking-mode and embedding-dimension overrides, interactive model test debugger, multi-workspace built-in model sharing, WeKnora Cloud hosted models and parsing; a generated model catalog fills context window, max output, reasoning levels and vision support, with a resolved-call preview and per-model protocol override |
## 🧩 Chrome Extension
@ -289,7 +293,7 @@ Stop services: `docker compose down`
## MCP Server
Please refer to the [MCP Configuration Guide](./mcp-server/MCP_CONFIG.md) for the necessary setup.
WeKnora has a built-in MCP Server: create an endpoint under Settings → Publish & Integrations → MCP Server and connect clients over Streamable HTTP at `/mcp/<endpoint_id>`. See the [MCP guide](./website-docs/03-features/08-mcp.md). The standalone Python server in [`mcp-server/`](./mcp-server/MCP_CONFIG.md) is deprecated and kept only for existing deployments.
## 🔌 Using WeChat Dialog Open Platform

View File

@ -57,12 +57,13 @@ https://github.com/user-attachments/assets/2819598d-3140-4623-814a-8162a22b653c
*2 分 25 秒 · 1080p · 英文旁白,中英字幕。*
框架围绕三大核心能力构建:**RAG 快速问答**适合日常知识查询,**ReAct Agent 智能推理**自主编排知识检索、MCP 工具、**技能目录**、会话级 **Docker / E2B / Cube 沙箱**与网络搜索完成复杂多步任务,全新的 **Wiki 模式**则让 Agent 从原始文档中自治生成相互链接的 Markdown 知识库与可视化知识图谱,并支持人工编辑、版本历史与一键回滚。**跨会话长期记忆**会记住你是谁、你常问什么。知识加工环节也完全可控:**树形文件夹**保留上传目录结构,**分块编辑与版本历史**让检索片段可以像文档一样被修改、比对与回滚。结合多源数据接入(飞书知识库 / 飞书云盘 / GitLab / 腾讯 IMA / Notion / 语雀 / 钉钉文档 / RSS,更多持续接入中)、**网站嵌入 Widget** 将智能体发布到外部站点、**权限范围 API Key 与 Principal 模型**面向程序化集成、**每空间多实例存储后端**灵活编排数据落地、二十余家主流模型厂商集成(含 LiteLLM)、Langfuse 全链路可观测性与**运行时任务队列面板 + Worker 池治理**、**企业级多空间 RBAC(四级角色矩阵 + 资源归属 + 空间审计日志)**,以及完全可私有化部署的模块化架构,WeKnora 帮助团队把分散文档沉淀为可查询、可推理、可持续演进的专属知识资产。
框架围绕三大核心能力构建:**RAG 快速问答**适合日常知识查询,**ReAct Agent 智能推理**自主编排知识检索、MCP 工具、**技能目录**、会话级 **Docker / E2B / Cube 沙箱**、通过 **BrowserSkill** 操作用户本机浏览器与网络搜索完成复杂多步任务,全新的 **Wiki 模式**则让 Agent 从原始文档中自治生成相互链接的 Markdown 知识库与可视化知识图谱,并支持人工编辑、版本历史与一键回滚。**跨会话长期记忆**会记住你是谁、你常问什么。知识加工环节也完全可控:**树形文件夹**保留上传目录结构,**分块编辑与版本历史**让检索片段可以像文档一样被修改、比对与回滚。结合多源数据接入(飞书知识库 / 飞书云盘 / Confluence / GitLab / 腾讯 IMA / Notion / 语雀 / 钉钉文档 / RSS,更多持续接入中)、**网站嵌入 Widget** 将智能体发布到外部站点、**内置 MCP Server** 把知识库开放给 Cursor、Claude 等 AI 工具、**权限范围 API Key 与 Principal 模型**面向程序化集成、**每空间多实例存储后端**灵活编排数据落地、27 家内置模型厂商与自动生成的模型目录(含 LiteLLM)、Langfuse 全链路可观测性与**运行时任务队列面板 + Worker 池治理**、**企业级多空间 RBAC(四级角色矩阵 + 资源归属 + 空间审计日志)**,以及完全可私有化部署的模块化架构,WeKnora 帮助团队把分散文档沉淀为可查询、可推理、可持续演进的专属知识资产。
框架支持从飞书、GitLab、腾讯 IMA、Notion 及语雀等外部平台自动同步知识(更多数据源持续接入中),覆盖 PDF、Word、图片、Excel、XMind 等十余种文档格式,并可通过企业微信、飞书、Slack、Telegram 等 IM 频道直接提供问答服务。模型层面兼容 OpenAI、DeepSeek、Qwen(阿里云)、智谱、混元、Gemini、MiniMax、NVIDIA、LiteLLM、Ollama 等主流厂商。Office 文档可由 **anydoc** 在 Go 进程内解析。全流程模块化设计,大模型、向量数据库、存储等组件均可灵活替换,支持本地与私有云部署,数据完全自主可控。WeKnora 还无缝集成了 **Langfuse**,为 Agent 运行、Token 使用及任务流水线提供了全面的可观测性追踪。
框架支持从飞书、Confluence、钉钉文档、GitLab、腾讯 IMA、Notion 及语雀等外部平台自动同步知识(更多数据源持续接入中),覆盖 PDF、Word、图片、Excel、XMind 等十余种文档格式,并可通过企业微信、飞书、Slack、Telegram 等 IM 频道直接提供问答服务。模型层面兼容 OpenAI、DeepSeek、Qwen(阿里云)、智谱、混元、Gemini、MiniMax、NVIDIA、LiteLLM、Ollama 等主流厂商。Office 文档可由 **anydoc** 在 Go 进程内解析。全流程模块化设计,大模型、向量数据库、存储等组件均可灵活替换,支持本地与私有云部署,数据完全自主可控。WeKnora 还无缝集成了 **Langfuse**,为 Agent 运行、Token 使用及任务流水线提供了全面的可观测性追踪。
## ✨ 最新更新
- **v0.8.2** —— **本地浏览器(BrowserSkill)**:智能体通过开源 BrowserSkill 扩展操作用户自己的 Chrome / Edge,支持实时任务预览、暂停 / 继续,登录和验证码交给用户处理;**内置 MCP Server**(按空间发布 `/mcp/<endpoint_id>` 端点,Streamable HTTP,每个端点独立令牌、知识库范围、限流与工具分组;Python 版 `mcp-server/` 已弃用);侧边栏**工具箱**集中管理技能、MCP 服务与浏览器连接;**对话控制**(运行中追加要求、从任意历史问题分叉、原地回滚并还原沙箱检查点、按会话选择思考强度);**产物库**;沙箱**交互终端**与**图形桌面**;macOS **Lite 宿主机沙箱**与项目文件夹;重构的**模型目录**(27 家内置厂商,自动补全上下文窗口、最大输出、思考档位与视觉能力);Agent 检索工具合并为 `search_knowledge` / `read_document` / `list_documents`;Confluence 与钉钉文档数据源;博查与 Serply 网络搜索;日语界面;IM 频道级回复语言;仅白名单出站模式。不兼容变更:钉钉频道仅支持 Stream 模式,沙箱命令默认以 `root` 执行。详见 [`CHANGELOG.md`](./CHANGELOG.md)。
- **v0.8.0** —— **技能沙箱运行时**(会话级常驻 Docker / E2B / Cube 后端,按空间配置网络策略;移除 Local 宿主机进程后端;Docker 需显式开启);**空间技能目录**(从 ClawHub / SkillHub / git / zip 安装,按沙箱快照、实时进度、文件浏览/编辑、个人与空间环境变量);**跨会话长期记忆**(profile / preference / fact / task / interest,自动抽取需确认,`search_memory`);进程内 **anydoc** Office 解析;官方 **DeepSeek Harness 插件** `@wxg-prc-cpg/dsh-weknora`;GitLab 与腾讯 IMA 数据源;LiteLLM;Exa 与 Metaso 网络搜索;XMind 解析;对话产物、问题大纲与时间戳;上下文压缩与供应商 Prompt Cache 标记。另有 OIDC JWKS 验签、可选复杂密码、文档自动打标签,以及大范围沙箱/安全加固。详见 [`CHANGELOG.md`](./CHANGELOG.md)。
- **v0.7.2** —— 上线**官方产品文档站**(VitePress,六大板块约 50 篇,覆盖约 360 个 API 端点与约 150 个环境变量,含独立 Docker/Nginx 部署、快速上手样例数据与本地 MCP demo);**知识库文件夹树**(文件夹路径独立入库,可像文件管理器一样浏览、重命名与重新归档);**分块编辑与版本历史**(可视化编辑检索分块、逐版本 diff 与回滚、自动重建索引、文档自定义元数据);**Wiki 页面版本历史**(快照 + 行级 diff + 一键回滚 + 浏览器内手动编辑);**API 文件直链模式** `resource_urls=public` / `RESOURCE_URL_MODE`(第三方 App 无需二次调用鉴权代理即可加载图片与文件);**飞书云盘数据源**与 docx blocks 逐类型下钻同步;文档批量打标签;**MCP Server 1.1.x**(迁移到 mcp 2.x 高级 API,官方 PyPI 包 `tencent-weknora-mcp`,新增 `create_knowledge_from_text` 与 `list_shared_knowledge_bases`,共 29 个工具);AWS S3 默认凭据链(IAM Role / IRSA);本地 HTML 上传解析;QQBot Markdown 回复;新增 app / frontend / docreader / mcp-server 的 PR CI 检查。另有 router 与 modelcontext 大规模重构、重排与分块质量优化,以及大量稳定性修复。详见 [`CHANGELOG.md`](./CHANGELOG.md)。
- **v0.7.1** —— 新增**云之家 IM 集成**(WebSocket + 图片消息 + Markdown 回复);**火山引擎 Rerank** 供应商(自动分批请求)与**智谱 AI 网络搜索**供应商;**平台级 API Key**,用于控制面自动化(空间管理、系统设置、运行时队列、审计日志);**按知识库的活动审计追踪**;FAQ 管理增强(筛选、打标签、导出、导入结果追踪);**Langfuse OTLP/OTel 追踪**迁移,支持 W3C traceparent 跨服务传播;对话头部操作栏,支持一键 **Markdown 导出**,并在引用抽屉中展示 Wiki 工具结果;Prompt 缓存可观测性;会话渠道治理(IM/嵌入/API 会话按管理员范围隔离);飞书大型 Wiki 同步韧性增强;移除旧版 Neo4j 会话记忆依赖。另有大范围的 slug 完整性、SSRF 传输与状态同步加固。详见 [`CHANGELOG.md`](./CHANGELOG.md)。
@ -123,12 +124,15 @@ https://github.com/user-attachments/assets/2819598d-3140-4623-814a-8162a22b653c
| 能力 | 详情 |
|------|------|
| 智能推理 | ReACT 渐进式多步推理,自主编排知识检索、MCP 工具、技能沙箱与网络搜索 |
| 智能推理 | ReACT 渐进式多步推理,自主编排知识检索、MCP 工具、技能沙箱、本地浏览器与网络搜索 |
| 快速问答 | 基于知识库的 RAG 问答,快速准确地回答问题 |
| Wiki 模式 | Agent 驱动从原始文档中自动生成并维护结构化、相互链接的 Markdown Wiki 知识页面;支持浏览器内人工编辑、页面版本历史、行级 diff 与一键回滚 |
| 技能目录与沙箱 | 空间技能目录(ClawHub / SkillHub / git / zip)安装到会话级 Docker / E2B / Cube 沙箱;`shell_exec`、文件工具、产物收集、按配置网络策略;已移除 Local 宿主机进程后端 |
| 技能目录与沙箱 | 空间技能目录(ClawHub / SkillHub / git / zip)安装到会话级 Docker / E2B / Cube 沙箱;`shell_exec`、文件工具、产物收集、按配置网络策略;已移除 Local 宿主机进程后端;对话旁提供交互终端与浏览器内图形桌面;macOS 桌面版在绑定项目文件夹的系统沙箱(Seatbelt)中运行会话 |
| 本地浏览器 | 智能体通过开源 BrowserSkill 扩展在独立任务窗口中操作用户自己的 Chrome / Edge(打开页面、点击、填表、读取内容),支持实时预览、暂停 / 继续 / 结束,登录与验证码交由用户处理 |
| 对话控制 | 运行中追加要求、从任意历史问题分叉对话、原地回滚(沙箱工作区同步还原到对应检查点),按会话选择思考强度 |
| 产物库 | 侧边栏集中列出所有对话生成的文件,支持类型筛选、搜索、按日期分组与版本历史 |
| 长期记忆 | 跨会话记忆(profile / preference / fact / task / interest),支持自动抽取、用户确认与按需 `search_memory` |
| 工具调用 | 内置工具、MCP 工具(含 OAuth2 远程服务、会话内 OAuth 授权)、网络搜索;支持 `@Skill / @MCP` 提及以按轮次范围化 Agent 运行时 |
| 工具调用 | 内置工具、MCP 工具(含 OAuth2 远程服务、会话内 OAuth 授权)、网络搜索;支持 `@Skill / @MCP` 提及以按轮次范围化 Agent 运行时;MCP 工具按需发现与调用,可逐个启用或停用 |
| 对话策略 | 在线 Prompt 编辑、检索阈值调节、多轮上下文感知、按 Agent 引用输出开关 |
| 推荐问题 | 基于知识库内容自动生成推荐问题与答后追问 |
| 临时附件 | 会话级临时上传图片 / 文档,异步解析后用于一次性问答,支持图片与附件合并限额 |
@ -144,7 +148,7 @@ https://github.com/user-attachments/assets/2819598d-3140-4623-814a-8162a22b653c
| 分块编辑与版本历史 | 在界面直接编辑检索分块,保留逐版本快照,支持 diff 与一键回滚,编辑后自动重建索引;生成问题可增删改与重新生成;支持文档自定义元数据 |
| 按批次解析配置 | 上传确认对话框或 `process_config` API 覆盖解析引擎、分块、多模态(VLM / ASR)、图谱抽取与问题生成;支持 reparse 时调整配置 |
| 批量重新解析 | 一次为多篇文档重新排队解析,可携带批次级 `process_config` |
| 数据源导入 | 飞书知识库 / 飞书云盘 / Lark / GitLab / 腾讯 IMA / Notion / 语雀 / 钉钉文档 / RSS 订阅自动同步(更多数据源开发中),支持增量与全量同步 |
| 数据源导入 | 飞书知识库 / 飞书云盘 / Lark / Confluence / GitLab / 腾讯 IMA / Notion / 语雀 / 钉钉文档 / RSS 订阅自动同步(更多数据源开发中),支持增量与全量同步 |
| 文档格式 | PDF / Word / Txt / Markdown / HTML / EPUB / MHTML / 图片 / CSV / Excel / PPT / JSON / XMind |
| 自动打标签 | 解析完成后从知识库已有标签中选择匹配项增量关联,不创建新标签、不覆盖人工标签 |
| 检索策略 | BM25 稀疏召回 / Dense 稠密召回 / GraphRAG 图谱增强 / 父子分块 / pgvector HNSW 加速(1024 维)/ 多维度索引 |
@ -161,9 +165,9 @@ https://github.com/user-attachments/assets/2819598d-3140-4623-814a-8162a22b653c
| 对象存储 | 本地 / 腾讯云COS / 火山引擎 TOS / MinIO / AWS S3(支持 IAM Role / IRSA 默认凭据链)/ 阿里云 OSS / 金山云 KS3 / 华为云 OBS;支持**每空间多实例存储后端**,不同知识库可绑定不同实例并设置默认实例 |
| IM 集成 | 企业微信 / 飞书 / Lark(飞书国际版)/ QQBot / Slack / Telegram / 钉钉 / Mattermost / 微信 / 云之家 |
| 网站嵌入 | 通过嵌入 Widget 发布智能体,支持域名白名单、限流与安全模式 Token 交换 |
| 网络搜索 | DuckDuckGo / Bing / Google / Tavily / Baidu / Ollama / SearXNG / Keenable / 智谱 AI / Exa / Metaso |
| 网络搜索 | DuckDuckGo / Bing / Google / Tavily / Baidu / Ollama / SearXNG / Keenable / 智谱 AI / Exa / Metaso / 博查 / Serply |
| API 集成 | 权限范围 API Key(能力级授权 + 按 KB 限制 + 节流的 last_used 追踪)与 API 集成调试台;MCP OAuth 与嵌入会话按 Principal 隔离;`resource_urls=public` 直接返回可加载的文件/图片直链,免去二次鉴权代理调用 |
| MCP Server | 官方 PyPI 包 `tencent-weknora-mcp`,29 个工具,支持 stdio / SSE / HTTP 三种传输 |
| MCP Server | 内置:按空间发布 `/mcp/<endpoint_id>` 端点(Streamable HTTP),每个端点独立令牌、知识库范围、限流与工具分组(检索、`ask`、Wiki、需手动开启的写入工具);Python 包 `tencent-weknora-mcp` 已弃用 |
**平台能力**
@ -171,12 +175,12 @@ https://github.com/user-attachments/assets/2819598d-3140-4623-814a-8162a22b653c
| 能力 | 详情 |
|------|------|
| 部署 | 本地 / Docker / Kubernetes (Helm),支持私有化离线部署 |
| 界面 | Web UI / RESTful API / 命令行(`weknora`)/ Chrome Extension / 网站嵌入 Widget / 微信小程序 |
| 界面 | Web UI / RESTful API / 命令行(`weknora`)/ Chrome Extension / 网站嵌入 Widget / 微信小程序;界面支持中文 / 英文 / 日文 / 韩文 / 俄文 |
| 权限控制 | 空间 RBAC 四级角色矩阵(Owner / Admin / Contributor / Viewer),按知识库的资源归属,每空间审计日志,invite-only 准入,无空间预置与受控自助创建工作区,管理员密码重置(会话吊销),跨空间超级管理员,权限范围 API Key |
| 安全 | API Key 与 MCP / 数据源凭据 AES-256-GCM 静态加密、支持平滑密钥轮换;app ↔ docreader gRPC TLS + Token;Redis TLS;防 SSRF HTTP 客户端(覆盖数据源、URL 导入、重定向链等);密钥响应脱敏;技能沙箱隔离(Docker 需开启 / E2B / Cube)与按配置网络策略;OIDC ID Token JWKS 验签;可选复杂密码策略 |
| 安全 | API Key 与 MCP / 数据源凭据 AES-256-GCM 静态加密、支持平滑密钥轮换;app ↔ docreader gRPC TLS + Token;Redis TLS;防 SSRF HTTP 客户端(覆盖数据源、URL 导入、重定向链等);密钥响应脱敏;技能沙箱隔离(Docker 需开启 / E2B / Cube)与按配置网络策略;OIDC ID Token JWKS 验签;可选复杂密码策略;仅白名单出站模式(`SSRF_DNS_WHITELIST_ONLY`) |
| 可观测性 | 集成 Langfuse(唯一追踪后端)以追踪 ReAct 循环、Token 消耗、工具调用和任务流水线;内置 Langfuse 风格的文档解析追踪时间线,逐阶段展示解析进度;系统管理员运行时任务队列面板(队列深度、按模型并发、失败任务排查与手动重试) |
| 任务管理 | MQ 异步任务,分阶段独立 Worker 池治理(core / 后处理 / enrichment / maintenance + 弹性共享池,Wiki 独立池)与按模型后台并发治理;版本升级自动数据库迁移 |
| 模型管理 | 集中配置,YAML 声明式内置模型配置,知识库级别模型选择,按模型思考模式与 Embedding 维度覆盖,交互式模型调试器,多空间共享内置模型,WeKnora Cloud 托管模型与文档解析 |
| 模型管理 | 集中配置,YAML 声明式内置模型配置,知识库级别模型选择,按模型思考模式与 Embedding 维度覆盖,交互式模型调试器,多空间共享内置模型,WeKnora Cloud 托管模型与文档解析;模型目录自动补全上下文窗口、最大输出、思考档位与视觉能力,提供实际调用预览与按模型协议覆盖 |
## 🧩 Chrome 插件
@ -272,7 +276,7 @@ WeKnora 支持将文档转化为知识图谱,展示文档中不同段落之间
## 配套MCP服务器
请参考 [MCP配置说明](./mcp-server/MCP_CONFIG.md) 进行相关配置。
WeKnora 已内置 MCP Server:在「设置 → 发布集成 → MCP Server」新建端点,客户端通过 Streamable HTTP 连接 `/mcp/<endpoint_id>` 即可,详见 [MCP 文档](./website-docs/03-features/08-mcp.md)。[`mcp-server/`](./mcp-server/MCP_CONFIG.md) 下的独立 Python 服务已弃用,仅为兼容旧部署保留。
## 🔌 使用微信对话开放平台

View File

@ -53,12 +53,13 @@
[**WeKnora(ウィーノラ)**](https://weknora.weixin.qq.com) は、大規模言語モデル(LLM)をベースとしたオープンソースのナレッジフレームワークで、エンタープライズ級の文書理解、セマンティック検索、自律推論シナリオ向けに設計されています。
本フレームワークは **3 つのコア能力** を中心に構築されています:日常的な検索に最適な **RAG ベースのクイック Q&A**、ナレッジ検索・MCP ツール・**スキルカタログ**・セッション永続の **Docker / E2B / Cube サンドボックス**・Web 検索を自律的にオーケストレーションし複雑なマルチステップタスクを処理する **ReAct Agent 推論**、そして Agent が生のドキュメントから相互リンクされた Markdown ナレッジベースとインタラクティブなナレッジグラフを自律生成・維持する全く新しい **Wiki モード**(手動編集・バージョン履歴・ワンクリックロールバック対応)。**クロスセッション長期メモリ**は「あなたが誰で、何を繰り返し尋ねるか」を覚えます。ナレッジの整備も細かく制御可能で、**ツリー型フォルダー**がアップロード時のディレクトリ構造を保持し、**チャンク編集とバージョン履歴**により検索チャンクをドキュメントと同様に編集・差分比較・ロールバックできます。さらに、多様なデータソース連携(Feishu ナレッジベース / Feishu クラウドドライブ / GitLab / Tencent IMA / Notion / Yuque / DingTalk Docs / RSS、随時拡充中)、**ウェブサイト埋め込み Widget** による外部サイトへのエージェント公開、プログラム連携向けの**スコープ付き API キーと Principal モデル**、ワークスペースごとの**マルチインスタンスストレージバックエンド**、20 以上の LLM プロバイダー統合(LiteLLM 含む)、Langfuse による全体可観測性と**ランタイムタスクキューダッシュボード + Worker プール統治**、**エンタープライズ向けマルチテナント RBAC(4 階層ロールマトリクス + リソース所有権 + テナント監査ログ)**、完全セルフホスト可能なモジュラーアーキテクチャと組み合わせることで、WeKnora は散在する文書を「検索可能・推論可能・継続的に進化する」専用ナレッジ資産へと昇華させます。
本フレームワークは **3 つのコア能力** を中心に構築されています:日常的な検索に最適な **RAG ベースのクイック Q&A**、ナレッジ検索・MCP ツール・**スキルカタログ**・セッション永続の **Docker / E2B / Cube サンドボックス**・**BrowserSkill** によるユーザー自身のブラウザ・Web 検索を自律的にオーケストレーションし複雑なマルチステップタスクを処理する **ReAct Agent 推論**、そして Agent が生のドキュメントから相互リンクされた Markdown ナレッジベースとインタラクティブなナレッジグラフを自律生成・維持する全く新しい **Wiki モード**(手動編集・バージョン履歴・ワンクリックロールバック対応)。**クロスセッション長期メモリ**は「あなたが誰で、何を繰り返し尋ねるか」を覚えます。ナレッジの整備も細かく制御可能で、**ツリー型フォルダー**がアップロード時のディレクトリ構造を保持し、**チャンク編集とバージョン履歴**により検索チャンクをドキュメントと同様に編集・差分比較・ロールバックできます。さらに、多様なデータソース連携(Feishu ナレッジベース / Feishu クラウドドライブ / Confluence / GitLab / Tencent IMA / Notion / Yuque / DingTalk Docs / RSS、随時拡充中)、**ウェブサイト埋め込み Widget** による外部サイトへのエージェント公開、ナレッジベースを Cursor や Claude などの AI ツールに公開する**組み込み MCP Server**、プログラム連携向けの**スコープ付き API キーと Principal モデル**、ワークスペースごとの**マルチインスタンスストレージバックエンド**、自動生成のモデルカタログを備えた 27 の組み込みモデルベンダー(LiteLLM 含む)、Langfuse による全体可観測性と**ランタイムタスクキューダッシュボード + Worker プール統治**、**エンタープライズ向けマルチテナント RBAC(4 階層ロールマトリクス + リソース所有権 + テナント監査ログ)**、完全セルフホスト可能なモジュラーアーキテクチャと組み合わせることで、WeKnora は散在する文書を「検索可能・推論可能・継続的に進化する」専用ナレッジ資産へと昇華させます。
Feishu、GitLab、Tencent IMA、Notion、Yuqueなどの外部プラットフォームからのナレッジ自動同期(他のデータソースも順次対応中)に対応し、PDF、Word、画像、Excel、XMindなど10以上の文書フォーマットをサポート。WeChat Work、Feishu、Slack、TelegramなどのIMチャネルから直接Q&Aサービスを提供できます。モデル層ではOpenAI、DeepSeek、Qwen(Alibaba Cloud)、Zhipu、Hunyuan、Gemini、MiniMax、NVIDIA、LiteLLM、Ollamaなど主要プロバイダーに対応。Office 文書は **anydoc** でプロセス内解析できます。全プロセスをモジュラー設計し、大規模モデル、ベクトルデータベース、ストレージなどのコンポーネントを柔軟に差し替え可能。ローカルおよびプライベートクラウドデプロイに対応し、データは完全に自己管理可能です。さらにWeKnoraは **Langfuse** とシームレスに統合され、Agentの推論、トークン消費、パイプラインに対する包括的な可観測性(オブザーバビリティ)を提供します。
Feishu、Confluence、DingTalk Docs、GitLab、Tencent IMA、Notion、Yuqueなどの外部プラットフォームからのナレッジ自動同期(他のデータソースも順次対応中)に対応し、PDF、Word、画像、Excel、XMindなど10以上の文書フォーマットをサポート。WeChat Work、Feishu、Slack、TelegramなどのIMチャネルから直接Q&Aサービスを提供できます。モデル層ではOpenAI、DeepSeek、Qwen(Alibaba Cloud)、Zhipu、Hunyuan、Gemini、MiniMax、NVIDIA、LiteLLM、Ollamaなど主要プロバイダーに対応。Office 文書は **anydoc** でプロセス内解析できます。全プロセスをモジュラー設計し、大規模モデル、ベクトルデータベース、ストレージなどのコンポーネントを柔軟に差し替え可能。ローカルおよびプライベートクラウドデプロイに対応し、データは完全に自己管理可能です。さらにWeKnoraは **Langfuse** とシームレスに統合され、Agentの推論、トークン消費、パイプラインに対する包括的な可観測性(オブザーバビリティ)を提供します。
## ✨ 最新アップデート
- **v0.8.2** — **ローカルブラウザ(BrowserSkill)**:オープンソースの BrowserSkill 拡張機能を通じて、エージェントがユーザー自身の Chrome / Edge を操作(ライブのタスクプレビュー、一時停止 / 再開、ログインや CAPTCHA はユーザーに引き継ぎ);**組み込み MCP Server**(ワークスペース単位の `/mcp/<endpoint_id>` エンドポイント、Streamable HTTP、エンドポイントごとのトークン・ナレッジベース範囲・レート制限・ツールグループ;Python 版 `mcp-server/` は非推奨);スキル・MCP サービス・ブラウザ接続をまとめたサイドバーの**ツールボックス**;**会話コントロール**(実行中のターンへの要件追加、過去の任意の質問からの分岐、サンドボックスのチェックポイントと連動したその場での巻き戻し、セッション単位の推論強度);**成果物ライブラリ**;サンドボックスの**インタラクティブターミナル**と**グラフィカルデスクトップ**;macOS の **Lite ホストサンドボックス**とプロジェクトフォルダー;再構築された**モデルカタログ**(27 の組み込みベンダー、コンテキストウィンドウ・最大出力・推論レベル・ビジョン対応を自動補完);Agent の検索ツールを `search_knowledge` / `read_document` / `list_documents` に統合;Confluence と DingTalk Docs データソース;Bocha と Serply の Web 検索;日本語 UI;IM チャネル単位の返信言語;ホワイトリスト限定の外部通信モード。互換性のない変更:DingTalk チャネルは Stream モードのみ、サンドボックスのコマンドは既定で `root` で実行。詳細は [`CHANGELOG.md`](./CHANGELOG.md)。
- **v0.8.0** — **スキルサンドボックス実行環境**(セッション永続の Docker / E2B / Cube バックエンド、テナント単位のネットワークポリシー;Local ホストプロセスバックエンドを削除;Docker はオプトイン);**テナントスキルカタログ**(ClawHub / SkillHub / git / zip からインストール、サンドボックス単位のスナップショット、ライブ進捗、ファイル閲覧/編集、個人・ワークスペース環境変数);**クロスセッション長期メモリ**(profile / preference / fact / task / interest、確認付き自動抽出、`search_memory`);プロセス内 **anydoc** Office パーサー;公式 **DeepSeek Harness プラグイン** `@wxg-prc-cpg/dsh-weknora`;GitLab と Tencent IMA データソース;LiteLLM;Exa と Metaso Web 検索;XMind 解析;チャット成果物、質問アウトライン、タイムスタンプ;コンテキスト圧縮とプロバイダー Prompt Cache マーカー。加えて OIDC JWKS 検証、任意の複雑パスワード、ドキュメント自動タグ付け、広範なサンドボックス/セキュリティ強化。詳細は [`CHANGELOG.md`](./CHANGELOG.md)。
- **v0.7.2** — **公式製品ドキュメントサイト**を公開(VitePress、6 セクション約 50 ページで約 360 の API エンドポイントと約 150 の環境変数を網羅、独立した Docker/Nginx デプロイ・クイックスタート用サンプルデータ・ローカル MCP デモを同梱);**ナレッジベースのフォルダーツリー**(アップロードパスを独立したデータとして保存し、ファイルマネージャーのように参照・リネーム・再配置);**チャンク編集とバージョン履歴**(UI で検索チャンクを編集、バージョン単位の差分とロールバック、編集後のインデックス自動再構築、ドキュメントのカスタムメタデータ);**Wiki ページのバージョン履歴**(スナップショット + 行単位差分 + ワンクリックロールバック + ブラウザ内手動編集);**ファイル直リンクモード** `resource_urls=public` / `RESOURCE_URL_MODE`(サードパーティアプリが認証プロキシへの二次リクエストなしで画像とファイルを表示);**Feishu クラウドドライブデータソース**と docx の blocks API 同期;ドキュメントの一括タグ付け;**MCP Server 1.1.x**(mcp 2.x の高レベル API へ移行、公式 PyPI パッケージ `tencent-weknora-mcp`、`create_knowledge_from_text` と `list_shared_knowledge_bases` を追加し計 29 ツール);AWS S3 デフォルト資格情報チェーン(IAM Role / IRSA);ローカル HTML アップロード解析;QQBot の Markdown 返信;app / frontend / docreader / mcp-server の PR CI チェック追加。加えて router と `modelcontext` の大規模リファクタリング、リランクとチャンキングの品質改善、広範な安定性修正。詳細は [`CHANGELOG.md`](./CHANGELOG.md)。
- **v0.7.1** — 新しい**Yunzhijia(云之家)IM 連携**(WebSocket + 画像メッセージ + Markdown 返信);**Volcengine Rerank** プロバイダー(リクエストの自動分割)と **Zhipu AI Web 検索**プロバイダー;コントロールプレーン自動化向けの**プラットフォームスコープ API キー**(テナント管理、システム設定、ランタイムキュー、監査ログ);**KB 単位のアクティビティ監査証跡**;FAQ 管理の強化(フィルタリング、タグ付け、エクスポート、インポート結果追跡);**Langfuse OTLP/OTel トレーシング**への移行と W3C traceparent 伝播;チャットヘッダーアクションによるワンクリック **Markdown エクスポート**、参照ドロワーへの Wiki ツール結果表示;プロンプトキャッシュ可観測性;セッションチャネルガバナンス(IM/埋め込み/API セッションを管理者スコープで分離);Feishu 大規模 Wiki 同期の堅牢化;レガシー Neo4j 会話メモリ依存の削除。加えて広範な slug 整合性・SSRF トランスポート・状態同期の強化。詳細は [`CHANGELOG.md`](./CHANGELOG.md)。
@ -120,12 +121,15 @@ Feishu、GitLab、Tencent IMA、Notion、Yuqueなどの外部プラットフォ
| 機能 | 詳細 |
|------|------|
| インテリジェント推論 | ReACT プログレッシブ・マルチステップ推論、ナレッジ検索・MCP ツール・スキルサンドボックス・Web 検索を自律的にオーケストレーション |
| インテリジェント推論 | ReACT プログレッシブ・マルチステップ推論、ナレッジ検索・MCP ツール・スキルサンドボックス・ローカルブラウザ・Web 検索を自律的にオーケストレーション |
| クイック Q&A | ナレッジベースベースの RAG Q&A、迅速かつ正確な回答 |
| Wiki モード | Agent主導で生のドキュメントから構造化された相互リンク済みMarkdown Wikiページを自動生成・保守;ブラウザ内手動編集、ページのバージョン履歴、行単位差分とワンクリックロールバック |
| スキルカタログとサンドボックス | ワークスペースのスキルカタログ(ClawHub / SkillHub / git / zip)をセッション永続の Docker / E2B / Cube サンドボックスへインストール;`shell_exec`、ファイルツール、成果物、設定単位のネットワークポリシー;Local ホストプロセスバックエンドは削除 |
| スキルカタログとサンドボックス | ワークスペースのスキルカタログ(ClawHub / SkillHub / git / zip)をセッション永続の Docker / E2B / Cube サンドボックスへインストール;`shell_exec`、ファイルツール、成果物、設定単位のネットワークポリシー;Local ホストプロセスバックエンドは削除;チャット横のインタラクティブターミナルとブラウザ内グラフィカルデスクトップ;macOS デスクトップ版はプロジェクトフォルダーに紐づく OS サンドボックス(Seatbelt)でセッションを実行 |
| ローカルブラウザ | オープンソースの BrowserSkill 拡張機能を通じて、エージェントが専用のタスクウィンドウでユーザー自身の Chrome / Edge を操作(ページを開く、クリック、フォーム入力、内容の読み取り);ライブプレビュー、一時停止 / 再開 / 終了、ログインや CAPTCHA はユーザーに引き継ぎ |
| 会話コントロール | 実行中のターンへの要件追加、過去の任意の質問からの会話分岐、その場での巻き戻し(サンドボックスのワークスペースも対応するチェックポイントに復元)、セッション単位の推論強度選択 |
| 成果物ライブラリ | 全会話で生成されたファイルをサイドバーで一覧表示、種類フィルター・検索・日付グループ・バージョン履歴に対応 |
| 長期メモリ | クロスセッションメモリ(profile / preference / fact / task / interest)。自動抽出、ユーザー確認、オンデマンド `search_memory` |
| ツール呼び出し | 組み込みツール、MCP ツール(OAuth2 リモートサービス・会話中 OAuth 含む)、Web 検索;`@Skill / @MCP` メンションでターン単位に Agent ランタイムを範囲化 |
| ツール呼び出し | 組み込みツール、MCP ツール(OAuth2 リモートサービス・会話中 OAuth 含む)、Web 検索;`@Skill / @MCP` メンションでターン単位に Agent ランタイムを範囲化;MCP ツールは必要に応じて検出・呼び出しされ、ツール単位で有効 / 無効を切り替え可能 |
| 対話戦略 | オンライン Prompt 編集、検索閾値チューニング、マルチターン文脈認識、Agent 単位の引用出力トグル |
| 推奨質問 | ナレッジベースの内容に基づく質問の自動生成と回答後のフォローアップ |
| 一時添付 | セッションスコープで画像 / ドキュメントをアップロードし、非同期解析して一回限りの Q&A に使用(画像 + 添付の合算上限) |
@ -141,7 +145,7 @@ Feishu、GitLab、Tencent IMA、Notion、Yuqueなどの外部プラットフォ
| チャンク編集とバージョン | UI から検索チャンクを直接編集、バージョン単位のスナップショット・差分・ワンクリックロールバック、編集後のインデックス自動再構築;生成質問の追加・編集・削除・再生成;ドキュメントのカスタムメタデータ対応 |
| アップロード単位の解析設定 | アップロード確認ダイアログまたは `process_config` API でパーサー・チャンキング・マルチモーダル(VLM / ASR)・グラフ抽出・質問生成をバッチ単位で上書き;reparse 時も設定変更可能 |
| 一括 reparse | 複数ドキュメントの解析を一度に再キュー、バッチ単位の `process_config` 対応 |
| データソースインポート | Feishu ナレッジベース / Feishu クラウドドライブ / Lark / GitLab / Tencent IMA / Notion / Yuque / DingTalk Docs / RSS フィードの自動同期(他のデータソースも開発中)、増分・全量同期対応 |
| データソースインポート | Feishu ナレッジベース / Feishu クラウドドライブ / Lark / Confluence / GitLab / Tencent IMA / Notion / Yuque / DingTalk Docs / RSS フィードの自動同期(他のデータソースも開発中)、増分・全量同期対応 |
| 文書フォーマット | PDF / Word / Txt / Markdown / HTML / EPUB / MHTML / 画像 / CSV / Excel / PPT / JSON / XMind |
| 自動タグ付け | 解析後、ナレッジベース既存タグから一致するものを増分付与(新規タグ作成や手動タグの上書きはしない) |
| 検索戦略 | BM25 疎検索 / Dense 密検索 / GraphRAG グラフ強化 / 親子チャンキング / pgvector HNSW 加速(1024 次元)/ 多次元インデックス |
@ -158,19 +162,19 @@ Feishu、GitLab、Tencent IMA、Notion、Yuqueなどの外部プラットフォ
| オブジェクトストレージ | ローカル / MinIO / AWS S3(IAM Role / IRSA のデフォルト資格情報チェーン対応)/ 火山引擎 TOS / Alibaba Cloud OSS / 金山雲 KS3 / 華為雲 OBS;**ワークスペースごとに複数のストレージインスタンス**、KB 単位のバインドとデフォルトインスタンス |
| IM 統合 | WeChat Work / Feishu / Lark(Feishu 国際版)/ QQBot / Slack / Telegram / DingTalk / Mattermost / WeChat / Yunzhijia |
| ウェブ埋め込み | 埋め込み Widget でエージェントを公開、ドメイン許可リスト・レート制限・セキュアモード Token 交換 |
| Web 検索 | DuckDuckGo / Bing / Google / Tavily / Baidu / Ollama / SearXNG / Keenable / Zhipu AI / Exa / Metaso |
| Web 検索 | DuckDuckGo / Bing / Google / Tavily / Baidu / Ollama / SearXNG / Keenable / Zhipu AI / Exa / Metaso / Bocha / Serply |
| API 連携 | スコープ付き API キー(能力単位の付与 + KB 単位の制限 + 節流付き last_used 追跡)と API 連携プレイグラウンド;MCP OAuth と埋め込みセッションを Principal 単位で分離;`resource_urls=public` で直接読み込み可能なファイル / 画像 URL を返却し、認証プロキシへの二次リクエストを不要に |
| MCP Server | 公式 PyPI パッケージ `tencent-weknora-mcp`、29 ツール、stdio / SSE / HTTP の 3 トランスポート対応 |
| MCP Server | 組み込み:ワークスペース単位で `/mcp/<endpoint_id>` エンドポイントを公開(Streamable HTTP)、エンドポイントごとにトークン・ナレッジベース範囲・レート制限・ツールグループ(検索、`ask`、Wiki、明示的に有効化する書き込みツール)を設定;Python パッケージ `tencent-weknora-mcp` は非推奨 |
**プラットフォーム**
| 機能 | 詳細 |
|------|------|
| デプロイ | ローカル / Docker / Kubernetes (Helm)、プライベート化・オフラインデプロイ対応 |
| UI | Web UI / RESTful API / CLI (`weknora`) / Chrome Extension / ウェブ埋め込み Widget / WeChat ミニプログラム |
| UI | Web UI / RESTful API / CLI (`weknora`) / Chrome Extension / ウェブ埋め込み Widget / WeChat ミニプログラム;UI は中国語 / 英語 / 日本語 / 韓国語 / ロシア語に対応 |
| 可観測性 | Langfuse(唯一のトレーシングバックエンド)で ReAct ループ・トークン消費・ツール呼び出し・パイプライン追跡;Langfuse 風のドキュメント解析トレースタイムラインを内蔵し、ステージごとの進捗を表示;システム管理者向けランタイムタスクキューダッシュボード(キュー深度・モデル別並行度・失敗タスクの調査と手動再試行) |
| タスク管理 | MQ 非同期タスク、ステージ別 Worker プール統治(core / 後処理 / enrichment / maintenance + 弾性共有プール、Wiki は独立プール)とモデル別バックグラウンド並行度ガバナー;バージョンアップ時の DB 自動マイグレーション |
| モデル管理 | 集中設定、YAML 宣言型ビルトインモデル設定、ナレッジベース単位のモデル選択、モデル単位の思考モード・Embedding 次元上書き、インタラクティブモデルデバッガー、マルチテナント組み込みモデル共有、WeKnora Cloud ホスティングモデルとドキュメント解析 |
| モデル管理 | 集中設定、YAML 宣言型ビルトインモデル設定、ナレッジベース単位のモデル選択、モデル単位の思考モード・Embedding 次元上書き、インタラクティブモデルデバッガー、マルチテナント組み込みモデル共有、WeKnora Cloud ホスティングモデルとドキュメント解析;モデルカタログがコンテキストウィンドウ・最大出力・推論レベル・ビジョン対応を自動補完し、実際の呼び出し内容のプレビューとモデル単位のプロトコル上書きに対応 |
## 🧩 Chrome 拡張機能
@ -261,7 +265,7 @@ WeKnoraは文書をナレッジグラフに変換し、文書内の異なる段
## 対応するMCPサーバー
[MCP設定ガイド](./mcp-server/MCP_CONFIG.md) をご参照のうえ、必要な設定を行ってください。
WeKnora には MCP Server が組み込まれています:「設定 → 公開と連携 → MCP Server」でエンドポイントを作成し、クライアントから Streamable HTTP で `/mcp/<endpoint_id>` に接続してください。詳細は [MCP ドキュメント](./website-docs/03-features/08-mcp.md)(中国語)を参照。[`mcp-server/`](./mcp-server/MCP_CONFIG.md) のスタンドアロン Python サーバーは非推奨で、既存デプロイとの互換のためにのみ残されています。
## 🔌 WeChat対話オープンプラットフォームの使用

View File

@ -53,12 +53,13 @@
[**WeKnora**](https://weknora.weixin.qq.com)는 엔터프라이즈급 문서 이해, 시맨틱 검색, 자율 추론 시나리오를 위해 설계된 오픈소스 LLM 기반 지식 프레임워크입니다.
본 프레임워크는 **세 가지 핵심 역량**을 중심으로 구성됩니다. 일상 검색에 최적화된 **RAG 기반 빠른 Q&A**, 지식 검색·MCP 도구·**스킬 카탈로그**·세션 지속 **Docker / E2B / Cube 샌드박스**·웹 검색을 자율적으로 오케스트레이션하여 복잡한 다단계 작업을 처리하는 **ReAct Agent 추론**, 그리고 Agent가 원본 문서에서 상호 연결된 마크다운 지식베이스와 인터랙티브 지식 그래프를 스스로 생성·유지하는 완전히 새로운 **Wiki 모드**(수동 편집·버전 이력·원클릭 롤백 지원)입니다. **크로스 세션 장기 메모리**는 당신이 누구이며 무엇을 반복해서 묻는지 기억합니다. 지식 가공 과정도 세밀하게 제어할 수 있습니다. **트리형 폴더**가 업로드 시의 디렉터리 구조를 그대로 유지하고, **청크 편집 및 버전 이력**을 통해 검색 청크를 문서처럼 수정·비교·롤백할 수 있습니다. 다양한 데이터 소스 연동(Feishu 지식베이스 / Feishu 클라우드 드라이브 / GitLab / Tencent IMA / Notion / Yuque / DingTalk Docs / RSS, 지속 확장 중), **웹사이트 임베드 Widget**으로 외부 사이트에 에이전트 게시, 프로그램 연동을 위한 **범위 지정 API 키 및 Principal 모델**, 워크스페이스별 **다중 인스턴스 스토리지 백엔드**, 20개 이상의 LLM 프로바이더 통합(LiteLLM 포함), Langfuse 기반 풀스택 관측 가능성과 **런타임 작업 큐 대시보드 + Worker 풀 거버넌스**, **엔터프라이즈 멀티 테넌트 RBAC(4단계 역할 매트릭스 + 리소스 소유권 + 테넌트 감사 로그)**, 완전 셀프호스팅이 가능한 모듈형 아키텍처를 결합하여, WeKnora는 흩어진 문서를 검색·추론 가능하며 지속적으로 진화하는 전용 지식 자산으로 탈바꿈시킵니다.
본 프레임워크는 **세 가지 핵심 역량**을 중심으로 구성됩니다. 일상 검색에 최적화된 **RAG 기반 빠른 Q&A**, 지식 검색·MCP 도구·**스킬 카탈로그**·세션 지속 **Docker / E2B / Cube 샌드박스**·**BrowserSkill**을 통한 사용자 브라우저·웹 검색을 자율적으로 오케스트레이션하여 복잡한 다단계 작업을 처리하는 **ReAct Agent 추론**, 그리고 Agent가 원본 문서에서 상호 연결된 마크다운 지식베이스와 인터랙티브 지식 그래프를 스스로 생성·유지하는 완전히 새로운 **Wiki 모드**(수동 편집·버전 이력·원클릭 롤백 지원)입니다. **크로스 세션 장기 메모리**는 당신이 누구이며 무엇을 반복해서 묻는지 기억합니다. 지식 가공 과정도 세밀하게 제어할 수 있습니다. **트리형 폴더**가 업로드 시의 디렉터리 구조를 그대로 유지하고, **청크 편집 및 버전 이력**을 통해 검색 청크를 문서처럼 수정·비교·롤백할 수 있습니다. 다양한 데이터 소스 연동(Feishu 지식베이스 / Feishu 클라우드 드라이브 / Confluence / GitLab / Tencent IMA / Notion / Yuque / DingTalk Docs / RSS, 지속 확장 중), **웹사이트 임베드 Widget**으로 외부 사이트에 에이전트 게시, 지식베이스를 Cursor·Claude 등 AI 도구에 공개하는 **내장 MCP Server**, 프로그램 연동을 위한 **범위 지정 API 키 및 Principal 모델**, 워크스페이스별 **다중 인스턴스 스토리지 백엔드**, 자동 생성 모델 카탈로그를 갖춘 27개 내장 모델 벤더(LiteLLM 포함), Langfuse 기반 풀스택 관측 가능성과 **런타임 작업 큐 대시보드 + Worker 풀 거버넌스**, **엔터프라이즈 멀티 테넌트 RBAC(4단계 역할 매트릭스 + 리소스 소유권 + 테넌트 감사 로그)**, 완전 셀프호스팅이 가능한 모듈형 아키텍처를 결합하여, WeKnora는 흩어진 문서를 검색·추론 가능하며 지속적으로 진화하는 전용 지식 자산으로 탈바꿈시킵니다.
Feishu, GitLab, Tencent IMA, Notion, Yuque 등 외부 플랫폼에서 지식 자동 동기화를 지원하며(추가 데이터 소스 개발 중), PDF, Word, 이미지, Excel, XMind 등 10가지 이상의 문서 포맷을 처리합니다. WeChat Work, Feishu, Slack, Telegram 등의 IM 채널을 통해 Q&A 서비스를 직접 제공할 수 있습니다. 모델 레이어에서 OpenAI, DeepSeek, Qwen(Alibaba Cloud), Zhipu, Hunyuan, Gemini, MiniMax, NVIDIA, LiteLLM, Ollama 등 주요 프로바이더를 지원합니다. Office 문서는 **anydoc**으로 프로세스 내 파싱할 수 있습니다. 전체 프로세스가 모듈화 설계되어 LLM, 벡터 DB, 스토리지 등 구성 요소를 유연하게 교체 가능하며, 로컬 및 프라이빗 클라우드 배포를 지원하여 데이터 완전 자체 관리가 가능합니다. 또한 WeKnora는 **Langfuse**와 원활하게 통합되어 Agent 추론, 토큰 사용량 및 파이프라인에 대한 포괄적인 관측 가능성(Observability)을 제공합니다.
Feishu, Confluence, DingTalk Docs, GitLab, Tencent IMA, Notion, Yuque 등 외부 플랫폼에서 지식 자동 동기화를 지원하며(추가 데이터 소스 개발 중), PDF, Word, 이미지, Excel, XMind 등 10가지 이상의 문서 포맷을 처리합니다. WeChat Work, Feishu, Slack, Telegram 등의 IM 채널을 통해 Q&A 서비스를 직접 제공할 수 있습니다. 모델 레이어에서 OpenAI, DeepSeek, Qwen(Alibaba Cloud), Zhipu, Hunyuan, Gemini, MiniMax, NVIDIA, LiteLLM, Ollama 등 주요 프로바이더를 지원합니다. Office 문서는 **anydoc**으로 프로세스 내 파싱할 수 있습니다. 전체 프로세스가 모듈화 설계되어 LLM, 벡터 DB, 스토리지 등 구성 요소를 유연하게 교체 가능하며, 로컬 및 프라이빗 클라우드 배포를 지원하여 데이터 완전 자체 관리가 가능합니다. 또한 WeKnora는 **Langfuse**와 원활하게 통합되어 Agent 추론, 토큰 사용량 및 파이프라인에 대한 포괄적인 관측 가능성(Observability)을 제공합니다.
## ✨ 최신 업데이트
- **v0.8.2** — **로컬 브라우저(BrowserSkill)**: 오픈소스 BrowserSkill 확장 프로그램을 통해 에이전트가 사용자 자신의 Chrome / Edge를 조작(실시간 작업 미리보기, 일시정지 / 재개, 로그인과 CAPTCHA는 사용자에게 인계); **내장 MCP Server**(워크스페이스별 `/mcp/<endpoint_id>` 엔드포인트, Streamable HTTP, 엔드포인트마다 별도 토큰·지식베이스 범위·요청 제한·도구 그룹; Python 버전 `mcp-server/`는 지원 중단); 스킬·MCP 서비스·브라우저 연결을 모은 사이드바 **도구 상자**; **대화 제어**(실행 중인 턴에 요구 사항 추가, 이전 질문에서 대화 분기, 샌드박스 체크포인트와 함께 제자리 되감기, 세션별 추론 강도); **산출물 라이브러리**; 샌드박스 **대화형 터미널**과 **그래픽 데스크톱**; macOS **Lite 호스트 샌드박스**와 프로젝트 폴더; 재구축된 **모델 카탈로그**(27개 내장 벤더, 컨텍스트 윈도우·최대 출력·추론 단계·비전 지원 자동 채움); Agent 검색 도구를 `search_knowledge` / `read_document` / `list_documents`로 통합; Confluence 및 DingTalk Docs 데이터 소스; Bocha 및 Serply 웹 검색; 일본어 UI; IM 채널별 응답 언어; 화이트리스트 전용 외부 통신 모드. 호환성 변경: DingTalk 채널은 Stream 모드만 지원하며, 샌드박스 명령은 기본적으로 `root`로 실행됩니다. 자세한 내용은 [`CHANGELOG.md`](./CHANGELOG.md).
- **v0.8.0** — **스킬 샌드박스 런타임**(세션 지속 Docker / E2B / Cube 백엔드, 테넌트 단위 네트워크 정책; Local 호스트 프로세스 백엔드 제거; Docker는 옵트인); **테넌트 스킬 카탈로그**(ClawHub / SkillHub / git / zip에서 설치, 샌드박스별 스냅샷, 실시간 진행률, 파일 탐색/편집, 개인·워크스페이스 환경 변수); **크로스 세션 장기 메모리**(profile / preference / fact / task / interest, 확인이 필요한 자동 추출, `search_memory`); 프로세스 내 **anydoc** Office 파서; 공식 **DeepSeek Harness 플러그인** `@wxg-prc-cpg/dsh-weknora`; GitLab 및 Tencent IMA 데이터 소스; LiteLLM; Exa 및 Metaso 웹 검색; XMind 파싱; 채팅 산출물, 질문 개요, 타임스탬프; 컨텍스트 압축 및 프로바이더 Prompt Cache 마커. 또한 OIDC JWKS 검증, 선택적 복잡한 비밀번호, 문서 자동 태깅, 광범위한 샌드박스/보안 강화. 자세한 내용은 [`CHANGELOG.md`](./CHANGELOG.md).
- **v0.7.2** — **공식 제품 문서 사이트** 공개(VitePress, 6개 섹션 약 50편으로 약 360개 API 엔드포인트와 약 150개 환경 변수를 다루며, 독립 Docker/Nginx 배포·빠른 시작 샘플 데이터·로컬 MCP 데모 포함); **지식베이스 폴더 트리**(업로드 경로를 독립 데이터로 저장하여 파일 관리자처럼 탐색·이름 변경·문서 재배치); **청크 편집 및 버전 이력**(UI에서 검색 청크 직접 편집, 버전별 diff와 롤백, 편집 후 인덱스 자동 재구축, 문서 커스텀 메타데이터); **Wiki 페이지 버전 이력**(스냅샷 + 라인 단위 diff + 원클릭 롤백 + 브라우저 내 수동 편집); **파일 직접 링크 모드** `resource_urls=public` / `RESOURCE_URL_MODE`(서드파티 앱이 인증 프록시를 다시 호출하지 않고 이미지와 파일을 렌더링); **Feishu 클라우드 드라이브 데이터 소스** 및 docx blocks API 동기화; 문서 일괄 태깅; **MCP Server 1.1.x**(mcp 2.x 고수준 API로 마이그레이션, 공식 PyPI 패키지 `tencent-weknora-mcp`, `create_knowledge_from_text`와 `list_shared_knowledge_bases` 추가로 총 29개 도구); AWS S3 기본 자격 증명 체인(IAM Role / IRSA); 로컬 HTML 업로드 파싱; QQBot Markdown 응답; app / frontend / docreader / mcp-server PR CI 검사 추가. 또한 router와 `modelcontext` 대규모 리팩터링, 리랭크·청킹 품질 개선 및 광범위한 안정성 수정. 자세한 내용은 [`CHANGELOG.md`](./CHANGELOG.md).
- **v0.7.1** — 새로운 **Yunzhijia(云之家) IM 통합**(WebSocket + 이미지 메시지 + Markdown 응답); **Volcengine Rerank** 제공자(요청 자동 분할)와 **Zhipu AI 웹 검색** 제공자; 컨트롤 플레인 자동화를 위한 **플랫폼 범위 API 키**(테넌트 관리, 시스템 설정, 런타임 큐, 감사 로그); **KB 단위 활동 감사 추적**; FAQ 관리 강화(필터링, 태깅, 내보내기, 가져오기 결과 추적); **Langfuse OTLP/OTel 트레이싱** 마이그레이션 및 W3C traceparent 전파; 채팅 헤더 액션을 통한 원클릭 **Markdown 내보내기** 및 참조 드로어의 Wiki 도구 결과 표시; 프롬프트 캐시 가시성; 세션 채널 거버넌스(IM/임베드/API 세션을 관리자 범위로 분리); Feishu 대규모 Wiki 동기화 견고화; 레거시 Neo4j 대화 메모리 의존성 제거. 또한 광범위한 slug 무결성, SSRF 전송, 상태 동기화 강화. 자세한 내용은 [`CHANGELOG.md`](./CHANGELOG.md).
@ -129,12 +130,15 @@ Feishu, GitLab, Tencent IMA, Notion, Yuque 등 외부 플랫폼에서 지식 자
| 기능 | 상세 |
|------|------|
| 지능형 추론 | ReACT 점진적 멀티스텝 추론, 지식 검색·MCP 도구·스킬 샌드박스·웹 검색을 자율 오케스트레이션 |
| 지능형 추론 | ReACT 점진적 멀티스텝 추론, 지식 검색·MCP 도구·스킬 샌드박스·로컬 브라우저·웹 검색을 자율 오케스트레이션 |
| 빠른 Q&A | 지식베이스 기반 RAG Q&A, 빠르고 정확한 답변 |
| Wiki 모드 | Agent가 주도하여 원본 문서에서 구조화된 마크다운 Wiki 페이지를 자동 생성 및 유지 관리; 브라우저 내 수동 편집, 페이지 버전 이력, 라인 단위 diff 및 원클릭 롤백 |
| 스킬 카탈로그와 샌드박스 | 워크스페이스 스킬 카탈로그(ClawHub / SkillHub / git / zip)를 세션 지속 Docker / E2B / Cube 샌드박스에 설치; `shell_exec`, 파일 도구, 산출물, 설정 단위 네트워크 정책; Local 호스트 프로세스 백엔드 제거 |
| 스킬 카탈로그와 샌드박스 | 워크스페이스 스킬 카탈로그(ClawHub / SkillHub / git / zip)를 세션 지속 Docker / E2B / Cube 샌드박스에 설치; `shell_exec`, 파일 도구, 산출물, 설정 단위 네트워크 정책; Local 호스트 프로세스 백엔드 제거; 채팅 옆 대화형 터미널과 브라우저 기반 그래픽 데스크톱; macOS 데스크톱 앱은 프로젝트 폴더에 묶인 OS 샌드박스(Seatbelt)에서 세션 실행 |
| 로컬 브라우저 | 오픈소스 BrowserSkill 확장 프로그램을 통해 에이전트가 전용 작업 창에서 사용자 자신의 Chrome / Edge를 조작(페이지 열기, 클릭, 양식 입력, 내용 읽기); 실시간 미리보기, 일시정지 / 재개 / 종료, 로그인과 CAPTCHA는 사용자에게 인계 |
| 대화 제어 | 실행 중인 턴에 요구 사항 추가, 이전 질문에서 대화 분기, 제자리 되감기(샌드박스 작업 공간도 해당 체크포인트로 복원), 세션별 추론 강도 선택 |
| 산출물 라이브러리 | 모든 대화에서 생성된 파일을 사이드바에서 한눈에 보기, 유형 필터·검색·날짜별 그룹·버전 이력 지원 |
| 장기 메모리 | 크로스 세션 메모리(profile / preference / fact / task / interest), 자동 추출, 사용자 확인, 온디맨드 `search_memory` |
| 도구 호출 | 내장 도구, MCP 도구(OAuth2 원격 서비스·대화 중 OAuth 포함), 웹 검색; `@Skill / @MCP` 멘션으로 턴 단위 Agent 런타임 범위 지정 |
| 도구 호출 | 내장 도구, MCP 도구(OAuth2 원격 서비스·대화 중 OAuth 포함), 웹 검색; `@Skill / @MCP` 멘션으로 턴 단위 Agent 런타임 범위 지정; MCP 도구는 필요할 때 탐색·호출되며 도구별로 켜고 끌 수 있음 |
| 대화 전략 | 온라인 프롬프트 편집, 검색 임계값 조정, 멀티턴 문맥 인식, Agent별 인용 출력 토글 |
| 추천 질문 | 지식베이스 콘텐츠 기반 질문 자동 생성 및 답변 후 후속 질문 |
| 임시 첨부 | 세션 범위로 이미지 / 문서를 업로드하고 비동기 파싱하여 일회성 Q&A에 사용(이미지 + 첨부 통합 한도) |
@ -150,7 +154,7 @@ Feishu, GitLab, Tencent IMA, Notion, Yuque 등 외부 플랫폼에서 지식 자
| 청크 편집 및 버전 | UI에서 검색 청크를 직접 편집하고 버전별 스냅샷·diff·원클릭 롤백, 편집 후 인덱스 자동 재구축; 생성 질문 추가·수정·삭제·재생성; 문서 커스텀 메타데이터 지원 |
| 업로드 단위 파싱 설정 | 업로드 확인 대화상자 또는 `process_config` API로 파서·청킹·멀티모달(VLM / ASR)·그래프 추출·질문 생성을 배치 단위로 덮어쓰기; reparse 시 설정 변경 지원 |
| 일괄 reparse | 여러 문서의 파싱을 한 번에 재큐잉, 배치 단위 `process_config` 지원 |
| 데이터 소스 임포트 | Feishu 지식베이스 / Feishu 클라우드 드라이브 / Lark / GitLab / Tencent IMA / Notion / Yuque / DingTalk Docs / RSS 피드 자동 동기화(추가 데이터 소스 개발 중), 증분·전체 동기화 지원 |
| 데이터 소스 임포트 | Feishu 지식베이스 / Feishu 클라우드 드라이브 / Lark / Confluence / GitLab / Tencent IMA / Notion / Yuque / DingTalk Docs / RSS 피드 자동 동기화(추가 데이터 소스 개발 중), 증분·전체 동기화 지원 |
| 문서 포맷 | PDF / Word / Txt / Markdown / HTML / EPUB / MHTML / 이미지 / CSV / Excel / PPT / JSON / XMind |
| 자동 태깅 | 파싱 후 지식베이스 기존 태그에서 일치 항목을 증분 연결(새 태그 생성·수동 태그 덮어쓰기 없음) |
| 검색 전략 | BM25 희소 / Dense 밀집 / GraphRAG 그래프 강화 / 부모-자식 청킹 / pgvector HNSW 가속(1024차원) / 다차원 인덱싱 |
@ -167,19 +171,19 @@ Feishu, GitLab, Tencent IMA, Notion, Yuque 등 외부 플랫폼에서 지식 자
| 오브젝트 스토리지 | 로컬 / MinIO / AWS S3(IAM Role / IRSA 기본 자격 증명 체인 지원) / Volcengine TOS / Alibaba Cloud OSS / Kingsoft Cloud KS3 / Huawei Cloud OBS; **워크스페이스당 여러 스토리지 인스턴스**, KB 단위 바인딩 및 기본 인스턴스 |
| IM 통합 | WeChat Work / Feishu / Lark(Feishu 국제판) / QQBot / Slack / Telegram / DingTalk / Mattermost / WeChat / Yunzhijia |
| 웹사이트 임베드 | 임베드 Widget으로 에이전트 게시, 도메인 허용 목록·속도 제한·보안 모드 Token 교환 |
| 웹 검색 | DuckDuckGo / Bing / Google / Tavily / Baidu / Ollama / SearXNG / Keenable / Zhipu AI / Exa / Metaso |
| 웹 검색 | DuckDuckGo / Bing / Google / Tavily / Baidu / Ollama / SearXNG / Keenable / Zhipu AI / Exa / Metaso / Bocha / Serply |
| API 통합 | 범위 지정 API 키(능력 단위 권한 + KB 단위 제한 + 스로틀링된 last_used 추적)와 API 통합 플레이그라운드; MCP OAuth 및 임베드 세션을 Principal 단위로 격리; `resource_urls=public`으로 바로 로드 가능한 파일 / 이미지 URL을 반환하여 인증 프록시 재호출 제거 |
| MCP Server | 공식 PyPI 패키지 `tencent-weknora-mcp`, 29개 도구, stdio / SSE / HTTP 3가지 트랜스포트 지원 |
| MCP Server | 내장: 워크스페이스별 `/mcp/<endpoint_id>` 엔드포인트 게시(Streamable HTTP), 엔드포인트마다 별도 토큰·지식베이스 범위·요청 제한·도구 그룹(검색, `ask`, Wiki, 명시적으로 켜는 쓰기 도구); Python 패키지 `tencent-weknora-mcp`는 지원 중단 |
**플랫폼**
| 기능 | 상세 |
|------|------|
| 배포 | 로컬 / Docker / Kubernetes (Helm), 프라이빗/오프라인 배포 지원 |
| UI | Web UI / RESTful API / CLI (`weknora`) / Chrome Extension / 웹사이트 임베드 Widget / WeChat 미니 프로그램 |
| UI | Web UI / RESTful API / CLI (`weknora`) / Chrome Extension / 웹사이트 임베드 Widget / WeChat 미니 프로그램; UI는 중국어 / 영어 / 일본어 / 한국어 / 러시아어 지원 |
| 관측 가능성 | Langfuse(단일 추적 백엔드)로 ReAct 루프·토큰 소비·도구 호출·파이프라인 추적; Langfuse 스타일의 문서 파싱 추적 타임라인 내장으로 단계별 진행 표시; 시스템 관리자용 런타임 작업 큐 대시보드(큐 깊이·모델별 동시성·실패 작업 조사 및 수동 재시도) |
| 작업 관리 | MQ 비동기 작업, 단계별 Worker 풀 거버넌스(core / 후처리 / enrichment / maintenance + 탄력적 공유 풀, Wiki 독립 풀)와 모델별 백그라운드 동시성 거버너; 버전 업그레이드 시 자동 DB 마이그레이션 |
| 모델 관리 | 중앙 설정, YAML 선언형 내장 모델 구성, 지식베이스별 모델 선택, 모델별 사고 모드·Embedding 차원 덮어쓰기, 대화형 모델 디버거, 멀티테넌트 내장 모델 공유, WeKnora Cloud 호스팅 모델 및 문서 파싱 |
| 모델 관리 | 중앙 설정, YAML 선언형 내장 모델 구성, 지식베이스별 모델 선택, 모델별 사고 모드·Embedding 차원 덮어쓰기, 대화형 모델 디버거, 멀티테넌트 내장 모델 공유, WeKnora Cloud 호스팅 모델 및 문서 파싱; 모델 카탈로그가 컨텍스트 윈도우·최대 출력·추론 단계·비전 지원을 자동으로 채우고, 실제 호출 미리보기와 모델별 프로토콜 덮어쓰기 지원 |
## 🧩 Chrome 확장 프로그램
@ -271,7 +275,7 @@ WeKnora는 문서를 지식 그래프로 변환해 문서 내 서로 다른 섹
## MCP 서버
필요한 설정은 [MCP 설정 가이드](./mcp-server/MCP_CONFIG.md)를 참고하세요.
WeKnora에는 MCP Server가 내장되어 있습니다. 「설정 → 게시 및 통합 → MCP 서버」에서 엔드포인트를 만들고, 클라이언트에서 Streamable HTTP로 `/mcp/<endpoint_id>`에 연결하세요. 자세한 내용은 [MCP 문서](./website-docs/03-features/08-mcp.md)(중국어)를 참고하세요. [`mcp-server/`](./mcp-server/MCP_CONFIG.md)의 독립 Python 서버는 지원 중단되었으며 기존 배포와의 호환을 위해서만 남아 있습니다.
## 🔌 WeChat 대화 오픈 플랫폼 사용

View File

@ -1,6 +1,6 @@
# v0.8.2 版本说明
发布日期:2026-09-23
发布日期:2026-09-24
v0.8.2 让智能体走出对话框:它可以操作你电脑上的浏览器;知识库可以作为 MCP Server 发布给 Claude、Cursor 等其他 AI 工具;对话过程也更可控,可以中途补充要求、分叉或回滚。沙箱新增交互终端和图形桌面,模型接入改为按厂商目录自动配置,另有 Confluence、钉钉文档数据源和日语界面等更新。