HarmonyOS 6（API 23）实战：基于悬浮导航、沉浸光感与HMAF的“律界智脑“——PC端AI智能体沉浸式法律文档智能审查工作台

文章目录

• • 每日一句正能量
  • 前言
  • 一、前言：法律科技3.0时代的智能体革命
  • 二、核心特性解析与技术选型
  • • 2.1 HMAF在法律文档审查中的价值
    • 2.2 沉浸光感在法律审查中的创新应用
    • 2.3 悬浮导航的法律适配
  • 三、项目实战："律界智脑"架构设计
  • • 3.1 应用场景与功能规划
    • 3.2 技术架构图
  • 四、环境配置与模块依赖
  • • 4.1 模块依赖配置
    • 4.2 权限声明（module.json5）
  • 五、核心组件实战
  • • 5.1 窗口沉浸配置（EntryAbility.ets）
    • 5.2 风险等级光效系统（RiskLightEffect.ets）
    • 5.3 HMAF四层审查智能体架构（ReviewAgentScheduler.ets）
    • 5.4 悬浮审查导航（ReviewFloatNavigation.ets）
    • 5.5 主文档编辑器与风险高亮（DocumentReviewPage.ets）
    • 5.6 浮动风险清单窗口（RiskListAbility.ets）
    • 5.7 多窗口光效同步管理器（WindowLightSync.ets）
  • 六、关键技术总结
  • • 6.1 HMAF法律文档审查开发清单
    • 6.2 沉浸光感实现清单
    • 6.3 风险等级光效映射
    • 6.4 PC端多窗口光效协同
  • 七、调试与适配建议
  • • 7.1 法律文档解析性能优化
    • 7.2 风险光效可访问性
    • 7.3 多窗口管理优化
  • 八、运行效果展示
  • • 8.1 文档概览阶段 – 无风险光效
    • 8.2 条款审查阶段 – 中风险光效
    • 8.3 风险分析阶段 – 高风险光效
    • 8.4 合规报告阶段 – 极高风险光效
  • 九、总结与展望

每日一句正能量

“重要的不是经历什么，而是如何诠释这些经历。” 同样失业，有人诠释为“我完了”，有人诠释为“终于可以换赛道”。经历是客观事件，诠释是主观选择。把诠释权握在自己手里，人就永远不是命运的受害者。

前言

摘要：2026年，法律科技（LegalTech）进入"智能体驱动合规"时代。中国法律服务市场规模突破1.5万亿元，但传统法律文档审查面临条款遗漏、风险识别滞后、跨文档比对低效三大痛点。HarmonyOS 6（API 23）引入的鸿蒙智能体框架（HMAF）将AI能力下沉至系统层，配合悬浮导航与沉浸光感特性，为PC端法律文档审查带来了"条款即光效、风险即导航"的全新交互范式。本文将实战开发一款面向HarmonyOS PC的"律界智脑"应用，展示如何利用HMAF构建"文档解析-条款识别-风险研判-合规建议"四层智能体协作架构，通过悬浮导航实现审查阶段实时追踪，基于沉浸光感打造"风险等级即氛围"的沉浸体验，以及基于多窗口架构构建浮动条款对比、风险清单和法条引用窗口的协作审查体验。

一、前言：法律科技3.0时代的智能体革命

2026年，中国法律服务市场规模已突破1.5万亿元，企业法务团队年均处理合同超过5000份，但传统法律文档审查工具面临三大核心痛点：

HarmonyOS 6（API 23）的HMAF框架配合**悬浮导航（Float Navigation）与沉浸光感（Immersive Light Effects）**特性，为法律文档智能审查带来了革命性解决方案：

• 智能体协同审查：HMAF构建的"条款智能体"可深度解析合同结构，自动识别关键条款与风险点，响应延迟降至1.5秒，审查效率提升8倍

• 风险等级光效感知：根据当前文档风险等级（无风险/低风险/中风险/高风险/极高风险）动态切换环境光色，让法务人员"看见"风险分布

• 悬浮审查导航：底部悬浮导航实时显示四大智能体运行状态与审查进度徽章，法务人员无需切换页面即可掌握全局审查态势

• PC多窗口协作审查：主文档编辑器 + 浮动条款对比窗口 + 浮动风险清单窗口 + 浮动法条引用窗口的四层架构，通过光效联动实现"一眼全局"

本文核心亮点：

• 风险等级光效：根据文档风险等级动态切换环境光色与脉冲节奏（无风险柔绿、低风险淡蓝、中风险暖黄、高风险橙红、极高风险警示红）

• 悬浮审查导航：底部悬浮页签替代传统工具栏，支持审查阶段切换、风险统计徽章、条款类型实时角标

• HMAF四层审查架构：基于Agent Framework Kit构建"文档解析-条款识别-风险研判-合规建议"四层智能体协作体系

• 多窗口光效联动：主文档窗口 + 浮动条款对比 + 浮动风险清单 + 浮动法条引用的光效同步与焦点感知

• 审查意图沉浸感知：通过Intents Kit实时理解法务人员审查意图，自动调整界面光效与导航形态

二、核心特性解析与技术选型

2.1 HMAF在法律文档审查中的价值

HarmonyOS 6的HMAF采用四层架构设计：应用智能体层、智能体框架层、AI引擎层、智能体内核层。在"律界智脑"中，这种架构能够：

• 原生智能调度：法律智能体不再是应用的附属品，而是系统的基础能力，支持跨文档任务编排

• 意图即审查：通过Intents Kit将法务人员自然语言意图（如"找出所有知识产权相关条款"）转化为结构化审查任务

• 分布式智能体协同：利用鸿蒙分布式软总线，实现PC主控+平板批注+手机审批的多设备协作

• 端云协同推理：端侧处理文档解析与条款提取，云端大模型处理复杂风险研判与判例检索

2.2 沉浸光感在法律审查中的创新应用

HarmonyOS 6的 systemMaterialEffect 通过模拟物理光照模型，为审查状态反馈带来细腻的视觉表达。在法律文档场景中，这种材质效果能够：

• 增强风险感知：不同风险等级拥有专属光效标识（无风险柔绿、低风险淡蓝、中风险暖黄、高风险橙红、极高风险警示红）

• 状态直觉感知：解析时的呼吸蓝光、识别条款时的脉冲金光、发现风险时的警示红光、生成建议时的确认绿光

• 提升审查专注度：动态环境光随文档复杂度变化，简单合同柔和、复杂并购协议强烈

2.3 悬浮导航的法律适配

传统法律审查工具采用固定侧边栏导航，在PC大屏环境下占用大量横向空间。HarmonyOS 6的悬浮导航通过以下方式适配法律场景：

• 审查阶段页签：底部悬浮页签承载"文档概览-条款审查-风险分析-合规报告"四个审查阶段

• 风险统计徽章：页签角标实时显示当前阶段发现的风险条款数量，帮助法务人员快速定位

• 条款类型角标：显示已识别的条款类型数量（如"已识别12类条款，3项风险"）

• 透明度三档调节：支持强/平衡/弱三档，最大化文档阅读区域

三、项目实战："律界智脑"架构设计

3.1 应用场景与功能规划

面向HarmonyOS PC的法律文档智能审查场景，核心功能包括：

3.2 技术架构图

┌─────────────────────────────────────────────────────────┐
│ 律界智脑 – 应用层 │
├─────────────┬─────────────┬─────────────┬──────────────┤
│ 文档解析Agent │ 条款识别Agent │ 风险研判Agent │ 合规建议Agent │
├─────────────┴─────────────┴─────────────┴──────────────┤
│ HMAF 鸿蒙智能体框架（API 23） │
├─────────────────────────────────────────────────────────┤
│ 悬浮导航(Float Navigation) │ 沉浸光感(Immersive Light) │
├─────────────────────────────────────────────────────────┤
│ ArkUI / ArkTS / RichEditor │
├─────────────────────────────────────────────────────────┤
│ HarmonyOS 6.1.0 (API 23) PC端 │
└─────────────────────────────────────────────────────────┘

四、环境配置与模块依赖

4.1 模块依赖配置

在 oh-package.json5 中添加以下依赖：

