文档
核心概念
一个目标会被拆成若干能力。对每项能力，规划器给出可复用或可购买的条目，外加一个自建选项；然后在质量、成本和风险三个维度上搜索没有其他方案能胜过的那些方案，并推荐其中一个。本页逐一定义这些概念，并给出真实数字。
条目与类型
条目是任何带有链接、许可证、也可以带价格的可复用内容。每个条目都有一个 kind。（自托管节点把条目称为模块（block），其标识符如 blk_ 开头的 ID 和 /api/blocks 路由沿用这个叫法。）
| 类型 | 含义 |
|---|---|
repo | 代码仓库或库。 |
skill | 智能体技能：由说明文字和脚本组成，智能体按需加载。 |
harness | 智能体 harness：围绕模型搭建的编排、工具和评测。 |
mcp_server | 为智能体提供工具的 Model Context Protocol server。 |
model、dataset | 模型或数据集，例如来自 Hugging Face 的。 |
prompt、template | 仅托管应用有：提示词包和项目起步模板。规划器把它们当作 skill 处理。 |
design | 设计文件，例如作为条目导入的 Figma 文件。 |
paper | 用作蓝本的 arXiv 论文。论文不会被当作可直接使用的条目推荐，只作为自建的依据。 |
build_task | 预留给开发需求。规划器目前还没有用到它。 |
在托管应用上，条目就是一条上架信息，名称为 owner/slug，目录由用户发布或导入的内容构成。在节点上，条目 ID 由 blk_ 加 16 位十六进制字符组成，根据卖家的密钥和条目名称计算得出。条目来自两个地方：卖家发布的条目（运行 seed 时，内置示例也是这样发布的），以及节点用 --online 在线找到的免费条目（GitHub、MCP registry、Hugging Face，以及你配置的 MCP server）。在线找到的条目没有签名，一律免费，并保留自己的 origin。
能力
规划器把你的目标转换成一组能力：用简短标签表示成品必须完成的任务。默认情况下，它拿目标里的词去匹配一份固定的、共 23 项能力的分类，保留最匹配的前八项。英文词按整词匹配；简体中文词按子串匹配，覆盖 23 项能力中的 22 项（ui-design 暂时没有中文词）。使用 --llm 时，则由 Claude 来拆分目标，并且可以使用列表之外的标签。
| 能力 | 匹配的典型词 |
|---|---|
web-frontend | website、frontend、ui、dashboard、landing、react |
backend-api | api、backend、server、rest、endpoint |
auth | login、authentication、signup、oauth、users |
payments | payment、checkout、stripe、billing、subscription |
crypto-payments | bitcoin、usdc、usdt、wallet、blockchain、escrow |
database | database、sql、postgres、storage、persist |
retrieval-rag | rag、retrieval、search、documents、embeddings、vector |
llm-chat | chatbot、assistant、llm、conversational、agent |
web-scraping | scrape、crawl、extract、monitor |
document-parsing | pdf、docx、ocr、invoice、parse |
speech | voice、speech、audio、transcribe、tts |
vision | image、vision、photo、detection、video |
trading | trading、stocks、backtest、portfolio、quant |
data-analysis | analytics、analysis、csv、report、charts |
notifications | email、sms、slack、telegram、alert |
scheduling | schedule、cron、daily、weekly、calendar |
mobile-app | mobile、ios、android、app |
deployment | deploy、hosting、docker、kubernetes、cloud |
testing-eval | test、evaluation、eval、benchmark、qa |
ui-design | figma、mockup、wireframe、prototype、branding |
agent-harness | harness、orchestration、workflow、multi-agent、mcp |
recommendation | recommend、recommender、personalized、ranking |
translation | translate、translation、multilingual、language |
卖家在自己的条目上用同样的标签声明能力。声明了某项需求所要求的能力，比仅靠文字匹配找到的条目更可靠：只要该需求的候选中有条目声明了这项能力，就只考虑声明了的那些。关键词规划器刻意做得很简单。如果目标写得不寻常，请先看输出里的 requirements，再决定是否采信方案。
质量、成本与风险
每个需求下的每个选项都有三个数字。质量和风险在 0 到 1 之间，成本以美元计。
质量，越高越好
质量是条目已有信号的加权平均。缺少的信号会被略去，不会按零计入。没有任何信号的条目得 0.4：低于平均水平，但不会是零。在托管应用上，信号来自上架信息本身：评价、星标（含 GitHub 星标）、下载量、测试通过率、最近更新时间和归档状态；在节点上，则来自条目本身和验证记录。
| 信号 | 权重 | 计分方式 |
|---|---|---|
| 已验证购买的评分 | 2.0 | 托管已放款的买家给出的 1 到 5 分的平均值，并向 3 分收拢，避免一条评价左右结果。 |
tests_pass_rate | 1.5 | 卖家报告的 0 到 1 的数值；若有验证记录，则采用最新一条。 |
stars | 1.0 | 平方根刻度，约 10,000 个 star 得 1 分。 |
downloads | 1.0 | 对数刻度，一百万次下载得 1 分。 |
citations | 0.5 | 线性，200 次引用得 1 分。 |
scorecard | 0.75 | OpenSSF Scorecard 的 0 到 10 分，线性。 |
dependents | 0.5 | 对数刻度，10,000 个依赖方得 1 分。 |
随后有三项扣减，以乘法作用在得分上，所以只会拉低得分，缺少某个信号则没有任何影响。已知漏洞：每个严重或高危公告扣 20%，其他公告每个扣 4%，合计最多扣 50%。对代码类条目（repo、skill、harness、mcp_server），陈旧度会乘以 0.6 加 0.4 倍的新鲜度，其中最近更新在 90 天内新鲜度为 1，之后线性下降，四年时为 0。已归档的条目乘以 0.7。托管应用的目录和节点自带的发现来源目前都不提供 scorecard、dependents 或漏洞数量，只有条目自带这些数据时才会生效。
方案中每个选项的质量还要乘以条目与需求的契合度（文字相关度，以及是否声明了该能力）。卖家提供的信号在有人验证之前只是一面之词，详见信任与验证。
成本，越低越好
成本等于付费条目的价格之和，再加上每个自建步骤的估算。默认的自建估算是每个缺失部分 8.00 美元的智能体 token 花费。这是对你自己智能体开销的估计，不是 ReuseForge 收取的费用。
风险，越低越好
风险把各项明确的成因累加起来，上限为 1：
| 成因 | 增加的风险 |
|---|---|
许可证为 UNKNOWN 或未声明 | 0.4 |
| 来自网络、尚无已验证购买的条目 | 0.2 |
| 有 arXiv 蓝本的自建步骤 | 0.5（合计） |
| 没找到蓝本的自建步骤 | 0.7（合计） |
| 每个严重或高危漏洞 | 0.2，最多 0.5 |
| 每个其他已知公告 | 0.03，最多 0.15 |
| 已归档 | 0.25 |
| 代码类条目长期未更新 | 90 天内为 0，四年时升到 0.2 |
| 安全评分（0 到 10） | 低于 5 分时每低 1 分加 0.04，最多 0.2；高于 7.5 分时最多减 0.1 |
| 被依赖数 | 到 10,000 时最多减 0.1 |
总和限制在 0 到 1 之间。从漏洞这一行往下，只有条目带有相应信号时才会生效。
Pareto 方案
一个方案为每项需求选定一个选项。它的质量和风险是各步骤的平均值，成本是总和。当方案 A 在三个维度上都不比方案 B 差，并且至少有一个维度严格更好时，称 A 支配 B。Pareto 前沿就是预算内所有不被任何其他方案支配的方案。规划器对此做精确搜索，而不是抽样，并从前沿中最多返回 12 个方案。
命令行只打印推荐方案。完整的前沿是节点上 POST /api/plan 返回的 JSON 里的 pareto_front 字段，托管应用的规划器则把它画成图。前沿上的每个方案都是一次真实的取舍，所以你可以自己决定愿意为质量付多少钱。推荐方案取“质量减去 0.15 倍风险”最大者；若并列，则选更便宜的。
下面是目标 RAG chatbot over my PDF invoices with a dashboard and crypto checkout 在不设预算时的前沿，只使用内置的示例数据（python -m repoblock seed）。换成别的条目，数字会不同。
| 方案 | 质量 | 成本 | 风险 | 做法 |
|---|---|---|---|---|
| A 推荐 | 0.936 | $52.00 | 0.200 | 购买三个 DEMO 条目：RAG harness（$25）、结账套件（$15）、起步 UI（$12）。解析器用免费的。 |
| B | 0.919 | $27.00 | 0.200 | 购买结账套件和起步 UI。RAG 框架和解析器用免费的。 |
| C | 0.839 | $23.00 | 0.283 | 购买结账套件（$15），自建 UI（$8）。 |
| D | 0.800 | $20.00 | 0.283 | 购买起步 UI（$12）。支付用免费的 Stripe 库，加密支付自建（$8）。 |
| E | 0.720 | $16.00 | 0.367 | 全部用免费条目，外加两次自建（$16）。 |
预算设为 16 时，只有方案 E 放得下。设为 10 时，没有任何方案可行，规划器会提示 No plan fits the budget. Raise the budget or drop a requirement.（预算内没有可行方案，请提高预算或删去一项需求）。它从不会悄悄超出预算。
共用条目只付一次钱
一个条目可以同时满足多项需求。在上表里，结账套件同时声明了 payments 和 crypto-payments。方案 B 两项都用它，只付一次 15 美元，所以总成本是 15 + 12 = 27 美元，而不是 42 美元。托管订单（测试模式）里每个付费条目只列一次，购物清单里也只显示一次。
依论文自建
每项需求还会多一个自建选项，这让方案能适应较小的预算，也能覆盖没人出售的东西。使用 --online 时，每个自建步骤会带上最多两篇 arXiv 论文作为蓝本；不使用时没有蓝本，该步骤的质量得分更低、风险更高。该步骤按自建估算计价。ReuseForge 内部不向任何人付款，这是你自己智能体要做的工作。
python -m repoblock brief "voice assistant that sends telegram alerts" --budget 30 --onlinebrief 会输出一份给编码智能体的文档，其中列出：已经覆盖的部分（直接集成，不要重写）；必须自建的部分及其蓝本链接和大致预算；值得配给智能体的 MCP server；以及规则，即交付时附带测试、记录所用一切内容的许可证，并把完成的成果作为条目发布回来。最后一条规则会让下一位买家的方案更便宜。ReuseForge 负责写 brief，执行自建则由你的智能体完成。
术语表
| 术语 | 含义 |
|---|---|
| 条目（item） | 带有链接、许可证、价格和信号的可复用内容。自托管节点中称为模块（block）。 |
| 目标 | 你想最终得到什么，用普通文字描述。 |
| 方案（plan） | 为每项需求选定一个选项，并给出质量、成本和风险。 |
| 托管（escrow） | 由中立方保管款项，直到买家验收或验收期结束。目前只有测试模式，没有真实资金流动。 |
| 托管方、仲裁方 | 确认存款并裁决争议的一方。在自托管节点上就是节点运营者。 |
| 出资人（backer） | 为众筹项目出资并获得收益份额的人。目前只有测试模式。 |
| 份额（unit） | 众筹项目 1,000,000 份收益份额中的一份。 |
| 账本（ledger） | 每个节点都保存的签名、哈希相连的日志。见信任与验证。 |
最近更新: