memi

Memi

面向 Agentic AI 的设计层。

在编码 Agent 开始编辑之前，先为它提供界面说明。Memi 会绘制仓库中现有 UI 的映射，呈现与具体文件关联的无障碍和设计系统风险，并提供一项可重复运行的确定性检查，供你在合并前再次执行。先从 CLI 开始，再将相同的检查关卡添加到每个拉取请求中。

Memi Studio 现已推出；Memi Canvas 正在开发中。首次审计无需账号、API 密钥、Figma 文件、全局安装或守护进程。

从你的下一个界面开始 · 获取 Memi Studio · 阅读研究

快速入门：发现你的第一个界面问题

在任意前端仓库中运行一次非破坏性审计。无需账号、API 密钥、Figma 文件、全局安装或守护进程。

npx -y @memi-design/cli@latest diagnose . --json --no-write --fail-on none

结果包含规范化的问题 ID、置信度、来源信息和 file:line 证据，Agent 可以据此处理具体问题，而不是靠猜测。

将相同的上下文提供给你的编码 Agent：

npx skills add memi-design/memi --skill audit-frontend-design

然后询问：

在编辑之前审计这个前端。优先处理对用户影响最大的五项改动，复用现有系统，并在补丁完成后验证结果。

如果 Memi 在你的项目中发现了真实的界面问题，请分享这项发现。真实报告是了解下一步改进方向最有用的信号。

成本与离线运行

本地源码诊断使用确定性规则：不调用模型、不需要 API 密钥，也不产生模型费用。它会检查你提供的代码库，并返回可由 Agent 验证的发现。安装、CPU 时间、CI 运行器以及你选择的任何 Agent 仍会产生成本。已发布的研究尚未证实端到端的美元或 Token 节省优势。

先运行一次诊断，处理置信度最高的发现，然后重新运行相同的检查。使用 --agent-context 获取范围有限的文件索引，而不是将整个代码库发送给模型。其路由采用启发式方法；上下文更小并不能证明任务会以更低成本成功完成。--files 可限定所报告发现的范围，而无需启动 Git；但它仍会扫描目录树以汇总统计信息。

**已发布的 Beta 版：**为 2.8 前端工作流安装确切的 2.8.0-beta.2 软件包。稳定版仍为 2.7.9；该 Beta 版不是稳定版。请参阅当前发布状态和已知限制。

beta2 npm 发布记录标明了其已发布源码和不可变制品证据。beta1 npm 发布记录保留了先前版本的历史记录，但不能验证 beta2。2.8 锁定的默认设置和明确的能力契约不追溯适用于 2.7.9。

npx -y @memi-design/[email protected] --version
npx -y @memi-design/[email protected] agent brief . --frontend --intent "Improve this interface" --json

该 Beta 版明确将托管安全审查、SwiftUI 对等性和完整的 DesignWorkbench 认证列为待处理事项。它不是稳定版，也未获雇主批准。发布溯源和平台凭证必须对应确切的已发布制品。

该 Beta 版默认禁止本地诊断写入项目文件，将付费集成设为可选，并要求对网络访问、子进程和源报告持久化操作进行明确授权。npm 安装需要访问软件包注册表；离线首次运行的说法需要单独验证过的软件包。请参阅验收台账、已知限制和发布实况。

**2.8 前端工作流：**该 Beta 版提供能够感知代码库的前端简报、四个实用且已锁定的 MCP 工具、经过验证的 Figma/Paper 证据输入，以及明确的组件复用冲突。请参阅前端工作流，获取可运行的 Beta 命令；并参阅发布计划，了解尚未完成的门槛。托管式独立安全扫描，以及 reviewed-candidate-audit 和 swiftui-rendered-rerun 凭证仍是稳定版发布的待办事项。Paper 像素级对等性尚未评估。在盘点的 158 条 CLI 路径中，105 条仍处于延期状态；广泛授权不会启用这些路径。目前尚无证据证实完整任务能够节省美元或 Token 成本。

2.8 对前端 Agent 的改进

2.7.9 中	2.8 beta 中
诊断、Agent 简报、令牌工具、Figma 桥接和技能已存在。	agent brief --frontend 将实际导出项、props、CSS/DTCG 令牌和 CSF 故事整合到 2–16 KiB 的 JSON 响应中。
Harness 配置暴露了宽泛的工具目录。	锁定的 stdio 启动时不会创建套接字或写入项目；无需授权即可使用四种读取工具。
设计映射可能过时，生成器警告也可能被忽略。	系统会根据当前导出项、必需 props、令牌引用和可选源哈希检查显式映射。标记为已映射的 Registry 规范会阻止重复生成；宿主封装会提供复用指导。
Paper 没有专用集成。	Codex 可以通过同一经过验证的封装提供选定的 Paper 或 Figma 上下文；无需额外的模型会话或捆绑连接器。
静态诊断可能会将尚未评估的类别显示为通过。	质量评分仅涵盖已评估类别；覆盖范围和扫描遗漏会单独列出。除非实际运行浏览器验证，否则该项仍标记为未评估。

