{"id":16804660,"url":"https://github.com/yanglbme/v2ex-action","last_synced_at":"2025-08-10T11:31:19.206Z","repository":{"id":45395177,"uuid":"257579882","full_name":"yanglbme/v2ex-action","owner":"yanglbme","description":"🔝 V2EX GitHub Action | 自动发送 V2EX 热门内容到企业微信、钉钉等，可自定义发送周期","archived":false,"fork":false,"pushed_at":"2024-03-19T01:03:16.000Z","size":446,"stargazers_count":40,"open_issues_count":0,"forks_count":10,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-12-01T12:48:06.808Z","etag":null,"topics":["actions","bot","python3","spider","v2ex"],"latest_commit_sha":null,"homepage":"https://github.com/marketplace/actions/v2ex-action","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yanglbme.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2020-04-21T11:55:05.000Z","updated_at":"2024-05-16T08:51:31.000Z","dependencies_parsed_at":"2024-06-21T02:12:05.666Z","dependency_job_id":"8425d1fb-0d01-4659-ab60-029f7720c82c","html_url":"https://github.com/yanglbme/v2ex-action","commit_stats":{"total_commits":38,"total_committers":3,"mean_commits":"12.666666666666666","dds":"0.13157894736842102","last_synced_commit":"7e3f2bbaaa9387a2869adffd4b81f9e27fb97f5c"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yanglbme%2Fv2ex-action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yanglbme%2Fv2ex-action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yanglbme%2Fv2ex-action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yanglbme%2Fv2ex-action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yanglbme","download_url":"https://codeload.github.com/yanglbme/v2ex-action/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":229404258,"owners_count":18067680,"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":["actions","bot","python3","spider","v2ex"],"created_at":"2024-10-13T09:45:40.965Z","updated_at":"2024-12-12T15:16:36.370Z","avatar_url":"https://github.com/yanglbme.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/yanglbme/v2ex-action\"\u003e\n    \u003cimg src=\"./images/logo.png\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eV2EX Action\u003c/h1\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n[![v2ex status](https://github.com/yanglbme/reading/workflows/V2ex/badge.svg)](https://github.com/yanglbme/v2ex-action/actions) [![release](https://img.shields.io/github/v/release/yanglbme/v2ex-action.svg)](../../releases) [![license](https://badgen.net/github/license/yanglbme/v2ex-action)](./LICENSE) [![PRs Welcome](https://badgen.net/badge/PRs/welcome/green)](../../pulls)\n\n\u003c/div\u003e\n\n自动将 [V 站](https://v2ex.com)热门发送到指定的 webhook 地址，如企业微信群机器人。可配置 workflow 的触发条件为 `schedule`，实现周期性定时发送热门内容。欢迎 Star ⭐ 关注本项目。\n\nV2EX Action 支持钉钉机器人、企业微信机器人、飞书机器人三种 webhook。\n\n## 入参\n\n| 参数      | 描述         | 是否必传 | 默认值 |\n| --------- | ------------ | -------- | ------ |\n| `webhook` | Webhook 地址 | 是       | -      |\n| `secret`  | 签名密钥     | 否       | ''     |\n| `count`   | 帖子数量     | 否       | 8      |\n\n若是钉钉，务必**提供签名密钥**，企业微信则无须提供，飞书则可提供亦可不提供。\n\n![](./images/dingding_secret.png)\n\n## 完整示例\n\n在你的任意一个 GitHub 仓库 `.github/workflows/` 文件夹下创建一个 .yml 文件，如 `v2ex.yml`，内容如下：\n\n```yml\nname: V2ex\n\non:\n  schedule:\n    # 可自定义 cron 表达式\n    - cron: \"0 2 * * *\"\n\njobs:\n  build:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: yanglbme/v2ex-action@main\n        with:\n          webhook: ${{ secrets.WEBHOOK }}\n          secret: ${{ secrets.SECRET }}\n          count: 6\n```\n\n注意：\n\n- cron 是 UTC 时间，使用时请将北京时间转换为 UTC 进行配置。由于 GitHub Actions 的限制，如果将 cron 设置为 `* * * * *`，则实际的执行频率为每 5 分钟执行一次。\n\n  ```bash\n  ┌───────────── 分钟 (0 - 59)\n  │ ┌───────────── 小时 (0 - 23)\n  │ │ ┌───────────── 日 (1 - 31)\n  │ │ │ ┌───────────── 月 (1 - 12 或 JAN-DEC)\n  │ │ │ │ ┌───────────── 星期 (0 - 6 或 SUN-SAT)\n  │ │ │ │ │\n  │ │ │ │ │\n  │ │ │ │ │\n  * * * * *\n  ```\n\n- 请在项目的 `Settings -\u003e Secrets` 路径下配置好 `WEBHOOK` 与 `SECRET`(仅钉钉机器人要配置)，不要直接在 `.yml` 文件中暴露地址跟密钥。\n\n  ![](./images/config.png)\n\n## 效果\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\" style=\"width: 400px;\"\u003e\n      \u003ca href=\"https://ding-doc.dingtalk.com/doc#/serverapi3/iydd5h\"\u003e\n        \u003cimg src=\"./images/dingding_res.png\" style=\"width: 360px;\"\u003e\u003cbr\u003e\n        \u003csub\u003e钉钉\u003c/sub\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\" style=\"width: 400px;\"\u003e\n      \u003ca href=\"https://work.weixin.qq.com/api/doc/90000/90136/91770\"\u003e\n        \u003cimg src=\"./images/qyweixin_res.png\" style=\"width: 360px;\"\u003e\u003cbr\u003e\n        \u003csub\u003e企业微信\u003c/sub\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\" style=\"width: 400px;\"\u003e\n      \u003ca href=\"https://open.feishu.cn/document/ukTMukTMukTM/ucTM5YjL3ETO24yNxkjN?lang=zh-CN\"\u003e\n        \u003cimg src=\"./images/feishu_res.png\" style=\"width: 360px;\"\u003e\u003cbr\u003e\n        \u003csub\u003e飞书\u003c/sub\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## 联系我\n\n对于 Gitee Pages Action 有任何的疑问，还可以通过以下方式找到我。\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\" style=\"width: 260px;\"\u003e\n      \u003cimg src=\"https://cdn-doocs.oss-cn-shenzhen.aliyuncs.com/gh/doocs/images/qrcode-for-doocs.png\" style=\"width: 400px;\"\u003e\u003cbr\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\" style=\"width: 260px;\"\u003e\n      \u003cimg src=\"https://cdn-doocs.oss-cn-shenzhen.aliyuncs.com/gh/doocs/images/qrcode-for-yanglbme.png\" style=\"width: 400px;\"\u003e\u003cbr\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## 许可证\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyanglbme%2Fv2ex-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyanglbme%2Fv2ex-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyanglbme%2Fv2ex-action/lists"}