Files
cad-agent/ai.memory/reference_environment.md
T
gjm 0b4ffdec0c chore(memory): 沉淀基座 c++_dll 加载/执行的排查结论
- 新增 ai.memory/project_mcp_frame_dll_loader.md:
  1) 运行时 acrxGetApiVersion() 有状态、不可用于版本比对;
  2) DLL 工具写数据库需文档锁(应用上下文 → eLockViolation);
  3) 同一 DLL 只加载一次(模块缓存)及代理不再 FreeLibrary 的原因。
- 更新索引 MEMORY.md;reference_environment.md 的 c++_dll 说明改为「只加载一次」
  并指向新文件,测试脚本表补 verify_annotate.py。
- 修正 feedback_preferences.md 中 ai.memory「尚未入库」的过时说明。
2026-10-09 22:37:31 +08:00

3.2 KiB
Raw Blame History

name, description, type
name description type
环境与外部资源 CadProject 的构建/运行要点、CAD SDK 路径、测试脚本等外部资源指引 reference

环境与外部资源

构建

  • 系统:CMake + vcpkg + Visual Studio 生成器,通过 CMake Presets 区分 CAD 版本。
  • 产物:bin/<Config>-<TAG>/ 与 lib/<Config>-<TAG>/。
  • 命令:cmake --preset R230 → cmake --build --preset R230 --config Debug。
  • 可用 preset:R180–R260(AutoCAD,ARX 18–26)、Z2023–Z2026(ZWCAD,ZRX)。
  • 前置:需要 VCPKG_ROOT;必需 cache 变量 CAD_SDK_ROOT、DEP_LIB_ROOT、DEP_INC_ROOT、 CAD_SDK_VERSION(AutoCAD 还需 CAD_SDK_SUBVERSION)。

CAD SDK 路径

  • AutoCAD:仓库同级 ../envi-code/Arx
  • ZWCAD:仓库同级 ../envi-code/Zrx
  • 在 cmakepresets.json 的 CAD_SDK_ROOT 中配置。

运行 / 联调

  • 先启动 已加载插件的 CAD,确认 127.0.0.1:8080 在监听。
  • 脚本通过 TCP 连接 127.0.0.1:8080 收发 JSON-RPC。

测试脚本(根目录,非单元测试)

脚本 作用
test.py 截图 → 发 DeepSeek 视觉模型 → 回答
test_autoagent.py 拉一次视口截图存 test_screenshot.png
countOfCircle.py 伪造 zoom_window_normalized 调用,验证 TCP 链路
agent_loop.py 完整 Agent 循环(多回合),需 openai 包与 API Key
verify_annotate.py 批注工具运行时验证(绘制/校验/改属性/清理);--keep 保留批注

两个构建目标

目标 产物 作用
src/cad_mcp_frame cad_mcp_frame.arx(ZWCAD 下 .zrx) MCP 基座:起 TCP、解析配置、路由执行
src/cad_mcp_plugins cad_mcp_plugins.dll 示例 C++ 工具插件,ABI 动态加载

三种工具后端(backend.type)

  • lisp_inline:{占位符} 替换后 sendStringToExecute(异步)。
  • lisp_file:(load "文件" nil) 后执行 call_template。
  • c++_dll:LoadLibrary(同一 DLL 只加载一次)+ 工厂/销毁函数(同步,可返回图像)。 版本校验与「写库需文档锁」两个坑见 MCP 基座 c++_dll 加载与执行的坑。

远程仓库

  • 现状(2026-10-08 起):CadProject 已从「某仓库的子目录」独立为单独仓库。
    • origin = ssh://git@39.107.55.179:222/gjm/cad-agent.git
    • 当前分支 home-ai-dev;服务器只保留 main,采用 PR 流程 (home-ai-dev → main,合并后源分支被删除,故本地 home-ai-dev 的 upstream 显示 [gone])。
    • 历史已被重写/重新初始化(哈希全新)。
  • 历史参考(旧):new-start.git = ssh://gjm@47.93.46.28:1216/srv/git/new-start.git
  • SSH 密钥(2026-10-08 变更):服务器已改用新密钥 ~/.ssh/id_ed25519_guojianming(注释 guojianming.go@gmail.com); 旧密钥 ~/.ssh/id_ed25519(deploy@aly-db)已被服务器移除,会 Permission denied (publickey)。 本仓库已设置 git config core.sshCommand "ssh -i ~/.ssh/id_ed25519_guojianming -o IdentitiesOnly=yes"。 换机器时需补该配置或加入 ~/.ssh/config。