From 82be010987ba3e244a2833ffa678227732ba9072 Mon Sep 17 00:00:00 2001 From: lik Date: Sun, 1 Nov 2026 11:42:57 +0800 Subject: [PATCH] =?UTF-8?q?chore(repo):=20=E8=A1=A5=E5=85=85=E7=9B=AE?= =?UTF-8?q?=E5=BD=95=E7=BA=A6=E5=AE=9A=E5=B9=B6=E5=B0=86=E4=B8=B4=E6=97=B6?= =?UTF-8?q?=E8=B0=83=E8=AF=95=E6=96=87=E4=BB=B6=E5=8A=A0=E5=85=A5=E5=BF=BD?= =?UTF-8?q?=E7=95=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - README 明确根目录只放入口/配置、测试统一放 test/、一次性脚本放 scripts/ 或删除、共享逻辑放 agent/infra - .gitignore 忽略 /tmp_* 与 /tmp/ --- .gitignore | 3 +++ README.md | 7 +++++++ 2 files changed, 10 insertions(+) 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`,