用途:这是开发 Blocklet Server 核心代码的入口技能,不同于用于开发 blocklet 应用的 blocklet-dev-setup,两者使用不同的 Server 模式,不可混淆。
主要能力与流程:检查 git 等基础工具;如用户提供 URL,先判断类型(GitHub 上 blocklet-server 仓库的 issue 继续本技能,其他仓库 issue 建议改用 blocklet-dev-setup;非 GitHub URL 交由 blocklet-url-analyzer 分析);将仓库克隆到 ~/arcblock-repos/blocklet-server;若工作区有未提交改动,会询问用户选择 stash、提交、丢弃或取消;随后切换到 dev 分支并拉取;启动前检查是否已有 Blocklet Server 生产版本在运行(两者端口与资源冲突,不能同时运行);最后读取并执行仓库内 ~/arcblock-repos/blocklet-server/.claude/skills/project-setup/SKILL.md,完成前置检查(Node.js v22+、bun、nginx)、bun install、bun turbo:dep、配置 core/webapp/.env.development 等步骤,并持续查看 tmux 中 webapp 窗口日志,处理崩溃重试。
使用方式:用 /blocklet-server-dev-setup 触发,或说明需要配置 blocklet-server 环境。开发环境用 bun run start 启动,访问 http://127.0.0.1:3000(3030 仅为代理地址);其他命令如 bun run test、bun run turbo:lint。
限制:严禁删除 ~/blocklet-server-data/ 或 ~/blocklet-server-dev-data/ 目录(含服务器配置与数据库、已安装 blocklet 及数据、用户认证与钱包绑定、日志与运行状态),即使用户要求也应拒绝并说明风险,可改用 tmux kill-session -t blocklet 停止服务。GitHub 权限不足、克隆失败或找不到 project-setup 技能时按对应提示处理。具体价格与收费信息暂未提供。