项目概览
本指南系统介绍了在企业级SaaS平台（如Confluence、Jira、Dify、VSCode、GitLab）及内部知识库（dp）框架内，利用平台扩展机制开发自定义Web功能模块的工程实践。内容涵盖六大平台的定位、扩展机制、前端技术栈，以及核心设计思想，包括沙箱隔离、声明式与命令式混合、平台即基础设施、原生嵌入优于外部链接、API-First架构和渐进式复杂度。指南详细阐述了各平台的核心原理与开发流程，如Confluence的Forge宏机制、Jira的Forge App模块体系、dp知识库的API集成与iframe嵌入方案、Dify的Plugin架构、VSCode的Extension与Webview架构，以及GitLab的Web IDE与Editor Extension路径。此外，还提供了系统架构图、能力矩阵、数据流时序图、真实应用场景、工程落地速查表、安全注意事项、优缺点与局限分析，以及常见误区澄清，为开发者提供了从理论到实践的全面参考。
解决什么问题
本指南针对企业在已有企业级SaaS平台（如Confluence、Jira、Dify、VSCode、GitLab）或内部知识库（dp）框架内开发自定义Web功能模块的需求，系统梳理了相关工程实践。报告指出，传统做法存在六大痛点：重复造轮子（每个系统都要自己做用户管理、权限、通知、搜索）、用户体验割裂（用户在不同平台间来回切换）、部署运维成本高（自建Web应用需服务器、域名、HTTPS、监控、备份）、权限体系不互通（自建系统难以与已有平台权限打通）、数据孤岛（工单、文档、AI对话数据无法联动）、响应速度慢（从提需求到上线需数周）。平台扩展机制可将上线周期缩短至天或小时级。
工作方式
指南详细介绍了六大平台的扩展机制与开发路径。Confluence和Jira基于Atlassian Forge平台，通过宏（Macro）或App模块嵌入，前端使用React + UI Kit或Custom UI，后端逻辑通过Resolver函数实现，数据存储使用Storage API。dp知识库无标准化扩展机制，提供三种方案：API集成（推荐，通过REST API读写文档，可用Webhook监听事件）、iframe嵌入（最简单但用户体验较差）、浏览器扩展（适合平台不开放API的场景）。Dify采用Plugin架构，分为Tool Plugin（给Agent增加工具能力）、Model Plugin（接入自定义模型）、Extension Plugin（扩展平台功能），开发语言为Python ≥ 3.12。VSCode采用Extension + Webview架构，Extension Host（Node.js进程）与Webview（独立iframe）通过postMessage双向通信。GitLab提供两条路径：Web IDE Extension Marketplace（基于VSCode Server，支持VSCode扩展）和Editor Extension（VSCode/JetBrains插件，通过REST/GraphQL API交互）。
核心能力
- 沙箱隔离，代码运行在安全环境中，不影响平台内核
- 声明式配置（manifest）与命令式业务逻辑分离
- 平台即基础设施，直接调用平台API，无需自建用户、权限、通知系统
- 原生嵌入优于外部链接，功能长在平台内
- API-First架构，前后端解耦
- 渐进式复杂度，从iframe嵌入逐步升级到平台原生扩展
- Confluence支持UI Kit（低复杂度、自动审核）与Custom UI（高灵活性、人工审核）
- Jira支持多种挂载点：工单面板、操作菜单、全局面板、仪表盘小组件、项目页、管理页
- Dify Tool Plugin通过execute()方法实现工具调用，结果回传LLM
- VSCode Webview支持React/Vue/原生HTML，通过消息机制与Extension Host交互
- GitLab Web IDE扩展运行在沙箱容器中，与实例隔离
- 提供六平台能力矩阵，对比原生UI嵌入、后端逻辑、数据存储、API访问、权限继承、热更新、离线可用等能力
使用前需要了解
- AI 整理 · 本地测试，未经人工复核；依据历史报告节选，不代表当前产品状态。
- 本指南为技术概述与开发指南，不包含具体项目的实现代码或配置细节。报告明确指出了五个不建议使用的场景：需要大量前端交互的复杂应用（建议做独立Web应用）、需要实时WebSocket长连接（Forge不支持，VSCode Webview也受限）、需要访问本地文件系统（平台沙箱隔离）、需要高性能计算（Forge Resolver有25秒超时限制）、需要绕过平台API直接操作数据库（平台不允许）。此外，各平台存在特定局限：Confluence Forge不支持Server/Data Center，Custom UI审核慢（人工审核3-5天），Storage API有容量限制；Jira Forge同样不支持Server/Data Center，Resolver冷启动有延迟；dp知识库需自建服务器并处理权限认证，无标准化扩展机制；Dify Plugin仅支持Python ≥ 3.12，前端能力弱，插件间依赖管理不成熟；VSCode Extension Host可能影响IDE性能，Webview安全限制严格；GitLab Web IDE扩展生态远不如VSCode Desktop，部分Extension API不可用。报告还指出，Atlassian Connect已进入淘汰通道，官方计划2025-2026年逐步停用，新项目应使用Forge。
