# xAgent 产品首发包 · 官方资料事实核对（fact-check）

- **用途**：面向小型技术团队的产品首发包，仅供用户审阅，不对外发布。
- **核对日期**：2026-10-01
- **核对方式**：对本轮指定的 3 个官方页面逐页发起 HTTPS GET 抓取（`web_fetch`），对返回正文做逐条声明比对；并用本会话自身的运行事实交叉印证可复核的部分。
- **判定口径**：
  - ✅ 已核实 = 官方页面正文（本次成功抓取的原文）明确支持该表述；
  - ⚠️ 需注意 = 官方支持但存在限定条件，直接照搬原文会失实；
  - ❌ 冲突 = 待核表述与官方正文不符；
  - ❓ 无法核实 = 本次材料范围内无据可依。
- **重要区分**：「官方文档说法」与「本会话真实观察到的执行」严格分开。事件被成功投递/接收 ≠ 业务任务完成；本核对不伪造任何未在本文列出的协作步骤。

## 一、来源与可达性

| # | 来源 | URL | 抓取结果 |
|---|------|-----|----------|
| S1 | 多 Agent 如何通过会话事件协作 | https://xagent.xiagaogao.com/docs/guides/multi-agent-session-event-collaboration/ | 抓取成功，HTTP 200，正文完整可读 |
| S2 | xAgent Agent 会话：提交任务、文件与审批 | https://xagent.xiagaogao.com/docs/user-guide/agent-session/ | 抓取成功，HTTP 200，正文完整可读 |
| S3 | 支持的智能体功能 | https://xagent.xiagaogao.com/docs/manual/capabilities/ | 抓取成功，HTTP 200，正文完整可读 |

以下所有「✅」均指上述已实际读取的正文内容，而非搜索摘要或模型记忆。

## 二、「适合谁」核对

| 拟发布表述 | 判定 | 官方依据 / 说明 |
|---|---|---|
| xAgent 面向每天需要提交任务、查看过程、补材料、拿结果的用户 | ✅ | S2「适用对象」原文即此定位；S2 亦说明普通用户只需关注会话列表、时间线与输入区，高阶用户才需进入高级设置 |
| 适合小型技术团队作为 AI 工作助手使用 | ⚠️ | 官方三篇均未出现「小型技术团队」字样，属我方针对首发受众的定位推断。可作为产品包装话术，但不得写成官方承诺的功能点 |
| 主会话统筹 + 子会话专项执行是多 Agent 的基本分工 | ✅ | S1「主 Agent 与子 Agent 的分工」、S2「主会话与子会话」一致描述 |
| 当前只提供会话级协作，完整项目级 Agent Team 仍在规划 | ✅ | S1「当前版本的边界」原文明确：完整的项目级 Agent Team 仍在后续规划中。首发包文案应照此表述，不得宣称已有项目级 Team |

## 三、「能做什么」核对

### 3.1 会话与任务（S2）

| 拟发布表述 | 判定 | 官方依据 / 说明 |
|---|------|------|
| 在 Agent 会话中提交任务、上传文件、查看执行时间线、继续追问修正 | ✅ | S2「什么时候使用」「基本用法」「继续修正结果」均覆盖；同会话保留上下文，适合连续调整 |
| 阅读文档/网页/表格等已有材料，产出总结、报告、清单、回复、方案、数据结果 | ✅ | S2「什么时候使用」列举场景；S3「常见任务写法」给出研究调研、多文档比较、会议与项目、表格分析、合同合规、代码等示例写法 |
| 外发消息、删改重要数据、访问外部系统、创建子会话/触发器、使用密钥/插件等动作应重点确认，审批依实际规则生效 | ⚠️ | S2「工具调用与审批」列出应重点确认的动作；须结合 S1「事件不绕过审批」的目标会话权限、工作区和审批策略理解，不能宣称所有动作均必定弹审批或统一不可绕过 |
| 高级设置可微调 Agent Prompt、模型/Provider Policy、密钥 key、常驻 Skill/Tool | ✅ | S2「高级设置与任务微调」；注意官方口径：密钥只选 key，真实密钥值不进入模型或消息历史 |
| 支持 `/refresh_messages`、`/compress`、`/clear-history`（仅主会话）、`/delete`（仅子会话）命令 | ✅ | S2「会话命令」；注意：会话运行中或等待确认时命令可能暂时不可用 |
| 长会话可能进行上下文压缩，压缩期间部分会话操作被冻结 | ✅ | S2「上下文与长会话」明确使用「可能」；不得改写成必然发生 |

