ForcePilot/backend/package/yuxi/channels/adapters/feishu/tools/bitable.py
Kris 69b7139863 refactor(feishu): 清理冗余代码并补全飞书工具集实现
1.  移除多个文件中的空行、冗余导入
2.  修复文件末尾缺少换行符的问题
3.  新增并补全飞书多类工具API实现:
    - 多维表格:更新、删除记录,列出视图
    - 文档:更新、追加、删除块
    - 云文档:上传、下载文件
    - 群组:创建、添加成员、更新信息、创建公告
    - 目录:重构用户部门缓存逻辑
4.  优化消息发送、回复、转发等API的错误处理和逻辑
5.  新增消息列表查询、已读状态查询等功能
2026-05-13 16:07:59 +08:00

250 lines
7.7 KiB
Python

from __future__ import annotations
from typing import Any
from ._validate import validate_params
try:
import lark_oapi
HAS_LARK_SDK = True
except ImportError:
HAS_LARK_SDK = False
lark_oapi = None # type: ignore
@validate_params
async def list_bitable_tables(client: Any, app_token: str) -> list[dict[str, Any]]:
if not HAS_LARK_SDK or not client:
return []
try:
request = lark_oapi.api.bitable.v1.ListAppTableRequest.builder().app_token(app_token).build()
resp = await client.bitable.v1.app_table.list(request)
if not resp.success():
raise RuntimeError(f"获取多维表格列表失败: {resp.msg}")
data = resp.data if hasattr(resp, "data") else {}
items = data.get("items", [])
return [
{
"table_id": item.get("table_id", ""),
"name": item.get("name", ""),
"revision": item.get("revision", 0),
}
for item in items
]
except Exception as e:
raise RuntimeError(f"获取多维表格列表失败: {e}") from e
@validate_params
async def get_bitable_fields(client: Any, app_token: str, table_id: str) -> list[dict[str, Any]]:
if not HAS_LARK_SDK or not client:
return []
try:
request = (
lark_oapi.api.bitable.v1.ListAppTableFieldRequest.builder().app_token(app_token).table_id(table_id).build()
)
resp = await client.bitable.v1.app_table_field.list(request)
if not resp.success():
raise RuntimeError(f"获取字段列表失败: {resp.msg}")
data = resp.data if hasattr(resp, "data") else {}
items = data.get("items", [])
return [
{
"field_id": item.get("field_id", ""),
"field_name": item.get("field_name", ""),
"type": item.get("type", 0),
"property": item.get("property", {}),
"is_primary": item.get("is_primary", False),
}
for item in items
]
except Exception as e:
raise RuntimeError(f"获取字段列表失败: {e}") from e
@validate_params
async def list_bitable_records(
client: Any,
app_token: str,
table_id: str,
page_size: int = 100,
filter_formula: str = "",
) -> list[dict[str, Any]]:
if not HAS_LARK_SDK or not client:
return []
records: list[dict[str, Any]] = []
page_token = ""
try:
while True:
request_builder = (
lark_oapi.api.bitable.v1.ListAppTableRecordRequest.builder()
.app_token(app_token)
.table_id(table_id)
.page_size(page_size)
.page_token(page_token)
)
if filter_formula:
request_builder.filter(filter_formula)
request = request_builder.build()
resp = await client.bitable.v1.app_table_record.list(request)
if not resp.success():
break
data = resp.data if hasattr(resp, "data") else {}
items = data.get("items", [])
for item in items:
records.append(
{
"record_id": item.get("record_id", ""),
"fields": item.get("fields", {}),
"created_time": item.get("created_time", ""),
"last_modified_time": item.get("last_modified_time", ""),
}
)
page_token = data.get("page_token", "")
if not page_token or not items:
break
except Exception as e:
raise RuntimeError(f"获取记录列表失败: {e}") from e
return records
@validate_params
async def create_bitable_record(
client: Any,
app_token: str,
table_id: str,
fields: dict[str, Any],
) -> dict[str, Any]:
if not HAS_LARK_SDK or not client:
raise RuntimeError("SDK 不可用")
try:
request_body = lark_oapi.api.bitable.v1.CreateAppTableRecordRequestBody.builder().fields(fields).build()
request = (
lark_oapi.api.bitable.v1.CreateAppTableRecordRequest.builder()
.app_token(app_token)
.table_id(table_id)
.request_body(request_body)
.build()
)
resp = await client.bitable.v1.app_table_record.create(request)
if not resp.success():
raise RuntimeError(f"创建记录失败: {resp.msg}")
data = resp.data if hasattr(resp, "data") else {}
record = data.get("record", {}) or data
return {
"record_id": record.get("record_id", ""),
"fields": record.get("fields", fields),
}
except Exception as e:
raise RuntimeError(f"创建记录失败: {e}") from e
@validate_params
async def update_bitable_record(
client: Any,
app_token: str,
table_id: str,
record_id: str,
fields: dict[str, Any],
) -> dict[str, Any]:
if not HAS_LARK_SDK or not client:
raise RuntimeError("SDK 不可用")
try:
request_body = lark_oapi.api.bitable.v1.UpdateAppTableRecordRequestBody.builder().fields(fields).build()
request = (
lark_oapi.api.bitable.v1.UpdateAppTableRecordRequest.builder()
.app_token(app_token)
.table_id(table_id)
.record_id(record_id)
.request_body(request_body)
.build()
)
resp = await client.bitable.v1.app_table_record.update(request)
if not resp.success():
raise RuntimeError(f"更新记录失败: {resp.msg}")
data = resp.data if hasattr(resp, "data") else {}
record = data.get("record", {}) or data
return {
"record_id": record.get("record_id", record_id),
"fields": record.get("fields", fields),
}
except Exception as e:
raise RuntimeError(f"更新记录失败: {e}") from e
@validate_params
async def delete_bitable_record(
client: Any,
app_token: str,
table_id: str,
record_id: str,
) -> dict[str, Any]:
if not HAS_LARK_SDK or not client:
raise RuntimeError("SDK 不可用")
try:
request = (
lark_oapi.api.bitable.v1.DeleteAppTableRecordRequest.builder()
.app_token(app_token)
.table_id(table_id)
.record_id(record_id)
.build()
)
resp = await client.bitable.v1.app_table_record.delete(request)
if not resp.success():
raise RuntimeError(f"删除记录失败: {resp.msg}")
return {
"deleted": True,
"record_id": record_id,
"app_token": app_token,
"table_id": table_id,
}
except Exception as e:
raise RuntimeError(f"删除记录失败: {e}") from e
@validate_params
async def list_bitable_views(
client: Any,
app_token: str,
table_id: str,
) -> list[dict[str, Any]]:
if not HAS_LARK_SDK or not client:
return []
try:
request = (
lark_oapi.api.bitable.v1.ListAppTableViewRequest.builder().app_token(app_token).table_id(table_id).build()
)
resp = await client.bitable.v1.app_table_view.list(request)
if not resp.success():
raise RuntimeError(f"获取视图列表失败: {resp.msg}")
data = resp.data if hasattr(resp, "data") else {}
items = data.get("items", [])
return [
{
"view_id": item.get("view_id", ""),
"view_name": item.get("view_name", ""),
"view_type": item.get("view_type", ""),
}
for item in items
]
except Exception as e:
raise RuntimeError(f"获取视图列表失败: {e}") from e