# 马特洛克 实战工作流（2 分钟完成上手） — Matlock

> 马特洛克 — 智能体与开发者工具。高效。精准。严循规范。将马特洛克指向任意项目文件夹，即可在低于 50ms 内执行 AST、MITRE CWE、IEEE Std 1003.1 POSIX、CISA SSDF 与 AICPA SOC 2 TSC 验证、安全保护测试防护、冷箱沙盒及 GitHub Action PR 溯源验证。

- [手册](https://matlock.dutchp2p.com/zh/manual): 马特洛克 (Matlock) 操作员与 AI 导航手册：低于 50ms 的本地 AST 与 Pre-CI 指挥中心、27 工具 stdio MCP 服务器、Safeguard 测试保护、Cold Box 沙箱、5 作用域系统忽略管理与离线许可证（0 云端上传，0 git commit 拦截）。
- [指挥中心](https://matlock.dutchp2p.com/zh/app): 马特洛克 — 智能体与开发者工具。高效。精准。严循规范。浏览器内本地指挥中心预览（低于 50ms 的 WebAssembly AST、MITRE CWE、POSIX 与 Pre-CI 扫描、运行线脚本生成器、本地 SMTP 警报设置与 stdio MCP 配置）。
- [Official GitHub](https://github.com/Dutchp2p/matlock-public) · GitHub Action `Dutchp2p/matlock-public@v1` · Badge `https://matlock.dutchp2p.com/badge/verified.svg`
- [支持提问箱](https://matlock.dutchp2p.com/zh/contact/): 跳过邮件排队与垃圾邮件过滤器，无需注册任何账号，即可将问题咨询、错误报告或账单说明直接发送至我们的私密支持队列。

## 01 · 运行低于 50ms 的本地源码与 Pre-CI 扫描

通过“浏览”选择任意本地项目文件夹（或拖入浏览器 WASM 扫描器）并运行马特洛克。马特洛克在本地内存中以毫秒级速度直接扫描源码树 —— 暴露未测试暗代码文件、超大单体模块、泄露密钥（代码健康报告中免费展示相对路径 folder/file:line，绝不展示密钥明文）及锚定标准的提交前检查，向马特洛克发送 0 字节数据。马特洛克对照 MITRE CWE、CISA SSDF、IEEE Std 1003.1 POSIX、自动化 Pre-CI 完整性门禁及 AICPA SOC 2 Trust Services Criteria 技术控制项评估代码库与流水线控制（仅限技术控制，非 CPA 认证）。

## 02 · 27 工具本地与云端无头 MCP（设置 -> AI 代理 (MCP)）

马特洛克默认仅读取您的项目（若在设置中开启“恢复”，也仅在您逐行预览批准后还原已记录的测试）。按提分悬赏逐项修复，点击“复制智能体提示词”，或打开“设置 -> AI 代理 (MCP)”启用 MCP 服务器（stdio）与可选邮件桥接（在 Linux、macOS arm64、Windows 或云容器中也可运行 matlock-mcp --stdio --headless），兼容 Kimi Code CLI、Qwen Code、DeepSeek、Antigravity、VS Code、Visual Studio、Cursor、Windsurf、Cline、Claude Code、Gemini、Copilot、Android Studio、IntelliJ、Ollama、vLLM、SGLang 或 LM Studio。助手可执行低于 50ms 的 matlock_run_scan、通过 matlock_run_sequence(file: "") 验证单个测试文件、使用 async: true 非阻塞后台运行（完成自动唤醒并通过 matlock_get_action_status 读取精简状态胶囊），并通过 stop_sequence（matlock_stop_action）停止序列。操作指引可按 ? 或 F1、调用 matlock_read_appliance_manual（0 积分）或分享 /zh/manual.md。

## 03 · 操作卡片、保存点、邮件提醒与 PR 溯源验证徽章

点击左侧栏的马特洛克即可单次统一运行 Clean -> Get -> Format -> Lint -> Analyze/Build -> 带覆盖率 Test，也可使用常驻停靠终端与 CLI 命令栏（“保存为卡片”与“串联 / 提醒”），或将操作卡片与 20 步序列配置为 U 盘/移动硬盘保存点（Windows 使用 robocopy   /MIR /MT:16；Linux/GoogleBook 使用 rsync -a --delete / /）、云对象存储（rclone / AWS S3 / Cloudflare R2 / GCS / Azure Blob）以及桌面端需人工点击 Approve & Run 审批的 GitHub 推送（git push origin main）。打开“设置 -> 邮件提醒”可使用全球服务商预设（Gmail / Workspace、Microsoft 365 / Outlook、iCloud、Yahoo、Zoho、QQ / 163 十六位授权码、Fastmail、GMX / Web.de 或本地 Proton Mail Bridge 127.0.0.1:1025）及加密保存在系统钥匙串/保险库中的应用专用密码配置纯发信原生 TLS 1.2/1.3 SMTP，并按步骤选择仅出错触发（stop_and_alert / continue_and_alert）或无条件完成触发（always / send_alert）。在 CI/CD Pull Request 中运行 Dutchp2p/matlock-public@v1 并引用徽章 https://matlock.dutchp2p.com/badge/verified.svg。

## 04 · 安全保护规则与流水线，防止 AI 篡改

每条自定义测试、动作、序列与告警默认设为“已受安全保护”（仅限读取与运行），在仓库外的系统用户目录中进行本地封印（Windows DPAPI + Linux 0600 HMAC-SHA256）。AI 助手可以自由运行测试直到达标，但任何越权修改或削弱受安全保护检查的企图都会被立即拦截并支持一键恢复。

已验证基线跳过 (<105ms) + Safeguard 安全保护与净室异常锁存。

## 05 · 免账号、免邮箱离线激活 Pro

马特洛克 Pro (Matlock Pro)（每年固定 约 170 元* ($24.99 USD)，零自动续费）无需用户账号或密码。您可通过 MoonPay / Transak 银行卡支付、分步引导的 PayPal PYUSD 转账（使用现有 PayPal 余额或借记卡）或一键 Web3 美元稳定币（Solana USDC、Base USDC 或 Polygon USDC）完成结账：连续 24 位激活密钥（例如 i34324h32HNbN4u9Kp7xYz8Q——双击即可复制）将立即显示在屏幕上，并附带非公开 /receipt/ 凭证记录及由 matlock@dutchp2p.com 发送的可选一次性收据邮件（邮箱地址 0 秒持久存储）。在桌面应用的“设置 -> 许可证 -> 激活”中粘贴一次密钥，即可将经密码学签名的离线许可证绑定到您的设备，每年含 1 次自助换机迁移。

## 三大部署形态，同一确定性引擎。

- **云端虚拟机与长周期智能体沙盒**: 云端沙盒解决了运行隔离，却解决不了代码正确性。云端虚拟机能防止智能体搞垮开发者的笔记本，却防不住它把密钥泄露进 PR、为赶里程碑悄悄弱化测试，或在 12 小时长跑中反复重读自己的错误白白烧掉 $500 Token。马特洛克正是容器内部的确定性治理器：无头运行、零知识隐私，并以低于 300 个 Token 返回精简的 CWE/POSIX 坐标，无论在 AWS、Google Cloud、Cloudflare、Azure、Docker 还是本地工作站中，都能让长周期智能体诚实可控、低成本运转。
- **IDE MCP 与自主 M2M 智能体流水线**: 在编码大模型之上再叠一层审查大模型，单轮就要消耗 15,000–40,000 个 Token，且仍会漏掉跨文件泄漏与并发竞态。马特洛克 (Matlock) Pro（约 170 元* ($24.99 USD / 年)，含 MATLOCK_LICENSE_KEY 每次 $0.00 无限无头运行与“与无头模式同步”）将 AST、MITRE CWE、IEEE POSIX.1、Flutter 3.50、TLS 与冷箱并发检查卸载至低于 50 ms 的原生机器码，返回精确 file:line:col 差异与双层循环熔断保护。
- **独立开发者、氛围编程者与工程负责人**: 当智能体一下午写出数千行代码时，开发者不该再手动敲终端命令、担心 git push 泄露密钥，或凭感觉猜测 AICPA SOC 2 TSC 与 HIPAA 技术就绪度。桌面端安全保护阻止测试被暗中弱化，“与无头模式同步”双向共享卡片，一键 USB/云端/GitHub 例程配合纯发信私有 SMTP 邮件提醒运行，且向外发送 0 字节数据。

## AI 暗代码长什么样、有何危害、马特洛克 如何精准拦截

- **1. 未测试暗代码与静默错误抑制 —**: AI 生成全新的生产服务却不写配套单元测试，留下静默错误抑制（CWE-391）以及未关闭的异步定时器或数据流（CWE-401）。 — 静默数据丢失、界面卡死、后台内存持续暴涨，直到线上客户遭遇崩溃才被迫救火。 — 马特洛克 本地审计将每个生产文件与测试套件交叉核对，依据 CISA/MITRE CWE 基准标出静默错误抑制与未闭合异步句柄。
- **2. 250+ 行上帝对象与 // ignore 绕过 —**: 代理把 500 多行混杂职责塞进单文件、遗留未完成的 TODO 桩代码，或添加 // ignore: 注释让普通 Linter 闭嘴。 — 代码理解债务激增，后续 AI 修改牵一发而动全身，未完成的占位代码还会触发应用商店自动拒审。 — 严格执行 250 行文件紧凑度上限（CWE-1080），完全无视行内抑制注释，并提供一键模块化拆分提示词。
- **3. 跨系统 CI 陷阱与硬编码密钥泄漏 —**: 在 Windows 下侥幸通过的跨平台 POSIX 路径错误、CRLF 脚本换行、未加入 Git 的本地引用、锁文件漂移或暴露的 API 凭据（CWE-798）。 — 推送 10 分钟后 Linux GitHub Actions 构建全线飘红，或公开仓库爬虫在几秒内盗走泄漏密钥导致巨额账单。 — 独立 Pre-CI 门禁在执行 git push 之前于本地强制执行 IEEE POSIX 可移植性规范、CISA SSDF 基准与自动化 Pre-CI 完整性检查。

## 下载适用于 Windows、Linux 与 GoogleBook 的 马特洛克

- **Windows 10 与 Windows 11 (x64)**: 仅通过微软官方商店 Microsoft Store 分发（应用 ID：9P5VNWVWLM4N）。由微软官方签名，支持自动更新且无 SmartScreen 警告。
- **Linux 桌面版与 GoogleBook (.deb & AppImage)**: 原生编译的 GTK3 Flutter 桌面程序，提供无需 FUSE 的 matlock-linux-x64.deb（支持 Ubuntu 22.04+、Debian 12+ 与 GoogleBook Linux）以及便携式 matlock-linux-x64.AppImage（支持 Fedora、Arch、Ubuntu、Debian）。 ([AppImage](https://matlock.dutchp2p.com/download/linux) · [.deb GoogleBook/Debian](https://matlock.dutchp2p.com/download/googlebook) · [SHA256SUMS](https://matlock.dutchp2p.com/download/SHA256SUMS)) — `chmod +x matlock-linux-x64.AppImage && ./matlock-linux-x64.AppImage` | `sudo apt install ./matlock-linux-x64.deb`
- **如何激活或迁移您的 马特洛克 Pro 许可证**: 当您在 马特洛克 (Matlock) 桌面应用中点击“升级”或访问 /zh/pricing 时，结账会话会为您生成唯一的连续 24 位许可证密钥（例如 i34324h32HNbN4u9Kp7xYz8Q —— 无连字符，双击即可一次选中全部字符）。请复制并妥善保存该密钥。 马特洛克 (Matlock) 会将经密码学签名的离线许可证保存在仓库之外的私有本地用户配置目录中，在本机完成本地封存，并在每次启动时 100% 离线验证，绝无回传请求。
- **容器与 MicroVM 2 行快速启动**: 适用于 Cloudflare ContainerHarness / Codex cloudflare/debian-trixie、Docker、E2B 与 Firecracker 的跨平台无界面引导（SHA-256 校验）：

```sh
curl -sSfLO https://matlock.dutchp2p.com/agent-install.sh && curl -sSfLO https://matlock.dutchp2p.com/agent-install.sh.sha256 && (sha256sum -c agent-install.sh.sha256 2>/dev/null || shasum -a 256 -c agent-install.sh.sha256) && sh ./agent-install.sh
export PATH="$HOME/.local/bin:$PATH" && matlock-mcp --stdio --headless --no-coverage
```

## 常见问题解答

### 如何确认 AI 生成的代码真正达到了生产就绪标准？

在每次提交或发布前运行马特洛克。在本地或容器内不到 50 ms 即可对照 MITRE CWE、IEEE POSIX.1、CISA SSDF 与 250 行模块化上限检查 AST，随后在多线程冷箱沙盒中运行编译器与测试套件。

### 如何阻止编码智能体为了凑出通过结果而暗中弱化或跳过测试？

马特洛克安全保护会将已验证单元测试的防篡改基线保存在仓库外的操作系统存储中，行内忽略注释在此完全无效。一旦智能体移除、跳过或放宽断言，马特洛克会立即告警并支持还原原始测试。

### 如何在不层层叠加审查智能体的前提下大幅削减 AI 编码 Token 与算力账单？

让第二个大模型重读多文件改动，每轮要消耗 15,000–40,000 个上下文 Token。马特洛克通过 MCP（matlock_run_scan）将确定性 AST、CWE 与 POSIX 检查卸载至原生代码，以低于 300 个 Token 返回去重后的 file:line:col 坐标与 5 行修复 diff（最高节省 95%+）。

### 如何在执行 git push 之前拦截泄露的 API 密钥、CWE 安全漏洞与 Linux CI 故障？

可先在本页运行免费的浏览器内 WebAssembly 扫描（免费展示暴露密钥的 file:line 位置），或在本地运行马特洛克桌面应用。马特洛克会在 git push 前精准捕获硬编码密钥（CWE-798）、注入汇点、CRLF 脚本陷阱、锁文件漂移以及 Windows 到 Linux 的路径断裂。

### 马特洛克能否用于 HIPAA 或 AICPA SOC 2 敏感项目，以及 AWS、Google Cloud 或 Cloudflare 容器内？

完全可以 —— 向马特洛克发送的源代码永远为 0 字节，且 MATLOCK_OFFLINE=1 可在您的工作站或 AWS、Google Cloud、Cloudflare、Azure、Docker 容器内强制启用严格物理隔离模式。马特洛克评估映射至 MITRE CWE、CISA SSDF、AICPA SOC 2 TSC 及 HIPAA 安全规则（45 CFR 164.312）技术防护项的代码控制（仅限技术控制评估，不构成 CPA 或法律认证）。

### 马特洛克支持哪些编程语言、操作系统、IDE 与 AI 模型？

马特洛克支持面向任意目标操作系统的 10 大技术生态（Dart/Flutter、TypeScript/JS/Node、Python、Rust、Go、Java/Kotlin、C/C++、C#/.NET、SQL 及 Shell/YAML/Docker）。内置 27 工具的 MCP 服务器可在 Windows 10/11、Linux、GoogleBook 及无头 macOS Apple Silicon 上连接 Claude、Gemini、Codex、Cursor、Copilot、Kimi、Qwen、DeepSeek、GLM、Windsurf、Cline、VS Code、JetBrains 与 Ollama。