用途:本技能用于启动、开发运行、冒烟测试或驱动 SEO Office 应用,并确认某改动能端到端跑通(UI→流程→产物)。资料给出经验证的逐条操作流程。
启动:pnpm 不在非交互 PATH 上,需先加 nvm bin 到 PATH,再经 corepack 调用: export PATH="$(ls -d ~/.nvm/versions/node/*/bin | tail -1):$PATH" cd "/home/agricidaniel/Desktop/SEO Office" corepack pnpm exec next dev --turbopack -p 3100 端口 3000 常被残留实例占用。服务约 160ms 显示 Ready,但首个请求触发编译,curl 需放宽超时。验证:curl -s http://localhost:3100/api/specialists | head -c 200 应返回 31 个 specialists。LLM 提供方为 SEO_OFFICE_LLM_PROVIDER=claude-cli,claude CLI 须在 PATH 上,无需 ANTHROPIC_API_KEY。gcloud 凭据过期会导致 google-analytics/google-search-console specialist 报 invalid_grant,需执行 gcloud auth application-default login。
同源写入规则:POST/DELETE 路由检查 sameOriginWriteAllowed。curl 不发送 Origin 头(服务端对服务端)可通过;浏览器同源可通过;伪造跨源 Origin 返回 403。
端到端冒烟流程:specialists 接受空载荷,从 client manifest 读取目标。使用明确的丢弃式 slug。步骤依次为:POST /api/clients 生成脚手架;POST /api/clients/$SLUG/jobs 入队 vault-linter(确定性,约 67ms,无网络/LLM/费用);用 SSE 订阅 /api/jobs/$JOB/events?slug=$SLUG(?slug= 必填);从磁盘读取产物 .seo-office/vaults/$SLUG/wiki/deliverables/*vault-lint.md;用 DELETE /api/clients/$SLUG?confirm=1 删除(?confirm=1 必填,会先备份到 .seo-office/backups/ 再级联)。真实交付物(抓取+LLM)可在步骤 2 改用 technical-auditor,预计约 130s 且有实际费用。
UI 验证:无头 Chromium 通常无法初始化 WebGL,3D 画布会停在“Loading the 3D workspace”,属环境限制而非缺陷;外壳、导航、vault 面板、任务流与状态栏仍可针对实时状态渲染,建议用 accessibility snapshot 而非截图。
限制与注意:常见错误包括 pnpm 退出 127(用 corepack 前缀)、SSE 缺 slug 报错(补 ?slug=)、DELETE 因破坏性返回 400(补 ?confirm=1)、直接删磁盘 vault(应走 API 以级联 SQLite 索引并备份)、端口 3000 挂起(换端口)。切勿操作真实用户 vault。