配置

改配置的两种方式（任选）：

① 覆盖层（推荐，不动包内文件）：编辑 ~/.dsh/profiles/web/cordis.patch.yml，按 id 定位覆盖：

- id: mc-bridge
  config:
    enabled: true
    endpoint: 'http://127.0.0.1:25580'
    token: ''          # 本机可空；云端必填
    readOnly: false
    allowTiers: ['act.tier1']

② 直接改包内的 cordis.patch.yml（会被升级覆盖，不推荐）。

字段参考

字段	默认	说明
`endpoint`	`http://127.0.0.1:25580`	mod 桥地址。本机回环；云端填域名（建议走反代/HTTPS）
`token`	`''`	`Authorization: Bearer`。非回环端点必须填，否则拒绝启用（安全门）
`enabled`	`false`	总开关（opt-in：装上不主动连）
`readOnly`	`true`	默认只读：不注册任何动作工具（AI 只能看）
`allowTiers`	`[]`	授权哪些动作层：`act.tier1`（视角/移动/跳跃/climbTo/walkToward）· `act.tier2`（`exec_ops`、后续 mine/place/attack）
`reconnectMinMs` / `reconnectMaxMs`	2000 / 30000	退避区间（2→4→8→16→30s 封顶）
`heartbeatTimeoutMs`	45000	SSE 心跳超时（SSE 无"请求超时"概念）；3 次丢包判死
`rateLimit.say/anim/actTier1/screenshot`	5000/2000/2000/30000	每工具最小间隔（ms）；超限返回 `rate_limited` + `retryAfterMs`
`window.enabled`	`false`	L0 窗口层（找 MC 窗口/截图/可选简单输入）—— 不依赖 mod
`window.captureIntervalMs`	5000	截取间隔
`window.allowInputInjection`	`false`	允许简单盲操作（按键/鼠标）
`window.requireForeground`	`true`	抓图前校验前台窗口 == MC 窗口（防抓到遮挡窗口）
`audit.enabled`	`true`	审计（默认开，不随 debug）
`audit.logToFile`	`false`	是否额外落文件

非法配置不会让插件失效：按字段回落到默认并告警说明原因（"配置缺失"静默取默认，只有"存在但非法"才告警）。

dsh-mc-bridge

インストール

ドキュメント

配置

字段参考