Rasczak Knowledge Commons

Rasczak Agent 服务

十种免费且附带来源链接的决策方法、三个可选决策包、REST、静态页面、无状态 MCP 端点，以及可离线使用的 Agent Skill。请求使用经过审核的固定内容，不会调用模型。付款默认停用；部署负责人必须在启用前验证实时结算。

版本 0.4.0 新增了决策工作流预览、免费客户端 Skill、私有版本权限代码，以及有界的公开来源采集。首个工作流的假设价格为 $5，但无法购买。配对模型评估和独立试验仍待开展。托管研究仅为预览，并非可用服务。

版本 0.4.1 修复了在 Workers 中复现的采集器故障：不支持的重定向处理导致请求无法发出。现在会返回重定向，但不会跟随，并会明确拒绝。运行记录仅持久化有界故障代码，不会保存错误消息或响应正文。实际的 Workers 运行时测试涵盖了采集和重定向拒绝，并以合成响应替代外部网络。

/workflows/ 和 workflow_catalog MCP 工具会展示范围和评估状态。/books/ 链接到两本可选书籍，并披露版税信息。客户决策产物仍归客户所有。一般反馈不代表允许将相关成果作为已发布示例重复使用。

KitAccess 是一个非活动后端组件，已通过临时钱包签名和本地存储测试数据进行测试。已结算的收据会绑定买家、SKU、版本和产物哈希；每次下载都需要新的单次使用签名。生产环境中的私有存储、实际结算和退款对账仍需通过验证。环境标志无法启用工作流购买或访问路由。源代码和免费客户端均为公开内容；私有工作流草稿不包含在此代码库和静态资源中。

可选的市场采集器最多读取三个由运营人员批准的 GitHub issue 来源，并且每天最多插入二十条去重后的链接/标题，记录总量上限为 1,000 条。它不会调用模型，也不会执行 issue 文本。请通过 D1 私下配置获批来源，而非使用公开请求正文。运行崩溃后需要对账；遇到提供商限流时会停止，不会重试。未设置启用标志且未配置获批来源时，采集器不会运行。

研究预览与隐私

GET /api/v2/research 介绍了未来的费用封顶服务。GET /api/v2/kits 支持 q、domain、offset 和 limit；GET /api/v2/kits/{id} 用于读取元数据。GET /api/v2/changes 提供版本变更信息。POST /api/v2/research/feedback 根据 OpenAPI 架构接收一般兴趣或技能反馈。它绝不会创建订单或收费。反馈功能要求设置 RESEARCH_FEEDBACK_ENABLED=true、D1 绑定以及通过部署密钥存储设置的 FEEDBACK_HASH_KEY。切勿将其值放入源代码或提示词中。

启用反馈功能前，请应用 migrations/0002_research.sql。每日确定性清理会汇总过期反馈，并在 30 天后删除原始提交。每日限额：每个假名提交五次，每个网络哈希提交二十次，全局一千次。哈希并非经过验证的客户身份。一般评论不得包含私人信息；请勿发布客户场景或凭证。服务不会发送通知或进行联系。

研究报价、订单、状态、结果和退款端点均返回 503。已提供 Cloudflare Workflow 入口点，但该入口点未绑定，且会无条件拒绝执行。刻意不提供实时模型和退款传输功能。设置标志无法绕过此发布门槛。离线模块实现了整数微美元定价、30% 加价、报价接受、原子成本预留、不确定调用对账、生命周期转换和退款意向。只有注入的模拟适配器可用于演练任务。

开展任何试点前，必须评估适配器的最坏情况成本、设立损失准备金、验证付款和退款结算、对交付范围进行基准测试，并获得明确的发布授权。预算中应计入可见令牌和推理令牌、工具、验证、重试、支付及退款费用。未使用的资金将退回；未能交付约定的输出则必须全额退款。通过这些门槛后，才会提供报价。

现有源代码许可证保持不变。新的付费工具包草稿不包含在此代码库或静态资源中。运行时文档并不代表已测得跨模型质量或令牌节省效果。

本地运行

npm ci --include=dev
npm run check
npm run deploy:dry
npm run dev

使用 Node 22 或固定版本的本地 Node 依赖。SQLite 测试使用 Node 内置的实验性驱动程序；托管收据使用 Cloudflare D1。

接口

