如何解决OneMore插件在ARM架构下Table of Contents功能异常问题

OneMore是一款强大的OneNote插件，提供了许多实用功能，其中Table of Contents（目录）功能能够帮助用户快速生成和管理笔记的结构。然而，在ARM架构设备上，部分用户可能会遇到该功能异常的问题。本文将详细分析可能的原因并提供解决方案。

功能概述：OneMore的Table of Contents

OneMore的Table of Contents功能允许用户在OneNote中自动生成文档目录，支持多种自定义选项。通过InsertTocCommand类（OneMore/Commands/Snippets/InsertTocCommand.cs）实现，用户可以通过对话框设置目录级别、样式和位置等参数。

 图：OneMore的命令面板界面，可访问Table of Contents功能

ARM架构下的常见异常表现

在ARM架构设备上使用Table of Contents功能时，可能会遇到以下问题：

• 目录生成后无法正确显示层级结构
• 刷新目录时程序无响应或崩溃
• 目录中的链接无法跳转至对应章节
• 对话框选项显示异常或无法交互

这些问题主要与ARM架构下的兼容性处理有关，特别是在资源加载和UI渲染方面。

异常原因分析

1. 架构相关代码处理

OneMore在多个文件中涉及架构检测，例如CheckBitnessAction.cs中：

if (osarc == Architecture.Arm64)
{
    // ARM64架构下的特殊处理逻辑
    return (onearc == Architecture.Arm64 && urarc == Architecture.Arm64)
        || (onearc == Architecture.X64 && urarc == Architecture.X64);
}

如果Table of Contents功能未正确处理ARM64架构的特殊情况，可能导致功能异常。

2. 目录生成逻辑

PageTocGenerator类（OneMore/Commands/Snippets/TocGenerators/PageTocGenerator.cs）负责实际的目录生成工作。在ARM设备上，可能存在以下问题：

• 表格宽度计算错误（MinToCWidth常量处理）
• 线程安全问题导致的UI渲染异常
• 资源文件加载路径错误

3. 资源文件处理

在ARM架构下，资源文件的加载可能存在路径或格式问题。例如在Resources.Designer.cs中：

///   Looks up a localized string similar to Table of Contents.
internal static string InsertTocCommand_TOC {
    get {
        return ResourceManager.GetString("InsertTocCommand_TOC", resourceCulture);
    }
}

如果资源文件未正确编译或加载，会导致目录功能相关的文本和图标无法正常显示。

解决方案与修复步骤

1. 确保使用最新版本

OneMore团队持续改进ARM架构支持，通过以下命令获取最新代码：

git clone https://gitcode.com/gh_mirrors/on/OneMore
cd OneMore

2. 手动调整目录生成参数

如果目录显示异常，可以尝试修改目录生成参数：

1. 在OneNote中打开需要生成目录的页面
2. 启动OneMore命令面板（默认快捷键Ctrl+Shift+P）
3. 选择"Table of Contents"命令
4. 在弹出的对话框中（InsertTocDialog.cs）调整以下参数：
   • 减少目录层级（Levels）
   • 更改目录位置（Location）
   • 取消勾选"Right-align page numbers"选项

 图：Table of Contents设置对话框

3. 运行诊断工具

OneMore提供了诊断工具，可以帮助识别问题：

1. 打开OneMore设置
2. 导航至"Tools"选项卡
3. 点击"Run Diagnostics"按钮
4. 查看生成的日志文件（可在SessionLogger.cs中找到日志配置）

4. 手动编译适配ARM架构

如果上述方法无效，可以尝试手动编译针对ARM架构的版本：

msbuild OneMore.sln /p:Platform=ARM64 /p:Configuration=Release

预防未来问题

为避免Table of Contents功能在ARM架构下出现异常，建议：

1. 定期更新OneMore至最新版本
2. 在修改笔记结构后使用"Refresh TOC"功能更新目录
3. 避免在目录中使用过于复杂的格式或特殊字符
4. 如遇问题，可通过[docs/developers/Debugging OneMore.htm](https://gitcode.com/gh_mirrors/on/OneMore/blob/27d5f5c3b1b1d3842d1be52e4c919daca0748af8/docs/developers/Debugging OneMore.htm?utm_source=gitcode_repo_files)提供的方法收集调试信息

总结

OneMore的Table of Contents功能在ARM架构下的异常通常与架构兼容性、资源加载或参数设置有关。通过更新软件、调整生成参数或手动编译适配版本，大多数问题都可以得到解决。如果遇到复杂问题，建议查阅官方文档或提交issue获取帮助。

图：OneMore插件功能概览