roncarve-official-web/箴言助手-Chat-Assistant-产品页设计文档.md

箴言助手 Chat Assistant 产品页设计文档

1. 产品命名与定位

• 中文名：箴言助手
• 英文名：Chat Assistant
• 产品定位：连接企业数据、领域知识、业务工具与表达策略，为垂直行业提供有依据、可落地、可追溯的智能建议。
• 演示场景：保险顾问服务与保障建议。
• 扩展方式：用新的业务数据、知识资源、技能、工具、意图、表达模板和治理策略替换保险资源包，复用对话、编排、权限、观测与审计底座。

2. 当前项目能力总结

以下总结以 D:\workspace\bankchat 当前代码、README 和设计文档为依据。产品页只表达代码中已经存在的能力边界，不把路线图能力包装成现状。

2.1 对话与上下文

• 新建、保存和查询会话，按会话加载最近历史消息，并支持较早上下文摘要。
• 通过 SSE 流式输出回答、工具调用与模型原生 thinking 状态；模型不支持 thinking 时明确降级，不影响正式回答。
• 支持在输入中显式选择已发布技能及产品、活动、权益对象，并将控制信息与用户正文分开存储。
• 支持用户档案和表达风格偏好，风格只调整语言表达，不覆盖事实、合规规则和工具结果。

2.2 业务事实与建议

• 保险演示场景复用客户与客户画像、产品、活动、权益查询能力，并以保障建议方式呈现。
• Agent 可把会话问题、历史上下文、业务查询结果与合规表达资源组合为建议。
• 快捷动作采用白名单和确定性工具预执行，数据库管理工具元数据，运行体仍由代码控制。

2.3 可配置的行业资源体系

• 意图、技能、工具、方案、表达模板、内容、字典与策略均具有独立资源模型。
• 资源支持启用、发布、版本历史和回退，并可在解决方案总览中查看关系。
• 行业扩展不依赖改造聊天外壳，核心工作是建立新的数据对象、行业技能、业务工具与表达策略。

2.4 数据接入与治理

• 数据源支持配置、连通性测试、启停与历史记录。
• 数据范围支持同步、预览、发布与停用，运行时通过受控目录查询。
• 字段元数据、敏感字段保护和查询审计形成数据访问边界。

2.5 模型与运行配置

• 使用 OpenAI-compatible API，可配置不同厂商的 Base URL、模型和调用参数。
• 模型配置支持连通性测试、激活、历史版本与回退，敏感凭据由后端加密存储和脱敏展示。

2.6 分析、追踪与审计

• 会话效果分析包括概要、时序、意图、工具和会话记录。
• Trace 记录资源选择、工具调用、模型节点、状态与耗时，支持问题回放。
• 管理操作进入追加式审计事件，并提供查询、详情、选项与完整性校验能力。

2.7 身份与权限

• 浏览器统一通过 Java 网关访问，Python Agent API 仅承载编排与流式生成。
• 支持 Roncarve IAM OIDC Authorization Code + PKCE 登录与显式应用准入。
• 外部身份按 (issuer, subject) 绑定，不按邮箱自动合并；系统管理员、管理员和普通用户职责分离。

3. 产品页信息架构

1. Hero：用“让行业经验，成为每一次决策的底气”建立核心价值，并展示真实产品对话界面。
2. 六大能力：企业数据、领域知识、智能建议、来源追溯、行业扩展、安全合规。
3. 行业扩展：以保险为演示示例，交互切换制造、零售和专业服务场景。
4. 落地路径：连接、理解、建议、追溯。
5. 安全可信：统一身份、数据范围与审计观测。
6. 转化区：邮件预约产品演示。

4. 视觉方向

• 参考“荣刻驭境”的品牌层级、导航比例、大标题力度和企业级质感。
• 与荣刻驭境的深色粒子主题区分，采用白色与浅灰蓝基底、荣刻蓝主色和克制薄荷绿辅助色。
• 首屏使用选定方案 1 的真实产品工作台视觉；正文使用清晰分隔、充足留白和少量表面层级，不堆叠卡片。
• 桌面端以左右分栏为主；移动端改为单列，能力与流程按阅读顺序展开。
• 中英文共享同一信息架构，并持久化语言偏好。

5. 实现范围

• 新增 /products/chat-assistant/ 多页应用入口。
• 新增响应式 React 产品页、行业场景交互、移动导航和中英文切换。
• 首页产品菜单增加“箴言助手”入口。
• 更新 Vite 多页构建、Nginx 规范路径和站点地图。
• 通过现有 Docker Compose 在 127.0.0.1:8081 提供本地预览。