StenoAI企业部署指南:Organization AI适配器连接与会议笔记安全共享完整教程
StenoAI企业部署指南:Organization AI适配器连接与会议笔记安全共享完整教程
StenoAI 是一款面向政府与国防等敏感场景的隐私优先 AI 会议记录工具,本指南带你完成 StenoAI 企业部署:通过自托管的 Organization AI 适配器(enterprise adapter)把本地会议纪要安全共享给团队成员,并基于共享笔记进行组织级 AI 问答,全程音频绝不离开本地设备。
一、为什么企业需要 StenoAI 组织适配器
StenoAI 的默认设计是"数据不出设备":录音、转写、摘要全部在本机完成。但团队场景下,个人笔记无法流通,决策依据散落在各台电脑里。
Organization 适配器正是解决这一矛盾的桥梁——它由你的组织自托管部署,承担三个职责:
| 职责 | 说明 |
|---|---|
| 🔐 统一身份认证 | 员工使用组织邮箱或 Google Workspace SSO 登录 |
| 📤 笔记安全共享 | 摘要笔记(Markdown)上传至组织 S3 存储,仅组织内可见 |
| 🤖 AI 路由代理 | 摘要与问答请求经适配器服务端转发,API 密钥由组织统一管理,客户端接触不到密钥 |
💡 关键隐私边界:即使接入适配器,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,所有摘要与问答请求改经组织适配器路由。
四、共享你的第一条会议笔记
连接成功后,有两种方式把笔记交给团队:
手动共享
- 打开任一会议的详情页面(MeetingDetail.tsx)
- 点击 Share with {orgId} 按钮
- 共享采用三步上传:向适配器请求预签名地址 → 将 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 问答
浏览团队的笔记
侧边栏出现 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 桶与适配器的连通性,查看调试日志 |
📌 安全提示:适配器模式下转录文本会离开本机(虽然音频不会)。处理绝密录音时,建议保持本地模型摘要模式,仅将可对外共享的笔记手动分享给组织。
七、相关文档与代码位置
- 官方隐私说明:docs/privacy/how-on-device-works.mdx
- 敏感场景使用建议:docs/privacy/confidential-use-cases.mdx
- 组织会话与共享逻辑:app/renderer/src/hooks/useOrg.ts
- 共享笔记页面:app/renderer/src/routes/OrgShared.tsx
- 企业策略与端到端契约:e2e/fixtures/mock-adapter.js
按照以上步骤,你的团队即可获得一个"音频不出设备、笔记受控共享、密钥集中管理"的 StenoAI 企业级会议笔记体系。



