sorify：实践指南

真正理解sorify，要从它处理的任务开始：sorify - AI Agentic QA AI 代理平台。实际做软件开发时，经常会碰到依赖、接口和异常处理往往比主路径更影响采用，所以功能列表并不能代替验证。与其反复读介绍，不如在隔离分支完成一个可回滚的小任务，再依据安装步骤、接口契约、测试结果和错误信息做取舍。对需要可检查开发流程而非单次演示的工程师来说，这个仓库值得继续验证；只求即装即用的人则要先看维护成本。

下一代AI 第一 - 浏览器测试 &浏览器自动化平台

AI 完全可控 - 剧作家管理 Platform

专为 AI 代理打造 - Claude・Codex

专为 developers 打造 通过 MCP

管理整个工作区 打造强大 browser automations

与scheduler

双向 webhook integrations

Chrome 扩展程序，带有 MCP（适用于混合动力爱好者）

24/7 背景 Agents

Page 知晓 MCP

Comprehensive 测试 management

与 Ephemeral 上的剧作家跑步者一起

Control 本地的所有内容 harness

克劳德·法典·OpenCode

Pick 从左边开始 off

AI 仪表板上的代理 itself

24/7 背景 AI Agents

Page 感知 - 与 MCP sync

为本地 harness 提供支持的相同 MCP 工具 也在UI上

Admin tools

用户管理，oAuth apps

监控、日志等

Code coverage

对于前端 assets

User Skills

创建、重用技能 - 多合一 place

分享、浏览、复制attach

对于本地或 UI Agent

★ 自动化： 使用 claude、codex - 以及技能、mcp、测试运行程序和仪表板自动化浏览器测试。

★ Chrome 扩展： 捕获浏览器操作，发送到 AI 编写测试、上传、自我修复。

★ Webhooks： 3 种类型的双向集成。触发器远程运行，或触发 Github Actions 或 HTTP Webhook pre/post 从 sorify 运行。

★ 临时： 自托管，可在临时模式下扩展。

★ 计划： 在内置计划程序中运行自动化浏览器任务。

✴ 测试管理： 组织测试套件和测试用例，按需或按计划运行它们。

✴ 剧作家代码覆盖率： 仪表板内的代码覆盖率支持。

✴ 测试运行程序： 由剧作家驱动的执行，具有完整的运行历史记录。

✴ 通知： 当套件完成或失败时收到通知。

✴ Cookie 管理器：sorify 支持来自 UI、MCP 和 chrome 扩展的每套件 cookie 注入。

✴ 用户管理： 角色、权限和每个用户 IAM。

✴ MCP 服务器： MCP 层上的低令牌消耗，控制测试用例、代码的各个方面。

✴ 代理插件： 包含 Claude/Codex 插件 - 零代码测试代码管理。

✴ 我的 AI 代理： 具有仪表板后台功能，AI 代理您自己的 OpenAI-compatible。

✴ MCP： 页面感知聊天，可以调用每个 sorify MCP 工具，可恢复切换到本地代理。

✴ 技能： 在平台内为座席创建、分享技能。使用过MCP或UI内的代理。

✴ i18n 和 2 种模式： 支持日语、中文、马来语，带有深色模式。

快速入门

docker-compose up

特点

WITH ALL MCP CONTROLS - SUPPORTED

▼ Core Testing
・ AI test generation        ・ Playwright execution
・ Browser automation        ・ Cross-browser support
・ Headless mode             ・ Scheduled runs
・ Cron scheduling           ・ Per-test scheduling
・ Run history               ・ Run cancellation
・ Status polling            ・ Test logs
・ Pass-rate analytics       ・ Screenshot on failure
・ Code coverage reports     ・ LCOV coverage export
・ Bundle URL filter         ・ Run retention pruning

