让每一位员工都拥有
专属的 AI 知识伙伴

坡鹿设计了两种运行模式：

• 本地优先（默认）：所有对话、记忆、知识库数据全部存储在本地 SQLite 数据库（%APPDATA%\PoLu\jarvis.db），企业内部可完全离线运行。
• LLM 接口配置：LLM 调用走企业指定的 API endpoint，可以是云服务，也可以是企业内部自建的模型服务——这完全由管理员配置决定，坡鹿本身不强制连接任何外网。

坡鹿的多租户隔离分三层：

• 标签层：conversations/memories 表加 tenant_id + owner_user_id；knowledge_regions 加 tenant_id + department_id + classification。
• SQL 层：所有查询自动拼接 WHERE tenant_id = ?，写入时校验当前用户身份是否匹配。guest 角色禁写任何数据，不可见的密级 region 直接拒写。
• 身份层：每一条消息在入队前被解析为 securityContext（tenantId + userId + role + departmentId），后续处理全程携带，不允许静默降级。

任何跨租户查询——哪怕是 SQL 注入试图绕过——都会在 WHERE 条件处被拒绝。

完全不需要。安装后默认就是单用户模式——loopback 请求自动注入主用户 admin 上下文，你零配置就能用。多租户是在企业有多个部门/子公司/分公司需要数据隔离时才需要开启的。

切换分 4 步：

1. 脑界面工具栏点 🏢 打开管理端
2. 概览页顶部「运行模式」面板 → 点"切换为多租户模式"
3. 确认后管理端 toast 提示"请重启坡鹿应用"
4. 完全退出后重新启动即可

数据库 schema 两套模式完全兼容，切换不需要初始化或迁移。旧对话的 tenant_id 是 T:000001，在正确租户身份下依然可见。

管理端随安装包一起打包，不需要额外安装。路径是 http://127.0.0.1:3721/admin/ui（或 polu.hnsunny.cn/admin/ui）。

5 个页签覆盖全部运维操作：

• 概览：运行模式切换、租户列表、统计数据
• 用户：按租户筛选，新增/编辑/停用用户
• 租户部门：新增租户 → 新增部门（支持父子层级）
• 绑定：渠道身份绑定（微信/飞书 open_id）
• 会话：签发 token / 撤销 token

从管理端签发会话 token（只显示一次）→ 管理员把 token 发给员工 → 员工在脑界面点工具栏 👤 → 粘贴 token → Enter 即可。后续所有请求自动带上 Authorization Bearer header。切换用户重新粘贴新 token，登出点"清除 token"按钮。

坡鹿开发版未购买 EV 代码签名证书（预计上线前补齐），Windows SmartScreen 会提示"Windows Defender SmartScreen 已阻止未经常运行的应用"。两种解决方式：

• 方式一（推荐）：右键 PoLuSetup.exe → 属性 → 勾选"解除锁定" → 应用 → 确定，然后双击安装
• 方式二：SmartScreen 弹窗 → "更多信息" → "仍要运行"

不会。坡鹿升级和卸载都不碰用户数据目录，三层保护：

1. 物理隔离：应用代码装在 C:\Program Files\PoLu\，用户数据（jarvis.db、config.json、知识库索引、LLM API Key 等）全部在独立目录 %APPDATA%\PoLu\。升级只覆盖应用目录。
2. schema 迁移幂等：每次启动运行时遇到新字段都是 ALTER TABLE ... ADD COLUMN 包在 try { } catch { } 里——跑 1 次、10 次、N 次都不变坏，只增不改。
3. NSIS 卸载配置：deleteAppDataOnUninstall: false，卸载也不会删除用户数据。

升级前建议手动备份 %APPDATA%\PoLu\jarvis.db，作为额外保险。

坡鹿支持两种运行模式，管理员可在管理端一键切换：

• 单用户模式（默认）：适合个人或小团队。所有入站消息默认映射到主用户，共用一套记忆和会话。零配置启动。
• 多租户模式（形态 B）：适合企业部署。每个员工一个账号（账号下挂专属助手，独立记忆、独立会话），部门知识库在部门内共享、跨部门强制拦截。

形态 B 部署步骤：

1. 一台常开的主机（Windows 16G+ SSD），安装坡鹿 → 托盘菜单勾「开机自启」→ 运行模式切多租户
2. 🏢 管理端 → 建租户 / 部门
3. 🏢 管理端 → 租户 / 用户 → 创建员工账号（带邮箱 + 初始密码）
4. 员工在自己的电脑上装坡鹿 → 脑界面 👤 登录 → 用邮箱密码登录自己的身份

员工换电脑登录同一个账号，会话和记忆跟着人走，不跟着机器走。