# MatrixFlow 使用指南：完整资料 > MatrixFlow 官方使用指南：从创建第一个浏览器环境，到代理排障、AI 助手任务、结果核验与团队交接。每一步都给出可核对的做法和边界。 更新日期：2026-10-18 ## 第一次使用 MatrixFlow：先完成一个可检查的小任务 URL: https://docs.matrixflow.cn/guides/getting-started/ 摘要：第一次使用时，先建立一个用途明确的浏览器环境，手动确认网址、账号与网络，再运行一个只读任务。能看到窗口打开只代表启动成功，还需要检查页面里的目标数据是否已经得到。 ### 核心结论 - 第一次使用只建一个环境，先核对域名、账号和网络，再运行只读任务。 - “窗口打开”只是启动成功；完成标准要写到页面上的具体字段或文件行数。 - 助手回答必须与页面抽样对照，登录页、错误页和空列表不能都解释成没有数据。 ### 先给环境一个可辨认的身份 浏览器环境是组织工作的单位，账号则是网站里的身份，两者需要分别核对。MatrixFlow 的环境资料包含名称、平台、分组、代理、启动网址与备注等信息。建议按业务命名，例如“店铺A－订单核对”，而不是只写“环境1”。名称里不用放密码、验证码或完整手机号。 首次操作只选一个环境。打开后先看地址栏是否是预期域名，再看网站显示的店铺或账号名称；平台相似的名称、国内站与海外站不要靠图标猜测。没有登录或出现验证页时，先由账号持有人完成正常验证。 ### 用只读任务检验工作链路 以下为示例任务，不是某个平台已经通过验收的声明：“在店铺A环境打开订单列表，只读取今天的订单号、金额和状态，不改变订单；把页面实际显示的内容列出来，保留编号前导零。”这条指令同时限定了环境、页面、字段和可执行范围，便于判断是否做对。 检查结果时，把助手回答与页面抽样对照。缺失字段应明确标为未读取，登录页、错误页与空列表不能都解释成没有订单。若需要保存文档，还要检查文件存在、可以打开，而且文件内容与回答一致。 ### 完成一次任务以后再扩大范围 遇到问题时记录发生时间、环境名称、目标网址、最后一步和错误文字。截图应遮盖个人信息与敏感业务数据。界面入口可能随版本调整，以当前客户端实际显示为准；有入口不代表所有网站、所有动作都已经获得兼容保证。 - 关掉环境后再次打开，检查是否回到预期账号；保留会话不等于网站一定允许长期登录。 - 把成功标准写下来，例如“读回3条订单并保留原始编号”，避免只用“操作完成”作为结果。 - 增加第二个环境时重新核对身份，随后再安排多环境任务；先小规模检查能更快发现错窗。 - 把需要发布、发货或更改资料的步骤单独列明，并先使用草稿或可控测试内容验证。 ### 用一个只读例子验收完整链路 第一次测试不要同时验证代理、登录、多个环境和写入。选一个已知可访问的普通页面，写下环境名称、网址、允许读取的字段与预期结果。示例任务：在环境“QA-订单复核”打开指定测试页，只读取页面标题和三条测试记录，不点击表单或保存按钮。 验收时分开记录四件事：环境是否启动、目标标签是否打开、页面是否加载、指定数据是否读对。前两项成功但页面空白，不能算业务任务完成；如果测试页返回错误，记录错误原文和发生阶段，再缩小排查范围。 - 范围：一个环境、一个网址、三条只读记录。 - 证据：页面标题、记录数、读取时间和未读取原因。 - 停止条件：环境身份不符、出现登录验证或页面要求提交。 ### 遇到问题时先定位在哪一层 若窗口没启动，先检查环境本身与运行状态；窗口启动但网址打不开，再检查地址、DNS、代理连通性和证书；页面打开但无法登录，检查账号会话与平台验证；页面能登录但业务数据不可见，检查账号角色、店铺切换和筛选条件。每次只改变一个变量，避免同时改代理、Cookie 和账号设置后无法判断原因。 记录“实际页面看到什么”，不要只写“AI失败”。例如“目标页面返回登录页，预期的 3 条记录没有出现”，能让下一位接手人知道从登录状态继续，而不是重复整个任务。若问题涉及账号锁定或安全验证，交由账号持有人处理。 - 记下系统、应用版本、环境标识、时间和页面地址。 - 重试只读访问前先确认页面没有发生写入。 ### 常见问题 **第一次要不要批量导入环境？** 不要。先用一条环境验证命名、代理、登录和任务链路，再批量导入。批量成功只说明表格被接收，不说明每个环境都能进入正确账号。 **怎样确认打开的是正确账号？** 看地址栏域名、页面显示的店铺或账号名称和当前网络。环境名称只用于定位，不能代替页面身份核对。 ### 参考资料 - MatrixFlow 官方网站: https://matrixflow.cn/ - MDN：HTTP Cookie 与会话: https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/Cookies - MDN：HTTP Cookie: https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Guides/Cookies --- ## 如何整理多账号浏览器环境，减少找错窗口 URL: https://docs.matrixflow.cn/guides/organize-browser-environments/ 摘要：多账号管理应先建立“环境对应谁、用来做什么”的清单，再扩大数量。窗口编号适合定位，业务名称和页面账号信息用于确认身份；三者不能互相替代。 ### 核心结论 - 环境命名用“业务－账号别名－用途”，窗口编号只负责定位，不负责证明身份。 - 批量导入前先填一行检查列、代理和网址，再扩展整批。 - 交接时以实际页面账号和数据归属为准，不以“Cookie 还在”判断登录有效。 ### 采用一套团队能看懂的命名方式 建议使用“业务－账号别名－用途”的结构，例如“品牌A－国内内容－编辑”或“店铺B－订单－核对”。分组按品牌、项目或责任人选择一个主维度，避免同一批环境同时混用地区、平台和账号状态作为分组依据。MatrixFlow 提供环境分组及移动环境到分组的管理能力，整理时仍需核对每个环境实际对应的账号。 备注用于说明负责人、允许进行的操作和交接日期，不用于保管登录秘密。离职交接、账号停用或业务迁移后及时更新备注。测试环境应在名称前加“测试”，并使用独立测试数据，防止把测试任务送到生产账号。 ### 批量整理前先核对一行 客户端的环境导入模板包含环境名称、平台、分组、代理、启动网址和备注。批量操作前先填一条示例，检查列没有错位、平台网址无拼写错误，代理字段与代理管理里的记录对应，再增加剩余条目。不要把其他工具的表格直接当作兼容模板，也不要只因表格上传成功就认定每个环境都配置正确。 “1到9号”应覆盖九个不同目标，而不是两个端点。执行前列出目标清单；任务完成后按环境逐项对照结果。列表排序、导入或删除操作之后重新核对编号与名称的关系。存在同名环境时，先重命名为唯一标识，再执行涉及写入的任务。 ### 交接时检查页面身份和数据归属 浏览器里保存了登录资料，并不意味着网站会话永久有效。MDN 说明，网站可通过会话标识判断请求对应的登录状态，会话无效时仍可能要求重新登录。交接应以页面显示的账号为准，不能仅根据已保存 Cookie 的数量判断。 以下为整理检查清单，属于操作建议：打开目标环境，核对域名与账号；关闭后重新打开，观察状态；检查只读数据归属；最后确认环境名称与业务清单一致。整理人员只处理获授权的账号，复制或清理环境数据前保留必要备份，避免丢失尚未提交的草稿。 - 每个环境有唯一业务名称，能找到负责人。 - 测试与生产用途可以直接从名称区分。 - 多环境任务有完整目标清单和逐项结果。 - 删除或迁移前已检查草稿与需要保留的数据。 ### 用环境台账避免同名和编号漂移 团队可以维护一份最小台账：稳定环境 ID、显示名称、平台、业务账号别名、负责人、用途、允许操作、最近核验时间。窗口序号是当前列表里的定位线索，可能随筛选、排序或删除变化；长期流程应优先使用稳定 ID 和可辨认名称，打开后再核对站点内账号身份。 示例（虚构）：MF-013｜国内店铺-售后｜负责人：运营甲｜只读订单与整理草稿｜最近核验：2026-10-16。不要在台账里存密码、验证码、完整 Cookie 或 API Key。把敏感凭据留在受控凭据系统，并另行管理访问权限。 - 同一业务账号是否被误配到两个环境？ - 环境名称、列表编号和页面账号是否都能互相核对？ - 账号离职或用途改变后，谁负责撤权和复核？ ### 批量整理时先抽一项再扩展 整理旧环境时，先选一条做“当前值—目标值—核验方式”对照，确认重命名不会改变目录身份、代理不会误配到其他账号、已有浏览器资料不会因清理而丢失。之后分小批处理，并在每批结束时核对环境总数、失败条目和受影响账号。 发生名称重复时，不要用列表第几行做唯一判断；以稳定环境 ID、配置详情和已授权账号身份交叉核对。若无法确认某环境归属，把它标为待认领而非猜一个负责人。 - 变更前导出台账，保留可回滚的旧名称映射。 - 变更后核对数量、代理关联、负责人和登录身份。 ### 常见问题 **环境名称可以写手机号或密码吗？** 不可以。名称会出现在列表、截图和交接材料里，不应包含密码、验证码、完整手机号等敏感信息。 **测试环境和正式环境怎么区分？** 用固定前缀“测试－”，并使用独立测试账号和测试数据；不要只在备注里写“测试”，也不要让测试任务进入生产账号。 ### 参考资料 - MatrixFlow 官方网站: https://matrixflow.cn/ - MDN：HTTP Cookie 与会话管理: https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/Cookies - MDN：HTTP Cookie 管理: https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Guides/Cookies --- ## 代理配置与排障：从连接失败到页面可用 URL: https://docs.matrixflow.cn/guides/proxy-setup-troubleshooting/ 摘要：代理排障应按配置、连接、网页和业务权限逐层检查。MatrixFlow 的代理导入支持明确选择协议，但协议选对和端口可达都不能证明目标网站已经可用。 ### 核心结论 - 代理排障按配置、连接、网页、业务权限四层逐层检查，每次只改一个条件。 - 协议选对、端口可达、测速正常，都不能证明目标网站和账号可用。 - 代理不自动清除 Cookie，也不授予平台权限；“经过代理”不是匿名保证。 ### 先确认代理服务给了什么 记录服务商提供的协议、主机、端口、认证方式和有效期。MatrixFlow 的代理批量导入界面可选择 SOCKS5、HTTP 或 HTTPS；输入文本如果省略协议，所选类型会影响导入结果。导入前检查类型，不要凭端口号推断协议。填写账号密码时注意复制产生的空格和换行，也不要把认证信息发到公共群或截图里。 先添加一条代理并验证，再处理整批。需要用户名密码与基于出口地址授权的代理，其排查方法不同；后者应检查服务商允许的客户端地址是否与当前网络相符。代理费用、可用区域与使用限制由相应服务商说明，不能从浏览器软件的功能推导出来。 ### 按错误出现的位置缩小范围 每次只改变一个条件，再重复同一项检查。一次同时更换代理、浏览器设置和账号，会使原因难以追踪。不要用关闭系统安全功能、忽略证书警告或安装来源不明证书作为常规解决办法。 - 连代理服务都失败：检查主机、端口、协议、有效期和本地网络，保留明确错误信息。 - 能连接但认证失败：检查账号密码或服务商的地址授权设置，只修改相关配置。 - 普通网页可访问而目标站失败：记录目标域名、错误页与发生时间，核对服务商路由及站点状态。 - 网页打开却要求登录或验证：按网站正常流程处理，这属于会话或访问要求，不能解释为代理配置必然错误。 ### 理解网络代理能解决的范围 MDN 将代理描述为客户端与目标服务器之间的中间环节；部分代理还可能转发原始客户端信息。因此“经过代理”本身不是匿名保证。代理也不会自动清除 Cookie、改变网站账号权限或完成订单操作。 业务验收要再多做一步：在正确环境进入目标页面，确认账号与所需数据能正常显示。记录本次代理配置与检查结果，交接时隐去凭据。如果同一任务在提交后超时，先去平台核对是否已产生记录，再决定后续操作，避免网络问题变成重复提交。 ### 按 DNS、连接、TLS、网页分层测试 把“代理不行”拆成可观察步骤：先确认代理地址、端口、协议和认证信息来自服务提供方；再从客户端建立连接；然后访问一个无敏感数据的 HTTPS 测试页；最后访问目标业务页面。每一步记状态码或错误原文。TCP 连通不代表 DNS、TLS 或目标站授权也正常。 若只某个站点失败，检查目标站限制、地区规则或账号状态，不要马上改全局代理。若所有站点均失败，优先核对协议、端口、认证和出口可用性。证书告警应停止，不应通过关闭证书校验绕过。 - 连不上：检查主机、端口、防火墙与凭据。 - 能连接但打不开 HTTPS：检查 DNS、TLS 和代理协议兼容性。 - 只有业务后台异常：进一步检查平台登录状态与账号权限。 ### 留下一份可复测的变更记录 一次排障记录至少包括环境 ID、代理配置别名（不记录密码）、目标网址、测试时间、错误阶段和变更前后结果。先备份已知可用配置，再一次修改一个字段并重测同一网址。若目标站出现验证码、风控或安全提醒，应暂停自动操作，不能把更换出口地址当作绕过安全检查的方法。 代理用于路由请求，不会清除浏览器存储，也不会授予平台业务权限。即使出口 IP 变化，账号的登录状态、平台规则和操作授权仍分别由浏览器会话与平台决定。 - 避免把代理密码、完整连接 URL 发到工单或公共聊天。 - 排障结束后确认原本应使用该配置的环境仍然正确。 ### 常见问题 **代理连接成功但目标站打不开怎么办？** 记录目标域名、错误页和发生时间，检查服务商路由、站点状态与账号权限；不要同时更换代理、浏览器设置和账号。 **为什么换了代理还是要登录？** 登录状态由网站会话决定，代理只改变网络路径。会话失效、风控要求或主动退出都可能触发重新登录。 ### 参考资料 - MatrixFlow 官方网站: https://matrixflow.cn/ - MDN：代理服务器与隧道: https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/Proxy_servers_and_tunneling - MDN：代理服务器与隧道: https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Proxy_servers_and_tunneling --- ## 把工作流和 AI 助手任务写成可核对的步骤 URL: https://docs.matrixflow.cn/guides/workflows-assistant-schedules/ 摘要：自动化任务至少应说明目标环境、要做的动作、允许的修改和成功标准。定时任务还要明确时间、时区与电脑运行条件；保存了工作流不等于已经完成一次业务执行。 ### 核心结论 - 任务至少写清目标环境、动作、允许的修改和成功标准。 - 保存工作流不等于执行成功，先做一次最小运行并核对结果。 - 定时任务要写明时间、时区、设备运行条件和错过执行策略。 ### 把目标、步骤与完成条件写在一起 “帮我处理店铺”难以验收。更好的示例是：“先读取店铺A今天待发货订单并保存清单，确认清单存在后，再读取店铺B；本次不发货、不改订单。”这是一种任务描述方法，不是对任意平台执行能力的保证。一次只安排必要动作，写清读取字段、时间范围、输出位置和遇到登录失效时的停止条件。 涉及发布时先说明目标账号、内容来源、可见范围和是否允许提交。商品说明与社媒文案应来自真实资料；需要审批的内容先保留草稿。结果里应有可复查的记录，例如平台里的草稿条目或提交后读回的状态，不能把按钮被点击当作发布已经成功。 ### 保存工作流后做一次最小运行 MatrixFlow 的工作流仓库先写入本地并读回保存结果。用户仍应重新打开工作流，核对名称、步骤和目标环境；保存是配置动作，运行是业务动作，二者分开检查。首次运行选择测试环境与少量数据，检查错误时能否停下，以及输出是否完整。 客户端包含随包知识库及本地关键词检索，也支持导入 Markdown、JSONL、JSON 资料。知识资料适合放产品说明、字段定义和工作规范，不适合存放密码。导入以后用一个能定位具体事实的问题检查检索结果，并定期清理过时说法；有知识库不代表回答中的每一句都自动可靠。 ### 排期要包含执行条件和异常处理 MatrixFlow 具备本地排期持久化机制，但本地排期需要电脑、应用与网络可运行。新建排期后核对执行时间和下一次运行；电脑关机或休眠期间不要按在线服务器的标准期待执行。恢复后先检查记录，再决定补做哪些安全步骤。 下面是建议保留的验收项目。它们用于帮助使用者发现问题，并非已经通过所有场景的测试报告。网站页面更新、权限变化或验证要求都可能让旧流程暂停，维护时应根据错误证据修改具体步骤。 - 顺序正确：A 的完成证据出现后，才允许开始 B。 - 范围完整：逐项列出目标环境，标明完成、失败或未执行。 - 输出可用：生成的文档可以打开，字段与页面数据一致。 - 写入可核验：结果未知时先核对平台记录，避免再次提交。 ### 可直接复制的任务单模板 任务单可以用六个字段表达：目标（要得到什么结果）、范围（环境与记录集合）、顺序（依赖关系）、权限（只读或允许修改的字段）、证据（从哪里核对）、停止条件（验证、歧义、数据冲突）。例如“先在 14 号 QA 环境读取订单列表，再在 15 号 QA 环境读取同一日期范围；不得修改订单；分别导出订单号、SKU、金额和状态；每个环境读回总数；先完成 14 再开始 15”。 如果指令说“1 到 9 号”，任务单应展开为 1、2、3、4、5、6、7、8、9，并在执行前核对没有遗漏或重复。用户给的是顺序依赖，就不能为了并行而重排；无法识别多个同号环境时，先解析完整名称。 - 目标：要交付的文件、数据或业务状态。 - 范围：逐个环境、页面、时间段和记录。 - 验收：成功证据与失败状态分别定义。 ### 定时与长任务要有恢复点 排期应写明确切日期或重复规则、时区、电脑休眠时的处理、允许的最长运行时间和错过一次执行后是跳过还是补跑。长任务每个阶段记录已完成范围、下一项和未决结果；重启后先读任务账本与页面状态，再判断从哪里恢复，不能从头重复已经提交的业务动作。 MatrixFlow 的任务单或本地工具可以帮助描述工作，但生成说明、保存工作流、创建定时计划和实际完成业务是四种不同状态。报告时分别说明，不要把“已创建”写成“已执行”。 - 跨时区任务存储时区名并在界面显示下一次本地执行时间。 - 结果未知先核验，验证或登录问题转交用户。 ### 常见问题 **工作流保存后为什么要先试跑？** 保存只代表配置存在，试跑能发现环境、账号、页面和权限问题；试跑也应使用只读或可控数据。 **电脑睡眠会怎样？** 本地定时依赖设备与应用运行，睡眠或退出可能导致错过触发；恢复后先看检查点，不要直接重复写入任务。 ### 参考资料 - MatrixFlow 官方网站: https://matrixflow.cn/ - Playwright：动作可执行性检查: https://playwright.dev/docs/actionability --- ## 环境、账号、平台：用一张表把三者对上 URL: https://docs.matrixflow.cn/guides/environment-account-map/ 摘要：多账号出错往往不是不会操作，而是环境、平台账号和业务身份没有稳定对应。一张可维护的对应表应包含唯一环境标识、平台、账号别名、负责人、代理范围、最近核验时间和允许动作；表格本身不能代替页面核对。 ### 核心结论 - 环境、平台账号和业务身份是三件事，不能用窗口编号互相代替。 - 对应表至少要有唯一环境标识、平台、账号别名、负责人、允许动作和最近核验时间。 - 表格只用于组织工作；每次关键操作仍要读回页面里的账号与店铺身份。 ### 为什么三者必须分开记录 浏览器环境是本地的工作空间，平台账号是网站里的登录身份，业务身份则是店铺、品牌或项目。一个环境里可以退出一个账号再登录另一个账号，一个平台也可能有多个店铺；如果只记“环境 3 是店铺 A”，时间一长就无法判断当前页面到底是谁。 窗口编号适合定位，不适合证明身份。把它当作楼层号，而不是门牌上的姓名。真正的身份确认来自页面显示的账号、店铺名称、域名和当前权限，必要时还要看后台的成员信息。 ### 对应表至少要有哪些列 这张表不需要很复杂，但必须能回答两个问题：这个环境现在应该对应谁，以及谁有权在这里做什么。不要把密码、Cookie、恢复码放进同一张表，也不要把表格截图发到公共群。 - 环境标识：唯一且稳定的名称，例如“品牌A－国内内容－编辑01”。 - 平台与站点：写明平台、国内站或海外站、店铺所在区域。 - 账号别名：用于团队识别的别名，不写密码、验证码或完整手机号。 - 业务范围：该账号负责的品牌、店铺、品类或项目。 - 负责人：唯一负责人和备份负责人，避免多人同时写入。 - 网络范围：代理地区或线路名称，不写认证凭据。 - 允许动作：只读、草稿、发布、修改价格等，按最小权限填写。 - 最近核验：最后一次在页面上确认账号身份的时间与核验人。 ### 建立与更新规则 新建环境时先填表、再登录。命名按“业务－账号别名－用途”组织，测试环境统一加“测试－”前缀。环境分组可以按品牌、项目或负责人选一个主维度，不要同时混用地区、平台和账号状态。 账号更换、负责人离职、店铺迁移或代理调整后，当天更新对应表，并在备注里写明变更原因。归档环境前先检查是否有未提交草稿、未完成任务或需要保留的记录；删除本地环境不代表平台权限已经被撤销。 ### 交接时的三步核对 只有三步都完成，交接才算闭环。只看表格、只拿到密码或只看到窗口打开，都不足以证明接手人能够安全地继续工作。 - 第一步：接手人打开指定环境，核对地址栏域名与页面显示的账号或店铺名称。 - 第二步：执行一个只读任务，例如读取页面标题、订单条数或账号名称，并与原负责人记录对照。 - 第三步：在对应表上签字确认环境、账号、权限与未完成任务，异常项单独列出。 ### 最常见的四个错误 发现这些问题时，先暂停涉及写入的任务，重新核对页面身份，再修正表格与环境名称。不要用“先跑完再说”换取短期速度。 - 同名环境：列表里出现两个“店铺A”，执行时只能靠猜。 - 复制环境时带走旧会话：新环境一打开就是上一个账号。 - 把个人账号混入业务矩阵：权限、内容和责任都无法追踪。 - 表格长期不更新：账号已经换了，任务仍按旧对应关系执行。 ### 常见问题 **对应表应该用什么工具维护？** 表格、数据库或团队现有文档都可以，关键是唯一标识、权限和更新时间可查。不要用无法审计的临时聊天记录代替。 **一个环境可以对应多个平台账号吗？** 技术上可以退出再登录，但会增加错号风险。团队环境最好保持一个环境对应一个主要账号；确需切换时，在任务前后都读回页面身份。 **对应表需要记录代理密码吗？** 不需要。密码和认证信息应放在受控的凭据管理中，对应表只记录线路名称、地区和负责人。 ### 参考资料 - MatrixFlow 官方网站: https://matrixflow.cn/ - MDN：HTTP Cookie 与会话: https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/Cookies - Playwright：浏览器上下文隔离: https://playwright.dev/docs/browser-contexts --- ## 怎样把一句话说成 AI 助手能执行的任务 URL: https://docs.matrixflow.cn/guides/describe-task-to-ai/ 摘要：一句“帮我处理一下”缺少环境、范围和完成标准，助手只能猜。有效指令应写明在哪做、做什么、允许改什么、怎样算完成、什么情况停下来；对写入任务还要指定提交前预览和提交后读回。 ### 核心结论 - 把“处理、优化、看一下”换成具体动作、字段和范围。 - 任务指令要写明环境、对象、允许的修改、成功证据和停止条件。 - 写入类任务必须要求提交前预览、提交后读回，不能只要求“完成”。 ### 先去掉模糊词 “帮我看看店铺”“把数据整理一下”“优化一下内容”都不是可执行任务。助手不知道是哪个店铺、看哪些字段、整理成什么格式，也不知道什么算完成。模糊指令会把理解成本转移给执行者，最后得到的往往是看起来合理但无法核对的结果。 把动词换成可观察的动作：读取今天待发货订单的订单号、SKU、金额和状态；把结果按金额从高到低排序；导出为 XLSX；在结果里标出缺失字段。动作越具体，越容易判断是否做对。 ### 六要素模板 这六项不必写成长文，一段话也可以。例如：“在店铺A环境读取今天待发货订单的订单号、SKU、金额和状态，不修改订单；按订单号升序导出 XLSX，保留前导零；如果出现登录页或条数与页面不一致，停止并报告。” - 目标：要得到什么结果，例如“一份今日待发货订单清单”。 - 环境：在哪个浏览器环境、哪个账号、哪个平台执行。 - 范围：时间、状态、分页、字段和商品范围，避免用“全部”代替清单。 - 动作：只读、保存草稿、发布、修改字段；明确哪些动作不允许。 - 成功证据：页面条数、字段完整性、文件行数、可见范围或读回值。 - 停止条件：登录失效、验证码、权限不足、页面异常、提交结果未知时停下来交给人。 ### 只读与写入要分开说 只读任务的风险低，适合第一次验证环境和链路。写入任务必须单独授权，写明允许修改的字段、商品范围和目标账号。不要用“顺便把价格改一下”这种附带授权，也不要把“检查”理解成“可以修改”。 对发布、发货、付款、删除等不可逆动作，要求助手在提交前展示预览或待提交内容，提交后从独立页面读回状态。结果未知时先查，不要重复提交。 ### 把核验写进指令 核验要求要写到助手无法用“已完成”三个字带过的程度。比如不要写“确认发布成功”，而是写“从帖子详情页读回正文、账号和可见范围，并报告实际值”。 - 页面类：读回标题、H1、账号名称、表格行数、帖子可见范围。 - 文件类：文件存在、可以打开、实际行数、关键字段未失真。 - 写入类：目标记录 ID、修改前后值、提交后的状态。 - 异常类：缺失字段、重复记录、空列表、登录页、错误提示。 ### 什么时候必须停下来 出现验证码、二次验证、权限不足、账号身份不符、页面结构与预期不符、提交结果未知或核验值与目标不一致时，任务应停止并交给人处理。继续猜测、绕过验证或反复提交，可能把一个小问题变成重复发布、重复付款或账号风险。 把这些停止条件写进任务指令，比事后追问“为什么没告诉我”更有效。好的任务描述不仅告诉助手做什么，也告诉它什么时候不该做。 ### 常见问题 **一句话任务能有多长？** 长度不是关键，信息完整才是。一个只读任务可以很短；涉及多个环境或写入时，应把范围、证据和停止条件写全。 **可以让助手自己决定步骤吗？** 可以让它规划，但目标和成功证据必须由你给出。关键写入、权限和不可逆动作应明确限制，不能完全交给执行者自行判断。 **助手说完成了还要核验吗？** 要。执行者的自述不是结果证据；读回页面、文件或记录状态，才能确认任务真的完成。 ### 参考资料 - MatrixFlow 官方网站: https://matrixflow.cn/ - Playwright：可操作性检查: https://playwright.dev/docs/actionability - MDN：文档对象模型（DOM）: https://developer.mozilla.org/en-US/docs/Web/API/Document_Object_Model --- ## 导出 XLSX 之后：文件、行数与页面三方核对 URL: https://docs.matrixflow.cn/guides/export-and-verify/ 摘要：导出成功提示只说明文件被生成。验收要同时看三处：页面上的记录范围与条数、导出文件的字段与行数、关键字段是否保持原样。任何一处不一致，都应标记为未完成并记录差异。 ### 核心结论 - 导出成功不等于数据完整，必须核对页面范围、文件行数和关键字段。 - 订单号、SKU 等文本编号要检查前导零和长数字是否被表格软件改写。 - 交付物应包含文件、读取时间、页面来源和异常清单。 ### 先定义交付范围 在导出之前写清：哪个店铺、哪个账号、什么时间范围、哪些状态、哪些字段、预期大约多少条。范围不清，文件再漂亮也无法判断是否完整。尤其要区分“今天创建的订单”和“今天更新的订单”，两者可能完全不同。 如果页面有筛选条件，记录筛选值；如果分页，记录页数和每页条数；如果列表有隐藏列，确认导出是否包含。验收时以这个范围为准，而不是以文件里碰巧出现的记录为准。 ### 文件层检查 这些检查可以手工完成，也可以由脚本完成。关键是保留一份原始导出文件，不要直接在原始文件上修改分析结果。 - 文件能打开，工作表名称与列头符合约定。 - 实际数据行数与页面条数或预期范围一致。 - 订单号、SKU、运单号保持文本格式，000031 没有变成 31。 - 金额、日期、状态字段没有被自动格式化成语义不同的值。 - 没有多余的空行、重复表头或合并单元格破坏结构。 - 编码正常，中文、符号和特殊字符没有乱码。 ### 页面层抽查 从页面读取第一条、最后一条和中间随机一条记录，与文件对照。检查分页是否读完、列表是否还在加载、筛选是否生效、是否有重复记录。页面显示“共 N 条”时，要确认 N 是当前筛选结果还是全量。 如果页面条数与文件行数不一致，先不要改文件。记录页面 URL、筛选条件、读取时间、页面条数和文件行数，再判断是分页遗漏、重复导出、隐藏记录还是文件写入问题。 ### 不一致怎么记录 差异记录比“导出失败”更有用。它能帮助下一次修正范围、分页或字段映射，也能让接手人知道哪些数据不能直接使用。 - 缺失：页面上有、文件里没有的记录，列出订单号或主键。 - 多余：文件里有、页面范围不应包含的记录。 - 重复：同一主键出现多次，记录重复次数。 - 失真：字段值被改写，例如前导零丢失、金额精度变化。 - 未知：无法判断哪边正确的记录，单独标记，不擅自补齐。 ### 交付物包含什么 一份可用的交付至少包含：导出文件、数据范围说明、页面来源与读取时间、行数与字段核对结果、异常清单。若涉及敏感数据，交付前遮盖买家手机号、地址等信息，并确认接收人有权限。 最后再问一次：这份文件能否被另一个人独立复查？如果不能，说明证据还不完整。 ### 常见问题 **文件能打开就算导出成功吗？** 不算。还要核对行数、字段、文本格式和页面范围；能打开只说明文件没有损坏。 **页面条数和文件行数差几条正常吗？** 不应默认正常。先确认筛选、分页、重复和隐藏记录；无法解释的差异要标记为未完成。 **导出文件可以直接发给客户吗？** 先脱敏并确认授权。订单数据可能包含个人信息，发送前应遮盖无关字段并使用受控渠道。 ### 参考资料 - MatrixFlow 官方网站: https://matrixflow.cn/ - RFC 4180：CSV 格式: https://www.rfc-editor.org/rfc/rfc4180 - MDN：Blob 与文件下载: https://developer.mozilla.org/en-US/docs/Web/API/Blob --- ## 团队交接：权限、环境与任务状态一起交 URL: https://docs.matrixflow.cn/guides/team-handoff-permissions/ 摘要：一次完整交接要让接手人知道“哪个环境对应哪个账号、能做什么、哪些任务没完成、出了问题怎么退回”。环境、平台权限和任务状态分别管理，任何一项缺失都可能造成错操作。 ### 核心结论 - 交接包含环境对应、平台权限、任务状态和回滚方式四块，不只是账号密码。 - 删除本地环境不等于撤销平台权限，成员权限要在平台侧处理。 - 接手人必须实际打开环境、读回账号并完成一个只读任务，交接才算闭环。 ### 交接清单的四块 这四块要放在接手人能找到的地方，而不是散落在聊天记录里。清单可以简短，但每项都要有明确值和负责人。 - 环境对应：环境名称、平台、账号别名、负责人和最近核验时间。 - 权限范围：能查看什么、能修改什么、哪些动作必须审批。 - 任务状态：已完成、进行中、待处理、失败待核验的任务及最后一步。 - 回滚方式：误操作后如何撤销、找谁审批、保留哪些证据。 ### 权限要在平台侧处理 浏览器环境只是本地工作空间。把环境删掉、把电脑收走，并不会自动移除账号在平台上的成员权限。人员离开或职责变化时，应先在平台后台移除或调整权限，再处理本地环境与共享资料。 权限按最小必要分配：需要读数据的人不必拥有发布权限，需要草稿的人不必拥有删除权限。高权限账号应单独管理，操作留记录。 ### 未完成任务怎么写 不要只写“还有几个订单没处理”。要写清任务范围、最后成功的步骤、当前页面状态、已有证据、下一步动作和负责人。例如：“店铺A 今日待发货 12 条，已导出 9 条，剩余 3 条因地址异常待人工确认；文件在交付目录，页面读取时间 10:20。” 如果提交结果未知，要特别标注“先核验，禁止重复提交”。这比一句“可能没成功”更能防止下一位负责人误操作。 ### 接手人的验收动作 验收完成后，接手人应在交接记录上写明实际核验结果，而不是只写“已收到”。如果环境打不开、账号不符或权限缺失，交接应暂停，先解决问题。 - 打开指定环境，核对域名、账号和店铺名称。 - 运行一个只读任务，读取页面标题或指定记录。 - 对照原负责人的记录，确认结果一致。 - 检查未完成任务与异常清单，确认下一步由谁负责。 - 确认权限范围，尤其是写入、发布和删除权限。 ### 敏感信息怎么传 密码、恢复码、API 密钥不要写进环境名称、表格备注、截图或群聊。使用受控的凭据管理或安全渠道传递，交接完成后按团队策略轮换。截图应遮盖个人信息、订单数据和浏览器工具栏中的敏感内容。 最后检查一次共享目录和聊天记录，移除不再需要的敏感文件。交接的目标不是把资料全部转过去，而是让接手人拥有完成工作所需的最小信息。 ### 常见问题 **交接需要原负责人陪同多久？** 取决于任务复杂度。至少应完成一次只读任务验收和一次异常处理演练；高风险写入任务应单独安排复核。 **离职后只改密码够吗？** 不够。还要在平台侧移除权限、检查已保存会话、共享资料和自动化任务，并确认没有遗留的定时任务。 **交接记录要保存多久？** 按团队合规与业务需要决定。至少覆盖任务周期和可能的复查窗口，敏感信息应脱敏或单独保管。 ### 参考资料 - MatrixFlow 官方网站: https://matrixflow.cn/ - MDN：HTTP Cookie 与会话: https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/Cookies - NIST：日志管理指南: https://csrc.nist.gov/pubs/sp/800/92/final --- ## 本站常见问题 **MatrixFlow 第一次使用应该先做什么？** 只建一个环境，手动核对域名、账号和网络，再运行一个只读任务。不要一开始就批量导入环境或执行发布、付款、发货等写入操作。 **浏览器环境和平台账号是一回事吗？** 不是。浏览器环境是本地工作空间，平台账号是网站里的身份。环境名称只能帮助定位，不能代替页面里的账号、店铺名称核对。 **代理连接成功就代表页面可用吗？** 不代表。还要检查目标域名、登录状态、账号权限和业务数据。网络能通、已经登录、有权操作，是三个不同结论。 **为什么任务显示完成，页面却没有结果？** 执行者的自述不是证据。应读回页面或文件确认，常见原因是登录失效、页面结构变化、权限不足或提交未真正生效。 **AI 助手能操作多个窗口吗？** 在 MatrixFlow 中，可以按环境拆分步骤并在后台执行，最终逐窗口核对结果。具体支持范围以当前版本为准，写入类操作仍要单独核验。 **导出的 XLSX 应该检查什么？** 至少检查文件能打开、实际行数与页面一致、关键字段没有丢失，订单号等文本字段保留前导零，异常项有明确记录。 **团队交接需要交什么？** 环境清单、账号对应、权限范围、未完成任务、异常记录和回滚方式。交接后由接手人实际打开页面确认，而不是只看表格。 **这些指南能保证平台不封号吗？** 不能。指南讲的是工作方法与核验边界，账号是否合规取决于平台规则、经营资料和具体操作。任何工具都不应承诺免验证或免处罚。