{
"dependencies": {
"@kit.UIDesignKit": "^1.0.0",
"@kit.AgentFrameworkKit": "^1.0.0",
"@kit.IntentsKit": "^1.0.0",
"@kit.WindowManagerKit": "^1.0.0",
"@kit.CoreFileKit": "^1.0.0",
"@kit.PDFKit": "^1.0.0"
}
}

4.2 权限声明（module.json5）

{
"module": {
"name": "entry",
"type": "entry",
"description": "律界智脑 – AI智能体法律文档审查工作台",
"mainElement": "EntryAbility",
"deviceTypes": ["2in1"],
"abilities": [
{
"name": "EntryAbility",
"srcEntry": "./ets/entryability/EntryAbility.ets",
"description": "主文档编辑器窗口",
"icon": "$media:icon",
"label": "$string:EntryAbility_label",
"startWindowIcon": "$media:startIcon",
"startWindowBackground": "$color:start_window_background",
"exported": true,
"skills": [
{
"actions": ["action.system.home"],
"entities": ["entity.system.home"]
}
]
},
{
"name": "ClauseCompareAbility",
"srcEntry": "./ets/clauseability/ClauseCompareAbility.ets",
"description": "浮动条款对比窗口",
"launchType": "multiton"
},
{
"name": "RiskListAbility",
"srcEntry": "./ets/riskability/RiskListAbility.ets",
"description": "浮动风险清单窗口",
"launchType": "multiton"
},
{
"name": "LawRefAbility",
"srcEntry": "./ets/lawability/LawRefAbility.ets",
"description": "浮动法条引用窗口",
"launchType": "multiton"
}
],
"requestPermissions": [
{ "name": "ohos.permission.INTERNET" },
{ "name": "ohos.permission.GET_NETWORK_INFO" },
{ "name": "ohos.permission.READ_MEDIA" },
{ "name": "ohos.permission.WRITE_MEDIA" }
]
}
}

五、核心组件实战

5.1 窗口沉浸配置（EntryAbility.ets）

代码亮点：本模块实现法律文档审查的全屏沉浸模式。通过setWindowLayoutFullScreen消除系统栏干扰，setWindowSystemBarEnable隐藏状态栏，配合setWindowBackgroundColor设置透明背景，让底层风险光效能够完整透出，营造"文档悬浮于风险氛围之中"的沉浸感。

// entry/src/main/ets/entryability/EntryAbility.ets

import { UIAbility, Want, AbilityConstant } from '@kit.AbilityKit';
import { window } from '@kit.WindowManagerKit';

export default class EntryAbility extends UIAbility {
async onWindowStageCreate(windowStage: window.WindowStage): Promise<void> {
// 创建主窗口
const mainWindow = await windowStage.createMainWindow('DocumentReviewPage');

// 设置全屏沉浸 – 消除所有系统栏干扰
await mainWindow.setWindowLayoutFullScreen(true);
await mainWindow.setWindowSystemBarEnable([]);

// 设置窗口背景为透明，允许底层风险光效透出
await mainWindow.setWindowBackgroundColor('#00000000');

// 设置窗口最小尺寸，确保法律文档阅读体验
await mainWindow.setWindowMinWidth(1280);
await mainWindow.setWindowMinHeight(800);

// 加载主页面
await mainWindow.loadContent('pages/DocumentReviewPage');
await mainWindow.show();

console.info('LegalReview main window created with immersive mode');
}

onWindowStageDestroy(): void {
console.info('EntryAbility window stage destroyed');
}
}

5.2 风险等级光效系统（RiskLightEffect.ets）

代码亮点：本模块实现了"风险等级即光效"的沉浸感知系统，这是"律界智脑"最核心的视觉创新。通过RiskLevel枚举定义五种风险等级的专属光效人格，利用systemMaterialEffect为标题栏和导航组件注入物理光照级的光晕效果，结合Canvas绘制动态呼吸光背景，实现法务人员"一眼感知风险"的直觉体验。

// entry/src/main/ets/theme/RiskLightEffect.ets

import { hdsMaterial, SystemMaterialEffect } from '@kit.UIDesignKit';

/**
* 风险等级枚举 – 每种等级对应专属光效人格
*/
export enum RiskLevel {
NONE = 'none', // 无风险 – 安心柔绿
LOW = 'low', // 低风险 – 冷静淡蓝
MEDIUM = 'medium', // 中风险 – 警示暖黄
HIGH = 'high', // 高风险 – 紧迫橙红
CRITICAL = 'critical' // 极高风险 – 危险警示红
}

/**
* 光效配置接口
*/
export interface RiskLightConfig {
primaryColor: string; // 主色调
ambientColor: string; // 环境光色
glowColor: string; // 光晕色
pulseSpeed: number; // 脉冲速度(ms)
pulseIntensity: number; // 脉冲强度 0-1
materialEffect: SystemMaterialEffect;
riskLabel: string; // 风险标签文本
}

/**
* 风险光效主题管理器
* 核心创新：根据当前文档最高风险等级，动态切换全局光效氛围
*/
export class RiskLightTheme {
// 五种风险等级的光效配置
private static readonly LIGHT_MAP: Record<RiskLevel, RiskLightConfig> = {
[RiskLevel.NONE]: {
primaryColor: '#27AE60', // 安心绿
ambientColor: '#E8F8F0', // 淡绿环境
glowColor: '#7ED6A8', // 柔光晕
pulseSpeed: 4000, // 极缓慢脉冲 – 安心感
pulseIntensity: 0.15,
materialEffect: SystemMaterialEffect.IMMERSIVE,
riskLabel: '无风险'
},
[RiskLevel.LOW]: {
primaryColor: '#3498DB', // 冷静蓝
ambientColor: '#EBF5FB', // 淡蓝环境
glowColor: '#85C1E9', // 柔蓝光晕
pulseSpeed: 3500, // 缓慢脉冲
pulseIntensity: 0.2,
materialEffect: SystemMaterialEffect.IMMERSIVE,
riskLabel: '低风险'
},
[RiskLevel.MEDIUM]: {
primaryColor: '#F39C12', // 警示黄
ambientColor: '#FEF5E7', // 淡黄环境
glowColor: '#F8C471', // 暖黄光晕
pulseSpeed: 2500, // 中等脉冲 – 注意感
pulseIntensity: 0.35,
materialEffect: SystemMaterialEffect.IMMERSIVE,
riskLabel: '中风险'
},
[RiskLevel.HIGH]: {
primaryColor: '#E67E22', // 紧迫橙
ambientColor: '#FDEEE0', // 淡橙环境
glowColor: '#F0A060', // 橙红光晕
pulseSpeed: 1800, // 较快脉冲 – 紧迫感
pulseIntensity: 0.5,
materialEffect: SystemMaterialEffect.IMMERSIVE,
riskLabel: '高风险'
},
[RiskLevel.CRITICAL]: {
primaryColor: '#E74C3C', // 危险红
ambientColor: '#FDEDEC', // 淡红环境
glowColor: '#FF6B6B', // 警示红光晕
pulseSpeed: 1000, // 急促脉冲 – 危险感
pulseIntensity: 0.7,
materialEffect: SystemMaterialEffect.IMMERSIVE,
riskLabel: '极高风险'
}
};

// 当前主题状态（全局共享）
@StorageLink('currentRiskLevel') currentRisk: RiskLevel = RiskLevel.NONE;
@StorageLink('ambientLightColor') ambientColor: string = '#E8F8F0';
@StorageLink('primaryLightColor') primaryColor: string = '#27AE60';
@StorageLink('riskPulsePhase') pulsePhase: number = 0;

/**
* 切换风险等级光效
* @param level 风险等级
*/
public switchRiskLight(level: RiskLevel): void {
const config = RiskLightTheme.LIGHT_MAP[level];
this.currentRisk = level;
this.ambientColor = config.ambientColor;
this.primaryColor = config.primaryColor;

// 触发全局光效同步事件
AppStorage.setOrCreate('lightEffectChanged', Date.now());
AppStorage.setOrCreate('riskLevelChanged', level);
}

/**
* 根据风险条款数量自动计算风险等级
*/
public autoCalculateRisk(criticalCount: number, highCount: number, mediumCount: number): RiskLevel {
if (criticalCount > 0) return RiskLevel.CRITICAL;
if (highCount > 0) return RiskLevel.HIGH;
if (mediumCount > 0) return RiskLevel.MEDIUM;
if (highCount + mediumCount + criticalCount === 0 && this.hasAnyRisk()) return RiskLevel.LOW;
return RiskLevel.NONE;
}

private hasAnyRisk(): boolean {
// 检查是否存在任何风险条款
const risks = AppStorage.get<RiskItem[]>('riskItems') || [];
return risks.length > 0;
}

/**
* 获取当前光效配置
*/
public getCurrentConfig(): RiskLightConfig {
return RiskLightTheme.LIGHT_MAP[this.currentRisk];
}

/**
* 获取HdsNavigation的系统材质配置
*/
public getNavigationMaterial(): object {
const config = this.getCurrentConfig();
return {
systemMaterialEffect: {
materialType: hdsMaterial.MaterialType.ADAPTIVE,
materialLevel: hdsMaterial.MaterialLevel.ADAPTIVE,
effect: config.materialEffect
}
};
}

/**
* 获取风险等级徽章样式
*/
public getRiskBadgeStyle(): { bgColor: string; textColor: string; borderColor: string } {
const config = this.getCurrentConfig();
return {
bgColor: config.primaryColor + '1A', // 10%透明度背景
textColor: config.primaryColor,
borderColor: config.primaryColor + '4D' // 30%透明度边框
};
}
}

