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:
@@ -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 分层、可空标注
|
||||
|
||||
Reference in New Issue
Block a user