From 854ffcb2b162044a742e20eb94cf211dc585793f Mon Sep 17 00:00:00 2001 From: chii Date: Wed, 2 Sep 2026 15:08:59 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E5=AE=9E=E7=8E=B0=E4=BA=A4?= =?UTF-8?q?=E4=BB=98=E8=AE=B0=E5=BD=95=E5=B9=B6=E5=90=8C=E6=AD=A5=20invent?= =?UTF-8?q?ory=20=E4=B8=93=E9=A1=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 记下 W6 怎么跑与国内/MCP 冒烟结果；联调入口改为 mgr1 :8640。 Co-authored-by: Cursor --- docs/README.md | 3 +- docs/impl-20260901.md | 51 ++++++++++++++++++++++++++ docs/integration-vlepontas-20260901.md | 4 +- onesvm-dev-md | 2 +- 4 files changed, 56 insertions(+), 4 deletions(-) create mode 100644 docs/impl-20260901.md diff --git a/docs/README.md b/docs/README.md index f2e3d0b..5e9ea0c 100644 --- a/docs/README.md +++ b/docs/README.md @@ -16,7 +16,8 @@ created: 2026-09-01 | `overview-integration-20260901.md` | 整合方式入门导览：整合哪些/怎么整合/什么服务/怎么排队 | 新接手工程师 | 导读（不产生新结论） | | `mcp-usage-20260901.md` | 消费者侧 MCP 使用文档：接入方式、工具参数、能力数据范围、数据获取使用规则 | 智能体消费者（Vlepontas/EAI） | 消费侧规则权威 | | `deploy-prod-preset-20260901.md` | 生产部署预设：stack 组件、端口、镜像 pin、节点布局、镜像传输流程（审批稿） | 运维/实施 | 部署执行依据 | -| `integration-vlepontas-20260901.md` | Vlepontas 联调手册：注册接入、C1–C6 验收用例、升级决策回路（部署批准后生效） | Vlepontas 侧工程师 | 接入执行依据 | +| `integration-vlepontas-20260901.md` | Vlepontas 联调手册：注册接入、C1–C6 验收用例、升级决策回路 | Vlepontas 侧工程师 | 接入执行依据 | +| `impl-20260901.md` | 控制面实现交付记录：怎么跑、验收链、W6 热修 | 实现/接手工程师 | 实现回执（不覆盖 design） | ## 数据与验收（仓内可追溯） diff --git a/docs/impl-20260901.md b/docs/impl-20260901.md new file mode 100644 index 0000000..094182c --- /dev/null +++ b/docs/impl-20260901.md @@ -0,0 +1,51 @@ +--- +type: receipt +status: active +created: 2026-09-01 +--- + +# 控制面实现交付记录 + +> 对应 `contract-20260901-browser-impl` / `plan-20260901-03`（实现）+ `plan-20260901-04`（W6 热修）。 +> 机制细节仍以 `design-arch-20260901.md` 为准；决策以 `plan-final-20260901.md` 为准。 + +## 交付了什么 + +| 块 | 路径 | +|---|---| +| 单二进制三角色 | `server/cmd/browser-server`（`-role=gateway\|scheduler\|proxymanager`） | +| 公共包 | `server/internal/{contract,store,auth,policy,safetyscan,httpx,config}` | +| 五 Dock 适配器 | `server/internal/dock`（searxng-cn/global、trafilatura、lightpanda、headless-shell） | +| Swarm stack | `stacks/browser-server.yml`（10 服务；shell `replicas=0`） | +| 本机冒烟 / 部署脚本 | `scripts/smoke-local.sh` · `scripts/deploy-mgr1.sh` | +| 镜像 | `onesvm/browser-server:dev` · `onesvm/trafilatura-http:dev`（日常复用 tag） | + +## 怎么跑 + +```bash +# 单测 +make test + +# 本机 compose 冒烟（stub 引擎） +make smoke + +# mgr1 部署（须用户 🟡 确认；读 gitignore deploy.env） +bash scripts/deploy-mgr1.sh # dry-run +bash scripts/deploy-mgr1.sh --apply +``` + +入口：`http://192.168.1.51:8640`（MCP `POST /mcp`，HTTP `POST /v1/search` `/v1/read`）。认证头 `X-Service-Token`。 + +## 验收链 + +- 实现轮：V1 verify → ITER-3 → V2 reverify PASS → V3 arch-review PASS-with-debt → ITER-4（D-1/D-2） +- 部署轮 W6：stack 已在 mgr1；海外订阅经 central-proxy bootstrap；探活 `alive=41/52`（2026-09-02） +- 国内/MCP 冒烟（同日）：401 / 签发 / `tools/list=[search,read]` / MCP `tools/call` 200；`/v1/search` `/v1/read` 信封 200 但 `error=upstream`（searxng-cn 上游超时/空结果，网关未崩） +- 产物（gitignore）：`.dsh/artifacts/run-20260901-browser-impl/` + +## W6 热修（已入镜像） + +- `BROWSER_SERVER_SUB_FETCH_PROXY`：仅订阅拉取走 `.53:7890` +- mihomo 卷 nonroot 可写；热载路径用容器内 `/root/.config/mihomo/config.yaml` +- 生成配置剥离 dns/geosite；mihomo limit **128m** +- `NewManager` 接线 mihomo delay 探针（修全池探活 nil panic） diff --git a/docs/integration-vlepontas-20260901.md b/docs/integration-vlepontas-20260901.md index ea4042f..0ad2caf 100644 --- a/docs/integration-vlepontas-20260901.md +++ b/docs/integration-vlepontas-20260901.md @@ -6,7 +6,7 @@ created: 2026-09-01 # Vlepontas 联调使用说明（草稿 · 部署批准后生效） -> 状态说明：本文档在**用户批准部署预设**（`docs/deploy-prod-preset-20260901.md`）并完成 L0–L2 灰度上线后生效；文中地址/端口为预设值（`:8640`、`browser-server` alias），上线后以正式通知为准。 +> 状态说明：mgr1 测试期已部署（2026-09-02）。入口 `http://192.168.1.51:8640`，overlay alias `browser-server`。 > 详细工具参数/错误码/能力范围见《MCP 使用文档》`docs/mcp-usage-20260901.md`，本文是联调操作手册。 ## 1. 联调目标 @@ -42,7 +42,7 @@ Vlepontas casa-worker 走 overlay（按 WSG 先例附加 `vlepontas-casa-net`） ```bash curl -X POST -H 'X-Service-Token: bs_vlep_…' -H 'Content-Type: application/json' \ - http://192.168.1.61:8640/v1/search \ + http://192.168.1.51:8640/v1/search \ -d '{"query":"跨境电商 出口退税 政策 2026","region":"domestic","max_results":5}' ``` diff --git a/onesvm-dev-md b/onesvm-dev-md index 66eddbc..7b26ce7 160000 --- a/onesvm-dev-md +++ b/onesvm-dev-md @@ -1 +1 @@ -Subproject commit 66eddbc931ec501aee046ca979c576dfb7bab745 +Subproject commit 7b26ce7b3d0e1983e0e014be0940dcf8b6f795a2