← 返回项目库

pREST Studio 中文数据 API 工作台

pREST Studio 中文数据 API 工作台，提供服务状态、数据目录、REST GET 调试和 MCP 工具调用界面。

pREST Studio 是嵌入 pREST 服务的静态管理与探索界面，交付版将核心导航、状态、字段、查询参数、错误提示和 MCP 操作统一为简体中文。工作台覆盖服务概况、模式与数据表浏览、字段结构查看、只读 GET 查询和 MCP 工具调用；本地预览适配器提供固定的虚构演示数据，生产使用时由 prestd 提供真实 PostgreSQL 与 MCP 服务。

真实界面

项目截图

共 7 张

运行概况
订单明细
客户资料
每日指标
响应结果
已连接
调用结果

Capabilities

核心功能

✓中文服务总览与健康、就绪、MCP 状态检查
✓数据库、模式和数据表目录浏览
✓字段结构、类型和可为空信息查看
✓分页记录展示与 GET 筛选条件构建
✓REST 只读查询、响应 JSON 和 curl 地址复制
✓MCP 初始化、工具目录和工具搜索
✓MCP 表单参数填写、调用结果和调用记录
✓访问令牌按标签页保存，且默认不写入 localStorage

适用场景

在本地学习 pREST 数据路由、字段结构和 GET 查询语法
为内部只读数据目录制作可复用的 API 调试工作台
通过 MCP 工具目录检查服务能力并验证工具参数
将中文 Studio 嵌入 pREST 服务，作为二次开发起点

适合谁

需要学习 pREST、验证数据 API、检查 PostgreSQL 数据目录或为内部工具制作只读运维界面的开发者、技术负责人和开源社群用户。

商业化思路

用于社群学习、数据 API 原型验证、内部只读数据工作台和 pREST 二次开发基础，不承诺现成托管服务或外部数据库资源。

你会拿到什么

  • ✓固定上游提交并完成中文适配的完整源码包
  • ✓本地预览适配器、固定演示数据和可重复运行说明
  • ✓MIT 许可证、版权事实和上游来源披露
  • ✓7 张真实中文功能页截图与构建、测试验收记录

部署流程

  1. 1安装 Node.js 24 或更高版本、pnpm 11，并进入 studio 目录安装锁定依赖。
  2. 2执行 pnpm build，将 Studio 构建到 internal/studio/dist，由 prestd 的嵌入处理器提供 /_studio/。
  3. 3在真实环境启动 prestd 并配置 PostgreSQL、认证令牌和 MCP 能力，再从服务总览、数据浏览、REST 调试和 MCP 工具四条路径复核。
  4. 4本地无外部服务时可运行 preview-api.py 配合 VITE_PREST_PROXY_TARGET 验证固定演示流程；该适配器不得当作生产数据库。

真实验证结果

最终源码通过 TypeScript 检查、ESLint（0 error）和 118 个 Vitest 单元测试，覆盖率为 94.41% statements；使用本地固定适配器完成健康、元数据、数据目录、订单记录、REST GET 和 MCP JSON-RPC 调用验证。确定性浏览器单页流程生成 7 张 1440×900 中文功能截图，全部 HTTP 200，控制台错误、404、登录页、破图、横向溢出和语义阻断均为 0；源码包通过 unzip、许可证、外部推广和禁项扫描。

部署前须知

本地预览只展示固定的虚构演示数据，未连接外部 PostgreSQL 或 MCP 服务；真实部署需要由使用者提供 prestd 运行时、数据库和认证配置。当前构建在 Node.js 22 上可完成验收，但项目声明的正式构建要求为 Node.js 24+。

部署难度

中等

最低配置

Node.js 24+ 与 pnpm 11+ 用于构建；生产运行时由 pREST prestd 提供，部署前需按实际环境配置 PostgreSQL、认证令牌和 MCP 服务。

开源许可证

MIT License

最后验证

2026-09-02

技术栈

React 19TypeScriptViteTailwind CSSpREST HTTP APIMCP JSON-RPC

授权说明

仓库根目录包含 MIT LICENSE，源码包保留完整许可证与版权声明；交付包含中文界面和本地预览适配修改，修改方不主张上游源码权利，使用前请核对 MIT License 条款。

Release notes

版本记录

1 个已发布版本

v0.1.0-cn.1 当前推荐

首个中文社群学习交付版本：补齐 pREST Studio 核心中文界面，增加无凭据本地演示适配器，完成数据浏览、REST 查询和 MCP 工具调用的真实运行验收。

部署要求：Node.js 24+、pnpm 11+ 和现代浏览器；生产运行还需要 prestd、PostgreSQL、认证令牌及按需配置的 MCP 服务。

已知问题：本地演示适配器只用于重复验证界面与操作路径，不提供真实数据库数据；部署前需替换为实际服务配置。

登录后领取