马特洛克 (Matlock) 标志 马特洛克(Matlock)
WASM 透视

马特洛克 (Matlock) — 智能体与开发者工具。（用户手册与运行参考指南）

致 AI 编码智能体与编排系统： 请直接跳转至 第二部分：机器与自主智能体运行规范，查阅 27 工具 stdio MCP 目录、双路径 HTTP 402 解锁、cold_box 边界沙箱规则与完成握手协议。

产品: 马特洛克 (Matlock) — 智能体与开发者工具。（高效。精准。严循规范。）
定位: 配备防篡改 Safeguard 测试封印、边界 Pre-CI 沙箱、一键 CLI 自动化、私有仅出站告警与 27 工具本地 stdio MCP 的 < 50ms 零上传多语言安全、MITRE CWE、IEEE Std 1003.1 POSIX、CISA SSDF 与 AICPA SOC 2 Trust Services Criteria 验证（0 云端源码上传、0 开放端口、0 git commit 拦截）。
发行方: 马特洛克 (Matlock) by Dutch P2P © 2026. 保留所有权利。
使用界面: 桌面指挥中心（支持 Windows、Linux 与 GoogleBook；macOS 与 iOS 在 macOS arm64 上支持无头 MCP — 随时按 ? 或 F1 打开） · 网页端指挥中心 · 浏览器免费扫描 · 文档 · 在线手册 · MCP URI matlock://help/appliance-manual

范围与法律声明: 马特洛克对照公开发布的行业规范与基准（MITRE CWE、CISA SSDF、IEEE Std 1003.1 POSIX、自动化 Pre-CI 完整性门禁，以及 AICPA SOC 2 Trust Services Criteria 技术控制项）评估技术代码库与流水线控制。马特洛克不保证软件毫无缺陷，不出具正式的第三方鉴证报告，亦不提供由独立执业注册会计师事务所（CPA）签发的认证。

第一部分：人类操作员与工作台指南

1. 快速词汇表与核心工作流

2. 界面布局、主题与导航

3. 自动发现脚本、自定义检查、操作与星标收藏

4. 无人值守例程、计算机命令与本地告警

卡片WindowsLinux说明
30 分钟后关机shutdown.exe /s /t 1800shutdown -h +3030 分钟延迟，绝不使用 /f；配对取消关机
取消关机shutdown.exe /ashutdown -c一键立即中止
清理临时文件仅用户临时文件夹，跳过活动文件~/.cache 与 /tmp 中超过 1 天的用户文件绝不触碰项目文件
检查磁盘空间Get-PSDrive -PSProvider FileSystemdf -h只读
优化磁盘（整理或 trim）Optimize-Volume -DriveLetter C -Verbosefstrim -av需管理员/root 权限；无 UAC/sudo 弹窗静默停止
备份副本robocopy . "<backup-folder>" /MIRrsync -a --delete ./ "<backup-folder>/"保留 .git，跳过构建缓存；robocopy 0–7 = 通过
查找词语并列出findstr /s /i /m /c:"Aluminium" *.dartgrep -rnI "Aluminium" --include="*.dart" .可编辑的不区分大小写递归搜索
捕获超过 250 行文件for /r %i in (*.dart) do ... find /c /v ""find . -name "*.dart" -exec awk '... c>250 ...' {} +只读扫描，列出超过 250 行的文件

5. 结果瀑布流、单分类重跑、忽略与复制给智能体

6. 粘性防篡改 Safeguard、测试完整性与恢复

7. 水平健康分、覆盖率进度条与模块化标准

8. 双栏设置与封签状态恢复

