Git AI 项目追踪 wyb587285-dot/git-ai-tracker

🛰️ git-ai-tracker · Git AI 星级项目追踪

一个 零依赖（仅需 Node.js ≥ 18）的本地插件/工具：持续追踪 GitHub 上以下六大方向最火、效果最好的开源项目，按「热度 + 增速 + 活跃度 + 社区」计算 1~5 星评分，并提供增速榜、Markdown 报告和网页仪表盘。

| 方向 | id | 内置搜索词 |
| 🤖 AI Agent 智能体 | agent | topic:ai-agents、ai agent framework |
| 📚 RAG 检索增强 | rag | topic:rag、retrieval augmented generation |
| 📄 文档解析 | docparse | topic:document-parsing、topic:pdf、topic:ocr |
| 🧩 多智能体协作 | multiagent | topic:multi-agent、multi-agent framework |
| 🕸️ 知识图谱 | kg | topic:knowledge-graph、knowledge graph llm |
| 🕷️ 网页爬取 | crawler | topic:web-crawler、topic:web-scraping |

内置 27 个保底观察名单（langchain、autogen、dify、ragflow、MinerU、docling、MetaGPT、graphrag、LightRAG、crawl4ai、firecrawl……），即使搜索相关性有偏差也能保证明星项目入榜。

界面与简介
- 浅色高对比主题（默认），右上角 🌙/☀️ 一键切换深色模式（记忆偏好）
- 内容区全宽布局，大字号、强对比，表格可读性优先
- 所有项目简介均为中文：知名项目使用手工中文词典（src/i18n.js），新项目按主语言 + 话题词典自动生成中文兜底简介

快速开始

node bin/git-ai-tracker.js doctor # 体检：Node 版本/网络/限额/数据
node bin/git-ai-tracker.js track # 首次追踪（未认证约 1.5~2 分钟）
node bin/git-ai-tracker.js dashboard --open # 生成并打开网页仪表盘
npm run serve # 或启动实时仪表盘 http://127.0.0.1:3210

也可以 npm link（Windows 下 npm link 需管理员）后全局使用 git-ai-tracker 命令。

⭐ 增速、新星徽章、趋势曲线需要至少两天的快照才会出现——第一天只有热度榜，从第二天起自动解锁。

命令一览

| 命令 | 说明 |
| track | 拉取 GitHub 数据生成当日快照。参数：--category agent,rag 只跑指定类；--min-stars 1000 门槛；--quick 跳过观察名单 |
| list | 终端查看最新榜单。--category / --sort stars\|growth\|week\|month\|score\|updated（week=近7天窗口日均增速，month=近30天窗口日均增速）/ --limit 30 |
| report | 生成 Markdown 报告到 reports/report-日期.md（--stdout 直接打印，--demo 用演示数据） |
| dashboard | 生成单文件仪表盘 reports/dashboard.html（离线可用，--open 自动打开） |
| serve | 本地实时服务：GET / 仪表盘、GET /api/data 数据、POST /api/refresh 触发追踪；--demo 用演示数据预览；页面上有一键追踪 + 10 分钟自动刷新开关 |
| history owner/repo | 查看某项目的每日星数快照曲线 |
| add owner/repo --category agent | 加入观察名单（--category 可多选逗号分隔） |
| remove owner/repo | 移出观察名单 |
| doctor | 体检：Node / 网络 / GitHub 限额 / 数据状态 |

星级评分模型

评分(0~100) = 热度0.26 + 增速0.26 + 动量0.12 + 活跃度0.20 + 社区0.10 + 声量0.06 （有历史数据时）
评分(0~100) = 其余分量按占比折算 （首次追踪，无增速数据时）

热度 = log10(★+1)/6 × 年龄衰减 （100 万星封顶；>1 年每多 1 年 -12%，下限 55%——防止老项目靠存量霸榜）增速 = 日均涨星/100 （与上一个快照的真实差值，日均 100 星封顶）另计算「近7天窗口日均（周均）」与「近30天窗口日均（月均）」，用于排序与展示动量 = 相对增速 = 日均涨星 ÷ (星数/1000 × 10 星/天的体量基准) 活跃度 = 7 天内有推送=满分，线性衰减至 180 天归零社区 = log10(fork+1)/4 （1 万 fork 封顶）声量 = 互联网热度：Hacker News 声量(0.6) + 微信公众号文章量(0.4)，尽力而为、失败按 0 分

星级: ≥85 → 5★ · ≥70 → 4★ · ≥55 → 3★ · ≥40 → 2★ · 其余 1★ 徽章: 🚀 新星（创建≤1年且日均≥5星）· 🌲 常青（≥30k★）· 🆕 本次新上榜

增速完全来自本地每日快照的真实差值，不是估算——所以坚持每天跑一次 track，数据越攒越准。
声量与动量两个分量共同保证「正在被大家讨论、涨星快的项目」优先于「老项目吃存量」。

