{{ theme.skipToContentLabel || 'Skip to content' }}

工具与业务能力

状态:已发布的 0.3.0 稳定版;支持平台:Windows、Linux。macOS 尚未列为正式支持。

目的

通过内置工具、脚本工具或稳定 defineTool 契约连接确定性的业务动作。

公共接口

  • buildTools
  • defineTool
  • adaptCoreMindTool
  • ToolEffectDeclaration
  • ProcessRunner
  • GitAdapter
  • createUnifiedDiffdiffFiles

错误与边界

  • 工具加载失败会告警并跳过
  • 工具异常会进入 tool_result 与失败预算
  • 越权路径或 deny 规则会阻止执行
  • 自定义工具缺少 effect 时配置或 SDK 定义直接失败;受约束模式不会猜测未知副作用
  • effect.operations 可组合 readwriteprocessnetworkexternalreversible 必须如实填写
  • 自定义工具不得使用 readwritebash 等内置工具名,避免权限语义被错误继承
  • Linux bash 沙箱初始化失败时关闭执行,不回退到宿主 shell
  • ProcessRunner 不启用 Shell 拼接,限制 UTF-8 输出、执行时间和环境变量;调用方显式提供 env 时,该最小环境是权威输入,不会重新合并宿主环境,也不会被工具执行上下文覆盖
  • GitAdapter 只开放固定的只读 status/diff/log,不允许任意子命令、写操作或路径逃逸
  • 统一 Diff 同时限制输入、输出和计算复杂度,避免超大文件拖垮进程
  • Windows 宿主 Shell 只有在 full、关闭工作区限制且允许网络时才开放;这是显式风险选择,不是隔离承诺

CoreMind 只提供机制、质量护栏和开发指导。业务目标、规则、数据字段、审批责任和最终验收由用户或业务负责人决定。

源码、测试与示例

{{ theme.lastUpdated?.text || theme.lastUpdatedText || 'Last updated' }}:

Released under the MIT License.