本技能是开发 Blurb 平台（blurb-workspace/）的操作指南。仓库为单体结构：engei-widgets 提供组件插件（Chart、Map、Mermaid 等），engei 是 React 编辑器/预览库（CodeMirror + markdown），blurb 是 Cloudflare Worker 应用（Hono + D1），含客户端 SPA、Worker 服务端、共享工具和 D1 迁移。
构建与开发：wrangler dev 不会热重载 engei-widgets 或 engei 的改动，需依次执行 cd engei-widgets && bun run build、cd ../engei && bun run build、cd ../blurb && bun run build 后刷新浏览器；仅改 blurb 时只需 cd blurb && bun run build。开发服务器为 cd blurb && bun run dev，监听 localhost:8787，应在本地而非生产测试。
密钥与数据库：密钥存于 Infisical 的 prod 环境，路径 /apps/blurb，关键项 ADMIN_TOKEN；本地开发用 .dev.vars。迁移用 bun run db:migrate（本地）和 bun run db:migrate:prod（生产），迁移文件位于 blurb/migrations/ 并按序编号。可直接查询生产库：npx wrangler d1 execute sono-worker-db --remote --command "SELECT ..."。
测试与部署：测试用 Vitest + Miniflare 加真实 D1，自动应用迁移；运行 bun run test 或 bun run test:watch，engei 用 bun run test。测试辅助函数 request(path, init) 针对 Hono 应用发起请求，认证用 TEST_ADMIN_TOKEN。部署用 cd blurb && bun run deploy（vite build + wrangler deploy），发布到 blurb.md 和 www.blurb.md。
其他要点：内容路由按 Accept 头返回不同格式（text/html 返回 SPA，application/json 返回 JSON 文件对象，/ 返回原始 markdown）。认证采用按文件夹的 SHA-256 token_hash，ADMIN_TOKEN 可绕过所有文件夹权限；文件夹权限用两位八进制 chmod 字符串，第一位为所有者、第二位为公开，位含义为 4 读、2 评论、1 写，默认 '76'。可经 API 编辑线上内容，如 PATCH 用 old_str/new_str 差异、PUT 用完整 content。注意事项包括构建顺序必须为 widgets→engei→blurb，D1 的 db.exec() 在 Miniflare 测试中无法处理多行 CREATE TABLE，应改用 db.prepare(stmt).run()，以及主题变量需在三处保持同步等。