点击右上角 设置 打开双栏对话框（左侧分类栏 + 简洁右侧控件；每个面板标题均带 ? 图标可直达对应手册章节）：

  1. 外观：语言（9 种语言 + 复制文本语言）、主题（跟随系统、浅色、深色板岩）、桌面快捷方式，以及 Windows 关闭时最小化到系统托盘。
  2. 项目与运行器：模块化调节盘（Grade A..Minimum）、本地配置 打开文件夹（私有本地用户配置文件夹）、恢复初始设置横幅（重新打开一键为我配置）、保留快速运行历史 与 重置忽略注册表。
  3. Safeguard 与恢复：允许马特洛克恢复测试、仅限人工的 Safeguard 自动回滚开关，以及 在我的电脑之间同步（通行短语封签文件夹同步）。
  4. 邮件告警：本地仅出站邮件与自定义脚本告警站 + 测试邮件。
  5. AI 代理 (MCP)：MCP 服务器 (stdio) 开关（默认关闭）、“与无头模式同步” 双向桥接（一键刷新加载智能体创建的卡片/序列并双向发布现行指令，0 后台轮询）、测试 MCP 连接、复制 MCP 配置与智能体指令、为我的手机 AI 复制一个问题 与 智能体邮件桥接。
  6. 许可证与更新：24 位密钥 激活 / 将许可证迁移到此设备、自动检查更新（MATLOCK_OFFLINE=1 拦截一切对外请求）、发送匿名崩溃诊断（默认关闭；MATLOCK_NO_TELEMETRY=1）、复制诊断信息、释放内存、分享马特洛克、联系我们（dutch@dutchp2p.com）与 Dutch P2P 工具。
  7. 封签状态恢复（重置忽略注册表）：若外部篡改触发 integrity_seal:MUTE_SEAL_TAMPERED 或 storage_recovery:BAK_AUTO_RESTORE，请打开 设置 -> 项目与运行器 -> 存储与备份 -> 重置忽略注册表。

9. 连接 AI 智能体（桌面端 MCP 与手机/对话指南）

{
  "mcpServers": {
    "matlock": {
      "command": "matlock.exe",
      "args": ["mcp", "--stdio"]
    }
  }
}

10. 内置标准参考（10 大生态 + Pre-CI）

每项内置检查均已编译进马特洛克，并锚定于 MITRE CWE、CISA SSDF（NIST SP 800-218）、IEEE Std 1003.1 POSIX、Pre-CI 门禁与 AICPA SOC 2 Trust Services Criteria 技术控制项：

