常见问题

产品定位

这和聊天式代码助手有什么区别？

聊天式助手优化的是单次交互的质量。SkyMythos 优化的是一次研发工作能否被组织解释、审计、复现和交接。

具体的差别在于：执行输入被冻结而不是随会话漂移；多个节点是独立会话而不是一个长对话；完成由产物和质量门禁证明而不是由自然语言声明；失败保留谱系可以从明确边界恢复；长期认知进入可审阅的知识空间而不是散落在会话历史里。

它是一个 CI/CD 系统吗？

不是。它覆盖「需求与设计到代码交付」这一段，并与现有代码托管、CI/CD 和发布系统协作。它不接替构建集群，也不接管生产发布。

它是一个 Agent 框架吗？

不是。它是一个控制面：负责身份、版本、策略、沙箱生命周期与交付。Agent 运行时是可替换的组件，通过版本化适配器接入。

为什么不做 DAG 大画布？

因为执行中的任务与会话才是主要工作表面。依赖图用于解释过程，按需展开。把画布作为产品中心会让人以为编排本身就是目标，而实际目标是可交付的工程结果。

部署形态

支持 SaaS 吗？

产品以纯私有化为前提设计。核心控制面、沙箱、模型接入、产物与遥测链路都能在客户环境独立运行，不依赖外部托管服务。

这意味着所有状态权威都必须部署在客户网络内。

最低需要什么？

容器运行时、模型网关，以及生产环境所需的 PostgreSQL 与 S3 兼容对象存储。Kubernetes 路径额外需要集群与预先安装的沙箱前置组件。

可以用我们自己的模型网关吗？

可以，这正是设计目标。平台按能力类别管理网关地址与模型目录，支持多个提供方与协议。模型回退属于网关内部能力，对流程透明。

必须联网吗？

关键路径不依赖公网。模型调用出站到你自己配置的网关。技能与扩展只能来自本地注册表，沙箱禁止在启动时从公网获取能力代码。

能在没有模型的情况下使用吗？

不能。平台不提供内置模型，也不提供规则回退。

安全与治理

提示词或技能可以作为安全边界吗？

不可以，这是明确的架构立场。凭据、工具、网络和高风险副作用必须由平台策略约束。

具体体现为：任务只获得最小接收者注入的凭据；Agent 主进程不直接持有扩展凭据；任务密钥在各组件就绪后立即删除；沙箱禁止在启动时从公网拉取代码；工作范围中的 Agent 不回退到个人凭据。

代码和凭据会被发送出去吗？

代码只在任务沙箱内处理，产物归档到你自己配置的对象存储。凭据加密保存，运行期通过环境变量引用注入，明文不写入配置文件、规格、事件或日志。会话正文默认只随沙箱生命周期存在，不进入业务数据库。

企业可以启用独立加密的会话归档，并按策略保留。

管理员能看到我的个人凭据吗？

不能。访问令牌与密钥加密保存，管理员不能读取明文，接口也不回显。

审计记录包含什么？

发布、撤回、标签移动、任务解析、沙箱物化、连接就绪与返工刷新进入安全审计。密钥、完整提示词与会话正文不进入审计。

运行与失败

任务失败后能从中断处继续吗？

可以恢复，但边界是明确的。在可用沙箱内，可以从用户或门禁决策选定的已开始节点创建新的执行代次。

整个沙箱丢失了会怎样？

任务失败。不做跨沙箱恢复——依赖图状态、会话、产物与工作树位于同一故障域，这是有意的设计取舍。替代方案需要分布式状态机，而当前的复杂度收益不成立。

为什么等待用户输入时不释放沙箱？

因为依赖图状态在沙箱内。释放会丢失执行谱系。这个限制已知，如果未来需要改变，需要新的架构决策。

模型返回空响应怎么办？

按退避启动有限次数的恢复会话。耗尽后保留明确的节点失败，供更新模型或连接器后单独重跑。不会把空响应伪装成完成。

能不能跳过某个必需节点？

不能。跳过必需节点会破坏产物契约的完整性，让下游消费一个从未被生产的东西。这正是产品要消除的那类问题。

知识与记忆

对话历史会自动变成长期知识吗？

不会。进入知识空间的内容必须可追溯、可审阅并具有明确权威来源。完整会话是来源材料，不是知识。

在途任务会因为知识更新而变化吗？

不会。任务创建时冻结知识快照，在途任务不随个人配置或知识更新漂移。但执行期间的知识召回会实时读取最新生效内容并重新检查授权——因此撤权会立即生效。

检索服务挂了会影响任务吗？

已冻结的快照不依赖在线索引，可以继续确定性重放。任务预检在检索服务已配置而不可用时失败关闭；对话则降级到关系数据库检索并标记原因。

知识库更新需要重新发布吗？

知识库不生成整体发布。每篇文档有独立的草稿与发布版本，每次读取实时选择当时有权访问的生效版本。

成熟度与采购

现在可以用于生产吗？

需要区分。仓库已经形成可运行的纵向切片，覆盖领域模型到界面体验的完整链路。但高可用控制面、企业单点登录与审计、生产环境安装升级，以及基于真实外部系统的完整端到端验收仍在建设中。

采购评估时应当按四层验证边界逐项确认，不要以「能部署」或「能跑通一次任务」代替业务验收。

怎么确认某项能力真的可用？

要求提供该能力的第四层证据：真实登录主体使用真实模型网关、Git 服务、连接器或数据面完成对应的读写链路。

前三层——已实现、已通过门禁、已部署——都不能替代它。

没有第四层证据时怎么写？

按目标形态描述，明确标注尚未验证。本手册的用语规则约束产品本身，不只是在文档里。

可以参与贡献吗？

源码、部署说明与架构文档见项目仓库。许可与贡献方式以仓库中的实际说明为准。