Fix API section, binary name, and remaining inaccuracies
Major: Public C API section now shows the real dstalk_host.h API with service-vtable pattern (dstalk_service_query + 8 vtable types) instead of the fabricated flat C API from dstalk_api.h which does not exist. Other fixes: - Binary name: dstalk-core.dll → dstalk.dll (matching CMake target) - Test count: 8 → 9 (added network_plugin_test.cpp) - Features card: updated ABI description to mention service vtables - Terminal demo: file path dstalk_api.h → dstalk_host.h - Tech stack: header reference dstalk_api.h → dstalk_host.h - Docs row: added docs/explanation/ (architecture, plugin-lifecycle, security-logging) - en.html favicon: translated remaining Chinese 图层 1 → Layer 1 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
78
index.html
78
index.html
@@ -3,10 +3,10 @@
|
|||||||
<head>
|
<head>
|
||||||
<meta charset="UTF-8">
|
<meta charset="UTF-8">
|
||||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||||
<meta name="description" content="dstalk 是基于 DeepSeek V4、兼容 OpenAI / Anthropic API 的 C/C++ AI 编程 CLI，采用 dstalk-core.dll 插件宿主 + 多前端解耦架构。">
|
<meta name="description" content="dstalk 是基于 DeepSeek V4、兼容 OpenAI / Anthropic API 的 C/C++ AI 编程 CLI，采用 dstalk.dll 插件宿主 + 多前端解耦架构。">
|
||||||
<meta name="theme-color" content="#0b1020">
|
<meta name="theme-color" content="#0b1020">
|
||||||
<meta property="og:title" content="dstalk — C/C++ AI 编程 CLI">
|
<meta property="og:title" content="dstalk — C/C++ AI 编程 CLI">
|
||||||
<meta property="og:description" content="DeepSeek V4 驱动，C ABI 可嵌入，dstalk-core.dll 作为插件宿主，9 个功能插件覆盖 AI、网络、会话、LSP 与工具。">
|
<meta property="og:description" content="DeepSeek V4 驱动，C ABI 可嵌入，dstalk.dll 作为插件宿主，9 个功能插件覆盖 AI、网络、会话、LSP 与工具。">
|
||||||
<meta property="og:type" content="website">
|
<meta property="og:type" content="website">
|
||||||
<link rel="alternate" hreflang="zh-CN" href="https://dstalk.top/">
|
<link rel="alternate" hreflang="zh-CN" href="https://dstalk.top/">
|
||||||
<link rel="alternate" hreflang="en" href="https://dstalk.top/en.html">
|
<link rel="alternate" hreflang="en" href="https://dstalk.top/en.html">
|
||||||
@@ -213,7 +213,7 @@
|
|||||||
<div>
|
<div>
|
||||||
<div class="eyebrow">dstalk.top 是 dstalk 项目的官方网站</div>
|
<div class="eyebrow">dstalk.top 是 dstalk 项目的官方网站</div>
|
||||||
<h1><span>ds</span>talk</h1>
|
<h1><span>ds</span>talk</h1>
|
||||||
<p class="lead">基于 DeepSeek V4 大模型、兼容 OpenAI / Anthropic API 的 AI 编程 CLI。核心采用 C11 / C++20 编写，以 dstalk-core.dll 作为插件宿主暴露稳定 C ABI，9 个功能插件 (AI、网络、LSP、会话、文件、工具等) 编译为独立 DLL，通过统一接口接入 CLI、SDL3 GUI 与第三方宿主。</p>
|
<p class="lead">基于 DeepSeek V4 大模型、兼容 OpenAI / Anthropic API 的 AI 编程 CLI。核心采用 C11 / C++20 编写，以 dstalk.dll 作为插件宿主暴露稳定 C ABI，9 个功能插件 (AI、网络、LSP、会话、文件、工具等) 编译为独立 DLL，通过统一接口接入 CLI、SDL3 GUI 与第三方宿主。</p>
|
||||||
<div class="actions">
|
<div class="actions">
|
||||||
<a class="btn btn-primary" href="#quickstart">开始使用</a>
|
<a class="btn btn-primary" href="#quickstart">开始使用</a>
|
||||||
<a class="btn btn-secondary" href="https://git.pulsareon.com/pulsareon/dstalk">查看源代码</a>
|
<a class="btn btn-secondary" href="https://git.pulsareon.com/pulsareon/dstalk">查看源代码</a>
|
||||||
@@ -226,7 +226,7 @@
|
|||||||
<span class="badge">GPL v3.0</span>
|
<span class="badge">GPL v3.0</span>
|
||||||
</div>
|
</div>
|
||||||
<div class="stats" aria-label="项目状态">
|
<div class="stats" aria-label="项目状态">
|
||||||
<span class="stat"><strong>核心</strong>dstalk-core.dll (插件宿主)</span>
|
<span class="stat"><strong>核心</strong>dstalk.dll (插件宿主)</span>
|
||||||
<span class="stat"><strong>前端</strong>CLI + SDL3 GUI</span>
|
<span class="stat"><strong>前端</strong>CLI + SDL3 GUI</span>
|
||||||
<span class="stat"><strong>插件</strong>deepseek · anthropic · network · lsp · session · context · config · file-io · tools</span>
|
<span class="stat"><strong>插件</strong>deepseek · anthropic · network · lsp · session · context · config · file-io · tools</span>
|
||||||
</div>
|
</div>
|
||||||
@@ -243,8 +243,8 @@ AI: dstalk-core 是插件宿主，负责插件加载、服务注册、
|
|||||||
事件总线和配置管理；AI、网络、会话、LSP、文件 IO
|
事件总线和配置管理；AI、网络、会话、LSP、文件 IO
|
||||||
等能力都由独立插件提供，前端只处理输入与渲染。
|
等能力都由独立插件提供，前端只处理输入与渲染。
|
||||||
|
|
||||||
> /file read dstalk-core/include/dstalk/dstalk_api.h
|
> /file read dstalk-core/include/dstalk/dstalk_host.h
|
||||||
<span class="dim">--- dstalk-core/include/dstalk/dstalk_api.h ---</span></code></pre>
|
<span class="dim">--- dstalk-core/include/dstalk/dstalk_host.h ---</span></code></pre>
|
||||||
</div>
|
</div>
|
||||||
</header>
|
</header>
|
||||||
|
|
||||||
@@ -256,7 +256,7 @@ AI: dstalk-core 是插件宿主，负责插件加载、服务注册、
|
|||||||
</div>
|
</div>
|
||||||
<div class="cards">
|
<div class="cards">
|
||||||
<article class="card"><div class="icon">C</div><h3>零 Node.js 运行时</h3><p>核心以 C11 / C++20 构建，目标是毫秒级启动和更低内存占用，适合终端长期交互。</p></article>
|
<article class="card"><div class="icon">C</div><h3>零 Node.js 运行时</h3><p>核心以 C11 / C++20 构建，目标是毫秒级启动和更低内存占用，适合终端长期交互。</p></article>
|
||||||
<article class="card"><div class="icon">ABI</div><h3>稳定 C ABI</h3><p>公开 dstalk_init、dstalk_chat、dstalk_file_read 等 C 函数，方便 C/C++、Python、Rust、C#、Go 嵌入。</p></article>
|
<article class="card"><div class="icon">ABI</div><h3>稳定 C ABI</h3><p>公开 dstalk_init、dstalk_service_query 等宿主函数和 8 种服务 vtable (AI、会话、HTTP、文件、LSP 等)，方便 C/C++、Python、Rust、C#、Go 嵌入。</p></article>
|
||||||
<article class="card"><div class="icon">AI</div><h3>多 API 兼容</h3><p>内置 DeepSeek 与 Anthropic 两个 AI 插件，兼容 OpenAI 风格接口；通过 config.toml 中的 ai.provider 一键切换。</p></article>
|
<article class="card"><div class="icon">AI</div><h3>多 API 兼容</h3><p>内置 DeepSeek 与 Anthropic 两个 AI 插件，兼容 OpenAI 风格接口；通过 config.toml 中的 ai.provider 一键切换。</p></article>
|
||||||
<article class="card"><div class="icon">CLI</div><h3>CLI 与 GUI 双前端</h3><p>dstalk-cli 提供 ANSI 终端 UI，dstalk-gui 基于 SDL3 跨平台窗口，共享同一组核心能力。</p></article>
|
<article class="card"><div class="icon">CLI</div><h3>CLI 与 GUI 双前端</h3><p>dstalk-cli 提供 ANSI 终端 UI，dstalk-gui 基于 SDL3 跨平台窗口，共享同一组核心能力。</p></article>
|
||||||
<article class="card"><div class="icon">PLG</div><h3>插件化宿主</h3><p>核心仅做插件加载、服务注册、事件总线和配置管理；AI、网络、LSP、会话等能力均为独立 DLL，可以替换或扩展。</p></article>
|
<article class="card"><div class="icon">PLG</div><h3>插件化宿主</h3><p>核心仅做插件加载、服务注册、事件总线和配置管理；AI、网络、LSP、会话等能力均为独立 DLL，可以替换或扩展。</p></article>
|
||||||
@@ -300,7 +300,7 @@ build/dstalk-cli/dstalk-cli.exe config.toml</code></pre>
|
|||||||
<section id="architecture" class="container section">
|
<section id="architecture" class="container section">
|
||||||
<div class="section-head">
|
<div class="section-head">
|
||||||
<h2>插件宿主 + 多前端解耦架构</h2>
|
<h2>插件宿主 + 多前端解耦架构</h2>
|
||||||
<p>dstalk-core.dll 作为插件宿主，负责插件加载、服务注册、事件总线和配置管理；AI、网络、LSP、会话、文件 IO、工具等 9 个功能插件编译为独立 DLL，前端只通过 C ABI 触达核心能力。GUI 通过 CMake 选项 DSTALK_BUILD_GUI 启用。</p>
|
<p>dstalk.dll 作为插件宿主，负责插件加载、服务注册、事件总线和配置管理；AI、网络、LSP、会话、文件 IO、工具等 9 个功能插件编译为独立 DLL，前端只通过 C ABI 触达核心能力。GUI 通过 CMake 选项 DSTALK_BUILD_GUI 启用。</p>
|
||||||
</div>
|
</div>
|
||||||
<div class="terminal architecture">
|
<div class="terminal architecture">
|
||||||
<div class="terminal-top"><span class="dot"></span><span class="dot"></span><span class="dot"></span><span class="terminal-title">architecture</span></div>
|
<div class="terminal-top"><span class="dot"></span><span class="dot"></span><span class="dot"></span><span class="terminal-title">architecture</span></div>
|
||||||
@@ -310,7 +310,7 @@ build/dstalk-cli/dstalk-cli.exe config.toml</code></pre>
|
|||||||
└───────────────────────┬─────────────────────────────┘
|
└───────────────────────┬─────────────────────────────┘
|
||||||
│ C ABI
|
│ C ABI
|
||||||
┌───────────────────────▼─────────────────────────────┐
|
┌───────────────────────▼─────────────────────────────┐
|
||||||
│ dstalk-core.dll — 插件宿主 │
|
│ dstalk.dll — 插件宿主 │
|
||||||
│ 插件加载 · 服务注册 · 事件总线 · 配置管理 │
|
│ 插件加载 · 服务注册 · 事件总线 · 配置管理 │
|
||||||
├───────────────┬───────────────┬─────────────────────┤
|
├───────────────┬───────────────┬─────────────────────┤
|
||||||
│ deepseek (ai) │ anthropic (ai)│ network (http) │
|
│ deepseek (ai) │ anthropic (ai)│ network (http) │
|
||||||
@@ -329,12 +329,12 @@ build/dstalk-cli/dstalk-cli.exe config.toml</code></pre>
|
|||||||
<div class="panel table-wrap">
|
<div class="panel table-wrap">
|
||||||
<table>
|
<table>
|
||||||
<tr><th>模块</th><th>当前技术</th><th>状态</th></tr>
|
<tr><th>模块</th><th>当前技术</th><th>状态</th></tr>
|
||||||
<tr><td>核心库</td><td>C11 / C++20，dstalk-core.dll，插件宿主，公开 C ABI</td><td><span class="ok">已启用</span></td></tr>
|
<tr><td>核心库</td><td>C11 / C++20，dstalk.dll，插件宿主，公开 C ABI</td><td><span class="ok">已启用</span></td></tr>
|
||||||
<tr><td>CLI 前端</td><td>ANSI 终端 UI，调用 dstalk/dstalk_api.h</td><td><span class="ok">已启用</span></td></tr>
|
<tr><td>CLI 前端</td><td>ANSI 终端 UI，调用 dstalk/dstalk_host.h</td><td><span class="ok">已启用</span></td></tr>
|
||||||
<tr><td>GUI 前端</td><td>SDL3 图形化前端，CMake 选项 DSTALK_BUILD_GUI 启用</td><td><span class="ok">已就位</span></td></tr>
|
<tr><td>GUI 前端</td><td>SDL3 图形化前端，CMake 选项 DSTALK_BUILD_GUI 启用</td><td><span class="ok">已就位</span></td></tr>
|
||||||
<tr><td>插件</td><td>9 个功能插件 (deepseek · anthropic · network · lsp · session · context · config · file-io · tools)，独立 DLL</td><td><span class="ok">已启用</span></td></tr>
|
<tr><td>插件</td><td>9 个功能插件 (deepseek · anthropic · network · lsp · session · context · config · file-io · tools)，独立 DLL</td><td><span class="ok">已启用</span></td></tr>
|
||||||
<tr><td>测试</td><td>8 个测试文件覆盖插件宿主、事件总线、服务注册、插件加载及各 AI 插件，CTest 集成</td><td><span class="ok">已启用</span></td></tr>
|
<tr><td>测试</td><td>9 个测试文件覆盖插件宿主、事件总线、服务注册、插件加载及各 AI 插件，CTest 集成</td><td><span class="ok">已启用</span></td></tr>
|
||||||
<tr><td>文档</td><td>docs/tutorial、docs/reference (commands、plugin-abi)</td><td><span class="ok">已发布</span></td></tr>
|
<tr><td>文档</td><td>docs/tutorial、docs/reference (commands、plugin-abi)、docs/explanation (architecture、plugin-lifecycle、security-logging)</td><td><span class="ok">已发布</span></td></tr>
|
||||||
<tr><td>示例</td><td>examples/example_plugin 展示插件开发模板</td><td><span class="ok">已提供</span></td></tr>
|
<tr><td>示例</td><td>examples/example_plugin 展示插件开发模板</td><td><span class="ok">已提供</span></td></tr>
|
||||||
<tr><td>依赖管理</td><td>Conan2，boost/1.86.0，openssl/3.4.1</td><td><span class="ok">已配置</span></td></tr>
|
<tr><td>依赖管理</td><td>Conan2，boost/1.86.0，openssl/3.4.1</td><td><span class="ok">已配置</span></td></tr>
|
||||||
<tr><td>构建系统</td><td>CMake 3.21+，Ninja，LLVM/Clang，CMakePresets</td><td><span class="ok">已配置</span></td></tr>
|
<tr><td>构建系统</td><td>CMake 3.21+，Ninja，LLVM/Clang，CMakePresets</td><td><span class="ok">已配置</span></td></tr>
|
||||||
@@ -364,27 +364,49 @@ build/dstalk-cli/dstalk-cli.exe config.toml</code></pre>
|
|||||||
<section id="api" class="container section">
|
<section id="api" class="container section">
|
||||||
<div class="section-head">
|
<div class="section-head">
|
||||||
<h2>公开 C API</h2>
|
<h2>公开 C API</h2>
|
||||||
<p>dstalk-core 通过 dstalk-core/include/dstalk/dstalk_api.h 暴露函数，前端和第三方宿主都通过同一组接口调用核心能力。</p>
|
<p>dstalk 通过 4 个公开头文件暴露能力：dstalk_host.h 管理宿主生命周期与插件，dstalk_services.h 定义 8 种服务 vtable，dstalk_lsp.h 提供独立 LSP 客户端，dstalk_types.h 共享消息与事件类型。前端通过 dstalk_service_query() 获取服务指针，再经函数指针调用具体能力。</p>
|
||||||
</div>
|
</div>
|
||||||
<div class="terminal">
|
<div class="terminal">
|
||||||
<div class="terminal-top"><span class="dot"></span><span class="dot"></span><span class="dot"></span><span class="terminal-title">dstalk_api.h</span></div>
|
<div class="terminal-top"><span class="dot"></span><span class="dot"></span><span class="dot"></span><span class="terminal-title">dstalk_host.h — 宿主 API</span></div>
|
||||||
<pre><code>int dstalk_init(const char* config_path);
|
<pre><code><span class="dim">// 生命周期</span>
|
||||||
void dstalk_destroy(void);
|
int dstalk_init(const char* config_path);
|
||||||
|
void dstalk_shutdown(void);
|
||||||
|
|
||||||
void dstalk_set_api_key(const char* api_key);
|
<span class="dim">// 插件管理</span>
|
||||||
void dstalk_set_base_url(const char* base_url);
|
int dstalk_plugin_load(const char* path);
|
||||||
void dstalk_set_model(const char* model);
|
int dstalk_plugin_unload(int plugin_id);
|
||||||
|
int dstalk_plugin_list(char** output_json);
|
||||||
|
void*dstalk_service_query(const char* name, int min_version);
|
||||||
|
|
||||||
int dstalk_chat(const char* input, char** output);
|
<span class="dim">// 事件系统</span>
|
||||||
int dstalk_chat_stream(const char* input, dstalk_stream_cb cb, void* userdata);
|
int dstalk_event_subscribe(int type, dstalk_event_handler_fn fn, void* ud);
|
||||||
void dstalk_free_string(char* str);
|
int dstalk_event_emit(int type, const void* data);
|
||||||
|
void dstalk_event_unsubscribe(int sub_id);
|
||||||
|
|
||||||
void dstalk_session_clear(void);
|
<span class="dim">// 配置 / 内存 / 诊断</span>
|
||||||
int dstalk_session_save(const char* path);
|
const char* dstalk_config_get(const char* key);
|
||||||
int dstalk_session_load(const char* path);
|
int dstalk_config_set(const char* key, const char* value);
|
||||||
|
void*dstalk_alloc(size_t size);
|
||||||
|
void dstalk_free(void* ptr);
|
||||||
|
char*dstalk_strdup(const char* s);
|
||||||
|
void dstalk_set_diag_callback(dstalk_diag_cb cb);</code></pre>
|
||||||
|
</div>
|
||||||
|
<div class="terminal" style="margin-top:16px">
|
||||||
|
<div class="terminal-top"><span class="dot"></span><span class="dot"></span><span class="dot"></span><span class="terminal-title">dstalk_services.h — 服务 vtable 示例</span></div>
|
||||||
|
<pre><code><span class="dim">// AI 服务: dstalk_service_query("ai.deepseek", 0)</span>
|
||||||
|
typedef struct {
|
||||||
|
int (*configure)(const char* provider, const char* base_url,
|
||||||
|
const char* api_key, const char* model,
|
||||||
|
int max_tokens, double temperature);
|
||||||
|
dstalk_chat_result_t (*chat)(const dstalk_message_t* history,
|
||||||
|
int len, const char* input, const char* tools_json);
|
||||||
|
dstalk_chat_result_t (*chat_stream)(...);
|
||||||
|
void (*free_result)(dstalk_chat_result_t* result);
|
||||||
|
} dstalk_ai_service_t;
|
||||||
|
|
||||||
int dstalk_file_read(const char* path, char** content);
|
<span class="dim">// 同模式: dstalk_session_service_t, dstalk_http_service_t,</span>
|
||||||
int dstalk_file_write(const char* path, const char* content);</code></pre>
|
<span class="dim">// dstalk_file_io_service_t, dstalk_config_service_t,</span>
|
||||||
|
<span class="dim">// dstalk_tools_service_t, dstalk_lsp_service_t</span></code></pre>
|
||||||
</div>
|
</div>
|
||||||
</section>
|
</section>
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user