// 风险条款接口
export interface RiskItem {
id: string;
clauseId: string;
clauseText: string;
riskType: string;
riskLevel: RiskLevel;
suggestion: string;
relatedLaws: string[];
position: { start: number; end: number };
}

// 条款接口
export interface ContractClause {
id: string;
title: string;
content: string;
clauseType: string;
riskLevel: RiskLevel;
startIndex: number;
endIndex: number;
isKeyClause: boolean;
}

export const riskLightTheme = new RiskLightTheme();

5.3 HMAF四层审查智能体架构（ReviewAgentScheduler.ets）

代码亮点：本模块是"律界智脑"的核心智能层，实现了"文档解析-条款识别-风险研判-合规建议"四层智能体协作架构。通过Agent Framework Kit创建多智能体会话，四个Agent并行处理法律文档，结果实时汇聚到文档编辑器。关键创新在于利用Intents Kit解析法务人员的审查意图（如"找出所有不对等赔偿条款"），自动触发对应Agent协作并调整界面风险光效。

// entry/src/main/ets/agents/ReviewAgentScheduler.ets

import {
hmaf,
AgentSession,
AgentMode,
TaskMessage,
TaskResult
} from '@kit.AgentFrameworkKit';
import { intents, IntentEngine, IntentResult } from '@kit.IntentsKit';
import { riskLightTheme, RiskLevel, RiskItem, ContractClause } from '../theme/RiskLightEffect';

/**
* 智能体类型定义
*/
export enum AgentType {
DOC_PARSER = 'doc_parser', // 文档解析Agent
CLAUSE_IDENTIFIER = 'clause_identifier', // 条款识别Agent
RISK_ANALYZER = 'risk_analyzer', // 风险研判Agent
COMPLIANCE_ADVISOR = 'compliance_advisor' // 合规建议Agent
}

/**
* 审查阶段枚举
*/
export enum ReviewStage {
OVERVIEW = 'overview', // 文档概览
CLAUSE_REVIEW = 'clause', // 条款审查
RISK_ANALYSIS = 'risk', // 风险分析
COMPLIANCE_REPORT = 'report' // 合规报告
}

/**
* 文档解析结果接口
*/
export interface ParseResult {
docType: string; // 文档类型：合同/协议/章程/法律意见书
totalClauses: number; // 总条款数
keyClauses: number; // 关键条款数
parties: string[]; // 当事方
effectiveDate: string; // 生效日期
expirationDate: string; // 到期日期
jurisdiction: string; // 管辖约定
}

