Initial commit: GovAI 政务AI平台

This commit is contained in:
freedakgmail
2026-06-15 23:48:37 +08:00
commit 0f490f72a9
245 changed files with 51669 additions and 0 deletions
+316
View File
@@ -0,0 +1,316 @@
# 应用类型标准规范
本文档定义了政智通平台各类型应用的数据格式、UI模式和配置标准。新增应用时必须按照对应类型的标准配置。
---
## 一、对话型 (chatbot)
**UI 模式:** 左侧对话历史列表 + 中间对话区域 + 底部输入框
**适用场景:** 政策问答、法规咨询、通用问答类应用
### 数据库字段标准
| 字段 | 必填 | 说明 |
|------|------|------|
| `dify_app_type` | ✅ | 值为 `chatbot` |
| `welcome_message` | ✅ | 首次进入时的欢迎语,如"您好!我是XXX助手。" |
| `suggested_prompts` | ✅ | JSON数组,3-4条推荐提问,显示为可点击按钮 |
| `app_config.system_prompt` | ✅ | 系统提示词,定义AI角色和回答风格 |
| `app_config.model` | 可选 | 模型名称,默认 `qwen-plus` |
| `app_config.temperature` | 可选 | 温度参数,问答类建议 0.2-0.4 |
| `app_config.max_tokens` | 可选 | 最大输出token数 |
### 示例配置
```json
{
"app_config": {
"system_prompt": "你是一个政策法规智能问答助手,熟悉中国各级政府的法律法规和政策文件。请准确、严谨地回答用户的政策法规相关问题。",
"model": "qwen-plus",
"temperature": 0.3,
"max_tokens": 4000
},
"welcome_message": "您好!我是政策法规智能问答助手。您可以向我咨询各类法律法规和政策条款。",
"suggested_prompts": [
"最新的行政处罚法有哪些变化?",
"营商环境优化相关政策有哪些?",
"政府信息公开条例的适用范围?"
]
}
```
### UI 截图要素
- 顶部:应用图标 + 应用名称 + 描述 + 右侧类型标签"对话型"
- 左侧:`+ 新对话` 按钮 + 对话历史列表
- 中间:欢迎消息气泡 + 推荐提问按钮
- 底部:输入框 + 发送按钮
---
## 二、公文写作型 (chatbot + DOC_WRITER_SLUGS)
**UI 模式:** 公文类型卡片网格 + 底部输入框
**适用场景:** 公文拟稿、公文写作助手
**触发条件:** `slug` 必须加入前端 `DOC_WRITER_SLUGS` 集合
### 数据库字段标准
| 字段 | 必填 | 说明 |
|------|------|------|
| `dify_app_type` | ✅ | 值为 `chatbot` |
| `slug` | ✅ | 必须注册到前端 `DOC_WRITER_SLUGS`,如 `official-doc-writer``fagai-doc-writer` |
| `app_config.system_prompt` | ✅ | 包含《党政机关公文格式》(GB/T 9704) 相关指引 |
| `welcome_message` | ✅ | 如"您好!我是公文写作助手" |
| `suggested_prompts` | ✅ | 公文写作相关的推荐提问 |
### 前端注册
`apps/web/src/app/(portal)/chat/[appId]/page.tsx` 中:
```typescript
const DOC_WRITER_SLUGS = new Set(["official-doc-writer", "fagai-doc-writer"]);
```
### 示例配置
```json
{
"app_config": {
"system_prompt": "你是一个专业的公文写作助手,精通《党政机关公文格式》国家标准(GB/T 9704)。请按照规范格式帮助用户拟稿各类公文。"
},
"welcome_message": "您好!我是公文写作助手。我可以帮您拟稿各类公文,并确保格式符合标准。",
"suggested_prompts": [
"帮我起草一份工作通知",
"拟一份关于年度总结的报告"
]
}
```
### UI 截图要素
- 顶部:应用图标 + 名称 + 描述 + 右侧"公文写作"标签
- 左侧:`+ 新建公文` 按钮 + 历史记录
- 中间:**选择公文类型**标题 + 12种公文类型卡片网格(通知、请示、报告、批复、函、通报、意见、决定、会议纪要、公告、科技项目申报通知、科技奖励通报)
- 底部:输入框 + 发送按钮
---
## 三、工作流型 (workflow)
**UI 模式:** 步骤进度条 + 分步表单 + 上一步/下一步按钮
**适用场景:** 按步骤收集信息后生成报告/方案的应用
### 数据库字段标准
| 字段 | 必填 | 说明 |
|------|------|------|
| `dify_app_type` | ✅ | 值为 `workflow` |
| `app_config.app_type` | ✅ | 值为 `workflow` |
| `app_config.steps` | ✅ | JSON数组,定义每个步骤的表单字段 |
| `app_config.system_prompt` | ✅ | 系统提示词 |
| `welcome_message` | 可选 | 步骤开始前的提示语 |
### steps 字段格式
每个step包含:
```json
{
"key": "字段标识",
"label": "步骤标题",
"type": "text | textarea | select",
"description": "步骤描述(可选)",
"placeholder": "输入提示",
"required": true,
"options": ["选项1", "选项2"] // type为select时必填
}
```
### 示例配置
```json
{
"app_config": {
"system_prompt": "你是项目可行性研究专家。请根据用户提供的项目信息,生成专业规范的可行性分析内容。",
"model": "qwen-plus",
"temperature": 0.3,
"max_tokens": 6000,
"app_type": "workflow",
"steps": [
{
"key": "project_name",
"label": "项目名称",
"type": "text",
"placeholder": "如:XX产业园基础设施建设项目",
"required": true
},
{
"key": "project_type",
"label": "项目类型",
"type": "select",
"options": ["基础设施", "产业发展", "社会事业", "生态环保", "科技创新"],
"required": true
},
{
"key": "background",
"label": "项目背景",
"type": "textarea",
"placeholder": "项目建设的背景、必要性、政策依据等",
"required": true
}
]
}
}
```
### UI 截图要素
- 顶部:返回按钮 + 应用图标 + 名称 + 描述 + 右侧"工作流"标签
- 步骤条:圆形标记 + 步骤名称 + 箭头连接
- 表单区域:步骤标题 + 输入控件(文本框/选择器/多行文本)
- 底部:上一步/下一步按钮
---
## 四、补全型 (completion)
**UI 模式:** 左侧输入区 + 右侧输出区
**适用场景:** 文本处理、摘要提取、翻译等单次输入输出型应用
### 数据库字段标准
| 字段 | 必填 | 说明 |
|------|------|------|
| `dify_app_type` | ✅ | 值为 `completion` |
| `app_config.input_label` | ✅ | 输入区域标题,如"文件内容" |
| `app_config.output_label` | ✅ | 输出区域标题,如"核心摘要" |
| `app_config.input_placeholder` | ✅ | 输入框占位文本 |
| `app_config.system_prompt` | ✅ | 系统提示词 |
### 示例配置
```json
{
"app_config": {
"input_label": "文件内容",
"output_label": "核心摘要",
"system_prompt": "你是一个政务文件分析专家。请对提供的文件进行分析,输出包含:一句话概要、核心要点、关键数据摘录、政策影响分析、行动建议。",
"input_placeholder": "粘贴需要提取摘要的文件内容..."
}
}
```
### UI 截图要素
- 顶部:应用名称 + 描述 + 右侧类型标签"补全型"
- 左侧:输入标签 + 大文本输入框
- 右侧:输出标签 + 结果展示区域
- 底部:提交按钮
---
## 五、智能体型 (agent)
**UI 模式:** 类似chatbot,但带有工具调用能力展示
**适用场景:** 需要调用多个工具进行综合分析的应用
### 数据库字段标准
| 字段 | 必填 | 说明 |
|------|------|------|
| `dify_app_type` | ✅ | 值为 `agent` |
| `app_config.tools` | ✅ | 可用工具列表,如 `["数据检索", "趋势分析", "报告生成"]` |
| `app_config.system_prompt` | ✅ | 包含工具调用说明的系统提示词 |
| `welcome_message` | ✅ | 说明具备的能力 |
| `suggested_prompts` | ✅ | 推荐提问 |
### 示例配置
```json
{
"app_config": {
"tools": ["数据检索", "趋势分析", "对比分析", "报告生成"],
"system_prompt": "你是一个综合研判智能体,服务于政府部门的数据分析和决策支持。你具备以下工具能力:1.数据检索 2.趋势分析 3.对比分析 4.报告生成。"
},
"welcome_message": "您好!我是综合研判智能助手。我具备数据检索、趋势分析、对比分析和报告生成等能力。",
"suggested_prompts": [
"分析本季度经济运行数据",
"对比去年同期各项指标变化"
]
}
```
### UI 截图要素
- 顶部:应用图标 + 名称 + 描述 + 右侧"智能体"标签
- 左侧:`+ 新对话` 按钮 + 对话历史
- 中间:欢迎消息(含能力说明)+ 推荐提问 + 工具调用标记展示
- 底部:输入框 + 发送按钮
---
## 六、PPT生成型 (ppt_generator)
**UI 模式:** 文件上传/文本输入 + PPT预览
**适用场景:** 将文档/文本内容转换为PPT
### 数据库字段标准
| 字段 | 必填 | 说明 |
|------|------|------|
| `dify_app_type` | ✅ | 值为 `ppt_generator` |
| `app_config.app_type` | ✅ | 值为 `ppt_generator` |
| `app_config.default_config` | ✅ | PPT默认配置(风格、格式、页数等) |
| `welcome_message` | ✅ | 说明支持的输入方式 |
### 示例配置
```json
{
"app_config": {
"app_type": "ppt_generator",
"system_prompt": "你是一个专业的演示文稿设计专家。",
"default_config": {
"style": "general",
"format": "ppt169",
"page_count": 10,
"with_images": true
}
},
"welcome_message": "您好!我是智能PPT生成助手。请上传源文件或粘贴文本内容,我将为您生成专业的PowerPoint演示文稿。"
}
```
---
## 通用规范
### 分类图标与颜色
所有机构的相同类型分类应使用统一的图标和颜色,在 `apps/web/src/lib/category-config.ts` 中配置:
| 分类类型 | 图标 | 颜色 |
|---------|------|------|
| 公文写作 | `FileSignature` | `bg-blue-100 text-blue-800` |
| 政策解读 | `Scale` | `bg-indigo-100 text-indigo-800` |
| 数据分析 | `BarChartBig` | `bg-emerald-100 text-emerald-700` |
| 便民服务 | `HeadphonesIcon` | `bg-amber-100 text-amber-700` |
| 组织人事 | `UserCog` | `bg-sky-100 text-sky-700` |
| 招商引资 | `TrendingUp` | `bg-violet-100 text-violet-700` |
| 翻译外事 | `Languages` | `bg-teal-100 text-teal-700` |
| 综合应用 | `LayoutGrid` | `bg-gray-100 text-gray-700` |
### 命名规范
- 新机构分类slug格式:`{机构缩写}-{功能}`,如 `fagai-writing``gongan-policy`
- 应用名统一使用"XX助手"或"XX生成"格式
- 同类应用跨机构使用相同名称(如所有公文写作应用都叫"公文写作助手")
### 详情页 long_description 格式
使用 Markdown 格式,推荐结构:
```markdown
## 功能介绍
简要描述功能:
- 功能点1
- 功能点2
- 功能点3
## 使用方法
使用说明文字。
```
+787
View File
@@ -0,0 +1,787 @@
# 政智通(GovAI)— 项目全景总结
> **文档编号**DOC-MGT-009
> **版本**v1.1.0
> **生成日期**2026-05-23
> **最后更新**2026-05-23
> **状态**:已发布(Published
---
## 1. 项目概述
**政智通(GovAI** 是一个面向政府部门的 AI 智能应用平台,旨在提升行政效能、赋能智慧政务。平台支持多机构多租户,内置知识库 RAG、多种 AI 应用类型(对话 / 补全 / 工作流 / 智能体 / PPT 生成),为不同政务场景提供一站式 AI 解决方案。
### 1.1 核心定位
| 维度 | 说明 |
|------|------|
| **品牌名称** | 政智通(GovAI),由企业版「Aily」演进而来 |
| **目标用户** | 政府各局委办工作人员(科技局、公安局、发改局、律所、信访局等) |
| **核心价值** | 一站式政务 AI 应用商店 + 知识库 + 创作者平台 |
| **部署模式** | 私有化部署,前后端分离 |
### 1.2 功能全景
```
┌─────────────────────────────────────────────────────┐
│ 政智通 平台 │
├──────────┬──────────┬──────────┬─────────────────────┤
│ 应用商店 │ 工作台 │ 创作中心 │ 知识库管理 │
│ (Store) │(Workspace)│ (Create) │ (Knowledge) │
├──────────┴──────────┴──────────┴─────────────────────┤
│ 管理后台 (Admin) │
│ 数据总览 │ 应用管理 │ 审核队列 │ 用户管理 │ 审计日志 │
├─────────────────────────────────────────────────────┤
│ AI 引擎层 (LLM / RAG / PPT) │
│ 通义千问 │ 向量嵌入 │ 知识库检索 │ PPT Master │
└─────────────────────────────────────────────────────┘
```
---
## 2. 技术架构
### 2.1 整体架构
采用 **Go 后端 + Next.js 前端 + Python PPT Worker** 的三层架构:
```
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ Next.js │────▶│ Go API │────▶│ PostgreSQL │
│ 前端 │ │ Server │ │ (pgvector) │
│ :3000 │ │ :8080 │ │ │
└──────────────┘ └──────┬───────┘ └──────────────┘
┌──────┴───────┐ ┌──────────────┐
│ Redis │────▶│ PPT Worker │
│ 消息队列 │ │ (Python) │
│ │ │ :8090 │
└──────────────┘ └──────────────┘
┌──────────────┐
│ MinIO │
│ 对象存储 │
└──────────────┘
```
### 2.2 技术栈总览
| 层级 | 技术 | 版本 |
|------|------|------|
| **后端框架** | Go + Chi Router | Go 1.25、Chi v5 |
| **数据库** | PostgreSQL + pgvector | PG 17 |
| **缓存/队列** | Redis | 7.x |
| **ORM/SQL** | sqlc 代码生成 + pgx | pgx v5 |
| **前端框架** | Next.js (App Router) | 16.2.6 |
| **UI 框架** | React + TypeScript | React 19.2.4、TS 5 |
| **CSS 方案** | Tailwind CSS v4 | v4CSS-first 配置) |
| **组件库** | shadcn/ui (base-nova) | v4.7.0 |
| **状态管理** | Zustand + TanStack React Query | Zustand 5、RQ 5 |
| **AI/LLM** | 通义千问 (DashScope) | OpenAI 兼容接口 |
| **向量嵌入** | text-embedding-v3 | DashScope |
| **PPT 引擎** | PPT Master (Python) | FastAPI + python-pptx |
| **对象存储** | MinIO | — |
| **认证** | JWT + 多机构切换 | golang-jwt v5 |
### 2.3 数据流
```
用户操作 → Next.js 前端
→ /api/* 代理 → Go API Server
→ PostgreSQL(持久化)
→ Redis(缓存/PPT队列)
→ DashScope APILLM推理)
→ pgvector(向量检索/RAG
→ SSE 流式响应 → 前端实时渲染
```
---
## 3. 项目目录结构
```
GovAI/
├── .cursorrules # Cursor IDE 工作流规则
├── .env.example # 根级环境变量模板
├── README.md # 项目主文档
├── run.md # 运行说明与测试账号
├── 政务AI平台调整方案.md # 品牌/分类调整方案
├── Makefile # 开发/构建/迁移统一入口
├── server/ # ========== Go 后端 ==========
│ ├── .env # 后端环境配置(已配置)
│ ├── go.mod / go.sum # Go 依赖
│ ├── sqlc.yaml # sqlc 代码生成配置
│ ├── cmd/
│ │ ├── server/
│ │ │ ├── main.go # 服务入口
│ │ │ └── router.go # 路由定义(API v1
│ │ └── embed-chunks/
│ │ └── main.go # 文档分片/向量化 CLI 工具
│ ├── internal/
│ │ ├── config/config.go # 配置加载
│ │ ├── handler/ # HTTP 处理器(13 个模块)
│ │ ├── middleware/ # 认证/RBAC/限流/审计中间件
│ │ └── response/response.go # 统一响应格式
│ ├── pkg/
│ │ ├── auth/ # JWT、密码哈希、SSO
│ │ ├── chunker/ # 文档分片器
│ │ ├── db/ # 数据库连接 + sqlc 查询
│ │ ├── dify/ # Dify 集成客户端
│ │ ├── embedding/ # 向量嵌入服务
│ │ └── llm/ # LLM 提供商(OpenAI/Anthropic
│ └── migrations/ # 迁移文件 + 种子数据(49 个)
├── apps/
│ └── web/ # ========== Next.js 前端 ==========
│ ├── package.json # 前端依赖
│ ├── next.config.ts # Next.js + API 代理配置
│ ├── components.json # shadcn/ui 配置
│ └── src/
│ ├── app/ # App Router 页面
│ │ ├── error.tsx # 全局错误边界
│ │ ├── loading.tsx # 全局加载状态
│ │ ├── not-found.tsx # 404 页面
│ │ ├── (auth)/ # 登录/注册
│ │ ├── (portal)/ # 商店/工作台/知识库/创作/聊天
│ │ │ ├── error.tsx # Portal 错误边界
│ │ │ └── loading.tsx# Portal 加载状态
│ │ └── (admin)/ # 管理后台各页面
│ │ ├── error.tsx # Admin 错误边界
│ │ └── loading.tsx# Admin 加载状态
│ ├── components/
│ │ ├── app-ui/ # 各应用类型 UI 组件
│ │ ├── app-card/ # 应用卡片组件
│ │ ├── layout/ # Header 布局
│ │ └── ui/ # shadcn 基础组件(20+
│ ├── hooks/ # 可复用自定义 Hooks
│ │ ├── use-sse-stream.ts # SSE 流式解析
│ │ ├── use-copy-clipboard.ts# 剪贴板复制
│ │ ├── use-scroll-bottom.ts # 自动滚动
│ │ ├── use-file-export.ts # 文件下载导出
│ │ ├── use-app-config.ts # 应用配置解析
│ │ └── index.ts # 统一导出
│ ├── lib/ # API 客户端、类型、工具函数
│ │ └── types.ts # 统一类型定义(全局)
│ └── stores/auth.ts # Zustand 认证状态
├── ppt-worker/ # ========== PPT 生成服务 ==========
│ ├── app.py # FastAPI HTTP 入口
│ ├── worker.py # Redis 队列 Worker
│ ├── pipeline.py # PPT Master 管线
│ ├── requirements.txt # Python 依赖
│ └── Dockerfile # 容器化配置
├── docker/ # ========== Docker 配置 ==========
│ ├── docker-compose.yml # PG + Redis + MinIO + PPT Worker
│ └── docker-compose.dify.yml # Dify AI 引擎(可选)
└── docs/ # ========== 项目文档 ==========
├── UI-STYLE-GUIDE.md # UI 风格规范
├── APP-TYPE-STANDARD.md # 应用类型标准
├── add-domain-guide.md # 新增行业领域指南
└── ... # 其他技术文档
```
---
## 4. 前端架构详解
### 4.1 路由结构
| 路由组 | 路径 | 页面 | 守卫 |
|--------|------|------|------|
| `(auth)` | `/login` | 登录页 | 无 |
| `(auth)` | `/register` | 注册页 | 无 |
| `(portal)` | `/store` | 应用商店首页 | 需登录 |
| `(portal)` | `/store/category/[slug]` | 分类应用列表 | 需登录 |
| `(portal)` | `/store/apps/[slug]` | 应用详情页 | 需登录 |
| `(portal)` | `/chat/[appId]` | 应用运行页 | 需登录 |
| `(portal)` | `/workspace` | 工作台(最近+收藏) | 需登录 |
| `(portal)` | `/create` | 创作中心 | 需登录 |
| `(portal)` | `/knowledge` | 知识库管理 | 需登录(creator/admin |
| `(admin)` | `/dashboard` | 数据总览 | 需 admin |
| `(admin)` | `/apps` | 应用管理 | 需 admin |
| `(admin)` | `/reviews` | 审核队列 | 需 admin |
| `(admin)` | `/users` | 用户管理 | 需 admin |
| `(admin)` | `/analytics` | 使用分析 | 需 admin |
| `(admin)` | `/audit` | 审计日志 | 需 admin |
| `(admin)` | `/models` | 模型管理 | 需 admin |
| `(admin)` | `/security` | 安全管理 | 需 admin |
### 4.2 应用类型与对应 UI 组件
| 应用类型 | UI 组件 | 交互模式 | 核心能力 |
|----------|---------|----------|----------|
| **chatbot(对话型)** | `ChatbotUI` | SSE 流式多轮对话 | 文件上传、对话导出、历史管理 |
| **completion(补全型)** | `CompletionUI` | 单次输入→流式输出 | 格式模板选择、历史侧边栏 |
| **workflow(工作流)** | `WorkflowUI` | 多步骤表单→汇总生成 | 步骤引导、参数校验 |
| **agent(智能体)** | `AgentUI` | SSE 流式+工具调用 | 工具标记解析、执行状态展示 |
| **公文写作** | `DocWriterUI` | 模板→表单→流式生成 | Word/TXT 导出、后续对话修改 |
| **研判分析** | `AnalysisUI` | 模板→向导→流式生成 | Word/MD 导出、追问优化 |
### 4.3 状态管理
```
┌─────────────────────────────────────────┐
│ 状态管理架构 │
├────────────┬────────────┬───────────────┤
│ Zustand │ React Query│ Component │
│ 全局认证 │ 服务端数据 │ 局部 UI 状态 │
├────────────┼────────────┼───────────────┤
│ • user │ • 应用列表 │ • 表单数据 │
│ • token │ • 分类数据 │ • 对话消息 │
│ • org │ • 统计信息 │ • 流式状态 │
│ • login() │ • 5min缓存 │ • 侧边栏切换 │
│ • logout() │ • retry=1 │ • 加载状态 │
│ • switchOrg│ │ │
└────────────┴────────────┴───────────────┘
```
### 4.4 自定义 Hooks
| Hook | 文件 | 用途 | 使用组件 |
|------|------|------|----------|
| `useSSEStream` | `use-sse-stream.ts` | SSE 流式响应解析(buffer 管理、事件解析、conversation_id 提取) | chatbot/agent/completion/workflow/doc-writer/analysis |
| `useCopyToClipboard` | `use-copy-clipboard.ts` | 剪贴板复制 + toast 提示 | chatbot/agent/completion/doc-writer/analysis |
| `useScrollToBottom` | `use-scroll-bottom.ts` | 消息列表自动滚动到底部 | chatbot/agent/doc-writer/analysis |
| `useFileExport` | `use-file-export.ts` | 文件下载导出(Blob + URL.createObjectURL | chatbot/agent/doc-writer/analysis |
| `useAppConfig` | `use-app-config.ts` | 解析 app.app_config JSON 配置 | completion/workflow/agent |
| `useSuggestedPrompts` | `use-app-config.ts` | 解析 app.suggested_prompts | chatbot/agent |
工具函数:
- `updateLastAssistantMessage()` — 更新消息列表中最后一条 AI 消息的内容
- `setStreamErrorMessage()` — 流式失败时设置错误提示消息
### 4.5 错误边界与加载状态
| 文件 | 层级 | 功能 |
|------|------|------|
| `app/error.tsx` | 全局 | 捕获未处理的渲染错误,显示错误标识、重试和返回按钮 |
| `app/loading.tsx` | 全局 | 全屏加载 Spinner |
| `app/not-found.tsx` | 全局 | 404 页面,引导用户返回应用中心 |
| `app/(portal)/error.tsx` | Portal | 应用侧错误边界,保留 Header 导航 |
| `app/(portal)/loading.tsx` | Portal | 应用侧加载状态(适配 Header 高度 3.5rem |
| `app/(admin)/error.tsx` | Admin | 管理后台错误边界 |
| `app/(admin)/loading.tsx` | Admin | 管理后台加载状态 |
### 4.6 统一类型定义
所有业务类型集中定义在 `lib/types.ts`,按模块分组:
| 分组 | 类型 |
|------|------|
| 核心业务 | `App``KnowledgeBase``Category``PaginatedResponse``ChatMessage``Conversation``Rating` |
| 对话/流式 | `Message``DeleteTarget` |
| 智能体 | `ToolCall` |
| 补全型 | `FormatTemplate` |
| 工作流 | `WorkflowStep` |
| 公文写作 | `DocTemplate``TemplateField``SelectOption` |
| 研判分析 | `AnalysisTemplate``TemplateStep``StepField``FieldOption` |
| 用户/认证 | `User``Organization` |
| 管理后台 | `AdminApp``Review``AuditLog``OverviewStats` |
### 4.7 前端依赖
| 类别 | 包名 | 版本 | 用途 |
|------|------|------|------|
| 框架 | `next` | 16.2.6 | SSR/SSG 框架 |
| 视图 | `react` / `react-dom` | 19.2.4 | UI 渲染 |
| 状态 | `zustand` | 5.0.13 | 全局状态管理 |
| 数据 | `@tanstack/react-query` | 5.100.9 | 服务端数据缓存 |
| UI | `shadcn` | 4.7.0 | 组件库 CLI |
| 样式 | `tailwindcss` | v4 | CSS 框架 |
| 样式 | `tailwind-merge` / `clsx` | 3.5.0 / 2.1.1 | 样式合并 |
| 图标 | `lucide-react` | 1.14.0 | 图标库 |
| 主题 | `next-themes` | 0.4.6 | 暗色模式 |
| Markdown | `react-markdown` / `remark-gfm` | 10.1.0 / 4.0.1 | Markdown 渲染 |
| 通知 | `sonner` | 2.0.7 | Toast 提示 |
| 命令面板 | `cmdk` | 1.1.1 | 搜索/命令 |
| 日期 | `date-fns` | 4.1.0 | 日期处理 |
| 动画 | `tw-animate-css` | 1.4.0 | CSS 动画 |
---
## 5. 后端架构详解
### 5.1 API 路由总览(`/api/v1`
#### 认证模块
| 方法 | 路径 | 说明 |
|------|------|------|
| POST | `/auth/register` | 用户注册 |
| POST | `/auth/login` | 用户登录 |
| POST | `/auth/refresh` | Token 刷新 |
| POST | `/auth/logout` | 用户登出 |
| GET | `/auth/me` | 获取当前用户 |
| PUT | `/auth/profile` | 更新用户信息 |
| POST | `/auth/switch-org` | 切换机构 |
#### 应用商店
| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/store/categories` | 获取分类列表 |
| GET | `/store/apps` | 获取应用列表(分页/搜索) |
| GET | `/store/featured` | 推荐应用 |
| GET | `/store/rankings` | 热门排行 |
| GET | `/store/recent` | 最近使用 |
#### 应用交互
| 方法 | 路径 | 说明 |
|------|------|------|
| POST | `/apps/{id}/chat` | 对话/智能体(SSE 流式) |
| POST | `/apps/{id}/completion` | 补全(SSE 流式) |
| POST | `/apps/{id}/generate-doc` | 公文生成(SSE 流式) |
| POST | `/apps/{id}/generate-analysis` | 研判报告(SSE 流式) |
| GET | `/apps/{id}/conversations` | 对话历史 |
| POST | `/apps/{id}/feedback` | 用户反馈 |
| POST | `/apps/{id}/favorite` | 收藏/取消 |
| POST | `/apps/{id}/rating` | 评分 |
#### 创作中心
| 方法 | 路径 | 说明 |
|------|------|------|
| GET/POST | `/creator/apps` | 创作者应用 CRUD |
| POST | `/creator/apps/{id}/submit-review` | 提交审核 |
| GET | `/creator/templates` | 应用模板 |
#### 知识库
| 方法 | 路径 | 说明 |
|------|------|------|
| GET/POST | `/knowledge` | 知识库 CRUD |
| POST | `/knowledge/{id}/documents` | 上传文档 |
| POST | `/knowledge/{id}/reindex` | 重建索引 |
| POST | `/knowledge/{id}/reembed` | 重建向量 |
#### 管理后台
| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/admin/analytics` | 使用分析数据 |
| GET/PUT | `/admin/apps` | 应用上下架管理 |
| GET/PUT | `/admin/reviews` | 审核队列 |
| GET/PUT | `/admin/users` | 用户角色/状态管理 |
| GET | `/admin/audit-logs` | 审计日志 |
### 5.2 后端依赖
| 包 | 版本 | 用途 |
|----|------|------|
| `go-chi/chi` | v5.2.5 | HTTP 路由 |
| `go-chi/cors` | v1.2.2 | 跨域处理 |
| `golang-jwt/jwt` | v5.3.1 | JWT 认证 |
| `jackc/pgx` | v5.9.2 | PostgreSQL 驱动 |
| `redis/go-redis` | v9.19.0 | Redis 客户端 |
| `rs/zerolog` | v1.35.1 | 结构化日志 |
| `google/uuid` | v1.6.0 | UUID 生成 |
| `joho/godotenv` | v1.5.1 | 环境变量加载 |
| `golang.org/x/crypto` | v0.51.0 | 密码哈希 |
### 5.3 Handler 模块(13 个)
```
handler/
├── auth.go # 认证(登录/注册/切换机构)
├── store.go # 应用商店(列表/搜索/排行)
├── app_usage.go # 应用使用(聊天/补全/生成)
├── conversation.go # 对话历史管理
├── creator.go # 创作中心
├── knowledge.go # 知识库管理
├── ppt.go # PPT 任务管理
├── admin_app.go # 管理后台-应用
├── admin_review.go # 管理后台-审核
├── admin_user.go # 管理后台-用户
├── admin_analytics.go# 管理后台-统计
├── admin_audit.go # 管理后台-审计
└── template.go # 模板管理(公文/分析)
```
---
## 6. 数据库设计
### 6.1 迁移版本
| 版本 | 文件 | 内容 |
|------|------|------|
| 000001 | init | 用户表、部门表 |
| 000002 | categories_and_applications | 分类、应用、应用配置 |
| 000003 | reviews_and_favorites | 评价、收藏 |
| 000004 | usage_logs | 使用日志 |
| 000005 | models_quotas_audit | 模型、配额、审计日志 |
| 000006 | ppt_tasks | PPT 任务表 |
| 000007 | doc_templates | 公文模板 |
| 000008 | conversation_naming | 对话命名 |
| 000009 | knowledge_base_id | 知识库 ID 字段 |
| 000010 | document_content | 文档内容存储 |
| 000011 | usage_messages | 使用消息记录 |
| 000012 | organizations | 多机构表 |
| 000013 | multi_tenant | 多租户改造 |
| 000014 | — | 最新迁移 |
### 6.2 种子数据
| 文件 | 内容 |
|------|------|
| `seed.sql` | 基础分类、默认应用 |
| `seed_keji.sql` | 科技局专属数据 |
| `seed_gongan_*.sql` | 公安局应用与知识库 |
| `seed_fagaiju*.sql` | 发改局应用与知识库 |
| `seed_legal*.sql` | 律师事务所(14 个应用+4 个知识库) |
| `seed_xinfang*.sql` | 信访局(10 个应用+4 个知识库) |
| `seed_ppt.sql` | PPT 生成应用 |
| `seed_multi_tenant_users.sql` | 多机构用户账号 |
| `seed_doc_templates.sql` | 公文模板 |
| `seed_analysis_templates.sql` | 分析报告模板 |
---
## 7. PPT 生成服务
### 7.1 架构
```
用户提交 PPT 任务 → Go API → Redis 队列 → Python Worker → PPT Master
MinIO 存储 ← 生成 PPTX
```
### 7.2 功能特性
| 特性 | 说明 |
|------|------|
| **输入格式** | PDF、Word、网页 URL、纯文本 |
| **演示风格** | 通用、咨询、顶级咨询 |
| **幻灯片格式** | 16:9 宽屏、4:3 传统、竖版 |
| **AI 生图** | 通义万相(可选) |
| **输出** | 原生可编辑 PPTX 文件 |
### 7.3 技术栈
- **Web 框架**FastAPI + uvicorn
- **任务队列**Redis
- **PPT 引擎**PPT Master(外部项目)
- **PPT 生成**python-pptx
- **图片生成**:通义万相 (wanx)
- **LLM**:通义千问(内容大纲生成)
---
## 8. 多机构多租户
### 8.1 支持的机构
| 机构 | 角色配置 | 专属应用数 |
|------|----------|-----------|
| 科技局 | super_admin + admin + creator + user | 默认应用集 |
| 公安局 | admin + creator + user | 专属应用 |
| 发改局 | admin + creator + user | 专属应用 |
| 教育局 | admin + user | — |
| 人社局 | admin + creator + user | — |
| 财政局 | admin + user | — |
| 住建局 | admin + creator + user | — |
| 市监局 | admin + creator + user | — |
| 律师事务所 | admin + creator + user | 14 个法律应用 |
| 信访局 | admin + creator + user | 10 个信访应用 |
### 8.2 角色权限模型
| 角色 | 权限 |
|------|------|
| `super_admin` | 全平台管理权限,跨机构管理 |
| `admin` | 机构管理权限(应用审核、用户管理、数据分析) |
| `creator` | 可创建和发布应用 |
| `user` | 使用应用和知识库 |
---
## 9. 应用分类体系
### 9.1 通用分类(10 个)
| 分类 | 说明 | 典型应用 |
|------|------|----------|
| 公文写作 | 公文拟稿、会议纪要、文件摘要 | 公文写作助手、会议纪要生成 |
| 政策解读 | 法规问答、政策影响分析 | 政策法规问答、政策影响分析 |
| 政务宣传 | 宣传稿件、信息发布 | — |
| 数据治理 | 数据分析、综合研判 | 综合研判助手 |
| 便民服务 | 群众来信回复、咨询答复 | 群众来信回复 |
| 信息化工具 | 开发辅助、系统运维 | — |
| 组织人事 | 干部考核、人事管理 | 干部考核助手 |
| 招商引资 | 项目评估、投资分析 | 招商项目评估 |
| 翻译外事 | 中英互译、外事用语 | 翻译助手 |
| 综合应用 | 其他政务场景 | — |
### 9.2 行业专属分类
- **律师事务所**:法律服务(对标 iCourt Alpha
- **信访局**:信访受理、政策答复、矛盾调解、督查督办
---
## 10. 预置应用清单
### 10.1 通用应用(11 个)
| 应用 | 类型 | 分类 |
|------|------|------|
| 政策法规问答 | 对话型 | 政策解读 |
| 公文写作助手 | 对话型 | 公文写作 |
| 群众来信回复 | 对话型 | 便民服务 |
| 会议纪要生成 | 补全型 | 公文写作 |
| 公文摘要提取 | 补全型 | 公文写作 |
| 翻译助手 | 补全型 | 翻译外事 |
| 招商项目评估 | 工作流 | 招商引资 |
| 政策影响分析 | 工作流 | 政策解读 |
| 综合研判助手 | 智能体 | 数据治理 |
| 干部考核助手 | 智能体 | 组织人事 |
| 智能PPT生成 | PPT生成 | 综合应用 |
### 10.2 律师事务所应用(14 个)
| 应用 | 类型 | 增强等级 |
|------|------|----------|
| 法律法规检索 | 对话型 | P0(类案综述、参照标注) |
| 法律咨询助手 | 对话型 | P0(结构化报告、风险预测) |
| 合同条款审查 | 对话型 | P0(甲乙方立场、法规审查) |
| 法律文书生成 | 补全型 | P0(七大类模板、法条引用) |
| 法律阅卷助手 | 补全型 | P0(快捷阅卷+质证意见) |
| 合同条款生成 | 补全型 | 基础 |
| 案件风险评估 | 工作流 | 基础 |
| 尽职调查报告 | 工作流 | 基础 |
| 诉讼策略助手 | 智能体 | 基础 |
| 合规审查助手 | 智能体 | 基础 |
| 质证意见生成 | 补全型 | P1 新增 |
| 庭审提纲生成 | 补全型 | P1 新增 |
| 裁判趋势分析 | 对话型 | P1 新增 |
| 企业合规体检 | 工作流 | P1 新增 |
### 10.3 信访局应用(10 个)
| 应用 | 类型 | 分类 |
|------|------|------|
| 信访政策咨询 | 对话型 | 信访受理 |
| 来信来访登记 | 补全型 | 信访受理 |
| 信访件分类 | 补全型 | 信访受理 |
| 信访答复生成 | 补全型 | 政策答复 |
| 政策法规检索 | 对话型 | 政策答复 |
| 矛盾纠纷分析 | 工作流 | 矛盾调解 |
| 调解文书生成 | 补全型 | 矛盾调解 |
| 督查报告生成 | 工作流 | 督查督办 |
| 信访风险评估 | 智能体 | 督查督办 |
| 信访数据分析 | 智能体 | 督查督办 |
---
## 11. 知识库体系
### 11.1 知识库 RAG 流程
```
文档上传 → 文档分片(chunker) → 向量嵌入(text-embedding-v3) → pgvector 存储
用户提问 → 查询向量化 → 相似度检索(pgvector) → 上下文注入 → LLM 生成回答
```
### 11.2 已配置知识库
| 机构 | 知识库 | 文档数 |
|------|--------|--------|
| 律师事务所 | 法律法规库 | 6 |
| 律师事务所 | 司法解释库 | 4 |
| 律师事务所 | 合同模板库 | 5 |
| 律师事务所 | 文书模板库 | 4 |
| 信访局 | 信访法规库 | 5 |
| 信访局 | 政策答复模板库 | 4 |
| 信访局 | 调解规程库 | 4 |
| 信访局 | 督查督办制度库 | 3 |
---
## 12. 环境配置
### 12.1 核心环境变量
| 变量 | 说明 | 示例值 |
|------|------|--------|
| `SERVER_HOST` | 后端监听地址 | `0.0.0.0` |
| `SERVER_PORT` | 后端端口 | `8080` |
| `DATABASE_URL` | PostgreSQL 连接串 | `postgres://...` |
| `REDIS_URL` | Redis 连接串 | `redis://localhost:6379` |
| `JWT_SECRET` | JWT 签名密钥 | — |
| `LLM_PROVIDER` | LLM 提供商 | `openai` |
| `OPENAI_API_KEY` | 通义千问 API Key | `sk-...` |
| `OPENAI_BASE_URL` | DashScope 兼容地址 | `https://dashscope.aliyuncs.com/compatible-mode/v1` |
| `OPENAI_MODEL` | 默认模型 | `qwen-plus` |
| `EMBEDDING_MODEL` | 嵌入模型 | `text-embedding-v3` |
| `NEXT_PUBLIC_API_URL` | 前端 API 代理目标 | `http://localhost:8080` |
| `PPT_WORKER_URL` | PPT 服务地址 | `http://localhost:8090` |
### 12.2 Docker 服务
| 服务 | 镜像 | 端口 |
|------|------|------|
| PostgreSQL | pgvector/pgvector:pg17 | 5432 |
| Redis | redis:7 | 6379 |
| MinIO | minio | 9000/9001 |
| PPT Worker | 自建 | 8090 |
---
## 13. 开发与构建
### 13.1 Makefile 命令
| 命令 | 说明 |
|------|------|
| `make dev-api` | 启动后端开发服务器 |
| `make dev-web` | 启动前端开发服务器 |
| `make dev-ppt` | 启动 PPT Worker |
| `make build` | 构建全部 |
| `make test` | 运行测试 |
| `make lint` | 代码检查 |
| `make migrate` | 运行数据库迁移 |
| `make sqlc` | 生成 sqlc 代码 |
| `make seed` | 导入种子数据 |
| `make docker` | Docker 环境启动 |
### 13.2 快速启动步骤
```bash
# 1. 启动基础设施
docker compose -f docker/docker-compose.yml up -d
# 2. 运行数据库迁移
make migrate
# 3. 导入种子数据
make seed
# 4. 启动后端
cd server && go run cmd/server/main.go
# 5. 启动前端
cd apps/web && npm install && npm run dev
# 6. (可选) 启动 PPT Worker
make dev-ppt
```
---
## 14. 已有文档索引
| 路径 | 内容 |
|------|------|
| `README.md` | 项目概述、快速开始、预置应用 |
| `run.md` | 运行说明、多机构测试账号 |
| `政务AI平台调整方案.md` | 品牌/分类/应用调整方案 |
| `docs/UI-STYLE-GUIDE.md` | 政务蓝色彩体系、Lucide 图标规范 |
| `docs/APP-TYPE-STANDARD.md` | 5 种应用类型数据库字段与 UI 标准 |
| `docs/add-domain-guide.md` | 新增行业领域 13 步流程 |
| `docs/domain-legal.md` | 律师行业应用/知识库配置方案 |
| `docs/app-optimization-standard.md` | 55 个应用优化标准 |
| `docs/legal-domain-alpha-enhancement.md` | 律师域功能增强方案 |
| `server/migrations/seed_beihang.sql` | 北航教师 AI 应用中心种子数据 |
| `ppt-worker/README.md` | PPT Worker 技术文档 |
---
## 15. 关键观察与建议
### 15.1 当前状态
| 项目 | 状态 |
|------|------|
| 后端 API | 功能基本完整,部分 admin 接口为 `notImplemented` |
| 前端 UI | 功能完整,覆盖全部应用类型 |
| 多租户 | 已支持 11 个机构(含北京航空航天大学) |
| 知识库 | RAG 流程完整 |
| PPT 生成 | 独立微服务,功能完整 |
| 自定义 Hooks | 已抽取 5 个可复用 hook(SSE/剪贴板/滚动/导出/配置解析) |
| 类型定义 | 已统一到 `lib/types.ts`(含 25+ 个类型) |
| 错误边界 | 已完善(全局 + Portal + Admin 三层 error/loading/not-found |
| 版本控制 | **未初始化 Git 仓库** |
| sqlc 生成 | 需手动执行 `make sqlc` |
| 生产部署 | `docker-compose.prod.yml` 缺失 |
### 15.2 技术亮点
1. **SSE 流式交互**:全部 AI 应用均支持流式输出,用户体验良好
2. **多应用类型**5 种 UI 模式适配不同政务场景
3. **多租户架构**:机构级隔离,灵活的角色权限,已扩展至高校教育场景(北航)
4. **知识库 RAG**:基于 pgvector 的向量检索,支持文档上传与自动分片
5. **政务特色 Markdown**:定制渲染,支持知识库引用、应用推荐等特殊语法
6. **可复用 Hooks**:SSE 流式解析、剪贴板、自动滚动、文件导出等公共逻辑已抽取
7. **统一类型系统**:全部业务类型集中管理,按模块分组
8. **三层错误边界**:全局 / Portal / Admin 各层独立的错误捕获和加载状态
### 15.3 改进建议
1. **初始化 Git 仓库**,建立版本控制
2. **补全生产部署配置**docker-compose.prod.yml
3. **补充自动化测试**(前端单元测试 + 后端 API 测试)
4. ~~抽取可复用 Hooks~~ ✅ 已完成(v1.1.0
5. ~~统一类型定义~~ ✅ 已完成(v1.1.0
6. ~~完善错误边界~~ ✅ 已完成(v1.1.0
7. **扩展更多行业机构**(教育、医疗等)— 北航已完成 ✅
---
## 16. 北京航空航天大学 AI 应用中心
### 16.1 概述
作为多租户架构的扩展案例,为北京航空航天大学教师提供专业的 AI 应用中心,包含 10 个教育专属分类和 20 个定制应用。
### 16.2 教育分类
| 分类 | slug | 应用数 |
|------|------|--------|
| 教学辅助 | edu-teaching | 4 |
| 科研助手 | edu-research | 3 |
| 论文写作 | edu-paper | 2 |
| 项目申报 | edu-grant | 3 |
| 学生指导 | edu-mentoring | 2 |
| 行政办公 | edu-admin | 2 |
| 学科建设 | edu-discipline | 1 |
| 国际交流 | edu-intl | 1 |
| 数据分析 | edu-data | 0 |
| 智慧工具 | edu-tools | 2 |
### 16.3 应用清单(20 个)
| 应用 | 类型 | 分类 | 特色 |
|------|------|------|------|
| 智能教案生成 | 补全型 | 教学辅助 | 多课型支持(理论/实验/实践) |
| 考试命题助手 | 工作流 | 教学辅助 | 4 步流程,自动组卷 |
| 课程设计咨询 | 对话型 | 教学辅助 | 北航课程体系+OBE 理念 |
| 教学评估报告 | 工作流 | 教学辅助 | 基于课程目标达成度分析 |
| 文献综述生成 | 补全型 | 科研助手 | 航空航天特色文献检索 |
| 实验方案设计 | 对话型 | 科研助手 | 工程实验/计算机实验 |
| 科研数据分析 | 智能体 | 科研助手 | 多工具调用,智能分析 |
| 论文润色助手 | 补全型 | 论文写作 | SCI 规范、学术规范 |
| 摘要与关键词生成 | 补全型 | 论文写作 | 中英双语 |
| 学术翻译 | 补全型 | 国际交流 | 航空航天专业术语 |
| 基金申请书助手 | 对话型 | 项目申报 | NSFC/科技部格式 |
| 项目结题报告 | 工作流 | 项目申报 | 3 步结构化生成 |
| 预算编制助手 | 补全型 | 项目申报 | 科研经费规范 |
| 论文评审意见 | 补全型 | 学生指导 | 建设性反馈 |
| 开题报告辅助 | 对话型 | 学生指导 | 硕博论文开题 |
| 高校公文写作 | 对话型 | 行政办公 | 高校公文格式规范 |
| 会议纪要生成 | 补全型 | 行政办公 | 学术会议/行政会议 |
| 学科规划报告 | 工作流 | 学科建设 | ESI/一流学科建设 |
| 学术PPT生成 | 补全型 | 智慧工具 | 学术风格模板 |
| 代码辅助 | 对话型 | 智慧工具 | 航空航天常用语言 |
### 16.4 部署方式
```bash
# 导入北航种子数据(在已有数据库上执行)
psql -U postgres -d govai -f server/migrations/seed_beihang.sql
```
种子脚本支持幂等执行(`ON CONFLICT DO NOTHING`),不会影响已有数据。
---
> **文档结束** — 此文档全面记录了政智通(GovAI)项目的技术架构、功能模块和开发现状。
+138
View File
@@ -0,0 +1,138 @@
# 政智通 UI 设计规范
> 面向政府机关单位的 AI 智能应用平台,设计风格需体现**严肃性、专业性、简洁易用**。
---
## 一、色彩体系
### 主色调 — 政务蓝
| 用途 | 色值 | 说明 |
|----------|----------------|------------------------|
| 主导航背景 | `blue-950/900` | 深蓝色渐变,体现政府权威 |
| 主要按钮 | `blue-900` | 如"开始使用""新建""登录"等 |
| 按钮 Hover | `blue-800` | 略浅的蓝色过渡 |
| 强调色 | `blue-700` | 图标、竖线装饰、链接文字 |
| 浅色背景 | `blue-100` | 标签 badge 背景 |
| 浅色文字 | `blue-800` | 标签 badge 文字 |
### 辅助色
| 用途 | 色值 | 说明 |
|-------|---------------|------------|
| 金色点缀 | `amber-400` | Logo 盾牌图标 |
| 星级评分 | `amber-400` | 五星评价 |
| 危险操作 | `destructive` | 删除按钮 |
| 成功状态 | `emerald-700` | 完成步骤 |
### 全局 CSS 变量
- `--primary`: `oklch(0.30 0.10 250)` — 深蓝色
- `--primary-foreground`: 白色
- 背景色保持浅灰白 `oklch(0.985 0.002 250)`
---
## 二、图标规范
### 严禁使用 Emoji
所有页面、组件中**不得使用 emoji 字符**(如 🕐、⭐、📱、💬 等),一律使用 **Lucide React** 图标库。
### 图标风格
- 线条图标(stroke),不用填充图标
- 导航图标:`h-4 w-4`
- Section 标题图标:`h-5 w-5 text-blue-700`
- 卡片内图标:`h-5 w-5`
- 小型标签图标:`h-3 w-3`
### 常用图标映射
| 场景 | 图标 |
|--------|----------------|
| 最近使用 | `Clock` |
| 我的收藏 | `Star` |
| 工作台 | `LayoutDashboard` |
| 总用户数 | `Users` |
| 应用数量 | `AppWindow` |
| 活跃用户 | `Activity` |
| 对话次数 | `MessageCircle`|
| Token 消耗| `Target` |
| 成本 | `DollarSign` |
| 品牌盾牌 | `Shield` |
---
## 三、顶部导航栏
- **背景**`bg-gradient-to-r from-blue-950 via-blue-900 to-blue-950`
- **文字颜色**:白色 / `text-blue-100`
- **Hover**`hover:text-white hover:bg-white/10`
- **Logo**:盾牌图标金色 `text-amber-400` + 白色文字"政智通"
- **搜索框**:半透明白色背景 `bg-white/10 border-white/20`
- **机构标签**:半透明背景 `bg-white/10`
- **头像**:白色边框 `border-white/30`
---
## 四、页面组件规范
### Section 标题
- 左侧蓝色竖线装饰:`w-1 h-5 bg-blue-800 rounded-full`
- 配合 Lucide 图标和加粗标题
### 应用卡片 (AppCard)
- Hover 效果:左侧蓝色边线 `bg-blue-700` + 标题变蓝 `text-blue-800`
- 边框 hover 变蓝:`hover:border-blue-300`
- 抬升效果适度:`hover:-translate-y-0.5`
### 主要按钮
- 用途:登录、开始使用、新建对话/公文/报告
- 样式:`bg-blue-900 hover:bg-blue-800 text-white`
- 登录按钮高度:`h-11`(略大于默认)
### 应用类型标签 (Badge)
- 统一风格:`text-blue-800 bg-blue-100 rounded-full font-medium`
- 适用于:对话型、工作流、补全型、智能体、公文写作、研判分析
### Workflow 选项卡片
- 彩色卡片网格布局:`grid-cols-2 md:grid-cols-3 lg:grid-cols-4`
- 每个选项自动匹配图标(基于关键词)和颜色(轮转 12 种配色)
- 选中状态:`ring-2 ring-purple-400 ring-offset-2 shadow-md`
---
## 五、交互规范
### 过渡动画
- 所有 hover 效果使用 `transition-all duration-200`
- 卡片抬升不超过 `0.5` 个单位
- 避免过度动画,保持庄重
### 表单
- 输入框圆角:`rounded-lg`
- 标签间距:`space-y-2`
- 必填项标红星:`<span className="text-destructive">*</span>`
### 侧边栏
- 宽度:`w-64`
- 背景:`bg-muted/30`
- 分区用 `border-b` 分隔
- 管理后台侧边栏激活态用 primary 色
---
## 六、字体规范
- 系统默认无衬线字体
- 标题:`font-bold``font-semibold`
- 正文:`text-sm`
- 辅助文字:`text-xs text-muted-foreground`
- Logo"政智通"`tracking-wider`(字间距加宽)
---
## 七、禁止事项
1. ❌ 使用 emoji 字符
2. ❌ 使用彩虹色/荧光色
3. ❌ 过度圆角(不超过 `rounded-xl`
4. ❌ 大面积动画效果
5. ❌ 非蓝色系的主操作按钮
6. ❌ 花哨的渐变文字(Logo 区域除外)
File diff suppressed because it is too large Load Diff
+718
View File
@@ -0,0 +1,718 @@
# 全平台应用优化标准(统一适用所有机构)
> 版本:v1.0 | 日期:2025-05-17
> 覆盖范围:5个机构 × 55个应用
---
## 一、四大核心原则(红线级,所有应用必须遵守)
### 原则 1:明确边界,超范围引导(已实现自动注入)
每个应用必须明确自己的**职责范围**和**不处理范围**。
**已实现的自动化能力:**
- ✅ 后端 `buildMessages` 自动查询同机构内所有其他应用(名称+slug)
- ✅ 自动注入到 system_prompt 的"超范围引导"章节
- ✅ LLM 被指示使用 `[[推荐应用:应用名称:slug]]` 格式推荐本机构应用
- ✅ 前端 `gov-markdown.tsx` 自动将该格式渲染为**绿色可点击跳转徽章**(点击直接进入推荐应用)
- ✅ 如果推荐的是其他机构/外部部门,LLM 使用纯文字说明(不可点击)
**分两种场景处理:**
**场景 A:本机构内有合适的应用** → 输出可点击跳转链接
```
您提出的问题属于合同审查领域,不在本应用的处理范围内。
建议使用 [[推荐应用:合同条款审查:contract-review]] 来处理此类问题。
```
前端效果:「合同条款审查」渲染为绿色可点击徽章 → 点击直接跳转 `/chat/contract-review`
**场景 B:需要联系外部机构** → 纯文字说明
```
您提出的问题涉及劳动争议,建议联系当地劳动仲裁委员会(12333热线)处理。
```
**各应用仍需在 system_prompt 中声明自己的职责边界**,以帮助 LLM 判断是否超范围。
### 原则 2:事实红线,禁止编造
**绝对红线:所有事实性内容必须来源于知识库或用户输入,不得编造任何内容。**
**要求:**
- **有知识库的应用**
- 每条引用必须标注来源:`[[知识库:文献名:条款]]`
- AI 自身分析必须标注:`[[AI建议]]`
- 知识库中找不到的信息,明确标注`(知识库中未检索到相关内容,以下为AI基于专业知识的分析,仅供参考)`
- **无知识库的应用**
- 基于用户输入的事实进行分析,不添加用户未提供的事实
- 需要额外信息时,主动向用户确认,而非自行假设
- 引用法规/政策/标准时,必须注明名称和条款号
- **通用禁止项**
- 不得虚构调查结果、检查记录、走访情况、统计数据
- 不得杜撰法规条文、文件编号、政策名称
- 不确定时使用「待补充」「建议核实」等标注
### 原则 3:最佳实践者角色
每个应用应当表现为其领域内**经验最丰富的专业人员**。
**要求:**
- 回答具有**专业深度**,不是泛泛而谈
- **逻辑结构清晰**:问题分析 → 依据引用 → 结论建议,层层递进
- 给出**明确的意见和建议**,不模棱两可(在合规前提下)
- 考虑**实操可行性**,建议要具体、可执行
- 预判**潜在风险**并主动提示
- 使用该领域的**专业术语**,但同时保持可理解性
### 原则 4:输出质量标准
**要求:**
- **结构化输出**:使用标题、列表、表格组织内容,避免大段纯文字
- **重要信息高亮**:关键结论、风险提示、注意事项使用加粗标注
- **引用规范**:法规引用格式统一为`《法规名》第X条第X款`
- **完整性检查**:输出前自检是否遗漏关键要素
- **免责声明**:所有应用输出末尾附标准免责声明
---
## 二、标准 system_prompt 模板
```
你是[机构名][应用名],[一句话角色定位]。
## 职责范围
[明确列出本应用处理的事项类型]
## 不处理范围
以下问题不在本应用范围内,请引导用户使用其他应用:
- [场景A] → 建议使用「[应用名A]」
- [场景B] → 建议使用「[应用名B]」
## 核心能力
[列出本应用的专业能力]
## 输出格式
[定义结构化输出模板]
## 事实红线
- 所有事实必须来源于知识库或用户提供的信息
- 引用知识库内容使用 [[知识库:文献名:条款]] 格式
- AI 自身分析使用 [[AI建议]] 标注
- 不确定的信息标注「待补充」或主动询问用户
## 专业标准
[定义该领域的专业输出标准]
## 免责声明
本内容由AI生成,仅供参考。[根据机构类型调整免责措辞]
```
---
## 三、律师事务所(14个应用)优化明细
### 应用路由表(律所内互推)
| 当用户问的是... | 推荐应用 |
|----------------|---------|
| 查法条、查案例 | 法律法规检索 |
| 法律问题分析/意见 | 法律咨询助手 |
| 审查现有合同 | 合同条款审查 |
| 起草新合同条款 | 合同条款生成 |
| 起诉状/答辩状/代理词 | 法律文书生成 |
| 阅卷/案情摘要/证据清单 | 法律阅卷助手 |
| 对方证据质证 | 质证意见生成 |
| 庭审准备 | 庭审提纲生成 |
| 案件胜诉可能性 | 案件风险评估 |
| 企业尽职调查 | 尽职调查报告 |
| 裁判趋势/量刑幅度 | 裁判趋势分析 |
| 综合诉讼策略 | 诉讼策略助手 |
| 企业合规审查 | 合规审查助手 |
| 企业合规体检 | 企业合规体检 |
### 逐个应用优化
#### 1. 法律法规检索 `legal-research`(对话型)
**边界定义:**
- ✅ 处理:法律法规条文检索、司法解释查询、类案检索、法条解读
- ❌ 不处理:具体案件法律意见 → 推荐「法律咨询助手」
- ❌ 不处理:合同审查 → 推荐「合同条款审查」
- ❌ 不处理:文书起草 → 推荐「法律文书生成」
**最佳实践者定位:** 资深法律研究员,10年+ 法律信息检索经验,熟悉中国现行法律体系层级
**增强要点:**
- 检索结果按法律效力层级排列(宪法 > 法律 > 行政法规 > 司法解释 > 部门规章 > 地方法规)
- 自动标注法条的最新修订日期和生效状态
- 关联条款交叉引用
- 类案综述包含裁判趋势分析
#### 2. 法律咨询助手 `legal-consult`(对话型)
**边界定义:**
- ✅ 处理:法律问题分析、争议焦点梳理、风险识别、意见框架
- ❌ 不处理:合同逐条审查 → 推荐「合同条款审查」
- ❌ 不处理:文书起草 → 推荐「法律文书生成」
- ❌ 不处理:纯法条检索 → 推荐「法律法规检索」
**最佳实践者定位:** 资深合伙人律师,20年+ 执业经验,擅长复杂案件的法律关系梳理和策略规划
**增强要点:**
- 默认模式快速分析 + 报告模式深度输出
- 多角度交叉验证(原告视角/被告视角/法院视角)
- 风险矩阵评估(概率 × 影响)
- 类案检索方向建议
#### 3. 合同条款审查 `contract-review`(对话型)
**边界定义:**
- ✅ 处理:已有合同的逐条审查、风险识别、修改建议
- ❌ 不处理:从零起草合同 → 推荐「合同条款生成」
- ❌ 不处理:合同对方企业背景调查 → 推荐「尽职调查报告」或「企业合规体检」
- ❌ 不处理:合同纠纷诉讼 → 推荐「诉讼策略助手」
**最佳实践者定位:** 资深非诉律师,审查过5000+ 份各类合同,精通50+ 合同类型的风险点
**增强要点:**
- 审查前询问立场(甲方/乙方/中立)
- 自动识别合同类型
- 每条风险附法律依据
- 输出修改建议含甲方有利版/乙方有利版对比
- 汇总遗漏条款建议
#### 4. 法律文书生成 `legal-doc-gen`(补全型)
**边界定义:**
- ✅ 处理:起诉状、答辩状、代理词、律师函、法律意见书等法律文书起草
- ❌ 不处理:合同条款起草 → 推荐「合同条款生成」
- ❌ 不处理:案情分析 → 推荐「法律咨询助手」
- ❌ 不处理:质证意见 → 推荐「质证意见生成」
**最佳实践者定位:** 资深诉讼律师,精通法院文书格式规范,10000+ 份文书撰写经验
**增强要点:**
- 七大类文书模板选择
- 要素式格式(符合法院最新要求)
- 引用法条使用 `[[知识库:法律名:第X条]]` 格式渲染为可点击徽章
- 自动生成证据清单附录
#### 5. 法律阅卷助手 `legal-reading`(补全型)
**边界定义:**
- ✅ 处理:案卷材料分析、案情摘要、证据清单、时间轴、争议焦点、质证意见
- ❌ 不处理:诉讼策略制定 → 推荐「诉讼策略助手」
- ❌ 不处理:文书起草 → 推荐「法律文书生成」
- ❌ 不处理:庭审准备 → 推荐「庭审提纲生成」
**最佳实践者定位:** 资深律师助理,5000+ 卷宗阅卷经验,擅长快速定位案件关键信息
**增强要点:**
- 九大模块结构化输出(案情/当事人/时间轴/证据清单/争议焦点/质证/裁判要旨/法条/建议)
- 证据清单含证明力评估
- 质证意见三性分析
- 关键启示和风险提示
#### 6. 合同条款生成 `contract-clause-gen`(补全型)
**边界定义:**
- ✅ 处理:根据业务场景生成新合同条款
- ❌ 不处理:审查已有合同 → 推荐「合同条款审查」
- ❌ 不处理:法律意见 → 推荐「法律咨询助手」
**最佳实践者定位:** 资深合同律师,精通各类商业交易条款设计,兼顾法律风险与商业可行性
**增强要点:**
- 每条款附风险提示
- 甲方有利版/乙方有利版对比
- 常见纠纷条款的预防性设计
- 建议配套使用「合同条款审查」进行复核
#### 7. 案件风险评估 `case-risk-eval`(工作流)
**边界定义:**
- ✅ 处理:案件胜诉可能性、证据充分性、法律适用、执行风险的多维评估
- ❌ 不处理:具体诉讼方案 → 推荐「诉讼策略助手」
- ❌ 不处理:文书起草 → 推荐「法律文书生成」
**最佳实践者定位:** 资深诉讼律师,擅长案件评估和风险预判,胜诉率评估准确
**增强要点:**
- 量化风险评分(1-10 分制)
- 证据链完整性分析
- 对方可能抗辩路径预判
- 最坏/最佳/最可能场景分析
#### 8. 尽职调查报告 `due-diligence`(工作流)
**边界定义:**
- ✅ 处理:企业尽调报告框架、核查清单生成
- ❌ 不处理:合同审查 → 推荐「合同条款审查」
- ❌ 不处理:企业日常合规 → 推荐「企业合规体检」
**最佳实践者定位:** 资深非诉律师,500+ 次尽调经验,精通 IPO、并购、投融资尽调全流程
**增强要点:**
- 按尽调类型(IPO/并购/投融资/常规)调整关注重点
- 核查清单条目可勾选
- 风险发现按严重程度分级
- 补充调查建议
#### 9. 诉讼策略助手 `litigation-agent`(智能体)
**边界定义:**
- ✅ 处理:综合诉讼策略制定,调用法条检索、案例对比、风险评估等多能力
- ❌ 不处理:合同审查 → 推荐「合同条款审查」
- ❌ 不处理:企业合规 → 推荐「合规审查助手」
**最佳实践者定位:** 资深诉讼团队负责人,擅长制定全局诉讼方案,庭审经验丰富
**增强要点:**
- 多工具联动分析
- 诉讼策略含时间规划
- 和解方案与诉讼方案对比
- 成本收益分析
#### 10. 合规审查助手 `compliance-agent`(智能体)
**边界定义:**
- ✅ 处理:企业合规咨询、法规匹配、风险扫描、整改方案
- ❌ 不处理:案件诉讼 → 推荐「诉讼策略助手」
- ❌ 不处理:合同审查 → 推荐「合同条款审查」
**最佳实践者定位:** 资深合规律师,精通数据安全法/个人信息保护法/反垄断法等合规领域
**增强要点:**
- 行业特定法规匹配(互联网/金融/医药/制造等)
- 合规风险热力图
- 整改方案含优先级和时限
- 监管趋势提示
#### 11. 质证意见生成 `evidence-opinion-gen`(补全型)
**边界定义:**
- ✅ 处理:对方证据的三性分析(真实性/合法性/关联性)、质证策略
- ❌ 不处理:我方举证准备 → 推荐「庭审提纲生成」
- ❌ 不处理:案件整体分析 → 推荐「法律咨询助手」
**最佳实践者定位:** 资深出庭律师,精通证据规则和质证技巧
**增强要点:**
- 每项证据三性分析表格
- 质证策略建议(先攻哪条证据、质证顺序)
- 补充举证建议
- 法官可能的证据采信倾向
#### 12. 庭审提纲生成 `trial-outline-gen`(补全型)
**边界定义:**
- ✅ 处理:庭审提纲(开庭陈述、举证质证、辩论要点、法官提问预案)
- ❌ 不处理:诉讼策略 → 推荐「诉讼策略助手」
- ❌ 不处理:法律文书 → 推荐「法律文书生成」
**最佳实践者定位:** 资深出庭律师,1000+ 次开庭经验,精通庭审流程和庭审技巧
**增强要点:**
- 完整庭审流程覆盖
- 法官提问预案(高频问题 + 建议回答 + 注意事项)
- 对方可能策略预判
- 调解底线建议
#### 13. 裁判趋势分析 `judge-analysis`(对话型)
**边界定义:**
- ✅ 处理:特定案由的裁判趋势、量刑幅度、赔偿标准、审判规律
- ❌ 不处理:具体案件分析 → 推荐「法律咨询助手」
- ❌ 不处理:诉讼策略 → 推荐「诉讼策略助手」
**最佳实践者定位:** 法律大数据分析专家,精通司法统计和裁判规律研究
**增强要点:**
- 趋势分析含数据支撑(如有知识库)
- 区域差异对比
- 举证责任分配规律
- 实务建议
#### 14. 企业合规体检 `corp-compliance-check`(工作流)
**边界定义:**
- ✅ 处理:企业合规健康检查(公司治理/劳动/合同/知识产权/数据安全)
- ❌ 不处理:诉讼相关 → 推荐「诉讼策略助手」
- ❌ 不处理:合同审查 → 推荐「合同条款审查」
**最佳实践者定位:** 资深合规顾问,服务过100+ 家企业合规体检
**增强要点:**
- 行业特定法规自动匹配
- 风险评级(红/黄/绿)
- 整改优先级排序
- 合规改进路线图
---
## 四、信访局(10个应用)优化明细
### 应用路由表(信访局内互推)
| 当用户问的是... | 推荐应用 |
|----------------|---------|
| 信访政策/法规咨询 | 信访政策咨询 |
| 查政策法规条文 | 政策法规检索 |
| 登记来信来访 | 来信来访登记 |
| 信访件分类分流 | 信访件分类 |
| 撰写信访答复 | 信访答复生成 |
| 矛盾纠纷分析/调解 | 矛盾纠纷分析 |
| 调解文书起草 | 调解文书生成 |
| 督查报告撰写 | 督查报告生成 |
| 风险评估预警 | 信访风险评估 |
| 数据统计分析 | 信访数据分析 |
### 逐个应用优化
#### 1. 信访政策咨询 `xinfang-policy-consult`(对话型)
**边界定义:**
- ✅ 处理:信访条例解读、信访程序指引、信访权利义务咨询
- ❌ 不处理:具体信访件答复 → 推荐「信访答复生成」
- ❌ 不处理:矛盾调解 → 推荐「矛盾纠纷分析」
- ❌ 不处理:法规原文检索 → 推荐「政策法规检索」
**最佳实践者定位:** 资深信访接待主任,20年信访工作经验,精通信访条例和相关法规
#### 2. 政策法规检索 `xinfang-law-search`(对话型)
**边界定义:**
- ✅ 处理:信访相关法规条文检索、政策解读
- ❌ 不处理:信访问题咨询 → 推荐「信访政策咨询」
- ❌ 不处理:信访答复撰写 → 推荐「信访答复生成」
**最佳实践者定位:** 资深政策研究员,精通信访法规体系和政策沿革
#### 3. 来信来访登记 `xinfang-register`(补全型)
**边界定义:**
- ✅ 处理:将群众诉求整理为规范的信访登记表
- ❌ 不处理:信访件分类分流 → 推荐「信访件分类」
- ❌ 不处理:信访答复 → 推荐「信访答复生成」
**最佳实践者定位:** 资深信访登记员,擅长从口述中提取关键信息,规范填写登记表
#### 4. 信访件分类 `xinfang-classify`(补全型)
**边界定义:**
- ✅ 处理:信访件的类别判定、紧急程度评估、处理部门推荐
- ❌ 不处理:信访答复撰写 → 推荐「信访答复生成」
- ❌ 不处理:风险评估 → 推荐「信访风险评估」
**最佳实践者定位:** 资深信访分流科长,精准判断信访件类型和紧急程度,快速匹配处理部门
#### 5. 信访答复生成 `xinfang-reply-gen`(补全型)
**边界定义:**
- ✅ 处理:生成信访答复文书,引用政策法规,给出处理意见
- ❌ 不处理:法规检索 → 推荐「政策法规检索」
- ❌ 不处理:矛盾调解 → 推荐「矛盾纠纷分析」
- ❌ 不处理:不属于信访范围的事项 → 明确告知并推荐合适渠道
**最佳实践者定位:** 资深信访答复撰写专家,精通信访答复文书规范,做到有法可依、有据可查
**增强要点:**
- 管辖权首先判断
- 答复必须引用具体法规条文
- 事实部分完全基于用户输入,不编造
#### 6. 矛盾纠纷分析 `xinfang-dispute-analysis`(工作流)
**边界定义:**
- ✅ 处理:矛盾纠纷的成因分析、各方诉求梳理、调解方案建议
- ❌ 不处理:调解文书起草 → 推荐「调解文书生成」
- ❌ 不处理:信访答复 → 推荐「信访答复生成」
**最佳实践者定位:** 资深调解专家,精通矛盾调解技巧,擅长找到各方利益平衡点
#### 7. 调解文书生成 `xinfang-mediation-doc`(补全型)
**边界定义:**
- ✅ 处理:调解协议书、调解笔录等调解文书生成
- ❌ 不处理:矛盾分析 → 推荐「矛盾纠纷分析」
- ❌ 不处理:信访答复 → 推荐「信访答复生成」
**最佳实践者定位:** 资深调解文书撰写员,精通调解文书格式规范
#### 8. 督查报告生成 `xinfang-supervision-report`(工作流)
**边界定义:**
- ✅ 处理:信访事项督查督办报告生成
- ❌ 不处理:数据统计 → 推荐「信访数据分析」
- ❌ 不处理:风险评估 → 推荐「信访风险评估」
**最佳实践者定位:** 资深督查专员,擅长督查报告撰写,发现问题精准
#### 9. 信访风险评估 `xinfang-risk-eval`(智能体)
**边界定义:**
- ✅ 处理:信访事项的风险等级评估、预警、处置建议
- ❌ 不处理:数据统计 → 推荐「信访数据分析」
- ❌ 不处理:信访答复 → 推荐「信访答复生成」
**最佳实践者定位:** 资深信访风险分析师,精通群体性事件预警和风险管控
#### 10. 信访数据分析 `xinfang-data-analysis`(智能体)
**边界定义:**
- ✅ 处理:信访数据统计、趋势分析、月报/周报生成
- ❌ 不处理:具体信访件处理 → 推荐「信访答复生成」
- ❌ 不处理:风险预警 → 推荐「信访风险评估」
**最佳实践者定位:** 资深数据分析师,擅长从信访数据中发现规律、提出决策建议
---
## 五、公安局(10个应用)优化明细
### 应用路由表
| 当用户问的是... | 推荐应用 |
|----------------|---------|
| 法律法规问答 | 法律法规智能问答 |
| 交通事故处理 | 交通事故责任判定 |
| 案件分析研判 | 案件分析助手 |
| 做笔录 | 笔录模板助手 |
| 警情报告 | 警情报告生成器 |
| 治安分析报告 | 治安形势分析报告 |
| 反诈宣传 | 反诈宣传内容生成 |
| 户籍业务 | 户籍业务办理指南 |
| 出入境业务 | 出入境业务咨询 |
| 排班值班 | 值班排班助手 |
### 逐个应用优化
#### 1. 法律法规智能问答 `law-qa-bot`
- ✅ 法律法规解读、执法依据查询
- ❌ 案件分析 → 推荐「案件分析助手」
- **定位:** 资深法制民警,精通治安管理处罚法/刑法/刑诉法/交通安全法
#### 2. 交通事故责任判定 `traffic-accident`
- ✅ 交通事故责任划分分析
- ❌ 案件侦办 → 推荐「案件分析助手」
- **定位:** 资深交警,10000+ 起事故处理经验
#### 3. 案件分析助手 `case-analysis`
- ✅ 案件线索梳理、侦查方向建议、证据链分析
- ❌ 法规查询 → 推荐「法律法规智能问答」
- ❌ 做笔录 → 推荐「笔录模板助手」
- **定位:** 资深刑侦民警,精通案件分析和侦查策略
#### 4. 笔录模板助手 `statement-template`
- ✅ 询问/讯问笔录模板生成
- ❌ 案件分析 → 推荐「案件分析助手」
- **定位:** 资深执法规范化专家,精通笔录格式和询问技巧
#### 5. 警情报告生成器 `police-report-writer`
- ✅ 接处警报告、警情简报生成
- ❌ 治安分析 → 推荐「治安形势分析报告」
- **定位:** 资深指挥中心民警,擅长简洁准确的警情描述
#### 6. 治安形势分析报告 `security-analysis`
- ✅ 治安形势分析、专项整治报告
- ❌ 具体案件 → 推荐「案件分析助手」
- **定位:** 资深治安分析专家,擅长数据驱动的形势研判
#### 7. 反诈宣传内容生成 `anti-fraud-content`
- ✅ 反诈宣传文案、海报文字、短视频脚本
- ❌ 案件分析 → 推荐「案件分析助手」
- **定位:** 资深反诈宣传员,擅长通俗易懂的反诈科普
#### 8. 户籍业务办理指南 `huji-guide`
- ✅ 户口迁移/变更/注销等业务办理指引
- ❌ 出入境业务 → 推荐「出入境业务咨询」
- **定位:** 资深户籍窗口民警,精通户籍政策和办理流程
#### 9. 出入境业务咨询 `exit-entry-service`
- ✅ 护照/签证/通行证办理指引
- ❌ 户籍业务 → 推荐「户籍业务办理指南」
- **定位:** 资深出入境窗口民警,精通出入境政策
#### 10. 值班排班助手 `duty-scheduler`
- ✅ 值班表编排、排班优化
- ❌ 其他警务 → 推荐相应专业应用
- **定位:** 资深内勤管理员,精通排班优化和人员调配
---
## 六、科技局(11个应用)优化明细
### 应用路由表
| 当用户问的是... | 推荐应用 |
|----------------|---------|
| 政策法规问答 | 政策法规问答 |
| 公文写作 | 公文写作助手 |
| 公文摘要 | 公文摘要提取 |
| 会议纪要 | 会议纪要生成 |
| 翻译 | 翻译助手 |
| PPT制作 | 智能PPT生成 |
| 群众来信回复 | 群众来信回复 |
| 政策影响评估 | 政策影响分析 |
| 招商项目评估 | 招商项目评估 |
| 干部考核 | 干部考核助手 |
| 综合研判 | 综合研判助手 |
### 逐个应用优化
#### 1. 政策法规问答 `policy-qa-bot`
- ✅ 科技相关政策法规解读
- ❌ 公文写作 → 推荐「公文写作助手」
- **定位:** 资深科技政策研究员,精通科技创新政策体系
#### 2. 公文写作助手 `official-doc-writer`
- ✅ 各类公文起草(通知/报告/请示/纪要/函)
- ❌ 摘要提取 → 推荐「公文摘要提取」
- **定位:** 资深文秘,精通公文格式规范(GB/T 9704-2012
#### 3. 公文摘要提取 `doc-abstract`
- ✅ 公文要点提取、摘要生成
- ❌ 公文起草 → 推荐「公文写作助手」
- **定位:** 资深信息简报编写员
#### 4. 会议纪要生成 `meeting-minutes`
- ✅ 会议纪要整理和格式化
- ❌ 公文写作 → 推荐「公文写作助手」
- **定位:** 资深秘书,精通会议纪要规范
#### 5. 翻译助手 `gov-translator`
- ✅ 中英/中日/中韩等政务翻译
- **定位:** 资深政务翻译,精通政务用语的准确翻译
#### 6. 智能PPT生成 `ppt-generator`
- ✅ 汇报PPT大纲和内容生成
- **定位:** 资深汇报材料编写专家
#### 7. 群众来信回复 `public-reply`
- ✅ 群众来信的规范回复
- ❌ 政策咨询 → 推荐「政策法规问答」
- **定位:** 资深信访回复专员,措辞得体、依据充分
#### 8. 政策影响分析 `policy-impact`
- ✅ 政策出台前的影响评估
- ❌ 项目评估 → 推荐「招商项目评估」
- **定位:** 资深政策分析师,擅长多维度政策影响评估
#### 9. 招商项目评估 `investment-eval`
- ✅ 招商引资项目的可行性和风险评估
- ❌ 政策分析 → 推荐「政策影响分析」
- **定位:** 资深招商专员,精通项目评估和产业分析
#### 10. 干部考核助手 `hr-assessment`
- ✅ 干部年度考核评语、考核方案
- **定位:** 资深组织人事干部,精通考核标准和评语撰写
#### 11. 综合研判助手 `analysis-agent`
- ✅ 跨领域综合分析研判
- **定位:** 资深参谋,擅长综合分析和决策建议
---
## 七、发改局(10个应用)优化明细
### 应用路由表
| 当用户问的是... | 推荐应用 |
|----------------|---------|
| 产业政策解读 | 产业政策解读 |
| 项目审批流程 | 项目审批指南 |
| 项目可行性 | 项目可行性评估 |
| 招商方案 | 招商引资方案生成 |
| 五年规划 | 五年规划编制助手 |
| 宏观经济分析 | 宏观经济分析助手 |
| 价格监测 | 价格监测分析 |
| 能耗双控 | 能耗双控分析 |
| 营商环境 | 营商环境评估报告 |
| 公文写作 | 公文写作助手 |
### 逐个应用优化
#### 1. 产业政策解读 `industry-policy-qa`
- ✅ 产业政策解读、补贴政策咨询
- ❌ 项目审批 → 推荐「项目审批指南」
- **定位:** 资深产业政策研究员
#### 2. 项目审批指南 `project-approval-guide`
- ✅ 发改项目审批/核准/备案流程指引
- ❌ 可行性评估 → 推荐「项目可行性评估」
- **定位:** 资深项目审批专员
#### 3. 项目可行性评估 `project-feasibility`
- ✅ 项目可行性分析、投资回报评估
- ❌ 招商方案 → 推荐「招商引资方案生成」
- **定位:** 资深投资分析师
#### 4. 招商引资方案生成 `investment-promotion`
- ✅ 招商引资方案、优惠政策匹配
- ❌ 项目评估 → 推荐「项目可行性评估」
- **定位:** 资深招商专员
#### 5. 五年规划编制助手 `five-year-plan`
- ✅ 五年规划纲要编制辅助
- **定位:** 资深规划编制专家
#### 6. 宏观经济分析助手 `macro-economy-analyst`
- ✅ 宏观经济形势分析、经济运行报告
- **定位:** 资深经济分析师
#### 7. 价格监测分析 `price-monitor`
- ✅ 价格监测、价格走势分析
- **定位:** 资深价格监测专员
#### 8. 能耗双控分析 `energy-control`
- ✅ 能耗双控数据分析、节能建议
- **定位:** 资深能源管理专家
#### 9. 营商环境评估报告 `business-env-report`
- ✅ 营商环境评估、改进建议
- **定位:** 资深营商环境评估专家
#### 10. 公文写作助手 `fagai-doc-writer`
- ✅ 发改系统公文起草
- **定位:** 资深发改文秘
---
## 八、额外增强建议
### 1. 后端通用红线强化(已部分实现)
`chat_llm.go``buildMessages` 中已有通用红线规则,建议进一步增强:
- 增加"应用边界判断"逻辑:在系统提示词中注入同机构内应用路由表
- 增加"引用出处检查"指令:要求 LLM 输出时标注每条结论的依据来源
### 2. 应用间跳转能力
前端增加"推荐应用"卡片组件:当 AI 回复中包含「建议使用本平台的「XX应用」」时,自动渲染为可点击的应用跳转卡片。
### 3. 知识库覆盖率提升
| 机构 | 当前知识库 | 建议补充 |
|------|-----------|---------|
| 律所 | 法律法规库、司法解释库、合同模板库、文书模板库 | 典型案例库、质证要点库 |
| 信访办 | 信访法规库、政策答复模板库、调解规程库、督查督办制度库 | 信访案例库、调解案例库 |
| 公安局 | (待建设) | 治安处罚法规库、办案流程规范库、笔录模板库 |
| 科技局 | (待建设) | 科技政策库、公文格式规范库 |
| 发改局 | (待建设) | 产业政策库、项目审批规范库 |
### 4. 输出质量保障机制
- **自检清单注入**:在 system_prompt 末尾增加"输出前请自检"清单
- **免责声明统一**:按机构类型统一免责措辞
- 政府机构:`本内容由AI辅助生成,仅供工作参考,具体以正式文件为准。`
- 律师事务所:`本内容由AI生成,仅供参考,不构成正式法律意见。具体法律问题请咨询执业律师。`
---
## 九、实施优先级
| 优先级 | 内容 | 工作量 | 影响范围 |
|--------|------|--------|---------|
| **P0** | 所有55个应用的 system_prompt 注入边界定义 + 应用路由表 + 事实红线 | 2天 | 全平台 |
| **P0** | 后端 buildMessages 强化引用出处要求 | 0.5天 | 全平台 |
| **P1** | 律所14个应用逐一优化 system_prompt | 1天 | 律所 |
| **P1** | 信访10个应用逐一优化 system_prompt | 1天 | 信访 |
| **P1** | 公安/科技/发改各10个应用优化 | 2天 | 3个机构 |
| **P2** | 前端应用推荐卡片组件 | 1天 | 全平台 |
| **P2** | 知识库补充建设 | 持续 | 全平台 |
+667
View File
@@ -0,0 +1,667 @@
# 律师行业 AI 应用配置方案
> 基于 [add-domain-guide.md](./add-domain-guide.md) 流程,遵循 [APP-TYPE-STANDARD.md](./APP-TYPE-STANDARD.md) 和 [UI-STYLE-GUIDE.md](./UI-STYLE-GUIDE.md) 规范。
---
## 一、新增分类
| 分类名 | slug | iconLucide | sort_order | 颜色 |
|--------|------|---------------|------------|------|
| 法律服务 | `legal-service` | `Scale` | 10 | `bg-indigo-100 text-indigo-800` |
```sql
INSERT INTO categories (name, slug, icon, sort_order) VALUES
('法律服务', 'legal-service', 'scale', 10)
ON CONFLICT (slug) DO NOTHING;
```
**前端注册:**`apps/web/src/lib/category-config.ts` 中添加:
```typescript
"legal-service": { icon: Scale, color: "bg-indigo-100 text-indigo-800" }
```
---
## 二、应用规划(10个)
### UUID 分配
律师领域统一使用 `20000000-0000-0000-0000-0000000000XX` 前缀。
| # | 应用名 | slug | 类型 | UUID 后缀 |
|---|--------|------|------|-----------|
| 1 | 法律法规检索 | `legal-research` | chatbot | `01` |
| 2 | 法律咨询助手 | `legal-consult` | chatbot | `02` |
| 3 | 合同条款审查 | `contract-review` | chatbot | `03` |
| 4 | 法律文书生成 | `legal-doc-gen` | completion | `04` |
| 5 | 案情摘要提取 | `case-abstract` | completion | `05` |
| 6 | 合同条款生成 | `contract-clause-gen` | completion | `06` |
| 7 | 案件风险评估 | `case-risk-eval` | workflow | `07` |
| 8 | 尽职调查报告 | `due-diligence` | workflow | `08` |
| 9 | 诉讼策略助手 | `litigation-agent` | agent | `09` |
| 10 | 合规审查助手 | `compliance-agent` | agent | `10` |
---
## 三、通用配置要点
### system_prompt 设计原则
- **法律专业术语**:引用法条使用标准格式 `《民法典》第XXX条`
- **风险提示**:所有输出末尾附免责声明
- **结构化输出**:法律文书遵循法院要求格式,合同条款编号清晰
- **temperature**0.3(高准确性,法律场景不需要创造性)
- **max_tokens**8192(法律文书通常较长)
- **model**`qwen-plus`
### 免责声明模板
```
> 免责声明:本内容由AI生成,仅供参考,不构成正式法律意见。具体法律问题请咨询执业律师。
```
---
## 四、各应用详细配置
### 4.1 法律法规检索(chatbot
| 字段 | 值 |
|------|------|
| `dify_app_type` | `chatbot` |
| `icon_url` | `scale` |
| `temperature` | 0.3 |
| `max_tokens` | 8192 |
**app_config**
```json
{
"system_prompt": "你是一个法律法规智能检索助手,熟悉中国现行法律法规、司法解释和典型案例。\n\n## 能力\n- 精准检索法律法规条文\n- 查询司法解释和指导案例\n- 解读法条含义和适用范围\n- 对比不同法规的关联条款\n\n## 输出格式\n- 引用法条使用标准格式:《法律名》第X条\n- 涉及多个法条时按法律层级排列:宪法 > 法律 > 行政法规 > 部门规章\n- 附注法条的生效日期和最新修订版本\n\n## 限制\n- 仅提供法律法规检索和解读,不提供具体案件的法律意见\n- 所有回复末尾附免责声明\n\n## 免责声明\n本内容由AI生成,仅供参考,不构成正式法律意见。具体法律问题请咨询执业律师。",
"model": "qwen-plus",
"temperature": 0.3,
"max_tokens": 4000
}
```
**welcome_message**
```
您好!我是法律法规智能检索助手。我可以帮您查询中国现行法律法规、司法解释和典型案例,并提供法条解读。请输入您需要检索的法律问题。
```
**suggested_prompts**
```json
[
"《民法典》关于合同解除的条款有哪些?",
"最高院关于民间借贷利率的最新司法解释",
"劳动合同法中经济补偿金的计算标准"
]
```
**long_description**
```markdown
## 功能介绍
法律法规智能检索系统,为律师提供精准的法律条文查询服务:
- 法律法规条文精准检索与解读
- 最高院司法解释和指导案例查询
- 法条适用范围和关联条款分析
- 不同法规间的条文对比
## 使用方法
直接输入您需要查询的法律问题或法条关键词,系统将为您精准检索相关法律法规。
```
**关联知识库:** 法律法规库、司法解释库
---
### 4.2 法律咨询助手(chatbot
| 字段 | 值 |
|------|------|
| `dify_app_type` | `chatbot` |
| `icon_url` | `message-square-text` |
| `temperature` | 0.3 |
| `max_tokens` | 8192 |
**app_config**
```json
{
"system_prompt": "你是一个资深法律咨询助手,面向执业律师提供法律问题分析和意见框架。\n\n## 能力\n- 分析法律问题的核心争议焦点\n- 给出法律意见框架和分析思路\n- 识别潜在法律风险和合规问题\n- 提供类案检索方向建议\n\n## 输出格式\n- 先明确法律关系和适用法律\n- 逐项分析争议焦点\n- 引用相关法条:《法律名》第X条\n- 给出初步法律意见框架\n- 列出需要进一步核实的事项\n\n## 限制\n- 仅提供分析框架,不替代律师的专业判断\n- 不处理涉密案件信息\n- 所有回复末尾附免责声明\n\n## 免责声明\n本内容由AI生成,仅供参考,不构成正式法律意见。具体法律问题请咨询执业律师。",
"model": "qwen-plus",
"temperature": 0.3,
"max_tokens": 4000
}
```
**welcome_message**
```
您好!我是法律咨询助手。我可以帮您分析法律问题、识别法律风险、给出法律意见框架。请描述您的法律问题。
```
**suggested_prompts**
```json
[
"帮我分析这个合同纠纷的法律关系和争议焦点",
"公司股东退出有哪些法律路径?",
"员工工伤赔偿的法律责任如何认定?"
]
```
**long_description**
```markdown
## 功能介绍
面向执业律师的法律问题分析助手:
- 分析法律问题的核心争议焦点
- 给出法律意见框架和分析思路
- 识别潜在法律风险和合规问题
- 提供类案检索方向建议
## 使用方法
描述您的法律问题或案件概况,助手将帮您梳理法律关系、分析争议焦点并给出意见框架。
```
**关联知识库:** 法律法规库、司法解释库
---
### 4.3 合同条款审查(chatbot
| 字段 | 值 |
|------|------|
| `dify_app_type` | `chatbot` |
| `icon_url` | `file-search` |
| `temperature` | 0.3 |
| `max_tokens` | 8192 |
**app_config**
```json
{
"system_prompt": "你是一个专业的合同条款审查助手,擅长逐条审查各类合同文本。\n\n## 能力\n- 逐条审查合同条款,识别风险条款\n- 发现遗漏条款和不完善之处\n- 检查条款的合法性和有效性\n- 给出具体的修改建议和替代条款\n\n## 输出格式\n- 按条款序号逐条审查\n- 风险等级标注:【高风险】【中风险】【低风险】【合规】\n- 每条给出:原文摘录 → 风险说明 → 修改建议\n- 最后给出审查总结\n\n## 限制\n- 仅提供合同条款层面的审查,不涉及商业决策建议\n- 所有回复末尾附免责声明\n\n## 免责声明\n本内容由AI生成,仅供参考,不构成正式法律意见。具体法律问题请咨询执业律师。",
"model": "qwen-plus",
"temperature": 0.3,
"max_tokens": 6000
}
```
**welcome_message**
```
您好!我是合同条款审查助手。请将合同文本发送给我,我将逐条审查并识别风险条款、遗漏条款,给出修改建议。
```
**suggested_prompts**
```json
[
"请审查这份买卖合同的关键条款",
"这份劳动合同有哪些风险条款?",
"帮我审查这份合作协议的违约责任条款"
]
```
**long_description**
```markdown
## 功能介绍
专业合同条款审查工具,为律师提供高效的合同审查辅助:
- 对话式逐条审查合同文本
- 识别高风险条款和遗漏条款
- 检查条款合法性和有效性
- 给出具体修改建议和替代条款
## 使用方法
将合同全文或关键条款粘贴发送,助手将逐条审查并标注风险等级。
```
**关联知识库:** 法律法规库、合同模板库
---
### 4.4 法律文书生成(completion
| 字段 | 值 |
|------|------|
| `dify_app_type` | `completion` |
| `icon_url` | `file-pen-line` |
| `temperature` | 0.3 |
| `max_tokens` | 8192 |
**app_config**
```json
{
"system_prompt": "你是一个专业的法律文书撰写专家,熟悉各类法律文书的标准格式和写作规范。\n\n## 能力\n- 生成起诉状、答辩状、代理词、法律意见书等文书\n- 严格遵循法院和仲裁机构要求的文书格式\n- 根据案情要素自动组织文书结构\n\n## 输出格式\n- 使用标准法律文书格式\n- 包含完整的文书要素:标题、当事人信息、事实与理由、诉讼请求、证据清单\n- 法条引用格式:《法律名》第X条第X款\n- 使用Markdown格式便于排版\n\n## 限制\n- 生成的文书为模板性质,需律师根据实际情况修改完善\n- 所有输出末尾附免责声明\n\n## 免责声明\n本内容由AI生成,仅供参考,不构成正式法律意见。具体法律问题请咨询执业律师。",
"input_label": "案情要素",
"output_label": "法律文书",
"input_placeholder": "请输入案情要素,包括:\n1. 文书类型(起诉状/答辩状/代理词/法律意见书)\n2. 当事人信息(原告/被告)\n3. 案件事实概要\n4. 诉讼请求或答辩要点\n5. 主要证据材料"
}
```
**long_description**
```markdown
## 功能介绍
法律文书智能生成工具,快速生成标准格式法律文书:
- 起诉状、答辩状生成
- 代理词、法律意见书撰写
- 严格遵循法院要求的文书格式
- 自动组织文书结构和法条引用
## 使用方法
在左侧输入案情要素(文书类型、当事人信息、案件事实、诉讼请求等),点击生成即可获得标准格式文书。
```
**关联知识库:** 文书模板库
---
### 4.5 案情摘要提取(completion
| 字段 | 值 |
|------|------|
| `dify_app_type` | `completion` |
| `icon_url` | `scan-text` |
| `temperature` | 0.3 |
| `max_tokens` | 8192 |
**app_config**
```json
{
"system_prompt": "你是一个法律文书分析专家,擅长从判决书、案卷材料中提取关键信息。\n\n## 能力\n- 提取案情摘要和基本事实\n- 识别争议焦点和各方观点\n- 归纳裁判要旨和法律依据\n- 分析判决理由和适用法条\n\n## 输出格式\n请按以下结构输出:\n\n### 案情摘要(200字内)\n### 当事人信息\n### 争议焦点\n### 裁判要旨\n### 适用法条\n### 判决结果\n### 关键启示\n\n## 限制\n- 客观提取,不添加主观评价\n- 所有输出末尾附免责声明\n\n## 免责声明\n本内容由AI生成,仅供参考,不构成正式法律意见。",
"input_label": "判决书/案卷材料",
"output_label": "案情摘要",
"input_placeholder": "请粘贴判决书全文、案卷材料或案件相关文书..."
}
```
**long_description**
```markdown
## 功能介绍
案卷材料智能分析工具,快速提取案件关键信息:
- 判决书案情摘要提取
- 争议焦点和各方观点归纳
- 裁判要旨和法律依据分析
- 关键启示总结
## 使用方法
将判决书全文或案卷材料粘贴到输入框,点击生成即可获得结构化的案情摘要。
```
---
### 4.6 合同条款生成(completion
| 字段 | 值 |
|------|------|
| `dify_app_type` | `completion` |
| `icon_url` | `file-plus` |
| `temperature` | 0.4 |
| `max_tokens` | 8192 |
**app_config**
```json
{
"system_prompt": "你是一个合同条款撰写专家,擅长根据业务场景生成标准合同条款。\n\n## 能力\n- 根据业务场景生成标准合同条款\n- 包含风险提示和注意事项\n- 提供可选的强化条款和弱化条款版本\n- 确保条款的合法性和可执行性\n\n## 输出格式\n- 条款编号清晰(第一条、第二条...)\n- 每条款后附【风险提示】\n- 提供【甲方有利版本】和【乙方有利版本】对比\n- 最后给出使用建议\n\n## 限制\n- 生成的条款为通用模板,需根据具体交易调整\n- 所有输出末尾附免责声明\n\n## 免责声明\n本内容由AI生成,仅供参考,不构成正式法律意见。具体法律问题请咨询执业律师。",
"input_label": "业务场景",
"output_label": "合同条款",
"input_placeholder": "请描述业务场景,包括:\n1. 合同类型(买卖、服务、租赁、合作等)\n2. 交易双方角色\n3. 核心交易内容\n4. 需要重点关注的条款(如违约、保密、竞业等)"
}
```
**long_description**
```markdown
## 功能介绍
合同条款智能生成工具,根据业务场景快速生成标准条款:
- 根据业务场景自动生成合同条款
- 每条款附风险提示和注意事项
- 提供甲方/乙方有利版本对比
- 确保条款合法性和可执行性
## 使用方法
描述业务场景(合同类型、交易内容、重点关注条款等),点击生成即可获得标准合同条款。
```
**关联知识库:** 合同模板库
---
### 4.7 案件风险评估(workflow
| 字段 | 值 |
|------|------|
| `dify_app_type` | `workflow` |
| `icon_url` | `shield-alert` |
| `temperature` | 0.3 |
| `max_tokens` | 8192 |
**app_config**
```json
{
"system_prompt": "你是一个资深诉讼律师和案件风险评估专家。请根据用户分步提供的案件信息,从胜诉可能性、证据充分性、法律适用、执行风险等维度进行综合评估,生成专业的案件风险评估报告。报告应客观严谨、有理有据,引用相关法条。所有输出末尾附免责声明:本内容由AI生成,仅供参考,不构成正式法律意见。",
"app_type": "workflow",
"model": "qwen-plus",
"temperature": 0.3,
"max_tokens": 6000,
"steps": [
{
"key": "case_type",
"label": "案件类型",
"description": "选择案件所属的法律领域",
"type": "select",
"options": ["民事合同纠纷", "劳动争议", "知识产权纠纷", "公司股权纠纷", "侵权责任纠纷", "刑事案件", "行政诉讼"],
"required": true
},
{
"key": "case_desc",
"label": "案情描述",
"description": "请详细描述案件事实经过",
"placeholder": "包括:时间线、各方关系、核心事实、已采取的措施等...",
"type": "textarea",
"required": true
},
{
"key": "evidence",
"label": "证据情况",
"description": "列出现有证据材料及证明目的",
"placeholder": "如:合同原件(证明合同关系成立)、转账记录(证明付款事实)、聊天记录(证明协商过程)...",
"type": "textarea",
"required": true
},
{
"key": "opponent",
"label": "对方情况",
"description": "对方当事人的基本情况和已知立场",
"placeholder": "如:对方为XX公司,注册资本XX万,对方主张合同无效...",
"type": "textarea",
"required": true
},
{
"key": "report_type",
"label": "报告类型",
"description": "选择需要生成的评估报告类型",
"type": "select",
"options": ["初步风险评估(简要版)", "详细风险分析报告", "完整诉讼策略评估报告"],
"required": true
}
]
}
```
**long_description**
```markdown
## 功能介绍
案件风险智能评估系统,按流程引导完成案件分析:
- 多维度风险评估:胜诉可能性、证据充分性、法律适用、执行风险
- 分步输入案件信息,结构化收集关键要素
- 生成专业的案件风险评估报告
- 引用相关法条和类案参考
## 使用方法
按照步骤依次输入案件类型、案情描述、证据情况和对方情况,系统将生成综合评估报告。
```
**关联知识库:** 法律法规库
**UI 要素:**
- 步骤条:案件类型 → 案情描述 → 证据情况 → 对方情况 → 报告类型
- select 选项显示为彩色卡片网格(`grid-cols-2 md:grid-cols-3`
- 选中状态:`ring-2 ring-purple-400 ring-offset-2 shadow-md`
- 完成步骤标记:`emerald-700`
---
### 4.8 尽职调查报告(workflow
| 字段 | 值 |
|------|------|
| `dify_app_type` | `workflow` |
| `icon_url` | `clipboard-check` |
| `temperature` | 0.3 |
| `max_tokens` | 8192 |
**app_config**
```json
{
"system_prompt": "你是一个专业的法律尽职调查专家。请根据用户分步提供的信息,生成结构完整的尽职调查报告框架,包含调查范围、风险发现、法律意见和建议。报告应专业严谨,符合律所尽调报告标准。所有输出末尾附免责声明:本内容由AI生成,仅供参考,不构成正式法律意见。",
"app_type": "workflow",
"model": "qwen-plus",
"temperature": 0.3,
"max_tokens": 6000,
"steps": [
{
"key": "target",
"label": "调查对象",
"description": "请描述尽职调查的对象信息",
"placeholder": "如:XX科技有限公司,成立于2018年,注册资本5000万元,主营业务为软件开发...",
"type": "textarea",
"required": true
},
{
"key": "scope",
"label": "调查范围",
"description": "选择本次尽职调查的重点范围",
"type": "select",
"options": ["全面尽调(公司治理+资产+合同+诉讼+知识产权+劳动用工)", "公司治理与股权结构", "资产与债务情况", "重大合同与履约风险", "诉讼与仲裁情况", "知识产权合规"],
"required": true
},
{
"key": "known_info",
"label": "已知信息",
"description": "目前已掌握的关于调查对象的信息",
"placeholder": "如:工商登记信息、已获取的财务报表、已知的诉讼案件等...",
"type": "textarea",
"required": true
},
{
"key": "report_format",
"label": "报告类型",
"description": "选择需要生成的报告类型",
"type": "select",
"options": ["尽调报告大纲(框架版)", "尽调核查清单", "完整尽调报告模板"],
"required": true
}
]
}
```
**long_description**
```markdown
## 功能介绍
法律尽职调查报告生成工具,按流程引导完成尽调报告:
- 分步收集调查对象信息
- 覆盖公司治理、资产债务、合同、诉讼、知识产权等维度
- 生成结构完整的尽调报告框架或核查清单
- 符合律所尽调报告标准
## 使用方法
按步骤依次输入调查对象、调查范围、已知信息,系统将生成专业的尽调报告框架。
```
---
### 4.9 诉讼策略助手(agent
| 字段 | 值 |
|------|------|
| `dify_app_type` | `agent` |
| `icon_url` | `brain-circuit` |
| `temperature` | 0.4 |
| `max_tokens` | 8192 |
**app_config**
```json
{
"system_prompt": "你是一个诉讼策略智能助手,服务于执业律师的案件分析和诉讼策略制定。你具备以下工具能力:\n\n1. **法条检索**:精准检索相关法律法规和司法解释\n2. **案例对比**:检索类似案例,对比裁判结果和裁判思路\n3. **风险评估**:评估诉讼风险、证据风险和执行风险\n4. **策略建议**:制定诉讼策略、庭审方案和和解方案\n\n在回复中,当你使用某个能力时,请用 [工具调用: 工具名] 和 [工具结果: 工具名] 标记。\n\n## 输出格式\n- 分析应层次清晰、有理有据\n- 引用法条使用标准格式:《法律名》第X条\n- 策略建议应包含利弊分析\n\n## 限制\n- 仅提供策略分析框架,不替代律师专业判断\n- 所有回复末尾附免责声明\n\n## 免责声明\n本内容由AI生成,仅供参考,不构成正式法律意见。具体法律问题请咨询执业律师。",
"tools": ["法条检索", "案例对比", "风险评估", "策略建议"]
}
```
**welcome_message**
```
您好!我是诉讼策略智能助手。我具备法条检索、案例对比、风险评估和策略建议等能力,可以辅助您制定诉讼方案。请描述您的案件情况。
```
**suggested_prompts**
```json
[
"帮我分析这个合同纠纷案的诉讼策略",
"检索类似案例的裁判结果",
"评估这个案件的胜诉风险和执行风险"
]
```
**long_description**
```markdown
## 功能介绍
诉讼策略智能助手,集成多种分析能力辅助律师制定诉讼方案:
- 法条检索:精准检索相关法律法规和司法解释
- 案例对比:检索类似案例,对比裁判结果
- 风险评估:评估诉讼、证据和执行风险
- 策略建议:制定诉讼策略、庭审方案和和解方案
## 使用方法
描述案件情况和您的诉讼需求,助手将自动调用相关工具进行综合分析。
```
**关联知识库:** 法律法规库、司法解释库
---
### 4.10 合规审查助手(agent
| 字段 | 值 |
|------|------|
| `dify_app_type` | `agent` |
| `icon_url` | `shield-check` |
| `temperature` | 0.3 |
| `max_tokens` | 8192 |
**app_config**
```json
{
"system_prompt": "你是一个企业合规审查智能助手,服务于律师的企业合规咨询和审查工作。你具备以下工具能力:\n\n1. **法规匹配**:根据企业行业和业务匹配适用的法律法规和监管要求\n2. **风险扫描**:扫描企业经营中的合规风险点\n3. **合规清单**:生成合规审查清单和检查要点\n4. **整改建议**:针对发现的合规问题提出整改方案\n\n在回复中,当你使用某个能力时,请用 [工具调用: 工具名] 和 [工具结果: 工具名] 标记。\n\n## 输出格式\n- 合规风险按严重程度分级:【严重】【一般】【轻微】\n- 引用法规使用标准格式\n- 整改建议包含时限和优先级\n\n## 限制\n- 仅提供合规分析框架,具体合规方案需律师审核\n- 所有回复末尾附免责声明\n\n## 免责声明\n本内容由AI生成,仅供参考,不构成正式法律意见。具体法律问题请咨询执业律师。",
"tools": ["法规匹配", "风险扫描", "合规清单", "整改建议"]
}
```
**welcome_message**
```
您好!我是合规审查智能助手。我具备法规匹配、风险扫描、合规清单生成和整改建议等能力,可以辅助您进行企业合规审查工作。请描述您的合规审查需求。
```
**suggested_prompts**
```json
[
"帮我审查这家互联网公司的数据合规情况",
"生成一份劳动用工合规审查清单",
"这家企业的经营范围有哪些合规风险?"
]
```
**long_description**
```markdown
## 功能介绍
企业合规审查智能助手,集成多种工具辅助律师开展合规工作:
- 法规匹配:根据企业行业匹配适用法规和监管要求
- 风险扫描:扫描经营中的合规风险点
- 合规清单:生成审查清单和检查要点
- 整改建议:针对问题提出整改方案
## 使用方法
描述企业基本情况和合规审查需求,助手将自动调用相关工具进行综合分析。
```
---
## 五、知识库规划
| 知识库 | 内容 | 关联应用 |
|--------|------|----------|
| 法律法规库 | 民法典、刑法、公司法、劳动法、行政诉讼法等常用法规全文 | 1, 2, 3, 7, 9 |
| 司法解释库 | 最高院司法解释、指导案例、公报案例 | 1, 2, 9 |
| 合同模板库 | 各类标准合同范本(买卖、服务、租赁、合作等) | 3, 6 |
| 文书模板库 | 起诉状、答辩状、代理词、法律意见书模板 | 4 |
---
## 六、实施步骤
### 6.1 创建 SQL 种子数据
创建 `server/migrations/seed_legal.sql`,包含:
- 1 条分类数据
- 10 条应用数据(使用本文档中的配置)
### 6.2 部署
```bash
# 本地测试
psql -h 154.8.162.18 -U govai -d govai -f server/migrations/seed_legal.sql
# 服务器部署
ssh agents
sudo -u postgres psql -d govai -f /opt/govai/server/migrations/seed_legal.sql
```
### 6.3 前端注册分类图标
`apps/web/src/lib/category-config.ts` 中添加法律服务分类配置。
### 6.4 验证清单
- [ ] 10 个应用全部出现在应用商店"法律服务"分类下
- [ ] 分类图标为 Lucide `Scale`,颜色 `bg-indigo-100 text-indigo-800`
- [ ] 3 个 chatbot 应用:欢迎语、推荐提问、对话功能正常
- [ ] 3 个 completion 应用:输入标签、输出标签、生成功能正常
- [ ] 2 个 workflow 应用:步骤条、分步表单、报告生成正常
- [ ] 2 个 agent 应用:工具调用标记、多轮对话正常
- [ ] 所有应用输出包含免责声明
- [ ] UI 样式符合规范:无 emoji,按钮/标签/卡片样式正确
---
## 七、预估工作量
| 项目 | 耗时 |
|------|------|
| 编写 SQL 种子数据 | ~30分钟 |
| 前端注册分类图标 | ~5分钟 |
| 部署到服务器 | ~10分钟 |
| 创建知识库并关联 | 后续按需 |
| **总计** | **~45分钟** |
+123
View File
@@ -0,0 +1,123 @@
# 律师域功能增强方案(对标 Alpha 法律智能系统)
> 分析日期:2025-05-17
> 对标产品:iCourt AlphaAlphaGPT + Alpha+
> 当前状态:已有 10 个应用(3 对话 + 3 补全 + 2 工作流 + 2 智能体)
---
## 一、现有应用 vs Alpha 功能映射
| 序号 | 现有应用 | 类型 | 对标 Alpha 模块 | 覆盖度 | 差距评估 |
|------|---------|------|----------------|--------|---------|
| 1 | 法律法规检索 | 对话 | 类案检索 | ★★☆☆☆ | 仅支持文字检索,缺少类案综述、参照级别、法官风格分析 |
| 2 | 法律咨询助手 | 对话 | 法律咨询 | ★★★☆☆ | 有分析框架,缺少结构化报告导出、可视化输出、交叉验证 |
| 3 | 合同条款审查 | 对话 | 合同审查 | ★★☆☆☆ | 基础审查能力有,缺少立场设定、自定义规则、主体尽调、多版本导出 |
| 4 | 法律文书生成 | 补全 | 文书起草 | ★★★☆☆ | 能生成常见文书,缺少模板库、法条超链、要素式格式 |
| 5 | 案情摘要提取 | 补全 | 法律阅卷 | ★★☆☆☆ | 仅单文档提取,缺少多文档问答、追问溯源、快捷阅卷、质证意见 |
| 6 | 合同条款生成 | 补全 | 合同审查(生成部分) | ★★★☆☆ | 基本可用,缺少业务模板库 |
| 7 | 案件风险评估 | 工作流 | 法律咨询(风险预测) | ★★★☆☆ | 多维度评估较好,缺少类案数据支撑 |
| 8 | 尽职调查报告 | 工作流 | 合同审查(主体尽调) | ★★☆☆☆ | 仅报告框架,缺少企业数据联动 |
| 9 | 诉讼策略助手 | 智能体 | 跨模块综合 | ★★★☆☆ | 概念完整,缺少真实数据调用能力 |
| 10 | 合规审查助手 | 智能体 | 无直接对标(增值能力) | ★★★☆☆ | 我们独有的差异化功能 |
---
## 二、Alpha 功能中可完善进现有应用的清单
### 优先级 P0:增强现有应用(改 prompt + 知识库即可)
| # | 增强内容 | 目标应用 | Alpha 对应功能 | 实现方式 |
|---|---------|---------|---------------|---------|
| 1 | **审查立场设定** | 合同条款审查 | 合同审查-审查立场 | prompt 增加立场参数(甲方/乙方/中立),输出差异化审查意见 |
| 2 | **风险等级细化** | 合同条款审查 | 合同审查-法规结合审查 | prompt 引导结合知识库法规对每条款给出法律依据 |
| 3 | **结构化报告输出** | 法律咨询助手 | 法律咨询-一键导出报告 | prompt 增加"报告模式",输出完整法律咨询意见书(含封面、目录、正文、附录) |
| 4 | **快捷阅卷模板** | 案情摘要提取 | 法律阅卷-快捷提问 | prompt 增加固定输出模块:证据清单、事件时间轴、争议焦点、庭审提纲 |
| 5 | **质证意见生成** | 案情摘要提取 | 法律阅卷-质证意见 | prompt 增加"三性分析"模块(真实性、合法性、关联性) |
| 6 | **文书模板分类** | 法律文书生成 | 文书起草-模板起草 | input_placeholder 细化为七大类模板选择,prompt 按模板输出标准格式 |
| 7 | **法条引用强化** | 法律文书生成 | 文书起草-法条超链引用 | prompt 要求引用法条使用 `[[知识库:法律名:第X条]]` 格式,自动渲染为可点击徽章 |
| 8 | **类案综述生成** | 法律法规检索 | 类案检索-类案综述 | prompt 在检索结果后自动生成"类案综述"段落,包含裁判趋势和建议 |
### 优先级 P1:新增应用(填补功能空白)
| # | 新应用名称 | 类型 | Alpha 对应功能 | 功能说明 |
|---|----------|------|---------------|---------|
| 1 | **质证意见生成** | 补全 | 法律阅卷-质证意见 | 输入证据材料清单,从真实性、合法性、关联性三维度生成质证意见书 |
| 2 | **庭审提纲生成** | 补全 | 法律阅卷-快捷提问 | 输入案件信息,生成完整庭审提纲(含开庭陈述、举证质证、辩论要点) |
| 3 | **法官裁判分析** | 对话 | 类案检索-法官审判风格 | 输入法官姓名/法院/案由,分析裁判倾向、量刑幅度、审理周期(需知识库支撑) |
| 4 | **企业合规体检** | 工作流 | 合同审查-主体审查 | 分步输入企业信息,生成涉诉风险、行政处罚、经营异常等合规体检报告 |
### 优先级 P2:远期能力建设(需系统级支持)
| # | 能力 | Alpha 对应功能 | 说明 | 前置条件 |
|---|------|---------------|------|---------|
| 1 | 文档上传问答 | 法律阅卷-多文档问答 | 上传多个文件后综合问答,回答可溯源到原文 | 需要文件上传+分片+向量检索能力 |
| 2 | 合同多版本导出 | 合同审查-多版本导出 | 修订版、批注版、纯净版等多格式导出 | 需要 docx 生成和 diff 能力 |
| 3 | 企业工商数据联动 | 合同审查-主体审查 | 对接天眼查/企查查 API,实时查询企业信息 | 需要外部 API 接入 |
| 4 | 可视化输出 | 法律咨询-PPT/思维导图 | 分析结果生成 PPT 或思维导图 | 需要前端渲染引擎 |
| 5 | 语音检索 | 类案检索-语音检索 | 语音输入转文字后检索 | 需要 ASR 服务接入 |
| 6 | 案件管理系统 | Alpha+ 案件管理 | 全流程案件管理、智能节点预警 | 需要独立模块开发 |
| 7 | 知识库沉淀 | Alpha+ 知识库 | 办案经验自动沉淀为知识资产 | 当前知识库可部分支持 |
---
## 三、应用分类调整建议
当前律师域只有一个分类"法律服务",建议参照 Alpha 模块拆分:
| 新分类 | 包含应用 | 说明 |
|--------|---------|------|
| **法律检索** | 法律法规检索、法官裁判分析(新) | 对标 Alpha 类案检索模块 |
| **合同服务** | 合同条款审查、合同条款生成 | 对标 Alpha 合同审查模块 |
| **文书起草** | 法律文书生成、质证意见生成(新)、庭审提纲生成(新) | 对标 Alpha 文书起草+阅卷 |
| **案件分析** | 法律咨询助手、案情摘要提取、案件风险评估 | 对标 Alpha 法律咨询+阅卷 |
| **综合服务** | 诉讼策略助手、合规审查助手、尽职调查报告、企业合规体检(新) | 对标 Alpha 智能体+Alpha+ |
---
## 四、P0 增强实施路线(可立即执行)
```
第 1 步:增强 3 个现有应用的 system_prompt0.5天)
├─ 合同条款审查 → 加入审查立场(甲方/乙方)、法规结合审查
├─ 案情摘要提取 → 重命名为"法律阅卷助手",加入快捷阅卷+质证意见
└─ 法律文书生成 → 加入模板分类选择、法条徽章引用
第 2 步:增强 2 个现有应用的输出格式(0.5天)
├─ 法律咨询助手 → 加入"报告模式"结构化输出
└─ 法律法规检索 → 加入类案综述自动生成
第 3 步:完善知识库内容(1天)
├─ 法律法规库 → 补充常用法律全文(民法典、刑法、劳动法等)
├─ 合同模板库 → 补充各类型合同审查要点checklist
└─ 文书模板库 → 补充法院要求的最新文书格式标准
```
---
## 五、我们的差异化优势(Alpha 没有的)
| 能力 | 说明 |
|------|------|
| **多机构隔离** | 同一平台支持多家律所独立运营,数据完全隔离 |
| **知识库自定义** | 律所可上传自有案例库、内部制度,形成专属知识资产 |
| **应用自创建** | 律师可自行创建/定制 AI 应用,不受产品功能限制 |
| **合规审查助手** | Alpha 无专门的企业合规审查工具,我们已有 |
| **开放部署** | 支持私有化部署,不依赖特定厂商生态 |
| **来源溯源徽章** | AI 输出自动标注知识库来源和 AI 建议,增强可信度 |
---
## 六、总结
**核心结论**:当前律师域 10 个应用覆盖了 Alpha 五大模块的基础能力,但在**深度**和**专业度**上有明显差距。
**最快见效的 3 件事**
1. **合同条款审查加入立场设定** — 一行 prompt 改动,立刻提升专业感
2. **案情摘要提取升级为法律阅卷助手** — 加入快捷模板(证据清单/时间轴/质证意见),功能翻倍
3. **法律文书生成加入法条徽章** — 利用已有的 `[[知识库:...]]` 渲染机制,法条可点击
**不建议做的事**ROI 太低):
- 企业工商数据联动(需付费 API + 大量开发)
- 语音检索(使用频率低)
- 完整案件管理系统(偏离 AI 应用平台定位)