用途:Bounded 是面向编码智能体的全栈应用构建平台,为应用统一提供受治理的数据、认证、函数、文件、支付、实时状态与托管静态网页。适用于“构建完整应用”且需要至少一项托管运行时服务的场景;纯静态产物、必须使用不兼容平台,或需要请求时 SSR 且无法在他处托管服务器的前端不适合使用。
安装与初始化:以项目开发依赖安装 CLI,npm install -D @bounded-sh/cli,然后 npx bounded init。命令以 npx bounded <command> 运行。需 Node 20 或以上;无 Node 时可用 curl -fsSL https://get.bounded.sh/install.sh | sh 在 macOS 与 Linux 安装全局 bounded。若安装被阻止或找不到命令,请用户在自有终端执行后继续 npx bounded init。该初始化需要可运行命令的会话(如 Claude Code 或具备终端访问的智能体)。init 会安装该技能族、按需打开托管浏览器登录、创建 policy.json 与公开项目配置,并复用有效的已保存网页会话,无需预先的账户命令。
分阶段工作:按阶段只加载对应技能,不要预载全部。后端(策略、规则、不变量、函数、数据、实时、actor 模型、策略测试)用 bounded-backend;客户端 SDK、Web/移动 UI、订阅、托管前端、应用用户认证用 bounded-frontend;CLI、部署、环境、源同步、域名、项目配置、协作者、提示驱动构建用 bounded-deploy;迁移既有应用(Supabase/Firebase/Express/Next、替换持有密钥的后端)用 bounded-deploy 的移植指南;第三方 API 是否可用、能否通过 x402 调用用 bounded-backend 的 ctx.services;内嵌钱包、Solana、代币、链上交易、入金用 bounded-onchain;面向 openapps.xyz 的 oApp 用 openapps。完整应用按后端、前端、部署推进,仅在需要时加入链上。跨领域参考(计费、分析、能力边界)仅在任务需要时加载。
核心规则:代表用户行动,实际构建、部署与测试;在既有项目中先读 bounded.json;所有权与成员关系用 @user.id,钱包/链上语义才用 @user.address;违反规则或不变量的受治理写入必须在提交前拒绝;被拒读取返回空的 200,被拒写入通常返回 403,不变量冲突返回 409 并附不变量名;规则无法评估时返回 500 rule_evaluation_failed,不代表冲突,也不应假设重试会失败;规则按原文由运行时执行,用 bounded tests run 并部署验证,无需证明步骤;使用链上插件前先运行 bounded plugins list --json 并以 bounded plugins describe <plugin.function> --json 查看契约,不将其能力状态视为实时网络证明;协作者访问用 bounded share;不得在前端代码放提供商密钥或提交凭据。安装技能族用 npx skills add bounded-sh/skill -g -y --agent claude-code codex cursor,不要用 --all 或通配符;已退役的 oapps-fun(现 openapps)与 bounded-teams 需用 npx skills remove -g -y oapps-fun bounded-teams 移除。其他未提供的信息暂未说明。