# Contributing to dsh-task-router

感谢你愿意贡献！

## 开发环境

```bash
git clone <your-fork-url>
cd dsh-task-router
npm install
npm run check
```

## 提交前

请确保通过：

- `npm run typecheck`
- `npm test`
- `npm run build`

建议提交信息使用简洁的英文或中文，并说明改动动机。

## 代码规范

- TypeScript 严格模式：`strict`、`noUncheckedIndexedAccess` 等已开启。
- 不引入不必要的运行时依赖。
- 用户可见错误信息使用中文，并经过 `sanitizeError` 脱敏。
- 涉及 API Key 的代码不得打印或持久化明文密钥。

## 测试

新增功能时请补充对应测试。当前测试主要集中在：

- 配置校验与预设迁移
- Tavily / LLM / Image / REST 适配器
- 工具执行与子代理逻辑
- 首轮工具面与 hook 行为

## 文档

重大功能变更请同步更新：

- `README.md`
- `CHANGELOG.md`
- 必要时的 `docs/TECHNICAL_HANDOFF.md`

## AI 参与声明

这是一个高度 AI 性质的项目：TIKO 发起，并由 GLM、DeepSeek、Qwen 等 AI 工具大量参与设计、编码、测试和文档整理，连项目提交也是由 DeepSeek 操作的。贡献时请保留该声明与原作者署名。