▼ Test Management
・ Suite management          ・ Test case management
・ Bulk test creation        ・ Bulk test deletion
・ Suite duplication         ・ Test duplication
・ Code version history      ・ Version restore
・ Test enable/disable       ・ Search and filters
・ Suite bookmarks           ・ Suite review page
・ Dashboard analytics

▼ Sessions and Data
・ Cookie injection          ・ Pre-authenticated sessions
・ Storage state upload      ・ Suite variables
・ Proxy routing             ・ Per-domain proxies
・ Timeout configuration     ・ History retention

▼ Access Control
・ User management           ・ Role-based permissions
・ Per-suite members         ・ Suite sharing

▼ Notifications
・ Teams notifications       ・ Email notifications
・ Inline screenshot emails  ・ Notification cooldown
・ Digest summaries

▼ Integrations
・ CI webhook trigger        ・ Bi-directional webhooks
・ Webhook concurrency guard ・ Webhook token regeneration
・ GitHub Actions dispatch   ・ HTTP request hooks
・ Pre-run hooks             ・ Post-run hooks
・ Multi GitHub App support  ・ GitHub/GHE OAuth login
・ MCP discovery endpoint

▼ AI and Agents
・ MCP server                ・ Low-token consumption
・ Claude plugins            ・ Codex plugins
・ My AI Agent web chat      ・ Agent chat handoff to MCP
・ Agent profiles            ・ Ask and Agent chat modes
・ User skills (markdown)    ・ Skills library + copy
・ Long running agents       ・ Live agent streaming
・ Agent turn cancellation   ・ Agent web tools
・ AI healing                ・ Failure investigation
・ Gateway live lookups

▼ Dashboard and UI
・ Activity feed             ・ Cmd+K command palette
・ Global search             ・ Screenshot gallery
・ Syntax highlighted editor ・ Admin dashboard note
・ i18n (JA, ZH, MS)         ・ Dark mode

▼ Recorder
・ Chrome extension          ・ Session recording
・ Recorded test generation  ・ Standalone recorder MCP

▼ Deployment
・ Self hosting              ・ Ephemeral mode
・ Docker deployment         ・ Admin panel
・ Ephemeral readiness check ・ Execution mode switcher
・ Runner image build        ・ Data retention pruning

特征矩阵

▼ Feature Matrix

                                                                            MCP  Dashboard   Webhook     API
                                                                        --------------------------------------
・ Suites: list/get/create/update/delete/duplicate                           ○      ○          —           ○
・ Suite schedule: update/delete                                             ○      ○          —           ○
・ Suite cookies: upload                                                     ○      ○          —           ○
・ Suite integrations: GitHub Action/HTTP request (pre/post run hooks)       ○      ○          —           ○
・ Suite bookmarks: list/toggle                                              ○      ○          —           ○
・ Suite members: list/add/update/remove                                     ○      ○          —           ○
・ Tests: list/get/create/update/update code/delete/duplicate                ○      ○          —           ○
・ Tests: bulk-create/bulk-delete                                            ○      ○          —           ○
・ Tests: toggle enabled/disabled                                            ○      ○          —           ○
・ Runs: trigger/list/get/cancel/delete                                      ○      ○          —           ○
・ Runs: status                                                              ○      ○          ○           ○
・ Runs: logs                                                                ○      ○          —           ○
・ Screenshots: list/get                                                     ○      ○          —           ○
・ Recorder: chrome extension events                                         ○      —          —           —
・ Suite webhook token: regenerate                                           —      ○          —           ○
・ Test code-version: restore                                                —      ○          —           ○
・ Login/register/logout/password reset                                      —      ○          —           ○
・ Profile: update name/password                                             —      ○          —           ○
・ Dashboard analytics (stats, recent runs)                                  —      ○          —           —
・ Admin: manage users (create, list, role, delete, reset password)          —      ○          —           ○

AI 用法

克劳德·科德

$ cat ~/.sorify
SORIFY_URL=http://localhost:8000/sorify
[email protected]
SORIFY_PASSWORD=changeme

