Skip to content

Commit 5a4a9d4

Browse files
committed
doc: Updated documentation to version v2.2.0
1 parent 331ed65 commit 5a4a9d4

7 files changed

Lines changed: 82 additions & 7 deletions

File tree

CHANGELOG.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,31 @@ group changes under a level-2 heading that matches the release tag, such as
77
`## v2.0.0`; the release workflow uses that section as the GitHub release notes
88
when the matching tag is pushed.
99

10+
## v2.2.0
11+
12+
- **New capabilities:** Added native Anthropic Messages API support through the
13+
official SDK, including provider-specific streaming and tool-call handling.
14+
- **MCP integration:** Added remote `streamable-http` MCP server discovery from
15+
the official MCP Registry, custom server installation, header authentication,
16+
tool registration, server-side execution, caching, pagination, and hosted URL
17+
safety controls. Local stdio, npm, Docker, and OAuth transports remain out of
18+
scope for this version.
19+
- **Reliability and security:** Strengthened API route access policy, request
20+
body and response limits, terminal stream validation, context budgeting and
21+
compression, outbound URL/DNS checks, shared plugin registration, and Worker
22+
gzip-size and deployment dry-run validation.
23+
- **Architecture and maintainability:** Split the chat shell, composer,
24+
message editor, Markdown diagram rendering, and chat-service orchestration
25+
into smaller components, hooks, and domain modules while preserving the
26+
existing user-facing workflows.
27+
- **Fixes and experience:** Fixed known issues across branch-preserving chat
28+
history, tool-call completion, provider response handling, image/export
29+
fallback, memory/RAG/search/voice workflows, settings, loading/error states,
30+
and accessibility behavior.
31+
- **Engineering and documentation:** Aligned local, CI, Docker, and Worker
32+
guidance around Node 22 and pnpm 10.30.3, added artifact-hygiene checks, and
33+
synchronized Anthropic, MCP, privacy, security, and deployment documentation.
34+
1035
## v2.1.0
1136

1237
- Rebuilt System Settings with clearer grouped controls, an About panel,

README.md

Lines changed: 17 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -20,9 +20,23 @@
2020
<img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-5-3178c6" />
2121
</p>
2222

23-
Neo Chat is a self-hostable, local-first AI chat application built with Next.js, React, TypeScript, and Zustand. It brings multi-provider chat, assistant presets, text-only Skills, OpenAPI-style plugin tools, web search, knowledge-base RAG, local memory, voice, generated media, rich message rendering, citations, and editable artifacts into one clean workspace.
24-
25-
It is designed for people who want the power of modern AI workspaces without giving up local data ownership. Chat history, workspace metadata, skills, plugin configuration, memories, and files stay in the browser by default; server routes act as controlled proxies for model providers, search, RAG, document parsing, voice, plugin execution, and deployment health.
23+
Neo Chat is a self-hostable, local-first AI chat application built with Next.js, React, TypeScript, and Zustand. It brings multi-provider chat, assistant presets, text-only Skills, OpenAPI-style plugin tools, remote streamable HTTP MCP servers, web search, knowledge-base RAG, local memory, voice, generated media, rich message rendering, citations, and editable artifacts into one clean workspace.
24+
25+
It is designed for people who want the power of modern AI workspaces without giving up local data ownership. Chat history, workspace metadata, skills, plugin configuration, memories, and files stay in the browser by default; server routes act as controlled proxies for model providers, search, RAG, document parsing, voice, plugin and MCP execution, and deployment health.
26+
27+
## v2.2.0 Highlights
28+
29+
- Added native Anthropic Messages API support through the official SDK.
30+
- Added remote streamable HTTP MCP server discovery and installation from the
31+
official MCP Registry, with plugin-market management, authentication, and
32+
server-side tool execution. This release intentionally supports remote MCP
33+
servers only.
34+
- Strengthened provider requests, API route policy, context budgeting,
35+
outbound URL safety, plugin registration, and Worker deployment validation.
36+
- Reconstructed the chat shell, composer, message rendering, and chat service
37+
internals into smaller modules while preserving existing workflows.
38+
- Fixed known issues across chat history, tool calls, provider streams, media
39+
and exports, memory/RAG/search/voice flows, settings, and accessibility.
2640

2741
## v2.1.0 Highlights
2842

README.zh-CN.md

Lines changed: 16 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -20,9 +20,22 @@
2020
<img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-5-3178c6" />
2121
</p>
2222

