当库使用特定的 this 上下文调用用户提供的回调时，该上下文是 API 的一部分。 TypeScript 允许您将其键入为函数的第一个参数，即使它不是真正的参数。这记录并强制执行预期的上下文。

使用小写原始类型，切勿使用大写包装类型。

“泛型黄金法则”规定类型参数应该在函数签名中出现两次或多次。如果类型参数仅出现一次，则它与任何内容无关并且可能是不必要的。不必要的类型参数会产生类型安全的错误感觉，并且可能导致推理不太成功。

JavaScript 对象键始终是字符串，即使对于数组也是如此。

不要从单个示例推断类型。

优先选择 async/await 而不是回调，以获得更清晰的代码和更好的类型流。

将大型 JavaScript 代码库迁移到 TypeScript 并不一定是全有或全无。 allowJs 编译器选项可让您通过在同一项目中混合 .ts 和 .js 文件来逐步采用 TypeScript。这使得增量迁移成为可能，允许团队一次转换一个文件，同时维护工作代码库。

您的 TypeScript 环境包括全局变量、环境变量和特定于平台的 API。使用声明文件 (.d.ts) 为您的环境创建准确的类型定义。这确保了特定于平台的代码和全局变量的类型安全。

检查 marimo 笔记本是否可以在 WebAssembly (WASM) 环境中运行 - marimo 游乐场、社区云或导出的 WASM HTML。

对于一般 marimo 笔记本约定（单元结构、PEP 723 元数据、输出渲染、marimo 检查、变量命名等），请参阅 marimo-notebook 技能。该技能特别侧重于将 Streamlit 概念映射到 marimo 等效项。

marimo 使用 Python 创建笔记本，与使用 JSON 的 Jupyter 不同。这是一个示例笔记本：

Pydantic 是声明批处理作业（尤其是机器学习）的真实来源的好方法。您可以声明如下内容：

添加链接到 marimo 笔记本的“在 molab 中打开”徽章。徽章可以添加到任何目标：GitHub README、文档网站、博客文章、网页或任何其他 Markdown/HTML 文件。

“那些疯狂到认为自己可以改变世界的人，才是真正改变世界的人。”

传统的顺序执行会浪费时间：

Hooks 提供对 Claude 行为的编程控制，无需修改核心代码，从而实现项目特定的自动化、安全检查和工作流程定制。

<quick_start> 使用 AskUserQuestion 工具解决 spec.md 中的歧义：

暂无简介

重大更改会破坏信任并破坏客户端应用程序：

代码重复会造成维护噩梦：