01 / 产品定位
Talos 适合什么工作
Talos 运行在自己的电脑或服务器上，让模型依照固定方法完成专业任务，交出文件、报告或专业软件里的实际成果。适合设计研发、法律与财税初审、网页信息采集、研究报告与汇报材料制作，也适合把行业方法交付给客户的方案商。
选择一个有明确输入、交付格式和验收人员的任务作为起点。例如，指定合同与审查依据，要求交付风险清单和可追溯引用；或者指定零件参数，要求交付原生模型与独立复核结果。
偶尔问答可使用通用聊天助手；纯软件开发可继续使用编码工具。大规模多租户隔离需要另行设计部署方案。专业结论仍需具有相应资质的人员复核。
02 / 产品方法
五项投入，让工作有依据、有成品
- 行业剧本与资料
- 用 Playbook 固化任务路线、交付契约与治理规则，并绑定可信资料。法律与税务资料需要维护时效和适用范围。
- 驱动专业软件
- 通过 Creo 原生 OTK、桌面操作、浏览器或命令行执行工作。可用性取决于宿主平台、软件版本、授权和工具环境。
- 交付验收
- 检查真实文件、预览和读回结果；CAD 可配合独立几何复核。格式检查不能替代专业判断或审美复核。
- 事实型记忆
- 记忆保留原文依据与版本，支持纠正、撤回和审计。本地向量可关闭；召回质量的独立评估仍在进行。
- 运营与分发
- 服务枢纽提供账号、模型授权、额度、目录发布与设备配对，便于团队或方案商统一维护。
自我学习仍属实验能力。审批和失败处理已有实现，不把“成功生成工具到复用晋级”的完整闭环宣称为已完成验收。
03 / 实施选型
个人桌面、团队网关，还是商业运营
| 形态 | 适用对象 | 实施准备 |
|---|---|---|
个人桌面talos-client | 个人设计、法务、研究工作 | 每台电脑独立保存数据；安装包、模型访问条件和备份位置。 |
团队网关talos | 部门共享实例与扩展 | HTTPS 反代、强制鉴权、受控运行账户、明确权限与共享数据边界。 |
商业运营talos-server | 统一账号、计费、分发与移动配对 | 服务枢纽、PostgreSQL、域名证书、密钥管理及备份恢复流程。 |
部署形态与发行版本分别选择。使用自有或内网模型的团队可选择社区版网关；统一运营的商业客户端连接服务枢纽。先用一个真实场景试点，再扩大并发和用户范围。
资源预算需考虑并发模型请求、Chromium 会话、本地记忆模型与资料增长。浏览器、模型文件和构建缓存各自占用空间，生产机应保留数据盘余量。
04 / 模型来源
商业版与社区版的区别
| 项目 | 商业版 | 社区版 |
|---|---|---|
| 登录 | 使用服务枢纽账号或配对授权 | 无官方账号与会员中心 |
| 模型接入 | 推理通过服务枢纽；模型范围由等级授权决定 | 自行配置供应商、BaseURL 与密钥，可使用内网模型 |
| 运营能力 | 账号、额度、目录分发与服务端内容审查 | 模型采购、访问控制与合规由部署方负责 |
默认构建为商业版。需要自管模型时，应取得对应社区版发行包或采用明确的社区版构建配置。更换部署位置不会自动改变发行版本。
社区版在“设置 → 连接 → 模型服务”添加供应商，选择主模型并探测。小模型可用于任务预判与重排；实际可用模型、上下文窗口和费用以所接服务为准。
05 / 开始使用
安装后，完成首次运行向导
- 从首页的真实发布清单选择匹配平台的安装包。未发布或未验证的平台不视为可下载安装；Windows 优先使用正式安装包。
- 填写用户与助手名称，完成首次使用引导和外观设置。
- 商业版登录账号；社区版配置主模型并进行连通性探测。
- 选择本地记忆模型档位。内网或资源受限环境可先选择“关闭”，保留其他召回方式。
- 检查工作区、默认权限、项目规则与备份位置，再开始任务。
首次配置未完成时，界面可以访问，但定时调度、后台任务恢复与文件监控会暂缓。没有自动执行并不一定是故障，先查看首启阻塞项。
安装包实际提供情况请查看客户端下载。macOS 需要对应构建与签名环境；指南中的平台说明不等同于已发布所有平台安装包。
06 / 环境准备
专业软件与授权需要单独准备
- Creo 建模：需准备兼容的 Windows、Creo Parametric、Pro/TOOLKIT C SDK 与授权，以及构建通道所需的 MSVC x64 环境。先检查通道，再执行建模；工具无法就绪时应停止。
- 桌面操作：依赖操作系统的辅助功能或自动化接口与相应授权。不同桌面会话、权限和平台限制会影响操作结果。
- 浏览器：首次使用可能下载受管 Chromium。内网环境提前准备浏览器；网站登录、验证码、限流与访问政策仍需遵守。
- Linux：桌面客户端需满足 WebKitGTK 与 GTK 依赖；需要命令沙箱的场景需安装
bwrap。 - 资料和字体：准备有权使用且保持更新的行业资料、文档模板和中文字体，交付时检查引用和显示效果。
Talos 安装包不包含第三方专业软件的使用授权，也不保证任意软件版本和网页布局下的自动化兼容性。
07 / 团队方法
用剧本定路线，用技能固化步骤
Playbook（剧本）描述一个领域的身份、任务路线、交付契约、治理规则及资料空间。Skill（技能）承载可复用的具体步骤、脚本与参考材料。MCP连接外部软件与工具。三者按任务组合，新增行业通常无需改动核心。
- 在客户端的剧本或技能管理中查看目录、版本与依赖，确认软件、资料和环境变量已准备。
- 安装可信内容，核对版本和最低客户端要求。分发包摘要不一致或版本不满足时应拒绝安装。
- 用一个小任务确认激活路线、工具权限和交付契约，再交给团队复用。
- 维护资料来源、更新时间与审核人；剧本声明的偏好技能不代表已经随包安装。
实施人员应先以受审查的信任级别接入新 MCP，使用环境变量引用密钥。服务能连接只说明链路可用，仍要确认工具范围与任务依赖。
08 / 交付验收
用成品和证据评估一次试点
选一个已有资料和验收标准的任务，约定输入、输出路径、文件格式、引用要求及人工复核责任。验收至少包括：文件真实存在、预览正常、读回内容一致。
- CAD：核对原生模型、导出文件、尺寸与独立几何证据。已验证操作有明确适用范围，不能外推为任意建模能力。
- 法律与财税：核对原始事实、依据时效和适用范围。正式意见与高风险结论由专业人员复核。
- 报告与演示：检查引用、数字、中文字体与版式。逐页文案或任务摘要不能替代正式文件。
- 网页采集：记录覆盖率、失败率与可恢复状态；遵守网站规则，不把风控失败隐藏为完成。
建议记录首次验收通过率、人工退回次数与可复用步骤。用这些结果决定下一阶段定制或推广范围。
09 / 商业账号
账号、充值与跨端配对
在首页或商业客户端注册、登录后，核对服务端返回的余额、会员等级与可用模型。余额、月度限额和请求速率是不同约束：充值增加余额，并不自动解除等级模型限制或本期月限额。
当前已接入七相支付真实收银台与异步通知，首笔真实实付验收尚未完成。套餐以在线目录为准，付款前确认订单、金额与支付通道；跳转或返回页面不代表已到账，以服务端确认的订单状态及权益为准。遇到延迟时保留订单号，由运营核对查单，避免重复付款。
手机与电脑使用配对码或扫码完成授权。电脑需保持运行、登录有效并有近期心跳，才能接收任务。解绑后中继应停止授权；远程操作具有本机权限影响，仅配对可信设备。
新建手机远程会话使用高信任执行权限。网关形态与桌面形态的验收范围不同，具体环境应先完成一次真实任务验证。不得把配对成功等同于远程任务已完成。
10 / 数据管理
数据保存在本地，也需要备份
安装版桌面使用平台用户数据目录；网关通常使用启动工作目录下的 .talos。两者不能因文件夹名称相近而混作同一份数据。
| 桌面平台 | 默认运行根 |
|---|---|
| Windows | %LOCALAPPDATA%\Talos |
| macOS | ~/Library/Application Support/Talos |
| Linux | ${XDG_DATA_HOME:-~/.local/share}/talos |
数据库、记忆、日志、扩展和状态保存在运行根；备份时还要包含工作区里的实际交付物。按一致性要求备份数据库，不要在进程占用时删除 SQLite 的 WAL / SHM 文件，也不要让多个实例并发写同一运行根。
本地保存不等于数据永不出机。模型请求、联网检索与外部工具会传送任务所需内容；商业版模型请求经过服务枢纽。敏感场景需审核模型服务、外部工具、日志策略与网络边界。
11 / 安全边界
先确定权限，再执行任务
共享或远程环境应显式设置新会话默认权限，使用 default 或经评估的 acceptEdits。当前未配置时可能回落为 dontAsk，不要依赖默认值判断安全。
| 模式 | 使用要点 |
|---|---|
plan | 只规划，阻止有副作用的调用。 |
default | 需要审批；无交互通道时相关操作被阻断。 |
acceptEdits | 允许编辑；部分操作在无交互通道时可按回退策略放行，需评估场景。 |
dontAsk / bypassPermissions | 直接执行，命令与浏览器的沙箱边界也会降低，仅用于明确授权的高信任场景。 |
审批门禁和操作系统沙箱负责不同边界；沙箱不等于隐藏所有宿主文件。高风险工作应叠加受控账户、虚拟机或容器。定时任务与手机远程有特殊执行权限，只配置可信内容。
团队网关对外需强制鉴权与 HTTPS；共享网关密钥只交管理员。备份、日志和截图不要包含令牌、口令、支付密钥或配对码。
12 / 排障与支持
先找到首个错误，再处理后续症状
| 现象 | 先检查 |
|---|---|
| 界面可打开，后台任务不执行 | 首次运行向导是否全部完成。 |
| 需要登录 / 凭据失效 | 重新登录，检查网络与账号状态；不要公开令牌。 |
模型不可用 / model_not_permitted_for_tier | 当前等级授权与可用模型目录，不能仅靠充值解决。 |
quota_exhausted | 余额是否耗尽；充值或联系运营核对额度。 |
monthly_quota_exhausted / rate_limit_exceeded | 月度窗口或请求频率限制，与余额分开排查。 |
| 手机显示电脑离线 | 电脑是否运行、凭据是否有效、近期心跳与守护是否就绪。 |
需要 bwrap / 工具被阻断 | 宿主依赖、会话权限与项目规则，不以全权限模式掩盖问题。 |
安装内容摘要不符 / app_version_too_low | 重新获取可信包，或升级匹配版本，不跳过完整性检查。 |
| 服务在线但上游不可用 | /healthz 仅证明存活；运营应结合 /readyz 与上游账号状态。 |
提交问题时提供什么
提供客户端版本、操作系统、部署形态、首次出现时间、复现步骤，以及首个错误附近的脱敏日志。支付问题附订单号与金额，设备问题附脱敏设备状态。保留失败现场，不提交完整业务资料、密钥或登录凭据。
哪些需要额外约定
行业资料更新、第三方软件授权、内网适配、专业结论复核、多租户隔离和定制交付，应在实施范围中明确。实验能力、未发布安装包和未完成的真实交易验收不作为已验证承诺。