产品使用说明
OpenPartner 是松粿科技出品的企业级专用智能体平台。每位员工拥有独立的 AI 工作台与工作空间，企业沉淀可治理的 AI 资产，运维从单机平滑扩展到多节点，全程留痕、数据不出企业。
本目录是平台装好之后的使用与运维手册。安装部署请前往「安装」。
截图说明
本目录所有截图取自演示环境。截图中的机构名称、用户名、目录名与业务内容均为演示实例；不同部署因机构设置而略有差异。截图分辨率统一为 1920 × 1080。
一、界面总览
| 分区 | 位置 | 作用 | 详见 |
|---|---|---|---|
| 垂直导航条 | 最左侧 | 全局功能入口，底部为账户菜单 | 本页 · 角色路由表 |
| 工作空间面板 | 左侧上半 | 文件目录树，上传、导入、预览、Git 操作 | 工作空间文件 |
| 任务列表 | 左侧下半 | 会话列表，按今天／昨天／历史分组 | 任务管理 |
| 对话区 | 中间 | 流式对话、思考链、工具调用、产物 | AI对话 |
| 输入区 | 对话区底部 | 智能体、模型、技能、场景、MCP、附件 | 输入区的八个能力位 |
| 右侧面板 | 最右侧 | 仓库管理、会话相关文件、文件预览 | Git 仓库管理 |
| 账户菜单 | 左下角头像 | 我的账户、退出登录、重启智能体、终端模式 | 账户 |
垂直导航条的构成
| 位置 | 图标项 | 可见性 | 指向 |
|---|---|---|---|
| 顶部 | 工作台 | 全员 | 工作台 |
| 中部 | 扩展应用（图标由管理员自定义） | 按扩展启用状态 | 扩展应用 |
| 底部 | 资产 | 仅管理员 | 资产 |
| 底部 | 管理 | 仅管理员 | 管理总览 |
| 底部 | 设置 | 仅管理员 | 管理运维总览 |
| 最底 | 账户菜单 | 全员 | 账户 |
注意 · 非管理员看不到「资产」「管理」「设置」三项，这是设计如此，不是加载失败。
二、角色路由表
从你要做的事出发，而不是从菜单出发：
| 我想做的事 | 打开 | 角色 |
|---|---|---|
| 第一次用，不知道从哪开始 | 快速上手 | 全员 |
| 让 AI 帮我写文档／查代码／出方案 | 工作台 · AI 对话 | 全员 |
| 把 AI 做出来的文件存进公司仓库 | 工作台 · Git 仓库管理 | 全员 |
| 给 AI 喂公司自己的资料 | 工作台 · 导入技能／重要文档 | 全员 |
| 让 AI 调用接入的外部工具 | 工作台 · 接入 MCP 工具 | 全员 |
| 把我的方法沉淀给全公司用 | 资产 · 技能 | 管理员 |
| 接一个大模型厂商进来 | 模型厂商接入 | 管理员 |
| 建一个技能／场景／插件 | 能力配置 | 管理员 |
| 给新同事开账号并分配节点 | 用户与权限 | 管理员 |
| 看谁在用什么、花了多少 token | 使用情况概览 | 管理员 |
| 升级某个节点的程序／镜像 | 节点与升级 | 管理员 |
| 配错了／点不动／报错了 | 节点与升级 · 运维与日志 | 管理员 |
三、功能全景：七层能力
平台的全部配置能力构成七层。层级越低越基础，配置后对所有人生效。
| 层 | 名称 | 配置位置 | 作用 |
|---|---|---|---|
| 1 | 模型厂商 | 设置 → 模型厂商接入 | 接入大模型，决定 AI 有哪些能力 |
| 2 | 智能体 | 设置 → 智能体设置 | 定义 AI 角色、提示词、工具权限 |
| 3 | 场景 | 设置 → 动态场景 | 预置提示词＋工具组合，一键激活 |
| 4 | 插件 | 设置 → 插件管理 | 扩展智能体能力 |
| 5 | MCP 工具 | 设置 → MCP 配置 | 接入外部工具与数据源 |
| 6 | 技能 | 资产 → 技能 | 可复用的工作方法，支持团队共享 |
| 7 | 扩展 | 管理 → 扩展设置 | 嵌入第三方子应用 |
修改后何时生效 · 重启智能体后生效。
四、两种使用模式
| 模式 | 入口 | 适用场景 |
|---|---|---|
| 图形界面（Web） | 浏览器访问平台地址 | 日常办公、绝大多数用户 |
| opencode 终端模式（TUI） | 账户菜单 →「opencode tui 模式」 | 熟悉命令行的研发人员，需要直接操作终端 |
两种模式操作的是同一个智能体容器、同一份工作空间，可以随时切换。
五、术语表
| 术语 | 含义 |
|---|---|
| 工作台 | 左侧导航第一项，承载任务列表与对话区，是日常使用的主界面 |
| 工作空间 | 工作台内的文件目录树，每位用户独立，物理隔离在自己的节点磁盘上 |
| 智能体 | AI 角色定义（含提示词与工具权限），由管理员在「智能体设置」中维护 |
| 用户智能体 | 某位员工独占运行的容器，每个用户一个，可在「用户智能体管理」中启停 |
| 任务 | 一次多轮对话会话，按今天／昨天／历史分组 |
| 节点 | 一台部署了 OpenPartner 的服务器，承载若干用户智能体容器 |
| 场景 | 预置的提示词＋工具组合，激活后自动带入对话 |
| 技能 | 可复用的工作方法（提示词＋脚本），可授权给分组使用 |
| MCP | Model Context Protocol，业界标准协议，用于接入外部工具与数据源 |
| 插件 | 扩展智能体能力的模块，注册后可安装启用 |
| 扩展 | 以 iframe 嵌入的第三方子应用，在左侧导航中显示为独立图标 |
| 分组 | 权限单元。资源（仓库、技能目录、场景）按分组授权，决定谁能看到 |
| 资产 | 可复用的团队能力，即技能与重要文档 |
| 权限弹窗 | AI 需要执行敏感操作时弹出的确认框，由你决定放行一次、总是允许或拒绝 |
术语易混
- 工作台 ≠ 工作空间：前者是界面区域，后者是文件目录。
- 智能体 ≠ 用户智能体：前者是 AI 角色定义，后者是运行容器。
- 全文统一使用「节点」，不会出现 cell 这一内部术语。
六、相关页面
| 页面 | 内容 |
|---|---|
| 快速上手 | 登录、界面导览、5 分钟跑通第一个任务、常见卡点 |
| 安装 · 单机快速部署 | 从零装起一台 |
| 安装 · 多节点部署 | 扩容到多台 |
| 管理运维总览 | 管理员的开工顺序与权限矩阵 |