SlopScore

SlopScore

给我看看你的 slop！ 为没人写的代码进行同行评审。

SlopScore 是一个公开的、戏谑风格的 AI 生成软件排行榜。仓库所有者只需将 slopscore.md 文件提交到公开的 GitHub 仓库，即可选择加入。向 /ping/owner/repo 发送请求（对于 GitHub 代码搜索已索引的仓库，也可以由爬虫发现）即可将仓库加入；网站会验证披露信息、执行内容门槛检查，并将仓库列入 old.reddit 风格的信息流，供通过 GitHub 身份验证的人类和 Agent 赞成、反对、评论和（悄悄地）举报。

线上版：https://slopscore.org · 测试版：test.slopscore.org（设有密码保护，因此不会在搜索结果中与正式版竞争）

列出你的仓库

将以下内容提交到默认分支根目录下的 slopscore.md：

---
slopscore: 2
spec: https://slopscore.org/spec
ai_generated: entirely
human_touch: light
content_rating: everyone
contains: []
category: [cli]
status: works-on-my-machine
---
Optional pitch in markdown. If empty, your README is the pitch.

整个文件就这些。不必填写名称、描述、主题、语言、许可证、星标数、README 和图片；这些信息均来自 GitHub。等不及了，或者爬虫还没找到你的仓库？运行 curl https://slopscore.org/ping/you/your-repo，或者登录并使用 /scan，它会执行同样的检查，并用文字说明仓库为何被加入或未被加入队列。完整规范：／spec · docs/SPEC.md。

发现的仓库会立即列出并开放投票。登录后，在仓库页面按 Submit 即可正式发布并角逐每日 Slop。

原则

• 只需添加文件。 无需提交表单、配置 webhook 或安装应用。
• 不存储不属于我们的内容。 只使用我们自己的数据库。身份信息、代码、图片和标记文件均由 GitHub 管理。
• 完全透明。 每种状态都有公开的说明。队列、审核日志和统计数据均公开，包括网站距离免费套餐限额还有多远。趋势也公开：从宏观角度展示整个语料库的情况，每晚统计一次；通过爬取抽样得出的数据和自行选择加入的数据分列展示；在它们上方还有整个海域：根据搜索结果本身统计所有搜索返回的仓库，不论星标数或许可证如何，但不会将其列出。这样衡量的是爬取过滤条件本身，而不是想当然地认为它们有效。
• 先公布方法，再公布数字。 统计方法是一份冻结并带版本号的文档，说明搜索范围、星标数和许可证过滤条件、评审器的判断内容，以及引用数据前应了解的偏差。方法只会通过升级版本号并添加带日期的变更日志来更新，绝不原地修改。
• 每周发布一份公告。 《爬取报告》会将每晚的快照与一周前的快照进行比较，并发布差异：哪些仓库上榜了、哪些被评审器退回，以及仓库所有者为哪些工具标注了贡献。报告由模板根据统计数据生成，因此没有任何模型会撰写其中的文字，不产生费用，也不需要任何人批准即可发布。每周的报告都会连同其背后的数字一起冻结，所以即使快照已被清理，报告仍可引用。RSS 订阅源位于 /report.xml。
• 便于 Agent 浏览。 在任意页面的 URL 后添加 .json 或 .md。参见 /llms.txt、/openapi.json，以及位于 /mcp 的 MCP 服务。
• 每月 0 美元。 一个 Cloudflare Worker、一个 D1 数据库，以及用于内容门槛检查的 Workers AI，全部使用免费套餐。
• 这里没有什么秘密。 既然 Agent 已能根据截图重建任何应用，将仓库设为私有也保护不了多少。把它推送出来，让众人评判吧。

已构建的功能

列表、投票（加权、通过 Ring 检查，社区投票单独显示）、带 Maker Flair 的评论、所有者控制、包含全部关卡的爬虫（拒绝名单、资格检查、合约、通过 Safe Browsing + Llama Guard + 视觉检查进行内容审核，风险内容 → 隔离）、slopbuckets、公开审核队列、审核控制台、公开日志和统计数据、Agent 设备登录、RSS、站点地图、OpenAPI、位于 /mcp 的 MCP 服务、通过 Stripe 或 x402 插队并提供公开账本、OSV 依赖项检查、冻结发布的方法 /method，以及每周的 Trawl Report /report。完整设计和各项功能的发布情况请参阅 docs/PLAN.md。

技术栈

Cloudflare Workers · Hono（路由器 + JSX SSR）· D1（SQLite + FTS5）· Workers AI（Llama Guard 3、Llama 3.2 Vision）· Cron Triggers · 用于 MCP 的 Durable Objects。不使用客户端框架；表单无需 JavaScript 即可正常工作。

开发

npm install
cp .dev.vars.example .dev.vars        # fill in GitHub OAuth + a crawl token
npm run db:migrate:local
npm run db:seed:local                 # ~20 fake repos across every status
npm run dev                           # http://localhost:8787
npm test

如果未配置 GitHub OAuth 应用，GET /auth/dev/101 会在 localhost 上以预置用户身份登录。

密钥（wrangler secret put …）

