# 7-23 [process][bug] mnote.doc.markdown_edit manifest schema 缺少 required 与写入字段 v1

> 发现时间：2026-05-17
>
> 状态：`[process]`
>
> 关联主线：`07-ai`

## 1. 问题定义

`mnote.doc.markdown_edit` manifest 的 input schema 没有完整声明 `required` 字段，也缺少 `dryRun`、`idempotencyKey` 等写入合同字段。

这会让模型、ACP wrapper 和外部调用方无法从 manifest 得知真实写入要求。

## 2. 证据

- [manifest.rs](/mnt/Data1T/mnote/rust/crates/mnote-web/src/hermes_tools/manifest.rs:413) 附近定义 `mnote.doc.markdown_edit` manifest。
- 当前 schema 更像参数提示，没有完整表达写入前置条件。

## 3. 影响

- 调用方可能不传幂等字段或 dryRun 字段。
- tool toggle / schema validation 无法提前拒绝不合规请求。
- Reasonix / ACP 等多 runtime 接入时会继续复制不完整合同。

## 4. 建议修复

- 为 `mnote.doc.markdown_edit` 补全 JSON Schema：`required`、互斥的 `operations` / `full_content`、写入合同字段。
- manifest 与 Rust runtime 校验保持一致。
- 增加 manifest snapshot 测试，防止字段再次漂移。

## 5. 状态

已确认 manifest 合同不完整，尚未修复。