WASM-first 元测试平台ADR-285 如何用npx homecore连接 RuView Homecore、MCP 与本地 Agent【免费下载链接】RuViewπ RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video.项目地址: https://gitcode.com/GitHub_Trending/wi/RuViewRuView 将商品 WiFi 信号转化为实时空间智能与存在感知而 Homecore 是其中面向原生家庭自动化的 Rust 子系统。随着 Homecore 扩展出并发状态机、自动化引擎、认证 REST/WebSocket 核心、迁移工具、Wasmtime 插件路径与 HAP 服务贡献者需要一个聚焦的入口既能讲清当前能力边界、把用户引导到正确的源码与测试又能在不把 Rust 服务耦合进任何 Agent 框架的前提下安全地暴露给 Claude Code / Codex 等本地 Agent。本文基于 ADR-285docs/adr/ADR-285-homecore-wasm-first-metaharness.md 与其落地实现完整讲解npx homecore元测试平台metaharness的 WASM-first 内核、CLI/MCP 工具面、可信仓库校验、双宿主 Agent 适配器与发布安全门帮助你理解并直接使用这套只读优先的开发者工具。一、决策背景为什么要为 Homecore 单独做一个 harnessADR-285 记录的背景是Homecore 已成为一个多 crate 的 Rust 子系统包含并发状态机、启动恢复、录制器、自动化引擎、与 Home Assistant 兼容的认证 REST/WebSocket 核心、迁移工具、编译内与 Wasmtime 两种插件路径、网络 HAP 服务以及语音/卫星协议契约。实现有意保持有界——多个功能有 feature 门控若干部署依赖外部 provider且核心兼容不等于与整个 Home Assistant 集成生态完全对等。当时仓库已有的ruvnet/ruview贡献者 harness 面向整个 RuView 仓库Homecore 需要自己的聚焦入口ADR 明确了六项诉求讲清当前能力但不夸大成熟度把贡献者引导到正确的源码、ADR 与聚焦测试有意识地演练 Wasmtime 与 HAP 的 feature 门控暴露一个小而完整的 MCP 指引面以最低权限把探索委托给本地的 Claude Code 或 Codex CLI可随时从 Homecore 服务运行时中移除。用户期望的命令精确为npx homecore这里有一个命名冲突npm 包ruvnet/homecore安装后虽然可暴露homecore二进制但npx homecore解析的是不带 scope 的homecore包。由于 ADR-265 通常把新包保留在ruvnetscope 下可执行文件命名必须获得一次显式、狭窄的例外。二、决策要点homecore是执行门面不是第二个 Homecore 运行时ADR-285 的决策是在 harness/homecore/ 创建独立可测的 npm 包包名homecore暴露同名二进制。它只充当可执行文件的前门未来面向 import 的库仍归ruvnet/*。因此本 ADR 仅对 ADR-265 修订这一个可执行包名其余 RuView npm 包继续受 scope 规则约束。关键边界是该包是开发者工具。它可以检视受信任的 RuView checkout、运行固定测试命令但不会启动 Homecore 服务器、改动家庭状态、迁移用户数据、修改配对记录、安装插件或发布变更。这一点在 harness/homecore/README.md 与源码入口中反复被强制。从 package.json 可看到落地的包契约{ name: homecore, version: 0.1.0, type: module, bin: { homecore: bin/cli.js }, exports: { .: ./src/tools.js, ./brain: ./src/brain.js, ./guidance: ./src/guidance.js, ./hosts: ./src/hosts/index.js, ./kernel: ./src/kernel.js }, engines: { node: 20.0.0 }, license: MIT, dependencies: { metaharness/kernel: 0.1.2 } }值得注意的细节dependencies中metaharness/kernel被精确钉在0.1.2无^这与WASM-first 且版本可复现的设计一致engines.node 20意味着安装与运行环境需要 Node 20。实现采用 ESM源码组织为bin/CLI 入口、src/核心逻辑、skills/贡献者剧本、scripts/发布清单工具、brain/corpus/评审过的共享知识库。三、WASM-first 元测试内核优先 WASM、诚实报告、永不重标号ADR-285 的第一个支柱是 WASM-first 内核。语义为精确钉住metaharness/kernel除非操作者用环境变量METAHARNESS_KERNEL_BACKEND显式选择后端否则 harness 先请求包内打包的 WebAssembly 后端。实现位于 src/kernel.js核心逻辑在initializeKernel()L32-L59async function initializeKernel() { const explicit process.env.METAHARNESS_KERNEL_BACKEND; if (explicit) { return Object.freeze({ ...await loadKernel(), homecoreRequestedBackend: explicit }); } process.env.METAHARNESS_KERNEL_BACKEND wasm; try { return Object.freeze({ ...await loadKernel(), homecoreRequestedBackend: wasm }); } catch (wasmError) { delete process.env.METAHARNESS_KERNEL_BACKEND; const fallback await loadKernel(); return Object.freeze({ ...fallback, homecoreRequestedBackend: wasm, wasmFallbackReason: wasmError instanceof Error ? wasmError.message : String(wasmError), }); } finally { /* 恢复环境变量 */ } }可以看到请求 WASM 失败时会允许 native/JavaScript 回退以保证可移植性但回退结果中记录homecoreRequestedBackend: wasm与wasmFallbackReason回退执行永远不会被标称为 WASM。getKernelStatus()L61-L83进一步揭示后端永远如实上报的规则homecore wasm status --strict在 resolved backend 不是 WASM 时判定失败ok: false非 strict 下仅校验 MCP 服务器规范是否通过内核校验状态输出包含preferredBackend: wasm、requestedBackend、resolvedBackend、strict、mcpSpec、mcpValidation与人类可读的note。内核还承担一个验证职责加载后校验 MCP 服务器规范kernel.mcpValidate(JSON.stringify(MCP_SPEC))。MCP_SPEC在 kernel.js L8-L11 中把当前包版本精确写入命令const MCP_SPEC Object.freeze({ name: homecore, command: [npx, -y, ${PKG.name}${PKG.version}, mcp, start], });也就是说生成的 MCP 主机配置调用的是已安装的、精确版本的homecore二进制仓库中没有任何提交的 MCP 配置会执行homecorelatest避免 dist-tag 漂移带来不可复现或意外升级。ADR 特别强调这个内核边界与 Homecore 的应用插件架构是两回事插件架构仍保持四原则native 插件编译进二进制并显式注册外部插件包是有界的、路径校验过的、带签名验证的 WebAssemblyWasmtime 执行通过 Cargo feature 选择启用不加载任意的 native 动态库。落地映射到tools.js的 wasm 验证 profile见下文第四节它只运行带wasmtimefeature 的 Rust crate 测试。四、CLI 命令面把能力 → 源码 → 验证命令串起来二进制入口 bin/cli.js 定义了完整子命令帮助文本见 cli.js L40-L63默认命令为guidance。README 给出的典型用法如下# 带源码引用的概览默认命令 homecore guidance homecore guidance --topic plugins --query Wasmtime signatures homecore capabilities # 诊断包、WASM 内核、本地 CLI 与可选 checkout homecore doctor --repo . homecore wasm status --strict # 在受信任 RuView checkout 中运行聚焦的 Homecore 测试 homecore verify --repo . --profile core homecore verify --repo . --profile wasm homecore verify --repo . --profile hap # 通过本地宿主探索默认都只读 homecore agent run --host codex --repo . --prompt Map startup restore homecore agent run --host claude-code --repo . --prompt Review plugin trust # 启动 stdio MCP 服务器 homecore mcp start # 搜索或验证评审过的共享知识 homecore brain search --query REST WebSocket compatibility homecore brain verify --repo .完整子命令可汇总如下子命令作用关键参数guidance默认命令带源码引用的能力指引--topic、--query、--limit、--repocapabilities能力总览等价于guidance --topic overview--repodoctor检查 Node、WASM 内核、宿主 CLI、Rust 工具链与 checkout 标记--repo、--strict-wasmwasm status上报实际加载的内核后端--strictverify运行固定 Rust 验证 profile--profile core\|wasm\|hap\|full、--repo、--timeout-msbrain search/verify/propose检索/校验/提议共享知识--query、--repo、--id等tools列出 MCP 工具与 schema—skills/skill name列出或打印剧本—mcp start运行 stdio MCP 服务器—install --host codex\|claude-code打印宿主 MCP 配置不修改宿主设置—agent run委托本地 Agent 探索--host、--prompt、--repo、--allow-write、--confirmdoctor在 src/tools.js 的doctor()中会做多项检查Node 大版本 ≥ 20、内核是否成功加载并通过 MCP 规范校验、strict 时 resolved backend 是否确实是wasm、能否解析到受信任 checkout以及cargo/rustc/codex/claude是否在 PATH 上。guidance的主题在 MCP schema 中是受限枚举overview / core / server / api / plugins / integrations / migration / voice / testing查询长度 2–500 字符返回条数上限 20。包内还携带五个可检索的贡献者剧本skills/explore、migrate、operate-server、secure-plugin、verify可通过homecore skills/homecore skill name查看。固定验证 profilecore / wasm / hap / fullverify是唯一会执行仓库代码Cargo 构建产物的功能因此 ADR 规定它只作为本地 CLI 命令存在不通过 MCP 暴露。四个 profile 在 src/tools.js L22-L46 中定义为固定参数数组执行时使用shell: false语义core对v2/Cargo.toml的homecore、homecore-api、homecore-automation、homecore-assist、homecore-recorder、homecore-migrate、homecore-server七个 crate 执行cargo test --no-default-featureswasm分别对homecore-plugins与homecore-server执行cargo test --features wasmtime定向演练 Wasmtime 插件路径hap分别对homecore-hap与homecore-server执行cargo test --features hap-serverfull即 core wasm hap 的顺序组合见commandsForProfiletools.js L175-L180。执行约束同样值得写进你的脚本默认超时 900 000 ms15 分钟可用--timeout-ms覆盖上限 1 800 000 ms子进程输出上限 2 MBmaxOutputBytes: 2_097_152每个命令返回code/stdout/stderr/truncated。runVerification返回的note明确写道通过软件测试只验证所选代码路径不构成部署、生态对等、硬件或认证证据——这正是 ADR 反复强调的诚实标注。五、MCP 工具面默认拒绝、只读、资源有界ADR-285 规定 MCP 服务器只暴露四个工具且全部只读MCP 工具作用输入要点homecore_guidance返回带源码引用的能力指引、验证命令与限制topic(枚举)、query(2–500)、limit(1–20)、repohomecore_wasm_status加载 WASM-first 内核并校验 MCP 规范strict(bool)homecore_doctor检查 Node/内核/宿主/工具链/checkoutrepo、strict_wasmhomecore_memory_search检索评审过的共享知识query(必填2–500)、limit(1–25)实现上 MCP 服务器在 src/mcp-server.js 中自实现协议版本2024-11-05并未依赖重型 SDK。默认拒绝策略在 src/policy.js 中集中定义homecore_guidance/homecore_wasm_status/homecore_doctor/homecore_memory_search为read类且readOnly: true而homecore_verify虽然是已注册工具但被标记为execute、writesBuildArtifacts: true、mcpExposed: false因此在 MCP 上下文中会返回mcp_not_exposed拒绝。authorizeTool还执行validateArguments的 schema 校验未知字段一律拒绝因为 schema 带additionalProperties: false。MCP 的资源有界性可在 mcp-server.js L25-L28 的默认值中看到它们会读取 .harness/mcp-policy.json 并在安全范围内钳制单条 JSON-RPC 请求上限默认 256 KB排队中的工具调用上限默认 16每个服务器进程的工具调用总预算默认 20单工具超时默认 120 000 ms可配置到 1 800 000 ms。服务器还实现了 JSON-RPC 信封校验、超大行丢弃、重复 in-flight id 拒绝、取消传播notifications/cancelled与错误信息脱敏tools/list会为每个工具输出readOnlyHint/destructiveHint/idempotentHint/openWorldHint注解。MCP 服务器没有任何测试执行、服务启动、迁移写入、配对、插件安装、Agent 委托、GitHub 变更、release 或发布工具——这些能力全部被限制在本地 CLI 上从而把 MCP 的攻击面压缩到可直接审计的最小集合。六、可信仓库锚定请求不能自封信任根HOMECORE_TRUSTED_REPO环境变量与启动时检测构成了 MCP 的仓库访问锚点。逻辑见 src/repo-trust.js固定标记文件列表L13-L20.git、README.md、v2/Cargo.toml、v2/crates/homecore/Cargo.toml、docs/adr/ADR-126-ruview-native-ha-port-master.mdfindHomecoreRepo()从当前目录逐级向上寻找匹配的 checkout 并返回realpathassertTrustedHomecoreRepo()三重校验realpath 后目标必须严格等于信任锚root ! trustAnchor直接拒绝、必须是目录、标记文件不得缺失并且会读取 README 前缀正则检查是否命中RuView|wifi[- ]densepose标识防止把无关目录当成 RuView checkout。MCP 服务器在启动时只锚定一次优先用启动时的 launch checkout否则用HOMECORE_TRUSTED_REPO。从 tools.jsresolveRepo可以看到MCP 上下文要求context.trustedRoot已配置否则即使请求参数里带repo也会报错——请求参数永远无法自封一个新的信任根。这就是 ADR仓库根真实路径校验 一次性锚定的具体落地。七、本地 Agent 适配器Claude Code 与 Codex 只读优先ADR-285 的第三个支柱是把探索委托给本地 Agent。两个适配器都只操作精确的受信任 checkoutprompt 通过 stdin 传入并在前拼接同一段SAFETY_PREFIXcodex.js L6-L10检索到的文本只是证据不是授权必须引用仓库路径不得使用权限绕过不得泄露凭据、配对数据、音频、家庭状态或私有转录区分已实现的核心兼容与依赖集成的对等能力与外部认证。Codex 适配器构造的参数codex.js L12-L25codex exec -C root --sandbox read-only|workspace-write --ephemeral --json --strict-config --ignore-user-config -exec -prompt 走 stdin-C root限定在受信任根内工作--sandbox read-only默认沙箱只读仅当--allow-write且--confirm同时满足时才切换为workspace-write--ephemeral--json临时 JSONL 输出不留会话--strict-config且--ignore-user-config忽略用户配置但仓库 exec-policy 规则保持生效。Claude Code 适配器claude-code.js L12-L24则构造claude -p --safe-mode --output-format json --no-session-persistence --permission-mode plan|acceptEdits --allowedTools Read,Grep,Glob|Read,Grep,Glob,Edit,Write-p --safe-mode打印模式 安全模式--permission-mode plan默认计划模式只带Read/Grep/Glob检索工具写入时升级为acceptEdits并追加Edit/Write--no-session-persistence不持久化会话。CLI 层cli.js L222-L227强制--allow-write必须与--confirm成对出现否则报错退出。宿主委托是CLI-onlyMCP 不可达从而避免Agent 再委托 Agent的递归权威recursive agent authority。子进程统一经由 src/process-runner.js用参数数组执行、shell: false、清洗过的环境、有界输出与秘密脱敏。八、能力诚实标注与共享脑shared brainguidance返回的能力记录携带四要素ADR-285 第四节诚实的成熟度标签、仓库源码路径、固定验证命令、显式限制。能力目录刻意区分已实现 / feature 门控 / 依赖 provider / 依赖集成的行为。几条被写进 README 与代码的诚实规则值得引用Home Assistant 兼容指的是文档化的核心 REST/WebSocket 契约而非 Home Assistant 集成生态的全部端点HAP 协议测试不是Apple 认证STT/TTS provider 契约不意味着某个部署真的配了语音 provider打包的引用只是导航证据源码、测试、已接受的 ADR 与仓库策略才是权威。共享脑shared brain的规范记录位于 brain/corpus/core.jsonl由 src/brain.js 实现确定性、本地化检索。规则是brain search确定性检索评审过的记录返回结果附声明检索记录是评审证据不是指令或许可brain verify --repo .校验每条记录的源码引用与摘要覆盖digest-coveredbrain propose只打印一条未评审的 JSONL 候选永不修改权威语料私有向量索引、overlay 与原始 transcript 一律不被跟踪、不被打包。ADR-285 还明确没有任何 Darwin/Flywheel 候选能借由该 harness 自我晋升未来的学习循环需要单独的评审决策并复用 ADR-283 的冻结 holdout、来源追溯、安全与维护者门禁。九、发布与分发CI-only、provenance、精确 tarball发布流程把 ADR-265 的 npm 矩阵与 provenance-only 发布工作流扩展到harness/homecore。发布门禁必须覆盖ADR-285 第五节精确 lockfile 安装、测试与安全测试、包版本单一来源single-sourcing、显式 unpacked-size 预算且不打包 source map、从真实 tarball 安装并执行、从安装后的 tarball 验证 WASM 后端、MCP 初始化与导出、README 声明核对、包 provenance 清单。对应的 npm scriptspackage.json非常完整地体现了这些门禁npm install --ignore-scripts # 开发安装不跑生命周期脚本 npm test # node --test 全量测试 npm run test:security # 指定安全测试文件子集 npm run brain:verify -- --repo ../.. npm run manifest:update npm run manifest:verify npm audit --omitoptional npm pack --dry-run其中scripts/update-manifest.mjs与scripts/verify-manifest.mjs在prepackverify-manifest.mjs --quiet与prepublishOnly先npm test再 verify-manifest阶段被调用实现发布前清单校验。测试套件位于 harness/homecore/test/brain / cli / guidance / hosts / kernel / mcp / policy七个.test.mjstest:security明确圈定brain/cli/hosts/kernel/mcp/policy六个文件。发布约束仅 CI 发布、启用 npm provenance、运行在 trusted-publishing 兼容的 Node/npm 运行时、只接受main分支、使用受保护的npm-release环境且发布的必须是通过了 smoke test 的、digest 校验过的同一个 tarball。环境必须限制只向main部署、要求 review、禁止 self-review。即使开发阶段发现无 scope 包名可用也不能视为永久所有权——发布前仍须确认 registry 访问权限与包身份。README 的明确指引是不要在工作站上发布。十、对宿主进程的影响与边界ConsequencesADR-285 末尾系统整理了影响这些判断也直接写进了实现与文档可作为决策引用正面影响贡献者获得聚焦的npx homecore入口Rust 服务器不耦合任何 Agent 框架WASM 既用于可移植内核又被显式用于 Homecore 插件验证能力指引能区分已实现代码、feature 门控、provider 需求、生态限制与认证边界本地 Agent 执行在 Claude Code 与 Codex 间可移植且默认只读MCP 权威面小到可审计且不包含任何直接的家庭、网络、GitHub 或发布变更。负面影响homecore是对ruvnet/*命名空间的狭窄例外包新增一个精确的 WASM 内核运行时依赖wasm 与 hap 验证 profile 可能耗时且产生 Cargo 构建产物打包的指引目录可能陈旧需要引用校验与评审更新来维持。中性影响harness 不改变 Homecore 的协议、持久化、迁移、插件、HAP 或语音实现软件 profile 通过不构成生产部署、第三方生态对等、Apple 认证或硬件行为证据Ruflo 仍是可选的开发协调器不是homecore的运行时依赖。关联决策链ADR-285 建立在 RuView 一系列已接受的 ADR 之上可按需延伸阅读ADR-126Homecore 主决策native Home Assistant 移植总纲ADR-128插件边界ADR-130REST/WebSocket 契约ADR-133assist 与 Agent 桥ADR-161服务端安全评审ADR-165迁移信任边界ADR-182RuView 元测试平台本 ADR 的直接前身ADR-263harness 加固ADR-265npm 分发策略本 ADR 的唯一修订对象ADR-283共享脑与学习门禁。一句话总结ADR-285 用一个名字不 scope 的homecorenpm 包为 RuView 的 Rust Homecore 栈提供了一个 WASM-first、只读优先、可审计的开发者元测试平台——它在不把服务运行时耦合进 Agent 框架的前提下完成了能力指引、源码导航、定向验证、MCP 工具面与双宿主本地委托的全部职责并把每一次执行都控制在显式、可验证、不越权的边界内。【免费下载链接】RuViewπ RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video.项目地址: https://gitcode.com/GitHub_Trending/wi/RuView创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
WASM-first 元测试平台ADR-285 如何用npx homecore连接 RuView Homecore、MCP 与本地 Agent【免费下载链接】RuViewπ RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video.项目地址: https://gitcode.com/GitHub_Trending/wi/RuViewRuView 将商品 WiFi 信号转化为实时空间智能与存在感知而 Homecore 是其中面向原生家庭自动化的 Rust 子系统。随着 Homecore 扩展出并发状态机、自动化引擎、认证 REST/WebSocket 核心、迁移工具、Wasmtime 插件路径与 HAP 服务贡献者需要一个聚焦的入口既能讲清当前能力边界、把用户引导到正确的源码与测试又能在不把 Rust 服务耦合进任何 Agent 框架的前提下安全地暴露给 Claude Code / Codex 等本地 Agent。本文基于 ADR-285docs/adr/ADR-285-homecore-wasm-first-metaharness.md 与其落地实现完整讲解npx homecore元测试平台metaharness的 WASM-first 内核、CLI/MCP 工具面、可信仓库校验、双宿主 Agent 适配器与发布安全门帮助你理解并直接使用这套只读优先的开发者工具。一、决策背景为什么要为 Homecore 单独做一个 harnessADR-285 记录的背景是Homecore 已成为一个多 crate 的 Rust 子系统包含并发状态机、启动恢复、录制器、自动化引擎、与 Home Assistant 兼容的认证 REST/WebSocket 核心、迁移工具、编译内与 Wasmtime 两种插件路径、网络 HAP 服务以及语音/卫星协议契约。实现有意保持有界——多个功能有 feature 门控若干部署依赖外部 provider且核心兼容不等于与整个 Home Assistant 集成生态完全对等。当时仓库已有的ruvnet/ruview贡献者 harness 面向整个 RuView 仓库Homecore 需要自己的聚焦入口ADR 明确了六项诉求讲清当前能力但不夸大成熟度把贡献者引导到正确的源码、ADR 与聚焦测试有意识地演练 Wasmtime 与 HAP 的 feature 门控暴露一个小而完整的 MCP 指引面以最低权限把探索委托给本地的 Claude Code 或 Codex CLI可随时从 Homecore 服务运行时中移除。用户期望的命令精确为npx homecore这里有一个命名冲突npm 包ruvnet/homecore安装后虽然可暴露homecore二进制但npx homecore解析的是不带 scope 的homecore包。由于 ADR-265 通常把新包保留在ruvnetscope 下可执行文件命名必须获得一次显式、狭窄的例外。二、决策要点homecore是执行门面不是第二个 Homecore 运行时ADR-285 的决策是在 harness/homecore/ 创建独立可测的 npm 包包名homecore暴露同名二进制。它只充当可执行文件的前门未来面向 import 的库仍归ruvnet/*。因此本 ADR 仅对 ADR-265 修订这一个可执行包名其余 RuView npm 包继续受 scope 规则约束。关键边界是该包是开发者工具。它可以检视受信任的 RuView checkout、运行固定测试命令但不会启动 Homecore 服务器、改动家庭状态、迁移用户数据、修改配对记录、安装插件或发布变更。这一点在 harness/homecore/README.md 与源码入口中反复被强制。从 package.json 可看到落地的包契约{ name: homecore, version: 0.1.0, type: module, bin: { homecore: bin/cli.js }, exports: { .: ./src/tools.js, ./brain: ./src/brain.js, ./guidance: ./src/guidance.js, ./hosts: ./src/hosts/index.js, ./kernel: ./src/kernel.js }, engines: { node: 20.0.0 }, license: MIT, dependencies: { metaharness/kernel: 0.1.2 } }值得注意的细节dependencies中metaharness/kernel被精确钉在0.1.2无^这与WASM-first 且版本可复现的设计一致engines.node 20意味着安装与运行环境需要 Node 20。实现采用 ESM源码组织为bin/CLI 入口、src/核心逻辑、skills/贡献者剧本、scripts/发布清单工具、brain/corpus/评审过的共享知识库。三、WASM-first 元测试内核优先 WASM、诚实报告、永不重标号ADR-285 的第一个支柱是 WASM-first 内核。语义为精确钉住metaharness/kernel除非操作者用环境变量METAHARNESS_KERNEL_BACKEND显式选择后端否则 harness 先请求包内打包的 WebAssembly 后端。实现位于 src/kernel.js核心逻辑在initializeKernel()L32-L59async function initializeKernel() { const explicit process.env.METAHARNESS_KERNEL_BACKEND; if (explicit) { return Object.freeze({ ...await loadKernel(), homecoreRequestedBackend: explicit }); } process.env.METAHARNESS_KERNEL_BACKEND wasm; try { return Object.freeze({ ...await loadKernel(), homecoreRequestedBackend: wasm }); } catch (wasmError) { delete process.env.METAHARNESS_KERNEL_BACKEND; const fallback await loadKernel(); return Object.freeze({ ...fallback, homecoreRequestedBackend: wasm, wasmFallbackReason: wasmError instanceof Error ? wasmError.message : String(wasmError), }); } finally { /* 恢复环境变量 */ } }可以看到请求 WASM 失败时会允许 native/JavaScript 回退以保证可移植性但回退结果中记录homecoreRequestedBackend: wasm与wasmFallbackReason回退执行永远不会被标称为 WASM。getKernelStatus()L61-L83进一步揭示后端永远如实上报的规则homecore wasm status --strict在 resolved backend 不是 WASM 时判定失败ok: false非 strict 下仅校验 MCP 服务器规范是否通过内核校验状态输出包含preferredBackend: wasm、requestedBackend、resolvedBackend、strict、mcpSpec、mcpValidation与人类可读的note。内核还承担一个验证职责加载后校验 MCP 服务器规范kernel.mcpValidate(JSON.stringify(MCP_SPEC))。MCP_SPEC在 kernel.js L8-L11 中把当前包版本精确写入命令const MCP_SPEC Object.freeze({ name: homecore, command: [npx, -y, ${PKG.name}${PKG.version}, mcp, start], });也就是说生成的 MCP 主机配置调用的是已安装的、精确版本的homecore二进制仓库中没有任何提交的 MCP 配置会执行homecorelatest避免 dist-tag 漂移带来不可复现或意外升级。ADR 特别强调这个内核边界与 Homecore 的应用插件架构是两回事插件架构仍保持四原则native 插件编译进二进制并显式注册外部插件包是有界的、路径校验过的、带签名验证的 WebAssemblyWasmtime 执行通过 Cargo feature 选择启用不加载任意的 native 动态库。落地映射到tools.js的 wasm 验证 profile见下文第四节它只运行带wasmtimefeature 的 Rust crate 测试。四、CLI 命令面把能力 → 源码 → 验证命令串起来二进制入口 bin/cli.js 定义了完整子命令帮助文本见 cli.js L40-L63默认命令为guidance。README 给出的典型用法如下# 带源码引用的概览默认命令 homecore guidance homecore guidance --topic plugins --query Wasmtime signatures homecore capabilities # 诊断包、WASM 内核、本地 CLI 与可选 checkout homecore doctor --repo . homecore wasm status --strict # 在受信任 RuView checkout 中运行聚焦的 Homecore 测试 homecore verify --repo . --profile core homecore verify --repo . --profile wasm homecore verify --repo . --profile hap # 通过本地宿主探索默认都只读 homecore agent run --host codex --repo . --prompt Map startup restore homecore agent run --host claude-code --repo . --prompt Review plugin trust # 启动 stdio MCP 服务器 homecore mcp start # 搜索或验证评审过的共享知识 homecore brain search --query REST WebSocket compatibility homecore brain verify --repo .完整子命令可汇总如下子命令作用关键参数guidance默认命令带源码引用的能力指引--topic、--query、--limit、--repocapabilities能力总览等价于guidance --topic overview--repodoctor检查 Node、WASM 内核、宿主 CLI、Rust 工具链与 checkout 标记--repo、--strict-wasmwasm status上报实际加载的内核后端--strictverify运行固定 Rust 验证 profile--profile core\|wasm\|hap\|full、--repo、--timeout-msbrain search/verify/propose检索/校验/提议共享知识--query、--repo、--id等tools列出 MCP 工具与 schema—skills/skill name列出或打印剧本—mcp start运行 stdio MCP 服务器—install --host codex\|claude-code打印宿主 MCP 配置不修改宿主设置—agent run委托本地 Agent 探索--host、--prompt、--repo、--allow-write、--confirmdoctor在 src/tools.js 的doctor()中会做多项检查Node 大版本 ≥ 20、内核是否成功加载并通过 MCP 规范校验、strict 时 resolved backend 是否确实是wasm、能否解析到受信任 checkout以及cargo/rustc/codex/claude是否在 PATH 上。guidance的主题在 MCP schema 中是受限枚举overview / core / server / api / plugins / integrations / migration / voice / testing查询长度 2–500 字符返回条数上限 20。包内还携带五个可检索的贡献者剧本skills/explore、migrate、operate-server、secure-plugin、verify可通过homecore skills/homecore skill name查看。固定验证 profilecore / wasm / hap / fullverify是唯一会执行仓库代码Cargo 构建产物的功能因此 ADR 规定它只作为本地 CLI 命令存在不通过 MCP 暴露。四个 profile 在 src/tools.js L22-L46 中定义为固定参数数组执行时使用shell: false语义core对v2/Cargo.toml的homecore、homecore-api、homecore-automation、homecore-assist、homecore-recorder、homecore-migrate、homecore-server七个 crate 执行cargo test --no-default-featureswasm分别对homecore-plugins与homecore-server执行cargo test --features wasmtime定向演练 Wasmtime 插件路径hap分别对homecore-hap与homecore-server执行cargo test --features hap-serverfull即 core wasm hap 的顺序组合见commandsForProfiletools.js L175-L180。执行约束同样值得写进你的脚本默认超时 900 000 ms15 分钟可用--timeout-ms覆盖上限 1 800 000 ms子进程输出上限 2 MBmaxOutputBytes: 2_097_152每个命令返回code/stdout/stderr/truncated。runVerification返回的note明确写道通过软件测试只验证所选代码路径不构成部署、生态对等、硬件或认证证据——这正是 ADR 反复强调的诚实标注。五、MCP 工具面默认拒绝、只读、资源有界ADR-285 规定 MCP 服务器只暴露四个工具且全部只读MCP 工具作用输入要点homecore_guidance返回带源码引用的能力指引、验证命令与限制topic(枚举)、query(2–500)、limit(1–20)、repohomecore_wasm_status加载 WASM-first 内核并校验 MCP 规范strict(bool)homecore_doctor检查 Node/内核/宿主/工具链/checkoutrepo、strict_wasmhomecore_memory_search检索评审过的共享知识query(必填2–500)、limit(1–25)实现上 MCP 服务器在 src/mcp-server.js 中自实现协议版本2024-11-05并未依赖重型 SDK。默认拒绝策略在 src/policy.js 中集中定义homecore_guidance/homecore_wasm_status/homecore_doctor/homecore_memory_search为read类且readOnly: true而homecore_verify虽然是已注册工具但被标记为execute、writesBuildArtifacts: true、mcpExposed: false因此在 MCP 上下文中会返回mcp_not_exposed拒绝。authorizeTool还执行validateArguments的 schema 校验未知字段一律拒绝因为 schema 带additionalProperties: false。MCP 的资源有界性可在 mcp-server.js L25-L28 的默认值中看到它们会读取 .harness/mcp-policy.json 并在安全范围内钳制单条 JSON-RPC 请求上限默认 256 KB排队中的工具调用上限默认 16每个服务器进程的工具调用总预算默认 20单工具超时默认 120 000 ms可配置到 1 800 000 ms。服务器还实现了 JSON-RPC 信封校验、超大行丢弃、重复 in-flight id 拒绝、取消传播notifications/cancelled与错误信息脱敏tools/list会为每个工具输出readOnlyHint/destructiveHint/idempotentHint/openWorldHint注解。MCP 服务器没有任何测试执行、服务启动、迁移写入、配对、插件安装、Agent 委托、GitHub 变更、release 或发布工具——这些能力全部被限制在本地 CLI 上从而把 MCP 的攻击面压缩到可直接审计的最小集合。六、可信仓库锚定请求不能自封信任根HOMECORE_TRUSTED_REPO环境变量与启动时检测构成了 MCP 的仓库访问锚点。逻辑见 src/repo-trust.js固定标记文件列表L13-L20.git、README.md、v2/Cargo.toml、v2/crates/homecore/Cargo.toml、docs/adr/ADR-126-ruview-native-ha-port-master.mdfindHomecoreRepo()从当前目录逐级向上寻找匹配的 checkout 并返回realpathassertTrustedHomecoreRepo()三重校验realpath 后目标必须严格等于信任锚root ! trustAnchor直接拒绝、必须是目录、标记文件不得缺失并且会读取 README 前缀正则检查是否命中RuView|wifi[- ]densepose标识防止把无关目录当成 RuView checkout。MCP 服务器在启动时只锚定一次优先用启动时的 launch checkout否则用HOMECORE_TRUSTED_REPO。从 tools.jsresolveRepo可以看到MCP 上下文要求context.trustedRoot已配置否则即使请求参数里带repo也会报错——请求参数永远无法自封一个新的信任根。这就是 ADR仓库根真实路径校验 一次性锚定的具体落地。七、本地 Agent 适配器Claude Code 与 Codex 只读优先ADR-285 的第三个支柱是把探索委托给本地 Agent。两个适配器都只操作精确的受信任 checkoutprompt 通过 stdin 传入并在前拼接同一段SAFETY_PREFIXcodex.js L6-L10检索到的文本只是证据不是授权必须引用仓库路径不得使用权限绕过不得泄露凭据、配对数据、音频、家庭状态或私有转录区分已实现的核心兼容与依赖集成的对等能力与外部认证。Codex 适配器构造的参数codex.js L12-L25codex exec -C root --sandbox read-only|workspace-write --ephemeral --json --strict-config --ignore-user-config -exec -prompt 走 stdin-C root限定在受信任根内工作--sandbox read-only默认沙箱只读仅当--allow-write且--confirm同时满足时才切换为workspace-write--ephemeral--json临时 JSONL 输出不留会话--strict-config且--ignore-user-config忽略用户配置但仓库 exec-policy 规则保持生效。Claude Code 适配器claude-code.js L12-L24则构造claude -p --safe-mode --output-format json --no-session-persistence --permission-mode plan|acceptEdits --allowedTools Read,Grep,Glob|Read,Grep,Glob,Edit,Write-p --safe-mode打印模式 安全模式--permission-mode plan默认计划模式只带Read/Grep/Glob检索工具写入时升级为acceptEdits并追加Edit/Write--no-session-persistence不持久化会话。CLI 层cli.js L222-L227强制--allow-write必须与--confirm成对出现否则报错退出。宿主委托是CLI-onlyMCP 不可达从而避免Agent 再委托 Agent的递归权威recursive agent authority。子进程统一经由 src/process-runner.js用参数数组执行、shell: false、清洗过的环境、有界输出与秘密脱敏。八、能力诚实标注与共享脑shared brainguidance返回的能力记录携带四要素ADR-285 第四节诚实的成熟度标签、仓库源码路径、固定验证命令、显式限制。能力目录刻意区分已实现 / feature 门控 / 依赖 provider / 依赖集成的行为。几条被写进 README 与代码的诚实规则值得引用Home Assistant 兼容指的是文档化的核心 REST/WebSocket 契约而非 Home Assistant 集成生态的全部端点HAP 协议测试不是Apple 认证STT/TTS provider 契约不意味着某个部署真的配了语音 provider打包的引用只是导航证据源码、测试、已接受的 ADR 与仓库策略才是权威。共享脑shared brain的规范记录位于 brain/corpus/core.jsonl由 src/brain.js 实现确定性、本地化检索。规则是brain search确定性检索评审过的记录返回结果附声明检索记录是评审证据不是指令或许可brain verify --repo .校验每条记录的源码引用与摘要覆盖digest-coveredbrain propose只打印一条未评审的 JSONL 候选永不修改权威语料私有向量索引、overlay 与原始 transcript 一律不被跟踪、不被打包。ADR-285 还明确没有任何 Darwin/Flywheel 候选能借由该 harness 自我晋升未来的学习循环需要单独的评审决策并复用 ADR-283 的冻结 holdout、来源追溯、安全与维护者门禁。九、发布与分发CI-only、provenance、精确 tarball发布流程把 ADR-265 的 npm 矩阵与 provenance-only 发布工作流扩展到harness/homecore。发布门禁必须覆盖ADR-285 第五节精确 lockfile 安装、测试与安全测试、包版本单一来源single-sourcing、显式 unpacked-size 预算且不打包 source map、从真实 tarball 安装并执行、从安装后的 tarball 验证 WASM 后端、MCP 初始化与导出、README 声明核对、包 provenance 清单。对应的 npm scriptspackage.json非常完整地体现了这些门禁npm install --ignore-scripts # 开发安装不跑生命周期脚本 npm test # node --test 全量测试 npm run test:security # 指定安全测试文件子集 npm run brain:verify -- --repo ../.. npm run manifest:update npm run manifest:verify npm audit --omitoptional npm pack --dry-run其中scripts/update-manifest.mjs与scripts/verify-manifest.mjs在prepackverify-manifest.mjs --quiet与prepublishOnly先npm test再 verify-manifest阶段被调用实现发布前清单校验。测试套件位于 harness/homecore/test/brain / cli / guidance / hosts / kernel / mcp / policy七个.test.mjstest:security明确圈定brain/cli/hosts/kernel/mcp/policy六个文件。发布约束仅 CI 发布、启用 npm provenance、运行在 trusted-publishing 兼容的 Node/npm 运行时、只接受main分支、使用受保护的npm-release环境且发布的必须是通过了 smoke test 的、digest 校验过的同一个 tarball。环境必须限制只向main部署、要求 review、禁止 self-review。即使开发阶段发现无 scope 包名可用也不能视为永久所有权——发布前仍须确认 registry 访问权限与包身份。README 的明确指引是不要在工作站上发布。十、对宿主进程的影响与边界ConsequencesADR-285 末尾系统整理了影响这些判断也直接写进了实现与文档可作为决策引用正面影响贡献者获得聚焦的npx homecore入口Rust 服务器不耦合任何 Agent 框架WASM 既用于可移植内核又被显式用于 Homecore 插件验证能力指引能区分已实现代码、feature 门控、provider 需求、生态限制与认证边界本地 Agent 执行在 Claude Code 与 Codex 间可移植且默认只读MCP 权威面小到可审计且不包含任何直接的家庭、网络、GitHub 或发布变更。负面影响homecore是对ruvnet/*命名空间的狭窄例外包新增一个精确的 WASM 内核运行时依赖wasm 与 hap 验证 profile 可能耗时且产生 Cargo 构建产物打包的指引目录可能陈旧需要引用校验与评审更新来维持。中性影响harness 不改变 Homecore 的协议、持久化、迁移、插件、HAP 或语音实现软件 profile 通过不构成生产部署、第三方生态对等、Apple 认证或硬件行为证据Ruflo 仍是可选的开发协调器不是homecore的运行时依赖。关联决策链ADR-285 建立在 RuView 一系列已接受的 ADR 之上可按需延伸阅读ADR-126Homecore 主决策native Home Assistant 移植总纲ADR-128插件边界ADR-130REST/WebSocket 契约ADR-133assist 与 Agent 桥ADR-161服务端安全评审ADR-165迁移信任边界ADR-182RuView 元测试平台本 ADR 的直接前身ADR-263harness 加固ADR-265npm 分发策略本 ADR 的唯一修订对象ADR-283共享脑与学习门禁。一句话总结ADR-285 用一个名字不 scope 的homecorenpm 包为 RuView 的 Rust Homecore 栈提供了一个 WASM-first、只读优先、可审计的开发者元测试平台——它在不把服务运行时耦合进 Agent 框架的前提下完成了能力指引、源码导航、定向验证、MCP 工具面与双宿主本地委托的全部职责并把每一次执行都控制在显式、可验证、不越权的边界内。【免费下载链接】RuViewπ RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video.项目地址: https://gitcode.com/GitHub_Trending/wi/RuView创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
