WorkBuddy 入门：从一份可验收的任务开始

准备一场线下活动时，报名表通常只是工作的一小部分。你还会检查重复报名、统一分会场名称、统计人数、追问缺项，最后把结果交给现场同事。这些步骤有明确规则，却容易把一个下午切成许多短片段。

先拿一项最近完成的工作，把“找到文件、整理字段、核对异常、决定安排、通知相关人”分别写下来。前三项适合尝试交给工具预处理；决定安排涉及资源取舍，通知相关人涉及外部承诺，需要另设确认。这样拆开以后，你会知道哪些步骤值得自动化，也知道该从哪里接手。

WorkBuddy 可以围绕任务读取材料、处理文件并产出结果，实际能做到哪一步取决于当前环境、启用的能力和权限。初次体验时，把目标放在“交付一个能检查的文件”上，通常比要求它包办整场活动容易评估。

适合起步的任务应该能写出处理规则，有明确的检查方法，并且即使做错也能恢复。比如把培训通知压缩为一页清单，能检查日期、地点和待办是否保留；把多份设备盘点表合并，能检查设备编号和总行数；整理公开资料，能逐条核对链接与更新时间。

相反，“把客户问题都处理好”包含资料整理、专业判断、关系沟通和承诺，范围太宽。可以先缩成“把这十条问题归类，并列出需要业务负责人回答的部分”，得到有用的中间成果后再决定下一步。

• 规则能否说清：相同记录怎么处理，冲突记录怎么办？
• 结果能否检查：哪些数字、字段或句子必须与原材料一致？
• 错误能否恢复：是否保留原件，是否先在副本上试做？

频繁重复会提高配置流程的价值，但低频任务也能使用。只要一次整理本身已经很费力，且检查成本合理，就值得尝试。先留意“人工整理耗时、人工验收耗时、返工次数”这三个数，几次之后再判断是否真正减轻了负担。

通过 WorkBuddy 官网获取适合当前系统的安装版本，按当前页面完成安装与登录。个人电脑与企业管理设备的登录方式、可用功能及组织要求可能不同，遇到企业账号或资料使用限制时，先遵守所在组织的规定。

进入任务后，首先确认工作空间、任务说明和输出位置。工作空间是这次读取与保存文件的主要目录；没有指定时，产品也可能为新任务创建独立空间。练习时主动选一个单独目录，更方便核对输入和输出。无需一开始就配置所有专家、连接器和自动化。

报名整理练习/
  input/
    报名.csv
    处理规则.txt
  output/
  review/

input 放复制出来的练习材料，output 放生成结果，review 放人工核对记录。目录名称只是约定，不会自动变成系统级只读保护，所以仍要在任务中要求不改原件，并另行保留备份。不要直接把整个桌面、下载目录或客户资料根目录当作第一次任务的工作空间。

日常先保持默认权限。它在常规任务与受控操作之间保留确认环节；出现确认时，逐项看操作类型、目标路径和影响范围。发现工具准备覆盖原件，可以取消这一步，要求改为新文件；准备访问无关目录时，先让它解释必要性。

当前官方说明中，允许完全访问会减少高风险操作的二次确认，且作用于当前客户端内的全部任务，包括之后新建的任务。不要把它当成单个练习的临时提速按钮。完全访问不会提高数据准确性，也无法替代备份和人工检查。

本地目录与数据使用方式也要分开考虑。文件位于自己的电脑，并不能据此判断内容在处理时绝不离开设备；模型服务、技能和连接器可能涉及不同的数据处理路径。真实材料含有客户联系方式、合同、财务或员工信息时，先确认组织规则和相关服务说明，只提供完成任务所需的内容。下面的练习只使用虚构报名编号。

以下 CSV 全部为虚构数据。复制为 UTF-8 编码的“报名.csv”，放入 input。R101 完全重复；R102 的状态相互冲突；R104 缺少会场。这里故意保留异常，便于判断工具会不会自行补齐或悄悄丢弃。

报名编号,会场,部门,状态
R101,A馆,设计,已确认
R101,A馆,设计,已确认
R102,B馆,运营,已确认
R103,A馆,产品,待确认
R104,,销售,已确认
R102,B馆,运营,已取消

本次约定：完全相同的重复记录保留一行；同一编号内容冲突时，相关原始行都进入异常清单，暂不纳入有效记录；必填项缺失同样进入异常清单。确认状态只能照材料保留，不能根据常识猜测。规则确定后，可以复制下面的任务说明。

请整理当前工作空间 input/报名.csv。所有数据都是练习示例。
先列出已读到的文件、字段、处理计划与预期输出，
等我确认后再写文件。

处理范围：只用该 CSV，不联网，不读其他目录。
不得修改 input 中的文件。
规则：四个字段均为必填；完全相同的记录只保留一行，
并记下被去重的原始行号；同一报名编号有不同字段值时，
整组进入异常清单；缺项记录进入异常清单。不得补全未知值。
冲突检查优先于缺项检查，避免一行被计入两类异常。

确认计划后，在 output 新建：
1. 有效报名.csv：四个原字段，并附原始行号。
2. 异常清单.csv：原字段、原始行号、异常原因、待确认问题。
3. 整理说明.md：
输入记录数、有效记录数、异常原始行数、完全重复去除行数，
以及按状态统计的有效记录数。
原始行号从表头后的第一条数据记为1。

不要删除、覆盖或发送任何文件，不使用连接器。
发现已有同名输出时停止并询问。
遇到无法读取的文件、无法确定的字段或计数不守恒时，
说明问题并停止，不宣称完成。

检查计划时，重点看 R102 是否会整组隔离、R104 是否被标为缺项，以及结果是否写入 output。确认这些前提后再继续，比结束后逐行追查错误省力。

按上述规则，六条原始记录应得到两条有效记录、三条异常原始行和一条完全重复去除行。有效记录是 R101 与 R103；R102 的两行和 R104 进入异常清单。这里的数量是按示例人工推导的预期值，不代表 WorkBuddy 已实际运行通过。

• 打开三份输出，确认内容确实存在，扩展名与内容相符
• 检查有效记录只有 R101、R103，状态分别为已确认、待确认
• 检查 R102 的两种状态都保留，R104 的缺会场问题明确列出
• 核对 6＝2＋3＋1，并确认汇总只统计有效记录
• 重新打开输入副本，确认六条记录仍在，未被覆盖或重排

不要只看统计数字。若两个错误恰好相互抵消，总数也可能正确。因此至少要把重复、冲突、缺失三类情况各抽查一条；批量规模扩大后，再增加随机样本和边界样本。发现错误时，指出记录编号、错误字段和期望行为，让它只修正受影响的文件并重新核对计数。

三份最小完整输出，逐条保留来路

以下是上面六行虚构数据的人工参考答案，可分别复制成三份输出文本。它们不是 WorkBuddy 生成或执行通过的证明。两份 CSV 按原始行顺序排列；“原始行号”沿用本练习从 1 开始的数据行编号。

报名编号,会场,部门,状态,原始行号
R101,A馆,设计,已确认,1
R103,A馆,产品,待确认,4

报名编号,会场,部门,状态,原始行号,异常原因,待确认问题
R102,B馆,运营,已确认,3,同一编号状态冲突（原始行3与6）,应以哪条状态为准？请负责人核实后再处理
R104,,销售,已确认,5,必填项会场为空,会场是什么？未获确认前保持空值
R102,B馆,运营,已取消,6,同一编号状态冲突（原始行3与6）,应以哪条状态为准？请负责人核实后再处理

# 整理说明
本文件是六行虚构报名数据的人工参考，不是WorkBuddy实际执行回执。
输入：input/报名.csv；原始行号从表头后的第一条数据记为1。
使用规则：四字段必填；完全重复保留一行并记录去重来源；同编号冲突整组隔离；缺项不补齐；冲突检查优先于缺项。

## 数量与有效状态
输入记录数：6
有效记录数：2
异常原始行数：3（冲突2行，缺项1行）
完全重复去除行数：1
守恒核对：6＝2＋3＋1
有效记录按状态：已确认1条；待确认1条；已取消0条。
“有效”只表示满足本次数据整理规则，不等于已确认参会；R103仍为待确认，不得算成已确认到场人数。

## 六条原始记录的去向
1｜R101,A馆,设计,已确认 → 有效报名.csv数据行1，保留首次出现。
2｜R101,A馆,设计,已确认 → 与原始行1四字段完全相同，输出去重；原值在此记录，input原件不删除此行。
3｜R102,B馆,运营,已确认 → 异常清单.csv数据行1，与原始行6成对保留。
4｜R103,A馆,产品,待确认 → 有效报名.csv数据行2，状态原样保留。
5｜R104,,销售,已确认 → 异常清单.csv数据行2，会场保留空值，不能猜成A馆或B馆。
6｜R102,B馆,运营,已取消 → 异常清单.csv数据行3，与原始行3成对保留；不能仅因排在后面就认定它是有效新版本。

## 待确认与交接
请负责人确认R102应采用的状态，以及R104的会场；未答复前，两项均不并入有效名单。
两份CSV保留原四字段与来源；原始行2的完整内容和去重关系由本说明保留。逐行去向集合为1、2、3、4、5、6，无遗漏或重复计数。
正式验收时还须重新打开input/报名.csv确认六条输入未改变，并实际检查三份输出；这份人工答案不能证明产品执行或原件保护成功。
没有发送名单，也没有替负责人确认任何人的参会状态。