### 3.2 多 Agent 会话事件协作（S1）

| 拟发布表述 | 判定 | 官方依据 / 说明 |
|---|------|------|
| 每个 Agent 会话独立持有自己的上下文、任务状态、计划、工具、工作区与产物 | ✅ | S1「为什么使用独立会话」 |
| 会话分为主会话（接用户目标、拆任务、建/激活子会话、汇总）与子会话（围绕明确目标独立执行） | ✅ | S1「主 Agent 与子 Agent 的分工」；S1 强调子会话是真正的独立 Agent 会话，用户可进入查看过程 |
| 会话事件分「通知」与「协作」两种：通知只进 UI 历史不进模型上下文、不自动唤醒 Agent；协作事件进运行队列并激活目标会话 | ✅ | S1「通知与协作事件的区别」「为什么通知不进入模型上下文」。这是最容易写错的一条：不得宣传「通知会自动触发对方 Agent」 |
| 事件走持久化队列，含目标校验、排队、投递；目标忙碌或入口暂不可用时不被丢弃 | ✅ | S1「会话事件总线如何工作」第 1–6 步与持久队列说明 |
| 事件来源可以是 Agent 会话、触发器（定时/外部）、AgentPlugin（微信/Telegram 等）、外部接口 | ✅ | S1「哪些入口可以产生会话事件」；触发器只提交事件、不等待目标完成任务；AgentPlugin 消息无明确目标时通常进当前用户主会话，图片/文档经资源解析后作为附件交给 Agent；外部接口仍须身份验证与权限控制 |

### 3.3 内置能力与文件处理（S3）

| 拟发布表述 | 判定 | 官方依据 / 说明 |
|---|------|------|
| `v0.0.20.beta` 随包内置 54 个 Skill，按 6 个能力方向分组（研究分析、文档内容、产品项目、市场销售、财务法务采购人才、技术扩展） | ✅ | S3 开篇表格与能力总表；⚠️ 但官方同时声明：实际部署可用列表以「运行治理 → Skill」为准，管理员可停用内置或新增 Skill。首发包必须带上该限定，避免把「随包 54 个」说成「所有部署都可用 54 个」 |
| Web 会话上传支持 png/jpg/jpeg/webp、pdf、docx、pptx、xlsx/csv/tsv、html/json/xml/yaml 等及多种文本代码格式 | ✅ | S3「可以处理哪些文档」格式表 |
| Excel 由模型经原生 Tool 按需读取指定工作表/区域，不再预先内联整份文本；Word/PPT/PDF/HTML/文本会先准备可读材料再按需入上下文 | ✅ | S3 同上及其图例说明。注意官方明确「可上传≠可理解≠可预览」三者不同概念 |
| 可产出 Markdown/TXT/JSON/CSV/代码、PNG/JPEG/WebP 图片（依赖支持生成的 OpenAI-compatible 模型）、XLSX（excel-workbook-builder）、自包含 HTML 报告（html-report-builder）、HTML 幻灯片（html-slide-builder，非 PPTX 编辑器/导出器）、PPTX（powerpoint-builder，新建为主、不任意编辑已有 PPTX/POTX）、DOCX（word-document-builder，基于模板新建/占位填充，不承诺任意就地编辑、修订、批注、宏等）、PDF（检查/合并/抽页/优化，Office 转 PDF 依赖服务器安装 LibreOffice） | ✅ | S3「常见产物格式」逐项均有对应原文，且各项自带明确限制，首发包应原样保留这些限制 |
| 合同、合规、财务、投资、人事类 Skill 用于资料整理与决策辅助，不替代律师/会计师/审计师等资质人员的最终判断 | ✅ | S3「使用边界」。此类免责声明必须随功能清单一起发布 |

## 四、「开始前准备」核对

