应用发布规范

本文档详细介绍微应用发布的完整流程、安全审查规范要求以及相关注意事项，帮助开发者顺利完成应用上架与审核。

发布前准备

在提交应用发布申请之前，开发者必须完成以下自测工作：

极目桌面高度重视用户服务器的数据与系统安全，所有提交发布的微应用均需经过官方安全团队的严格代码审计。请务必遵守以下底线要求：

严禁私自调用线上/外部接口：微应用设计初衷是在用户本地服务器环境运行并直接管理服务器。除极目桌面原生提供的客户端能力外，默认禁止微应用向第三方外部服务器、未报备域名发起私网/公网网络请求。
特殊业务场景例外（需报备说明）：
- 若应用属于 AI 大模型服务类应用（必须调用外部 AI 模型供应商 API），或需要实时抓取官方开源镜像元数据等合理业务场景，可以在代码中调用外部线上接口。
- 必须履行的义务：在提交发版申请时，必须在「版本说明」或应用详情中如实、明确说明调用外部接口的原因、服务提供商及传输的数据类型，供审核团队定向审计。
严禁收集、窃取用户数据：绝对禁止私自上传、收集用户服务器敏感信息（包括但不限于：服务器公私网 IP、SSH 密钥、登录凭据、命令执行历史、业务数据库数据、个人隐私数据等）。一经发现，立即封禁开发者账号并下架全线应用。

严防 XSS 攻击：
- 前端渲染用户输入、日志内容、系统文件内容或执行结果时，必须进行合法的转义过滤，严禁直接使用 v-html、innerHTML 盲目渲染未过滤的富文本内容。
- 严禁通过动态拼接字符串引入外部 <script> 脚本，严禁使用 eval()、new Function() 执行动态代码。
防止命令注入（Command Injection）：
- 后端执行系统底层命令（如使用 Go 的 exec.Command）时，禁止使用危险的 shell 字符串拼接执行（如避免直接调用 sh -c "command " + userInput），必须对入参进行严格的白名单校验与结构化参数传参。
路径穿透防御：
- 操作文件时必须使用模板提供的 pkg/files 工具包或严格检查目标路径是否属于允许目录（如 /.__gmssh/ 下），防止 ../../ 路径穿越读取或覆写服务器关键系统文件（如 /etc/passwd、~/.ssh/）。

在应用正式上架前，需确保应用详情信息的专业与完整：

极目桌面后端已全面升级为 Go 架构：

评估维度	审核核心关注点
安全合规（一票否决）	无 XSS / 命令注入、无非法外网接口调用、绝不收集用户隐私与服务器凭据、安全路径校验
架构规范	Go 后端响应 `ping` 健康检查、Socket 位于 `tmp/app.sock`、持久化数据写入数据隔离目录
功能体验	功能自洽可用，无白屏、阻塞性报错，界面适配浅色/深色主题
文档与信息	应用描述真实准确，若包含外部必要服务（如 AI 接口）已如实附带申请说明