生态与领域马特洛克检查内容与防止的生产事故
核心多语言与 Dart / Flutter静默 catch 块（CWE-391）、空/越界隐患（CWE-476/CWE-125）、未 await 异步竞态、泄漏流/定时器/控制器（CWE-401）、死循环重试（CWE-835）、硬编码密钥（CWE-798）、未脱敏日志凭据（CWE-532）、跨 HTTP/SMTP/CLI/CI 禁用 TLS 证书校验（CWE-295 / [MITRE T1557]）、SQL 注入（CWE-89）、SSRF（CWE-918）、XXE（CWE-611）、未签名 JWT（CWE-347）、开放重定向（CWE-601）、缺失超时、非原子写入、路径遍历（CWE-22）及空洞/不稳定测试（CWE-362）。
Java (.java)硬编码密钥（CWE-798）、命令/SQL 注入（CWE-78/CWE-89）、不安全反序列化（CWE-502）、弱加密（CWE-327）、被吞掉的异常（CWE-391）、泄漏 JDBC/流句柄（CWE-404）、字符串 == 缺陷、粗暴 System.exit 及循环内休眠。
Python (.py)硬编码密钥（CWE-798）、Shell/SQL 注入（CWE-78/CWE-89）、不安全 pickle/yaml 加载（CWE-502）、弱哈希（CWE-328）、裸 except（CWE-391）、可变默认参数、泄漏描述符（CWE-775）、async def 内的同步调用及空洞测试。
Rust (.rs)嵌入式密钥（CWE-798）、格式化 Shell/SQL 字符串（CWE-78/CWE-89）、未加护 unsafe 转换、禁用 TLS 检查（CWE-295）、生产 .unwrap()/todo!() 恐慌、异步任务阻塞休眠、刻意泄漏（CWE-401）、丢弃 Result 及空洞测试。
Go (.go)硬编码令牌（CWE-798）、拼接 exec/SQL（CWE-78/CWE-89）、InsecureSkipVerify（CWE-295）、弱随机数（CWE-330）、忽略错误（CWE-252）、循环内 defer 泄漏与未取消上下文（CWE-404）、缺失 HTTP 超时、生产 panic 及空洞测试。
TypeScript 与 JavaScript (.ts、.tsx、.js、.jsx)暴露密钥（CWE-798）、DOM XSS / eval 注入点（CWE-79/CWE-95）、Shell 字符串插值（CWE-78）、原型链污染（CWE-1321）、空 .catch()（CWE-391）、类型抑制、NaN 比较缺陷、同步 I/O 卡顿、残留 debugger 及监听器/定时器泄漏（CWE-401）。
C 与 C++ (.c、.cpp、.cc、.h、.hpp)硬编码密钥（CWE-798）、未加护 FFI/缓冲区拷贝（CWE-787/CWE-120）、格式化字符串漏洞（CWE-134）、system() 注入（CWE-78）、new[]/delete 失配（CWE-762）、释放后重用（CWE-416）、抛异常析构函数、对非平凡类型使用 memset 及未 join 线程。
Kotlin 与 Android (.kt、.kts)硬编码密钥（CWE-798）、SQL 拼接（CWE-89）、不安全 WebView 桥接、绕过 TLS（CWE-295）、全局可读首选项（CWE-276）、泄漏 GlobalScope 协程（CWE-401）、主线程卡顿、!! 崩溃、吞掉 CancellationException 及 ZIP/APK 头整数溢出风险（CWE-190）。
C# 与 .NET (.cs)未释放 IDisposable 句柄（CWE-404）、async void 崩溃陷阱、未参数化 SQL/命令字符串（CWE-89/CWE-78）、禁用 ServerCertificateCustomValidationCallback TLS 校验（CWE-295）、被吞异常（CWE-391）、同步 .Result/.Wait() 死锁及空洞测试。
SQL 与存储引擎 (.sql)通配符授权（CWE-250）、动态 SQL 拼接（CWE-89）、DDL 明文密码（CWE-256）、系统 Shell 逃逸存储过程（CWE-78）、禁用 RLS、无条件 DELETE/UPDATE、非幂等迁移、深层 OFFSET 扫描及无保护表锁。
跨系统 Pre-CI、Bash/Shell (.sh)、PowerShell (.ps1)、Dockerfile 与 GitHub Actions YAML大小写路径冲突（POSIX.1）、CRLF shebang、Bash/POSIX 语法不兼容与 PowerShell $ErrorActionPreference / LASTEXITCODE 陷阱、未固定 Dockerfile 标签与 root 容器风险、HTML/资源字节预算超支、Windows 裸 .cmd/.bat 启动陷阱、泄漏句柄与非整树终止（CWE-775）、硬编码路径分隔符、未追踪导入、锁文件漂移、GitHub Actions YAML 过宽权限、工作流脚本注入与丢失 +x 权限位。
模块化与自定义检查仅限人工的模块化调节盘（Grade A <= 60 至 Minimum <= 1000，默认 Grade C <= 250 文件 / <= 80 函数；CWE-1080 / CWE-1120）外加保存在系统配置中的用户自定义模式与脚本检查。

11. 工作站 Pro 许可、网页预览与免费浏览器扫描

12. Linux、GoogleBook、更新、隐私与支持

第二部分：机器与自主智能体运行规范

A. 智能体入口与传输配置

{
  "mcpServers": {
    "matlock": {
      "command": "matlock-mcp",
      "args": ["--stdio", "--headless", "--no-coverage"]
    }
  }
}

B. 计量计费、M2M 集群接入与 Pro 解锁

