diff --git a/README.md b/README.md index 55d9ed8..dc0a84c 100644 --- a/README.md +++ b/README.md @@ -74,12 +74,16 @@ go test -count=1 ./... ## 依赖本仓库 +消费方把本库固定为 submodule,推荐路径 `deps/logging-system`。版本以消费方 gitlink 为准,不执行 `submodule update --remote`。 + ``` require logging-system v0.0.0 -replace logging-system => ../Logging-System +replace logging-system => ./deps/logging-system ``` +并列检出、还没放进 `deps/` 时,也可以暂时写 `replace logging-system => ../Logging-System`。本库不导入错误码模块。若消费方同时依赖 Agent-Native,而 Agent-Native 的 `deps/` 里还有一份本库,编译时只认消费方自己的 `replace`;两份 gitlink 必须相同。 + 远程:`ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Logging-System.git` 与错误码系统的追溯闭环见 [docs/integration.md](docs/integration.md)。可运行示例:`go test ./examples/trace`(两个仓库需为同级目录)。 diff --git a/docs/records/2026-09-29-verification.md b/docs/records/2026-09-29-verification.md new file mode 100644 index 0000000..89fb4d1 --- /dev/null +++ b/docs/records/2026-09-29-verification.md @@ -0,0 +1,17 @@ +# 验证记录 + +- 范围/主任务:挂载 Development-Guidelines,说明 `deps/logging-system` 消费方式,并确认 `examples/trace` 仍能连到并列的错误码库。日志格式未改。 +- 被测版本:规范挂载提交 `0ea2ad297a1d037ce0cb69be2428da3a558df573`。README 的 deps 说明在该提交之后。 +- 目标仓/分支:Logging-System `main`。规范子模块 `26b562d2e34fbc560711296a309c91c74ffc55b1`。 +- 环境:本机 Go 1.27。`examples/trace` 的 replace 指向 `/home/weichen/projects/Error-Code-System`。时间 2026-09-29。 +- 实际命令:仓库根 `go test -count=1 ./...`;`examples/trace` 下 `go test -count=1 ./...`;干净克隆 `/tmp/dg-verify/Logging-System` 后重复这两条。 + +| 预期用例/场景 | 实际是否执行 | 结果 | 证据/缺项 | +|---|---|---|---| +| 主模块测试 | 是 | PASS | 工作区与干净克隆 | +| examples/trace | 是 | PASS | 独立模块,两次都通过 | +| 规范子模块从批准远端检出 | 是 | PASS | 克隆到 `26b562d2e34fbc560711296a309c91c74ffc55b1` | + +首轮失败与重试:无。 +结论与限制:示例仍依赖并列目录里的错误码库,不依赖 `deps/` 下的副本。消费方当前锁定的是 `7f5972007bdcb6047ce7f95ee891f53e0af9d136`,尚未包含本仓的规范挂载提交。 +剩余项/责任人:父仓升级 gitlink 另行提交。