Archivesspace中LCNAF插件集成后无法运行显示的技术求助

先明确LCNAF插件的核心作用 #

LCNAF（国会图书馆名称规范文件）插件是给Archivespace补充的工具，核心是在创建/编辑档案相关记录（比如人物、机构、主题）时，自动匹配国会图书馆的权威规范数据，不用手动输入完整规范名称，还能直接关联官方权威数据源，保障档案元数据的规范性。

你需要检查的关键配置 #

1. 完善appconfig.yml的配置项 #

打开config/appconfig.yml文件，除了把lcnaf加入plugins列表，还要补充插件专属配置：

plugins:
  - lcnaf

# LCNAF插件具体配置
lcnaf:
  api_url: "https://id.loc.gov/authorities/names"
  autosuggest: true
  enable_linkout: true

• api_url：LCNAF权威数据的API地址，默认值无需修改；
• autosuggest：开启输入框自动提示功能，必须设为true才能看到插件效果；
• enable_linkout：开启记录详情页的LCNAF链接跳转，方便查看官方权威数据。

注意：修改配置后必须重启Archivespace服务，否则配置不会生效。

2. 验证插件是否成功加载 #

重启服务后，登录Archivespace管理员账号，进入System > Plugins页面：

• 若列表中显示LCNAF插件且状态为“Enabled”，说明加载成功；
• 若看不到插件，检查plugins文件夹结构：插件必须是独立的lcnaf文件夹，内部要有plugin.rb等核心文件，不能将GitHub下载的文件直接散放在plugins根目录。

插件的实际运行操作场景 #

插件正常启用后，在以下场景能看到效果：

• 创建/编辑Agent记录（人物、机构等）：在Name字段输入关键词，输入框下方会自动弹出匹配的LCNAF规范条目，选择后自动填充规范名称、权威URI等信息；
• 编辑Resource/Accession记录：在主题、关联人物字段输入关键词，同样会触发自动提示，选择后直接关联权威数据；
• 查看记录详情页：若开启enable_linkout，关联的LCNAF数据会显示可点击链接，直接跳转至国会图书馆的权威数据页面。

常见问题排查 #

• 无自动提示：检查Archivespace服务器是否能访问LCNAF的API（可能受防火墙限制），或确认autosuggest配置项设为true；
• 插件不加载：确认插件版本与你的Archivespace版本兼容，不同版本的Archivespace对插件API支持不同，需下载对应版本的插件；
• 运行报错：查看logs/archivesspace.out日志文件，里面会记录插件加载或运行时的错误，比如依赖缺失、配置语法错误等。

内容的提问来源于stack exchange，提问作者Karan Vishwakarma