快速开始

前置条件

CLI 使用 Bun，并通过本地 GitHub CLI 发起经过身份验证的 GraphQL 请求。安装项目依赖，并使用最小权限令牌，使其令牌可见的仓库与 Pull Request 访问范围符合本次扫描意图。不要把真实 token 写入被跟踪的文件或命令记录。

扫描令牌可见输入

选定 login 与时间窗口，检查用户确认信息，然后运行 scan。--yes 或 -y 会跳过确认，只应在已经审查过的批处理或 CI 场景中使用。

源码没有仅公开可见性过滤。扫描前检查令牌权限，并把全部生成输出视为可能敏感的数据。

bun devhunt scan LOGIN --token "$GITHUB_TOKEN" --window year

生成本地报告

扫描输出存在后，运行 report。可选的 --tz 值会影响本地时间活动计算。

bun devhunt report LOGIN --tz Asia/Shanghai

准备导读

先检查生成的 profile 和 AI 导读中的数据边界，再运行 narrate。

bun devhunt narrate LOGIN --lang zh --style professional

固定源码树的根目录没有 dev.sh 或 build.sh 启动脚本。不要使用这些过时说明。