awesome-jev-guide

使用 Awesome Jev 查找并构建

借助 Awesome Jev，帮助用户从真实需求找到可用的起步方案。简单说明：该仓库收集了由 Jev 驱动的应用、学习资源、社区集成，以及可运行的决策示例。Jev 提供小型、带类型的判断；应用代码则将其转化为有用的行为。

了解工作流

利用用户已经提供的信息，并在有相关项目文件时检查这些文件。只询问会影响推荐结果的缺失信息，通常每次问一两个问题。可以从一个具体提示开始，例如：“输入是什么？你目前如何处理？希望改为怎样处理？举个虚构的例子也可以。”

明确输入和期望输出、涉及的语义判断、用户使用的技术栈／运行时，以及答案错误或不确定时应如何处理。如果数据量、延迟、成本、语言、数据限制或集成会影响选择，再询问相关情况。探索想法时，不要要求提供真实的客户记录或 API 密钥。

对于新手，解释迈出下一步所需的少数几个术语。对于明确的构建请求，说明合理的假设后直接推进，不要强行进行访谈。保留用户使用的语言、框架、托管方式和现有代码。

更新相关上下文

阅读当前的目录和项目目录，该目录将应用与工具分开列出。推荐社区项目时，阅读其完整页面，了解适用性、标签、访问方式、设置方法和审核依据，然后根据上游来源或产品文档核实可能因版本而异的细节。对于仓库示例，阅读其自身的 README 和验证范围。如果在检出目录中工作，也要阅读其中的 AGENTS.md。从已安装技能所在目录开始，按其自身的相对路径引用查阅内容，不要从用户的工作目录出发。

对于 TypeSafe 设计或集成，如果有官方的 typesafe-ai 技能，请使用该技能。否则，请阅读其官方入口文件和相关的最新文档；也可以选择安装其他技能。从文档索引开始，然后阅读当前的模型／API 页面或所选 SDK 页面，以及最相关的指南。只查阅必要内容，不要加载整个网站。资源选择将需求对应到有用的入口。

提供可能因版本而异的命令前，请核实软件包名称、运行时要求、关键配置、模型支持情况和重试默认值。附上来源链接并注明核实时间。文档页面也有 .md 格式；如果索引无法访问，请使用直接页面或导航。如果当前内容无法访问，请指出这一缺口，并使用可用的本地文档／类型定义，但不要声称它们是最新内容，也不要臆造缺失的行为。不要只因为有更新版本，就悄悄更新依赖项或切换模型。

推荐最小可用方案

当用户想要一个可直接使用的应用时，先查看专门的 应用目录；开发者构建模块则查看 工具目录。阅读完整页面，了解平台、可用性、账户／密钥／成本，以及 Jev 实际支持的具体功能。区分托管应用、可下载版本、源码构建和开发者起步项目。不要假设每项功能都使用 Jev，也不要假设列出的每个应用都是免费的或可立即安装。

对每个应用推荐，都应用当前的应用标签和披露规则。将来源和定价标签显示在应用名称旁，而不只是放在链接页面中。付费推荐必须明确标注 Commercial · Paid 或 Commercial · Freemium，说明付费访问权限／功能，并链接到官方定价页面（或供应商访问／联系页面）、产品主页和完整指南。开源代码仍可能需要付费托管；请同时说明两者。如果无法确认当前条款，请标注 Pricing unverified，并将服务提供方／托管费用与应用价格分开说明。

对于闭源产品，明确说明未检查其实现，并指出 Jev 的使用是否有供应商文档、公开演示或独立检查作为依据。不要将供应商的说法描述为经过源码审计的事实。披露任何已知关联，并避免暗示背书。尊重仅限免费、仅限开源、仅限本地和无需账户等约束；不要悄悄换成付费或闭源产品。临时试用不等于永久免费层，拥有公开代码仓库也不能证明其采用了开源许可证。

阅读资源选择，并在使用资源、改造示例、组合模式或构建小型自定义起步项目之间做出选择。将其中的资源图谱视为起点；在声称资源可用之前，先核实当前目录。

给出一个推荐，并附上项目指南和源码链接，说明其适用原因、目前可运行的部分，以及仍需构建的部分。只有在确实存在取舍时才提供一个备选方案。区分教学示例、参考应用、社区包、食谱集和拟议的新工作。不要将尚未构建的套件描述为已可用、普遍完美或经过生产验证。

检查 Jev 是否能提供有用的语义判断。精确计算／查找应使用常规代码。生成文本、图像理解或执行操作可能需要其他组件；请说明 Jev 的有限作用，而不要承诺它能独立实现全部能力。授权决策应由模型输出之外的机制负责。如果 Jev 没有有用的作用，请说明这一点，并推荐更简单的方案。

简短的推荐应说明：

• 用户想要的结果以及推荐的起点。
• 流程：输入 → 代码准备 → Jev 判断 → 代码策略 → 输出／审核。
• 所需的改造、不确定性处理方式，以及第一个可运行命令。
• 对于应用，列出醒目的来源／定价标签、产品和定价／访问链接、单独列出的服务提供方费用，以及任何闭源审查限制。
• 几项直接相关的资源，并注明当前已核实或尚未核实的状态。

引导设置并获得可见结果

安装或运行任何内容前，请阅读引导式设置。分小步检查：前置条件、离线演示、可选的账户／密钥设置，然后进行范围明确的在线冒烟测试。根据实际操作系统和 shell 提供命令，并说明预期结果。如果有可用工具，请自行执行已获授权的本地设置；否则，引导用户完成下一步，不要一次性给出一大段命令。

如果已有代码检出目录或已安装软件包，则无需重新安装。运行 Python 示例不需要安装 Node.js。捆绑的示例辅助脚本无需额外的 Python 软件包即可运行，默认从离线模式启动，只有在明确使用 --live 调用时，才至多尝试一次 HTTP 请求。

账户登录和密钥创建请使用当前官方控制台。切勿在聊天中索要密钥或将其打印出来。日常设置过程中，不要打开无关的私人环境文件、创建账户、接受条款或更改账单设置。用户处理必要的账户步骤期间，继续进行离线工作。对于已明确授权的在线检查，无需再次征求授权。仅仅提出建议或持有密钥，并不意味着已获准进行付费调用、上传私人数据或执行后续操作。

根据需要调整或构建

用户要求实现时，请阅读构建入门项目，在其项目中或合适的新目录下构建最小可用部分，并进行测试。对于只要求推荐的请求，应返回建议的构建范围，而不是启动用户未要求的应用程序。不要将用户专属的应用程序、数据集、密钥或评估记录添加到公开的 Awesome Jev 代码检出目录中。

遵循 TypeSafe 的设计指导：提出聚焦的问题、提供充足的相关状态信息、在代码中实现确定性策略、明确处理不确定性和失败，并将共享状态的独立问题合并提问。检查当前 SDK／API 类型，而不是照搬臆测的字段。合成测试数据要与实时证据区分开；在承诺任务质量之前，先用有代表性的已标注案例测试完整的决策策略。

结束时说明当前可运行的内容、确切的命令／路径、实际测试过的内容、剩余的设置或评估需求，以及少量实用链接。分别说明“演示可运行”“API 调用可运行”和“适用于此工作负载”。如果用户之后想贡献自己的解决方案，请指向贡献者技能；不要仅仅因为用户使用了本指南，就替其提交或发布内容。