1. 微应用

菜单路径：高级功能 → 微应用

微应用用于把 HTML、JavaScript、CSS、图片等静态站点文件托管到 ThinkLink，并通过平台预览或发布给组织成员使用。配合动态菜单，可将微应用挂载到左侧菜单。

1.1. 功能与适用范围

微应用适合发布无需独立后端服务的页面，例如：

• 设备数据展示页和轻量看板；
• 项目介绍、运维流程和内部工具页；
• 已构建完成的单页应用静态文件；
• 需要嵌入 ThinkLink 菜单的外部业务前端。

每个微应用由一条应用记录和一组静态文件组成。应用记录定义名称和入口文件，文件管理用于上传实际页面内容。

1.2. 使用前提

• 当前用户需要拥有微应用菜单权限；
• 平台管理员需要确保对象存储服务可用；
• 准备好可直接由浏览器打开的静态站点文件；
• 如果站点由前端工程构建，请上传构建产物，而不是仅上传项目源代码。

如果页面包含访问 ThinkLink 或第三方服务的脚本，还需要确保目标服务允许当前页面来源访问，并避免在页面文件中写入密码、Token 或其他长期凭据。

1.3. 新增应用

1. 进入高级功能 → 微应用。
2. 点击新增。
3. 填写应用信息：

字段	说明
应用名称	列表和动态菜单配置中用于识别应用的名称。
入口文件	访问应用根地址时打开的文件，填写应用内相对路径；默认是 index.html。
备注	可选，用于记录用途、负责人或版本说明。

4. 点击确定保存。
5. 在应用列表中找到新记录，点击文件管理上传页面内容。

新增应用只创建应用记录，不会自动生成可访问的页面。必须上传与入口文件匹配的内容后才能正常预览。

1.4. 上传页面文件

打开应用的文件管理后，可按站点结构选择上传方式。

上传一个或多个文件

1. 如需放入子目录，在上传到的子目录中填写相对目录；上传到根目录时保持为空。
2. 点击上传文件。
3. 选择一个或多个文件并确认。
4. 上传完成后，在文件列表中检查路径和大小。

上传整个目录

1. 点击上传整个目录。
2. 选择本地站点目录。
3. 浏览器会保留目录内的相对层级并上传全部文件。

上传前请确认入口文件位于应用记录所配置的路径。例如入口为 index.html 时，文件列表中应存在根目录下的 index.html；如果入口为 pages/home.html，则应保留对应目录结构。

1.5. 文件管理与在线编辑

文件列表显示应用内相对路径、大小和可用操作。入口文件会显示专门标记。

操作	说明
新建文件	输入应用内相对路径并创建文本文件，例如 index.html 或 js/main.js。
在线编辑	对平台支持的文本文件直接查看和修改内容；二进制文件不会显示此操作。
复制路径	复制当前文件的完整访问地址。未开启分享时，复制的是会自动过期的临时地址。
下载	下载单个文件。
删除	删除当前文件；删除入口文件会导致应用根地址无法正常打开。
打包下载	将整个应用下载为 ZIP，用于备份或迁移。

修改或删除文件后，重新预览应用以确认页面、脚本、样式和图片路径仍然正确。

1.6. 预览应用

1. 返回微应用列表。
2. 在目标应用的操作列点击预览。
3. 平台生成一次有时效的访问凭据，并在新窗口打开入口文件。

预览无需先开启分享，但当前用户必须已登录并拥有访问权限。如果出现空白页或资源加载失败，请依次检查：

• 入口文件是否存在且路径完全一致；
• HTML 中的脚本、样式和图片是否使用应用内正确的相对路径；
• 所需文件是否全部上传；
• 浏览器控制台是否提示跨域、脚本或资源错误。

1.7. 复制访问地址与开启分享

在文件管理中点击复制应用地址，或对单个文件点击复制路径。

未开启分享

平台会生成临时访问地址。该地址会自动过期，适合短时间测试或发给当前协作人员验证，不应作为长期入口保存。

开启分享

1. 在微应用列表中打开目标应用的分享开关。
2. 开启成功后，平台会生成并复制新的分享链接。
3. 之后可点击复制链接再次获取当前分享地址。

安全提示： 开启分享后，任何获得链接的人都可以免登录访问应用。不要在共享应用中放置密钥、个人信息或仅限组织内部的数据。关闭分享会使当前分享链接失效；关闭后重新开启会生成新链接，旧链接不会恢复。

1.8. 下载与备份

• 在应用列表点击下载，或在文件管理顶部点击打包下载，可下载整个应用的 ZIP 包；
• 在文件操作列点击下载，可下载单个文件；
• 在大幅修改或删除应用前，建议先打包下载作为备份。

1.9. 删除应用

1. 在应用列表中找到目标应用。
2. 点击删除。
3. 阅读影响提示并确认。

警告： 删除应用会删除其文件记录，并删除指向该应用的动态菜单以及相关角色授权。该操作不能通过界面撤销。请先打包下载备份，并确认不再需要相应菜单入口。

1.10. 配额与常见问题

限制	当前上限
每个组织的微应用数量	10 个
单个文件大小	10 MiB
单个应用全部文件总量	10 MiB
单次上传总量	10 MiB
单次上传文件数量	300 个

应用列表和文件管理会显示当前用量。达到应用数量上限时，需要先删除不再使用的应用；达到空间上限时，可删除无用文件或压缩图片、脚本等资源后再上传。

现象	检查方法
预览提示页面不存在	检查入口文件路径及对应文件是否存在。
页面打开但样式或图片缺失	检查 HTML 中的相对路径，并确认目录结构完整上传。
其他用户看不到菜单	在动态菜单中启用并显示菜单，再到角色管理授予权限。
复制的地址过一段时间失效	未开启分享时复制的是临时地址；如确需长期免登录访问，可评估安全风险后开启分享。
无法继续上传	检查单文件、单次上传和应用总量是否超过上限。

1.11. 发布到侧边菜单

完成上传并确认预览正常后：

1. 进入高级功能 → 动态菜单；
2. 新增内容来源为微应用的菜单，并选择当前应用；
3. 设置挂载位置、打开方式、排序、显示和启用状态；
4. 进入系统管理 → 角色管理，为目标角色勾选该动态菜单；
5. 使用目标角色账号重新进入组织，确认菜单显示并可以打开。

详细字段说明请参阅动态菜单。