# @devflow-tools/server

> 基于 NestJS + Fastify 的 DevFlow REST API 服务端。（v0.17.8）

[![npm version](https://img.shields.io/npm/v/%40devflow-tools%2Fserver.svg)](https://www.npmjs.com/package/@devflow-tools/server)

## 安装

```bash
npm install @devflow-tools/server
```

## 快速开始

```bash
npm install -g @devflow-tools/cli
devflow dashboard
# 默认监听 http://127.0.0.1:13337
```

## 公共 API / 命令

binary `devflow-server`；提供 `/api/context`、`/api/graph`、`/api/workflows`、`/api/memory`、`/api/knowledge`、`/api/telemetry`、`/api/benchmark` 和 `/api/registry`。

## Runtime 与 Dashboard

建议使用 `devflow dashboard` 管理用户级 Runtime；`devflow dashboard --open` 才会打开浏览器，`devflow dashboard --no-start` 只查询已就绪实例。`/api/health` 是存活检查；`/api/ready` 还验证 Dashboard 静态资源、实例归属和数据库就绪状态。


二进制入口：
- `devflow-server`

## 配置与运行时

除健康检查外要求 `X-API-Key`；`PORT` 默认 `13337`，`DEVFLOW_API_KEYS` 可配置允许的密钥列表。

## 版本与兼容性

- 当前包版本：`0.18.3`
- Node.js：22.13.0+
- workspace 内部包应使用同一 DevFlow minor/patch 版本，避免类型和数据库 schema 不一致

## 相关链接

- [DevFlow 仓库](https://github.com/shilongfeicool/dev-flow)
- [问题反馈](https://github.com/shilongfeicool/dev-flow/issues)

## License

MIT