From 95a03b75786827b215121c35845d3ca35afc03bb Mon Sep 17 00:00:00 2001 From: weichen Date: Tue, 29 Sep 2026 14:30:57 +0000 Subject: [PATCH] Document the deps submodule path and record the adoption checks. Consumers should pin this repository with their own replace directive instead of relying on a sibling checkout. Co-authored-by: Cursor --- README.md | 6 +++++- docs/records/2026-09-29-verification.md | 17 +++++++++++++++++ 2 files changed, 22 insertions(+), 1 deletion(-) create mode 100644 docs/records/2026-09-29-verification.md diff --git a/README.md b/README.md index e0a6794..32c4f2d 100644 --- a/README.md +++ b/README.md @@ -93,10 +93,14 @@ WRITE_CATALOG=1 go test ./domains -run TestWriteCatalog -count=1 ## 依赖本仓库 +消费方把本库固定为 submodule，推荐路径 `deps/error-code-system`。版本以消费方 gitlink 为准，不执行 `submodule update --remote`。 + ``` require error-code-system v0.0.0 -replace error-code-system => ../Error-Code-System +replace error-code-system => ./deps/error-code-system ``` +并列检出、还没放进 `deps/` 时，也可以暂时写 `replace error-code-system => ../Error-Code-System`。本库不导入 Agent-Native、Agent-Squad 或日志库。若消费方同时依赖 Agent-Native，而 Agent-Native 的 `deps/` 里还有一份本库，编译时只认消费方自己的 `replace`；两份 gitlink 必须相同。 + 远程：`ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Error-Code-System.git` diff --git a/docs/records/2026-09-29-verification.md b/docs/records/2026-09-29-verification.md new file mode 100644 index 0000000..034e3d4 --- /dev/null +++ b/docs/records/2026-09-29-verification.md @@ -0,0 +1,17 @@ +# 验证记录 + +- 范围/主任务：挂载 Development-Guidelines，并说明消费方用 `deps/error-code-system` 固定本库。码值未改。 +- 被测版本：规范挂载提交 `bfe3346c33f0211c19ff24ca4346056b3c5f6b48`。README 的 deps 说明在该提交之后，验证时尚未单独提交。 +- 目标仓/分支：Error-Code-System `main`。规范子模块 `26b562d2e34fbc560711296a309c91c74ffc55b1`。 +- 环境：本机 Go 1.27。时间 2026-09-29。 +- 实际命令：仓库根 `go test -count=1 ./...`；`git clone --recurse-submodules` 到 `/tmp/dg-verify/Error-Code-System` 后再次 `go test -count=1 ./...`。 + +| 预期用例/场景 | 实际是否执行 | 结果 | 证据/缺项 | +|---|---|---|---| +| 目录、信封与服务测试 | 是 | PASS | 工作区与干净克隆各一次 | +| 规范子模块可从批准远端检出 | 是 | PASS | 克隆日志中的 `26b562d2e34fbc560711296a309c91c74ffc55b1` | +| 消费方仓库已经改用本库 | 是，在那些仓库的工作区 | PASS | 不在本记录里重复它们的测试 | + +首轮失败与重试：无。 +结论与限制：本库自身测试通过。消费方锁定的仍是更早的 `b67696d393e7abfbdd16fdde1064c07f5ecd2f72`，因为规范挂载提交还没被父仓采用。这是允许的：组件可以先合并，父仓稍后再升级 gitlink。 +剩余项/责任人：父仓是否升级到含本说明的新提交，由父仓另一次提交决定。