浏览器插件 - kimi 历史会话清理助手

背景

kimi 是一个国内的 AI 工具，平时用的比较多。

但是，历史会话只能一个一个删除，没有批量删除的功能。

通过抓包分析感觉不复杂，顺便用 trae 试试能不能写一个 chrome 插件。

需求如下：

插件仅在 kimi 官方页面有效
能一键清除所有历史记录
能清除自定义时间范围内的会话记录

实现

项目目录结构如下：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


├── 128.png
├── background.js
├── content.js       // 核心的处理逻辑
├── icons            // 项目使用到的 icon
│   ├── 128.png
│   ├── 16.png
│   ├── 32.png
│   └── 48.png
├── manifest.json   // 项目配置
├── popup.html      // 使用插件时弹出的配置页面代码
└── popup.js        // 配置页面对应的 js 代码

其中的manifest.json是必需的，是整个项目的配置文件，其他文件名随意，配置文件如下：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23


{
    "manifest_version": 3,
    "name": "kimi 历史会话清理助手",
    "version": "1.0.0",
    "description": "一键清理 Kimi AI 的历史会话记录。",
    "icons": {
        "16": "icons/16.png",
        "32": "icons/32.png",
        "48": "icons/48.png",
        "128": "icons/128.png"
    },
    "permissions": ["activeTab", "tabs", "cookies"],
    "host_permissions": ["https://kimi.ai/*", "https://kimi.moonshot.cn/*"],
    "action": {
        "default_popup": "popup.html"
    },
    "content_scripts": [
        {
            "matches": ["https://kimi.ai/*", "https://kimi.moonshot.cn/*"],
            "js": ["content.js"]
        }
    ]
}

配置文件解释参考： https://developer.chrome.com/docs/webstore/prepare?hl=zh-cn

本插件入口文件为popup.html，对应的是点击插件时弹出的配置界面。

2025-03-30-22-03-i9JCAL

其中用户点击清理历史会话按钮后执行的核心代码如下：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23


// 检查是否在对应的页面
if (!isValidKimiTab(tab)) {
  showStatus("请在 Kimi 的历史会话页面使用此插件", "error");
  return;
}

// 获取用户配置的参数
const { startTime, endTime } = getTimeRange();
const domain = new URL(tab.url).hostname;
const cookies = await chrome.cookies.getAll({ domain });

// 通过 chrome.tabs.sendMessage 把对应的参数传给 content.js
const response = await chrome.tabs.sendMessage(tab.id, {
  action: "clearAllHistory",
  domain,
  cookies,
  timeRange: { startTime, endTime },
});

// 等待处理结果
if (response && !response.success) {
  throw new Error(response.error || "未知错误");
}

content_scripts配置项中的含义是：

只有在 https://kimi.ai 或者 https://kimi.moonshot.cn开头的 url 页面中，才执行核心代码，这里对应的是content.js。

其中的核心代码如下：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72


// 通过 chrome.runtime.onMessage.addListener 监听来自 popup 的消息
chrome.runtime.onMessage.addListener(async (message, sender, sendResponse) => {
  if (message.action === "clearAllHistory") {
    try {
      const headers = {
        "Content-Type": "application/json",
      };

      // 如果有 cookies，添加认证信息
      if (message.cookies && message.cookies.length > 0) {
        const authToken = message.cookies.find((c) => c.name === "kimi-auth");
        if (!authToken) {
          throw new Error("未找到认证信息，请确保已登录");
        }
        headers["Authorization"] = `Bearer ${authToken.value}`;
        headers["Cookie"] = message.cookies
          .map((c) => `${c.name}=${c.value}`)
          .join("; ");
      }

      // 循环获取所有历史记录
      let allItems = [];
      let offset = 0;
      const pageSize = 50;

      while (true) {
        const response = await fetch(
          `https://${message.domain}/api/chat/list`,
          {
            method: "POST",
            headers: headers,
            body: JSON.stringify({
              kimiplus_id: "",
              offset: offset,
              q: "",
              size: pageSize,
            }),
          },
        );

        const data = await response.json();

        if (
          !data.items ||
          !Array.isArray(data.items) ||
          data.items.length === 0
        ) {
          break;
        }

        allItems = allItems.concat(data.items);
        offset += pageSize;

        // 添加适当的延迟，避免请求过于频繁
        await new Promise((resolve) => setTimeout(resolve, 500));
      }

      // 执行删除操作
      await deleteHistoryItems(
        message.domain,
        headers,
        allItems,
        message.timeRange,
      );
      sendResponse({ success: true });
    } catch (error) {
      console.error("发生错误：", error);
      sendResponse({ success: false, error: error.message });
    }
  }
  return true;
});