Knoww

Knoww

由 Polymarket 驱动的预测市场平台，助你了解自己的胜算。

功能

• 来自 Polymarket 的实时市场数据
• 通过 Reown AppKit 支持多个钱包
• 按类别浏览：政治、体育、金融、加密货币
• 活动和市场详情视图，包含价格图表
• 内置模拟交易 Agent 仪表板和管理 API
• 部署于 Cloudflare Workers

快速开始

前置条件

• Node.js 20.19+（或 22.x）
• pnpm
• Reown Cloud Project ID

如果计划开发 apps/agent，请使用支持该软件包测试脚本所需 node --experimental-strip-types 参数的当前 Node.js 版本。

设置

# Install dependencies
pnpm install

# Seed the Next.js environment file used by `pnpm dev:web`
cp apps/web/.env.local.example apps/web/.env.local

# Seed the Wrangler/Worker environment file used by `pnpm preview`
# and by local Cloudflare-style bindings such as D1/cron vars
cp apps/web/.dev.vars.example apps/web/.dev.vars

# Add required local variables
$EDITOR apps/web/.env.local
# Add Worker/runtime variables when you need preview mode, agent admin flows,
# or parity with Cloudflare bindings
$EDITOR apps/web/.dev.vars
# Required beyond the example file:
# NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID
#
# The example file already includes:
# NEXT_PUBLIC_POLY_BUILDER_CODE
# NEXT_PUBLIC_POLYMARKET_HOST
# NEXT_PUBLIC_POLYMARKET_WS_HOST
# NEXT_PUBLIC_POLYMARKET_CHAIN_ID
# POLY_RELAYER_API_KEY
# POLY_RELAYER_API_KEY_ADDRESS
#
# Common optional vars for local parity:
# NEXT_PUBLIC_APP_URL, NEXT_PUBLIC_POSTHOG_PROJECT_TOKEN,
# NEXT_PUBLIC_POSTHOG_HOST, POSTHOG_PROJECT_API_KEY, POSTHOG_HOST,
# OPENROUTER_API_KEY, EXTENSION_SESSION_SECRET,
# BUILDER_SIGNING_SERVER_URL, INTERNAL_AUTH_TOKEN,
# ALCHEMY_API_KEY, POLYGON_RPC_URL, COINMARKET_API_KEY

# Run the web app
pnpm dev:web

打开 http://localhost:8000

pnpm dev:web 会读取 apps/web/.env.local。pnpm preview 和 Cloudflare Worker 运行时会读取 apps/web/.dev.vars；本地 D1/Agent 定时任务设置也应放在此文件中。

扩展开发

# Configure the extension environment
cp apps/extension/.env.example apps/extension/.env

# Optional overrides:
# DEV_MODE=false        # point the built extension at production
# POLY_BUILDER_CODE=... # builder attribution code for extension orders
# WALLETCONNECT_PROJECT_ID=... # required for WalletConnect/mobile wallet QR flows

# Run the web app locally for extension API calls
pnpm dev:web

# In a second terminal, run the extension build in watch mode
pnpm dev:ext

在开发环境中，扩展默认指向 http://localhost:8000。如果希望构建后的扩展连接到生产环境，请在 apps/extension/.env 中使用 DEV_MODE=false。

技术栈

类别	技术
框架	Next.js 15（App Router）
钱包	Reown AppKit、Wagmi、Viem
数据	TanStack Query
UI	Shadcn、Tailwind CSS v4、Framer Motion
工具链	BiomeJS、TypeScript
部署	Cloudflare Workers

脚本

根工作区脚本：

pnpm dev:web        # Run the Next.js web app on port 8000
pnpm dev:ext        # Run the extension build in watch mode
pnpm build          # Build all workspace packages
pnpm build:web      # Build the web app only
pnpm build:ext      # Build the extension only
pnpm build:ext:dev  # Build the extension once in development mode
pnpm test           # Run workspace tests where defined
pnpm preview        # Preview the Cloudflare web deployment locally
pnpm lint           # Lint the monorepo
pnpm lint:web       # Lint the web app only
pnpm lint:ext       # Lint the extension only
pnpm format         # Format the monorepo
pnpm typecheck      # Type-check all workspace packages
pnpm typecheck:web  # Type-check the web app only
pnpm typecheck:ext  # Type-check the extension only
pnpm audit:security # Run a high-severity dependency audit
pnpm brand:render   # Render the brand mark asset
pnpm deploy         # Deploy the web app to Cloudflare
pnpm prepare        # Install Husky hooks
pnpm release:ext    # Bump, build, and zip the extension release

各工作区软件包中的脚本：

• apps/web/package.json：dev:turbo、start、soak、soak:assert、cf-typegen、agent:d1:list:local、agent:d1:adopt-runtime-schema:local、agent:d1:adopt-runtime-schema:remote、agent:d1:migrate:local、agent:d1:migrate:remote、test、test:node、test:watch、test:coverage、test:e2e
• apps/extension/package.json：clean、test、test:scoring、benchmark:embeddings、format、version:bump、zip、release
• apps/agent/package.json：build、typecheck、lint、format、test

常用测试命令：

pnpm --filter @knoww/web test           # Web Vitest suite + node-based tests
pnpm --filter @knoww/web test:watch     # Web Vitest watch mode
pnpm --filter @knoww/web test:coverage  # Web coverage run
pnpm --filter @knoww/web test:e2e       # Web Playwright smoke test
pnpm --filter @knoww/extension test     # Extension scoring tests
pnpm --filter @knoww/agent test         # Agent node tests

文档

• Knoww for Cursor - MCP 插件设置和市场软件包
• docs/ARCHITECTURE.md - 架构概览
• docs/API.md - API 路由参考
• Polymarket Docs - Polymarket 文档
• Reown Docs - Reown 文档

贡献

1. Fork 此仓库
2. 创建功能分支
3. 提交前运行 pnpm lint
4. 发起拉取请求

许可证

AGPL-3.0

---

由 Soclly 构建