mirror of
https://github.com/deepseek-ai/awesome-deepseek-integration
synced 2025-01-22 18:48:09 +00:00
84 lines
3.0 KiB
Markdown
84 lines
3.0 KiB
Markdown
# DeepSpace
|
||
|
||
DeepSpace（深度空间）是一款用于调试 DeepSeek API 的工具，由社区制作，灵感来源于 [MoonPalace](https://github.com/MoonshotAI/moonpalace?tab=readme-ov-file)。
|
||
|
||
[Read this in English](README.md)
|
||
|
||
## 特性
|
||
|
||
- **全平台支持：**
|
||
- [x] Mac
|
||
- [x] Windows
|
||
- [x] Linux
|
||
- **简单易用**：启动后只需将 `base_url` 替换为 `http://localhost:9988` 即可开始调试。
|
||
- **捕获完整请求**，包括网络错误时的“事故现场”。
|
||
- **快速检索**：通过 `request_id`、`chatcmpl_id` 快速检索、查看请求信息。
|
||
- **一键导出 BadCase 结构化上报数据**，帮助 DeepSeek 完善模型能力。
|
||
|
||
**推荐在代码编写和调试阶段使用 DeepSpace 作为你的 API “供应商”，以便能快速发现和定位关于 API 调用和代码编写过程中的各种问题。对于 DeepSeek 大模型各种不符合预期的输出，你也可以通过 DeepSpace 导出请求详情并提交给 DeepSeek 以改进 DeepSeek 的大模型。**
|
||
|
||
## 安装方式
|
||
|
||
### 使用 `go` 命令安装
|
||
|
||
如果你已经安装了 `go` 工具链，可以执行以下命令来安装：
|
||
|
||
```shell
|
||
$ go install github.com/2404589803/deepspace@latest
|
||
```
|
||
|
||
上述命令会在你的 `$GOPATH/bin/` 目录中安装编译后的二进制文件。运行 `deepspace` 命令来检查是否成功安装：
|
||
|
||
```shell
|
||
$ deepspace
|
||
DeepSpace is a command-line tool for debugging the DeepSeek AI HTTP API
|
||
|
||
Usage:
|
||
deepspace [command]
|
||
|
||
Available Commands:
|
||
cleanup Cleanup DeepSeek AI requests
|
||
completion Generate the autocompletion script for the specified shell
|
||
export Export a DeepSeek AI request
|
||
help Help about any command
|
||
inspect Inspect the specific content of a DeepSeek AI request
|
||
list Query DeepSeek AI requests based on conditions
|
||
start Start the DeepSpace proxy server
|
||
|
||
Flags:
|
||
-h, --help help for deepspace
|
||
-v, --version version for deepspace
|
||
|
||
Use "deepspace [command] --help" for more information about a command.
|
||
```
|
||
|
||
*如果你仍然无法检索到 `deepspace` 二进制文件，请尝试将 `$GOPATH/bin/` 目录添加到你的 `$PATH` 环境变量中。*
|
||
|
||
### 从 Releases 页面下载二进制（可执行）文件
|
||
|
||
你也可以从 [Releases](https://github.com/2404589803/deepspace/releases) 页面下载编译好的二进制文件：
|
||
|
||
- deepspace-linux
|
||
- deepspace-macos-amd64 => 对应 Intel 版本的 Mac
|
||
- deepspace-macos-arm64 => 对应 Apple Silicon 版本的 Mac
|
||
- deepspace-windows.exe
|
||
|
||
## 使用方式
|
||
|
||
### 启动服务
|
||
|
||
使用以下命令启动 DeepSpace 代理服务器：
|
||
|
||
```shell
|
||
$ deepspace start --port <PORT>
|
||
```
|
||
|
||
DeepSpace 会在本地启动一个 HTTP 服务器，`--port` 参数指定 DeepSpace 监听的本地端口，默认值为 `9988`。当 DeepSpace 启动成功时，会输出：
|
||
|
||
```shell
|
||
[DeepSpace] 2024/08/26 12:12:26 DeepSpace Starts => change base_url to "http://127.0.0.1:9988/v1"
|
||
```
|
||
|
||
你可以将导出的文件投递至以下邮箱：
|
||
|
||
[api-service@deepseek.com](mailto:api-service@deepseek.com) |