激活调试套餐，开始知识召回
付费用户使用一次性激活码在本机绑定设备，无需注册账号、用户名或密码，日常使用无需绑定工程。已有普通 Token 可按旧连接方式使用，但它不提供商业套餐的防共享保护。
先下载官方连接器，私密激活后再安装用户 Skill。WBA- 激活码也可为同套餐续期；换机或丢失电脑请凭授权编号联系发放方。
下载官方连接器01 · 交给 Agent 准备复制这段话，开始接入
在 Codex 或 Claude Code 中粘贴下面的指令。Agent 会先准备连接器，私密激活并核对授权，再安装用户 Skill。激活码和 Token 只在本机输入，不要粘贴到聊天中。
旧版 WB- 兑换码请走兑换码开通入口。这是另一种交付方式，已有 Token 不需要再兑换或登录。
开始前，确认你的环境
知识召回
已验证 Windows 上的 Codex、Claude Code。请先安装其中一个客户端，并能正常对话。Agent 会检查 Python 和 Skill / MCP 支持。
其他客户端与系统需单独核验，不默认承诺完整接入体验。
需要连接硬件时
当前设备插件以 Windows x64、Python 3.13 为已验证环境。HIL 底座的软件安装已验证 Windows 3.13、Linux 3.12；底座要求 Python 3.10+，包含 venv / ensurepip。
设备插件按实际型号安装驱动；Linux 底座可用不等于设备插件已验证。
下载了 ZIP，接下来怎么安装？
把下载文件的位置告诉 Agent，不要发送 Token。让它校验归档后，找到 wikibox/skills/wikibox/SKILL.md 所在目录，按当前客户端的安装规则放置；不要把整个 ZIP 外层文件夹当作 Skill。
- Codex：安装后新开会话，从技能列表选择 WikiBox，或输入
$wikibox init。 - Claude Code：安装后新开会话，输入
/wikibox init。
已有版本先检查更新并保留原连接配置。环境缺项让 Agent 明确指出，不把“已下载”当作“已安装”。
看到这些结果，才算连好了
- Token 已通过校验，显示实际授权范围和有效期。
- Agent 已加载 WikiBox 工具，能读取当前授权知识目录。
- 针对你的问题读到相关方法，并给出可追溯来源。
可以问：“设备打开 RTT 日志后故障不再复现，帮我找排查方法，区分已知事实、假设与下一步验证。”
MCP 服务地址：正在读取站点配置…
调试套餐包含什么？
包含持续更新的调试知识、WikiBox 用户 Skill、HIL 编排器，以及当前已支持的三类硬件插件 Skill。插件无需另购；实物设备不包含在套餐内，也不要求一次全部安装。
HIL 编排器
hil-orchestrator 将方法组织成调试步骤，记录证据；随包提供 hil-core 和固定依赖，Agent 自动准备隔离环境。
MKLink 探针
mklink-ai-probe 用于 MCU 调试、内存观测、RTT 等，按当前设备能力和操作规则执行。
示波器
dswave-ai-scope 用于受支持的 DSCope 波形观测与采集。
CAN 分析仪
toomoss-ai-can 用于受支持的 Toomoss / USB2XXX CAN、CAN FD 设备。
对 Agent 说：“安装套餐内的 HIL 编排器，我使用的是〔设备型号〕，请准备对应插件，先结合 WikiBox 给出排查计划。”Agent 从当前授权市场获取版本，绑定设备运行环境，再检查驱动、连接与台架。
只查方法、分析日志时不需要硬件插件。安装完成不等于实物验证通过；写入、烧录、激励等动作继续按设备规则确认。
付费套餐如何续期和换机？
续期时让 Agent 使用原连接器的 renew --profile 命令，在本机私密输入同套餐未使用的 WBA- 码，不需要重装或重新激活。换机或丢失电脑时，凭授权编号联系发放方撤销旧设备并领取短期换机码；不要复制设备私钥。
常见问题 · 接入与使用
我有调试 Token，还要账号或密码吗？
不需要。直接复制本页接入指令，让 Agent 打开本机私密输入界面。客户账户仅用于另一种兑换码交付流程；不要为 Token 接入额外注册账户。
到期时间在哪里看？到期后会怎样？
对 Agent 说：“查询我的 WikiBox 授权范围和有效期。”以服务器返回结果为准；没有到期时间时应明确说明，不能推算。过期后不能访问受保护的知识、市场或更新。Token 用户向发放方续期；兑换码账户可在“我的授权”查看有效期并兑换续期。已下载文件不会远程删除。
找不到 Skill，或安装后没有 WikiBox 工具？
先让 Agent 核对 Skill 是否装进当前客户端的正确目录，再新开会话。Skill 可见但工具不可用时，检查 MCP 配置、正常信任提示与连接状态；不要重复安装全部软件。让 Agent 分别报告“安装、连接、实际召回”哪一步失败。
提示无权限、Token 失效或连接失败怎么办？
让 Agent 检查站点地址、凭据状态与授权范围，不把 Token 打印出来。到期或撤销请联系发放方；网络故障稍后重试。反馈问题时提供客户端、系统、失败步骤和已去除凭据的错误信息。
套餐里的 HIL 或设备插件没有显示？
先刷新当前 Token 的授权市场并核对调试知识权限。调试套餐应包含上面列出的四个插件，若仍缺失，向发放方反馈授权配置问题，无需另买插件，也不要更换为管理员凭据。
换电脑或提示设备 / 并发限制怎么办？
普通 Token 在新电脑使用本机向导接入。设备绑定的商业凭据须使用官方连接器，不要复制私钥；可在原交付流程中撤销旧设备、激活新设备。提示并发限制时先停止旧会话请求，按服务端提示重试。
查到方法，就代表故障原因已经确定了吗？
不代表。召回结果是排查依据，结论还需要现场证据。没有相关知识时 Agent 应明确说明；硬件插件需要真实设备、驱动、接线与台架检查，软件自检不能代替上板验证。
以后知识更新还要重新安装吗？
中心知识按当前目录实时读取，不用反复重装。Skill 有新版时 Agent 会提示，确认后更新；保留原连接配置。更新和下载仍需有效授权。
团队功能 · 绑定工程有什么用？
团队可用 wikibox team 按工程积累规则、设计和调试经验；服务器核对工程权限。普通召回和调试方法访问不要求绑定工程。