# 灵驭物理 · 系列接入前置指引

版本：2026-10-31.2

## 你正在读取什么

这是灵驭物理系列的公开接入入口，不是MCP协议端点，也不授予账号或产品数据权限。老师交给你的网址可以在连接任何MCP之前，通过普通网页读取。
请相对于本指引网址读取 ./catalog.json；读取 ./manual.md 获取产品和客户端配置步骤。以本次实际读取的目录为准，不把网页画面的演示能力当成已开放接口。相对链接必须按当前页面的实际来源解析，不猜测正式域名。

## 根据老师的需求选择产品

先理解老师已经表达的任务。能够确定产品时直接进入该分支，不重复询问；无法确定时只问一句“这次想先用哪款产品，或完成什么事情？”
仅配置本次需要且 mcp.status 为 available 的产品。其他产品仍可打开网页使用，不猜测其MCP地址、不把网页网址填成服务地址，不一次安装目录中的所有连接。
电学已发布1.0.0。选用电学时，先读取产品自己的公开说明 https://dianxue.wuli.navia-future.com/connect.md 与实时目录 https://dianxue.wuli.navia-future.com/api/assistant-connection ，核对当前版本与用途；按任务选择公共操作指南、题目或学习数据连接，不一次安装全部私人连接。公共操作指南无需密钥；学习数据必须由教师在账号设置另行选择班级和期限授权，不能使用题目协作密钥。实验室网页可用，目录未提供其MCP。

目录中的 developmentCapabilities 记录共用接口实现的可迁移性验证，说明见 ./teaching-read.md。它不是独立的系列总MCP服务；publicConfiguration为false且url为null，不可据此另猜地址或安装。实际电学学习查询使用产品目录明确提供的mcp.learning连接，并以该产品实时说明与本人授权为准；其他实验尚未接入。

## 用所在客户端的原生方式配置

先识别自身客户端、可用的网页读取及配置能力。根据客户端当前官方设置或原生命令操作；没有相应能力时，告诉老师需要完成的具体一步，并提供 ./manual.html，不冒充已经安装。
Codex的已核对方法见 https://learn.chatgpt.com/docs/extend/mcp。仅当老师需要电学连接时，先检查名为 lingyu-electric 的现有配置；同URL且启用时复用，不重复添加。存在不同URL、授权方式或禁用状态时先说明冲突，不覆盖原配置或重写整个配置文件。
配置示例（不含任何密钥）：

    codex mcp add lingyu-electric --url https://dianxue.wuli.navia-future.com/mcp --bearer-token-env-var LINGYU_ELECTRIC_MCP_TOKEN

LINGYU_ELECTRIC_MCP_TOKEN 是由客户端运行环境读取的私有授权值，命令本身不会创建或保存它；需由老师在自己的设备完成私有配置，并让客户端进程能读取。不要在公开网页或聊天中索取、回显密钥，不扫描老师下载目录或无关账号配置寻找秘密。沿用已有本人明确提供的配置时仅处理该连接。
WorkBuddy等客户端依其实际支持的自定义MCP入口和官方说明操作，不把其他产品的预置连接器流程冒充本产品已完成联调。

## 教师本人授权

确需私人题目协作时，引导本人到产品网站创建所需范围、权限和有效期的授权，说明接入何种数据。读取指南不等于开通授权；每个产品的授权分别管理。
本入口不收集账号、授权密钥或模型API Key，不替老师授予全部产品权限。不能用未连接或未授权的接口代办工作。

## 用真实结果核对连接

配置写入后，使用当前客户端实际列出的工具或资源核对是否加载。未加载时明确提示重新连接或新开会话，不擅自关闭用户应用。
选择本次实际连接的只读查询：公共指南先读取circuit_get_operation_guide；题目连接列授权题目；学习连接先learning_get_contract再列授权班级。空列表可以是有效结果，无权限或连接错误则如实说明。不得只看配置文件或固定网页示例就说接通。不要为了验证连接自动创建草稿、发作业、发通知或调用收费模型。

## Skill与接下来的使用

配套Skill按产品和任务选择。仅使用目录真实提供且已发布的Skill入口；当前目录没有可安装的产品Skill包，不创建下载地址或自动安装通用插件。
连通后先简短说明当前可用能力，再结合老师任务给一个下一步建议。简单查询直接回答；修改题目草稿前明确老师想改哪里，按实际授权执行，执行后读回核对。不以“万能助手”承诺尚未开放的学生分析或其他产品能力。