/**
* HMAF法律文档审查智能体调度器
* 核心：四层智能体协作，实现法律文档的自动解析与风险审查
*/
export class ReviewAgentScheduler {
private session: AgentSession | null = null;
private intentEngine: IntentEngine | null = null;

// 审查数据存储
private clauses: Map<string, ContractClause> = new Map();
private risks: Map<string, RiskItem> = new Map();
private parseResult: ParseResult | null = null;

// 回调监听
private onDocumentParsed?: (result: ParseResult) => void;
private onClausesIdentified?: (clauses: ContractClause[]) => void;
private onRisksAnalyzed?: (risks: RiskItem[]) => void;
private onComplianceReady?: (report: ComplianceReport) => void;
private onStageChanged?: (stage: ReviewStage) => void;

/**
* 初始化智能体会话
*/
public async initialize(): Promise<void> {
this.session = await hmaf.createAgentSession({
mode: AgentMode.MULTI_AGENT,
config: {
maxConcurrentAgents: 4,
timeout: 60000, // 法律文档解析需要更长时间
enableDistributed: true
}
});

this.intentEngine = await intents.createIntentEngine({
supportedDomains: ['legal_review', 'contract_analysis', 'risk_assessment', 'compliance_check']
});

await this.registerAgents();
console.info('ReviewAgentScheduler initialized successfully');
}

/**
* 注册四层审查智能体
*/
private async registerAgents(): Promise<void> {
if (!this.session) return;

// 1. 文档解析Agent – 识别文档结构与基本信息
await this.session.registerAgent({
agentId: AgentType.DOC_PARSER,
capabilities: ['document_structure_analysis', 'party_extraction', 'date_recognition', 'jurisdiction_identification'],
promptTemplate: `
你是法律文档解析专家。分析给定文档的结构与基本信息：
– 识别文档类型（合同/协议/章程/法律意见书/起诉状）
– 提取所有当事方名称与角色
– 识别生效日期、到期日期、续约条款
– 提取管辖约定与争议解决条款位置
– 统计总条款数与关键条款数

返回JSON格式: {
"docType": "合同",
"totalClauses": 25,
"keyClauses": 8,
"parties": ["甲方名称", "乙方名称"],
"effectiveDate": "2026-01-01",
"expirationDate": "2027-01-01",
"jurisdiction": "北京市朝阳区人民法院"
}
`
});

// 2. 条款识别Agent – 提取并分类关键条款
await this.session.registerAgent({
agentId: AgentType.CLAUSE_IDENTIFIER,
capabilities: ['clause_extraction', 'clause_classification', 'key_term_identification', 'obligation_recognition'],
promptTemplate: `
你是法律条款识别专家。从文档中提取所有关键条款并分类：
– 知识产权条款（IP_CLAUSE）
– 违约责任条款（BREACH_CLAUSE）
– 保密条款（CONFIDENTIALITY）
– 争议解决条款（DISPUTE_CLAUSE）
– 自动续约条款（AUTO_RENEWAL）
– 不对等赔偿条款（UNILATERAL_INDEMNITY）
– 竞业限制条款（NON_COMPETE）
– 不可抗力条款（FORCE_MAJEURE）

对每个条款标注：标题、内容摘要、在文档中的起止位置、是否关键条款

返回JSON格式: [{"id": "clause_1", "title": "知识产权归属", "content": "…", "clauseType": "IP_CLAUSE", "isKeyClause": true, "startIndex": 1200, "endIndex": 1500}]
`
});

// 3. 风险研判Agent – 评估条款风险等级
await this.session.registerAgent({
agentId: AgentType.RISK_ANALYZER,
capabilities: ['risk_assessment', 'unfair_term_detection', 'compliance_gap_analysis', 'precedent_matching'],
promptTemplate: `
你是法律风险研判专家。分析给定条款的风险等级：
– 无风险（NONE）：标准条款，符合行业惯例
– 低风险（LOW）：轻微不利，可接受范围
– 中风险（MEDIUM）：需要关注，建议协商修改
– 高风险（HIGH）：严重不利，必须修改
– 极高风险（CRITICAL）：可能导致重大损失，拒绝签署

对每个风险条款提供：风险类型、风险等级、具体建议、相关法条引用

返回JSON格式: [{"id": "risk_1", "clauseId": "clause_1", "riskType": "不对等赔偿", "riskLevel": "HIGH", "suggestion": "建议增加赔偿上限条款", "relatedLaws": ["民法典第584条"]}]
`
});

// 4. 合规建议Agent – 生成合规报告与修改建议
await this.session.registerAgent({
agentId: AgentType.COMPLIANCE_ADVISOR,
capabilities: ['compliance_reporting', 'contract_optimization', 'legal_precedent_retrieval', 'amendment_drafting'],
promptTemplate: `
你是合规建议专家。基于风险分析结果生成完整合规报告：
– 文档整体合规评分（0-100）
– 风险条款清单与优先级排序
– 具体修改建议与替代条款文本
– 相关判例参考与法条依据
– 谈判要点与策略建议

返回JSON格式: {
"overallScore": 72,
"riskSummary": "本合同存在3项高风险条款…",
"recommendations": [{"priority": 1, "clauseId": "clause_1", "currentText": "…", "suggestedText": "…", "rationale": "…"}],
"precedents": ["案例1", "案例2"]
}
`
});
}

/**
* 处理法务人员输入 – 意图解析 + 智能体分发
*/
public async processReviewIntent(input: string, documentText: string): Promise<void> {
if (!this.session || !this.intentEngine) {
throw new Error('Scheduler not initialized');
}

// 第一步：意图解析
const intentResult: IntentResult = await this.intentEngine.parseIntent(input);
const intent = intentResult.primaryIntent;

console.info(`Detected review intent: ${intent.domain}/${intent.action}`);

// 根据意图调整审查阶段
this.adjustStageByIntent(intent);

// 第二步：智能体任务分发
switch (intent.action) {
case 'parse_document':
await this.dispatchDocumentParse(documentText);
break;
case 'identify_clauses':
await this.dispatchClauseIdentification(documentText);
break;
case 'analyze_risks':
await this.dispatchRiskAnalysis(Array.from(this.clauses.values()));
break;
case 'generate_compliance_report':
await this.dispatchComplianceReport(Array.from(this.risks.values()));
break;
case 'full_review':
// 全链路：解析 -> 识别 -> 研判 -> 建议
await this.dispatchFullReview(documentText);
break;
default:
await this.dispatchFullReview(documentText);
}
}

/**
* 根据意图调整审查阶段与光效
*/
private adjustStageByIntent(intent: IntentResult['primaryIntent']): void {
const stageMap: Record<string, ReviewStage> = {
'parse_document': ReviewStage.OVERVIEW,
'identify_clauses': ReviewStage.CLAUSE_REVIEW,
'analyze_risks': ReviewStage.RISK_ANALYSIS,
'generate_compliance_report': ReviewStage.COMPLIANCE_REPORT
};

const newStage = stageMap[intent.action] || ReviewStage.OVERVIEW;
this.onStageChanged?.(newStage);
}

/**
* 分发文档解析任务
*/
private async dispatchDocumentParse(documentText: string): Promise<void> {
const task: TaskMessage = {
targetAgent: AgentType.DOC_PARSER,
taskType: 'parse',
payload: { documentText },
priority: 1
};

const result: TaskResult = await this.session!.sendTask(task);
this.parseResult = JSON.parse(result.data);

// 触发回调
this.onDocumentParsed?.(this.parseResult);

// 更新全局状态
AppStorage.setOrCreate('parseResult', this.parseResult);
}

/**
* 分发条款识别任务
*/
private async dispatchClauseIdentification(documentText: string): Promise<void> {
const task: TaskMessage = {
targetAgent: AgentType.CLAUSE_IDENTIFIER,
taskType: 'identify',
payload: { documentText },
priority: 2
};

const result: TaskResult = await this.session!.sendTask(task);
const identifiedClauses: ContractClause[] = JSON.parse(result.data);

// 存储条款
identifiedClauses.forEach(clause => {
this.clauses.set(clause.id, clause);
});

this.onClausesIdentified?.(identifiedClauses);
AppStorage.setOrCreate('identifiedClauses', identifiedClauses);
}

/**
* 分发风险研判任务
*/
private async dispatchRiskAnalysis(clauses: ContractClause[]): Promise<void> {
const task: TaskMessage = {
targetAgent: AgentType.RISK_ANALYZER,
taskType: 'analyze',
payload: { clauses },
priority: 3
};

const result: TaskResult = await this.session!.sendTask(task);
const analyzedRisks: RiskItem[] = JSON.parse(result.data);

// 存储风险
analyzedRisks.forEach(risk => {
this.risks.set(risk.id, risk);
});

// 计算并切换风险光效
this.updateRiskLightEffect();

this.onRisksAnalyzed?.(analyzedRisks);
AppStorage.setOrCreate('riskItems', analyzedRisks);
}

/**
* 分发合规报告任务
*/
private async dispatchComplianceReport(risks: RiskItem[]): Promise<void> {
const task: TaskMessage = {
targetAgent: AgentType.COMPLIANCE_ADVISOR,
taskType: 'report',
payload: {
risks,
clauses: Array.from(this.clauses.values()),
parseResult: this.parseResult
},
priority: 4
};

const result: TaskResult = await this.session!.sendTask(task);
const report: ComplianceReport = JSON.parse(result.data);

this.onComplianceReady?.(report);
AppStorage.setOrCreate('complianceReport', report);
}

/**
* 全链路审查调度
*/
private async dispatchFullReview(documentText: string): Promise<void> {
// 阶段1：文档解析
await this.dispatchDocumentParse(documentText);

// 阶段2：条款识别
await this.dispatchClauseIdentification(documentText);

// 阶段3：风险研判
const allClauses = Array.from(this.clauses.values());
await this.dispatchRiskAnalysis(allClauses);

// 阶段4：合规报告
const allRisks = Array.from(this.risks.values());
await this.dispatchComplianceReport(allRisks);
}

/**
* 更新风险光效
*/
private updateRiskLightEffect(): void {
const risks = Array.from(this.risks.values());
const criticalCount = risks.filter(r => r.riskLevel === RiskLevel.CRITICAL).length;
const highCount = risks.filter(r => r.riskLevel === RiskLevel.HIGH).length;
const mediumCount = risks.filter(r => r.riskLevel === RiskLevel.MEDIUM).length;

const autoLevel = riskLightTheme.autoCalculateRisk(criticalCount, highCount, mediumCount);
riskLightTheme.switchRiskLight(autoLevel);

// 更新风险统计到全局状态
AppStorage.setOrCreate('riskStats', {
total: risks.length,
critical: criticalCount,
high: highCount,
medium: mediumCount,
low: risks.filter(r => r.riskLevel === RiskLevel.LOW).length,
none: risks.filter(r => r.riskLevel === RiskLevel.NONE).length
});
}

// 设置回调
public setCallbacks(callbacks: {
onDocumentParsed?: (result: ParseResult) => void;
onClausesIdentified?: (clauses: ContractClause[]) => void;
onRisksAnalyzed?: (risks: RiskItem[]) => void;
onComplianceReady?: (report: ComplianceReport) => void;
onStageChanged?: (stage: ReviewStage) => void;
}): void {
this.onDocumentParsed = callbacks.onDocumentParsed;
this.onClausesIdentified = callbacks.onClausesIdentified;
this.onRisksAnalyzed = callbacks.onRisksAnalyzed;
this.onComplianceReady = callbacks.onComplianceReady;
this.onStageChanged = callbacks.onStageChanged;
}

/**
* 获取当前审查数据
*/
public getReviewData(): {
clauses: ContractClause[];
risks: RiskItem[];
parseResult: ParseResult | null
} {
return {
clauses: Array.from(this.clauses.values()),
risks: Array.from(this.risks.values()),
parseResult: this.parseResult
};
}
}

// 合规报告接口
export interface ComplianceReport {
overallScore: number;
riskSummary: string;
recommendations: Array<{
priority: number;
clauseId: string;
currentText: string;
suggestedText: string;
rationale: string;
}>;
precedents: string[];
}

// 导出单例
export const reviewAgentScheduler = new ReviewAgentScheduler();

5.4 悬浮审查导航（ReviewFloatNavigation.ets）

