教程 · 进阶 · 本站原创导读

做一个属于自己的 Claude Code 扩展

参考原文:Getting started with Claude Code mods

认识 Mods 的事件链、状态和界面能力,从一个可观察、可测试的小扩展开始。

原作者 Addy Osmani · 原文发布 2026-10-01 · 原文约 11 分钟 · 核对 2026-10-26

阅读官方英文原文 ↗

01 · 先理解扩展所在的位置

Mod 作为插件里的模块进入事件处理链。接到事件后,可以观察结果、修改输入,也可以直接响应;是否调用 next 决定事件是否继续传递。

02 · 把状态与显示分开

上下文使用率是数据,提示条是数据的呈现。使用宿主管理的状态可以应对热重载;显示逻辑还要考虑空间不足和其他组件占用位置。

03 · 从只读扩展开始

先做一个观察上下文的扩展,再考虑拦截工具。API 会随版本变化,实际开发应核对本机生成的类型定义,并验证事件传递和界面更新。

04 · 自动显示要等待有效数据

/diff 自动打开会等待已有读取结束,再发起一次读取;成功且有可显示文件才打开。用户已关闭、手动打开或切换会话时,过时的自动尝试应退出。手动打开仍可呈现空态或错误。对照源码观察数据、用户意图与异步结果如何协调。

05 · 权限判断要保留来源

sec-default 用 verdict.plugin 识别插件发起的询问,用事件 approver 判断是否由宿主审批;保留受保护裁决,也允许更严格的答复。源码注明相关已发布类型声明尚待更新,练习应以固定提交推演,并核对实际宿主版本。AGENTS.md 的恢复分支则继续保留自己的已投递指令记录。

以上为 Learn 独立编写的中文导读;原文中的完整演示、代码与版本细节,请核对官方文章。下面的练习和自测为本站原创,不是原作者的作业。

MAKE IT YOURS

动手练习

本站原创练习

从仪表盘到异步状态推演

先用 10%、55%、92% 三组模拟数据画上下文提示条。再对照 /diff 源码,推演读取为空、读取失败、读取期间用户关闭、读取期间又有编辑四种情况。最后对照 sec-default,把普通模式询问、插件发起的询问和宿主审批分别列出来源字段及更严格答复的处理;只用模拟事件,无需安装或修改权限。

  • 提示条状态、空数据与窄屏草图
  • 四种异步场景的读取、打开、退出或重试时序
  • 三种询问的来源字段、裁决结果与宿主版本依据

正在读取此设备的学习记录……

一分钟自测 · 一个只观察工具结果的 Hook 应如何处理原事件?