在工作台提交和管理应用
个人应用开发者在开发者中心完成接入配置、镜像归档、版本提交、联网调试和上架申请。
超级管理员为个人账号授予“应用开发者”权限后,应用中心会显示“应用开发者工作台”。开发者只管理归属于自己的应用,不会看到或修改其他开发者的应用。进入应用开发者工作台后直接打开默认应用工作台;页面头部始终提供“新建应用”,不需要先经过“我的应用”中转页。
接入流程
- 进入应用开发者工作台,点击“新建应用”,填写应用名称和稳定简称。
- 在“接入与配置”中按顺序阅读“SDK 总览 →
jusp app→ Python/HTTP SDK”,使用jusp app init在已有项目内创建.jusp/app.yaml,再由开发者确认入口、组件、资源和角色;本地模拟不会调用平台或扣积分。 - 在“版本管理”选择 Docker/OCI 镜像归档。上传会话按分片传输;上传失败时按页面提示继续原会话,会话过期后重新选择同一归档。平台检查通过后才会产生可引用的镜像资产。镜像只属于当前版本,开发者不需要接触平台的存放方式。
- 在已有项目目录用
jusp app package生成版本包(.jusp/dist/submission.json),在页面选择生成的 JSON 文件并预览入口、路由、资源和镜像绑定后提交。页面不要求手写平台 JSON,重复点击会复用幂等键,不会创建重复版本。 - “版本管理”使用一张版本表,不把历史版本藏在“处理中”步骤里。点击版本行即可打开详情,不再额外显示“查看与操作”。草稿版本可直接替换版本包和镜像;已上架版本通过“修改本版本”建立同版本修改稿,修改后再提交审核。
- 版本状态由平台返回:草稿、处理中、可提交审核、审核中、已退回、已批准、上架中、已上架或已暂停。页面会显示阻断原因和下一步,不再使用没有动作含义的“准备→检查→开发测试→预发布”步骤条。
- 点击“CLI 配对”生成一次性配对码。联网调试会调用真实模型并从当前账户扣积分;配对页必须展示应用名称、有效期、权限范围和扣费提示,配对凭据只在 CLI 子进程中使用,不写入
.env、日志或版本包。 - 状态为“可提交审核”时申请上架。管理员审核或退回后,页面展示审核结果;新版本失败不会替换当前线上版本。
应用详情的四个分区
- 接入与配置:查看接入合同、本地模拟和 CLI 配对。
- 版本管理:上传与版本一一对应的镜像归档,选择
jusp app package生成的版本包;版本详情同时展示可展开查看的源文件,以及平台翻译后的入口、组件、资源需求、角色和镜像信息。 - 应用角色:定义角色名称与用途;成员绑定由组织管理员完成。
- 基本信息:查看应用名称、稳定简称和线上版本。低频技术标识收在“技术信息”中。
版本包和权限边界
版本包由 jusp app package 根据项目接入文件生成,只声明入口、路由、资源、角色和镜像资产引用,不包含秘密凭据、平台生成名称或镜像字节。平台会保存源文件的文件名、摘要、大小和上传时间,并把解析后的可读信息与版本绑定;这两层信息都可在详情中对照查看。应用角色只表达业务含义,组织成员的绑定由组织管理员负责;开发者不能模拟其他用户,也不能批准或激活版本。
本地模拟永远不扣积分。联网调试使用公网 Runtime 门面和当前账户的正常价格、余额、限流与用量归因;开始前页面会明确提示真实扣费。凭据到期后不能创建新调用,已经创建的异步任务仍可在受控窗口恢复。
提交新版本审核不会影响当前线上版本。只有新版本通过审核、预上架检查和平台激活后,才会成为新的线上版本。
版本状态和可执行动作
| 状态 | 开发者可以做什么 | 管理员可以做什么 |
|---|---|---|
| 草稿 | 编辑、替换源文件、上传/更换镜像、删除草稿、运行检查 | 只读查看 |
| 检查失败 | 查看字段级阻断,修复后重新检查 | 查看失败证据 |
| 可提交审核 | 发起上架申请 | 尚不能直接上线 |
| 审核中 | 查看申请和审计;不能原地覆盖源文件 | 批准或退回 |
| 已退回 | 按意见修改后重新提交 | 查看新申请 |
| 已批准 | 等待平台上线;可在允许条件下申请撤回 | 运行预上架检查并上线 |
| 上架中 | 只读查看部署进度 | 查看运行证据 |
| 已上架 | 修改本版本并提交变更审核,或显式新建下一版本 | 审核修改稿,批准后执行更新线上版本 |
| 已暂停/已撤销 | 查看原因,创建修复版本 | 按策略恢复或保持下线 |
修改已上架版本时,先点击“修改本版本”,平台为同一个版本建立独立修改稿。开发者先更新版本包或镜像并核对前后差异,再按需补充原因并提交审核;修改稿不会形成新的可见版本号。管理员批准后仍需单独执行“更新线上版本”,平台部署成功后才把同一版本切换为修改内容;部署失败时线上旧内容保持不变。只有显式点击“新建版本”才产生新版本。非线上版本的删除申请获批后,该版本会标记为已删除并退出可用版本列表;线上版本必须先下架,删除版本不会卸载另一个运行版本,也不删除应用业务数据。
如何确认没有影响线上版本
版本详情同时展示三组事实:
- 你上传的源文件:文件名、大小、SHA-256、上传时间和可展开查看的 JSON;
- 平台识别结果:应用入口、组件、资源需求、依赖、角色和镜像摘要;
- 平台执行事实:检查、审核、上线、部署状态与操作记录。
三组信息不一致时页面必须明确标红,并禁止申请上线。新版本或同版本修改稿完整通过并成功部署前,旧线上内容继续运行。
开发文档入口
- “应用中心 SDK 总览”:先理解模式、地址和安全边界;
- “应用 SDK 开发、维护与发布指南”:应用需要被其他应用调用时,设计和发布自己的业务 SDK;这是可选分支,平台不代维护应用业务文档;
- “jusp app 使用指南”:已有项目、接入 YAML、镜像 tar 和版本包;
- “Python SDK 入门教程”:安装、本地模拟、真实调试、正式运行、异步任务和应用间调用;
- “应用中心 HTTP 接入指南”:其他语言的完整接入步骤;
- “应用中心 HTTP API 参考”:原始接口、字段、响应和错误码。
第三方开发者只使用 RuntimeSession 和正式 SDK,不需要理解平台部署实现。
常见问题
- 需要处理:草稿版本可直接修改;已提交或已上架版本必须先建立同版本修改稿,修改版本包或镜像后再提交审核,不能绕过修改稿直接覆盖线上内容。
- 版本申请记录:提交、变更、删除和上架申请都会留下申请号、状态、说明和时间;管理员的批准、退回、撤销、上线也会在同一版本审计中出现。
- 镜像上传中断:回到“镜像与版本”,使用原上传会话的“继续上传”;会话过期后重新选择归档。
- 无法申请上架:版本必须处于“可提交审核”,平台检查阻断项为空。
- CLI 配对失败:重新生成一次性配对码;不要复制或保存运行时凭据。
- 看不到别人的应用:这是正常的所有权隔离,每个个人开发者只能管理自己的应用。