用途:为 WordPress ActivityPub 插件提供开发周期中的常用工作流参考,包括环境搭建、测试、代码质量检查与资源构建。
主要能力与用法: 环境管理:npm run env-start 启动 WordPress(http://localhost:8888),npm run env-stop 停止环境。 测试:npm run env-test 运行全部 PHP 测试,可加 --filter=pattern、指定测试文件路径或 --group=name;npm run test:e2e 运行 Playwright E2E 测试,npm run test:e2e:debug 调试。 代码质量:composer lint 检查 PHP 规范,composer lint:fix 自动修复;npm run lint:js 检查 JavaScript,npm run lint:css 检查 CSS,npm run format 格式化全部代码。 构建:npm run build 生产构建,npm run dev 开发监听模式。 覆盖率:npm run env-start -- --xdebug=coverage 启用覆盖率,npm run env-test -- --coverage-text 或 --coverage-html ./coverage 生成报告。
初始设置:克隆仓库后依次执行 npm install(自动运行 npm run prepare 安装钩子)、composer install、npm run env-start。
提交前钩子:仓库使用 .githooks/pre-commit,提交时自动排序 PHP 导入、检查未使用导入、校验测试模式、运行 PHPCS 自动修复并格式化 JavaScript。钩子会自动修改暂存文件,提交前需复查,若有改动需重新暂存并再次提交。
限制与说明:详细配置见 docs/development-environment.md、tests/README.md、docs/code-linting.md;其余未在资料中说明的内容暂未提供。