常见问题
登录与账号
无法登录或登录失败
星辰 Cowork 支持账号密码登录和手机验证码登录。
常见原因一：安全软件拦截。
星辰 Cowork 的客户端进程涉及本地进程通信和网络访问，可能被部分安全软件误判为可疑程序，导致启动或登录流程被阻断。
建议处理：临时退出360 安全卫士、电脑管家等安全软件后重试。
常见原因二：网络连接异常。
客户端需要与平台服务端保持通信。如果网络环境存在代理、VPN 或防火墙限制，可能阻断登录请求。
建议处理：关闭代理或 VPN 后重试，或检查防火墙是否放行了星辰 Cowork 的网络访问。
常见原因三：账号状态异常。
账号过期、配额耗尽或权限被回收，也会表现为登录失败。建议联系管理员确认账号状态。
工作空间与文件
升级或重启后，找不到原工作空间文件
星辰 Cowork 的工作空间文件统一存放在用户数据目录下，路径为：
- Windows：C:\Users\{用户名}\AppData\Roaming\astron-cowork\amio-agent\users\{用户ID}\workspaces\
- macOS：~/Library/Application Support/astron-cowork/amio-agent/users/{用户ID}/workspaces/
如果出现找不到文件的情况，通常有以下原因：
文件保存到了其他路径： 如果在对话中指定了其他目录保存文件，该文件不会出现在默认工作空间内。建议使用文件管理器的搜索功能，按文件名或创建时间定位。
工作空间目录被手动移动或删除：如果曾手动操作过 astron-cowork 目录下的文件夹，可能导致文件丢失。建议将重要文件定期备份到独立目录。
APA 录制器
接口调用失败，疑似参数不匹配（动态参数、签名、加密）
现象：录制一次后生成的技能，复用时接口返回错误，参数似乎对不上。
原因：部分企业系统接口包含动态参数（时间戳、随机数、设备信息）、请求签名或加密数据。仅录制一次，Cowork 难以区分哪些是固定参数、哪些是动态变化的。
解决方案：
- 将关键能力单独录制，用不同业务数据重复操作多次，让 Cowork 对比多轮请求，自动识别参数变化规律。
- 技术人员可配合通过 Network 控制台检查请求与响应，帮助确认签名、加密和接口依赖关系。
- 如果仍然无法稳定复现，缩小能力范围，分别生成和测试关键接口；对于只能通过页面触发的能力，使用浏览器插件桥接执行。
录制内容太多，生成技能后能力边界不清晰，测试困难
现象：一次录制了很长很完整的业务流程，但生成出来的技能包功能混乱，不知道哪些能力可用、哪些有问题。
原因：流程过长导致 Cowork 分析时难以清晰划分能力边界，也增加了调试难度。
解决方案：
- 一开始录制内容不要太多，只做一个简单场景或首页的部分功能，先把基本技能框架搭建好。
- 将完整流程拆分为查询、创建、修改、提交、审批、下载等原子能力，分别录制并验证。
- 第一次录制优先覆盖最常见的正常流程，后续再通过补充录制增加条件分支和异常处理。
- 各项原子能力稳定后，再由 Agent 根据业务任务自由组合。
手动添加模型后，图片理解或上下文压缩等功能异常
现象：自行添加了 OpenAI / Anthropic 协议的模型，但图片理解、上下文压缩等能力不工作。
原因：手动添加模型可能缺失模型基本信息（如是否支持视觉、上下文长度等），导致 Cowork 无法正确调用。
解决方案：
- 尽量使用「获取模型列表」功能拉取模型（标准协议的模型提供商都支持），而不是手动填写。
- 如果必须手动添加，确保补全模型的基本信息，否则建议使用官方内置模型服务。
页面包含 Canvas、电路图、拖拽等特殊组件，录制效果不理想
现象：Canvas 画布、电路拓扑图、拖拽组件、虚拟列表、富文本编辑器等页面元素，录制后无法稳定回放。
原因：这类组件没有标准 DOM 控件结构，录制和定位难度远高于普通表单。
解决方案：
- 优先让 Cowork 判断是否存在可直接调用的底层接口——如果能识别，将其生成为更稳定的纯代码能力。
- 如果必须依赖页面操作：放慢操作速度，围绕关键动作进行补充录制，并通过浏览器插件桥接执行。
- 涉及拓扑关系、坐标计算或特殊数据结构时，与技术人员协作效率更高。
超大表单场景，生成的技能填写不准确
现象：包含大量字段、条件联动和校验规则的表单，模型一次性生成的结果出现漏填、格式错误、字段对应不准。
原因：完全依赖模型一次生成全部字段，对模型生成准确性要求很高。
解决方案：
- 此类场景建议与技术人员协作开发，效率更高。
- 先用小规模数据测试，确认字段映射和执行结果正确后再扩大范围。
- 对于提交、删除、付款等高风险操作，增加预览和人工确认环节。
跨系统联动时，数据字段对应不上（CRM ↔ ERP ↔ OA）
现象：同一客户在不同系统中字段名不同（如 CRM 叫 clientName，ERP 叫 customer），编码不一致，直接传递数据出错。
原因：各系统独立建设，没有统一的字段映射标准。
解决方案：
- 通过多次录制、深度分析录制数据，将字段对应关系和转换规则沉淀到技能说明中。
- 先完成单个系统的能力验证，再由 Agent 自由组合多个技能实现跨系统流转。
初版 APA 生成完了，但不确定哪些能力能用、哪些需要补充
现象：技能包生成后，不知道覆盖面是否完整，有些功能可能处于「待验证」或「部分可用」状态。
原因：初版 APA 仅基于单次录制生成，未必覆盖所有业务情况。
解决方案：
- 直接问 Cowork：「当前生成了哪些能力？」
- 询问 Cowork：「哪些能力还需要补充录制？」
- 让 Cowork 测试：「请测试这个技能并分析失败原因。」
- 让 Cowork 更新：「请根据新的录制内容修复并更新技能。」
技能包发布后存在安全风险（账号、Cookie、敏感数据泄露）
现象：录制内容可能包含测试账号、Cookie、Token、客户数据等敏感信息，直接发布到团队市场会泄露。
原因：录制过程会采集所有请求和页面状态，包括认证凭证和业务数据，如果不加审查直接发布，敏感信息会随技能包一起分发。
解决方案：
- 录制时使用测试账号，遵循最小权限原则。
- 发布前检查技能包中是否包含固定账号、认证信息或真实业务数据。
- 认证凭证应由运行环境安全注入，不应直接写入技能包。
- 涉及写入、删除、付款、审批等操作，增加权限校验、执行记录和人工确认。
使用与文件
什么是技能？
技能是针对特定任务预设的专业工作流，例如内容创作、数据分析或信息整理，可以帮助用户更高效地完成具体工作；Cowork中也内置了一些技能哦
对话删除后还可以恢复吗？
不会，会话不会保留，但会话过程中的文件会保留，可在当前空间目录下找到该文件内容。
日志在哪里查看
Astron Cowork 的系统日志通常存放在应用数据目录中，如 C:\Users\zhangsan\AppData\Roaming\astron-cowork\logs\
在哪里进行问题反馈
在 Astron Cowork 界面的左下角，找到“举报与投诉”入口，支持图片形式上传
支持哪些文件格式？
支持处理 Word、Excel、PPT、PDF、HTML、图片、音频、代码脚本等常见格式，具体能力以当前页面展示为准。
生成的文件打不开
星辰 Cowork 支持生成多种格式的办公文档，系统会根据你的任务描述调用对应的专项技能来完成输出。如果你在下达任务时没有明确指定输出格式，助手可能会默认采用文本或 Markdown 格式交付，导致你期望的应用程序无法直接打开该文件。
建议： 在任务描述中直接说明你需要的文件格式，例如"生成一份 Word 文档""导出为 Excel 表格""输出为 PDF 文件"，系统会据此选择正确的输出方式。
插件
插件安装后仍然使用不了
扩展安装后需要手动启用：浏览器扩展安装后，浏览器通常会弹出确认栏（"是否添加扩展"），用户如果不点确认，扩展实际没装上，但 Astron 这边可能以为安装流程已走完。
内核版本过低
若浏览器内核落后，Astron 扩展安装后功能异常或直接无法运行。但页面提供了多个不同的插件，可切换其他浏览器进行插件安装。
计划任务
关闭客户端后计划任务还会执行吗
云侧计划任务在服务端运行，关闭客户端不影响执行；端侧任务依赖本地环境（本地文件、桌面软件、本机登录态），需保持客户端运行。创建任务时按场景选择执行位置。
计划任务没有按时执行，或结果没收到
原因/描述：任务未启用、客户端未在线（计划任务依赖本地服务触发）、或任务绑定的工作空间已失效。
解决方法：在计划任务列表确认任务状态为启用；保持客户端在线；检查任务绑定的工作空间是否存在；每次执行会生成独立记录，可在执行记录中查看过程与结果。
其他
存储文件的位置可以更改吗
这个工作空间路径是系统预设的固定位置，可以定期删掉不再需要的生成文件、临时导出、大附件等，可以与星小妙对话帮忙批量处理。
Cowork 支持接入哪些即时通讯工具
支持企业微信、钉钉、飞书。各渠道对话记录独立，但数字员工记忆跨渠道共享
是否支持语音输入？
支持。用户可以通过语音描述需求或下达任务，减少文字输入和操作步骤。