# @devflow-tools/database

> 基于 better-sqlite3 的本地 SQLite/WAL 持久化层，承载运行、检索、记忆和遥测记录。（v0.17.8）

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

## 安装

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

## 快速开始

```typescript
import { DevFlowDatabase } from '@devflow-tools/database';

const db = new DevFlowDatabase(process.cwd());
console.log(db);
```

## 公共 API / 命令

`DevFlowDatabase`、`openGlobalDevFlowDatabase`、`openGlobalDevFlowReadOnlyDatabase` 及 task runtime、work queue、retrieval ledger、workflow worker 类型/映射器。


## 配置与运行时

需要 Node.js 原生 better-sqlite3 能力；数据库文件默认位于项目 `.devflow/` 目录或全局 DevFlow 数据目录。

## 版本与兼容性

- 当前包版本：`0.17.8`
- Node.js：未在 package manifest 声明更高版本时，使用 Node.js 18+；原生 SQLite/Playwright 能力请按对应依赖安装
- workspace 内部包应使用同一 DevFlow minor/patch 版本，避免类型和数据库 schema 不一致

## 相关链接

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

## License

MIT