让 AI 写文档。
在 OmniDoc 里
接着编辑。

在 PowerShell 执行以下命令。第一条返回 True，随后输出带有 guide、schema、version 的 JSON，即表示程序可启动。

$ai = 'D:/OmniDoc/OmniDocAI.exe'
Test-Path -LiteralPath $ai
& $ai schema复制

在上方示例成功后的同一个 PowerShell 窗口执行。outline 列出块编号与类型；edit 按编号插入、替换、删除或移动块，并自动重新编号图、表、公式与引用。

# 在上方生成示例的同一个 PowerShell 窗口继续执行
& $ai outline $output
$ops = Join-Path $folder 'ops.json'
'[{"op":"insert","after":"end","blocks":[{"type":"paragraph","text":"由命令行追加的段落，含公式 $E=mc^2$。"}]}]' |
  Set-Content -LiteralPath $ops -Encoding UTF8
& $ai edit $output $ops
if ($LASTEXITCODE -ne 0) { throw '修改失败。' }
# 导出完整 JSON（可选）
& $ai read $output ([IO.Path]::ChangeExtension($output, '.json'))复制

修改前的版本保存在用户目录的 mcp-history 中，可以找回。create 默认不覆盖已有文件。

图片和附件按 schema 的 resources 规则打包：资源键是内容寻址的包内路径，值是自包含 data URL。需要引用资源时，先读取 schema 与已有文档的真实结构，保留资源引用。

修改已有 .udoc 时，用 omnidoc_read_udoc 查看结构（默认只返回大纲，嵌入代码与图片数据会缩略），再用 omnidoc_edit_udoc 按块编号修改。未修改的块、页面设置与资源保持不变。原生块中图题与公式带有 data-udoc-kind、data-udoc-label、data-udoc-number 属性，引用写作 <span data-udoc-ref="标签">；手工编辑 HTML 时保留这些属性，编号才能继续自动更新。

STDIO 使用逐行 UTF-8 JSON-RPC。客户端完成 initialize 与 notifications/initialized 握手后，发送以下请求。输出目录需已存在。

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "omnidoc_create_udoc",
    "arguments": {
      "document": {
        "title": "项目周报",
        "blocks": [
          {"type": "heading", "level": 1, "text": "项目周报"},
          {"type": "paragraph", "text": "本周完成原生文档接入，见表 \\ref{tab:tasks}。"},
          {"type": "table", "label": "tab:tasks", "caption": "任务状态",
           "rows": [["任务", "状态"], ["接口接入", "已完成"]]}
        ]
      },
      "outputPath": "D:/Reports/weekly-001.udoc"
    }
  }
}复制

成功时 result.structuredContent 的结构如下，数值以实际结果为准。

不要把 OmniDocAI.exe --mcp 当作普通命令运行后等待它显示界面；它会等待客户端通过标准输入发送协议消息。

此示例使用默认 profile。自定义用户目录时，修改 $profile。响应按二进制写入新文件，并检查原生容器标识。

# OmniDoc 需要正在运行。先把 ai 路径改为实际安装位置。
$ai = 'D:/OmniDoc/OmniDocAI.exe'
$profile = Join-Path $env:LOCALAPPDATA 'OmniDoc/Online'
$connection = Get-Content -LiteralPath (Join-Path $profile 'local-api.json') -Raw | ConvertFrom-Json
$address = [uri]$connection.baseUrl
if ($address.Scheme -ne 'http' -or $address.Host -ne '127.0.0.1' -or
    $address.IsDefaultPort -or $address.AbsolutePath -ne '/' -or
    $address.UserInfo -or $address.Query -or $address.Fragment -or
    $connection.token -notmatch '^[a-fA-F0-9]{64}$') {
  throw '本机 API 配置无效，请重新打开 OmniDoc。'
}
$sample = Join-Path (Split-Path $ai) 'ai-interface/native-document.example.json'
$body = [Text.Encoding]::UTF8.GetBytes((Get-Content -LiteralPath $sample -Raw -Encoding UTF8))
$output = Join-Path ([Environment]::GetFolderPath('MyDocuments')) ('HTTP示例-' + [guid]::NewGuid().ToString('N') + '.udoc')
Add-Type -AssemblyName System.Net.Http
$handler = [Net.Http.HttpClientHandler]::new()
$handler.UseProxy = $false
$handler.AllowAutoRedirect = $false
$client = [Net.Http.HttpClient]::new($handler)
$client.Timeout = [TimeSpan]::FromSeconds(180)
$client.DefaultRequestHeaders.Authorization = [Net.Http.Headers.AuthenticationHeaderValue]::new('Bearer', $connection.token)
$content = [Net.Http.ByteArrayContent]::new($body)
$content.Headers.ContentType = [Net.Http.Headers.MediaTypeHeaderValue]::new('application/json')
try {
  $response = $client.PostAsync($address.GetLeftPart([UriPartial]::Authority) + '/v1/documents/pack', $content).GetAwaiter().GetResult()
  if (-not $response.IsSuccessStatusCode) {
    throw ('HTTP ' + [int]$response.StatusCode + ': ' + $response.Content.ReadAsStringAsync().GetAwaiter().GetResult())
  }
  $bytes = $response.Content.ReadAsByteArrayAsync().GetAwaiter().GetResult()
  $stream = [IO.File]::Open($output, [IO.FileMode]::CreateNew, [IO.FileAccess]::Write)
  try { $stream.Write($bytes, 0, $bytes.Length) } finally { $stream.Dispose() }
  Get-FileHash -LiteralPath $output -Algorithm SHA256
} finally {
  if ($response) { $response.Dispose() }
  $content.Dispose()
  $client.Dispose()
}复制

默认目录是 %LOCALAPPDATA%\OmniDoc\Online，接口在其中保存修改历史与排版检查的临时数据。需要使用其他目录时，在配置中追加 --profile 与该目录的绝对路径。上方配置生成器会为三个客户端一起添加参数。

CLI 示例可使用 & $ai --profile 'D:/MyOmniDocProfile' create $sample $output。MCP 参数数组形如 ["--mcp", "--profile", "D:/MyOmniDocProfile"]。

接口随 Windows 客户端提供。OmniDocAI 直接调用安装目录中自带的 Rust 文档引擎，完成校验、打包、解包与修改；运行时不依赖 Python。

排版检查、页面图片与 HTML 导出会在后台启动一个独立的文档引擎，并以无头模式运行系统 Edge/Chrome 中的同一个 UniDoc 编辑器。它不操作你正在使用的窗口，也不连接云端服务；退出接口时一并结束。