文档中心

向量数据库VikingDB

请输入

资源导入与同步

上传飞书项目

概述

OpenViking 支持通过 add-resource 命令导入飞书项目，并将空间、需求、缺陷等内容导出、解析、切片、索引后写入指定数据库。

支持的导入范围

OpenViking 支持导入飞书项目中的以下信息：

项目空间：支持以空间为对象，导入其关联的工作项
工作项：包含需求、缺陷两种类型，支持基本信息、节点详情、缺陷管理、评论备注等字段导入

上传方式

本地文件支持控制台上传，CLI上传，API上传三种方式。

控制台上传

打开OpenViking首页，点击输入栏右侧“+”，“数据源同步”中选择“飞书项目”。

填入鉴权参数（参数获取可见获取鉴权参数），勾选授权须知，完成授权。

填入飞书项目链接，选择目标目录，点击“导入”，即可上传。

CLI上传

示例如下，具体命令与参数详见 add-resource-添加资源。

ov add-resource "https://project.feishu.cn" \
  --add-type feishu_project \
  --to "viking://resources" \
  --reason "sync feishu project" \
  --args '{
    "stream": "feishu_project_issues",
    "project_keys": ["viking_db"],
    "auth_config": {
      "plugin_id": "p",
      "plugin_secret": "x",
      "user_key": "u"
    }
  }'

API上传

示例如下，具体命令与参数详见 add_resource-导入资源。

curl -X POST "https://api.vikingdb.cn-beijing.volces.com/openviking" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer xxxxxxxxxxxxxxx" \
  -d '{
  "path": "https://project.feishu.cn/",
  "add_type": "feishu_project",
  "to": "viking://resources/",
  "create_parent": true,
  "reason": "sync feishu project",
  "args": {
    "stream": "feishu_project_issues",                                
    "project_keys": ["viking_db"],
    "auth_config": {"plugin_id": "p", "plugin_secret": "s", "user_key": "u" }
  }
}'

获取鉴权参数

首先需要在飞书项目开放市场创建一个插件

需要为插件授予所有【获取】权限

点击插件发布，创建版本并发布

在准备上传的Project空间中，安装刚刚创建的插件，仅管理员可操作

获取Plugin ID, Plugin Secret

获取User ID：hover左下角头像，鼠标点击用户名，自动复制用户ID（需复制插件创建人的用户ID）。

最近更新时间：2026.09.16 20:18:44

这个页面对您有帮助吗？

有用

无用

向量数据库VikingDB

控制台上传 #

CLI上传 #

API上传 #

控制台上传

CLI上传

API上传