feat(docs): 文档站自带热更新——源码变更自动重建后端+刷新元数据

- docs 后端从 go run 改为 build+spawn(编译成功才切换,与 fun run 同语义)
- watchLoop 复用:.go/go.mod/go.sum 变更→重采元数据+重启后端
- 新增 /fun-version 端点;文档页轮询版本变化自动刷新(编辑中推迟)
- snapshot 跳过 fun_gen_helper_test.go,避免采集辅助文件自触发
- -from 静态模式不启用;-no-run 仍刷新元数据(后端由外部管理)

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
This commit is contained in:
2026-09-19 15:46:07 +08:00
co-authored by Devin
parent 96d8a4074f
commit dabf8c2953
4 changed files with 86 additions and 12 deletions
+3 -1
View File
@@ -42,11 +42,13 @@ fun run -- -config dev.yaml # 透传程序参数
### fun docs —— API 文档站
```bash
fun docs # 自动 go run . 拉起后端
fun docs # 自动编译拉起后端,源码变更热更新
fun docs -upstream http://127.0.0.1:9000 # 指定后端地址
fun docs -no-run # 后端已在别处运行
```
- **热更新**:监听 `.go`/`go.mod`/`go.sum` 变更,自动重采元数据、重编译重启后端,
文档页检测版本变化自动刷新(编辑中推迟);`-from` 静态模式不启用
- 浅色文档风格:侧栏服务/方法树(stream 徽标)+ 搜索(`/` 快速聚焦)
- **分享**:标题旁一键复制深链(`#服务.方法?req=...`),自带请求体,打开即还原
- 参数表:字段/类型/示例值/说明;枚举下拉、嵌套 DTO 分层、可空标注