chii
347c94c121
缓存命中改写信封时补 UnmarshalJSON，避免 results 被抹空；零结果不进 300s 缓存。模版层对 SearXNG hits 做广告标记丢弃与同域限额 1 条，减轻 1688 霸屏。 Co-authored-by: Cursor <cursoragent@cursor.com> |
||
|---|---|---|
| .. | ||
| decision-candidates-20260901.md | ||
| deploy-prod-preset-20260901.md | ||
| design-arch-20260901.md | ||
| dev-handoff-20260902.md | ||
| impl-20260901.md | ||
| integration-vlepontas-20260901.md | ||
| mcp-usage-20260901.md | ||
| overview-integration-20260901.md | ||
| plan-final-20260901.md | ||
| README.md | ||
| type | status | created |
|---|---|---|
| meta | active | 2026-09-01 |
docs/ 索引 — onesvm-browser-server
仓根
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）