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

在 PowerShell 执行以下命令。第一条返回 True，随后输出带有 schema、workflow、version 的 JSON，即表示程序可启动。读取 schema 不需要打开文档服务。

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

在上方示例成功后的同一个 PowerShell 窗口执行。read 会导出可修改的 JSON；编辑其中的正文，再用 create 生成新版本。

# 在上方生成示例的同一个 PowerShell 窗口继续执行
$jsonOutput = [IO.Path]::ChangeExtension($output, '.json')
& $ai read $output $jsonOutput
if ($LASTEXITCODE -ne 0) { throw '读取失败。' }
# 修改 JSON 后，以新的文件名生成修改版
& $ai create $jsonOutput ([IO.Path]::ChangeExtension($output, '.edited.udoc'))复制

原有文档会保留。再次运行时，请选一个新的输出文件名；CLI 和 MCP 都会拒绝覆盖已存在的文件。

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

修改已有 .udoc 时，先用 omnidoc_read_udoc 读取完整 document，保留页面设置、资源及未修改的块，再创建一个新的输出文件。普通文档使用 blocks；需要完整网页交互的嵌入内容可按软件支持的 htmledit 结构处理。

STDIO 使用逐行 UTF-8 JSON-RPC。客户端完成 initialize 与 notifications/initialized 握手后，发送以下请求。请先创建 D:/Reports，并确认输出文件尚不存在。

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "omnidoc_create_udoc",
    "arguments": {
      "document": {
        "format": "udoc",
        "version": 3,
        "unidoc_type": "docs",
        "title": "项目周报",
        "blocks": [
          {
            "para_id": 1,
            "type": "paragraph",
            "html": "<h1>项目周报</h1>",
            "pages": [
              1
            ]
          },
          {
            "para_id": 2,
            "type": "paragraph",
            "html": "<p>本周完成原生文档接入。</p>",
            "pages": [
              1
            ]
          }
        ]
      },
      "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 时，才在配置中追加 --profile 与该目录的绝对路径。上方配置生成器会为三个客户端一起添加参数。

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

接口随 Windows 客户端提供。OmniDocAI 通过本机 API 调用软件自带的 Rust 文档引擎，完成校验、打包和解包。运行时不依赖 Python，也不需要操纵编辑器界面。

本篇的 JSON 示例和 MCP/CLI 原生生成已在 Windows 安装包中验证；生成文档已检查编辑、保存和重开。Codex 与 Claude 的配置格式依据各自官方接入文档；具体客户端中的连接状态请按第 02 节检查。