装完 superpowers 没显示OpenCode 的 TaoToken Base URL 别多写 /v1装完 superpowers 后在 OpenCode 里输入Tell me about your superpowers没有返回技能说明或者/skills list看不到superpowers/...这一类技能很多人会先怀疑插件没装上。实际排障时先看 OpenCode 的模型通道是否真的通了更有效。本文按排障视角处理先到 TaoToken 官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopencode_superpowers 创建 Key然后在 OpenCode 的模型通道里把 Base URL 填成https://taotoken.net/api不要多写/v1也不要把带官网 UTM 的页面地址当成接口地址。模型通道通了再完全退出并重启 OpenCode最后用Tell me about your superpowers和/skills list验证技能是否注册成功。下面从原问题、TaoToken 前置、可复制配置、验证结果、常见错排查和 CTA 六段展开核心只聚焦一件事OpenCode 装了 superpowers 却看起来没加载如何通过正确的 TaoToken Base URL 把模型通道和技能注册串起来。一、原问题与场景OpenCode 装了 superpowers 后技能不显示这个场景很典型你按教程在 OpenCode 里装了 superpowers配置文件里加了 plugin或者手动 clone 了仓库并创建了符号链接。重启 OpenCode 后输入Tell me about your superpowers结果没有技能列表输入/skills list也没有看到superpowers/前缀的技能。更让人困惑的是有时 OpenCode 界面看起来正常只是命令没有反应或者过一会报一个模型请求失败。这时不要急着重复安装 superpowers。因为 superpowers 的技能注册和 OpenCode 的模型通道并不是完全独立的两件事。OpenCode 需要能正常请求模型才能把一些交互式命令跑完如果模型通道的 Base URL 配错请求会先失败。你看到的现象就会是“技能不显示”但根因在模型通道。常见症状可以归成几类输入Tell me about your superpowers后没有返回 Superpowers 技能说明。输入/skills list后列表为空或者没有superpowers/技能。OpenCode 完全退出再启动后问题依旧。终端或日志里能看到 401、404、405、网络超时、模型不存在等错误。手动安装时符号链接创建成功但 OpenCode 内仍然不识别技能。排障顺序建议固定为先确认 TaoToken 的 Key 和 API Base URL 是否正确。再确认 OpenCode 的模型通道是否请求成功。再检查 superpowers 的 plugin 字段或手动符号链接。完全退出 OpenCode而不是只关窗口。重启后输入Tell me about your superpowers和/skills list。如果第 1 步和第 2 步没通后面的技能验证很容易被误判。二、TaoToken 前置先让模型通道通再谈技能注册TaoToken 在这里的角色很明确给 OpenCode 提供可用的模型通道。你先在 TaoToken 官网创建 Key再把 OpenCode 的模型通道指向https://taotoken.net/api。这里有两个高频错误一是把 Base URL 写成https://taotoken.net/api/v1二是把官网页面地址连同 UTM 参数一起填进去。正确做法是打开 TaoToken 官网创建或查看 API Key。API 根地址使用https://taotoken.net/api。Key 填YOUR_API_KEY的位置要替换成你自己的 Key。不要把 Base URL 写成https://taotoken.net/api/v1。不要把https://taotoken.net/?utm_source...这种官网页面地址填进接口地址。在 OpenCode 里选中 TaoToken 对应的 provider 和模型。为什么这件事会影响 superpowers 的显示因为 OpenCode 中很多命令依赖模型请求。模型通道失败时OpenCode 可能无法完整响应技能查询或者命令卡住表现出来就像 superpowers 没有加载。先把模型通道打通至少能区分两个问题到底是技能没注册还是请求没成功。拿到 Key 后建议先不要急着反复改 superpowers 安装方式。先让 OpenCode 能正常发一条模型请求。模型通道通了再处理技能列表排障会清晰很多。三、可复制配置opencode.json 里 Base URL 只写 https://taotoken.net/apiOpenCode 的配置文件常见位置如下macOS / Linux~/.config/opencode/opencode.jsonWindows%USERPROFILE%\.config\opencode\opencode.json下面是一个可复制的配置模板包含 superpowers plugin 和 TaoToken provider。把YOUR_API_KEY换成你在 TaoToken 创建的 Key把MODEL_ID换成你要使用的模型 ID。注意baseURL只能写https://taotoken.net/api不要多写/v1也不要带官网 UTM。{ $schema: https://opencode.ai/config.json, plugin: [ superpowersgithttps://github.com/obra/superpowers.git ], provider: { taotoken: { npm: ai-sdk/openai-compatible, name: TaoToken, options: { baseURL: https://taotoken.net/api, apiKey: YOUR_API_KEY }, models: { MODEL_ID: { name: MODEL_ID } } } }, model: taotoken/MODEL_ID }如果你的 OpenCode 版本使用图形界面或交互式命令配置模型通道字段名可能不完全一样但核心值不变Base URL 填https://taotoken.net/apiAPI Key 填你自己的 Key。只要在界面里看到 Base URL 输入框就不要写成https://taotoken.net/api/v1也不要把官网首页的 UTM 链接粘进去。如果你使用手动安装 superpowers也要检查 plugin 和技能目录链接是否有效。macOS / Linux 可以参考下面的检查方式ls -l ~/.config/opencode/plugins/superpowers.js ls -l ~/.config/opencode/skills/superpowers如果链接不存在或者指向了旧目录就需要先清理再重新创建。Windows 下如果符号链接创建失败通常需要管理员权限或开发者模式。无论哪种安装方式改完opencode.json后都要完全退出 OpenCode再重新启动。四、验证请求与成功结果Tell me about your superpowers 和 /skills list在 OpenCode 内验证之前可以先单独验证 TaoToken 的模型请求是否通。下面的 curl 使用正确的 API 根路径拼接方式最终请求地址是https://taotoken.net/api/chat/completions。如果你的模型 ID 不同把MODEL_ID换掉把YOUR_API_KEY换成真实 Key。curl -X POST https://taotoken.net/api/chat/completions \ -H Authorization: Bearer YOUR_API_KEY \ -H Content-Type: application/json \ -d { model: MODEL_ID, messages: [ { role: user, content: ping } ], max_tokens: 8 }如果返回 HTTP 200并且响应里有choices之类的内容说明 Key 和 Base URL 基本正确。如果返回 401优先检查 Key 是否复制完整、是否被替换。如果返回 404 或 405优先检查 Base URL 是否多写了/v1或者是否误把官网 UTM 地址填了进去。模型请求通之后完全退出 OpenCode。不要只关闭窗口要确保进程结束。macOS / Linux 可以结束 opencode 进程后重启Windows 可以在任务管理器里结束 OpenCode 相关进程。重启后在 OpenCode 聊天框输入Tell me about your superpowers然后输入/skills list成功结果应该能看到 Superpowers 的技能列表例如superpowers/test-driven-development、superpowers/systematic-debugging、superpowers/brainstorming、superpowers/writing-plans、superpowers/executing-plans等。看到这些内容说明两件事已经完成一是 OpenCode 的模型通道能正常请求 TaoToken二是 superpowers 插件被加载并完成了技能注册。如果Tell me about your superpowers有普通回复但/skills list仍然没有 superpowers 技能那问题更可能在插件加载或技能目录注册。如果两个命令都无响应或者直接报模型请求错误那仍然要回到 TaoToken Base URL 和 Key 上排查。五、本篇常见错排查/v1、UTM、重启、plugin、权限5.1 Base URL 多写 /v1这是本篇最核心的报错点。TaoToken 的 API 根地址是https://taotoken.net/api不要写成https://taotoken.net/api/v1多写/v1后OpenCode 或兼容 SDK 可能会拼出错误路径服务端返回 404 或 405。表现就是模型请求失败superpowers 命令看起来没加载。把 Base URL 改回https://taotoken.net/api完全重启 OpenCode 再试。5.2 Base URL 填成官网 UTM 地址官网入口可以带 UTM例如https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopencode_superpowers但这个地址用于打开网页、创建 Key不是 API Base URL。接口地址只填https://taotoken.net/api把 UTM 参数带进 Base URL会让请求路径和查询参数异常导致模型通道失败。5.3 Key 没有替换或已经失效YOUR_API_KEY必须替换成真实 Key。如果 Key 前后有空格、换行或者复制不完整会返回 401。建议到 API Keys 页面重新创建或核对 Key。修改后再次完全退出 OpenCode。5.4 OpenCode 没有完全退出只关闭窗口不等于退出。旧进程可能仍在后台继续使用旧配置。改完opencode.json后要结束 OpenCode 进程再重新启动。很多“重启后仍无反应”的案例都是因为进程没有真正退出。5.5 opencode.json 路径或语法错误确认文件在正确位置macOS / Linux~/.config/opencode/opencode.jsonWindows%USERPROFILE%\.config\opencode\opencode.jsonJSON 不能有注释不能有尾逗号。plugin、provider、model字段的层级要正确。如果 JSON 解析失败OpenCode 可能直接忽略部分配置superpowers 和模型通道都会受影响。5.6 plugin 字段没有生效如果使用自动安装检查opencode.json中是否有plugin: [ superpowersgithttps://github.com/obra/superpowers.git ]如果原来已经有plugin数组不要覆盖旧项要追加进去。改完后完全退出 OpenCode让插件重新下载和注册。5.7 手动安装的符号链接失败手动安装时plugins/superpowers.js和skills/superpowers两个链接都要存在。macOS / Linux 检查ls -l ~/.config/opencode/plugins/superpowers.js ls -l ~/.config/opencode/skills/superpowersWindows 下符号链接需要权限建议用管理员权限或开发者模式。链接指向旧目录时先删除旧链接再重新创建。5.8 模型没有选到 TaoToken即使opencode.json里配置了 TaoTokenOpenCode 当前会话也可能仍在使用其他 provider 或模型。确认模型选择的是taotoken/MODEL_ID并且MODEL_ID与 TaoToken 控制台可见的模型 ID 一致。模型选错时请求不会走 TaoToken技能命令也可能失败。5.9 旧缓存和旧版本冲突如果之前装过旧版 superpowers可能存在旧链接、旧目录、旧缓存。可以清理旧链接后重新启动让 OpenCode 重新加载。不要同时保留多个来源的 superpowers 目录避免技能注册冲突。5.10 网络和 DNS 问题如果 curl 请求超时检查本机网络、DNS、防火墙和代理设置。目标地址是https://taotoken.net/api先确保这个地址能正常访问。网络不通时OpenCode 里的技能命令也会没有反应。六、语义一致 CTAAPI Keys 与接入文档如果你的 OpenCode 装了 superpowers 但技能不显示建议按本文顺序闭环一次先到 TaoToken 创建或核对 Key再检查 OpenCode 模型通道的 Base URL 是否为https://taotoken.net/api然后完全退出并重启 OpenCode最后输入Tell me about your superpowers和/skills list验证。排障和接入相关优先看这两个入口创建或检查 Keyhttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopencode_superpowers_api_keys对照接入文档核对 Base URL 与请求路径https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopencode_superpowers_doc如果你只是想先验证模型通道是否已经通了可以打开模型对话测试https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopencode_superpowers_chat如果你长期在 OpenCode 里配合 superpowers 做工程化编码也可以了解 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopencode_superpowers_coding记住本篇最容易错的点OpenCode 的 TaoToken Base URL 只写https://taotoken.net/api不要多写/v1也不要带官网 UTM。模型通道先通重启再验证superpowers 技能是否注册成功就会一目了然。 装完 superpowers 没显示？OpenCode 的 TaoToken Base URL 别多写 /v1
装完 superpowers 没显示OpenCode 的 TaoToken Base URL 别多写 /v1装完 superpowers 后在 OpenCode 里输入Tell me about your superpowers没有返回技能说明或者/skills list看不到superpowers/...这一类技能很多人会先怀疑插件没装上。实际排障时先看 OpenCode 的模型通道是否真的通了更有效。本文按排障视角处理先到 TaoToken 官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopencode_superpowers 创建 Key然后在 OpenCode 的模型通道里把 Base URL 填成https://taotoken.net/api不要多写/v1也不要把带官网 UTM 的页面地址当成接口地址。模型通道通了再完全退出并重启 OpenCode最后用Tell me about your superpowers和/skills list验证技能是否注册成功。下面从原问题、TaoToken 前置、可复制配置、验证结果、常见错排查和 CTA 六段展开核心只聚焦一件事OpenCode 装了 superpowers 却看起来没加载如何通过正确的 TaoToken Base URL 把模型通道和技能注册串起来。一、原问题与场景OpenCode 装了 superpowers 后技能不显示这个场景很典型你按教程在 OpenCode 里装了 superpowers配置文件里加了 plugin或者手动 clone 了仓库并创建了符号链接。重启 OpenCode 后输入Tell me about your superpowers结果没有技能列表输入/skills list也没有看到superpowers/前缀的技能。更让人困惑的是有时 OpenCode 界面看起来正常只是命令没有反应或者过一会报一个模型请求失败。这时不要急着重复安装 superpowers。因为 superpowers 的技能注册和 OpenCode 的模型通道并不是完全独立的两件事。OpenCode 需要能正常请求模型才能把一些交互式命令跑完如果模型通道的 Base URL 配错请求会先失败。你看到的现象就会是“技能不显示”但根因在模型通道。常见症状可以归成几类输入Tell me about your superpowers后没有返回 Superpowers 技能说明。输入/skills list后列表为空或者没有superpowers/技能。OpenCode 完全退出再启动后问题依旧。终端或日志里能看到 401、404、405、网络超时、模型不存在等错误。手动安装时符号链接创建成功但 OpenCode 内仍然不识别技能。排障顺序建议固定为先确认 TaoToken 的 Key 和 API Base URL 是否正确。再确认 OpenCode 的模型通道是否请求成功。再检查 superpowers 的 plugin 字段或手动符号链接。完全退出 OpenCode而不是只关窗口。重启后输入Tell me about your superpowers和/skills list。如果第 1 步和第 2 步没通后面的技能验证很容易被误判。二、TaoToken 前置先让模型通道通再谈技能注册TaoToken 在这里的角色很明确给 OpenCode 提供可用的模型通道。你先在 TaoToken 官网创建 Key再把 OpenCode 的模型通道指向https://taotoken.net/api。这里有两个高频错误一是把 Base URL 写成https://taotoken.net/api/v1二是把官网页面地址连同 UTM 参数一起填进去。正确做法是打开 TaoToken 官网创建或查看 API Key。API 根地址使用https://taotoken.net/api。Key 填YOUR_API_KEY的位置要替换成你自己的 Key。不要把 Base URL 写成https://taotoken.net/api/v1。不要把https://taotoken.net/?utm_source...这种官网页面地址填进接口地址。在 OpenCode 里选中 TaoToken 对应的 provider 和模型。为什么这件事会影响 superpowers 的显示因为 OpenCode 中很多命令依赖模型请求。模型通道失败时OpenCode 可能无法完整响应技能查询或者命令卡住表现出来就像 superpowers 没有加载。先把模型通道打通至少能区分两个问题到底是技能没注册还是请求没成功。拿到 Key 后建议先不要急着反复改 superpowers 安装方式。先让 OpenCode 能正常发一条模型请求。模型通道通了再处理技能列表排障会清晰很多。三、可复制配置opencode.json 里 Base URL 只写 https://taotoken.net/apiOpenCode 的配置文件常见位置如下macOS / Linux~/.config/opencode/opencode.jsonWindows%USERPROFILE%\.config\opencode\opencode.json下面是一个可复制的配置模板包含 superpowers plugin 和 TaoToken provider。把YOUR_API_KEY换成你在 TaoToken 创建的 Key把MODEL_ID换成你要使用的模型 ID。注意baseURL只能写https://taotoken.net/api不要多写/v1也不要带官网 UTM。{ $schema: https://opencode.ai/config.json, plugin: [ superpowersgithttps://github.com/obra/superpowers.git ], provider: { taotoken: { npm: ai-sdk/openai-compatible, name: TaoToken, options: { baseURL: https://taotoken.net/api, apiKey: YOUR_API_KEY }, models: { MODEL_ID: { name: MODEL_ID } } } }, model: taotoken/MODEL_ID }如果你的 OpenCode 版本使用图形界面或交互式命令配置模型通道字段名可能不完全一样但核心值不变Base URL 填https://taotoken.net/apiAPI Key 填你自己的 Key。只要在界面里看到 Base URL 输入框就不要写成https://taotoken.net/api/v1也不要把官网首页的 UTM 链接粘进去。如果你使用手动安装 superpowers也要检查 plugin 和技能目录链接是否有效。macOS / Linux 可以参考下面的检查方式ls -l ~/.config/opencode/plugins/superpowers.js ls -l ~/.config/opencode/skills/superpowers如果链接不存在或者指向了旧目录就需要先清理再重新创建。Windows 下如果符号链接创建失败通常需要管理员权限或开发者模式。无论哪种安装方式改完opencode.json后都要完全退出 OpenCode再重新启动。四、验证请求与成功结果Tell me about your superpowers 和 /skills list在 OpenCode 内验证之前可以先单独验证 TaoToken 的模型请求是否通。下面的 curl 使用正确的 API 根路径拼接方式最终请求地址是https://taotoken.net/api/chat/completions。如果你的模型 ID 不同把MODEL_ID换掉把YOUR_API_KEY换成真实 Key。curl -X POST https://taotoken.net/api/chat/completions \ -H Authorization: Bearer YOUR_API_KEY \ -H Content-Type: application/json \ -d { model: MODEL_ID, messages: [ { role: user, content: ping } ], max_tokens: 8 }如果返回 HTTP 200并且响应里有choices之类的内容说明 Key 和 Base URL 基本正确。如果返回 401优先检查 Key 是否复制完整、是否被替换。如果返回 404 或 405优先检查 Base URL 是否多写了/v1或者是否误把官网 UTM 地址填了进去。模型请求通之后完全退出 OpenCode。不要只关闭窗口要确保进程结束。macOS / Linux 可以结束 opencode 进程后重启Windows 可以在任务管理器里结束 OpenCode 相关进程。重启后在 OpenCode 聊天框输入Tell me about your superpowers然后输入/skills list成功结果应该能看到 Superpowers 的技能列表例如superpowers/test-driven-development、superpowers/systematic-debugging、superpowers/brainstorming、superpowers/writing-plans、superpowers/executing-plans等。看到这些内容说明两件事已经完成一是 OpenCode 的模型通道能正常请求 TaoToken二是 superpowers 插件被加载并完成了技能注册。如果Tell me about your superpowers有普通回复但/skills list仍然没有 superpowers 技能那问题更可能在插件加载或技能目录注册。如果两个命令都无响应或者直接报模型请求错误那仍然要回到 TaoToken Base URL 和 Key 上排查。五、本篇常见错排查/v1、UTM、重启、plugin、权限5.1 Base URL 多写 /v1这是本篇最核心的报错点。TaoToken 的 API 根地址是https://taotoken.net/api不要写成https://taotoken.net/api/v1多写/v1后OpenCode 或兼容 SDK 可能会拼出错误路径服务端返回 404 或 405。表现就是模型请求失败superpowers 命令看起来没加载。把 Base URL 改回https://taotoken.net/api完全重启 OpenCode 再试。5.2 Base URL 填成官网 UTM 地址官网入口可以带 UTM例如https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopencode_superpowers但这个地址用于打开网页、创建 Key不是 API Base URL。接口地址只填https://taotoken.net/api把 UTM 参数带进 Base URL会让请求路径和查询参数异常导致模型通道失败。5.3 Key 没有替换或已经失效YOUR_API_KEY必须替换成真实 Key。如果 Key 前后有空格、换行或者复制不完整会返回 401。建议到 API Keys 页面重新创建或核对 Key。修改后再次完全退出 OpenCode。5.4 OpenCode 没有完全退出只关闭窗口不等于退出。旧进程可能仍在后台继续使用旧配置。改完opencode.json后要结束 OpenCode 进程再重新启动。很多“重启后仍无反应”的案例都是因为进程没有真正退出。5.5 opencode.json 路径或语法错误确认文件在正确位置macOS / Linux~/.config/opencode/opencode.jsonWindows%USERPROFILE%\.config\opencode\opencode.jsonJSON 不能有注释不能有尾逗号。plugin、provider、model字段的层级要正确。如果 JSON 解析失败OpenCode 可能直接忽略部分配置superpowers 和模型通道都会受影响。5.6 plugin 字段没有生效如果使用自动安装检查opencode.json中是否有plugin: [ superpowersgithttps://github.com/obra/superpowers.git ]如果原来已经有plugin数组不要覆盖旧项要追加进去。改完后完全退出 OpenCode让插件重新下载和注册。5.7 手动安装的符号链接失败手动安装时plugins/superpowers.js和skills/superpowers两个链接都要存在。macOS / Linux 检查ls -l ~/.config/opencode/plugins/superpowers.js ls -l ~/.config/opencode/skills/superpowersWindows 下符号链接需要权限建议用管理员权限或开发者模式。链接指向旧目录时先删除旧链接再重新创建。5.8 模型没有选到 TaoToken即使opencode.json里配置了 TaoTokenOpenCode 当前会话也可能仍在使用其他 provider 或模型。确认模型选择的是taotoken/MODEL_ID并且MODEL_ID与 TaoToken 控制台可见的模型 ID 一致。模型选错时请求不会走 TaoToken技能命令也可能失败。5.9 旧缓存和旧版本冲突如果之前装过旧版 superpowers可能存在旧链接、旧目录、旧缓存。可以清理旧链接后重新启动让 OpenCode 重新加载。不要同时保留多个来源的 superpowers 目录避免技能注册冲突。5.10 网络和 DNS 问题如果 curl 请求超时检查本机网络、DNS、防火墙和代理设置。目标地址是https://taotoken.net/api先确保这个地址能正常访问。网络不通时OpenCode 里的技能命令也会没有反应。六、语义一致 CTAAPI Keys 与接入文档如果你的 OpenCode 装了 superpowers 但技能不显示建议按本文顺序闭环一次先到 TaoToken 创建或核对 Key再检查 OpenCode 模型通道的 Base URL 是否为https://taotoken.net/api然后完全退出并重启 OpenCode最后输入Tell me about your superpowers和/skills list验证。排障和接入相关优先看这两个入口创建或检查 Keyhttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopencode_superpowers_api_keys对照接入文档核对 Base URL 与请求路径https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopencode_superpowers_doc如果你只是想先验证模型通道是否已经通了可以打开模型对话测试https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopencode_superpowers_chat如果你长期在 OpenCode 里配合 superpowers 做工程化编码也可以了解 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopencode_superpowers_coding记住本篇最容易错的点OpenCode 的 TaoToken Base URL 只写https://taotoken.net/api不要多写/v1也不要带官网 UTM。模型通道先通重启再验证superpowers 技能是否注册成功就会一目了然。