23-
Neo Chat 是一个可自托管、本地优先的 AI 对话应用,基于 Next.js、React、TypeScript 和 Zustand 构建。它把多供应商模型、助理预设、纯文本技能、OpenAPI 风格插件工具、联网搜索、知识库 RAG、本地记忆、语音、生成媒体、富消息渲染、引用和可编辑产物整合到一个干净的工作台中。
24-
25-
它适合想使用现代 AI 工作台、同时保持本地数据所有权的用户。默认情况下,对话历史、工作区元数据、技能、插件配置、记忆和文件都保存在浏览器内;服务端路由作为受控代理,连接模型供应商、搜索、RAG、文档解析、语音、插件执行和部署健康检查。
23+
Neo Chat 是一个可自托管、本地优先的 AI 对话应用,基于 Next.js、React、TypeScript 和 Zustand 构建。它把多供应商模型、助理预设、纯文本技能、OpenAPI 风格插件工具、远程 streamable HTTP MCP 服务器、联网搜索、知识库 RAG、本地记忆、语音、生成媒体、富消息渲染、引用和可编辑产物整合到一个干净的工作台中。
24+
25+
它适合想使用现代 AI 工作台、同时保持本地数据所有权的用户。默认情况下,对话历史、工作区元数据、技能、插件配置、记忆和文件都保存在浏览器内;服务端路由作为受控代理,连接模型供应商、搜索、RAG、文档解析、语音、插件与 MCP 执行和部署健康检查。
26+
27+
## v2.2.0 亮点
28+
29+
- 通过官方 SDK 新增 Anthropic 原生 Messages API 支持。
30+
- 新增从官方 MCP Registry 发现和安装远程 streamable HTTP MCP 服务器,
31+
支持插件市场管理、鉴权和服务端工具执行;本版本明确只支持远程 MCP
32+
服务器。
33+
- 加强供应商请求、API 路由策略、上下文预算、出站 URL 安全、插件注册表
34+
和 Worker 部署校验。
35+
- 将聊天壳层、输入框、消息渲染和聊天服务内部拆分为更小的模块,同时保持
36+
现有用户流程。
37+
- 修复聊天历史、工具调用、供应商流式响应、媒体与导出、记忆/RAG/搜索/语音、
38+
设置和无障碍相关的已知问题。
2639

2740
## v2.1.0 亮点
2841

docs/deployment-hardening.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -188,6 +188,13 @@ a plugin is enabled for a chat, runtime tool calls execute automatically without
188188
a per-call confirmation modal. See [Reliability and Safety Model](reliability-and-safety.md)
189189
for tool execution boundaries, context budgeting, and recovery behavior.
190190

191+
Remote MCP servers use the same server-registered plugin path and outbound URL
192+
policy. Neo Chat v1 supports only remote `streamable-http` MCP over HTTPS;
193+
hosted deployments block localhost and private-network MCP targets unless
194+
`ALLOW_LOCAL_NETWORK_PROXY=true` is explicitly enabled. Hosted or multi-instance
195+
deployments should configure `PLUGIN_REGISTRY_STORE=upstash` so installed MCP
196+
tools resolve consistently across instances.
197+
191198
## Deployment Health
192199

193200
Settings includes a deployment health panel backed by `/api/health`. The route

docs/privacy-and-local-data.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -73,6 +73,12 @@ plugin requests, and BYOK envelopes. Local memory tool results may also be
7373
present in model request context. Deployments should treat server logs,
7474
observability tools, and hosting provider logs as sensitive.
7575

76+
Remote MCP calls send model-generated tool arguments, including any context the
77+
tool arguments contain, to the configured MCP server. MCP tool results return
78+
through the plugin execution route and may be included in a subsequent model
79+
request. Treat every MCP server as a third-party service with its own logging,
80+
retention, and external side-effect behavior.
81+
7682
Neo Chat validates request payloads, applies URL safety gates, limits response
7783
sizes, and uses hosted-mode restrictions, but upstream providers still receive
7884
the content required to complete user-requested actions.
@@ -86,6 +92,8 @@ Depending on configuration, user content may be sent to:
8692
- RAG/vector services and document parsers such as Mineru or LlamaParse.
8793
- Voice providers such as ElevenLabs or Mimo.
8894
- Plugin APIs enabled by the user.
95+
- Remote MCP servers installed from the Registry or configured through a custom
96+
HTTPS endpoint.
8997

9098
Text-only skills themselves are local prompt instructions, but applied skill
9199
content can be sent to the selected model provider as part of the prompt.

docs/reliability-and-safety.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,14 @@ policy, response limits, and the configured tool-call round ceiling. Hosted
5454
deployments still require server-registered plugins; client-submitted legacy
5555
plugin definitions remain blocked.
5656

57+
MCP-backed functions add a remote side-effect boundary: the MCP server owns the
58+
tool implementation and may perform external actions. The supported MCP
59+
transport is remote `streamable-http` over HTTPS. Installation and execution
60+
use the same server-side plugin registration, outbound URL policy, response
61+
limits, and hosted local-network restrictions as other network-capable
62+
plugins. MCP results are also bounded before they enter tool details or later
63+
model context.
64+
5765
Built-in plugin IDs are reserved. Custom or manifest-installed plugins cannot
5866
override them, and built-ins take precedence if a stale mutable registry entry
5967
uses the same ID. If multiple active plugins expose the same function name, tool

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
"name": "neo-chat",
33
"description": "An omni AI chat application with a clean UI and excellent performance.",
44
"private": true,
5-
"version": "2.1.0",
5+
"version": "2.2.0",
66
"license": "MIT",
77
"packageManager": "pnpm@10.30.3",
88
"type": "module",

0 commit comments

Comments
 (0)