claude /plugin marketplace add https://github.com/rakutentech/sorify.git

在 Claude Code 中从该市场安装 sorify，然后启动一个新的 会议。现有的 /sorify:gateway、/sorify:generate 和 /sorify:recording 命令仍然可用。

法典

codex plugin marketplace add https://github.com/rakutentech/sorify.git
codex plugin add sorify@sorify

法典： 调用 $sorify:sorify-setup 技能一次。

使用法典技能

$sorify:sorify-gateway
$sorify:sorify-generate
$sorify:sorify-recording
$sorify:sorify-update

codex mcp get sorify

SKILL 1 - 索瑞菲 MCP

/sorify:gateway Create a test suite called "Awesome App"
/sorify:gateway List latest failing tests

/sorify:gateway Create new test suite. Get requirements from JIRA/GHE/Excel. Write using /sorify:generate
/sorify:gateway Update the test suite http://localhost:8000/sorify/suites/{id} by adding retry twice

AI 治疗

/sorify:gateway why my test is failing <name of test>
/sorify:gateway why my test is failing <or-link-to-test>

SKILL 2 - 内置 QA 技能

# Tests from source code (git)
/sorify:generate Scan my code and generate tests for <github.com/your/repo>

# Tests from source code (path)
/sorify:generate Scan my code and generate tests for </path/to/your/source>, ref </path/to/your/docs>

# Tests from url (remote)
/sorify:generate Crawl site and generate tests for https://rakuten.co.jp

OR SKILL BYO - 自带 QA 技能

/my:qa:skill Create detailed tests <...>
...then /sorify:gateway once done - upload, run and invetigate failed tests

Chrome 记录器 - 记录、捕获、生成、上传（Chrome 扩展）

这是一个 Chrome 扩展，可以选择在混合模式下工作。浏览时，它会记录浏览器事件并存储到文件中。 然后，AI 可以拾取事件序列，以更好地编写测试代码，当补充更多有关项目的上下文（例如源代码）时，效果很好。

从真实录制的会话生成测试，而不是 DOM 探索 — chrome-mcp-playwright sorify-recorder-mcp

♢ 1. 安装 mcp

curl -fsSL https://raw.githubusercontent.com/rakutentech/sorify/master/mcp/install-mcp.sh | sh

♢ 2. 加载 Chrome 扩展程序

chrome://extensions/ → 启用 “开发者模式” → “加载解压”→ 选择 extension/ 文件夹

我们没有 npx，抱歉

♢ 3. 启动录音机

当您启动 Claude Code 或 法典。在克劳德代码中，检查 /mcp plugin:sorify:sorify-recorder.

如果没有，则在以下位置启动侦听器：

~/.sorify-bin/sorify-recorder-mcp

否 4. 单击扩展图标 → 连接 → 开始录制

执行您想要变成测试的clicks/inputs，然后停止录制。

提示：检查端口lsof -nP -iTCP:7420 -sTCP:LISTEN

否 5. 生成测试

/sorify:recording latest

在 Codex 中，使用 $sorify:sorify-recording 并请求最新记录。

快速入门（来自源码）

发展（本地）

# 更新：APP_KEY、DB_PASSWORD、MYSQL_ROOT_PASSWORD
cp .env.example .env

composer setup
php artisan dev

验证

http://localhost:8000/sorify

• 用户： [email protected]
• 密码： 更改我

有关其他详细信息，自托管、临时模式、docker，请参阅 INSTALL.md。

可定制的设置

  <sub>Webhooks and integrations configured per suite</sub>

  
</td>
<td align="center" width="50%">
  Webhook settings

  <sub>CI webhook for triggering Sorify runs</sub>

</td>

Run settings

Webhook URL、令牌和运行选项

集成

1. sorify Webhook： 从外部触发sorify run/runs
2. HTTP Webhook： 从 sorify 触发 HTTP - pre/post 运行
3. Github Action Webhook： 从 sorify - pre/post 运行触发 Github 操作。详情如下：

