diff --git a/docs/plugin/PROVIDER_INTEGRATION_v2.md b/docs/plugin/PROVIDER_INTEGRATION_v2.md
index cb8a403e..686ce47c 100644
--- a/docs/plugin/PROVIDER_INTEGRATION_v2.md
+++ b/docs/plugin/PROVIDER_INTEGRATION_v2.md
@@ -11,7 +11,9 @@ Related files:
 - Sign test vectors:
   [`src/main/resolve/plugin/__fixtures__/sign-vectors.json`](../../src/main/resolve/plugin/__fixtures__/sign-vectors.json)
 
-The old v1 document (`docs/机场插件服务端对接指南.md`) described the password/encrypted-container model. Do not use it for new integrations.
+During development there was an earlier v1 design (password + encrypted container).
+That design has been retired, and the current codebase does not include a v1
+implementation.
 
 ---
 
diff --git a/docs/plugin/机场服务端对接指南-v2.md b/docs/plugin/机场服务端对接指南-v2.md
index d6a9442a..84e9c3c7 100644
--- a/docs/plugin/机场服务端对接指南-v2.md
+++ b/docs/plugin/机场服务端对接指南-v2.md
@@ -5,10 +5,10 @@
 相关文件：
 
 - 参考服务端：[`deploy/gateway/`](../../deploy/gateway/)
-- 精简英文契约：[`PROVIDER_INTEGRATION_v2.md`](PROVIDER_INTEGRATION_v2.md)
+- 英文版：[`PROVIDER_INTEGRATION_v2.md`](PROVIDER_INTEGRATION_v2.md)
 - 签名测试向量：[`src/main/resolve/plugin/__fixtures__/sign-vectors.json`](../../src/main/resolve/plugin/__fixtures__/sign-vectors.json)
 
-旧版 `docs/机场插件服务端对接指南.md` 是 v1 方案（账号密码 + 加密容器），已经废弃。
+开发过程中曾有一版 v1 方案（账号密码 + 加密容器）。该方案已弃用，当前代码库未包含 v1 实现。
 
 ---