diff --git a/.gitignore b/.gitignore index 121cda6..755e8cc 100644 --- a/.gitignore +++ b/.gitignore @@ -3,3 +3,6 @@ /data/ .env conf.json +# 临时调试文件,正式测试请放 test/ +/tmp_* +/tmp/ diff --git a/README.md b/README.md index 8a19e49..d876bff 100644 --- a/README.md +++ b/README.md @@ -150,6 +150,13 @@ routes/index.js 路由注册(/health/ai/*) test/media.test.js 元信息白名单、base64 解码、会话生命周期、供应商请求与失败路径 ``` +目录约定: + +- 根目录只放入口与配置(`index.js` / `app.js` / `websocket.js` / `config.js` 等),不提交临时脚本。 +- 自动化测试统一放 `test/*.test.js`,由 `npm test` 执行;临时验证脚本应先转成正式测试,不要留在根目录。 +- 一次性运维 / 调试脚本放 `scripts/`,用完后删除;需长期保留的请在 README 中说明用途和用法。 +- Agent 共享逻辑放 `agent/infra/`,业务路由与处理器分别放 `routes/`、`handler/`。 + ## 客户端约定 - 小程序录音使用 `wx.getRecorderManager()`,`format: 'mp3'`、`sampleRate: 16000`、`numberOfChannels: 1`,