人工智能AI 应用交互助手AI Agent【免费下载链接】ironclawIronClaw is an Agent OS focused on privacy, security and extensibility项目地址https://gitcode.com/gh_mirrors/iro/ironclaw点击查看免费下载导读ascii-renderer.draw是 IronClaw 中以 WASM 组件形式发布的一个最小化工具扩展它渲染一小段内置的 ASCII 艺术cat / dog / robot仅声明dispatch_capability效果不需要网络访问、不需要任何凭据是典型的纯计算pure compute能力。本文以该工具的提示文档draw.md为主线结合扩展清单、WASM 实现、JSON Schema 与构建脚本完整讲解这类无网络、无密钥工具的声明方式、调用契约、沙箱实现与在测试体系中的定位。工具契约参数、行为与默认值工具的提示文档定义了一条非常简洁的调用契约渲染一小段**预置canned**的 ASCII 艺术并返回可选参数subject选择图形cat、dog或robot默认值为robot传入未知 subject 时自动回退到robot而不是报错工具适合在用户索要 ASCII 艺术或快速小图画时调用不需要网络访问、不需要凭据是纯计算。从 WASM 实现lib.rs可以看到这套行为的具体落地。输入解析采用宽松策略req.params为空或空白时直接使用默认输入JSON 解析失败同样回退到默认值serde_json::from_str(params).unwrap_or_default()。随后art_for()对 subject 做trim().to_lowercase()归一化后匹配三种图形任何未命中分支都会落到 robot 图形上fn art_for(subject: str) - Optionstatic str { match subject.trim().to_lowercase().as_str() { cat Some(r# /\_/\ ( o.o ) ^ #), dog Some(r# / \__ ( \___ / O / (_____/#), robot | Some(r# [ o_o ] /|_____|\ | | d b#), _ None, } }返回结构由 types.rs 定义DrawInput { subject: OptionString }作为输入AsciiArt { subject: String, art: String }作为输出。输入输出 Schema类型即契约工具的输入输出各有独立的 JSON Schema2020-12 draft并在 manifest 中通过input_schema_ref/output_schema_ref引用输入 draw.input.v1.jsonobject仅一个可选字符串属性subjectadditionalProperties: false输出 draw.output.v1.jsonobject必填字段subject与art同样禁止多余属性。值得注意的细节是输入 Schema 中subject是开放字符串而非 enum。实现中对schema()的注释明确解释了原因——工具刻意接受任意字符串并对未知值回退到 robot因此对外声明的契约不能承诺一个实际并未强制执行的封闭集合lib.rs。这是声明必须与行为一致的一个典型示例schema 只约束参数形态不承诺取值枚举未知值由运行时宽容处理。Manifest 声明无网络、无密钥能力如何表达工具的能力声明位于扩展清单 manifest.toml采用reborn.extension_manifest.v2格式其关键声明如下字段值含义trustthird_party上传的 bundle 按ManifestSource::InstalledLocal校验禁止 first_party/system 信任声明[runtime]kind wasm,module wasm/ascii_renderer_tool.wasm运行时加载的 WASI 组件路径[[host_api]]id ironclaw.capability_provider/v1,section capability_provider.tools通过能力提供方 host API 暴露工具effects[dispatch_capability]仅声明调度能力无network效果default_permissionallow默认允许origin_gate_matrixloop_run gated_unless_granted,product forbidden,automation forbidden循环运行中默认受门控product/automation 场景禁止visibilitymodel工具对模型可见input_schema_ref/output_schema_ref/prompt_doc_ref指向 schemas 与 prompts 目录三件套资产必须随 bundle 一并导入effects只声明dispatch_capability是零义务的关键由于没有network效果义务规划器obligation planner不会为它附加ApplyNetworkPolicy也不会产生任何密钥义务manifest 中的注释还提到v2 解析器会因为缺少network效果而拒绝在此处声明network_targetsmanifest.toml。也就是说义务边界由效果声明机械推导声明与语义是强绑定关系。沙箱实现WASM 组件如何接入运行时工具本体是编译为wasm32-wasip2的WASI 组件通过wit-bindgen绑定 tool.wit 中定义的sandboxed-toolworld工具导入宿主提供的host接口、导出tool接口。核心入口execute(req: Request) - Response完成一次调用通过宿主log接口输出info级别日志日志按执行收集、限速每执行 1000 条、每条 4KB宽松解析params为DrawInput匹配图形并构造AsciiArt序列化为 JSON成功返回Response::Success(output)序列化失败则返回Response::Failure携带ErrorKind::Executor与稳定错误码serialization_failed。整个执行不触碰任何宿主能力——不调用http-request、不读取 workspace、不检查 secret。这正是 tool.wit 安全模型的体现WASM 工具默认无任何访问权所有能力均为 opt-in而本工具显式选择了零能力集合。构建侧Cargo.toml 采用cdylibcrate 类型并针对体积优化opt-level s、lto true、strip true。构建命令在 test-tools/README.md 中给出rustup target add wasm32-wasip2 # 一次性添加目标 bash scripts/build-test-tools.sh # 构建全部工具 bash scripts/build-test-tools.sh market-data # 构建单个工具脚本会校验组件头、把产物复制到 manifest 声明的[runtime].module路径并生成可上传的 zipwasm32-wasip1核心模块可导入但分发时会因tool manifest is invalid失败因为运行时通过wasmtime::component::Component::new加载的是 WASI 组件形态。在测试矩阵中的定位三种义务类别的零义务基准ascii-renderer属于 test-tools 体系中的测试夹具#5459 fixture与另外两个工具构成完整的三档义务矩阵工具效果凭据场景ascii-rendererdispatch_capability无纯计算零义务hacker-newsnetwork无通过 manifestnetwork_targets声明出站白名单无密钥market-datanetwork,use_secret租户共享market_data_api_key出站白名单 宿主托管密钥注入这套夹具的价值在于管理员安装后任何用户都可以零义务地请求该工具用来端到端验证无网络、无密钥扩展从导入、激活到被模型调用的完整链路。E2E 套件会构建并上传这些 bundleRust 套件则在ironclaw_composition::extension_lifecycle中内存构建 zip 夹具并通过available_extensions::tests::test_tool_fixture_manifests_stay_importable以include_str!钉住这些 manifest——一旦 manifest 漂移出可导入形态CI 就会失败而不是等演示时才暴露。所有夹具的数据都是预置的绝不执行真实出站请求网络声明只是为了驱动义务规划器。导入路径本身也有约束test-tools/README.mdzip 内必须包含 manifest 声明的全部资产模块、schemas、prompt 文档拒绝重复 zip 条目名拒绝非 WASM 运行时。总结ascii-renderer.draw是一个麻雀虽小、五脏俱全的工具扩展样本提示文档定义用户可感知的调用语义subject 三选一、未知回退、纯计算零依赖manifest 用效果声明把零义务落到义务规划器可验证的层面WASM 实现展示了一个最小化组件如何通过wit-bindgen接入sandboxed-toolworld而测试矩阵则赋予它纯计算基准夹具的工程价值。对于想要在 IronClaw 中编写同类无网络、无密钥 WASM 工具的开发者这个 fixture 的 manifest、schema、prompt 三件套与构建脚本就是最直接的参考模板。赞分享人工智能AI 应用交互助手AI Agent【免费下载链接】ironclawIronClaw is an Agent OS focused on privacy, security and extensibility项目地址https://gitcode.com/gh_mirrors/iro/ironclaw点击查看免费下载相关推荐IronClaw Google Drive 扩展 get_file 工具深度解析文件元数据获取的设计、安全模型与实现IronClaw Google Drive 扩展 get_file 工具深度解析文件元数据获取的设计、安全模型与实现 导读 google drive.get_人工智能AI 应用交互助手AI AgentIronClaw Google Sheets 扩展 create_spreadsheet 能力全解析参数契约、WASM 调用链与安全模型IronClaw Google Sheets 扩展 create_spreadsheet 能力全解析参数契约、WASM 调用链与安全模型 IronClaw 是人工智能AI 应用交互助手AI AgentIronClaw 扩展契约层解析ironclaw_extension_contracts 的职责边界、模块清单与安全密封设计IronClaw 扩展契约层解析ironclaw_extension_contracts 的职责边界、模块清单与安全密封设计 IronClaw 是一个以隐私、人工智能AI 应用交互助手AI Agent上一篇PingFangSC苹方字体跨平台视觉一致性的技术实现方案下一篇ComfyUI-Workflows-ZHOFLUX、SD3 到 3D 生成的现成工作流模板创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考