AcEdJig 随笔：把 Cursor Base URL 改到 TaoToken 的实操记录

1. AcEdJig 拖拽开发时模型补全为什么总在关键处掉链子如果你正在做 AutoCAD 二次开发大概率绕不开AcEdJig。它负责的是那种“鼠标一动、实体跟着预览”的交互体验画线时橡皮筋跟着走插入块时图元随光标漂移标注角度时数值实时刷新。这套机制的核心是sample()、update()、entity()三个回调在drag()循环里被反复调用任何一处状态没接上预览就会卡住或者直接崩掉。问题出在写这类代码的时候。AcEdJig的继承体系、DragStatus的枚举分支、UserInputControls的组合位运算、setKeywordList的关键字返回序号这些细节零散又容易记混。用 Cursor 写的时候模型经常给出“看起来对但编译不过”的补全比如把kCancel和kNormal的分支写反或者在sample()里漏掉setDispPrompt导致提示不刷新。更麻烦的是当你把 Cursor 的 Base URL 指向默认通道时长上下文里的 ObjectARX 头文件路径、AcGiWorldDraw的渲染重载签名模型有时会“幻觉”出一个不存在的参数列表。我试过在同一个.cpp文件里连续改AcEdJig的派生类发现补全质量波动很大。后来把 Cursor 的请求通道统一到 TaoToken 之后至少模型侧的行为稳定了很多——同一个 Key、同一个 Base URL补全和对话走同一条链路排查问题时不用再猜是编辑器插件的问题还是通道的问题。这篇就按我实际改配置的顺序把 Cursor Base URL 指向 TaoToken 的过程、可复制的配置片段以及一次AcEdJig拖拽实体预览的验证动作完整记下来。适合谁看正在用 Cursor 写 ObjectARX / AcEdJig 代码想让模型补全稳定一点的开发者或者你已经在用 TaoToken 的 API想把编辑器也接进同一条通道。下面从环境准备开始每一步都给到能直接粘贴的配置。2. 把 Cursor 接到 TaoTokenBase URL 与 Key 的前置准备Cursor 的模型接入走的是 OpenAI 兼容协议所以核心就三样东西Base URL、API Key、Model ID。TaoToken 的 API 入口是https://taotoken.net/api注意这里不要带任何查询参数保持干净。Key 在控制台的 API Keys 页面生成格式通常是一串以sk-开头的字符串。先确认你的 Cursor 版本支持自定义 Base URL。打开 Cursor进入设置找到 Models 区域。不同版本入口略有差异但关键词都是 “OpenAI API Key” 和 “Override OpenAI Base URL”。如果你用的是较新的版本可能会看到 “OpenAI Compatible” 这样的选项选它然后把 Base URL 填进去。这里有个容易踩的坑Base URL 到底要不要带/v1。TaoToken 的 API 根是https://taotoken.net/api而 OpenAI 兼容的对话补全路径是/v1/chat/completions。所以你在 Cursor 里填的 Base URL 应该是https://taotoken.net/api让 Cursor 自己去拼/v1/...。如果你手贱填成https://taotoken.net/api/v1有些版本会拼成/api/v1/v1/chat/completions直接 404。这个我在早期配置时踩过报错信息是404 page not found排查了半天才发现是路径重复。Key 的获取路径访问控制台登录后进入 API Keys点创建。建议给这个 Key 起个能认出来的名字比如cursor-acedjig方便以后按项目区分额度。创建后立刻复制页面刷新后就看不到了。Model ID 这块TaoToken 支持多种模型。写AcEdJig这种 C / ObjectARX 代码建议选长上下文能力强的模型因为一个.cpp文件加上头文件引用很容易超过 8k token。你可以在模型对话页面先试几个模型看哪个对AcGiWorldDraw、AcDbEntity这些符号的补全更准。选定后把 Model ID 记下来比如claude-sonnet-4-20250514这类字符串填到 Cursor 的模型配置里。三件套凑齐后先别急着写代码。用 curl 发一个最小请求验证通道是否通curl https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的Key \ -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: 回复 ok}], max_tokens: 10 }如果返回里能看到choices数组说明 Key 和 Base URL 都没问题。这一步过了再动 Cursor 的配置能省掉很多“到底是编辑器问题还是通道问题”的纠结。3. 可复制配置Cursor settings 与 AcEdJig 工程文件对照Cursor 的配置分两层一层是编辑器级别的模型设置一层是工程里可能用到的.cursorrules或settings.json。先把编辑器这层搞定。在 Cursor 设置里找到 Models把 OpenAI API Key 填成你的 TaoToken KeyOverride OpenAI Base URL 填https://taotoken.net/api。然后在模型列表里添加自定义模型Model ID 填你验证过的那个。保存后重启 Cursor让配置生效。如果你习惯用配置文件的方式Cursor 的用户级settings.json通常在~/.cursor/或通过命令面板打开。可以加入这样的片段{ cursor.openai.apiKey: sk-你的Key, cursor.openai.baseUrl: https://taotoken.net/api, cursor.models.custom: [ { id: claude-sonnet-4-20250514, name: TaoToken Claude Sonnet, provider: openai } ] }注意字段名可能随 Cursor 版本变化如果保存后不生效优先用图形界面设置。图形界面改完配置文件里会自动同步。工程这层如果你在项目根目录放了.cursorrules可以写一些针对AcEdJig的约束让补全更贴合 ObjectARX 的写法。比如本项目使用 ObjectARX 2024 SDKC17。 AcEdJig 派生类必须重载 sample()、update()、entity()。 DragStatus 分支必须覆盖 kNormal、kCancel、kNull。 关键字列表用 setKeywordList返回从 kw1 开始。 不要生成 MFC 相关代码。这个文件不参与编译但 Cursor 在补全时会把它作为上下文。实测下来加了这几行之后模型在sample()里漏写setDispPrompt的概率明显降低。再给一个AcEdJig派生类的骨架你可以直接粘到.cpp里配合 Cursor 补全class CLineJig : public AcEdJig { public: CLineJig(const AcGePoint3d start) : m_start(start) {} virtual DragStatus sampler() override { setDispPrompt(L\n指定终点: ); setKeywordList(LA B C); AcGePoint3d pt; DragStatus ds acquirePoint(pt); if (ds kNormal) m_end pt; return ds; } virtual Adesk::Boolean update() override { updateDimData(); return Adesk::kTrue; } virtual AcDbEntity* entity() override { if (!m_pLine) { m_pLine new AcDbLine(m_start, m_end); } else { m_pLine-setStartPoint(m_start); m_pLine-setEndPoint(m_end); } return m_pLine; } private: AcGePoint3d m_start, m_end; AcDbLine* m_pLine nullptr; };注意sampler()是sample()在部分 SDK 版本里的写法具体以你手上的头文件为准。Cursor 补全时如果给出sample()而你的 SDK 是sampler()编译会报does not override。这时候把错误信息贴回对话让模型按你的头文件修正。4. 验证请求一次 AcEdJig 拖拽实体预览的完整动作配置改完得用真实动作验证。最直接的方式是写一个最小命令注册到 AutoCAD然后手动拖拽看预览是否跟手。下面这个命令TESTJIG创建一个从原点出发的线段 JIGvoid testJigCommand() { AcGePoint3d start(0, 0, 0); CLineJig jig(start); jig.setDispPrompt(L\n拖拽确定终点按 ESC 取消: ); AcDbLine* pLine nullptr; if (jig.drag() kNormal) { pLine AcDbLine::cast(jig.entity()); if (pLine) { AcDbBlockTable* pBlockTable nullptr; acdbHostApplicationServices()-workingDatabase() -getBlockTable(pBlockTable, AcDb::kForRead); AcDbBlockTableRecord* pRecord nullptr; pBlockTable-getAt(ACDB_MODEL_SPACE, pRecord, AcDb::kForWrite); pRecord-appendAcDbEntity(pLine); pRecord-close(); pBlockTable-close(); pLine-close(); } } }注册命令用acedRegCmds-addCommand这里不展开。编译加载后在 AutoCAD 命令行输入TESTJIG移动鼠标你应该看到一条从原点出发的线段跟着光标走。按 ESC线段消失命令结束。按 A / B / Csample()里acquirePoint返回kKeyword你可以在分支里处理。这个动作验证了两件事一是 Cursor 的补全通道是通的因为你在写CLineJig时模型能给出updateDimData、acquirePoint这些符号二是AcEdJig的拖拽逻辑本身没写错。如果预览不跟手先检查update()里有没有调用updateDimData()再检查entity()返回的指针是否每次都是同一个实体——如果每次new一个新实体预览会闪烁甚至内存泄漏。验证模型侧是否真的走了 TaoToken可以在 Cursor 里打开对话问一个只有长上下文才能答对的问题比如“AcGiWorldDraw::subWorldDraw的返回值类型是什么”。如果模型能准确回答Adesk::Boolean说明通道和模型都正常。如果回答得含糊检查 Model ID 是不是选错了。5. 常见报错排查401、local proxy failed 与 reading choices配置过程中最容易撞上的几个报错我按实际遇到的顺序列一下。401 Unauthorized。这个最直接Key 不对或者没带上。检查 Cursor 设置里的 API Key 是不是完整有没有多余空格。TaoToken 的 Key 以sk-开头如果你复制的时候漏了前缀请求会被拒。另外确认 Base URL 是https://taotoken.net/api不是别的路径。如果 curl 能通但 Cursor 报 401多半是 Cursor 缓存了旧 Key重启编辑器。local proxy failed。这个报错通常出现在 Cursor 尝试走本地代理但连不上。先检查系统代理设置如果你之前配过代理把它关掉让 Cursor 直连。然后确认 Base URL 没有写成localhost或127.0.0.1。TaoToken 的地址是公网域名不需要本地转发。如果报错里出现ECONNREFUSED基本就是代理残留。reading choices 相关报错。比如cannot read property choices of undefined这说明请求发出去了但返回体不是预期的 OpenAI 格式。常见原因是 Model ID 填错或者 Base URL 多拼了/v1。用 curl 复现一下看返回的 JSON 顶层有没有choices。如果没有把完整返回贴到模型对话里让模型帮你判断是路径问题还是模型名问题。OAuth 相关报错。Cursor 有些版本会尝试 OAuth 登录而不是 API Key。如果你看到OAuth token invalid之类的提示去设置里明确选择 “Use API Key” 而不是登录账号。TaoToken 走的是 Key 认证不需要 OAuth 流程。编译期报错does not override。这个不是通道问题是 SDK 版本差异。把报错行和你的头文件里AcEdJig的声明贴给模型让它按实际签名改。Cursor 补全时如果一直给错签名在.cursorrules里写明 SDK 版本。排查顺序建议先 curl 验证 Key 和 Base URL再检查 Cursor 配置最后看工程代码。这样能快速定位是通道问题还是代码问题。6. 把通道固定下来让 AcEdJig 补全不再随机走到这里Cursor 的 Base URL 已经指向 TaoTokenKey 和 Model ID 也配好了。接下来就是日常写AcEdJig代码时让这套配置稳定发挥作用。几个实用习惯第一把常用的AcEdJig骨架放在项目里Cursor 补全时会参考同文件的上下文比空文件里补全准得多。第二遇到DragStatus分支、UserInputControls位运算这类容易错的点直接在对话里让模型列出所有枚举值对照头文件核对。第三长文件里如果补全开始漂移把不相关的代码折叠起来减少上下文干扰。如果你需要长期在 Cursor 里做 ObjectARX 开发可以考虑 Coding Plan额度和通道更稳定。验证模型能力的时候用模型对话页面快速试。Key 的管理在 API Keys 页面接入细节看接入文档。这几个入口我都放在下面按需取用。模型对话https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentmodel_chatCoding Planhttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcoding_plan控制台https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentconsoleAPI Keyshttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapi_keys接入文档https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdoc最后补一个AcEdJig里sample()的关键字处理片段这是拖拽交互里最容易写错的地方virtual DragStatus sampler() override { setDispPrompt(L\n选择模式 [圆弧(A)/直线(B)/取消(C)]: ); setKeywordList(LA B C); AcGePoint3d pt; DragStatus ds acquirePoint(pt); if (ds kKeyword) { switch (keywordIndex()) { case 0: m_mode Mode::Arc; break; case 1: m_mode Mode::Line; break; case 2: return kCancel; } } else if (ds kNormal) { m_end pt; } return ds; }keywordIndex()从 0 开始对应setKeywordList里的顺序不是从 kw1 开始。这个细节模型有时会搞混补全后记得核对。把这段和前面的CLineJig一起编译拖拽时按 A / B / C看命令行提示和分支是否对得上。对上了说明通道、配置、代码三层都通了。