实际收益是获得更有用的本地证据和更清晰的失败信号：简报会在 Agent 重复创建组件前识别已有组件；诊断会区分未检查的类别与已评估的发现；diagnose --receipt-only 则会提供独立的纯元数据结果，且不会持久化源报告。回归测试还发现并修正了有界文件读取、格式错误的事件处理以及失败退出代码方面的候选缺陷。这些修正改进了特定行为，但并不能证明设计质量普遍达标、通过安全认证或降低任务成本。

源代码 2a6d0e44 对应的早期打包结果，是针对那些确切字节的历史证据。之后的防御性运行时修复已取代该制品，成为发布候选版本；每个修正后的源代码检查点都会通过单独的本地包和摘要进行验证。有关各项结果的源代码、制品和范围，请参阅验证记录。本地候选版本的收据仍是其原始字节的证据；它们不能取代已发布的 npm 记录。

代码的权威来源仍是仓库。Memi 提供证据；Codex 编辑代码并运行项目的实际检查。现有的自定义 CSS 和组件系统无需迁移到 shadcn。此 beta 有意暂缓支持许多旧版命令路径；它目前还不能直接替换所有 2.7 工作流。

将检查加入每个拉取请求

将 examples/github-actions/memi-design.yml 复制到你的仓库中，保存为 .github/workflows/memi-design.yml。该模板固定使用经过审核的公共 Action 提交，并为审查者提供：

• 仅在新增界面债务时失败的 PR 检查；
• 包含人类可读报告的 memi-design-health 制品；以及
• 仓库授予 security-events: write 权限时生成的 SARIF 注释。

此工作流无需 API 密钥或 Memi 密钥。Fork 仓库发起的拉取请求仍会获得检查和报告；如果 GitHub 未授予相应权限，SARIF 上传会自动跳过。

如果你希望手动配置，完整的 GitHub Action 指南记录了每个输入、输出、权限和证据文件。

一个产品层，三个界面

界面	介绍	状态
Memi CLI	为本地代码仓库、Agent 和 CI 提供界面智能与确定性检查。	现已推出
Memi Studio	一款 macOS 工作台，可整合项目上下文、Agent 工作流与验证。	现已推出
Memi Canvas	一个用于设计系统上下文与受控 Agent 提案的可视化工作区。	目前正在开发中

查看产品

Memi Studio	Memi Canvas — 开发中
在同一个工作台中整合 Agent 提示词、项目记忆和验证界面。	预览设计系统上下文、检查提案，并让人工参与其中。此预览展示的是正在开发的版本，并非对已发布产品的保证。

Memi 为 Agent 工作流带来的价值

修改之前	修改期间	合并之前
发现组件、令牌、路由、状态和无障碍方面的缺漏。	为 Agent 提供范围明确的任务说明，指出必须保留的系统。	重新运行确定性检查，并在 CI 中展示新增的界面债务。

需求	从这里开始
查找 UI 风险和产品系统上下文	audit-frontend-design
围绕现有组件和令牌规划变更	remember-design-system
避免新产生的界面债务进入拉取请求	enforce-design-ci
构建并验证原生 Apple 界面	build-swiftui-interface

兼容 shadcn 注册表和 v0 设计系统。

证据一览

V15 确认性审计是一份公开的技术披露，并非排行榜。它分别考察回执准入、渲染后的设计质量、功能验收和资源观测结果。

测量记录	具体解读
36 / 36 份冻结回执通过准入	每个预注册的 Agent 实验单元都有可审计的回执。这表示回执通过准入，并不代表普遍性能。
10 组完整的模型评分匹配对	通过预先规定筛选条件的渲染设计质量比较。这是模型评分证据，并非独立从业者评审。
Buzzr / Expo：均值 +1.4；Paraform / web：均值 −0.4	在两类评分任务上，限定范围内的非劣效门槛均已通过。这并不能证明普遍更优。
0 / 21 项按任务和资源校正的测试遭到否决	该研究未能证明在速度、成本或令牌用量方面具有优势。

**单独列出的历史版本发布记录：**2.7 候选版本记录报告了 2,187 / 2,187 项测试通过。这是发布证据，不属于 V15，也不能证明每个项目都能获益。

基准测试与论文

在限定范围内的 Buzzr 和 Paraform 任务系列中，质量非劣效性检验均已通过。完整论文报告了排除项、失败路径和局限性，且未进行插补。本研究不声称具有优越性、更快速度或节省费用。 阅读会议风格审计 PDF，查看协议和收据，或查看 V17 预注册。

