chore: 删除 5 个遗留调试脚本并同步文档引用
- 删除 agent_loop.py / dwg_review_agent.py / countOfCircle.py
(硬编码 DeepSeek API Key)与 test.py / test_autoagent.py
(重复实现;且 test_autoagent.py 名字与 pytest 的 test_*.py 收集规则冲突)
- CODEBUDDY.md 测试章节改为「pytest 快层 + verify_* 慢层」
- review_checklist.json 描述改指 dwg_review 包
- ai.memory 同步引用与历史说明
安全:Key 已随提交 bdd77af 进入 git 历史并推到远程,删除文件不能清除历史,
需去 DeepSeek 控制台轮换该 Key(已在 ai.memory 备案)。
This commit is contained in:
1 parent
0656397a68
commit
8c0fcfee83
10 files changed
+53
-701
No files matched your search
@@ -100,8 +100,10 @@ TCP 线程只 `recv`,把请求封装成 `TaskData` 后 `PostMessage(WM_MCP_EXE
|
||||
|
||||
### 审查脚本与清单
|
||||
|
||||
- `dwg_review_agent.py`:逐图框审查流程。`MODEL_NAME`(默认 `deepseek-flash`)、
|
||||
`CHECKLIST_PATH`(默认 `review_checklist.json`)。
|
||||
> 注:原单文件脚本 `dwg_review_agent.py` 已由 `dwg_review/` 包取代(见
|
||||
> [LLM 识图审图 Agent 架构决策](project_review_agent_impl.md)),并于 2026-10-14 删除。
|
||||
|
||||
- 逐图框审查流程:`MODEL_NAME`(默认 `deepseek-flash`)、`CHECKLIST_PATH`(默认 `review_checklist.json`)。
|
||||
流程:`detect_drawing_frames` → 每框 `zoom_to_window` + `query_entities(window)`
|
||||
+ `get_text_content(window)` + `get_viewport_screenshot` → LLM 审查 → 汇总。
|
||||
- `review_checklist.json`:**可配置审查清单**,5 大类
|
||||
@@ -144,6 +146,7 @@ TCP 线程只 `recv`,把请求封装成 `TaskData` 后 `PostMessage(WM_MCP_EXE
|
||||
|
||||
## 遗留 / 待办
|
||||
|
||||
1. `dwg_review_agent.py` 仍硬编码 DeepSeek API Key(已推送远程),建议改为环境变量 `DEEPSEEK_API_KEY`。
|
||||
1. ~~`dwg_review_agent.py` 仍硬编码 DeepSeek API Key~~ —— 该脚本已于 2026-10-14 删除;
|
||||
但 Key 已随提交 `bdd77af` 进入 git 历史并推到远程,**必须去 DeepSeek 控制台轮换**。
|
||||
2. `review_checklist.json` 可补充「检查方法 / 阈值」;可加跨图框统计工具;可把清单移入 MCP 侧。
|
||||
3. 后期整理建筑/工业管道等审图规范并接入,让 LLM 参照规范审核。
|
||||
@@ -40,7 +40,12 @@ type: project
|
||||
(唯一 TCP 封装:单飞锁 + 换行分帧 + 重试 + 兼容 `error`/`isError`)、`llm_client.py`、
|
||||
`cad_tools.py`(动态工具表 + 只读白名单 `READ_ONLY_TOOLS`)、`checklist.py`、
|
||||
`phases/{planning,evidence,review,report}.py`、`annotator.py`、`__main__.py`。
|
||||
**取代**根目录散落的 `dwg_review_agent.py` / `agent_loop.py` 等重复脚本。
|
||||
**取代**根目录散落的 `dwg_review_agent.py` / `agent_loop.py` 等重复脚本
|
||||
(这 5 个遗留脚本已于 2026-10-14 删除,见 [环境与外部资源](reference_environment.md))。
|
||||
- `tests/`(pytest 回归网):假 LLM + 假 MCP 基座的**离线快层**,`tests/fakes.py` 提供
|
||||
`FakeLlmClient` / `FakeMcpClient` / `make_ctx`。锁定 `dwg_review` 既有行为。
|
||||
**陷阱**:绝不构造真 `LlmClient`(无 key 抛错)、无参 `CadTools()` 或 `ReviewContext.create()`
|
||||
(构造即 `list_tools()` 触网);一律 `make_ctx()` 注入假件。
|
||||
- `verify_mcp_frame.py`:基座改动验证脚本(分帧 / 大报文 / string id / 通知 / isError)。
|
||||
|
||||
## 环境事实
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: 环境与外部资源
|
||||
description: CadProject 的构建/运行要点、CAD SDK 路径、测试脚本等外部资源指引
|
||||
description: CadProject 的构建/运行要点、CAD SDK 路径、测试分层(pytest 快层 + verify_* 慢层)等外部资源指引
|
||||
type: reference
|
||||
---
|
||||
|
||||
@@ -26,16 +26,28 @@ type: reference
|
||||
- 先启动 **已加载插件的 CAD**,确认 `127.0.0.1:8080` 在监听。
|
||||
- 脚本通过 TCP 连接 `127.0.0.1:8080` 收发 JSON-RPC。
|
||||
|
||||
## 测试脚本(根目录,非单元测试)
|
||||
## 测试(两层,互不替代)
|
||||
|
||||
**快层 —— pytest 离线单元测试**(`tests/`,假 LLM + 假基座,无需 CAD、不联网、秒级):
|
||||
|
||||
- `pip install -r requirements-dev.txt` → `python -m pytest`。
|
||||
- 配置:`pytest.ini`(`testpaths = tests`)、根 `conftest.py`(加 `sys.path` + `RENDER_WAIT=0` / `REPORT_DIR=tmp` fixture)。
|
||||
- 陷阱:`dwg_review.config` 常量导入期定值,改 `os.environ` 无效,须 `monkeypatch.setattr(config, ...)`。
|
||||
|
||||
**慢层 —— 端到端冒烟脚本**(根目录 `verify_*.py`,需 CAD 在线且 `127.0.0.1:8080` 监听):
|
||||
|
||||
| 脚本 | 作用 |
|
||||
| --- | --- |
|
||||
| `test.py` | 截图 → 发 DeepSeek 视觉模型 → 回答 |
|
||||
| `test_autoagent.py` | 拉一次视口截图存 `test_screenshot.png` |
|
||||
| `countOfCircle.py` | 伪造 `zoom_window_normalized` 调用,验证 TCP 链路 |
|
||||
| `agent_loop.py` | 完整 Agent 循环(多回合),需 openai 包与 API Key |
|
||||
| `verify_mcp_frame.py` | 基座最小集:分帧 / id / isError 映射 |
|
||||
| `verify_mcp_tcp_hardening.py` | TCP 收发路径加固(超长帧 / 粘包 / 半关闭) |
|
||||
| `verify_mcp_fault_injection.py` | 工具异常保护(类型错误不再崩 CAD) |
|
||||
| `verify_stdio_bridge.py` | stdio ↔ TCP 桥(协议协商 / 转发 / 通知) |
|
||||
| `verify_annotate.py` | 批注工具运行时验证(绘制/校验/改属性/清理);`--keep` 保留批注 |
|
||||
|
||||
> 历史:根目录 `test.py` / `test_autoagent.py` / `countOfCircle.py` / `agent_loop.py` /
|
||||
> `dwg_review_agent.py` 五个遗留调试脚本已于 2026-10-14 删除(前三个含硬编码 API Key,
|
||||
> 后两个是重复实现)。`test_screenshot.png` 是 `test_autoagent.py` 的残留产物。
|
||||
|
||||
## 两个构建目标
|
||||
|
||||
| 目标 | 产物 | 作用 |
|
||||
|
||||
Reference in new issue
Block a user