docs: 补实现交付记录并同步 inventory 专项

记下 W6 怎么跑与国内/MCP 冒烟结果;联调入口改为 mgr1 :8640。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
chii 2026-09-02 15:08:59 +08:00
parent eb972dfa93
commit 854ffcb2b1
4 changed files with 56 additions and 4 deletions

View file

@ -16,7 +16,8 @@ created: 2026-09-01
| `overview-integration-20260901.md` | 整合方式入门导览:整合哪些/怎么整合/什么服务/怎么排队 | 新接手工程师 | 导读(不产生新结论) | | `overview-integration-20260901.md` | 整合方式入门导览:整合哪些/怎么整合/什么服务/怎么排队 | 新接手工程师 | 导读(不产生新结论) |
| `mcp-usage-20260901.md` | 消费者侧 MCP 使用文档:接入方式、工具参数、能力数据范围、数据获取使用规则 | 智能体消费者(Vlepontas/EAI) | 消费侧规则权威 | | `mcp-usage-20260901.md` | 消费者侧 MCP 使用文档:接入方式、工具参数、能力数据范围、数据获取使用规则 | 智能体消费者(Vlepontas/EAI) | 消费侧规则权威 |
| `deploy-prod-preset-20260901.md` | 生产部署预设:stack 组件、端口、镜像 pin、节点布局、镜像传输流程(审批稿) | 运维/实施 | 部署执行依据 | | `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) |
## 数据与验收(仓内可追溯) ## 数据与验收(仓内可追溯)

51
docs/impl-20260901.md Normal file
View file

@ -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)

View file

@ -6,7 +6,7 @@ created: 2026-09-01
# Vlepontas 联调使用说明(草稿 · 部署批准后生效) # 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`,本文是联调操作手册。 > 详细工具参数/错误码/能力范围见《MCP 使用文档》`docs/mcp-usage-20260901.md`,本文是联调操作手册。
## 1. 联调目标 ## 1. 联调目标
@ -42,7 +42,7 @@ Vlepontas casa-worker 走 overlay(按 WSG 先例附加 `vlepontas-casa-net`)
```bash ```bash
curl -X POST -H 'X-Service-Token: bs_vlep_…' -H 'Content-Type: application/json' \ 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}' -d '{"query":"跨境电商 出口退税 政策 2026","region":"domestic","max_results":5}'
``` ```

@ -1 +1 @@
Subproject commit 66eddbc931ec501aee046ca979c576dfb7bab745 Subproject commit 7b26ce7b3d0e1983e0e014be0940dcf8b6f795a2