代码亮点：本模块实现了"审查阶段即导航"的悬浮页签系统。底部悬浮导航不仅承载"文档概览-条款审查-风险分析-合规报告"四个审查阶段切换，更实时显示风险统计徽章（极高风险/高风险/中风险/低风险数量）和条款类型角标。采用HdsTabs悬浮样式配合systemMaterialEffect实现玻璃拟态+风险光效的双重效果，支持透明度三档调节，最大化文档阅读区域。

// entry/src/main/ets/components/ReviewFloatNavigation.ets

import { HdsTabs, HdsTabsController, hdsMaterial } from '@kit.UIDesignKit';
import { riskLightTheme, RiskLevel } from '../theme/RiskLightEffect';
import { ReviewStage } from '../agents/ReviewAgentScheduler';

@Component
export struct ReviewFloatNavigation {
@StorageLink('currentReviewStage') currentStage: ReviewStage = ReviewStage.OVERVIEW;
@StorageLink('currentRiskLevel') currentRisk: RiskLevel = RiskLevel.NONE;
@StorageLink('primaryLightColor') primaryColor: string = '#27AE60';
@StorageLink('navTransparency') navTransparency: number = 0.75;
@State riskStats: { total: number; critical: number; high: number; medium: number; low: number; none: number } =
{ total: 0, critical: 0, high: 0, medium: 0, low: 0, none: 0 };

private hdsTabController: HdsTabsController = new HdsTabsController();

// 阶段对应的光效配置
private readonly STAGE_CONFIG: Record<ReviewStage, { color: string; icon: Resource; label: string }> = {
[ReviewStage.OVERVIEW]: {
color: '#3498DB',
icon: $r('app.media.icon_overview'),
label: '文档概览'
},
[ReviewStage.CLAUSE_REVIEW]: {
color: '#9B59B6',
icon: $r('app.media.icon_clause'),
label: '条款审查'
},
[ReviewStage.RISK_ANALYSIS]: {
color: '#E67E22',
icon: $r('app.media.icon_risk'),
label: '风险分析'
},
[ReviewStage.COMPLIANCE_REPORT]: {
color: '#27AE60',
icon: $r('app.media.icon_report'),
label: '合规报告'
}
};

aboutToAppear(): void {
// 监听风险统计变化
AppStorage.link('riskStats').onChange((value: typeof this.riskStats) => {
this.riskStats = value;
});
}

build() {
Column() {
// 风险等级脉冲指示器 – 顶部光条
this.RiskPulseIndicator()

// HdsTabs 悬浮审查导航
HdsTabs({
controller: this.hdsTabController,
barPosition: BarPosition.End
}) {
// 文档概览页签
TabContent() {
this.OverviewModeContent()
}
.tabBar(this.buildStageTabBar('概览', ReviewStage.OVERVIEW, 0))

// 条款审查页签
TabContent() {
this.ClauseReviewContent()
}
.tabBar(this.buildStageTabBar('条款', ReviewStage.CLAUSE_REVIEW,
this.riskStats.total))

// 风险分析页签
TabContent() {
this.RiskAnalysisContent()
}
.tabBar(this.buildStageTabBar('风险', ReviewStage.RISK_ANALYSIS,
this.riskStats.critical + this.riskStats.high))

// 合规报告页签
TabContent() {
this.ComplianceReportContent()
}
.tabBar(this.buildStageTabBar('报告', ReviewStage.COMPLIANCE_REPORT, 0))
}
.width('96%')
.height(72)
.backgroundColor(`rgba(255, 255, 255, ${this.navTransparency})`)
.borderRadius(20)
.shadow({
radius: 16,
color: 'rgba(0, 0, 0, 0.12)',
offsetX: 0,
offsetY: 4
})
// 核心：沉浸光感材质配置
.barFloatingStyle({
barBottomMargin: 16,
gradientMask: {
maskColor: '#66F1F3F5',
maskHeight: 92
},
systemMaterialEffect: {
materialType: hdsMaterial.MaterialType.ADAPTIVE,
materialLevel: hdsMaterial.MaterialLevel.ADAPTIVE
}
})
// 动态风险光效边框
.border({
width: 1.5,
color: this.primaryColor + '44', // 动态主题色边框
radius: 20
})
}
.width('100%')
.padding({ bottom: 12 })
}

/**
* 风险等级脉冲指示器
*/
@Builder
RiskPulseIndicator(): void {
Row() {
// 当前风险等级脉冲光条
Row()
.width(48)
.height(4)
.backgroundColor(this.primaryColor)
.borderRadius(2)
.shadow({
radius: 8,
color: this.primaryColor + '66',
offsetX: 0,
offsetY: 0
})
.animation({
duration: riskLightTheme.getCurrentConfig().pulseSpeed,
iterations: –1,
curve: Curve.EaseInOut
})
.opacity(
0.5 + Math.sin(AppStorage.get<number>('riskPulsePhase') || 0) *
riskLightTheme.getCurrentConfig().pulseIntensity
)
}
.width('100%')
.justifyContent(FlexAlign.Center)
.margin({ bottom: 8 })
}

/**
* 构建带风险徽章的审查阶段页签
*/
@Builder
buildStageTabBar(title: string, stage: ReviewStage, badgeCount: number): void {
Column() {
Stack() {
// 阶段图标
Image(this.STAGE_CONFIG[stage].icon)
.width(24)
.height(24)
.fillColor(this.currentStage === stage ? this.STAGE_CONFIG[stage].color : '#666666')

// 风险数量徽章（仅风险分析阶段显示红色警告）
if (badgeCount > 0) {
Text(badgeCount.toString())
.fontSize(10)
.fontColor('#FFFFFF')
.backgroundColor(
stage === ReviewStage.RISK_ANALYSIS ? '#E74C3C' : this.STAGE_CONFIG[stage].color
)
.borderRadius(8)
.padding({ left: 4, right: 4 })
.position({ x: 16, y: –6 })
}
}
.width(32)
.height(32)

Text(title)
.fontSize(12)
.fontColor(this.currentStage === stage ? this.STAGE_CONFIG[stage].color : '#999999')
.margin({ top: 4 })
}
.width('100%')
.onClick(() => {
this.currentStage = stage;
AppStorage.setOrCreate('reviewStageChanged', stage);
})
}

@Builder
OverviewModeContent(): void { /* 文档概览内容 */ }

@Builder
ClauseReviewContent(): void { /* 条款审查内容 */ }

@Builder
RiskAnalysisContent(): void { /* 风险分析内容 */ }

@Builder
ComplianceReportContent(): void { /* 合规报告内容 */ }
}

5.5 主文档编辑器与风险高亮（DocumentReviewPage.ets）

代码亮点：本模块实现了法律文档的核心编辑与审查层。基于RichEditor组件实现文档渲染，通过TextDecoration和BackgroundColorSpan实现风险条款的动态高亮。每个条款根据风险等级显示不同颜色的下划线和背景高亮，鼠标悬停时显示风险详情浮层。关键创新在于"风险呼吸光"——高风险条款的背景色会随风险光效脉冲节奏轻微呼吸，引导法务人员优先关注。

// entry/src/main/ets/pages/DocumentReviewPage.ets

import { RichEditor, RichEditorController, SelectionRange } from '@kit.ArkUI';
import { window } from '@kit.WindowManagerKit';
import { riskLightTheme, RiskLevel, RiskItem, ContractClause } from '../theme/RiskLightEffect';
import { reviewAgentScheduler, ReviewStage, ParseResult } from '../agents/ReviewAgentScheduler';
import { ReviewFloatNavigation } from '../components/ReviewFloatNavigation';

