> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kontext.so/llms.txt
> Use this file to discover all available pages before exploring further.

# JavaScript SDK

> 一个轻量的 JavaScript SDK，可在任意 Web 应用中接入 Kontext 广告。

<Card title="JavaScript Demo" icon="github" href="https://github.com/kontextso/sdk-js-demo">
  看看用我们轻量的 SDK 接入高性能广告有多简单。
</Card>

## 环境要求

* 一个现代浏览器环境（SDK 不绑定任何框架——在静态页面、自定义聊天 UI 或任意 SPA 中都能使用）。

<Note>
  你需要一个 [发布方账号](/publishers#getting-started-is-easy) 来获取 `publisherToken` 与 placement code。
</Note>

<CardGroup cols={2}>
  <Card title="安装" icon="download" href="/sdk/js/installation">
    通过 npm 安装，或从 CDN 加载。
  </Card>

  <Card title="展示第一个广告" icon="rocket" href="/sdk/js/first-ad">
    创建会话、喂入消息、挂载广告——五分钟完成接入。
  </Card>

  <Card title="API 参考" icon="book" href="/sdk/js/api">
    `createSession`、`Session`、`Ad`，以及完整事件列表。
  </Card>

  <Card title="实践指南" icon="signs-post" href="/sdk/js/guides">
    no-fill、切换 character、会话恢复等常见模式。
  </Card>

  <Card title="示例应用" icon="github" href="/sdk/js/example">
    使用你自己的 publisher token 端到端运行 Vite 示例。
  </Card>
</CardGroup>