onesvm-browser-server/docs/README.md
chii 9b689b2476 feat: 落地节点指纹与 Cookie 罐,并按现网能力更新消费/接手文档
公开页抓取改为 Chrome 136 自洽身份 + 每节点 SQLite 养罐,Trafilatura 走 curl_cffi;MCP/README/接手说明与 09-02 现网复测对齐,避免消费方继续抄过期的站点三分表。

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-02 17:04:25 +08:00

28 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
type: meta
status: active
created: 2026-09-01
---
# docs/ 索引 — onesvm-browser-server
> 仓根 [`README.md`](../README.md) 是对外总览。接手先读 `dev-handoff-20260902.md`;拍板看 `plan-final-20260901.md`;改实现查 `design-arch-20260901.md`;消费方只读 `mcp-usage-20260901.md`。
| 文档 | 一句话说明 | 读者对象 | 权威关系 |
|---|---|---|---|
| `../README.md` | 仓库说明:问题、设计科学、入选方案、目录与怎么跑 | 所有人 | 入门(不覆盖 plan/design) |
| `dev-handoff-20260902.md` | 接手开发:包地图、事件表、改哪一层、验证、部署坑 | 新接手工程师 | **接手路径权威** |
| `plan-final-20260901.md` | 最终方案 v1:档位表、实测评定结论、D1–D6 决策点 | 项目 owner(review/拍板) | **决策权威**(冲突处以它为准) |
| `design-arch-20260901.md` | 架构机制全文:拓扑、统一出口、Dock 协议、队列、ProxyManager、O1–O13 | 实现工程师 | **机制细节权威** |
| `decision-candidates-20260901.md` | 消费方案选型决策记录:5 套入选理由、排除/预留清单、能力边界实测矩阵 | owner + 工程师 | 选型结论依据(09-01 bench;现网能力以 mcp-usage §4 为准) |
| `overview-integration-20260901.md` | 整合方式入门导览:整合哪些/怎么整合/什么服务/怎么排队 | 新接手工程师 | 导读(不产生新结论) |
| `mcp-usage-20260901.md` | 消费者侧 MCP 使用文档:接入、工具、**2026-09-02 现网能力**、错误码 | 智能体消费者(Vlepontas/EAI) | **消费侧规则权威** |
| `deploy-prod-preset-20260901.md` | 生产部署预设:stack 组件、端口、镜像 pin、节点布局、镜像传输流程 | 运维/实施 | 部署执行依据(cgroup 以 `stacks/browser-server.yml` 为准) |
| `integration-vlepontas-20260901.md` | Vlepontas 接入说明:入口、认证、现网验收用例、纪律 | Vlepontas 侧工程师 | 接入执行依据(密钥不进本文) |
| `impl-20260901.md` | 控制面实现交付记录:怎么跑、验收链、W6 热修 | 实现/接手工程师 | 实现回执(不覆盖 design) |
## 数据与验收(仓内可追溯)
- 实测工程与原始数据:`bench/`(5 方案 + 代理 + 站点矩阵;`results.json` + 样本;无密钥)
- 过程产物(调研/筛选/探活/验收报告):`.dsh/artifacts/run-20260901-browser-arch/`(gitignore,不提交)
- 契约与计划:`.dsh/contracts/`(contract-20260901-browser-arch / plan-20260901-01 均已 done)