@Entry
@Component
struct DocumentReviewPage {
@StorageLink('currentRiskLevel') currentRisk: RiskLevel = RiskLevel.NONE;
@StorageLink('ambientLightColor') ambientColor: string = '#E8F8F0';
@StorageLink('primaryLightColor') primaryColor: string = '#27AE60';
@StorageLink('currentReviewStage') currentStage: ReviewStage = ReviewStage.OVERVIEW;

@State documentText: string = '';
@State clauses: ContractClause[] = [];
@State risks: RiskItem[] = [];
@State parseResult: ParseResult | null = null;
@State selectedClauseId: string = '';
@State isReviewing: boolean = false;
@State pulsePhase: number = 0;

private richEditorController: RichEditorController = new RichEditorController();
private readonly RISK_COLORS: Record<RiskLevel, string> = {
[RiskLevel.NONE]: '#27AE60',
[RiskLevel.LOW]: '#3498DB',
[RiskLevel.MEDIUM]: '#F39C12',
[RiskLevel.HIGH]: '#E67E22',
[RiskLevel.CRITICAL]: '#E74C3C'
};

aboutToAppear(): void {
// 初始化审查引擎
reviewAgentScheduler.initialize().then(() => {
reviewAgentScheduler.setCallbacks({
onDocumentParsed: (result) => {
this.parseResult = result;
},
onClausesIdentified: (newClauses) => {
this.clauses = newClauses;
this.highlightClauses();
},
onRisksAnalyzed: (newRisks) => {
this.risks = newRisks;
this.highlightRisks();
},
onStageChanged: (stage) => {
this.currentStage = stage;
}
});
});

// 启动呼吸光动画
this.startRiskPulseAnimation();

// 加载示例合同文本
this.loadDemoDocument();

// 设置窗口沉浸
this.setupImmersiveWindow();
}

/**
* 启动风险呼吸光动画
*/
private startRiskPulseAnimation(): void {
const animate = () => {
this.pulsePhase = (this.pulsePhase + 0.03) % (Math.PI * 2);
AppStorage.setOrCreate('riskPulsePhase', this.pulsePhase);

// 动态更新风险条款高亮强度
if (this.risks.length > 0) {
this.updateRiskHighlightIntensity();
}

requestAnimationFrame(animate);
};
animate();
}

/**
* 更新风险高亮强度
*/
private updateRiskHighlightIntensity(): void {
// 高风险条款的呼吸效果通过RichEditor的样式更新实现
const intensity = 0.3 + Math.sin(this.pulsePhase) * 0.2;
AppStorage.setOrCreate('riskHighlightIntensity', intensity);
}

/**
* 加载示例法律文档
*/
private async loadDemoDocument(): Promise<void> {
// 示例：一份包含多种风险条款的商业合同
this.documentText = `
软件技术服务合同

甲方（委托方）：科技有限公司
乙方（服务方）：软件技术有限公司

第一条 知识产权归属
乙方在履行本合同过程中产生的所有知识产权，包括但不限于软件著作权、专利权、商标权等，均归甲方所有。乙方仅保留署名权。
（风险：不对等条款 – 乙方知识产权完全让渡）

第二条 违约责任
任何一方违反本合同约定，应向守约方支付合同总金额十倍的违约金。无论实际损失大小，违约方均应按此标准赔偿。
（风险：违约金过高 – 违反民法典第585条）

第三条 保密义务
乙方应对甲方提供的所有商业秘密承担永久保密义务，即使本合同终止后仍持续有效。
（风险：保密期限不合理 – 永久保密缺乏法律依据）

第四条 争议解决
因本合同引起的任何争议，双方应友好协商解决；协商不成的，任何一方均可向甲方所在地人民法院提起诉讼。
（风险：管辖约定不对等 – 仅有利于甲方）

第五条 自动续约
本合同期满前30日，如任何一方未书面提出终止，本合同自动续约一年，续约次数不限。
（风险：自动续约陷阱 – 可能产生长期绑定）
`;

// 触发全链路审查
this.isReviewing = true;
await reviewAgentScheduler.processReviewIntent('请全面审查此合同', this.documentText);
this.isReviewing = false;
}

/**
* 高亮条款
*/
private highlightClauses(): void {
this.clauses.forEach(clause => {
const riskColor = this.RISK_COLORS[clause.riskLevel];

// 为关键条款添加背景高亮
if (clause.isKeyClause) {
this.richEditorController.addBackgroundColorSpan({
start: clause.startIndex,
length: clause.endIndex – clause.startIndex,
color: riskColor + '1A' // 10%透明度背景
});
}
});
}

/**
* 高亮风险条款
*/
private highlightRisks(): void {
this.risks.forEach(risk => {
const clause = this.clauses.get(risk.clauseId);
if (!clause) return;

const riskColor = this.RISK_COLORS[risk.riskLevel];

// 添加风险下划线
this.richEditorController.addTextDecorationSpan({
start: clause.startIndex,
length: clause.endIndex – clause.startIndex,
decorationType: TextDecorationType.Underline,
color: riskColor,
style: TextDecorationStyle.WAVY // 波浪线表示风险
});

// 高风险条款添加边框效果
if (risk.riskLevel === RiskLevel.HIGH || risk.riskLevel === RiskLevel.CRITICAL) {
this.richEditorController.addBackgroundColorSpan({
start: clause.startIndex,
length: clause.endIndex – clause.startIndex,
color: riskColor + '26' // 15%透明度背景
});
}
});
}

/**
* 处理文档点击 – 选中条款
*/
private handleDocumentClick(event: ClickEvent): void {
const position = this.richEditorController.getSelection();
if (!position) return;

// 查找点击位置所在的条款
const clickedClause = this.clauses.find(clause =>
position.start >= clause.startIndex && position.start <= clause.endIndex
);

if (clickedClause) {
this.selectedClauseId = clickedClause.id;
// 切换对应风险光效
const relatedRisk = this.risks.find(r => r.clauseId === clickedClause.id);
if (relatedRisk) {
riskLightTheme.switchRiskLight(relatedRisk.riskLevel);
}
// 打开条款对比浮动窗口
this.openClauseCompareWindow(clickedClause);
}
}

/**
* 打开条款对比浮动窗口
*/
private async openClauseCompareWindow(clause: ContractClause): Promise<void> {
const want = {
deviceId: '',
bundleName: getContext().applicationInfo.name,
abilityName: 'ClauseCompareAbility',
parameters: {
clauseId: clause.id,
clauseData: JSON.stringify(clause),
riskData: JSON.stringify(this.risks.find(r => r.clauseId === clause.id))
}
};
await getContext().startAbility(want);
}

/**
* 打开风险清单浮动窗口
*/
private async openRiskListWindow(): Promise<void> {
const want = {
deviceId: '',
bundleName: getContext().applicationInfo.name,
abilityName: 'RiskListAbility',
parameters: {
risksData: JSON.stringify(this.risks)
}
};
await getContext().startAbility(want);
}

/**
* 打开法条引用浮动窗口
*/
private async openLawRefWindow(): Promise<void> {
const want = {
deviceId: '',
bundleName: getContext().applicationInfo.name,
abilityName: 'LawRefAbility',
parameters: {
lawsData: JSON.stringify(this.getAllRelatedLaws())
}
};
await getContext().startAbility(want);
}

private getAllRelatedLaws(): string[] {
const laws = new Set<string>();
this.risks.forEach(risk => {
risk.relatedLaws.forEach(law => laws.add(law));
});
return Array.from(laws);
}

/**
* 设置窗口沉浸
*/
private async setupImmersiveWindow(): Promise<void> {
const win = await window.getLastWindow(getContext());
await win.setWindowLayoutFullScreen(true);
await win.setWindowSystemBarEnable([]);
}

build() {
Stack() {
// 动态风险光效背景层
Column()
.width('100%')
.height('100%')
.backgroundColor(this.ambientColor)
.animation({
duration: 800,
curve: Curve.EaseInOut
})

// 主内容区
Column() {
// 顶部标题栏 – 风险光效联动
Row() {
// 风险等级指示器
Row() {
Circle()
.width(10)
.height(10)
.fill(this.primaryColor)
.shadow({
radius: 6,
color: this.primaryColor + '80',
offsetX: 0,
offsetY: 0
})

Text(riskLightTheme.getCurrentConfig().riskLabel)
.fontSize(13)
.fontColor(this.primaryColor)
.margin({ left: 6 })
}

Blank()

Text('律界智脑')
.fontSize(18)
.fontWeight(FontWeight.Bold)
.fontColor('#333333')

Blank()

// 快捷操作按钮
Row({ space: 12 }) {
Button('风险清单')
.fontSize(12)
.backgroundColor(this.primaryColor + '1A')
.fontColor(this.primaryColor)
.borderRadius(6)
.onClick(() => this.openRiskListWindow())

Button('法条引用')
.fontSize(12)
.backgroundColor(this.primaryColor + '1A')
.fontColor(this.primaryColor)
.borderRadius(6)
.onClick(() => this.openLawRefWindow())
}
}
.width('100%')
.height(56)
.padding({ left: 24, right: 24 })
.backgroundColor('rgba(255, 255, 255, 0.85)')
.backdropFilter($r('sys.blur.20'))
.alignItems(VerticalAlign.Center)

// 文档信息栏
if (this.parseResult) {
Row() {
Text(`类型：${this.parseResult.docType}`)
.fontSize(11)
.fontColor('#666666')

Text(`条款：${this.parseResult.totalClauses}项`)
.fontSize(11)
.fontColor('#666666')
.margin({ left: 16 })

Text(`关键：${this.parseResult.keyClauses}项`)
.fontSize(11)
.fontColor(this.primaryColor)
.margin({ left: 16 })

if (this.isReviewing) {
Text('审查中…')
.fontSize(11)
.fontColor(this.primaryColor)
.margin({ left: 16 })
.animation({
duration: 1000,
iterations: –1,
curve: Curve.EaseInOut
})
.opacity(0.5 + Math.sin(this.pulsePhase) * 0.5)
}
}
.width('100%')
.height(36)
.padding({ left: 24, right: 24 })
.backgroundColor('rgba(255, 255, 255, 0.6)')
}

// 文档编辑器
RichEditor({ controller: this.richEditorController })
.width('100%')
.layoutWeight(1)
.padding(24)
.backgroundColor('#FFFFFF')
.borderRadius(12)
.margin(16)
.shadow({
radius: 12,
color: 'rgba(0, 0, 0, 0.06)',
offsetX: 0,
offsetY: 4
})
.onClick((event) => {
this.handleDocumentClick(event);
})

// 底部悬浮审查导航
Column() {
ReviewFloatNavigation()
}
.width('100%')
}
.width('100%')
.height('100%')
}
.width('100%')
.height('100%')
}
}

