来源信息

  • 文档类型：阅读笔记 · 整理日期 2026-10-07
  • 原文：《Getting started with Claude Code Mods》 · 作者 Addy Osmani · 发布于 claude.dev · 发布日期 2026-10-01
  • 原文地址：https://claude.dev/blog/getting-started-with-claude-code-mods/
  • 本文为阅读整理，观点与数据以原文为准；原文不提供的事实均已标注为整理者说明。

阅读范围

  • 全文，含机制、Token Weather 六步、分享、两个扩展、四条习惯与结语。

事件链机制

Mod 是插件中的 JavaScript 或 TypeScript 模块。register 注册事件处理，next 把事件交给后续插件及默认行为；处理器可观察、改写或直接回答。与逐事件启动的设置 hook 不同，它常驻会话，可保存状态、绘制界面并调用宿主能力。模块没有 DOM 或 Node，外部访问经宿主 API；这不等于插件没有操作权限。

Token Weather 六步

教程从插件目录与清单开始，再挂接 AbovePrompt 绘图、读取上下文用量、保存历史、完成天气展示、验证测试，最后按插件方式分享。支持描述需求让 Claude 生成，但临时热加载目录与正式保留不同。

热重载会重新注册并触发启动，模块变量会重置；宿主 state 可保留当前会话数据，且需类型契约声明。渲染中读取 state 会订阅变化。界面应适配真实可用宽度，没内容或其他界面需要位置时交还 next。示例测试模拟用量并核对重绘，展示的是上下文占用，不是精确费用。

两个扩展与制作习惯

Blast Radius 暂缓风险命令，显示影响后让人选择；它只识别命令文本，别名和间接脚本可能绕过，不能替代权限系统。Replay Theater 观察写入前后内容，按主循环回合分组展示修改过程，不阻止编辑。

四条习惯是使用本版本生成的类型、从 e.props 读组件属性、为热重载保存宿主状态、用日志排查无效渲染。结语列举用量显示、读文件地图、完成提醒等方向；分享依赖插件市场与安装流程。

限制与游戏开发建议

文章要求特定最低版本，API 会变，应以实际构建的声明为准。第三方 mod 可通过宿主访问会话能力，需审查来源。本文未安装、运行教程命令、启用热加载或修改配置。

以下为整理者建议，非原文实测，也不表示已经实施。

可先考虑只读的 NPC 开发观察面板：显示本轮读取的状态定义、修改涉及的资源类型、待人工验证项。修改回放帮助理解改动顺序，但不能证明场景运行正确；必须补状态断言与实际试玩。

风险提示可区分普通脚本编辑、场景资源覆盖和存档迁移，提供明确目标与取消出口。硬限制应在可靠的权限与路径检查层实现，不能仅用关键字匹配。避免把私人代码或存档全文保存进回放日志，先设计保留与清理规则。

评估需包括热重载重复注册、窄屏布局、取消等待与多个插件的事件链交互。先确认面板没有改变原行为，再考虑改写功能，降低调试时难以归因的问题。

小结

Mods 把观察、交互与行为扩展接到事件链上；状态生命周期、接口版本和权限边界需要一起设计。

参考来源

相关笔记