数据与配置

data/snapshots/2026-02-07.json 每天一个快照（同日重跑覆盖当天文件） reports/report-.md Markdown 报告 reports/dashboard.html 单文件仪表盘 config/categories.json （可选）覆盖内置 6 大类的名称/搜索词/门槛 config/watchlist.json （可选）覆盖内置保底观察名单 token.txt （可选）GitHub Personal Access Token，已被 .gitignore

GitHub Token（强烈建议配置）：在 GitHub → Settings → Developer settings → Personal access tokens 生成一个不勾选任何权限的 token（公开数据只读），然后任选其一：

- 项目根目录创建 token.txt，把 token 粘贴进去（已 gitignore，不会提交）；
- 或设置环境变量 set GITHUB_TOKEN=ghp_xxx。

| | search | core |
| 未认证 | 10 次/分钟 | 60 次/小时 |
| 带 token | 30 次/分钟 | 5000 次/小时 |

一次完整 track ≈ 12 次 search + ~27 次 core（观察名单有跨类别缓存去重）。

每天自动追踪（已配置）

本机已注册 Windows 计划任务 git-ai-tracker-daily：每天 08:30 自动运行 track 并把日志写入 data/track.log。

查看 / 手动运行 / 删除 schtasks /query /tn git-ai-tracker-daily /fo list schtasks /run /tn git-ai-tracker-daily schtasks /delete /tn git-ai-tracker-daily /f

重建（注意替换为你的项目路径）
schtasks /create /tn "git-ai-tracker-daily" /tr "cmd /c cd /d E:\work\git星级项目追踪 && node bin\git-ai-tracker.js track >> data\track.log 2>&1" /sc daily /st 08:30 /f

计划任务为「仅当前用户登录时运行」模式；如需开机后台自动跑（不登录也运行），把任务改为 SYSTEM 账户或在任务计划程序中调整。

其他平台 crontab：

30 8 * * cd /path/to/git-ai-tracker && node bin/git-ai-tracker.js track >> track.log 2>&1

常见问题

- 第一次跑为什么没有增速/趋势？ 增速需要两天快照对比，第二天就有了。
- 搜索被限流（HTTP 403/429）？ 未认证 search 限额 10 次/分钟，工具已自动节流+退避；配置 token 后即可解除。
- 公司内网/代理环境？ Node 24+ 可设置 NODE_USE_ENV_PROXY=1 并配置 HTTPS_PROXY 环境变量。
- 想改追踪方向/搜索词？ 拷贝 src/defaults.js 里的结构，创建 config/categories.json 覆盖即可。

目录结构

bin/git-ai-tracker.js CLI 入口 src/cli.js 命令分发 src/track.js 追踪编排（搜索+观察名单+过滤+评分+存快照） src/github.js GitHub API 客户端（节流/限流退避/重试） src/score.js 星级评分模型 src/store.js 快照存储与历史读取 src/render.js 终端表格 + Markdown 报告 src/dashboard.js 仪表盘生成器 src/dashboard/template.html 仪表盘模板（内嵌 CSS/JS，零 CDN） src/serve.js 本地实时服务 src/fixture.js 演示数据（--demo 预览用） src/dsh/ DSH 插件半身（inject/apply + 五工具定义） scripts/smoke-dsh.mjs 插件冒烟测试

🔌 DeepSeek Harness 插件

本项目同时是一个 DSH 插件包（package.json 内含 dsh.bundle 清单 + 根目录 cordis.patch.yml）。装进 DeepSeek Harness 后，Agent 在对话里可以直接调用五个工具，无需敲命令行：

| 工具 | 说明 |
| git_ai_status | 数据状态：快照天数、最新快照、入榜项目数（只读本地，不联网） |
| git_ai_list | 最新榜单：category / sort（score\|stars\|growth\|updated）/ limit |
| git_ai_report | 生成 Markdown 报告（写入 reports/，返回全文；demo 用演示数据） |
| git_ai_dashboard | 生成单文件网页仪表盘（离线可用；demo 用演示数据） |
| git_ai_track | 拉取 GitHub 数据生成今日快照（联网 + 写盘，默认走宿主审批门） |

安装（DSH web profile）：

dsh plugin --profile web add wyb587285-dot/git-ai-tracker # 从 GitHub 安装
或发布 npm 后：dsh plugin --profile web add git-ai-tracker

配置（可选，在你的 profile cordis.patch.yml 中按 id 覆盖整个 config）：

- id: git-ai-tracker
name: 'git-ai-tracker'
config:
writeApproval: false # 关闭 git_ai_track 执行前审批（默认 true，自行承担风险）插件入口在 src/dsh/（inject: ['tools'] + apply(ctx, config)），冒烟测试：node scripts/smoke-dsh.mjs。CLI 用法与插件互不影响。