| 拟发布表述 | 判定 | 官方依据 / 说明 |
|---|------|------|
| 真正的外发动作（发消息、写 CRM、发布内容、改业务数据）需要对应 Tool / MCP / AgentPlugin、账号授权和审批策略齐备 | ✅ | S3「使用边界」第一条：Skill 提供处理方法，不代表外部系统已经连接 |
| Office→PDF、Excel 重算所需的 LibreOffice 及系统依赖不在 Server 发布包内，需管理员安装并验证（官方链接至安装手册第七步） | ✅ | S3「常见产物格式」末尾，引用了 `docs/getting-started/install/` 的 runtime assets 章节 |
| 上传文件的数量与大小以服务端文件能力为准，控制台会在保存前提示限制 | ✅ | S3 数据口径表；⚠️ 官方未给具体数字，首发包不应杜撰具体 MB/个数上限 |
| 密钥只选择 key 引用，真实值不进模型与消息历史 | ✅ | S2「高级设置与任务微调」 |
| 部署方如需固定工作方法/工具，可在高级设置配置常驻 Skill/常驻 Tool | ✅ | S2「高级设置与任务微调」 |

## 五、限制与安全边界的准确口径（S1/S3）

| 拟发布表述 | 判定 | 官方依据 / 说明 |
|---|------|------|
| 当前仅允许同一用户拥有的会话之间通信，不支持跨用户会话协作 | ✅ | S1「安全边界·只允许同一用户的会话通信」及「当前版本的边界」。本次汇总会话与 A/B 的协作属于同用户场景；汇总者在运行环境中也是子会话，不应称作主会话 |
| 事件必须带明确目标会话，不存在无边界广播 | ✅ | S1「必须有明确目标」 |
| 协作事件可激活目标会话，但其后的 Tool 调用、文件操作、外部发送、业务系统修改仍受目标会话的权限、工作区边界与审批策略约束 | ✅ | S1「事件不绕过审批」。**据此，首发包不得宣传「统一且不可绕过的安全底线」**——审批是否触发取决于各会话实际配置的审批策略，只能表述为「按实际规则生效」 |
| AgentPlugin 只是消息与事件入口，不扩大外部系统权限 | ✅ | S1「AgentPlugin 不扩大外部权限」 |
| 事件入队/投递成功只代表目标会话稳定接收，不代表业务任务完成；最终结果须以任务状态、产物、Tool 结果或后续通知确认 | ✅ | S1「会话事件总线如何工作」末段与「当前版本的边界」。此条同时是本核对自己的方法论基准 |
| 通知不会自动触发目标 Agent；触发器只提交事件不等待完成 | ✅ | S1「当前版本的边界」 |
| 扫描版 PDF 无可提取文本时当前原生解析可能无有效正文，OCR 属后续增强方向；加密/损坏/超限文件可能无法解析；长文档可能显示部分完成但可按索引继续读 | ✅ | S3「使用边界」 |
| 复杂协作应传递明确任务、文件产物与可验证结果，避免只发模糊状态 | ✅ | S1「当前版本的边界」 |


## 六、文档示例与本轮产品首发包案例

S1「一个协作示例」描述的是**新闻采集与报告生成**，不是产品首发包。以下仅核对文档内容，不意味着本轮执行了触发器或通知：

| 步骤 | 官方说明依据 | 判定 |
|---|---|---|
| 创建新闻采集、报告生成两个子会话 | S1 示例第 1 步 | ✅ 文档示例 |
| 触发器提交采集任务，不等待完成 | S1 示例第 2 步与「触发器」 | ✅ 文档示例；本轮未执行 |
| 保存采集产物，用通知向用户展示状态和引用 | S1 示例第 3–4 步与「通知事件」 | ✅ 文档示例；通知不自动唤醒 Agent |
| 用协作事件向报告会话交接确认的资料引用 | S1 示例第 5–6 步 | ✅ 文档示例；不复制全部历史 |

本轮产品首发包的实际分工为：汇总会话创建 **A「事实核对」**与 **B「页面与文案」**；A 返回 `fact-check.md`，B 返回 `launch.html` 与 `launch-copy.md`；汇总者接收返回、读取文件，用 A 的结论检查 B，并局部修订。该案例依据本轮可观察记录，不得改成“页面 / 文案分别占一个子会话”，也不得编造工具调用次数、通知类型或审批卡片。

## 七、官方说法 vs 本会话真实观察到的执行

本节区分 **A 自述**与**汇总会话直接观察**，不代表对全功能的生产验证。A 原始文件中的字节数及“主会话派发”称谓已在汇总时校正。

