开发

环境要求

• Node.js >=22

常用命令

npm install
npm run typecheck
npm test
npm run build

• typecheck：TypeScript 类型检查
• test：Node built-in test + tsx 运行单元测试
• build：tsc 生成类型声明 + tsdown 生成 Host/Browser bundle

回环验证

# 使用可写 DSH_HOME 副本 + 环境变量 Key 启动临时实例
DSH_HOME=/path/to/writable-home COMMANDCODE_API_KEY=user_xxx dsh web --port 3099

# 查询接口
curl http://127.0.0.1:3099/commandcode-usage/status.json
curl http://127.0.0.1:3099/commandcode-usage/turn-cost.json

注：README 曾提到的 scripts/dev-loopback.sh 当前仓库不存在；如需一键回环，需先补齐该脚本，或直接用上面的 DSH_HOME=... dsh web ... 命令。

速率与风控说明

• 默认 60s 才抓取一次，单次抓取 4 个端点，属于低频请求。
• 多账户默认串行；如仍担心风控，可调大 pollIntervalMs 或保持 accountConcurrency: 1。
• 对 4xx 不重试，对网络/5xx 最多重试一次，避免放大请求。