HTTP 集成 settings

从 sorify 触发 HTTP - pre/post 运行

GitHub、GHES、GHEC 集成

集成 1：Github Actions → sorify

触发器 sorify 使用套件的 CI webhook（令牌身份验证，无会话）从工作流程运行。 从套件的设置页面获取 Webhook URL，将令牌存储为秘密，然后：

on: [push]

jobs:
  e2e:
    runs-on: ubuntu-latest
    steps:
      - name: Trigger Sorify run
        run: |
          curl -sf -X POST "$SORIFY_WEBHOOK_URL/trigger" 
            -H "Content-Type: application/json" 
            -d '{"test_ids": [12, 34]}'   # omit to run all active tests
        env:
          SORIFY_WEBHOOK_URL: ${{ secrets.SORIFY_WEBHOOK_URL }}

      - name: Poll run status
        run: |
          curl -sf "$SORIFY_WEBHOOK_URL/runs/{run}/status"
        env:
          SORIFY_WEBHOOK_URL: ${{ secrets.SORIFY_WEBHOOK_URL }}

集成 2：sorify → Github 操作（前或后）

GitHub 应用程序在管理 → GitHub 应用程序（仪表板）下进行管理。 用于登录或触发 sorify 的操作。

要注册应用程序，请按照仪表板本身上的演练操作：管理→ GitHub 应用程序→“如何 注册“。

sorify 调度的工作流程如下所示：

on:
  workflow_dispatch:
    inputs:
      # Injected by Sorify — do not edit
      sorify_run_id:
        type: string
      sorify_suite_id:
        type: string
      # and so on. Custom add from - sorify's suite/{id} > settings

jobs:
  sorify:
    name: Sorify
    steps:
      - name: Show Sorify context
        run: |
          echo "sorify_run_id=${{ github.event.inputs.sorify_run_id }}"

HTTP API 参考

有关完整端点列表和示例curl 请求，请参阅 API.md。

业主

    <sub>MarikoKikugawa</sub>
  
</td>
<td align="center">
  
    <sub>asghar-ahmed</sub>
  
</td>
<td align="center">
  
    <sub>HiromichiHagiwara</sub>
  
</td>

    <sub>kevincobain2000</sub>
  
</td>
<td align="center">
  
    <sub>pulkit-kathuria</sub>
  
</td>
<td align="center">
  
    <sub>chetra-tep</sub>
  
</td>
<td align="center">
  
    <sub>chetratep</sub>
  
</td>

• v1 - 初始版本
• v1.1 - 在用户管理、mcp 增强中添加电池
• v1.2 - 用于记录和编写剧作家测试的 Chrome 扩展
• v1.3 - 技能更新，MS 团队通知链接到屏幕截图，仪表板具有管理员可编辑的消息
• v1.4 - 从 MCP 管理用户。
• v1.5 - 目前支持英语和日语的 i18n。
• v1.6 - i18n 支持马来语、简体中文。扩展捕获文件上传、iframe、选项卡、网络。 oAuth 登录，带头像。复制一个套件。
• v1.7 - Cookie 支持，变量支持。
• v1.8 - MCP 支持运行。登录页面后自动重定向。支持一次性 CI webhook 以及谁运行了 CI。
• v1.9 - Chrome 扩展内存泄漏修复。支持多个连接器的 pre/post Webhooks。
• v2.0 - 短暂模式
• v2.1 - 我的 AI 代理：仪表板内代理聊天（OpenAI-compatible 配置文件、页面上下文、MCP 切换）和测试代码上的 AI 模型归因。
• v2.2 - 长时间运行的代理、管理员控制的过时运行、md 上的美人鱼支持、AI 解释这些按钮。运动鞋 UI。
• v2.3 - 支持剧作家报道。
• v2.4 - 用户技能：共享、复制、分发、在代理中使用。