← 返回 Oxygen AI 能力产品页

Oxygen AI 能力 · 使用者手册Oxygen 25.x

RAYCONTENTECH®
适用菜单：AI 能力 · 版本 0.4.0 · 读者：文档工程师 / 技术写作与本地化同事
一句话：打开文档，点一下 AI 能力 菜单，就能得到一份检查报告，或得到可直接使用的修改内容。不用切换工具，也不用安装额外的 AI 平台。

1. 你能做什么

你想做的事用哪个动作
写一篇新的 DITA 主题基础能力 → 生成 DITA 主题
检查文档结构是否规范基础能力 → DITA 结构评审
检查术语是否统一术语库 → 检查术语合规 / 审计术语资产
把不规范术语改成标准写法术语库 → 规范化术语
给文档打分、找出问题质量门禁 → 生成质量评分
按评分结果整改质量门禁 → 整改质量问题
找出可复用的重复内容复用分析 → 分析复用机会
把重复内容改成复用引用复用分析 → 改写为复用引用
出版前检查 Markdown 格式MD 出版 → 预检 Markdown 出版
中英文同步（只改该改的几句）本地化 → 标注变更节点 / 提取增量片段 / 翻译增量片段 / 核查英文镜像
动作名称后面带 （当前文件） 的，只处理当前打开的这一篇文档。

2. 安装（约 3 分钟）

  1. 关闭 Oxygen。
  2. 把收到的文件夹 oxygen-ai-capabilities-trial-0.4.0-30days 复制到 Oxygen 安装目录的 plugins\ 下，例如 C:\Program Files\Oxygen XML Author 25\plugins\oxygen-ai-trial\ （复制后该目录下应能直接看到 plugin.xml）。
  3. 用记事本打开同目录的 oxygen-ai-capabilities.properties，把 baseUrl= 改成 管理员给你的服务地址（这是唯一要改的一项），保存。
  4. 启动 Oxygen，看到菜单 AI 能力 即安装成功。

卸载：关闭 Oxygen，删除该插件文件夹即可。

3. 第一次使用（1 分钟）

  1. 打开任意一篇文档（.dita / .ditamap / .md）；
  2. 点 AI 能力 → 试用许可状态…，确认剩余可用天数与服务状态：可用；
  3. 随便试一个动作，例如 质量门禁 → 生成质量评分。

4. 日常使用（5 步）

  1. 在 Oxygen 里打开要处理的文档；
  2. 点菜单 AI 能力；
  3. 选场景（如"术语库"），再选动作（如"检查术语合规"）；
  4. 等待几秒到几十秒（状态栏有提示）；
  5. 看结果：报告类动作会自动在 Oxygen 打开排版好的报告；改写类动作直接改文档（不满意按 Ctrl+Z 撤销）。

示例 A · 检查一篇文档的质量

AI 能力 → 质量门禁 → 生成质量评分 → 打开报告，查看总分、扣分项与修改建议。

示例 B · 中英文同步（只翻译改动部分）

  1. 本地化 → 标注变更节点：列出这次改了哪些内容；
  2. 本地化 → 提取增量片段：挑出要翻译的片段；
  3. 本地化 → 翻译增量片段：只翻译这几段；
  4. 本地化 → 核查英文镜像：检查英文稿是否漏译或残留。

5. 报告在哪里

6. 遇到问题怎么办

现象处理
菜单里没有 AI 能力确认插件文件夹在 <Oxygen>\plugins\ 下且 plugin.xml 直接可见；重启 Oxygen
状态显示"服务不可用"检查网络；确认 baseUrl 与管理员给的一致；请管理员确认服务在运行
提示"许可不可用 / 已到期"打开 AI 能力 → 试用许可状态… 查看原因；到期请联系管理员
动作是灰色、点不了通常是服务或许可不可用，先看许可状态
报告没有自动打开到项目 reports\ 目录找对应文件，用浏览器或 Oxygen 打开
改写结果不满意立即 Ctrl+Z 撤销；或先另存副本再执行改写类动作
中文显示异常确认 escapeNonAsciiInBody=false 这一行不要改动

7. 使用须知

8. 获取帮助

遇到问题请把以下信息发给管理员：

  1. 现象截图（含菜单与报错文字）；
  2. AI 能力 → 试用许可状态… 里显示的内容；
  3. 你的 Oxygen 版本（Help → About）与操作系统。