本仓库是 NEVSTOP-LAB 组织的 .github 默认仓库，集中维护：
- 组织主页（
profile/README.md，即访问 https://github.com/NEVSTOP-LAB 时展示的内容） - 组织级 GitHub Discussions 问答机器人（CSM Q&A Bot）及其调研文档
- 跨仓库的自动化运维 workflow（同步、统计、排行等）
| 路径 | 说明 |
|---|---|
profile/README.md |
组织 Profile 页面，展示项目矩阵、社区入口、AI-Wiki 等 |
.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等文件由profile/README.md间接引用或由自动化 workflow 维护，请勿手工编辑被自动覆盖的部分。
下表汇总了本仓库当前运行的 5 个 workflow，详细维护说明请点击对应文档链接。
| Workflow | 文件 | 功能简介 | 触发条件 | 运行频率 |
|---|---|---|---|---|
| CSM Q&A Discussion Bot | csm-discussion-bot.yml |
基于 RAG + LLM 自动回复组织级 Discussion 中 Q&A 分类下的提问与追问 | discussion / discussion_comment 事件、repository_dispatch（来自 Cloudflare Worker 实时中继）、workflow_dispatch（手动全量扫描，可 dry-run） |
事件驱动（实时） + 手动 |
| Sync GitHub to Gitee | sync-to-gitee.yml |
将 NEVSTOP-LAB 组织下的所有仓库（含 releases、wiki）同步到 Gitee 镜像 | 定时 + workflow_dispatch |
每天 02:00（北京时间） |
| Update Sorted Tags | update-sorted-tags.yml |
拉取组织所有仓库 topic 信息，按标签聚合后写回 profile/README.md |
定时 + workflow_dispatch |
每周日 00:00 UTC |
| Update Star History | update-star-history.yml |
统计组织 star 历史与 Top 仓库排行，更新 Star-History.md（含 Mermaid 图表） |
定时 + workflow_dispatch |
每 8 小时一次（00:00 / 08:00 / 16:00 UTC） |
| Update VIPM Downloads | update-vipm-downloads.yml |
抓取 VIPM 包下载量并刷新 profile/README.md 中相关徽章数据 |
定时 + workflow_dispatch |
每天 01:00（北京时间） |
所有“自动更新”类 workflow 在 push 失败时会自动
fetch + rebase origin/main最多重试 3 次，并使用secrets.SYNC_GITHUB_TOKEN进行鉴权与提交。
| 文档 | 简介 |
|---|---|
profile/README.md |
NEVSTOP-LAB 组织主页，介绍 CSM 框架、配套插件、社区入口、AI-Wiki，以及 star/topic 统计表格 |
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-star-history.yml 自动维护的组织 star 增长曲线与 Top 10 仓库排行 |
Group-*.md（CSM Framework · Libraries · Programming Environments · Supplement of Base Functions） |
按主题分组列出组织内仓库的索引页（CSM 框架、库、编程环境、基础功能补充等） |
| Secret | 用于 |
|---|---|
SYNC_GITHUB_TOKEN |
update-* 与 sync-to-gitee workflow 的 checkout / push / GitHub API |
SYNC_GITEE_TOKEN |
sync-to-gitee 推送到 Gitee 的鉴权 |
CSM_QA_GH_TOKEN |
discussion bot 读写组织级 Q&A discussions（Fine-grained PAT） |
LLM_API_KEY |
discussion bot 调用 LLM（默认 deepseek-chat）所需的 API Key |
各 secret 的具体权限要求与轮换说明请见 docs/workflows/ 下对应文档。