Repository navigation
SkillGo v1.0.0
SkillGo 1.0 聚焦一次性 Skill 任务的完整闭环:导入并发布技能,接收自然语言与附件,在独立沙箱执行,处理可恢复错误,最后将真实成果交付给网页用户或业务 API。
本次为重新发布的 v1.0.0,包含通用自动交付和默认配置调整。此前下载过该版本的用户请重新下载源码包;已有克隆需刷新 v1.0.0 标签。源码发布不会自动更新正在运行的实例。
本次发布重点
遵循 Skill,减少重复规划
- 管理员可按沙箱 Skill 版本开启“沿用 Skill 既定流程”。单 Skill 任务不再强制先生成另一份执行计划。
- 完整 Skill 的准备环节、输入分支、参考资料与自带校验保持原样;模型仍负责理解和执行,需要时可主动规划。
- 多 Skill 任务保留普通规划路径。开关默认关闭,由管理员审核后开启。
- 网页、异步 API 和重试任务均从绑定版本继承联网与既定流程设置;创建后的任务不受后续按钮切换影响。
让交付环节更直接
- 新部署默认使用文件接收模式,复用 Skill 自带检查,省去额外平台验证轮次;需要额外验证时可显式设置
SKILLGO_ARTIFACT_DELIVERY_ONLY=false。 - 通用最终操作交付默认对全部账号、Skill 和文件格式可用,无需版本白名单。
- 模型在最后一组操作执行前声明准确产物路径;全部操作成功、每个文件确为本组新建或内容更新且收集时大小与哈希一致,并满足原有完成条件后,可直接交付,省去独立结束轮次。
- 路径未知、旧文件未变化、操作失败或仍需查看结果时继续普通执行;不会扫描到任意文件就结束。
- 文件接收仍要求安全路径、真实非空文件、大小限制和实际持久化,不代表业务内容或版式通过审核。
- 保留既有工作流交付兼容适配,不修改上传的 Skill 包。
运行与维护
- 支持批量读取、批量命令和连续工作流,避免把确定的命令序列拆成多轮模型确认;工具失败仍交回模型处理。
- 上下文观测只记录统计信息,不增加摘要调用或改变模型输入,默认关闭。
- 持久化快照默认关闭,需要中断恢复的部署可自行启用;关闭快照不等于删除任务日志或最终产物。
- 清理无人调用的函数、旧测试转接入口和前端无效状态,合并重复附件解析,增加前端未使用符号检查。
- README 与执行/API 文档更新,统一前后端版本号为 1.0.0。
1.0 平台能力
Skill 导入与不可变版本、审核发布、多用户权限和审计;私有模型、视觉与 OCR 接入;隔离环境与依赖准备;任务级非 root gVisor 沙箱;进度、取消和重试;真实文件保存与下载;独立 Endpoint、幂等异步任务 API。
平台减少重复工作,实际耗时和产物质量仍取决于模型、Skill 与输入。没有同条件对照证据支持“始终快于其他框架”的承诺。
默认配置
| 设置 | 新部署默认值 |
|---|---|
| 沿用 Skill 既定流程 | 每个版本关闭 |
| 运行联网 | 每个版本关闭 |
SKILLGO_ARTIFACT_DELIVERY_ONLY |
true |
SKILLGO_DELIVERY_ONLY_SKILL_IDS |
空 |
SKILLGO_WORKFLOW_AUTO_DELIVERY_VERSION_IDS |
空 |
SKILLGO_CONTEXT_OBSERVABILITY |
false |
SKILLGO_DURABLE_CHECKPOINTS_ENABLED |
false |
发布不会覆盖已有实例的管理员设置或环境变量。上述开关相互独立,启用方法见 README 和对应文档。
升级到 1.0.0
- 等待任务和环境构建结束,备份数据库、文件存储及部署配置。
- 对照
.env.example和deploy/ecs.env.example保留原实例配置,不直接覆盖密钥。 - 使用固定标签升级 API、Web、Worker 与环境准备服务,按原部署保持副本数。
- 确认数据库版本、健康检查、登录和原 Endpoint 可用,再接收新任务。
标准部署可使用:
sudo SKILLGO_INSTALL_ROOT=/opt/skillgo \
SKILLGO_DEPLOY_ENV=deploy/ecs.env \
bash deploy/upgrade-skillgo.sh v1.0.0若启用了独立 environment-worker,还需在同一空闲维护窗口按原 Compose 配置重建并更新该服务;升级脚本的默认启动路径只覆盖常规 API、Web 与任务 Worker。
相对 v0.4.9,包含增量迁移 20261022_0009_skill_flow_policy,新增版本与任务的 follow_skill_flow 字段,默认 false,不删除已有记录。已经位于 0009 的实例无需重复迁移。服务按现有机制初始化/迁移数据库。
回退到只认识 0008 的旧代码前需要按部署流程处理数据库回退或恢复备份;降级会移除这两个策略字段,不能只替换镜像。
验证
发布提交通过后端测试、前端生产构建与运维检查;准确结果以对应提交的 GitHub Actions 为准。测试包含默认配置、完整验证兼容路径及通用交付的成功和失败边界。
发布由 Git 标签触发,附带 GitHub 自动生成的源码 ZIP/TAR;源码包不包含运行数据、密钥、模型配置或 Skill 私有资产。源码发布不会自动重启已有部署。