Add Chinese README and docs

Author: Sunrisepeak

README.zh.hant.md

@@ -1,86 +1,96 @@
 # llmapi
 
-> Modern C++ LLM API client with openai-compatible support
+> 使用 C++23 模組建構的現代 LLM 客戶端
 
 [![C++23](https://img.shields.io/badge/C%2B%2B-23-blue.svg)](https://en.cppreference.com/w/cpp/23)
 [![Module](https://img.shields.io/badge/module-ok-green.svg)](https://en.cppreference.com/w/cpp/language/modules)
 [![License](https://img.shields.io/badge/license-Apache_2.0-blue.svg)](LICENSE)
-[![OpenAI Compatible](https://img.shields.io/badge/OpenAI_API-Compatible-green.svg)](https://platform.openai.com/docs/api-reference)
+[![OpenAI Compatible](https://img.shields.io/badge/OpenAI-Compatible-green.svg)](https://platform.openai.com/docs/api-reference)
 
 | [English](README.md) - [简体中文](README.zh.md) - 繁體中文 |
 |:---:|
-| [完整文件](docs/) - [C++ API](docs/cpp-api.md) - [C API](docs/c-api.md) - [範例](docs/examples.md) |
+| [中文文件](docs/README.zh.hant.md) - [C++ API](docs/cpp-api.zh.hant.md) - [範例](docs/examples.zh.hant.md) |
 
-簡潔、型別安全的 LLM API 客戶端，使用 C++23 模組。流式介面設計，零成本抽象。支援 OpenAI、Poe、DeepSeek 及相容端點。
+`llmapi` 提供型別化的 `Client<Provider>` API，涵蓋聊天、串流輸出、embeddings、工具呼叫與對話持久化。預設別名 `Config` 對應 OpenAI 風格設定，常見情況下不需要顯式寫出 `openai::OpenAI(...)`。
 
-## ✨ 特性
+## 特性
 
-- **C++23 模組** - `import mcpplibs.llmapi`
-- **自動儲存歷史** - 對話歷史自動管理
-- **型別安全串流** - 概念約束的回呼函式
-- **流式介面** - 可鏈式呼叫的方法
-- **提供商無關** - OpenAI、Poe 及相容端點
+- C++23 模組：`import mcpplibs.llmapi`
+- 強型別訊息、工具與回應結構
+- 同步、非同步、串流聊天介面
+- OpenAI Provider 支援 embeddings
+- 支援儲存 / 載入對話歷史
+- 可透過 `baseUrl` 存取 OpenAI 相容端點
 
 ## 快速開始
 
-
 ```cpp
-import std;
 import mcpplibs.llmapi;
+import std;
 
 int main() {
-    using namespace mcpplibs;
-    
-    llmapi::Client client(std::getenv("OPENAI_API_KEY"), llmapi::URL::Poe);
-
-    client.model("gpt-5")
-          .system("You are a helpful assistant.")
-          .user("In one sentence, introduce modern C++. 並給出中文翻譯")
-          .request([](std::string_view chunk) {
-                std::print("{}", chunk);
-                std::cout.flush();
-          });
+    using namespace mcpplibs::llmapi;
+
+    auto apiKey = std::getenv("OPENAI_API_KEY");
+    if (!apiKey) {
+        std::cerr << "OPENAI_API_KEY not set\n";
+        return 1;
+    }
 
+    auto client = Client(Config{
+        .apiKey = apiKey,
+        .model = "gpt-4o-mini",
+    });
+
+    client.system("You are a concise assistant.");
+    auto resp = client.chat("用兩句話解釋 C++23 模組的價值。");
+
+    std::cout << resp.text() << '\n';
     return 0;
 }
 ```
 
-### 模型 / 提供商
+## Provider
+
+- `Config`：`openai::Config` 的匯出別名，預設走 OpenAI 風格
+- `openai::OpenAI`：OpenAI 聊天、串流、工具呼叫、embeddings
+- `AnthropicConfig` / `anthropic::Anthropic`：Anthropic 聊天與串流
+
+相容端點範例：
 
 ```cpp
-llmapi::Client client(apiKey, llmapi::URL::OpenAI);    // OpenAI
-llmapi::Client client(apiKey, llmapi::URL::Poe);       // Poe
-llmapi::Client client(apiKey, llmapi::URL::DeepSeek);  // Deepseek
-llmapi::Client client(apiKey, "https://custom.com");   // 自訂
+auto client = Client(Config{
+    .apiKey = std::getenv("DEEPSEEK_API_KEY"),
+    .baseUrl = std::string(URL::DeepSeek),
+    .model = "deepseek-chat",
+});
 ```
 
-## 🛠️ 建置
+## 建置與執行
 
 ```bash
-xmake              # 建置
-xmake run basic    # 執行範例（需先設定 OPENAI_API_KEY）
+xmake
+xmake run hello_mcpp
+xmake run basic
+xmake run chat
 ```
 
-## 📦 在建置工具中使用
-
-### xmake
+## 套件管理使用
 
 ```lua
--- 0 - 新增 mcpplibs 索引倉庫
-add_repositories("mcpplibs-index https://github.com/mcpplibs/llmapi.git")
-
--- 1 - 新增需要的函式庫和版本
+add_repositories("mcpplibs-index https://github.com/mcpplibs/mcpplibs-index.git")
 add_requires("llmapi 0.0.2")
-```
-
-> More: [mcpplibs-index](https://github.com/mcpplibs/mcpplibs-index)
 
-### cmake
-
-```
-todo...
+target("demo")
+    set_kind("binary")
+    set_languages("c++23")
+    set_policy("build.c++.modules", true)
+    add_files("src/*.cpp")
+    add_packages("llmapi")
 ```
 
-## 📄 授權條款
+更多內容見 [docs/getting-started.zh.hant.md](docs/getting-started.zh.hant.md) 與 [docs/providers.zh.hant.md](docs/providers.zh.hant.md)。
+
+## 授權
 
-Apache-2.0 - 詳見 [LICENSE](LICENSE)
+Apache-2.0，詳見 [LICENSE](LICENSE)

README.zh.md

@@ -1,85 +1,96 @@
 # llmapi
 
-> Modern C++ LLM API client with openai-compatible support
+> 使用 C++23 模块构建的现代 LLM 客户端
 
 [![C++23](https://img.shields.io/badge/C%2B%2B-23-blue.svg)](https://en.cppreference.com/w/cpp/23)
 [![Module](https://img.shields.io/badge/module-ok-green.svg)](https://en.cppreference.com/w/cpp/language/modules)
 [![License](https://img.shields.io/badge/license-Apache_2.0-blue.svg)](LICENSE)
-[![OpenAI Compatible](https://img.shields.io/badge/OpenAI_API-Compatible-green.svg)](https://platform.openai.com/docs/api-reference)
+[![OpenAI Compatible](https://img.shields.io/badge/OpenAI-Compatible-green.svg)](https://platform.openai.com/docs/api-reference)
 
 | [English](README.md) - 简体中文 - [繁體中文](README.zh.hant.md) |
 |:---:|
-| [完整文档](docs/) - [C++ API](docs/cpp-api.md) - [C API](docs/c-api.md) - [示例](docs/examples.md) |
+| [中文文档](docs/README.zh.md) - [C++ API](docs/cpp-api.zh.md) - [示例](docs/examples.zh.md) |
 
-简洁、类型安全的 LLM API 客户端，使用 C++23 模块。流式接口设计，零成本抽象。支持 OpenAI、Poe、DeepSeek 及兼容端点。
+`llmapi` 提供类型化的 `Client<Provider>` API，覆盖聊天、流式输出、嵌入、工具调用与对话持久化。默认别名 `Config` 对应 OpenAI 风格配置，常见场景不需要显式写 `openai::OpenAI(...)`。
 
-## ✨ 特性
+## 特性
 
-- **C++23 模块** - `import mcpplibs.llmapi`
-- **自动保存历史** - 对话历史自动管理
-- **类型安全流式** - 概念约束的回调函数
-- **流式接口** - 可链式调用的方法
-- **提供商无关** - OpenAI、Poe 及兼容端点
+- C++23 模块：`import mcpplibs.llmapi`
+- 强类型消息、工具与响应结构
+- 同步、异步、流式聊天接口
+- OpenAI Provider 支持 embeddings
+- 支持保存 / 加载对话历史
+- 可通过 `baseUrl` 访问 OpenAI 兼容端点
 
 ## 快速开始
 
 ```cpp
-import std;
 import mcpplibs.llmapi;
+import std;
 
 int main() {
-    using namespace mcpplibs;
-    
-    llmapi::Client client(std::getenv("OPENAI_API_KEY"), llmapi::URL::Poe);
-
-    client.model("gpt-5")
-          .system("You are a helpful assistant.")
-          .user("In one sentence, introduce modern C++. 并给出中文翻译")
-          .request([](std::string_view chunk) {
-                std::print("{}", chunk);
-                std::cout.flush();
-          });
+    using namespace mcpplibs::llmapi;
+
+    auto apiKey = std::getenv("OPENAI_API_KEY");
+    if (!apiKey) {
+        std::cerr << "OPENAI_API_KEY not set\n";
+        return 1;
+    }
+
+    auto client = Client(Config{
+        .apiKey = apiKey,
+        .model = "gpt-4o-mini",
+    });
 
+    client.system("You are a concise assistant.");
+    auto resp = client.chat("用两句话解释 C++23 模块的价值。");
+
+    std::cout << resp.text() << '\n';
     return 0;
 }
 ```
 
-### 模型 / 提供商
+## Provider
+
+- `Config`：`openai::Config` 的导出别名，默认走 OpenAI 风格
+- `openai::OpenAI`：OpenAI 聊天、流式、工具调用、embeddings
+- `AnthropicConfig` / `anthropic::Anthropic`：Anthropic 聊天与流式
+
+兼容端点示例：
 
 ```cpp
-llmapi::Client client(apiKey, llmapi::URL::OpenAI);    // OpenAI
-llmapi::Client client(apiKey, llmapi::URL::Poe);       // Poe
-llmapi::Client client(apiKey, llmapi::URL::DeepSeek);  // Deepseek
-llmapi::Client client(apiKey, "https://custom.com");   // 自定义
+auto client = Client(Config{
+    .apiKey = std::getenv("DEEPSEEK_API_KEY"),
+    .baseUrl = std::string(URL::DeepSeek),
+    .model = "deepseek-chat",
+});
 ```
 
-## 构建
+## 构建与运行
 
 ```bash
-xmake              # 构建
-xmake run basic    # 运行示例（需要先配置 OPENAI_API_KEY）
+xmake
+xmake run hello_mcpp
+xmake run basic
+xmake run chat
 ```
 
-## 在构建工具中使用
-
-### xmake
+## 包管理使用
 
 ```lua
--- 0 - 添加 mcpplibs 索引仓库
-add_repositories("mcpplibs-index https://github.com/mcpplibs/llmapi.git")
-
--- 1 - 添加需要的库和版本
+add_repositories("mcpplibs-index https://github.com/mcpplibs/mcpplibs-index.git")
 add_requires("llmapi 0.0.2")
-```
-
-> More: [mcpplibs-index](https://github.com/mcpplibs/mcpplibs-index)
 
-### cmake
-
-```
-todo...
+target("demo")
+    set_kind("binary")
+    set_languages("c++23")
+    set_policy("build.c++.modules", true)
+    add_files("src/*.cpp")
+    add_packages("llmapi")
 ```
 
-## 📄 许可证
+更多内容见 [docs/getting-started.zh.md](docs/getting-started.zh.md) 与 [docs/providers.zh.md](docs/providers.zh.md)。
+
+## 许可证
 
-Apache-2.0 - 详见 [LICENSE](LICENSE)
+Apache-2.0，详见 [LICENSE](LICENSE)

docs/README.zh.hant.md

@@ -0,0 +1,20 @@
+# llmapi 中文文件
+
+`llmapi` 是一個基於 C++23 模組的 LLM 客戶端函式庫。
+
+## 內容導覽
+
+- [快速開始](getting-started.zh.hant.md)
+- [C++ API 參考](cpp-api.zh.hant.md)
+- [範例](examples.zh.hant.md)
+- [Provider 設定](providers.zh.hant.md)
+- [進階用法](advanced.zh.hant.md)
+
+## 核心能力
+
+- `import mcpplibs.llmapi`
+- 型別化訊息、工具與回應結構
+- Provider 概念約束
+- 內建 OpenAI / Anthropic 支援
+- OpenAI 相容端點支援
+- 對話儲存與還原

docs/README.zh.md

@@ -0,0 +1,20 @@
+# llmapi 中文文档
+
+`llmapi` 是一个基于 C++23 模块的 LLM 客户端库。
+
+## 内容导航
+
+- [快速开始](getting-started.zh.md)
+- [C++ API 参考](cpp-api.zh.md)
+- [示例](examples.zh.md)
+- [Provider 配置](providers.zh.md)
+- [高级用法](advanced.zh.md)
+
+## 核心能力
+
+- `import mcpplibs.llmapi`
+- 类型化消息、工具和响应结构
+- Provider 概念约束
+- OpenAI / Anthropic 内置支持
+- OpenAI 兼容端点支持
+- 对话保存与恢复

docs/advanced.zh.hant.md

@@ -0,0 +1,40 @@
+# 進階用法
+
+## 對話持久化
+
+```cpp
+client.chat("記住我偏好簡潔回答。");
+client.save_conversation("session.json");
+```
+
+## 手動注入訊息
+
+```cpp
+client.add_message(Message::system("Translate English to Chinese."));
+client.add_message(Message::user("hello"));
+client.add_message(Message::assistant("你好"));
+```
+
+## 非同步介面
+
+```cpp
+auto task = client.chat_async("簡要解釋 coroutine。");
+auto resp = task.get();
+```
+
+## 工具呼叫流程
+
+```cpp
+auto first = client.chat("東京天氣如何？", params);
+for (const auto& call : first.tool_calls()) {
+    client.add_message(Message{
+        .role = Role::Tool,
+        .content = std::vector<ContentPart>{
+            ToolResultContent{
+                .toolUseId = call.id,
+                .content = R"({"temperature":"22C","condition":"sunny"})",
+            },
+        },
+    });
+}
+```