C. 完整 27 工具本地 MCP 目录

  1. matlock_run_scan(target_path?, changed_only?, dedup_by_rule?, if_none_match?, agent_id?, rule_id?, category?, pillar?, file_filter?, include_generated?, compact?, cursor?, rule_code?, transaction_signature?)：Index 0（readOnlyHint: true）< 50ms AST、CWE、POSIX 与 Pre-CI 扫描，返回 file:line:col（col >= 1）、cwe、mitre_attack 与 5 行统一 diff 修复处方（同时支持 CLI matlock-mcp scan . --format=sarif 导出 SARIF 2.1.0）。
  2. matlock_describe_project(target_path?, mode?)：可选工作区画像（0 积分，readOnlyHint: true）；传入 mode: "tool_bag"（或 CLI matlock-mcp toolbag [--json]）获取 ~350–550 Token 的渐进式清单，列出 [LOCKED]（仅执行）与 [MODIFIABLE]（智能体可优化）操作卡、序列、[NEW] / [UPDATED] 徽章、[UNAVAILABLE IN CONTAINER] 标记、现行指令与出站告警就绪状态。
  3. matlock_get_scan_results(target_path?, cursor?, pillar?, rule_code?)：分页获取发现项（25/页；桌面端在解锁前隐藏 Safeguard 受保护行；--headless 燃料舱解锁坐标）。
  4. matlock_qualify_test(file | files, target_path?, dry_run?, baseline_only?, wait_if_busy?, max_wait_seconds?)：通过 3 道门禁（运行时通过且 >= 1 条断言、0 分析器警告 + 行数上限、0 马特洛克发现项）校验 1–5 个测试文件（test_file / test_files）后再封签入 Safeguard，或仅封签基线（baseline_only: true）。
  5. matlock_get_test_integrity(target_path?, reverify?, include_archive?, id?, include_text?, note_for_id?, note?)：检查已移除测试完整性记录并附加智能体解释备注（0 关闭权限）。
  6. matlock_get_history(target_path?, limit?)：只读历史评分与修复次数。
  7. matlock_read_appliance_manual(section_id?, standard_id?, query?, locale?)：离线手册（9 种语言）及 CWE/POSIX/SSDF/SOC2/结果码查询（0 积分，0 网络）。
  8. matlock_list_custom_tests：列出用户自定义检查。
  9. matlock_register_custom_test：保存模式或脚本自定义检查。
  10. matlock_delete_custom_test：删除未锁定的自定义检查（内置检查不可变）。
  11. matlock_list_actions：列出操作卡（含 favorite/锁定/批准标记）及未配置的 recommendedTemplates（unconfiguredTemplate: true）。
  12. matlock_register_action(id, command, name?, favorite?)：编程或更新未锁定操作或初始模板（tpl_github、tpl_save_drive、tpl_cloud_sync、tpl_save_backup、tpl_defrag_optimize、tpl_shut_down），清除 unconfiguredTemplate，固定/取消收藏（favorite: true | false），并在桌面端强制开启需要批准。
  13. matlock_register_sealed_script：将构建/测试命令封签（由用户锁定）以防子智能体篡改。
  14. matlock_run_action(id, working_dir?, async?, send_alert?, cold_box?)：在系统作业树隔离下执行沙箱命令（async: true 非阻塞后台执行，send_alert: "always" | "on_error" | "never"，支持自定义 git push / USB robocopy/rsync / 云 R2/S3/GCS/Azure 卡片；Matlock 测试运行内置 0 次 git push）。
  15. matlock_get_action_status(id?)：轮询 async: true 后台运行的实时状态、退出码与紧凑精简状态胶囊。
  16. matlock_stop_action(id?, stop_sequence?)：立即终止活动进程树（stop_sequence: true 干净中止整个运行中序列）。
  17. matlock_delete_action：删除未锁定的操作卡。
  18. matlock_list_sequences：列出多步骤例程。
  19. matlock_register_sequence(id, name?, step_ids?, commands?, insert_step_id?, insert_command?, insert_step_name?, insert_at_index?, remove_step_index?, failure_policy?, always_run?, favorite?)：串联编排或修改未锁定序列，在从 0 开始的精确 insert_at_index 位置插入任意操作或 alert::<id> 步骤，配置 failure_policy（"stop" | "stop_and_alert" | "continue_and_alert"）、always_run 与 favorite: true | false。
  20. matlock_run_sequence(id, file?, async?, send_alert?, cold_box?, deep?, include_coverage?)：运行 seq_matlock 或 seq_fast_verify（传入 file 运行单个测试文件、async: true 非阻塞后台运行并在完成时自动唤醒、send_alert 发送错误/完成通知；默认 cold_box: false 保证冲刺速度；在外部保存、云同步、备份、推送或编译前传 cold_box: true 启用边界沙箱，已验证未变更时 < 15ms 即返回并以 < 300 坐标 Token 替代 15,000–40,000 人工检查 Token；deep: true 强制完整清理与覆盖率重算）。
  21. matlock_delete_sequence：删除未锁定的例程。
  22. matlock_list_alerts：列出本地告警通道（密钥已屏蔽）。
  23. matlock_set_alert：配置仅出站原生 Dart TLS 1.2/1.3 email_smtp（全局预设、系统钥匙串或通行短语封签本地容器保险库）或 custom_script 告警。
  24. matlock_trigger_alert(id, status, task_completed, uncovered_issues, next_move)：触发本地通知并强制附带 3 问交接内容。
  25. matlock_delete_alert：删除未锁定的告警卡。
  26. matlock_purchase_license(transaction_signature?, license_key?, target_path?, network?, runs?, lid?)：结算自主智能体集群按量额度（详见 /zh/agents）或认领每年约 170 元* ($24.99 USD/yr) 的 24 位 Pro license_key。
  27. matlock_report_issue(category, subject, description, tool_context?, output_dump?)：异步脱敏反馈/愿望单报告（0 积分，CONTINUE_IMMEDIATELY）。

