# @devflow-tools/sdk

> DevFlow 公共类型、插件契约、API client、配置/日志工具和 embedding contract。（v0.17.8）

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

## 安装

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

## 快速开始

```typescript
import { countTokens, loadPlugins } from '@devflow-tools/sdk';

console.log(countTokens('hello'));
const plugins = await loadPlugins(process.cwd());
```

## 公共 API / 命令

根入口包含 `DevFlowApiClient`、`DevFlowPlugin`、`EmbeddingProviderContract`、`loadConfig`、`loadPlugins`、`createLogger` 和 token 工具。引擎组合器位于 `@devflow-tools/context-engine`。


## 配置与运行时

可用 subpath：`@devflow-tools/sdk/step-templates`、`/auth`、`/plugin-workflow`、`/capability-rollout`、`/utils/project-scanner`。SDK 只定义跨包契约，不依赖 memory/knowledge 实现。

## 版本与兼容性

- 当前包版本：`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