• /api/v1/catalog 列出受支持的方法和工具包。
• /api/v1/methods/{id} 返回免费方法；未知 ID 返回 404。
• /api/v1/sample 返回完整的免费供应商评估工具包。
• /api/v1/packs/{id} 提供可选的组装工具包。未启用付款时返回 503；启用付款时，要求付款已验证并记录结算信息。
• /mcp 通过 Streamable HTTP 提供 catalog、method、sample_pack 和 pack_offer。这些工具均不会付款或授权支出。
• /full 返回 410。
• skill/rasczak-knowledge-commons 包含离线技能及其十个参考资料。

将客户端连接到部署所有者配置的源站。服务 URL 和代码库链接属于配置内容，不是内嵌的账户标识符。

对于 MCP Registry HTTP 所有权验证，可选择在构建时将 MCP_REGISTRY_PUBLIC_KEY 设置为 base64 编码的 Ed25519 公钥。公开验证记录会生成在 /.well-known/mcp-registry-auth。请仅将匹配的私钥保存在密钥存储中；服务器不需要该私钥。

构建和发布

scripts/build.mjs 根据整理后的目录生成静态发布内容。scripts/package-release.mjs 使用明确的允许列表创建独立的源代码包。两者都会在写入输出前运行隐私验证器。遇到未知发布文件时会停止打包。

将 RELEASE_PRIVACY_POLICY 设置为私有 JSON 策略文件，其中包含 forbiddenStrings，用于列出本地名称、账户标识符、原始文件名和内部项目名称。将此策略保存在发布内容之外。allowedPublicUrls 可将确切获批的公共端点排除在标识符匹配之外。仅靠模式检查无法识别所有私有标识符。推送前，请单独检查 Git 历史和作者元数据。

仅从全新且独立的检出目录发布生成的包。使用中性的作者元数据。不要将源代码归档、会话记录、浏览器配置文件、凭据、调试日志、源映射或原始工作目录复制到包中。data/input.json 等通用路径仅用于描述可分发结构。保留公共一手来源引用，以便核实方法声明。

部署

1. 将托管平台 CLI 验证到目标账户。通过进程环境和托管平台的密钥存储提供配置。切勿将凭据值写入源代码、日志、命令或文档。
2. 在构建时和部署配置中，将 PUBLIC_ORIGIN 设置为已验证的 HTTPS 来源。可选地将 PUBLIC_REPOSITORY 设置为获批的公共仓库。重新构建并运行 npm run deploy:check。
3. 保持 PAYMENTS_ENABLED=false 和 MAINNET_SETTLEMENT_APPROVED=false。仅部署允许列表中的资源和 Worker。验证主页、健康检查、目录、示例、未知 ID、Origin 拒绝、已禁用的支付功能，以及与实际 MCP 客户端的连接。
4. 如需收据，请创建 D1 数据库，将其绑定为 RECEIPTS，并应用 migrations/0001_receipts.sql。使用自己的数据库标识符。更改架构前备份收据。
5. 使用 Base Sepolia 及其确切的 USDC 资产进行支付试验。根据受控的收款地址配置 X402_PAY_TO。此服务无需收款钱包的私钥。
6. 将 Facilitator 凭据存储为托管平台密钥。验证实际结算、相同请求的重试、重放拒绝、结算结果不明确时的核对，以及结果恢复。启用生产支付前，必须通过明确授权且有额度限制的主网试验。
7. 在注册目录时使用已验证的命名空间和 URL。分别确认目录收录情况和实际的独立使用情况。这些源文件并不意味着已被收录，也不代表有任何客户数量。

支付行为和限制

此服务在 Base 或 Base Sepolia 上使用 x402 v2 精确模式 EIP-3009，授权有效期为 120 秒。它支持 65 字节的 EOA 签名。本地签名测试采用密码学验证；结算测试使用固定样例数据。

收据会绑定网络、资产、付款方、随机数、证明哈希、资源和交易。结果会在结算前存储。使用相同的已记录证明可获取相同结果，且不会再次收费。更改资源会被拒绝。结算状态不确定时会将其隔离，且绝不会自动重试。

如果结算成功但收据提交失败，请先根据 Facilitator 和链上证据核对收据，再恢复已存储的结果。切勿清除预留记录以强制再次支付。不存在公共收据编辑端点或自动退款操作。

测量协议请参阅 EVALUATION.md。测试、访问量和所有者支付都不能证明存在客户需求。