1. Enhanced 3D Cursor 插件在 Blender 里到底解决什么问题
Enhanced 3D Cursor 是一个把 Blender 原生 3D 游标从“能放一个点”升级成“能精确控制、能记录、能吸附、能回放”的插件。它是什么：一个 Python 脚本形式的 Blender 插件，文件名为space_view3d_enhanced_3d_cursor.py，作者是 dairin0d，开源许可 GPL 3+，分类属于 3D 视图。它能做什么：拖拽游标时像移动物体一样带轴线约束、精确坐标输入、吸附到顶点/边/面/边界盒、记录游标历史轨迹、把常用位置存成书签、在书签位置生成空物体。适合谁：需要在本地快速搭建插件运行环境、并且希望把游标位置纳入可复现工作流的开发者，尤其是做程序化建模、批量摆放、脚本驱动场景搭建的人。
原生游标的问题很直接：你只能靠 Shift+右键 或属性面板 N 侧栏里的数值去改，改完没有历史、没有书签、没有吸附反馈，一旦场景复杂，想回到上一个游标位置基本靠记忆。Enhanced 3D Cursor 把这块补上了，它在 3D 视图属性面板里新增两个子面板：Transform Extra Options（变换扩展选项）和3D Cursor Tools（3D 游标工具）。这两个面板名在中文界面里通常不翻译，所以你在侧栏里看到英文名是正常的。
我试过在 Blender 里直接装这个脚本，踩过的坑主要集中在 Python 环境路径和插件加载顺序上。Blender 自带 Python，不需要你系统里再装一个 Python，但插件文件必须放到正确的scripts/addons目录，否则用户首选项里根本搜不到。另外，插件版本和 Blender 版本要匹配，老版本 2.9.8 对应 Blender 2.7x，新版本 Blender 需要从对应分支拿脚本。下面按“原问题与场景 → TaoToken 前置 → 可复制配置 → 验证请求 → 常见错排查 → CTA”的顺序走一遍，每一步都能跟做。
这一节先把场景钉死：你本地已经装好 Blender，想用 Enhanced 3D Cursor 做游标精确控制，同时希望把模型调用相关的配置（Base URL、Key、Model ID）统一到 TaoToken 这一套环境里，避免在多个工具之间来回改 settings。TaoToken 在这里的角色是提供统一的 API 入口，官网是https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=，API 地址是https://taotoken.net/api。注意 API 地址不加 UTM，配置里只写https://taotoken.net/api。
2. TaoToken 前置：把 Base URL、Key、Model ID 三件套准备好
在动 Blender 插件之前，先把 TaoToken 的三件套准备好，这样后面无论你是用 Claude Code、Cline、Codex 还是自己写脚本调模型，配置都能复用。三件套是：Base URL、API Key、Model ID。Base URL 固定写https://taotoken.net/api；API Key 去控制台生成，地址是https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite；Model ID 根据你要用的模型填，比如对话类、编码类各有对应 ID，具体在模型对话页能看到，地址是https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite。
为什么这一步要放在 Blender 插件配置之前？因为 Enhanced 3D Cursor 本身是纯本地插件，不依赖网络，但你在做程序化建模时经常需要让脚本去调模型生成参数、生成摆放规则、生成材质描述。如果你把模型调用配置和 Blender 插件配置分开管理，后面改一个 Key 要改五个地方。统一到 TaoToken 之后，你只需要维护一份 settings，Blender 脚本、Cline、Claude Code 都读同一份。
生成 Key 的步骤：打开控制台，登录后进入 API Keys 页面，地址是https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite，点新建，复制出来的 Key 只显示一次，先存到本地环境变量或配置文件。不要直接硬编码在 Blender 脚本里，因为 Blender 的.blend文件可能被分享，Key 会泄露。推荐做法是写到用户目录下的配置文件，比如~/.taotoken/settings.json，然后 Blender 脚本读这个文件。
Model ID 的选择：如果你只是做游标位置计算、坐标变换这类纯逻辑，不需要调模型；如果你要让模型帮你生成摆放脚本、生成吸附规则，就选编码能力强的模型。Model ID 在模型对话页的下拉里能看到，复制那个字符串，填到配置里。三件套齐了之后，下面进入 Blender 插件的实际配置。
这里要强调一个点：TaoToken 是正常的 API 服务入口，不是任何形式的非法中转，配置里只写官方给的 Base URL 和 Key，不要自己拼奇怪的地址。所有配置都以官方文档为准，文档地址是https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite。
3. 可复制配置：settings 片段与插件加载路径
这一节给可直接复制的配置。分两部分：一部分是 TaoToken 的 settings 片段，一部分是 Blender 插件的加载与配置。
先说 TaoToken 的 settings。如果你用 Claude Code，配置通常写在~/.claude/settings.json或项目级.claude/settings.json。可复制片段如下，注意 JSON 里 Base URL 写https://taotoken.net/api，Key 用占位符，你替换成自己的：
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "sk-你的TaoTokenKey", "ANTHROPIC_MODEL": "你的ModelID" } }如果你用 Codex，配置写在~/.codex/auth.json，可复制片段：
{ "base_url": "https://taotoken.net/api", "api_key": "sk-你的TaoTokenKey", "model": "你的ModelID" }如果你用 Cline 或 Cline MCP，配置在 Cline 的设置里，Base URL 填https://taotoken.net/api，API Key 填你的 Key，Model ID 填你的模型。Cline MCP 的配置如果是 JSON 形式，片段如下：
{ "mcpServers": { "taotoken": { "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的TaoTokenKey", "model": "你的ModelID" } } }三件套在任何工具里都是 Base URL + Key + Model ID，缺一不可。Base URL 统一https://taotoken.net/api，不要加 UTM，不要加斜杠结尾之外的路径。
再说 Blender 插件。Enhanced 3D Cursor 的脚本文件名是space_view3d_enhanced_3d_cursor.py。安装方式有两种：一种是从文件安装，在 Blender 的Edit > Preferences > Add-ons > Install里选这个 py 文件；另一种是手动放到插件目录。手动放的路径，Windows 一般是C:\Users\你的用户名\AppData\Roaming\Blender Foundation\Blender\版本号\scripts\addons\，macOS 是/Users/你的用户名/Library/Application Support/Blender/版本号/scripts/addons/，Linux 是~/.config/blender/版本号/scripts/addons/。放进去之后重启 Blender，在 Add-ons 里搜Enhanced 3D Cursor或3D Cursor，勾选启用。
启用后，3D 视图按 N 打开侧栏，会看到Transform Extra Options和3D Cursor Tools两个子面板。如果没看到，检查是否在 3D 视图里按的 N，以及插件是否真的启用。插件启用后，拖拽游标用左键 LMB，松开确认；按 F10 可以在不碰鼠标的情况下加载操纵杆；拖拽过程中按 F10 进入鼠标自由模式，再按 F10 或 LMB 确认。放弃改动按 Esc 或右键 RMB。
如果你要把 TaoToken 的配置和 Blender 脚本结合，可以在 Blender 的脚本里读~/.taotoken/settings.json，然后调https://taotoken.net/api做请求。这样你的游标摆放规则可以由模型生成，再应用到 Enhanced 3D Cursor 的书签系统里。配置片段和插件路径都给了，下面进入验证。
4. 验证请求与成功结果：插件加载、功能触发、结果检查
验证分三层：插件是否加载成功、游标增强功能是否触发、TaoToken 请求是否通。逐层来。
第一层，插件加载验证。重启 Blender 后，打开Edit > Preferences > Add-ons，搜索框输入Enhanced，如果列表里出现3D View: Enhanced 3D Cursor并且勾选框是勾上的，说明加载成功。再按 N 打开侧栏，看到Transform Extra Options和3D Cursor Tools两个面板，说明 UI 注册成功。如果搜索不到，说明文件没放对目录，或者 Blender 版本不匹配。
第二层，游标增强功能触发。在 3D 视图里，把鼠标放到视图内，按左键拖拽，你会看到游标跟着鼠标走，同时标题栏左侧显示游标坐标。拖拽过程中按 X、Y、Z 可以约束到单轴，按住 Shift 再按 X/Y/Z 可以约束到另外两个轴，按两次同一键移除约束。按 G、R、S 分别进入移动、旋转、缩放游标模式。按 A 在绝对和相对坐标系之间切换。按 B 切全局坐标系，L 切自身，M 切缩放，J 切视图，N 切法线，K 切表面。这些键按下去，标题栏左侧的坐标系显示会变，说明功能生效。
第三层，TaoToken 请求验证。用 curl 测一下，命令如下：
curl -X POST https://taotoken.net/api/v1/messages \ -H "Content-Type: application/json" \ -H "x-api-key: sk-你的TaoTokenKey" \ -H "anthropic-version: 2023-06-01" \ -d '{ "model": "你的ModelID", "max_tokens": 64, "messages": [{"role": "user", "content": "回复 OK"}] }'如果返回里有content字段且内容是 OK 相关，说明 Base URL、Key、Model ID 三件套都对。如果返回 401，说明 Key 错；如果返回 model not found，说明 Model ID 错；如果连接超时，说明 Base URL 写错或网络问题。验证通过后，你就可以在 Blender 脚本里用同样的三件套去调模型，把生成的游标位置写进书签。
成功结果长什么样：Blender 里游标能拖、能吸附、能输入精确坐标、能存书签；终端里 curl 返回正常 JSON。两边都通，闭环就完成了。下面把常见错列出来。
5. 本篇常见错排查：401、local proxy failed、reading choices、OAuth
这一节对照真实报错，逐个排查。第一个，401 Unauthorized。原因通常是 Key 错、Key 过期、Key 前后有空格、或者把 Base URL 写成了带 UTM 的地址。解决：重新去https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite生成 Key，配置里 Base URL 只写https://taotoken.net/api，不要带任何查询参数。检查 JSON 里 Key 字段名是否正确，Claude Code 用ANTHROPIC_API_KEY，Codex 用api_key，Cline 用apiKey。
第二个，local proxy failed。这个报错通常出现在你本地配了代理，但代理没起来，或者代理地址写错。解决：检查你的环境变量里有没有HTTP_PROXY、HTTPS_PROXY、ALL_PROXY，如果有但代理服务没开，先关掉这些变量再试。如果你确实需要走本地代理，确认代理端口和协议对。注意，这里说的代理是本地开发环境的网络配置，不是任何形式的网络绕过工具，配置以你本地开发环境为准。
第三个，reading choices 相关报错。这个通常出现在返回体解析阶段，比如你期望 OpenAI 格式的choices字段，但实际返回的是 Anthropic 格式的content字段。解决：确认你用的接口路径和请求格式匹配。TaoToken 的 API 地址是https://taotoken.net/api，具体路径和请求体格式以官方文档为准，文档地址https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite。如果你在 Cline 里选错了 API 提供商类型，也会出现 reading choices 解析失败，改成对应的提供商类型即可。
第四个，OAuth 相关报错。这个通常出现在 Claude Code 首次登录或 token 刷新时。解决：如果你用的是 API Key 模式，不需要走 OAuth，直接在 settings 里配ANTHROPIC_API_KEY和ANTHROPIC_BASE_URL。如果工具强制走 OAuth，检查是否选错了认证方式。Claude Code 的配置文档在https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite，按文档里的 API Key 模式配。
第五个，Blender 插件相关报错。视图锁定到物体时点击 3D 视图任意位置报错，这是插件已知问题，解决方法是先解除锁定到光标。坐标精确输入时 Ctrl+Backspace 和 Ctrl+Delete 没有清空数据反而有确认效果，这也是已知问题，手动删数字即可。如果在游标移动进行时关闭插件再重开，可能出现 StructRNA 链结构错误，解决方法是不要在游标移动过程中关插件。
第六个，插件面板不显示。检查是否在 3D 视图按的 N，检查插件是否启用，检查 Blender 版本和插件版本是否匹配。老版本 2.9.8 对应 Blender 2.7x，新版 Blender 要用对应分支的脚本。
排查完这些，基本能覆盖 90% 的配置问题。剩下 10% 看日志，Blender 的报错在Window > Toggle System Console里看，终端的报错直接看输出。
6. 语义一致 CTA：按场景选入口
排障和接入相关的，去 API Keys 页面和接入文档。API Keys 地址https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite，接入文档地址https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite。验证模型是否通的，去模型对话页，地址https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite。长期做编码和 Agent 的，去 Coding Plan，地址https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite。Claude Code 相关配置，看 ClaudeCodeAnthropic 文档，地址https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=claudecode&utm_campaign=rewrite。
最后给一个实用技巧：把 Enhanced 3D Cursor 的书签库和 TaoToken 的配置放在同一个项目目录下，比如项目根目录建.taotoken/settings.json和.blender/bookmarks.json，这样换机器时整个项目一起拷走，游标书签和 API 配置都不丢。Blender 的书签默认存在Default屏幕属性里，如果你删了或重命名了Default屏幕，书签会丢，所以定期导出书签位置到项目目录是个好习惯。游标历史记录在所有场景中共享，改一次游标位置就加一条记录，历史条数在3D Cursor Tools面板的History size里调，别设太大，否则.blend文件会变大。
