32 lines
1.1 KiB
Markdown
32 lines
1.1 KiB
Markdown
# Quickstart: Proxy Module Delegation
|
||
|
||
1) 检出分支
|
||
```bash
|
||
git checkout 005-proxy-module-delegation
|
||
```
|
||
|
||
2) 跑现有测试基线
|
||
```bash
|
||
go test ./...
|
||
```
|
||
|
||
3) 添加新模块示例（开发）
|
||
- 在 `internal/hubmodule/<module>` 下实现元数据，并在 `init()` 中调用 `hubmodule.MustRegister`。
|
||
- 为该模块实现专属 handler（可基于 `internal/proxy/handler.go` 拓展），在启动时通过 `proxy.RegisterModule(proxy.ModuleRegistration{Key: "<module_key>", Handler: yourHandler})` 绑定。
|
||
- 在 `config.toml` 中把目标 Hub 的 `Module` 字段设为这个 `module_key`。
|
||
|
||
4) 启动代理验证
|
||
```bash
|
||
make run
|
||
# or
|
||
go run . --config ./config.toml
|
||
```
|
||
|
||
5) 验证缓存与日志
|
||
- 对同一路径请求两次，观察首次 cache_hit=false、二次 cache_hit=true，日志包含 module_key/hub/domain/upstream_status。
|
||
- 验证缺失 handler 时返回 5xx 且日志含错误字段。
|
||
|
||
6) 更新文档与计划
|
||
- 填充 tasks 清单（/speckit.tasks）。
|
||
- 提交前复查 `specs/005-proxy-module-delegation` 下的设计/研究文件。
|