logicrw/awesome-jev-projects · 上手攻略
- 仓库：logicrw/awesome-jev-projects
- 链接：https://github.com/logicrw/awesome-jev-projects
- 分类：Jev · 生态系统 · 源码验证型项目雷达
- 作者：Tom
- 更新：2026-09-23
是什么
logicrw/awesome-jev-projects 是 Jev 生态的源码验证型项目雷达，由个人维护（logicrw），主打「每条收录都连到 commit-pinned 源码里的具体决策点」。与纯引用型列表不同，它要求项目必须附上指向「Jev 实际被调用」的代码行，而非仅靠 README 描述自称用了 Jev。
该仓库同时提供：① GitHub 原生 README 浏览；② Live Radar 网页（带 sticky search + floating popover filter）；③ Agent Skill（可 npx skills add 安装到 Codex/Claude Code 等 agent 客户端）；④ llms.txt 全文供 LLM 阅读。⚠️ 注意：项目提交只接受 GitHub Issue（不接受 PR），有 Issue 模板；站点有多语言版（EN/简体中文/日语/韩语），但中文版可能比英文版更新滞后。
解决什么问题
Jev 相关的 awesome 列表最大的问题是收录门槛太低：只要 README 里提到 Jev 就能进列表，但没有人验证代码里是否真的调用了 Jev API。结果是列表越来越长，但真正「可复现的、在 commit 里可见的」案例淹没在 hype 里。
logicrw/awesome-jev-projects 的核心解决思路是把「说了什么」替换成「代码里写了什么」：每条收录必须链接到一个 commit-pinned 的源文件里的具体决策点（typed question → typed answer → accept/reject/escalate），而不是一个首页介绍页。这让开发者可以：① 直接点进去看代码，② 验证这个项目是不是真的在跑 Jev 而非自称。
⚠️ 注意：即使有源码验证，仓库也不核代码质量、测试是否通过、license 是否允许你的使用场景——「源码验证」只验证「Jev 被调用了」，不验证「调用得对/好/安全」。
快速安装
纯文档型仓库，但提供了一个 agent skill 可供安装：
# 安装 agent skill（在支持 npx skills 的环境，如 Codex、Claude Code）
npx skills add logicrw/awesome-jev-projects
# 或通过 URL 安装
npx skills add https://logicrw.github.io/awesome-jev-projects/
# 查看完整 llms.txt（供 LLM 阅读的整理版）
open https://logicrw.github.io/awesome-jev-projects/llms-full.txt
# 克隆本地浏览（非必需）
git clone https://github.com/logicrw/awesome-jev-projects.git
cd awesome-jev-projects
⚠️ npx skills add 是实验性功能，需确认你的 agent 客户端支持此安装协议（TypeSafe 官方文档标注为「Install the agent skill」入口，但具体兼容性未在 README 明确说明）。
核心用法
1. 用 Live Radar 搜索和过滤
访问 https://awesome-jev-projects.logicrw.org/en/ 或 https://logicrw.github.io/awesome-jev-projects/en/：
- Sticky Search：滚动时搜索框始终可见，随时输入关键词过滤。
- Floating Popover Filter：工具栏 popover 可按标签和分类实时过滤，不打断滚动。
- 17 个技术分类（按实现类型而非应用域）：Browser & OS Action（39）/ CLI & Pipelines（34）/ Classification（2）/ Code Navigation（13）/ Context GC（31）/ Creative Tools（16）/ Data & Search（33）/ Decision Tools（18）/ Domain Tools（41）/ Evaluation & Observability（29）/ High-Frequency / Games（41）/ MCP & Integrations（32）/ Model Routing（40）/ SDK & Decision Frameworks（97）/ SDK Integrations（6）/ Security & Guardrails（45）/ Voice & Conversation（4）。
⚠️ 注意：分类维度和 yibie/awesome-jev（按应用域：路由/评分/护栏等）完全不同，本仓库按技术实现类型分类，同一个 Jev 用途可能因技术栈不同而归入不同分类。
2. 理解 System 1（Jev）vs System 2（推理 LLMs）的架构定位
README 提供了清晰的架构对比，理解这个背景才能看懂收录逻辑：
| 维度 | System 2（推理 LLMs） | System 1（Jev） |
|---|---|---|
| 延迟 | 1,500ms–5,000ms+ | 50ms–100ms |
| 输出 | 非结构化文本/脆弱 JSON 正则 | 原生 typed Choice/Score/Noul |
| Token 成本 | $1.00–$15.00/1M tokens | 极低（不足 1 美分/千次） |
| 上下文漂移 | 易幻觉、注意力衰减 | 确定性有限状态机 |
| 主要场景 | 高级规划、开放生成 | 工具路由、动作派发、安全门禁 |
⚠️ 延迟和成本数字来自 README 标注，未在 README 内附原始引用；Noul 这个类型名在 TypeSafe AI 官方文档（https://typesafe.ai/blog/introducing-system-one-models-and-jev）里存在，但在 Jev 官方文档中通常描述为 Choice/Score/Boolean 三种，本仓库 README 额外列了 Noul 类型，实际 TypeSafe API 是否支持需进一步核实。
3. 用 Agent Skill 在终端查项目
# 安装后在 agent 对话里调用
npx skills add logicrw/awesome-jev-projects
# agent 可通过 skill 查询：
# - 按技术域找项目（如"browser automation"）
# - 查看 commit-pinned 源码证据
# - 获取具体 Jev 决策点的代码片段
⚠️ agent skill 的具体调用协议和 prompt 格式未在 README 说明，skill.md 文件在仓库里但路径未确认（/skill.md 或 /docs/skill.md），可能需 clone 后查看。
4. 提交项目
只接受 GitHub Issue，不接受 PR：
- 访问 https://github.com/logicrw/awesome-jev-projects/issues/new?template=project.yml
- 填写 Issue 模板（包含 repo URL）
- 维护者审核后收录
⚠️ 提交时需提供 Jev 被调用的源码 commit-pinned 链接，不能只给 README——这比其他 awesome 列表门槛高，hype-only 项目会被直接过滤。
典型适用场景
- 需要源码级验证的高置信度项目：当你找到感兴趣的项目后，可以直接点进 commit-pinned 源码文件，看 Jev 决策点的具体实现，不是只看 README 描述。
- 找特定技术栈的 Jev 集成：17 个技术分类按实现类型组织（如 MCP & Integrations、SDK & Decision Frameworks），适合按技术栈垂直搜索，而非按应用域。
- 给 coding agent 配 Jev 生态知识：安装 agent skill 后，agent 可以直接查询项目列表和源码证据，减少 agent「编造 Jev 用法」的幻觉风险。
- 对比 System 1 vs System 2 的选型决策：README 提供了清晰的架构对比，适合在架构评审时引用。
坑与注意
- 只验「Jev 被调用」，不验「调用正确」：源码验证只证明「有 Jev API 调用」，不证明逻辑对、安全、测试通过，采纳前必须自己读代码。
- Noul 类型存疑：README 列出
Noul作为 Jev 原生类型之一，但 TypeSafe 官方博客和常见文档只描述Choice/Score/Boolean三种，Noul可能是特定版本/上下文中的变体或命名，本仓库未附官方文档链接核实。 - Live Radar 可能比英文 README 更新快：多语言版本（中文/日文/韩文）同步时间不确定，建议以英文版为准。
- skill.md 路径未在 README 明确：安装 agent skill 前可能需要 clone 仓库找到 skill.md 的正确路径。
- Issue-only 提交机制：不接受 PR意味着社区无法直接编辑，提交的项目依赖维护者主动审核，响应速度不确定。
- 部分分类条目极少：
Classification仅 2 条、SDK Integrations仅 6 条，说明这类技术场景的 Jev 实践还很少。 - 赞助商部分标注「无paid sponsors yet」但接受 founding partner slots：如果看到付费置顶项目不要意外（README 声明不影响收录公平性）。
- 条目按技术类型分类，和 yibie/awesome-jev 完全不同维度：同一个项目可能在两个列表里都出现但归类不同，搜索时建议两个列表都看看。
与同类对比
| logicrw/awesome-jev-projects | yibie/awesome-jev | AppitStudio/awesome-jev | |
|---|---|---|---|
| 定位 | 源码验证型生态雷达 | 场景索引（引用即收） | 教学包（带可跑示例） |
| 条目数 | 521+ | 340+ | 未公布（少而精） |
| 验证方式 | ✅ commit-pinned 源码 | ❌ 引用即收 | 含 mock 可跑示例 |
| 分类维度 | 技术实现类型（17类） | 应用域（14类） | 应用域（14类） |
| 搜索界面 | Live Radar + skill | GitHub 文件浏览 | GitHub 文件浏览 |
| Agent skill | ✅ 有 | ❌ 无 | ✅ 有 |
| 收录门槛 | 最高（需源码证据） | 最低（引用即收） | 中 |
| 多语言 | EN/ZH/JP/KR | 仅 EN | 仅 EN |
| 维护者 | logicrw（个人） | yibie（个人） | AppitStudio（公司） |
核心差异：如果你需要最高置信度、确保「这个项目真的在用 Jev」且有代码可查，选 logicrw 版；如果你需要找思路和场景，选 yibie 版；如果你是第一次上手想跑一个可运行的例子，选 AppitStudio 版。
一句话结论
logicrw/awesome-jev-projects 是 Jev 生态里门槛最高的精选列表——521+ 个项目全部附有 commit-pinned 源码证据，适合需要「看到代码再信」的开发者和 coding agent；缺点是只验证「Jev 被调用了」不验证「调用正确」，且部分领域（Classification 仅 2 条、Voice 仅 4 条）案例极度匮乏，high-frequency/games（41 条）和 security/guardrails（45 条）最成熟。