5.6 浮动风险清单窗口（RiskListAbility.ets）

代码亮点：本模块实现了浮动风险清单窗口，通过WindowManager创建独立的子窗口。关键创新在于"跨窗口风险光效同步"——当主窗口的风险等级变化时，浮动窗口通过AppStorage全局状态自动同步主题色，风险清单按等级分组显示，每组使用对应风险颜色的左侧边框标识。窗口失焦时自动降低透明度，保持法务人员的专注度。

// entry/src/main/ets/riskability/RiskListAbility.ets

import { window } from '@kit.WindowManagerKit';
import { riskLightTheme, RiskLevel, RiskItem } from '../theme/RiskLightEffect';

@Entry
@Component
struct RiskListPage {
@StorageLink('currentRiskLevel') currentRisk: RiskLevel = RiskLevel.NONE;
@StorageLink('primaryLightColor') primaryColor: string = '#27AE60';
@StorageLink('ambientLightColor') ambientColor: string = '#E8F8F0';

@State riskItems: RiskItem[] = [];
@State isWindowFocused: boolean = true;
@State selectedRiskId: string = '';

aboutToAppear(): void {
// 获取启动参数
const params = getContext().abilityInfo?.parameters;
if (params?.risksData) {
this.riskItems = JSON.parse(params.risksData);
}

// 监听主窗口风险数据更新
AppStorage.link('riskItems').onChange((value: RiskItem[]) => {
this.riskItems = value;
});

this.setupFocusListener();
}

private async setupFocusListener(): Promise<void> {
const win = await window.getLastWindow(getContext());
win.on('windowFocusChange', (isFocused: boolean) => {
this.isWindowFocused = isFocused;
});
}

/**
* 按风险等级分组
*/
private getGroupedRisks(): Record<RiskLevel, RiskItem[]> {
const grouped: Record<RiskLevel, RiskItem[]> = {
[RiskLevel.CRITICAL]: [],
[RiskLevel.HIGH]: [],
[RiskLevel.MEDIUM]: [],
[RiskLevel.LOW]: [],
[RiskLevel.NONE]: []
};

this.riskItems.forEach(risk => {
grouped[risk.riskLevel].push(risk);
});

return grouped;
}

/**
* 获取风险等级颜色
*/
private getRiskColor(level: RiskLevel): string {
const colorMap: Record<RiskLevel, string> = {
[RiskLevel.NONE]: '#27AE60',
[RiskLevel.LOW]: '#3498DB',
[RiskLevel.MEDIUM]: '#F39C12',
[RiskLevel.HIGH]: '#E67E22',
[RiskLevel.CRITICAL]: '#E74C3C'
};
return colorMap[level];
}

build() {
Column() {
// 窗口标题栏
Row() {
Circle()
.width(10)
.height(10)
.fill(this.primaryColor)
.shadow({
radius: 6,
color: this.primaryColor + '80'
})

Text('风险清单')
.fontSize(16)
.fontWeight(FontWeight.Bold)
.fontColor('#333333')
.margin({ left: 8 })

Blank()

Text(`${this.riskItems.length}项风险`)
.fontSize(12)
.fontColor('#999999')
}
.width('100%')
.height(48)
.padding({ left: 16, right: 16 })
.backgroundColor('rgba(255, 255, 255, 0.9)')
.borderRadius({ topLeft: 16, topRight: 16 })

// 风险列表
List() {
const grouped = this.getGroupedRisks();
const order: RiskLevel[] = [RiskLevel.CRITICAL, RiskLevel.HIGH, RiskLevel.MEDIUM, RiskLevel.LOW];

ForEach(order, (level: RiskLevel) => {
const risks = grouped[level];
if (risks.length === 0) return;

// 风险等级分组标题
ListItem() {
Row() {
Row()
.width(4)
.height(16)
.backgroundColor(this.getRiskColor(level))
.borderRadius(2)
.margin({ right: 8 })

Text(`${this.getRiskLabel(level)} (${risks.length})`)
.fontSize(13)
.fontWeight(FontWeight.Bold)
.fontColor(this.getRiskColor(level))
}
.width('100%')
.height(36)
.padding({ left: 16, right: 16 })
.backgroundColor(this.getRiskColor(level) + '0D')
}

// 该等级下的风险项
ForEach(risks, (risk: RiskItem) => {
ListItem() {
Column() {
Text(risk.riskType)
.fontSize(14)
.fontWeight(FontWeight.Medium)
.fontColor('#333333')
.maxLines(1)
.textOverflow({ overflow: TextOverflow.Ellipsis })

Text(risk.clauseText.substring(0, 60) + '…')
.fontSize(12)
.fontColor('#666666')
.margin({ top: 4 })
.maxLines(2)
.textOverflow({ overflow: TextOverflow.Ellipsis })

Text(risk.suggestion)
.fontSize(11)
.fontColor(this.getRiskColor(level))
.margin({ top: 6 })
.maxLines(2)
.textOverflow({ overflow: TextOverflow.Ellipsis })
}
.width('100%')
.padding(12)
.backgroundColor(this.selectedRiskId === risk.id ?
this.getRiskColor(level) + '1A' : '#FFFFFF')
.borderRadius(8)
.border({
width: 1,
color: this.selectedRiskId === risk.id ?
this.getRiskColor(level) + '4D' : '#F0F0F0',
radius: 8
})
.onClick(() => {
this.selectedRiskId = risk.id;
// 同步主窗口选中该条款
AppStorage.setOrCreate('selectedRiskId', risk.id);
})
}
})
})
}
.width('100%')
.layoutWeight(1)
.padding(12)
.scrollBar(BarState.Auto)

// 底部统计
Row() {
Text(`总计：${this.riskItems.length}项风险`)
.fontSize(12)
.fontColor('#999999')
}
.width('100%')
.height(40)
.padding({ left: 16, right: 16 })
.justifyContent(FlexAlign.Center)
.borderTop({ width: 0.5, color: '#EEEEEE' })
}
.width('100%')
.height('100%')
.backgroundColor('rgba(255, 255, 255, 0.9)')
.backdropFilter($r('sys.blur.20'))
.borderRadius(16)
.shadow({
radius: 24,
color: 'rgba(0, 0, 0, 0.15)',
offsetX: 0,
offsetY: 8
})
.opacity(this.isWindowFocused ? 1.0 : 0.65)
.animation({
duration: 300,
curve: Curve.EaseInOut
})
}

private getRiskLabel(level: RiskLevel): string {
const labelMap: Record<RiskLevel, string> = {
[RiskLevel.NONE]: '无风险',
[RiskLevel.LOW]: '低风险',
[RiskLevel.MEDIUM]: '中风险',
[RiskLevel.HIGH]: '高风险',
[RiskLevel.CRITICAL]: '极高风险'
};
return labelMap[level];
}
}