只看总数会漏掉两种常见错误：把 R102 的两行压成一个“冲突编号”，会少保留一条原始记录；把“有效报名”理解成“已确认”，会擅自改变 R103 的状态。上面用原始行号、原值和去向同时核对，正是为了区分这两类问题。

读不到文件时，先看工作空间是否选对、文件名是否一致，再让它列出当前可见的输入清单。权限被拒绝时不要立即放开整台电脑，优先把允许处理的副本移入任务目录，或缩小输出范围。CSV 出现乱码时，检查编码和分隔符，先用几行样本确认读取结果。

如果结果看似合理却缺少异常说明，往往是任务被理解成了“尽量生成一份干净名单”。补充明确的失败规则：缺项必须列出、冲突不得择一、无法证明的数据不进入汇总。若需要下载程序或接入外部服务才能继续，应先审查新增能力和数据去向，练习也可以改用已经支持的文本输出。

一旦发现原文件已发生意外修改，先停止后续处理，记录受影响文件，再从已确认的备份恢复。不要假定聊天记录或操作日志一定提供可用的文件回滚。

保存任务说明、示例输入、合格输出和验收清单，下次只替换本次需要变化的内容。先用真实材料的脱敏副本跑一小批，比较字段、异常类型和人工复核时间，再扩大规模。材料格式变化或规则变化时，重做小样验证。

人的职责仍包括确定业务口径、确认对外发送、检查重要结论，以及承担最后决策。工具可以把需要检查的地方集中呈现，你就能把精力放到少数真正需要判断的问题上。一次成功的起步，应该留下可复用的方法和能追溯的结果。

遇到“文件打不开”，先记下卡住的具体位置：是任务里找不到文件，原来的办公软件也打不开，还是能读出内容却只有预览空白？这几种情况需要的证据不同。下面补充一套小样检查，适合在处理真实业务材料前使用。

2026 年 10 月 13 日核对的腾讯云 WorkBuddy Enterprise 常见问题，页面更新日期为 9 月 7 日，列出了文件读取可能受模型和文档插件、Skill 影响的情况。这是企业版文档中的排查建议，不能据此确定某个个人版账号的能力或故障原因。另一个线索来自官方更新日志：10 月 4 日的 5.7.6 条目修复的是资料库内 PPTX 在线预览慢、预览区空白。适用位置和格式都很具体，不能将它套用为 Excel、PDF 读取失败的统一修复办法，也不能据此判断当前版本仍有同一问题。

1. 能找到哪一份文件：记录文件名、扩展名、字节数和任务内相对位置。让工具列出实际可见的文件，再核对是否为同一份副本。仅列出文件名，还不能证明读取过正文。
2. 文件本身能否打开：用你已安装、获准使用的办公软件或阅读器打开副本，记录程序名称和可见错误。若这里也失败，先核对来源、是否下载完整以及格式是否相符。不要靠改扩展名“转换”文件，也不要覆盖原件尝试修复。
3. 能否读出指定内容：让 WorkBuddy 返回文件内部独有的校验代号、两项原值和所在行、单元格或页码。代号不要预先写进任务指令。读取失败就记录原文，不能用文件名、聊天里的答案或另一份文件补答。
4. 预览是否显示：单独记录预览入口、格式和现象。若原应用可打开、指定内容也读对，而内置预览空白，可以优先向支持人员报告预览环节；这些观察仍不足以确定根因。PDF 在阅读器里能看见页面、却不能选中文字时，也只能作为扫描图或文本提取问题的线索。
5. 输出是否正确：核对交付物里的原值、合计和来源位置。读对两个单元格只证明这个小样的局部读取成功；输出丢行、算错或保存成错误格式，仍需分别处理。

每项可以填“通过、失败、未测、不适用”，并写明依据。没有测试入口或当前环境没有相应能力时保留“未测”或“不适用”；不要把空白格当作通过。若小样本身能解析，而 WorkBuddy 读不到，下一步是核对当前版本、模型、已启用能力和材料提供方式。需要新增安装、授权或改变数据去向时，先停下确认。

先准备只含虚构内容的小文件，每次只测试一个文件。以下 TXT 和 CSV 可直接复制；XLSX 请在现有表格软件中新建并另存为工作簿；文本 PDF 请从现有文档软件导出。不要把本节验收答案一起放进待测工作空间或任务对话，以免工具直接复述答案。做独立对照时使用未包含答案的新任务。

校验代号：WB-TXT-M28
纸张：17
装订：25

校验代号,项目,数量
WB-CSV-P63,纸张,17
WB-CSV-P63,装订,25

