参考优化方案修改，增加协议范围

AGENTS.md

@@ -0,0 +1,56 @@
+# AGENTS.md
+
+WaveBench 是 MIT 许可的 Python 3.11+ 仪器测量台（VISA/SCPI、run plan、报告、TUI、插件 API）。本仓库的 `master` 是当前主线：上游基座 + 比赛作品包 + advisor 实施。
+
+## 分支定位
+
+- `master`（当前分支）是主线：`44506c4`（上游）→ `68148a0`／`a9e49e3`（比赛作品包）→ `6dc5263`／`51d6136`／`514b76f`（advisor：RFC、草案、同意门 + decision artifact）。它同时被上游 PR #27 提出——**往 `master` 提交前先想清楚是否要让上游看到这些内容**。
+- 远端：`origin` = `Epslion404/wavebench`（fork，上游 PR 的来源）；`tyai` = `Epslion404/TYAI-for-wavebench`（**private 比赛仓库**，默认分支 `master`，issue 与 PR 都在那里跟踪）。
+- `competition` 是另一条内容线（孤儿根提交）：含同一批 advisor 改动与文档，但**比赛作品包与 `master` 已经分叉**（见「已知不一致」）；它不向上游提 PR，只用于比赛提交。
+- 其他分支：`docs/advisor-plugin-rfc`（上游 PR #20）、`split/agent-scope-observe-advise`（上游 PR #4）。
+- CI 只在 push 到 `master`/`main` 或 PR 时触发；`competition` 不跑，本地检查要自己执行（`tyai` 上虽然会触发，但目前空转失败）。
+
+## 目录职责
+
+- `src/wavebench/`：核心实现（cli、services、drivers、transport、plugins、tui）。行为事实源依次为实现、`--help`、`run schema`、`run template --list`、`wavebench.example.toml`；文档和技能正文不能覆盖它们。
+- `比赛区/天翼AI电子科研Skill/`：比赛作品包（TeleAgent Skill）。`src/tianyi_electronics_skill/` 只用标准库（socket SCPI + 信号分析），`numpy`／`pyvisa` 是可选 extras。
+- `比赛区/天翼AI电子科研Skill/wavebench/`：根项目的**独立快照**。与根目录同名的文件内容逐字节相同，另有 `skills/` 与根 `.agents/skills/` 重复；根目录缺少 `tool-of-rei/release-notes/`。改根目录不会影响它，反之亦然，要同步就整目录覆盖。
+- `测试区/.temp/full_discover.py`：临时脚本（pyvisa 枚举 + 硬编码网段 `10.17.216.0/24` 的 SCPI 端口扫描），不是测试套件。
+- `docs/project/`：项目带文档（不进入文档站）。advisor 线见 `docs/project/rfcs/WaveBench_advisor插件RFC.md` 与 `docs/project/design/advisor-draft/`（seam 草案、阶段 1 骨架、规划文件）；自定义设备与协议支持的规范／TODO 只在 `competition` 分支上。
+- `.agents/skills/`：两个 Agent Skill 入口 —— `wavebench/SKILL.md`（真机操作、安全门、开发验证）和 `wavebench-docs/SKILL.md`（文档治理）。根 `SKILL.md` 只是指向前者的指针；排查真机行为时按需读 `wavebench/references/`，不要凭记忆推断。
+
+## 命令（仓库根）
+
+```bash
+python -m venv .venv        # 仓库不提交 .venv；要求 >=3.11（CI 只验证 3.11/3.12）
+.venv/bin/python -m pip install -e ".[dev,analysis,tui]"    # Windows: .venv\Scripts\python.exe
+.venv/bin/python -m pytest -q                # 离线全量（pythonpath=src，testpaths=tests）
+.venv/bin/python -m pytest -q tests/test_run_plan.py    # 聚焦单个测试文件
+.venv/bin/python -m ruff check .             # line-length=100，select E4/E7/E9/F
+python scripts/generate_docs.py --check      # CI 阻断：受管理 Reference 必须与源码同步
+python scripts/generate_docs.py              # 重新生成上述 Reference
+python .agents/skills/wavebench-docs/scripts/audit_docs.py --quiet-warnings
+python scripts/docs_impact.py --base <rev> --head HEAD   # 列出本次代码改动影响的候选文档页
+mkdocs build --strict                        # 文档站，需 pip install -e ".[docs]"
+```
+
+- `pdf` extra（weasyprint）只在 Linux CI 安装，Windows 用 `dev,analysis,tui` 即可。
+- 不连接仪器的命令：`run schema`、`run template --list`、`run check --plan <plan>`、`run report`。
+- 作品包在其自身目录内独立验证：`python -m pytest -q`；离线演示 `python -m tianyi_electronics_skill analyze --demo`。
+- GitHub 操作手动带代理：`git -c http.proxy=http://127.0.0.1:7897 <fetch|push|ls-remote>`；`gh` 需要 `$env:HTTPS_PROXY`（本机直连会超时）。
+- 仓库外的本地助手（取 PR／commit、merge、cherry-pick，自动带代理并拦「孤儿历史 merge」）：`D:\Documents\Code\TY_AI\tools\wbflow.ps1`，例如 `powershell -NoProfile -File <path> pr-cherry 20 -Repo <repo>`。
+
+## 真机与数据边界
+
+- 默认离线：driver/service 测试用 fake transport，实机记录不能替代可重复的离线测试。
+- `run check` 不碰仪器；`doctor`、`run verify` 会查询真实设备；setter、输出切换、采集、扫频必须取得明确授权。
+- 不自动执行 `*RST`，不因设置电压/幅度/频率而自动打开输出；不静默放宽安全上限，不自动追加 `--allow-50ohm`。
+- 被 gitignore 覆盖：`wavebench.toml`、`/data/`、`tool-of-rei/`、`.codegraph/`、`.agents/*`（两个 skill 除外）。不要把真实仪器地址或序列号写入跟踪文件。
+
+## 已知不一致
+
+- `docs/development/documentation.md` 要求给文档审计器传 `--term-allowlist`，但 `audit_docs.py` 已无该参数，照抄会报未知参数。
+- **两条线的比赛包已经分叉**（`git diff --shortstat master competition -- 比赛区` → 约 32 文件／+1954／−780）：`master` 版含 `artifacts/` 采集产物、`examples/protocols/vendor_can_waveform.json`、`src/.../artifacts.py`；`competition` 版含 P0 拆分（`scpi.py`、`dialects.py`、`analysis.py`、`waveform.py`、`fetch` 子命令、错误队列）与 `plot.py`、`protocols.py`，且没有 zip 与 `artifacts/`。合并或取舍前先确认哪条线是要提交的实现。
+- `比赛区/天翼AI电子科研Skill/src/tianyi_electronics_skill/bridge.py` 有 28 个 `E701`／`E702`（一行多语句），会让 `ruff check .` 变红。
+- 比赛作品包不再把 zip 归档提交进仓库：以后的打包走 GitHub Release。
+- 提交信息沿用上游约定：`feat|fix|docs|test|chore|refactor|perf(scope): 说明`，正文以英文为主。

docs/project/README.md

@@ -6,5 +6,6 @@
 - 执行实验：[执行一次实验](../how-to/run-an-experiment.md)
 - 查询 run plan 字段：[run plan Reference](../reference/run-schema.md)
 - 查看 RFC 与历史：[现有 RFC 索引](rfcs/README.md)和[更新日志](../../CHANGELOG.md)
+- advisor 插件类别：[RFC](../project/rfcs/WaveBench_advisor插件RFC.md)与[草案目录](design/advisor-draft/README.md)
 
 具体型号、SCPI、profile、quirk 和实机 evidence 由[仪器插件仓库](https://github.com/Scaxlibur/wavebench-instrument-plugins)维护。