docs: 新增最佳实践文档；补 .gitignore

- docs/best-practices.md：选型、任务写法、并发与资源、执行器选择、持久化与重启、多节点与桶划分、排障、反模式清单、上线检查清单（文档里的 API 调用形状已实跑核对） - README：文档表加入口 - .gitignore：忽略示例库文件 *.db、被强杀跑批留下的临时目录与文件（Windows 上 Path.replace 偶发 WinError 5 的测试修复在 f4de43c 里。）
2026-10-08 23:49:22 +08:00
parent f4de43c743
commit 1725b6cbdb
3 changed files with 369 additions and 0 deletions
@@ -857,6 +857,7 @@ outcome = run_task(

 | 文档 | 内容 |
 |---|---|
+| [最佳实践](docs/best-practices.md) | **照什么做生产上不会踩坑**：选型、任务写法、并发与资源、排障、反模式清单、上线检查清单 |
 | [用户指南](docs/user-guide.md) | 概念、任务编写、控制语义、超时、执行器、FAQ |
 | [命令行控制台](docs/cli.md) | 子命令、退出码、任务模块约定、完整走查（真实输出） |
 | [持久层实现指南](docs/store-guide.md) | **换掉默认持久层要实现哪些接口**、逐方法语义、并发要求、陷阱清单 |