docs: 补实现交付记录并同步 inventory 专项
记下 W6 怎么跑与国内/MCP 冒烟结果;联调入口改为 mgr1 :8640。 Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
parent
eb972dfa93
commit
854ffcb2b1
4 changed files with 56 additions and 4 deletions
|
|
@ -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) |
|
||||
|
||||
## 数据与验收(仓内可追溯)
|
||||
|
||||
|
|
|
|||
51
docs/impl-20260901.md
Normal file
51
docs/impl-20260901.md
Normal 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)
|
||||
|
|
@ -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}'
|
||||
```
|
||||
|
||||
|
|
|
|||
|
|
@ -1 +1 @@
|
|||
Subproject commit 66eddbc931ec501aee046ca979c576dfb7bab745
|
||||
Subproject commit 7b26ce7b3d0e1983e0e014be0940dcf8b6f795a2
|
||||
Loading…
Reference in a new issue