ResearchKit OS

ResearchKit OS is an AI Research Operating System — a multi-agent pipeline that turns any paper, PDF, or URL into a structured Knowledge Card, then lets you chat with it, compare it, explain it, and anchor it onchain.

Problem: Researchers spend 2 hours per paper, 70% on extraction — leaving little time for thinking.

Solution: 6-agent pipeline with adaptive planning, reflection loop, and MCP tools.

- Pipeline: Planner → Reader + Analyzer + Terminology (parallel) → KnowledgeBuilder → Reflection + Replan → Export

- Knowledge Card: takeaway, why-it-matters, what-surprised-me, who-should-read, innovation/methodology/results/limitations, terminology DAG, 4-intent recommendations

- 5 interactive modes: Chat with KC, 6-dimension paper comparison, 4-audience explanation, LLM smart suggestion, prompt playground

- 4 export formats: Markdown, Obsidian, Knowledge Graph (Mermaid), X Layer onchain (mock mode)

Tech Highlights:

- x402 Protocol (v2.4.2): HTTP 402 challenge + PAYMENT-SIGNATURE verification + facilitator HMAC-SHA256 signing (OKX v5/v6). ASP endpoint live at /api/x402/research, tested end-to-end with onchainos CLI (quote → pay → deliver → status:success)

- Web Search 4-tier fallback (v2.4.2): OpenSearch → FullText → keyword split → DuckDuckGo, fixing compound query empty results

- 4-layer i18n (zh-CN / en-US), 6 namespaces, zero-dependency t()

- Plugin System v2 (marketplace + batch execution queue + lifecycle hooks)

- MCP tool registry (memory / arxiv / filesystem / web_search)

- Cost & Token Dashboard (per-agent attribution)

- Security hardened v2.4.2: API key isolated from cookie, SSRF guard, tool whitelist, rate limit, stack trace sanitization, hardcoded key removal, Next.js 14.2.35

Hackathon Info:

- ASP ID: #9665

- Track: Software Utility

- Pricing: 0.005 USDT (x402 per call)

- Version: v2.4.2

- Demo: https://www.researchkit.online

- ASP Endpoint: https://www.researchkit.online/api/x402/research

- GitHub: https://github.com/yuuumc/researchkit

- X Post: https://x.com/yuuumc0001/status/2081612804176650274

ResearchKit OS — development complete, deployed live, ASP #9665 under OKX review.

[Milestones Completed]

✅ MVP Development Complete (2026/07/19)

- 6-agent architecture: Planner / Reader / Analyzer / Terminology / KnowledgeBuilder / Recommendation / Export

- Locale-aware language architecture (English & Chinese papers supported)

- Reflection + Replan self-correction loop

- Three export formats: Markdown / Obsidian / Knowledge Graph (Mermaid)

✅ Live Deployment (2026/07/20)

- Vercel deployment: https://researchkit-mu.vercel.app

- Smoke tested: English paper / Chinese paper / PDF / URL — all four input modes verified

✅ ASP Registration (2026/07/20, updated 2026/07/25)

- ASP ID: #9665

- Status: Under OKX review (public URL returns 404 while pending — this is normal)

- Service type: A2MCP

- Endpoint: https://www.researchkit.online/api/x402/research

- Pricing: 0.005 USDT (x402 per call)

✅ X Participation Post Published (2026/07/20)

- Tweet URL: https://x.com/yuuumc0001/status/2081612804176650274

- Includes #OKXAI tag + ASP link + demo site link

✅ Plugin System v2 + Full i18n (2026/07/22, v2.3.0)

- Plugin Marketplace: 3 built-in + 4 community mock plugins + batch execution queue

- 4-layer i18n: Application / Output / Auto Translate / Prompt language

- 6 namespaces, zero-dependency t() system

- UI polish: draggable ScrollToTop + progress ring, LiveThoughts streaming, auto-scroll on KC completion

✅ Security Hardening (2026/07/22, v2.3.1 + v2.3.2)

- v2.3.1: Vercel 58s timeout fix (MAX_ITERATIONS=0 on Vercel), CORS whitelist, PDF magic bytes validation, rate limit (KC/PDF/Batch)

- v2.3.2: API key isolated from cookie (HttpOnly), SSRF guard, tool whitelist (web_search + arxiv public, filesystem/memory gated), pluginId format validation, stack trace sanitization in production

- Dead code cleanup: computeWalletNonce removed, unused OpenAI import removed

- JSON truncation repair marker (wasRepaired + json-repaired tag)

✅ Custom Domain + x402 Protocol (2026/07/25, v2.4.0 → v2.4.2)

- Custom domain live: https://www.researchkit.online (replaces *.vercel.app subdomain)

- x402 Protocol end-to-end implementation: HTTP 402 challenge + accepts[] + PAYMENT-SIGNATURE decode + local field verification + business delivery + PAYMENT-RESPONSE

- OKX v5/v6 HMAC-SHA256 signing utility (okxStringify + okxSign): Python-style JSON (sorted keys, ": " / ", " separators), query string included for GET signing

- Facilitator verify/settle integration with auto-fallback to local trust on platform 50114 (Onchain OS v6 facilitator requires special platform permission, not a code issue)

- Web search 4-tier fallback (v2.4.2): OpenSearch → FullText → keyword split → DuckDuckGo, fixing compound query empty results (e.g. "transformer attention mechanism" now returns 5 results)

- arxiv tool compound keyword split search support

- Security hardening: hardcoded API key removed from scripts/analyze-tokens.ts (key already revoked), Next.js 14.2.5 → 14.2.35 (security patches), environment variable name sync between .env.local.example and config.ts, version numbers unified across 23 files

- Regression tested: onchainos CLI quote → pay → deliver flow returns status:success, final_answer + references + steps all complete

✅ Version Tags & Releases

- v2.3.0 / v2.3.1 / v2.3.2 / v2.4.0 / v2.4.1 / v2.4.2 all tagged on GitHub with release notes

- main branch at v2.4.2, develop branch in sync

[In Progress]

⏳ ASP #9665 under OKX review (public URL returns 404 while pending — this is normal)

⏳ Awaiting official evaluation after Jul 28 07:59 Beijing deadline

[Next Steps]

- Onboard real users from OKX.AI Marketplace once listed

- Explore ResearchKit Pro tier (academic institution subscription)

- v2.5 backlog: self-hosted Broker for real on-chain settlement (USDT0 transferWithAuthorization via EIP-3009), DNS rebinding guard, Upstash Redis rate limit

Bootstrapped