Skip to content
NEVSTOP-LABPublic

About

The /profile/README.md will appear on the nevstop-lab organization's profile.

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Latest commit

 

History

644 Commits

Folders and files

Repository files navigation

NEVSTOP-LAB/.github

本仓库是 NEVSTOP-LAB 组织的 .github 默认仓库,集中维护:

  • 组织主页(profile/README.md,即访问 https://github.com/NEVSTOP-LAB 时展示的内容)
  • 组织级 GitHub Discussions 问答机器人(CSM Q&A Bot)及其调研文档
  • 跨仓库的自动化运维 workflow(同步、统计、排行等)

📑 目录结构

路径 说明
profile/README.md 组织 Profile 页面:定位、徽章、社区入口与加入方式
csm-framework.md 组织主页的详细内容:框架组成、DSH 工具链、VIPM 下载量、模块与 topic 统计
.github/workflows/ 本仓库运行的所有 GitHub Actions workflow,详见下文
scripts/ workflow 调用的 Python 脚本(discussion bot、统计脚本等)
tests/ discussion bot 的 pytest 单元测试
csm-wiki/wiki_source.json CSM-Wiki 远程仓库地址,bot RAG 检索的知识源
requirements-bot.txt discussion bot 的 Python 依赖清单
webhook/ Cloudflare Worker 实时触发组织级 Discussion 回答的中继代码
docs/workflows/ 各 workflow 的详细维护文档(运维、排错、密钥说明)
docs/调研/ csm_qa RAG 问答 SDK 的技术调研报告

顶层的 Group-*.md、Star-History.md、csm-framework.md 等文件由 csm-framework.md 或组织主页引用,其中被自动化 workflow 覆盖的区块请勿手工编辑。

🤖 自动化 Workflow 概览

下表汇总了本仓库当前运行的 5 个 workflow,详细维护说明请点击对应文档链接。

Workflow 文件 功能简介 触发条件 运行频率
Org Discussion Router org-router.yml 组织级 Discussion 的 LLM 意图分类与分派:JOIN 做加入条件检测并发邀请,QA 用 RAG 回答,OTHER 友好引导 discussion / discussion_comment 事件、repository_dispatch(Worker 中继 org_msg_router)、workflow_dispatch(分类 + dry-run) 事件驱动(实时)+ 手动
CSM Q&A Discussion Bot csm-discussion-bot.yml 组织级 Q&A 的全量扫描与回滚通道,实时问答由 Org Discussion Router 接管 workflow_dispatch(手动全量扫描,可 dry-run)、repository_dispatch(旧 org_discussion_created,仅回滚) 手动 / 回滚
Update Profile Docs update-profile-readme.yml 串行刷新四类自动区块(写入 csm-framework.md 与 Star-History.md):VIPM 下载量、Topics 聚合、CSM Modsets、Star History 定时 + workflow_dispatch 每天 00:00(北京时间,UTC 16:00)
Sync GitHub to Gitee sync-to-gitee.yml 将 NEVSTOP-LAB 组织下的所有仓库(含 releases、wiki)同步到 Gitee 镜像 定时 + workflow_dispatch 每天 02:00(北京时间)
Org Membership Cleanup org-membership-cleanup.yml 检查组织成员活跃度,14 天无贡献者逐级降级(CSM-Developer 豁免)直至移出组织 定时 + workflow_dispatch 每天 09:00(北京时间),当前禁用

Warning

Org Membership Cleanup 目前在 Actions 中处于手动禁用状态(disabled_manually),每日定时不会运行,需要时在 Actions 页面启用该 workflow。

Note

组织成员活跃度管理说明

  • Developer 永久保留:达到 CSM-Developer 级别的成员不受活跃度检查影响。
  • 逐级调整:每次调整一级 —— CSM-Module-Author → CSM-Community → 离开组织。在最后一步离开组织前,会检查成员是否还参与其他团队;若有则仅移除 CSM 团队身份、保留组织成员资格。
  • 滑动窗口:14 天从成员的最近一次公开贡献时间起算(而非固定日期)。只要持续参与,窗口会自动跟着走,不会被"误伤"。
  • 贡献怎么算:在组织仓库中的代码提交、新建或关闭的 Issue/PR 都计入。任一类型的公开记录即视为活跃。
  • 容错保护:查询服务偶发异常时,本轮跳过该成员不做调整,等待下次重新评估;手动模拟运行不会实际修改任何状态。
  • 成员状态记录在 data/member_check_state.json,每日评估后自动归档。详见 维护文档。

所有“自动更新”类 workflow 在 push 失败时会自动 fetch + rebase origin/main 最多重试 3 次,并使用 secrets.SYNC_GITHUB_TOKEN 进行鉴权与提交。

📚 其他文档简介

文档 简介
profile/README.md NEVSTOP-LAB 组织主页:组织定位、徽章、CSM 框架一句话介绍与详解入口、社区交流、加入方式
csm-framework.md CSM Framework 详解:框架组成、DSH 工具链、VIPM 下载量、可复用模块、topic 统计、AI-Wiki
webhook/README.md Cloudflare Worker 中继的部署与配置说明:把组织级 Discussion 的 webhook 转发为 repository_dispatch,让 bot 实时响应而非等待定时扫描
docs/workflows/README.md Workflow 维护文档索引,按需查阅每个 workflow 的密钥、修改清单、常见故障
docs/调研/README.md csm_qa RAG SDK 整体架构与各方向调研报告(LLM 接入、向量库、Token 优化、费用评估)入口
Star-History.md 由 update-profile-readme.yml 自动维护的组织 star 增长曲线与 Top 10 仓库排行
Group-*.md(CSM Framework · Libraries · Programming Environments · Supplement of Base Functions) 按主题分组列出组织内仓库的索引页(CSM 框架、库、编程环境、基础功能补充等)

🔐 涉及的 Secrets

Secret 用于
SYNC_GITHUB_TOKEN update-profile-readme、sync-to-gitee 与 org-membership-cleanup workflow 的 checkout / push / GitHub API
SYNC_GITEE_TOKEN sync-to-gitee 推送到 Gitee 的鉴权
CSM_QA_GH_TOKEN org-router 与 discussion bot 读写组织级 Q&A discussions(Fine-grained PAT)
LLM_API_KEY org-router 与 discussion bot 调用 LLM(默认 deepseek-chat)所需的 API Key
WEBHOOK_APP_ID / WEBHOOK_APP_PRIVATE_KEY org-router 以 GitHub App 身份发出组织邀请

各 secret 的具体权限要求与轮换说明请见 docs/workflows/ 下对应文档。

About

The /profile/README.md will appear on the nevstop-lab organization's profile.

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages