【open harmony/harmonyos】最小权限也能做出完整体验：本地知识星图应用设计

前言 🔐

在 HarmonyOS / OpenHarmony 应用开发中，安全隐私是一个非常重要的主题。

很多应用一上来就申请相机、相册、位置、麦克风、通讯录、网络等权限，但并不是所有功能都真的需要这些权限。

我的项目星图 Xingtu是一个知识星图应用，它的核心体验包括：

• 创建节点
• 管理标签
• 建立节点连接
• 生成关键词星图
• 旋转和缩放 3D 星图
• 查看节点详情

这些能力都可以在本地完成，不需要相机、不需要相册、不需要定位，也不需要把用户内容上传到云端。

这篇文章就从“最小权限设计”的角度，聊聊如何在 HarmonyOS / OpenHarmony 中做一个隐私友好的本地知识图谱应用。✨

一、什么是最小权限原则

最小权限原则可以理解为：

应用只申请完成当前功能所必需的权限。

如果一个知识管理应用只是让用户输入文本、整理节点和查看图谱，那么它不应该默认申请：

• 相机权限
• 相册权限
• 位置权限
• 麦克风权限
• 通讯录权限

权限越少，用户的心理负担越低，应用的可信度也越高。

二、项目中的权限情况

当前星图项目的module.json5主要声明了入口 Ability 和备份 Extension，并没有配置敏感权限。

{"module": {"name":"entry","type":"entry","mainElement":"EntryAbility","deviceTypes": ["phone","tablet"],"abilities": [ {"name":"EntryAbility","srcEntry":"./ets/entryability/EntryAbility.ets","exported": true } ] } }

这意味着应用的核心体验并不依赖敏感权限。

用户打开应用后，可以直接使用星图功能，不会被一堆权限弹窗打断。

三、本地优先的功能设计

星图应用的核心数据是节点和连线：

exportinterfaceXingtuNode{ id:string; title:string; note:string; tags:string[]; position: Vec3; } exportinterfaceXingtuEdge{ id:string; fromId:string; toId:string; }

这些数据天然适合本地处理：

• 节点标题是用户手动输入的文本
• 备注是本地编辑内容
• 标签是用户自己分类
• 连线是用户手动建立的关系
• 3D 坐标是应用本地生成的布局数据

整个过程不需要访问设备隐私资源。

四、不依赖云端也能生成图谱 🧠

项目中的“词图生成”并不是把内容上传到服务器，而是本地解析用户输入。

privateparseWordList(rawWords:string):string[] {constnormalizedItems:string[] = rawWords .split(/[\n,，;；、]+/) .map((item:string) =>item.trim()) .filter((item:string) =>item.length>0);constseen:Set<string> =newSet<string>();constwords:string[] = []; normalizedItems.forEach((item:string) =>{constkey:string= item.toLowerCase();if(!seen.has(key)) { seen.add(key); words.push(item); } });returnwords; }

这段逻辑在本地完成：

• 分隔关键词
• 清理空白
• 去除重复
• 生成节点
• 建立关系

对于很多轻量级知识工具来说，本地规则生成已经足够好用，不一定一开始就需要联网 AI。

五、本地生成节点关系

生成星图时，项目会在本地创建中心节点和环绕节点。

const centerNode: XingtuNode = createNodeAtPosition({title: centerTitle, note: orbitWords.length> 0 ? `${orbitWords.length} 个关联词` :'中心词', tags: normalizedTheme.length> 0 ? ['theme','center'] : ['center'] }, {x: 0, y: 0, z: 40 });

环绕节点的位置也是本地计算：

privatecreateOrbitPosition(index:number,total:number):Vec3 {constgoldenAngle:number=Math.PI* (3-Math.sqrt(5));consttheta:number= goldenAngle * index;constradius:number=180+ (index %3) *34;return{x:Math.cos(theta) * radius,y:0,z:Math.sin(theta) * radius }; }

用户输入一组关键词后，应用可以直接生成可视化图谱，不需要请求远程服务。

这就是本地优先设计带来的好处：响应快、隐私压力小、离线也能使用。

六、权限少不代表体验弱

有些人会误以为：权限越多，能力越强。

但对知识星图这类应用来说，体验的关键不是权限，而是设计和交互：

• 星图是否有空间感
• 节点是否容易管理
• 关系是否清晰
• 输入是否方便
• 操作是否连贯
• 页面是否沉浸

项目中通过 ArkUI 和 UIDesignKit 实现了悬浮导航、玻璃拟态、流光背景、3D 透视投影等效果，这些都不依赖敏感权限。

HdsVisualComponent().width('100%').height('100%').opacity(0.86).scene(xingtuImmersiveSceneType(), this.immersiveLightController)

所以，最小权限不等于低质量体验。相反，它可以让应用更轻、更干净。

七、窗口沉浸不需要隐私权限

应用的沉浸式体验来自窗口和 UI 设置，而不是敏感权限。

constmainWindow:window.Window = windowStage.getMainWindowSync(); mainWindow.setWindowLayoutFullScreen(true); mainWindow.setWindowSystemBarProperties({ statusBarColor:'#00000000', navigationBarColor:'#00000000', statusBarContentColor:'#F4F8FF', navigationBarContentColor:'#F4F8FF', isStatusBarLightIcon:false, isNavigationBarLightIcon:false});

这样就可以让星图背景延展到系统栏区域，形成更完整的沉浸感。

这类能力是界面体验增强，不涉及用户隐私数据。

八、备份能力要明确边界

项目中配置了备份 Extension：

{"allowToBackupRestore":true}

对应 Ability：

exportdefaultclassEntryBackupAbilityextendsBackupExtensionAbility{asynconBackup() { hilog.info(DOMAIN,'testTag','onBackup ok');awaitPromise.resolve(); }asynconRestore(bundleVersion: BundleVersion) { hilog.info(DOMAIN,'testTag','onRestore ok %{public}s',JSON.stringify(bundleVersion));awaitPromise.resolve(); } }

备份恢复属于能力增强，但需要注意边界：

• 只备份应用必要数据
• 不额外采集无关信息
• 日志中不要输出用户隐私内容
• 备份能力要和产品说明保持一致

当前项目中日志只输出生命周期信息，没有打印节点内容，这是比较稳妥的。

九、日志中的隐私意识

项目中使用了hilog输出运行状态。

hilog.info(DOMAIN,'testTag','%{public}s','Ability onCreate');

如果日志中包含用户输入内容，就要特别谨慎。

比如节点标题、备注、标签这些都属于用户内容，不建议随意打印到日志中。

比较推荐的做法是：

• 日志只记录流程状态
• 错误日志避免包含用户原文
• 必须输出时区分 public/private 信息
• 发布版本减少无意义日志

隐私保护不是只有权限申请这一件事，日志同样需要注意。

十、后续如果接入 AI 怎么办

当前项目的生成逻辑是本地规则生成。

如果后续接入 AI，比如：

• 自动扩展关键词
• 自动总结节点
• 从文章生成图谱
• 推荐节点关系

那就需要重新审视隐私设计：

• 是否需要联网
• 是否上传用户输入内容
• 是否提供明确提示
• 是否允许用户关闭 AI
• 是否支持本地处理
• 是否区分敏感内容

也就是说，隐私设计要跟着能力变化一起升级，不能只停留在第一版。

十一、适合写进安全隐私文章的点

这个项目虽然不是专门的安全应用，但仍然可以从这些角度切入：

• 应用不申请敏感权限
• 核心知识图谱功能本地完成
• 关键词解析和节点生成本地完成
• UI 高级体验不依赖隐私资源
• 日志不输出用户节点内容
• 备份能力有明确配置入口

这些点都比较真实，不会显得硬凑。

但是不建议硬写“禁止 AI 识图”或“相册隐私保护”，因为项目目前没有相机、相册或 AI 识图能力。文章最好围绕真实项目能力来写，可信度更高。

十二、总结 🌟

这篇文章从最小权限角度，分析了一个 HarmonyOS / OpenHarmony 本地知识星图应用的隐私友好设计。

核心思路是：

• 能本地完成的功能优先本地完成
• 不需要的敏感权限不要申请
• 用户输入内容不要随意上传或打印
• UI 体验增强不等于权限增加
• 备份能力要明确数据边界
• 后续接入 AI 时重新评估隐私方案

对于很多工具类应用来说，最小权限不是限制，而是一种产品竞争力。

用户打开应用，不被权限弹窗打扰，也不用担心内容被随意读取或上传，这本身就是一种更安心的体验。🔐