5.7 多窗口光效同步管理器（WindowLightSync.ets）

代码亮点：本模块实现了跨窗口光效同步的核心机制。通过监听AppStorage中的光效状态变化，自动向所有浮动窗口广播主题更新。采用emitter模块实现高效的跨Ability事件通信，确保主窗口切换风险等级时，所有浮动窗口在300ms内完成光效同步，营造"一窗变色，全局感知"的沉浸体验。

// entry/src/main/ets/utils/WindowLightSync.ets

import { emitter } from '@kit.BasicServicesKit';

/**
* 光效同步事件定义
*/
export enum LightSyncEvent {
RISK_LEVEL_CHANGED = 'risk_level_changed',
THEME_COLOR_CHANGED = 'theme_color_changed',
AMBIENT_COLOR_CHANGED = 'ambient_color_changed',
WINDOW_FOCUS_CHANGED = 'window_focus_changed'
}

/**
* 窗口光效同步管理器
* 核心：实现主窗口与所有浮动窗口的光效实时同步
*/
export class WindowLightSync {
private static instance: WindowLightSync;
private eventHub: emitter.InnerEvent = {
eventId: 0x0001,
priority: emitter.EventPriority.HIGH
};

private constructor() {
this.initializeEventListener();
}

public static getInstance(): WindowLightSync {
if (!WindowLightSync.instance) {
WindowLightSync.instance = new WindowLightSync();
}
return WindowLightSync.instance;
}

/**
* 初始化全局事件监听
*/
private initializeEventListener(): void {
// 监听风险等级变化
AppStorage.link('riskLevelChanged').onChange((level: string) => {
this.broadcastLightSync(LightSyncEvent.RISK_LEVEL_CHANGED, { riskLevel: level });
});

// 监听主题色变化
AppStorage.link('lightEffectChanged').onChange(() => {
const primaryColor = AppStorage.get<string>('primaryLightColor') || '#27AE60';
const ambientColor = AppStorage.get<string>('ambientLightColor') || '#E8F8F0';

this.broadcastLightSync(LightSyncEvent.THEME_COLOR_CHANGED, {
primaryColor,
ambientColor
});
});
}

/**
* 广播光效同步事件
*/
public broadcastLightSync(event: LightSyncEvent, data: object): void {
const eventData: emitter.EventData = {
data: {
eventType: event,
payload: data,
timestamp: Date.now()
}
};

emitter.emit(this.eventHub, eventData);
console.info(`Broadcast light sync event: ${event}`);
}

/**
* 注册光效同步监听
* @param callback 同步回调
*/
public onLightSync(callback: (event: LightSyncEvent, data: object) => void): void {
emitter.on(this.eventHub, (eventData: emitter.EventData) => {
const { eventType, payload } = eventData.data as { eventType: LightSyncEvent; payload: object };
callback(eventType, payload);
});
}

/**
* 同步所有窗口到指定风险等级
*/
public syncAllWindowsToRisk(riskLevel: string): void {
AppStorage.setOrCreate('riskLevelChanged', riskLevel);
AppStorage.setOrCreate('lightEffectChanged', Date.now());
}

/**
* 同步所有窗口到指定主题色
*/
public syncAllWindowsToTheme(primaryColor: string, ambientColor: string): void {
AppStorage.setOrCreate('primaryLightColor', primaryColor);
AppStorage.setOrCreate('ambientLightColor', ambientColor);
AppStorage.setOrCreate('lightEffectChanged', Date.now());
}
}

// 导出单例
export const windowLightSync = WindowLightSync.getInstance();

六、关键技术总结

6.1 HMAF法律文档审查开发清单

6.2 沉浸光感实现清单

6.3 风险等级光效映射

6.4 PC端多窗口光效协同

七、调试与适配建议

7.1 法律文档解析性能优化

• 大文档处理：超过100页的合同文档建议采用分块解析策略，每50页为一个解析单元，避免单次任务超时
• 增量审查：修改后的文档仅需重新审查变更条款，利用clauseId进行差异比对
• 缓存机制：已解析的条款和风险结果缓存至AppStorage，避免重复计算

7.2 风险光效可访问性

• 色盲适配：除颜色外，风险等级通过脉冲速度（无风险4秒/极高风险1秒）和图标形状（圆形/三角形/菱形）双重编码
• 光敏保护：提供"减少动画"开关，关闭呼吸光效果，仅保留静态颜色标识
• 对比度保证：所有风险色彩组合均满足WCAG 2.1 AA级对比度标准（4.5:1）

7.3 多窗口管理优化

• 窗口生命周期：浮动窗口在失焦5分钟后自动进入休眠状态，释放GPU资源
• 光效同步节流：跨窗口主题同步采用100ms防抖机制，避免频繁切换导致性能抖动
• 子窗口限制：同时打开的浮动窗口不超过4个，超出时最早打开的窗口自动关闭

八、运行效果展示

8.1 文档概览阶段 – 无风险光效

打开一份标准NDA保密协议，文档解析Agent识别为低风险文档。界面呈现安心绿色光效：标题栏边框泛出柔绿光晕，环境背景渲染淡绿渐变，底部导航脉冲缓慢（4秒周期），传递"文档合规、安心签署"的直觉感知。

8.2 条款审查阶段 – 中风险光效

识别到"永久保密义务"条款时，风险研判Agent判定为中风险。界面切换为警示黄色光效：该条款背景呈现暖黄呼吸光（2.5秒周期），波浪下划线标识风险位置，底部导航"风险"页签角标显示"1"，提示法务人员需要关注。

8.3 风险分析阶段 – 高风险光效

发现"违约金十倍赔偿"条款时，风险等级跃升为高风险。界面切换为紧迫橙色光效：脉冲加速至1.8秒周期，风险条款背景透明度增强，左侧出现橙色竖条标识，浮动风险清单窗口自动弹出并定位到该风险项。

8.4 合规报告阶段 – 极高风险光效

当检测到"知识产权完全让渡+自动续约陷阱+不对等管辖"三重风险叠加时，风险等级达到极高风险。界面切换为危险红色光效：急促脉冲（1秒周期）配合顶部警示光条闪烁，所有浮动窗口同步变红，底部导航"风险"页签角标红色高亮显示"3"，强烈提示"拒绝签署或重大修改"。

九、总结与展望

本文基于HarmonyOS 6（API 23）的悬浮导航、沉浸光感与HMAF智能体框架特性，完整实战了一款面向PC端的"律界智脑"AI智能体法律文档智能审查工作台。核心创新点总结：

未来扩展方向：

• 分布式法务协作：通过鸿蒙分布式软总线，实现PC主控审查+平板批注修改+手机法务总监审批的无缝流转，三端光效实时同步
• AR合同空间审查：接入Face AR与Body AR，支持手势圈选条款自动风险分析、眼神聚焦条款自动高亮、语音指令"分析第三条"触发智能体审查
• 实时协作审查：多名法务同时审查同一合同，通过不同颜色光效区分审查者，实时同步批注与风险标记
• 判例知识库融合：接入中国裁判文书网，风险研判Agent自动匹配相似判例，以"幽灵批注"形式在文档旁展示相关判决要点
• 多模态文档支持：支持扫描件OCR识别、手写批注识别、语音批注转文字，构建全模态法律审查体验

转载自：https://blog.csdn.net/u014727709/article/details/161562857 欢迎 👍点赞✍评论⭐收藏，欢迎指正