快速开始

                      
                      // Node / Express 示例
import express from 'express';
import { verifyWsa, WsaVerificationError } from '@gptbots/workspace-extension-verify';

const app = express();
app.use(express.json());

app.post('/session/exchange', (req, res) => {
  try {
    const identity = verifyWsa(req.body.wsa, {
      secret: process.env.EXTENSION_APP_SECRET, // 你的密钥（只在后端）
      audience: 'app.example.com',              // 你的应用 host，必须等于令牌 aud
    });
    // identity = { accountId, role, workspaceId, username?, email?, avatar?, appName?, issuedAt?, expiresAt? }

    const sid = createYourSession(identity);    // 换成你自己的 session
    res.cookie('sid', sid, { httpOnly: true, secure: true, sameSite: 'lax' });
    res.json(identity);
  } catch (e) {
    const code = e instanceof WsaVerificationError ? e.code : 'Error';
    res.status(401).json({ code });             // 校验失败一律拒绝
  }
});

                    

                      
                      // 你的落地页
import { consumeHandoff } from '@gptbots/workspace-extension-sdk';

const identity = await consumeHandoff({ exchangeUrl: '/session/exchange' });
// consumeHandoff 依次做了：
// 1) 读取当前 URL 的 ?wsa=
// 2) POST { wsa } 到 /session/exchange（你的后端在这里 verifyWsa）
// 3) 成功后用 history.replaceState 抹掉 URL 里的 ?wsa=
// 4) 返回你后端回传的 identity

console.log('当前工作空间用户：', identity.username, identity.role);
if (identity.role === 'MEMBER') hideAdminUI();

                    

                      
                      工作空间「扩展」页                         GPTBots 平台                你的应用
────────────────                         ───────────                ────────
用户点击你的应用图标 ───────────────────▶ 校验点击人是该工作空间成员
                                          用密钥签一枚 5 分钟有效的 wsa (JWT)
打开 https://app.example.com/?wsa=<JWT> ────────────────────────────▶ 落地页
                                                                     consumeHandoff()
                                          ◀── POST /session/exchange { wsa } ──
                                                                     你的后端 verifyWsa() → identity
                                                                     建立自有 session
                                                                     抹掉 URL 里的 ?wsa=

                    

                      
                      # 解压后，两个包都自带预构建 dist，可直接本地依赖：
unzip workspace-extension-sdk-0.1.0.zip
npm i ./workspace-extension-sdk/packages/verify   # 后端
npm i ./workspace-extension-sdk/packages/browser  # 前端