XiuChengWu
ba7382db2a
- Implemented the OpenAI-compatible AI provider plugin, including configuration, chat, and chat_stream functionalities. - Added support for SSE streaming and tool calls. - Integrated Boost.JSON for JSON handling. - Created CMake configuration for the plugin. - Added error handling and logging throughout the plugin.
77 lines
3.1 KiB
Markdown
77 lines
3.1 KiB
Markdown
# dstalk 模块目录和功能说明
|
||
|
||
## 一、核心网关模块
|
||
|
||
| 目录 | 功能说明 |
|
||
|------|---------|
|
||
| `dstalk_core/` | 核心网关库（dstalk.dll / libdstalk.so），提供插件加载、服务注册、事件总线、配置存储、日志、内存管理 |
|
||
|
||
## 二、前端模块
|
||
|
||
| 目录 | 功能说明 |
|
||
|------|---------|
|
||
| `dstalk_cli/` | 命令行前端：ANSI 终端交互、命令解析、流式对话、工具调用、批处理/管道模式 |
|
||
| `dstalk_gui/` | 图形界面前端：SDL3 窗口化界面、暗色主题、流式对话（默认关闭） |
|
||
| `dstalk_web/` | Web 前端：Boost.Beast HTTP + SSE 流式推送、内嵌 HTML/CSS/JS 聊天界面（默认关闭） |
|
||
|
||
## 三、插件模块
|
||
|
||
插件按依赖层级分布在三个目录下，通过 C ABI 与核心网关通信。
|
||
|
||
### 3.1 基础插件（无依赖）
|
||
|
||
不依赖任何其他插件，可独立加载运行。
|
||
|
||
| 目录 | 服务名 | 功能说明 |
|
||
|------|--------|---------|
|
||
| `plugins_base/config/` | `"config"` | TOML 配置文件解析、键值读写 |
|
||
| `plugins_base/file_io/` | `"file_io"` | 文件读写服务 |
|
||
| `plugins_base/lsp/` | `"lsp"` | 语言服务器协议 JSON-RPC 客户端（诊断、悬停、补全），自行管理子进程 |
|
||
|
||
### 3.2 只依赖基础插件的插件
|
||
|
||
仅依赖 3.1 中的基础插件，不依赖同级或上层插件。
|
||
|
||
| 目录 | 服务名 | 功能说明 | 依赖 |
|
||
|------|--------|---------|------|
|
||
| `plugins_middle/network/` | `"http"` | HTTP/HTTPS POST 和流式请求（Boost.Beast + OpenSSL） | `config` |
|
||
| `plugins_middle/session/` | `"session"` | 会话消息历史管理、保存/加载、Token 计数 | `file_io` |
|
||
| `plugins_middle/tools/` | `"tools"` | 工具注册、Schema 管理、执行分发（内置 file_read/file_write） | `file_io` |
|
||
|
||
### 3.3 依赖其他插件的插件
|
||
|
||
依赖 3.2 或更多层级的插件。
|
||
|
||
| 目录 | 服务名 | 功能说明 | 依赖 |
|
||
|------|--------|---------|------|
|
||
| `plugins_upper/context/` | `"context"` | Token 计数（UTF-8 字节估算）、上下文窗口裁剪 | `session` |
|
||
| `plugins_upper/openai/` | `"ai.openai"` | OpenAI 兼容格式 AI 接入（chat/stream/tools、SSE 解析） | `http`、`config` |
|
||
| `plugins_upper/anthropic/` | `"ai.anthropic"` | Anthropic Claude Messages API 接入（chat/stream、SSE 解析） | `http`、`config` |
|
||
|
||
### 3.4 规划中的插件（尚未实现）
|
||
|
||
| 模块 | 服务名（建议） | 功能说明 | 分类 |
|
||
|------|---------------|---------|------|
|
||
| Anthropic↔OpenAI 格式转换 | `"format.convert"` | 双向请求/响应/SSE 流格式转换 | 依赖其他插件 |
|
||
| AI 自动识别接口 | `"ai.auto"` | 自动检测可用 AI 提供者并统一路由 | 依赖其他插件 |
|
||
| 数据库 | `"database"` | 数据库连接和查询服务 | 基础插件 |
|
||
|
||
## 四、插件依赖关系图
|
||
|
||
```
|
||
第一层（基础插件，无依赖）:
|
||
config file_io lsp
|
||
|
||
第二层（只依赖基础插件）:
|
||
network ← config
|
||
session ← file_io
|
||
tools ← file_io
|
||
|
||
第三层（依赖其他插件）:
|
||
context ← session
|
||
openai ← http, config
|
||
anthropic ← http, config
|
||
```
|
||
|
||
加载顺序由 Kahn 拓扑排序自动计算。
|