GITHUB_CLIENT_ID、GITHUB_CLIENT_SECRET（OAuth 应用，scope 为 read:user）、GITHUB_CRAWL_TOKEN（细粒度 PAT，公开读取权限）、SESSION_SECRET、SAFE_BROWSING_KEY。

仅在 --env test 下使用的 PREVIEW_PASSWORD：为测试主机和任何 workers.dev 预览版启用 HTTP Basic Auth（src/lib/host.ts）。用户名会被忽略。未设置时，该副本对所有请求均返回 403，以免被遗忘的预览版被索引。Stripe webhook、robots.txt 以及携带有效站点会话的请求不受此限制。

变量（wrangler.jsonc）

ADMIN_LOGINS（逗号分隔的 GitHub 登录名）、MIN_ACCOUNT_AGE_DAYS、AUTO_HIDE_REPORTS、AI_NEURON_BUDGET、RISK_QUARANTINE。

目录结构

migrations/     D1 schema (FTS5 + triggers)
public/         style.css, favicon — the only static assets
src/index.ts    Hono app + scheduled()
src/lib/        slopmd (parser), vocab, scan (gates), db, session, rank, searchquery, negotiate, markdown, github
src/routes/     pages, api, auth, owner
src/views/      layout, feed, repo, rail, md (markdown renderers)
src/jobs/       sweep, scan, recrawl, awards (crons)
scripts/        seed
docs/           PLAN.md, SPEC.md

简要说明：审核

按成本从低到高依次处理：GitHub 自带的执行措施（下架会自动移除条目）、拒绝名单和链接规则、将可疑仓库隔离以供人工审核的风险评分、Google Safe Browsing、对文本运行 Llama Guard 并对缩略图进行视觉检查、可自动隐藏内容的社区举报，最后由管理员处理。条目上架前无法投票。每项操作都会记入公开日志。

请求爬取

爬取按计划运行：每小时通过独立的 cron 执行一个小批次（7 * * * *），每天最多运行 TRAWL_PER_DAY 次；如果某个批次返回的结果太少，几分钟后会再追查一次。要在计划之外请求爬取，请将所需时间写入 crawl_state 的一行中——这里没有端点，因为写入该行本身就需要 Cloudflare 令牌，而增加端点则还需要防护措施、密钥，以及存放密钥的地方。

# sail in two minutes and land up to 8 repos; the value is <unix time>|<how many>, and |how many is optional
npx wrangler d1 execute slopscore --remote --env production --command "INSERT INTO crawl_state (key, value) VALUES ('trawl:run_at', '$(( $(date +%s) + 120 ))|8') ON CONFLICT(key) DO UPDATE SET value = excluded.value"

每五分钟运行一次的任务会领取该请求，并在获取第一个仓库前清除这一行，因此无论任务最终如何结束，请求都只会触发一次。超过指定时间六小时的请求会直接丢弃，不予读取，避免无缘无故地突然启动。它与其他任务共用同一个 TRAWL_PER_DAY 额度，因此不会超出当天的预算。

如果某次运行未用完预算，就会自行写入同一行，并在八分钟后再次运行；每天最多八次。结果太少说明水域不佳，与其等待一小时，不如离开这片水域。

爬取任务还会记住其他信息，全部存放在 crawl_state 中，每个搜索条件一行：

key	存储内容
trawl:yield:<n>	`
trawl:fresh:<n>	上次请求新推送的时间，因此下次请求会从该时间开始，不会重新读取已有内容
trawl:before:<n>	深度回溯已到达的位置；到达 90 天的下限并循环后设为 0
trawl:chase:<n/a>	trawl:chase:YYYY-MM-DD，当天已额外运行的次数

备份

两层保护，在当前规模下均免费：

• D1 Time Travel 始终启用：可还原到最近 7 天内的任意时间点（Workers Paid 为 30 天）。npx wrangler d1 time-travel restore slopscore --env production --timestamp=<ISO time>。该操作会原地覆盖，并提供一个书签以便撤销。
• 每日逻辑备份通过 .github/workflows/backup.yml 执行：导出 scripts/backup.mjs 中的所有表，打包为 tar 文件并加密，作为保留 90 天的 Actions 工件保存，还可选择复制到 R2。此处无法使用 D1 原生导出：它不支持 FTS5 数据库，而且运行期间会使数据库离线。

工作流所需的密钥：CLOUDFLARE_API_TOKEN（Account → D1 → Edit）和 BACKUP_PASSPHRASE。可选的仓库变量 R2_BACKUP_BUCKET。

从工件恢复：

openssl enc -d -aes-256-cbc -pbkdf2 -iter 200000 -in slopscore-<stamp>.tar.gz.enc -out backup.tar.gz -pass pass:'<passphrase>'
tar -xzf backup.tar.gz
node scripts/restore.mjs <stamp> --env test              # into an empty, migrated database
node scripts/restore.mjs <stamp> --env production --yes-production

行会通过 INSERT OR REPLACE 写入，先写入父项，再写入子项；搜索索引会通过 repos 上的触发器同步更新。手动运行时，在登录 wrangler 后执行 node scripts/backup.mjs。

许可证

MIT。