| 项 | 实际观察与证据范围 | 官方说法 / 限制 |
|---|---|---|
| 三篇资料 | A 返回称三篇已成功抓取；汇总会话亦对三个指定 URL 发起 web_fetch，均返回 HTTP 200 并读取正文 | S1/S2/S3 官方页面；不以搜索摘要代替正文 |
| 真实创建 | 汇总会话调用 session_create_sub 两次，分别返回 A/B 创建成功与首条任务消息已提交 | 仅证明创建与提交，不能推导任务完成 |
| A/B 身份 | A：`@{session:142c1288e4000ae}`；B：`@{session:142c1288ea400ae}`；汇总：`@{session:142c11c76e000ae}` | 独立会话，不是同一上下文的角色扮演；汇总者自身为子会话 |
| 实际返回 | 汇总会话分别收到 A/B 带来源标记的 reply 输入与产物引用 | 不将其假称为仅 UI 可见的通知；不推测不可见的内部事件步骤 |
| 文件证据 | 汇总会话通过文件读取工具成功读取三个原始文件，并复制到本会话产物目录；文件读取与复制均有成功回执 | 事件投递≠完成，最终需看产物、工具结果或任务状态 |
| 交叉审阅 | B 原页面将实际 A/B 分工错写成页面会话与文案会话，混用“真实流程”与“示意”；页面和文案泛称风险动作必走审批。汇总者据 A 与官方正文修正上述表述 | 限定实际权限、工作区与审批策略；不把示意伪装为执行 |
| 未执行事项 | 未对外发布，未创建长期计划、触发器或外部集成；A/B 未继续扩散；最终交付只列三个文件 | 创建的独立子会话仅 A/B 两个 |
| 未验证项 | 外发消息/邮件、触发器命中、插件链路、Office 产物生成与 LibreOffice 依赖未实测 | 有文档说明不等于当前已配置或验证 |

## 八、首发包文案建议（基于以上核对）

1. 「适合谁」：按 S2 适用对象口径写（每天提交任务、看过程、补材料、拿结果的用户）；「小型技术团队」只能作为我方定位话术，不得写成官方承诺。
2. 「能做什么」：可用 S2 使用场景 + S3 能力方向总表 + S1 会话事件协作，但必须同时携带各自限定条件（见第三、四、五节 ⚠️ 项）。
3. 数字口径：「54 个内置 Skill / v0.0.20.beta」必须附带「以运行治理 → Skill 为准，管理员可停用/新增」的限定句。
4. 安全表述：禁止出现「不可绕过的统一安全底线」类宣传语；正确口径是 S1「事件不绕过审批」——审批依各会话实际权限、工作区边界与审批策略生效。
5. 项目级 Team：只能写「规划中」，与 S1「当前版本的边界」保持一致。
6. 案例章节：使用本轮事实核对 / 页面与文案的真实分工及可观察交接；如另引 S1 新闻示例，必须标注文档示例，不得混淆。
7. 免责声明：合同/合规/财务/投资/人事类用途必须保留 S3 的资质人员判断免责。
8. 发布前自查：文中每个功能点都能在上文找到 ✅ 依据；凡标 ⚠️ 的条款，照抄限定语后再用。

## 九、结论

- 三份指定官方资料均已**实际抓取并读取正文**（HTTP 200），本核对的所有 ✅ 判定均可回溯到具体页面具体章节（见第一、二至七节的来源编号与章节名）。
- A 的功能核对可作为审阅依据，但不等于对 B 原稿的自动验收。汇总检查已发现并修正：案例分工与实际不一致、示意与实跑混淆、审批绝对化、插件配置泛化，以及原核对表格列数问题。
- 受众定位、部署差异、上传限额、上下文压缩与示例范围均须保留限定。当前只涉及同用户会话协作，完整项目级 Team 仍在规划；没有统一且不可绕过的安全保证。
- 最终交付只包含三个文件，仅供审阅；未对外发布，不创建长期计划、触发器或外部集成。

## 来源清单（本轮实际读取）

1. 多 Agent 如何通过会话事件协作 — https://xagent.xiagaogao.com/docs/guides/multi-agent-session-event-collaboration/ （S1）
2. xAgent Agent 会话：提交任务、文件与审批 — https://xagent.xiagaogao.com/docs/user-guide/agent-session/ （S2）
3. 支持的智能体功能 — https://xagent.xiagaogao.com/docs/manual/capabilities/ （S3）

（正文快照存于本会话 tmp 工具结果路径，仅供审计追溯；对外引用一律以上面三条原始 URL 为准。）