D. 边界 Cold Box 沙箱、3 次循环熔断与 3 问交接协议

E. 面向 AI 编码智能体的机器可读规范 (YAML)

product: "Matlock — Agent & Developer Tools. (Efficient. Exact. By the book.)"
pinned_version: "v1.0.0+1"
web_command_center: "https://matlock.dutchp2p.com/zh/app"
free_local_scan: "https://matlock.dutchp2p.com/zh/#wasm-instant-audit"
docs_hub: "https://matlock.dutchp2p.com/zh/docs"
online_manual: "https://matlock.dutchp2p.com/zh/manual"
public_repository: "https://github.com/Dutchp2p/matlock-public"
online_operational_map: "https://matlock.dutchp2p.com/llms.txt"
mcp_resource_uri: "matlock://help/appliance-manual"
mcp_stdio_command: "npx -y @dutchp2p/matlock-mcp | uvx matlock-mcp | matlock.exe mcp --stdio (Windows) | matlock mcp --stdio (.deb) or /path/to/matlock-linux-x64.AppImage mcp --stdio (Linux & GoogleBook) | matlock-mcp --stdio --headless --no-coverage (Linux x64, Windows x64 & macOS arm64)"
network_ports: 0
git_hooks_installed: 0
builtin_git_push_in_test_runs: false
custom_push_deploy_actions_allowed: true
mcp_tools_count: 27
primary_pipeline:
  card: "Matlock"
  sequence_id: "seq_matlock"
  entry_tool_index_0: "matlock_run_scan"
  badge_svg_url: "https://matlock.dutchp2p.com/badge/verified.svg"
  stages: "Clean -> Get -> Format -> Lint -> Analyze/Compile -> Test -> Coverage (depth 0..2)"
  cold_box_default: false
  cold_box_boundary_triggers: ["before external git push", "before cloud-drive save", "before removable backup", "before release compile"]
modularity_tuning_dial:
  person_only_sealed_os_settings: true
  default_tier: "Grade C (<= 250 / <= 80 fn)"
  tiers: ["Grade A (<= 60 / <= 25 fn)", "Grade B (<= 100 / <= 40 fn)", "Grade C (<= 250 / <= 80 fn)", "Grade D (<= 500 / <= 120 fn)", "Minimum (<= 1000 / <= 250 fn)"]
ignore_scopes_5: ["file:line:code", "file:code", "*:code", "file", "folder/"]
lock_governance:
  safeguarded: "Read & Run Only (auto-reverts unauthorized edits + Envelope tamper alert)"
  unlocked: "AI agent can modify (Read, Write, Modify & Run)"
os_storage:
  scope: "private_user_profile_outside_repo"
  env_override: "MATLOCK_STATE_DIR"

F. 智能体运行原则与执行边界

返回顶部