优先使用@types获取第三方库类型，无则通过声明文件或JSDoc手动添加，结合tsconfig.json的checkJs可在JS项目中实现类型提示与检查。
在使用 JavaScript（尤其是结合 TypeScript）开发项目时，为第三方库添加注解主要是为了获得更好的类型提示、代码补全和编译时检查。由于很多第三方库本身不提供类型定义，或你使用的是纯 JS 项目但希望享受类似 TS 的智能提示，就需要手动处理这些注解问题。
1. 使用 DefinitelyTyped 提供的类型声明
大多数流行的 JavaScript 库都有对应的类型定义文件，托管在 DefinitelyTyped 项目中，通过 @types/ 前缀的 npm 包发布。
例如，你想为 lodash 添加类型支持：
- 安装类型包：npm install --save-dev @types/lodash
- TypeScript 会自动识别并应用这些类型
- 在 .ts 或 .tsx 文件中导入 lodash 时，编辑器就会显示完整类型提示
常见例子：
npm install --save-dev @types/jquerynpm install --save-dev @types/react
npm install --save-dev @types/node
2. 为无类型定义的库创建本地声明文件
如果某个第三方库没有 @types/xxx 包，你可以自己创建类型声明文件。
步骤如下：
- 在项目中新建一个 types/ 目录或直接创建 global.d.ts
- 声明模块，例如你引入了一个叫 my-lib 的全局变量库
在 global.d.ts 中写入：
declare module 'my-lib' {
export function doSomething(): void;
export const version: string;
}
TypeScript 编译器会据此理解这个模块的结构，提供类型检查和提示。
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
3. 使用 JSDoc 在纯 JS 项目中添加类型注解
即使你不使用 TypeScript，也可以在纯 JavaScript 项目中通过 JSDoc 注释来标注类型，现代编辑器（如 VSCode）能识别这些注解。
示例：
/**
* @param {string} name - 用户名
* @param {number} id - 用户 ID
* @returns {object} 用户对象
*/
function createUser(name, id) {
return { name, id };
}
当你调用这个函数时，VSCode 就会显示参数提示和返回类型。
你还可以为第三方库变量添加类型：
/** @type {import('lodash')} */
const _ = require('lodash');
这样就能让编辑器为 _ 提供完整的 lodash 类型提示。
4. 配置 tsconfig.json 支持 JS 类型检查
在纯 JS 项目中启用类型检查，需在 tsconfig.json 中开启：
{
"compilerOptions": {
"checkJs": true,
"allowJs": true,
"noEmit": true
},
"include": ["src"]
}
开启 checkJs 后，TypeScript 会在编辑器中对 .js 文件进行类型检查，结合 JSDoc 可实现接近 TS 的开发体验。
基本上就这些方法。根据项目是否使用 TypeScript，选择对应策略即可。多数情况优先查 @types，没有就手写声明或用 JSDoc 补充。不复杂但容易忽略细节。
