与 Eidos 桌面版 API 交互

Eidos 通过其桌面端应用提供了强大的基于 RPC 的 API。配合 Bun 使用 @eidos.space/client，你可以利用其内置的 TypeScript 支持和卓越的性能，快速实现数据采集自动化。

本指南将演示如何使用 Bun 从 Hacker News 获取热门文章并将其导入 Eidos 表格中。示例包含文章内容，以支持语义化搜索功能。

准备工作

Eidos 桌面版: 确保 Eidos 桌面端应用正在运行。
Bun: 确保你的机器上安装了 Bun。

项目初始化

初始化一个新项目并安装 Eidos RPC 客户端：

# 初始化 Bun 项目
mkdir hn-ingestor && cd hn-ingestor
bun init -y

# 安装 Eidos RPC 客户端
bun add @eidos.space/client

示例：Hacker News 数据采集器

创建一个名为 index.ts 的文件并添加以下内容。该脚本将：

使用 createEidosClient 连接到你的 Eidos 桌面版实例。
检查并创建 “Hacker News” 表格。
获取 Hacker News 热门文章，包括文章内容。
更新/插入 (Upsert) 数据：如果文章（通过 HN ID 识别）已存在，则更新其分数；否则创建新记录。

import { createEidosClient } from "@eidos.space/client"

// 你可以在 Eidos 桌面端应用的仪表盘或 URL 中找到 Space ID
const SPACE_ID = "your_space_id"
const EIDOS_PORT = 13127 // Eidos 桌面版默认 RPC 端口

// 1. 初始化 Eidos 客户端
const client = createEidosClient({
  endpoint: `http://${SPACE_ID}.eidos.localhost:${EIDOS_PORT}/rpc`,
})

const space = client.space
const TABLE_NAME = "Hacker News"

// 2. 检查并创建表格
const tables = await space.schema.listTables()
let table = tables.find((t) => t.name === TABLE_NAME)

if (!table) {
  console.log(`正在创建表格 "${TABLE_NAME}"...`)
  table = await space.schema.createTable({
    name: TABLE_NAME,
    fields: [
      { name: "Content", columnName: "content", type: "text" },
      { name: "HN ID", columnName: "hn_id", type: "number" },
      { name: "URL", columnName: "url", type: "url" },
      { name: "HN 链接", columnName: "hn_link", type: "url" },
      { name: "Author", columnName: "author", type: "text" },
      { name: "Score", columnName: "score", type: "number" },
      {
        name: "Type",
        columnName: "type",
        type: "select",
        property: {
          options: [
            { id: "self", name: "self", color: "blue" },
            { id: "link", name: "link", color: "green" },
          ],
        },
      },
    ],
  })
}

const hnTable = space.table(table.id)

// 3. 获取 Hacker News 数据
console.log("正在获取热门文章...")
const topIds = (await fetch(
  "https://hacker-news.firebaseio.com/v0/topstories.json"
).then((res) => res.json())) as string[]

// 处理前 10 篇
for (const id of topIds.slice(0, 10)) {
  const item = (await fetch(
    `https://hacker-news.firebaseio.com/v0/item/${id}.json`
  ).then((res) => res.json())) as {
    type: string
    title: string
    url: string
    text?: string
    by: string
    score: number
  }

  if (item?.type === "story") {
    // 提取内容：自托管文章（Ask HN, Show HN）有 'text' 字段
    // 对于外部链接，内容将为空
    const content = item.text ? item.text.replace(/<[^>]+>/g, "") : ""
    const postType = item.text ? "self" : "link"

    const data = {
      content: content,
      url: item.url,
      hn_link: `https://news.ycombinator.com/item?id=${id}`,
      author: item.by,
      score: item.score,
      type: postType,
    }

    // 4. 导入/更新数据到 Eidos
    // 使用自定义 hn_id 字段检查记录是否存在
    const existing = await hnTable.findFirst({
      where: { hn_id: id },
    })

    if (existing) {
      console.log(`正在更新: ${item.title}`)
      await hnTable.update({
        where: { _id: existing._id },
        data,
      })
    } else {
      console.log(`正在创建: ${item.title}`)
      await hnTable.create({
        data: {
          hn_id: id,
          ...data,
        },
      })
    }
  }
}

console.log("导入完成！")

运行脚本

直接使用 Bun 运行该文件：

bun index.ts

下一步

了解如何对导入的数据使用语义化搜索
探索表格 API 参考获取更多操作
构建自定义脚本扩展实现自动化工作流