在处理 SCD/ICD 时,我常把 LN、DO、DA 的层级弄混,直到把 Claude Code 的模型通道指到 TaoToken 才好一些。直接在官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 创建一把 API Key,填入 Claude Code 就能用;再把整份 IEC 61850 缩写清单发给它,让它按“缩写—全称—所属类别”生成速查表。整个过程最花时间的不再是翻 DL/T 860,而是想清楚 PDIS 是距离保护还是方向比较、MMXU 的电压测量挂在哪个 CDC 下面这类实际问题。下面先从配置入手,把通道固定下来,再逐批整理术语,最后输出一份团队能直接用的 61850_terms.md。
1. 先把 Claude Code 的模型通道切到 TaoToken
1.1 理解 TaoToken 在这条链路里的位置
Claude Code 默认连接 Anthropic 官方 API,但真实项目里 Key 分散、额度分项目、模型来回切,这些事和 61850 工程里的多装置配置很像:一个站里几十台 IED,每台有自己的报告控制块,只靠一份配置很难管住。TaoToken 不是模型厂商,也不做推理,它只做一件事:把“在哪里调用模型”收敛成统一的 Base URL 和一把 Key。请求从 Claude Code 发出后,先到 https://taotoken.net/api 这个兼容通道,再由它按模型 ID 路由到对应模型。这样省掉了多把 Key 的传递成本,换模型时也只改一个 ID。
Claude Code 原生只读一组 ANTHROPIC_* 环境变量,团队里最容易出现的混乱是:A 机器上 Key 有效,B 机器上 Key 过期,C 机器上 Base URL 还指向上一个测试网关。这套配置收敛之后,变数被压到一把 Key 和一个固定 Base URL,模型选择、用量核对都移到网页端,不用再逐台机器检查环境变量。下面先拿 Key,再写配置。
1.2 在官网创建 Key 并确认模型 ID
准备材料只有三样:API Key、Base URL、模型 ID。Base URL 固定是 https://taotoken.net/api,末尾不要加 /v1。API Key 和模型 ID 都要从控制台获取:打开 TaoToken,注册登录后创建 API Key,把生成的字符串保存到安全位置,后面替换 YOUR_API_KEY;再进入模型广场,选择要用的 Claude 型号,把页面展示的模型 ID 记下来,对应后面的 YOUR_MODEL_ID。模型 ID 以模型广场为准,不要凭记忆填模型名,也不要自己拼接带日期后缀的 ID,写错的话 Claude Code 会直接报 400。
2. 写入 settings.json:让 Claude Code 走 TaoToken 的 Base URL
2.1 先用环境变量验证连通
先不急着改配置文件,用环境变量验证最快。打开终端,执行:
export ANTHROPIC_BASE_URL=https://taotoken.net/api
export ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY
export ANTHROPIC_MODEL=YOUR_MODEL_ID
执行完后启动 claude,输入一个最轻量的问题:
用一句话解释 61850 的 MMS
如果 Claude Code 能正常回答“MMS 是制造报文规范,用于站控层与间隔层之间传输报告和控制命令”,说明通道已经通了。这里有个容易踩的细节:环境变量只在当前终端会话生效。如果用 tmux 或 Windows Terminal 的多标签页,每个新会话都要重新 export,否则 Claude Code 会静默退回默认官方地址,表现出来就是“明明配过了,为什么还在吃官方额度”。所以验证通过之后,尽快把配置固化到 settings.json。
2.2 固化到 ~/.claude/settings.json
Claude Code 会读取用户目录下的 ~/.claude/settings.json。如果文件已存在,只需在 env 字段里追加三行;如果文件不存在,新建一个即可。示例:
{
"env": {
"ANTHROPIC_BASE_URL": "https://taotoken.net/api",
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_MODEL": "YOUR_MODEL_ID"
}
}
保存后完全退出终端重开,再运行 claude 验证。确认方式有两种:一是再问一遍刚才的 MMS 问题;二是在 claude 会话里输入 /status,看显示的 Base URL 是否为 https://taotoken.net/api。另外,.bashrc 或 .zshrc 里如果老早 export 过 ANTHROPIC_BASE_URL,它会和 settings.json 的配置冲突,建议在 shell 启动脚本里清掉旧网关地址。
3. 把 FC 功能约束与 CDC 数据类型喂给 Claude Code
3.1 FC 功能约束:先分清状态、测量、控制三族
通道配好之后,正事开始。原文的第一类是功能约束 FC,它决定某个 Data Attribute 能被哪些服务访问。最常用的是 ST(Status,状态信息)、MX(Measurand,测量值)、CO(Control,控制)、SP(Setpoint,定值)、SV(Substitute,取代值)、CF(Configuration,配置)、DC(Description,描述)。后面还有 BR(缓存报告)、RP(非缓存报告)、GO(GOOSE 控制)、MS(多路采样值控制)、US(单路采样值控制)这些服务型 FC。容易弄混的是 SP 和 SV:SP 是定值,SV 是取代值,一个写保护定值,一个临时替换量测值,功能完全不同。
把这组缩写交给 Claude Code 整理成表时,我会让它按“读写型 / 服务型 / 配置型”分组,而不是按原文顺序平铺。实际操作时,把完整清单粘进下面的提问模板就行:
把下面这份 IEC 61850 缩写清单按 FC、CDC、DO、LN、工程词五类整理成 Markdown 表格,格式:缩写 | 全称 | 中文译名 | 所属类别。容易混淆的缩写(如 PDIF/PDIR、SPC/DPC、SP/SV)请在表格后面给出辨析。
【把五类清单粘贴到这里】
Claude Code 返回的表格大概是这个风格(节选):
| FC 缩写 | 全称 | 用途 |
|---|---|---|
| ST | Status | 状态信息,如断路器位置 Pos.stVal |
| MX | Measurand | 测量值,如电流幅值 A.phsA.cVal |
| CO | Control | 控制命令,如合闸 Oper |
| SP | Setpoint | 定值,如过流定值 TctrVal |
3.2 CDC 公用数据类:Quality 和 Analogue value 是重点
第二类缩写是 CDC,Common Data Class。它不是数据对象本身,而是描述数据对象的内部结构。最常用的两个是 Quality(品质)和 Analogue value(模拟值)。Quality 几乎出现在每个测量 DA 后面,包含 validity、detailQual、source 等子位;Analogue value 是测量值的容器,结构里有 f(浮点值)、q(品质)、t(时标)。整份 CDC 清单里还有 Range configuration、Pulse configuration、Originator、Unit、Vector、Point、CtlModels、sboClass 等。
整理 CDC 时,我让 Claude Code 多输出一列“典型出现位置”,例如 Analogue value 的典型出现位置是 MV.mag.f,Originator 的典型出现位置是 SPC.Oper.origin。这样速查表就不只是缩写字典,而是能直接对照 SCD 文件查路径的索引。
4. DO 和 LN:SCD 里最容易搞混的两个层级
4.1 DO 三族,注意 SPC 的双重身份
DO(Data Object)位于 LN 之下、DA 之上,SCD 路径里表现为 LD/LN.DO.DA。比如 PTOC1.Op.general,Op 就是 DO。DO 大致分三族:状态族 SPC、DPS、INS,表示单点状态、双点状态、整数状态;测量族 MV、CMV、SAV,表示普通测量值、复数测量值、采样值;可控族 SPC、DPC、INC、APC,表示可控单点、可控双点、可控整数、可控模拟量。
注意 SPC 同时出现在状态族和可控族——作为 CDC 时它是公用数据类型“可控单点”,作为 DO 时它又代表一个具体的可控单点数据对象。判断方法看它在路径中的位置:LD/LN.SPC 这种形式它是 DO;而在 DO.DA 的 DA 定义中,它作为 CDC 出现。
4.2 LN 按功能域分组,避免在保护域里迷路
LN 是 61850 里最庞大的一层,原文列了近百个。逐个背不现实,比较高效的办法是让 Claude Code 按 IEC 61850-7-4 的功能域分组。保护域高频词:PDIF 差动、PDIR 方向比较、PDIS 距离保护、PTOV 过压、PTUV 欠压、PTOC 过流、PIOC 瞬时过流、PTRC 跳闸条件、RBRF 断路器失灵、RREC 自动重合闸;开关和控制域:XCBR 断路器、XSWI 隔离开关、CSWI 开关控制器、CILO 联锁;测量域:MMXU 测量、MSQI 相序不平衡、MMTR 计量、MHAI 谐波;变压器域:YPTR 电力变压器、YLTC 分接头、YPSH 功率分流;互感器域:TCTR 电流互感器、TVTR 电压互感器。
直接发给 Claude Code 的 prompt 可以是这样:
请把上面的 LN 缩写按 IEC 61850-7-4 的功能域重新分组,保留缩写、英文全称、中文说明。分组后每个域只留最常用的 8-10 个,再用表格输出。
4.3 用对比问题验证速查表
速查表生成之后,找几个容易混的 LN 验证。PDIF 是差动还是方向比较?答案是差动,PDIR 才是方向比较。差异只在第三位字母:DIF 来自 Differential,DIR 来自 Direction。与此同时,PDIS 是距离保护,PTOV 是过电压。让 Claude Code 解释差异时,可以这样问:
区分 PDIF、PDIR、PDIS 三个逻辑节点,用表格列出每类的保护原理和典型输入量。
Claude Code 会结合保护原理输出对比,比如“PDIF 比较差动电流、PDIR 比较方向元件动作、PDIS 测量阻抗定位故障”。这类问题比单纯背缩写有用,因为它把缩写放回 SCD 的实际功能场景里。以后再看到 Pxxx 开头的 LN,至少知道是保护域。
5. MMS、GOOSE、SCL 与 401/404 排障
5.1 工程常用语速查:把缩写按协议、模型、文件归类
最后一类是工程串场词。MMS(Manufacturing Message Specification)是制造报文规范,用于站控层与间隔层之间传报告、控制、定值;GOOSE(Generic Object Oriented Substation Event)是面向通用对象变电站事件,用于间隔层装置之间的快速跳闸和联锁;GSSE 是早期版本里的通用变电站状态事件,新工程很少用。模型类缩写:LD 逻辑设备、LN 逻辑节点、DO 数据对象、DA 数据属性、FC 功能约束、FCDA 功能约束数据属性、CDC 公用数据类、RCB 报告控制块。
文件类缩写最容易混淆:ICD 描述 IED 能力,SSD 描述系统规格,SCD 描述变电站完整配置,CID 是实例化后的 IED 配置,IID 是实例化 IED 描述,SED 用于系统间交换,SCL 是这些文件的描述语言。让 Claude Code 按“协议 / 模型 / 文件”三类整理:
把上述缩写按协议、模型、文件三类整理,文件类要标注每个文件对应的工程阶段。
整理结果存进 61850_terms.md 之后,再遇到 SCD 关联不上 ICD 这类问题,直接问 Claude Code 文件类型和对应的工程阶段,不用自己翻规范。
5.2 TaoToken 通道上最常见的三类报错
配好之后如果调用失败,报错基本逃不出三类。401 Unauthorized:ANTHROPIC_AUTH_TOKEN 还是占位符 YOUR_API_KEY,或者 Key 复制少了字符。这类似 SCD 里 DOI 引用了一个不在 ICD 里的 DA——引用了没有实例化的对象。404 Not Found:Base URL 写成了 https://taotoken.net/api/v1,TaoToken 的接口根路径只到 /api。这跟 FCDA 把 DO 层写成 LN 层是同一类错误,路径层级不对。400 Bad Request:模型 ID 不是模型广场展示的真实 ID。三个错误按优先级排查:先看状态码,再检查配置,最后对照模型广场。不要一上来就重装 Claude Code。
提示:检查 Base URL 时,顺便看看 shell 启动脚本里有没有残留的
ANTHROPIC_BASE_URL,旧网关地址很容易在这里和新配置打架。
6. 去模型广场核对本次调用的用量,并把速查表沉淀下来
6.1 在控制台核对调用记录
配置结束后,打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 的用量页面,正常情况下能看到刚才 Claude Code 的请求记录。看到记录,说明 Base URL、Key、模型 ID 三者对齐,后续写 SCD 可以直接依赖这条通道。这项检查很像 SCD 配置完成后的实例化验证:不是文件生成出来就结束,还要逐条确认数据对象实例创建成功。
6.2 把速查表存进工程仓库
让 Claude Code 把整理好的五张表保存为 Markdown 文件,命名 61850_terms.md,放进项目 docs 目录。之后评审 SCD、写 FCDA、核对 LN 所属域时,直接在对话里让它读取这份文件即可。我的使用习惯是:每次新开终端先确认 settings.json 的 env 没被覆盖,然后用“用一句话解释 61850 的 MMS”做连通性体检,再进入正式问题。这样把 Key 和通道的问题交给 TaoToken,把缩写梳理交给 Claude Code,自己只保留对结果的校验和判断。




被折叠的 条评论
为什么被折叠?



