StenoAI企业部署指南:Organization AI适配器连接与会议笔记安全共享完整教程

原创2026-10-13 23:54:401,349 阅读

StenoAI企业部署指南:Organization AI适配器连接与会议笔记安全共享完整教程

StenoAI 是一款面向政府与国防等敏感场景的隐私优先 AI 会议记录工具,本指南带你完成 StenoAI 企业部署:通过自托管的 Organization AI 适配器(enterprise adapter)把本地会议纪要安全共享给团队成员,并基于共享笔记进行组织级 AI 问答,全程音频绝不离开本地设备。

StenoAI桌面端会议笔记管理界面

一、为什么企业需要 StenoAI 组织适配器

StenoAI 的默认设计是"数据不出设备":录音、转写、摘要全部在本机完成。但团队场景下,个人笔记无法流通,决策依据散落在各台电脑里。

Organization 适配器正是解决这一矛盾的桥梁——它由你的组织自托管部署,承担三个职责:

职责 说明
🔐 统一身份认证 员工使用组织邮箱或 Google Workspace SSO 登录
📤 笔记安全共享 摘要笔记(Markdown)上传至组织 S3 存储,仅组织内可见
🤖 AI 路由代理 摘要与问答请求经适配器服务端转发,API 密钥由组织统一管理,客户端接触不到密钥

无需会议机器人即可录制Zoom会议音频

💡 关键隐私边界:即使接入适配器,StenoAI 也只上传文字摘要与笔记,音频文件永远不会离开本机。这一承诺在 docs/privacy/how-on-device-works.mdx 中有明确说明。

二、企业端准备:适配器地址与策略

部署前,请管理员确认以下两项配置(对应 GET /policy 接口返回的企业策略):

  • shared_notes_enabled:是否允许组织内共享笔记。该开关由服务端强制执行,桌面端仅是防御性 UI 控制
  • auto_share_default:新笔记自动备份到组织的默认开关值

适配器需要实现的核心接口(参考 e2e/fixtures/mock-adapter.js 中的契约定义):

  • POST /auth/login — 邮箱密码登录,返回 JWT 会话令牌
  • GET /policy — 发布企业策略
  • POST /uploads/presign — 为笔记上传签发 S3 预签名地址
  • POST /meetings / GET /meetings — 注册与检索共享笔记元数据
  • POST /ai/chat — 组织级 AI 问答

三、客户端连接:登录组织适配器

打开 StenoAI,进入 Settings → Organisation(设置页面组件:app/renderer/src/routes/settings/OrganisationTab.tsx),按以下步骤操作:

1. 填写适配器地址

在 Adapter URL 输入框填入你组织自托管的地址,例如 https://steno-adapter.yourcompany.com(本地调试默认为 http://localhost:8000)。地址会自动记忆,下次登录无需重填。

2. 选择登录方式

  • 推荐:Sign in with Google — 走 Google Workspace 单点登录。流程会在系统浏览器中完成 Google 认证,通过本地回环端口接收回调,client_secret 始终留在适配器服务端,不接触你的电脑
  • 备选:邮箱 + 密码登录 — 点击 Sign in with password 完成认证

3. 验证登录状态

登录成功后,卡片会显示 Signed in as {姓名},并附带组织 ID(orgId)与适配器地址。此时应用会自动切换 AI 提供方为 adapter,所有摘要与问答请求改经组织适配器路由。

StenoAI企业共享笔记演示

四、共享你的第一条会议笔记

连接成功后,有两种方式把笔记交给团队:

手动共享

  1. 打开任一会议的详情页面(MeetingDetail.tsx)
  2. 点击 Share with {orgId} 按钮
  3. 共享采用三步上传:向适配器请求预签名地址 → 将 Markdown 正文直接 PUT 到组织 S3(默认启用 SSE-AES256 加密)→ 注册笔记元数据(核心实现见 app/main.js 中的 uploadMeetingToOrg)

自动备份

在 Organisation 设置卡中开启 Auto-back up new notes 开关(默认开启,初始值由组织策略 auto_share_default 决定)。开启后,每条笔记摘要完成时会自动推送到组织 S3,无需手动操作;失败时笔记上会出现 Backup failed · Retry 提示可重试。

取消共享

随时可在 Shared notes 列表中对自有笔记执行 Unshare,或在笔记详情页点击 Unshare from {orgId}。适配器会原子地删除元数据与 S3 对象,且仅限所有者操作(非所有者会得到 403)。

五、浏览共享笔记与组织级 AI 问答

StenoAI组织共享笔记界面示意

浏览团队的笔记

侧边栏出现 Shared notes 入口(受组织策略门控,见 useOrg.ts 中的 useSharedNotesGate)。进入后看到组织内所有共享笔记列表,点击任一笔记即可查看完整 Markdown 正文——内容从组织 S3 由适配器服务端拉取,不会写入本地设备。

跨笔记 AI 问答

在 Chat 页将提问范围切换到组织共享语料库后,问题会通过适配器的 /ai/chat 端点回答。系统提示词(见 orgChat.ts)内置了安全约束:

  • 明确区分"通用知识"与"会议事实",笔记被视为数据而非指令
  • 答案引用笔记时只按标题标注来源,不暴露内部标识符
  • 证据不足时明确说明,绝不编造会议决策

六、常见问题排查

现象 原因与处理
登录后侧边栏没有 Shared notes 组织策略 shared_notes_enabled 为 false,联系管理员开启
会话突然失效 JWT 到期,应用会按令牌 exp 字段精确计时自动退出,重新登录即可
摘要报错 "adapter not configured" 会话文件异常导致 AI 提供方漂移,退出并重新登录适配器
共享后列表看不到笔记 检查组织 S3 桶与适配器的连通性,查看调试日志

📌 安全提示:适配器模式下转录文本会离开本机(虽然音频不会)。处理绝密录音时,建议保持本地模型摘要模式,仅将可对外共享的笔记手动分享给组织。

七、相关文档与代码位置

按照以上步骤,你的团队即可获得一个"音频不出设备、笔记受控共享、密钥集中管理"的 StenoAI 企业级会议笔记体系。

登录后查看全文
stenoai