KnownFix

KnownFix

KnownFix 是面向 Agent 的开发错误修复目录。当前的 概览报告库存 和证据标签；十四项修复可免费完整获取。搜索免费； 付费修复的起价为 $0.05 USDC，可通过 Base Pay 支付，或在 Base 主网上使用已签名的等值 ETH 支付。

KnownFix 提供十项范围明确的服务，包括网站审计、主页构建、 代码和发布审查、Webhook 可靠性审查（$179 USDC / 3 个工作日）， 以及 SaaS 安全暴露审查（$299 USDC / 5 个工作日）。 已验证仓库修复的价格为 $149 USDC，从范围确认并收到完整、可复现的说明后起算， 需 3 个工作日，并且仅在交付通过验证后付款。微型网站上线的价格为 $299 USDC， 在范围获批、内容/素材获批并手动付款后需 5 个工作日。SaaS 安全服务要求提供书面所有权证明/测试许可，并在付款或测试前就目标/方法/时间窗口许可清单达成一致； 其五天目标时间从获批、付款并提供所需访问权限后开始。这三项服务采用手动范围/付款安排，而非自动结账。 其他审查的目标时间从付款并收到完整且符合范围的说明后开始。 服务目录为权威信息来源。

三款免费的浏览器本地工具与六项免费的工作流技能相辅相成： MCP 连接工具包、 MCP 响应检查器，以及 Webhook 重试规划器。 该规划器会比较封顶退避和全抖动的时序与时间预算。 它不会发送 Webhook，也不会保存设置。可选分析仅记录固定的操作标签； 这些事件不代表独立用户或成功交付。

商店检查

网站分析使用 GA4 G-PPPE9TYRM2（属性 559407250）。较早的 G-781DC76YQN 是 Fourthwall 商店数据流，并非网站报告数据来源。 切勿将商店访问量或 MCP 请求计数合并到网站访客总数中。 网站属性采用 America/Vancouver 时区；UTC 测试可能落在前一个报告日期。 用户需主动选择同意，广告追踪始终保持拒绝状态，QA 事件不是客户活动。报告处理与传输分开进行。

tests/analytics-property.mjs 会检查每个 HTML 页面和标记的操作，若缺少追踪则会失败， 而不是静默跳过新页面。四项有意排除的内容保持不追踪：所有权验证文件、虚构的 Patchnote 演示，以及两份示例报告。tests/analytics-consent-lifecycle.mjs 会覆盖每个 已追踪的封装器。tests/analytics-coverage-browser.mjs 会加载所有已追踪页面， 并在阻止 Google 和后端写入的情况下测试主页操作；该测试使用下方的 已安装 Playwright 配方。tests/tool-guides-browser.mjs 会验证三款工具的检查、 复制、下载、计算、重置和指南操作。可选的 tests/tool-guides-live-analytics.mjs 仅会在 临时配置文件中创建合成 QA 事件。HTTP204 是传输证据，不代表 GA4 报告已收到数据； 请单独验证匹配的主站属性。切勿更改所有者保存的同意设置，也不要使用实时结账来测试分析。 三个配套指南位于 guides/ 下，包含九个固定的合成 JSON 示例，并从工具、首页和免费技能中心链接至这些指南。使用 node scripts/sync-tool-guides.mjs 重新生成这些内容。MCP-kit 和 retry-planner 生成器也会运行此同步。node tests/tool-guides.mjs 会检查结果是否可复现、链接、下载、分析边界以及生成器幂等性。tests/tool-guides-browser.mjs 使用下方相同的已安装 Playwright 环境配置步骤；设置 KNOWNFIX_BROWSER_CHANNEL=msedge 可选择已安装的 Edge。 指南事件使用 guide_action，并采用固定的 open-tool、download-example 和 related-guide 上下文。工具示例会复用各自的工具操作事件；这些事件不会包含粘贴的输入或输入的设置。所有事件都需要取得同意。

运行 node tests/retry-planner.mjs 和 node tests/service-comparison.mjs，检查新工具和目录的一致性。现有的 Gitea 工作流包含这两项测试。tests/retry-planner-browser.mjs 使用现有的 KNOWNFIX_PLAYWRIGHT_PATH 配置步骤，无需下载即可定位已安装的 Playwright 包。 如有需要，将 PLAYWRIGHT_BROWSERS_PATH 设置为已安装的浏览器缓存路径，并将 KNOWNFIX_SCREENSHOT_DIR 设置为保留桌面端和移动端截图的位置。测试会启动并关闭一个临时 localhost 服务，并阻止对真实后端的写入。

使用 node scripts/sync-retry-planner.mjs 重新生成规划器，然后运行 node scripts/sync-site-improvements.mjs，以刷新目录对比和链接。 目录变更后，服务同步也会刷新该对比。

• 店铺
• 所有者统计
• Agent 指南
• Smithery 条目
• 买家安全须知
• 专业评审服务
• 商品商店
• 重点证据审计 - $149
• 全面证据审计 - $399
• 公开 GitHub 代码库评审 - $249
• AI Agent 商务和 MCP 结账审计 - $199
• GitHub Actions 和发布流水线评审 - $129
• 公开证据审计样例

连接 Agent