• control.xlsx：仅建一张“核对页”。A1 填“校验代号”，B1 填“WB-XLSX-K47”；A3、B3 为“项目、数量”；A4、B4 为“纸张、17”；A5、B5 为“装订、25”。两项数量存为数字。本例没有公式、宏、隐藏工作表或外部链接。
• control-text.pdf：一页正文依次写“Marker: WB-PDF-R82”“Paper: 17”“Binding: 25”，导出为文本 PDF。这只检查简单文本路径，不能代表扫描件、复杂版面、加密 PDF 或所有 PDF 都可读。

只检查当前任务内的 control.xlsx，材料全部为虚构数据。
先确认实际可见的文件，不读取其他文件或目录。
返回文件里的校验代号、两项数量及各自所在位置，再计算合计。
没有读到就写“未读到”并保留可见错误，不猜测、不改文件。
不要安装软件、插件或 Skill，不新增授权，不联网搜索答案。
若现有能力不足，说明停在哪一步。
本轮只在回复中给出结果，不生成或发送文件。

人工验收时，四种正常样本的代号应各自匹配，两项数值为 17 和 25，合计为 42。XLSX 应指出“核对页”的 B1、B4、B5；CSV 两项数量位于第 2、3 个物理行，TXT 的数值位于第 2、3 行，PDF 位于第 1 页。这里是人为设置的参考答案，本轮没有调用 WorkBuddy，也没有在原生 Office 应用里打开这些文件。

两个故意出错的对照，避免把输入问题当成产品结论

本轮另制作了 control-gb18030.csv，它与 UTF-8 CSV 的文字、字段、行数相同，只改变编码；以及 renamed-text.xlsx，它是 control.txt 的逐字节副本，只改了文件名。请将它们单独保留为负例，不要覆盖正常样本。

• 编码对照：离线检查按各自声明的编码读取，两份 CSV 的逻辑内容一致；将这个 GB18030 样本强制按严格 UTF-8 解码，会出现 UnicodeDecodeError。这个结果来自本地 Python 检查，WorkBuddy 是否自动识别编码仍未测。真实文件不知道编码时，应先向来源确认，保留原件后另存转换副本，不能把所有乱码都归因于同一编码。
• 扩展名对照：离线检查能读取正常 XLSX 的工作表与已知单元格；改名负例的内容仍是 TXT，不是本例这种 XLSX 文件包。正常 XLSX 内含工作簿和工作表 XML，可对照微软的工作簿结构说明。即使某个工具能按文本回退读取负例，也不能算作已成功解析 Excel 工作簿；是否实际回退，本轮未测。

本轮离线检查还验证了文本 PDF 的单页文本可提取、正常 XLSX 的已知单元格可读。这只用于确认教学样本的内容。扫描 PDF、真实 PPTX 预览、密码保护文件、不同模型或版本的表现都未测试，不能拿这些样本宣称产品已修复。

复制这份记录，先保留观察，再决定是否反馈

记录性质：真实观察 / 合成样本测试（请选择）
发生时间与时区：未记录
WorkBuddy 版本、系统版本：未记录
个人版或企业版、模型名称、已启用能力：未记录
材料提供方式及任务内相对位置：未记录
文件名、扩展名、字节数：未记录
SHA-256（可选，用于本地核对同一份文件）：未计算
文件来源及类型：文本 / 扫描图 / 含公式 / 加密 / 未知

文件可见：未测；依据：无
原应用打开：未测；应用名称和可见错误：无
指定代号与数值读取：未测；返回内容及来源位置：无
预览显示：未测；入口、格式与现象：无
输出核对：未测；核对对象与差异：无
错误原文：尚无记录（填写前去除私人路径与正文）
复现步骤及次数：未记录
同环境正常样本的结果：未测
只改变的一个条件、改变前后结果：未记录
未知项：根因、影响范围、是否与历史修复相同
已做操作、是否改动原件：未记录
准备提供的附件：仅经检查的最小样本；尚未发送

例如，改名负例可如实记录为：“renamed-text.xlsx，50 字节，与 control.txt 内容相同；离线检查显示不是 ZIP 文件包。WorkBuddy 可见性、读取、预览、输出及原应用打开均未测。”这份记录说明已经知道什么，尚不能作为真实产品故障单。

反馈前，先用合成材料替换客户名、员工信息和业务数字，移除截图中的账号、私人目录与无关对话。路径和文件名本身也可能泄露项目或客户身份；校验值可以留作本地比对，不必默认对外发送。企业版 FAQ 提醒日志可能含对话和设备信息，因此不能把整包日志当成已经脱敏的附件。只通过当前产品的正式支持入口提交自己检查过、获准分享的材料；本文模板不会自动发送任何内容。

确认读取和格式路径后，再继续表格整理与对账或办公写作里的内容验收。若只有预览失败，保留原文件与已核对结果，把预览现象单独记录，避免反复重新生成文件引入新的内容差异。