{"id":18267652,"url":"https://github.com/oxeu/larkgithub","last_synced_at":"2025-04-12T01:04:25.648Z","repository":{"id":258098953,"uuid":"871815937","full_name":"OXeu/LarkGithub","owner":"OXeu","description":"Sync Lark sheet data to github issues.","archived":false,"fork":false,"pushed_at":"2024-10-17T04:19:34.000Z","size":4983,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-12T01:04:17.557Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OXeu.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-13T02:42:41.000Z","updated_at":"2024-12-07T08:17:04.000Z","dependencies_parsed_at":"2024-10-18T23:20:10.115Z","dependency_job_id":null,"html_url":"https://github.com/OXeu/LarkGithub","commit_stats":null,"previous_names":["oxeu/larkgithub"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OXeu%2FLarkGithub","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OXeu%2FLarkGithub/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OXeu%2FLarkGithub/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OXeu%2FLarkGithub/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OXeu","download_url":"https://codeload.github.com/OXeu/LarkGithub/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248501861,"owners_count":21114683,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-05T11:28:10.597Z","updated_at":"2025-04-12T01:04:25.630Z","avatar_url":"https://github.com/OXeu.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 飞书多维表格同步至 Github Issue\n本项目可拉取飞书多维表格的数据并同步创建 Github Issue\n\n## 特性\n- [x] 支持创建/更新 Github Issue\n- [x] 支持自定义标题内容模板\n- [x] 支持自定义字段同步至标签\n- [x] 支持自定义筛选条件\n- [x] 支持字段为空时占位内容\n- [x] 支持时间戳转可读的时间日期\n- [x] 支持同步图片/文件\n\n## 使用方法\n\n### 飞书\n创建一个飞书应用，添加以下权限：\n- bitable:app 查看、评论、编辑和管理多维表格\n- contact:user.base:readonly 获取用户基本信息\n\n发布并审核\n\n**在需要同步的多维表格的文档菜单 \u003e 更多 \u003e 添加文档应用 \u003e 搜索“多维表格同步” 添加，否则将会缺少文档读写权限**\n\n为需要同步的多维表格增加一个超链接字段，名称随意（如 Github Issue），但需要将名称填写到 `LARK_GITHUB_BIND_FIELD` 中。\n\n### GitHub\n\n复制 [lark-sync.yaml](./.github/workflows/lark-sync.yaml) 至需要同步的仓库\n\n在仓库 \u003e Settings \u003e Secrets and variables \u003e Action 中点击 New Repository Secret 添加以下 Secrets (逐条添加)\n|Name|示例值|说明|\n|---|---|---|\n|LARK_APP_ID|cli_xxxxxxxxxx|飞书应用的 APP ID|\n|LARK_APP_SECRET|R4ndOmsEcRetR4ndOmsEcRet|飞书应用的 APP Secret|\n|IMG_AUTH_TOKEN|鉴权TOKEN|可选，图片上传鉴权值，通过 Authorization 请求头传递给上传地址|\n\n飞书多维表格的链接通常为以下形式：\n```\nhttps://bingyan.feishu.cn/base/VPe0b11IqALpzZsa8OjcC90qnth?table=tblXgSAuBu3tKMjD\u0026view=vewMnpHsUz\n```\n其中的 `VPe0b11IqALpzZsa8OjcC90qnth` 为多维表格的 token, 保存到下列 `LARK_BITABLE_TOKEN` 中\n`tblXgSAuBu3tKMjD` 为多维表格的某一个表的 id,保存到下列 `LARK_BITABLE_TABLE_ID` 中\n\n\n在仓库 \u003e Settings \u003e Secrets and variables \u003e Action \u003e Variables 中点击 New Repository Variable 添加以下 Variable (逐条添加)\n|Name|示例值|说明|\n|---|---|---|\n|LARK_GITHUB_BIND_FIELD|Github issue|多维表格中用于绑定 Github Issue链接的字段名|\n|LARK_BITABLE_TOKEN|VPe0b11IqALpzZsa8OjcC90qnth|飞书多维表格的 token|\n|LARK_BITABLE_TABLE_ID|tblXgSAuBu3tKMjD|飞书多维表格中所需同步表的 id|\n|LARK_BITABLE_CONDITION_CONJUNCTION|or|多个筛选条件之间的条件关系可填 and 或 or 或不填|\n|LARK_BITABLE_CONDITIONS|需求描述,isNotEmpty;需求详细描述（可附文档）,isNotEmpty|多个筛选条件用 ; 分隔，筛选条件内的多个内容用 , 分割，详见下文|\n|ISSUE_TITLE_FORMAT|{需求描述:未命名}|Issue 标题格式化模板，详见下文|\n|ISSUE_LABEL_FIELDS|优先级,需求分类,需求状态|Issue Label来源字段，多个用 `,` 分隔|\n|ISSUE_CONTENT_FORMAT|同标题格式，详细示例见下文|Issue 内容格式化模板，详见下文|\n|ISSUE_UPDATE|true|是否在多维表格内容更新后同步更新 issue 内容|\n|FORCE_UPDATE|false|可选，强制更新所有 issue,适用于修改了模板格式的情况，更新完成后请将其重置为 false|\n|FORCE_UPDATE_USER|false|可选，是否强制更新由用户创建的 issue。默认只会更新由 bot 创建的 issue|\n|TIME_ZONE|+8|时区，使用整数表示相对于 UTC 的偏移小时数|\n|IMG_URL|https://sm.ms/api/v2/upload|可选，默认为 sm.ms 上传地址|\n|IMG_FILE_FIELD|smfile|可选，文件上传字段|\n\n## 格式化模板\n标题和内容使用模板来提高可自定义程度，以下是其详细规则：\n\n### 插入指定字段内容\n```\n{字段名称}\n```\n\n### 插入时间\u0026日期\n```\n{@日期的字段名}\n```\n\n### 当字段为空时的默认值\n```\n{字段名称:默认值}\n\n时间也可以使用默认值\n{@创建时间:未知时间}\n```\n\n### 特殊插值\n```\n记录创建时间\n{created_at}\n\n记录创建人\n{created_by}\n\n记录更新时间\n{updated_at}\n\n记录更新人\n{updated_by}\n```\n\n### 示例\nIssue 内容\n```\n## 需求描述\n{需求描述:无}\n\n## 详细描述\n {需求详细描述（可附文档）:无}\n\n {现象:}\n\n--- \n于 **{@需求提出日期}** 创建\n```\n效果：\n\n```markdown\n## 需求描述\n菜品信息补充\n\n## 详细描述\n 加入口让用户上传商家/菜品信息，经核实后后台上传\n\n--- \n于 **2024/10/11 16:00** 创建\n```\n## 筛选字段\n详见 https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/record-filter-guide\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foxeu%2Flarkgithub","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foxeu%2Flarkgithub","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foxeu%2Flarkgithub/lists"}