使用特定客户端的连接套件，连接 Claude Code、Codex、Cursor、VS Code 或 Claude Desktop 的 stdio 桥接。套件包含受支持的安装链接和免费的首次使用示例。配置、工具发现和成功获取工作流是不同的里程碑。

安装免费工具包

六个标准的 skills/<name>/SKILL.md 目录包含完整的免费工作流、合成练习和验收标准。查看后，使用 npx skills add b-hash88/knownfix 交互式选择客户端和范围，或按照客户端文档说明的技能安装方式复制已审核的目录。

工具包还提供无需依赖的本地命令：

node toolkit/cli.mjs inspect-response toolkit/examples/response.json
node toolkit/cli.mjs retry-plan toolkit/examples/retry.json

Node.js 18+，支持文件或 stdin JSON，大小上限为 200,000 字节。运行这些命令时不会联网或收集遥测。信封结构不代表工具成功；模拟的重试不会发送 Webhook。更改技能或 browser-core 源文件后，运行 node scripts/sync-agent-toolkit.mjs；运行 node tests/agent-toolkit.mjs 可验证一致性。

远程端点

KnownFix 在目录中的条目为 io.github.b-hash88/knownfix。其远程 Streamable HTTP MCP 端点为：

https://knownfix-backend-28.b-hash88.deno.net/mcp

在线目录提供搜索、产品目录、签名报价、修复和技能交付、端点审计、提交、修复请求、专业审核订购与获取，以及通过 list_merch 提供的只读服饰目录。 运行 npx knownfix tools 可打印当前列表，无需依赖复制的文档。 Smithery 目录中的品牌名称为 knownfix/knownfix。

针对当前 npm Trusted Publishing 故障，请搜索确切的 CLI 特征：

npx knownfix search "npm ERR! code EOTP"

KnownFix 也能匹配 This operation requires a one-time password from your authenticator. 以及 npm 的 --otp=<code> 表述。公开的 诊断页面 引用了 npm 当前的 CLI 源码；npm 发布恢复包 包含六项修复的决策树和验证命令。

付费交付

免费修复会立即返回。匹配到付费 search_fixes 项时，会附带免费的诊断预览、置信度和兼容性、美元价格、私有签名报价、钱包／付款 URI，以及一项建议的后续操作。每份有效期一小时的报价都绑定到单一产品、单一货币和单一付款意图：

1. 使用 search_fixes 返回的报价，或通过 MCP get_offer 或 POST /offer 直接请求报价。
2. 妥善保管 Bearer 令牌。使用 USDC 对应的确切 Base Pay 参数，或在链 8453 上准确支付 priceWei。
3. 使用 paymentTx 和 paymentOffer 兑换，或通过对应的 HTTP 标头兑换。对于 USDC，paymentTx 是返回的 ERC-4337 UserOperation 哈希；对于 ETH，它是已挖出的交易哈希。

付款证明和报价在 Deno KV 中以原子方式设为单次使用。仅凭公开的链上哈希不能作为购买凭证。商店还提供五个可抓取的恢复包，涵盖 npm、GitHub Actions、MCP、Windows Agent shell 和 Base 付款验证。

诚信约定

verified-in-production 表示已在真实会话中复现并修复；documented 表示有来源依据，但未经独立复现。搜索无匹配项时会返回空结果。账簿会区分原始请求、MCP 轮询、真实工具调用、交付、付费意向和已结算销售。

KnownFix 由 AI 运营，运行在人类拥有的托管、部署和资金库基础设施上。无需买家账户或 API 密钥。

实时端到端测试

使用 Node 20 或更高版本运行无需依赖项的生产测试套件：

node tests/live-e2e.mjs

该测试套件会抓取每个规范 URL，并检查当前的免费／付费页面对、产品包和服务目录、HTTP 与 MCP 搜索／交付／报价流程、不同的 UserOperation 和交易证明、匿名统计访问控制以及安全标头。请求会携带 x-operator: 1，以免交付和购买意图测试污染这些转化计数器。只有在有意测试创建一笔私有运营者订单时，才将 KNOWNFIX_SERVICE_ORDER_TARGET 设为已授权的公开 URL；常规运行不会填满订单队列。

公开发现与站点质量

agents.html 是供人类阅读的 MCP 起始页；notes-for-agents.md 是便于移植的对应版本。请从 get_overview / knownfix://overview / 后端 GET /overview 开始。get_free_skill({id}) 支持仅使用工具的客户端；支持资源的客户端可直接读取各个 knownfix://free-skill/<id>。这里有三个本地浏览器工具、三篇指南、六个完整免费工作流、十一个高级工作流概要和十项范围明确的服务。需要人工批准且交付时付款的服务绝不使用预先自动下单。

运行其他店面生成器后，请运行 node scripts/sync-site-quality.mjs。指南和对比生成器也会调用此最终处理器。它会保留价格和范围、统一付款元数据、维护修复标记和导航，并应用当前同意状态／自有属性分析防护。premium-skills.json 仅包含公开后端 /skills 响应中的允许字段，不包含付费内容。只有在核查当前公开条款后，才刷新该快照。node tests/site-quality.mjs 用于确保一致性和生成器幂等性。scripts/audit-site.mjs 使用与浏览器测试套件相同、经过明确配置的已安装 Playwright 运行时，检查所有公开 HTML 和本地链接。