Memi InterfaceBench v1 是一份包含 100 个目标任务的规范，其中有 5 个固定种子任务；它不是汇总性能分数。历史候选记录报告了 2,187/2,187 项测试通过，语句覆盖率为 70.57%。超过 25% 的说法仍未获验证。查看基准测试合约和工作流证据。

Memi DesignWorkBench v2 包含 300 份任务合约，任何认证声明都需要先经过从业者校准。

对应实际工作流的提示词

目标	可复制粘贴的提示词	配套工作流
在更改 UI 前建立基线	在编辑之前审计此 frontend。 优先处理有最明确 file:line 证据的五项更改。	audit-frontend-design
将证据转化为范围明确的计划	将这些发现转化为范围明确的 UI 更改计划。 编辑前优先复用现有组件和 token。	remember-design-system
保护拉取请求	为此拉取请求设置确定性的设计 CI 门禁。 仅当引入新的界面债务时才失败，并保存 SARIF 和 HTML 报告。	enforce-design-ci

明确说明研究内容

这项研究用于披露信息，而非产品排行榜。它将功能、渲染质量和资源证据分开，避免结果被解读为超出研究所支持的结论。

选择集成方式

接入方式	从这里开始	适用场景
单次 CLI 运行	npx -y @memi-design/[email protected] diagnose . --no-write	无需安装即可试用 Memi
全局 CLI	npm i -g @memi-design/cli	日常本地使用
Agent Skill	npx skills add memi-design/memi --skill audit-frontend-design	Codex、Claude Code、Cursor 及兼容的 Agent
GitHub Action	复制入门工作流	拉取请求设计 CI
MCP 服务	memi mcp start --no-figma	任何 MCP 客户端
Studio	brew install --cask memi-design/memi/memi-studio	受监督的 macOS 工作流

GitHub Action

name: design
on: [pull_request]

permissions:
  contents: read

jobs:
  memi:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      security-events: write
    steps:
      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
        with:
          fetch-depth: 0
      - uses: memi-design/memi@5fcbf39e1255af0c14c5a17ba6bde8cf1206e525 # v2.7.9
        with:
          version: "2.7.9"
          report: true
          upload-sarif: true

该 Action 会添加代码扫描注释、步骤摘要和 memi-design-health 构建产物。可将现有债务设为基线，同时让新引入的债务触发门禁失败。

GitHub Action 指南 · CI 配方 · 当前版本

Agent 和 MCP 配置

memi agent install codex --project .
memi agent install claude-code --project .
memi agent install cursor --project .
memi agent install grok-build --project .

{
  "mcpServers": {
    "memoire": {
      "command": "memi",
      "args": ["mcp", "start", "--no-figma"]
    }
  }
}

Codex 插件市场：

codex plugin marketplace add memi-design/memi --ref main --sparse .agents/plugins --sparse plugins/memoire

Agent 技术栈指南 · 复制粘贴示例 · 完整技能路由器

信任与验证

• 发布门禁 — 软件包、来源证明、全新安装、MCP、插件、二进制文件和公开接口检查。
• 当前发布信息 — CLI、Studio 和网站的公开版本。
• 可复现案例研究 — 固定的证据、弃答记录和配对协议。
• 依赖项信任台账 — 直接依赖项的用途、动态边界和审核政策。
• Trust Core 索引 — 2.8 beta 的默认锁定约定和证据状态。
• 威胁模型和外发流量图 — 受保护资产、副作用边界和目标位置。
• 数据保留和卸载/恢复 — 可能保留的数据以及如何保留状态。
• 依赖项/许可证审核和支持的平台 — 制品和沙箱门禁。
• 雇主审核材料 — 与制品绑定的审批清单；内部使用须获得雇主书面批准。
• 已知限制和发布信息 — beta 与稳定版的表述以及待补充的证据。
• 组织兼容性 — 同级接口，包括独立设置门禁的 Studio 和 Canvas。
• llms.txt — 精简的机器可读产品概览。

首次确定性审计无需上传源文件或遥测数据。连接集成会扩大边界，因此需要明确审核。Memi 也没有 npm 安装时生命周期脚本，提供 agent-kit --dry-run --json，不可变地固定 Action，并在 NOTICE 中说明第三方边界。

社区

欢迎贡献。有关配置和拉取请求指南，请参阅 CONTRIBUTING.md。请通过 issues 提交错误报告和功能请求；问题和真实项目报告请发布在 Discussions。

有助于项目的贡献包括可复现的审计夹具、框架适配器、技能改进、无障碍 UI 案例、动效检查以及前后对比报告。

许可证

Studio 界面参考和改编组件包含 Hermes WebUI，以及围绕 warpui_core 和 warpui 的 MIT Warp UI 框架边界；Warp 的 AGPL 应用程序代码和客户端代码未复制到 Memi 中。

MIT。有关可选适配器和完整的第三方署名，请参阅 NOTICE。