PaperSpine UI 是 PaperSpine 的外部终端配置界面，属于内部 /paperspine 步骤，用于在 Codex 和 Claude Code 中交互式配置 PaperSpine。
用途 当 paper_spine_config.json 缺失、不完整，或用户要求交互式配置 PaperSpine 时，使用该分支。在 Claude Code 中，当配置缺失时，/paperspine 必须自动调用该分支。在 Codex 中，启动该窗口会打开可见的 GUI/终端，Codex 将其视为升级操作，需以 sandbox_permissions: require_escalated 请求，否则窗口可能无法可靠出现。配置缺失时应将启动 UI 作为第一动作，不要从材料中推断配置。
主要能力 该 UI 通过已安装的 launch_paperspine_ui.ps1 启动真实终端窗口。它提供全屏终端 UI：居中欢迎屏、白色 ridge 字标、可读的字段/选项面板，以及稳定的 30% 字段列表加 70% 详情面板。右侧面板只显示当前活动字段的推理和值详情，不会把冗长的 JSON 式清单倾倒到聊天中。UI 会写入 paper_rewriting_output/paper_spine_config.json 和 paper_rewriting_output/paper_spine_config.md。
使用方式 需将已安装启动器的绝对路径传给启动器。Codex/Claude 从用户项目文件夹运行，那里不存在 scripts/，因此相对路径是 UI 窗口无法打开的最常见原因。解析安装目录的示例命令如下： $launcher = @( "$env:USERPROFILE.codex\skills\paper-spine-ui\scripts\launch_paperspine_ui.ps1", "$env:USERPROFILE.claude\skills\paper-spine-ui\scripts\launch_paperspine_ui.ps1", "$env:USERPROFILE.codex\skills\paper-spine-intake\scripts\launch_paperspine_ui.ps1", "$env:USERPROFILE.claude\skills\paper-spine-intake\scripts\launch_paperspine_ui.ps1" ) | Where-Object { Test-Path $_ } | Select-Object -First 1 powershell.exe -NoProfile -ExecutionPolicy Bypass -File $launcher -OutputDir paper_rewriting_output
操作方式：使用 Up/Down 进行字段导航，Left/Right 用于选择字段，Enter 用于文本/列表编辑，S 保存，Q 退出。
适用场景 适用于需要交互式配置 PaperSpine 的场景，尤其是配置缺失或不完整时。当存在真实 Windows 终端时，提供全屏终端 UI。
限制 如果未出现单独窗口（无头或沙箱化 Codex 且无交互桌面），可添加 -InPlace 在当前终端运行向导；如果 stdin 仍不可交互，则回退到编号菜单或原生问题。绝不要静默跳过配置。仅当箭头键 UI 不可用时，才回退到编号终端菜单；仅当终端执行不可能时，才使用聊天问题。绝不要让用户手动编写 JSON。问题顺序和回退模板参见 references/interactive-intake.md。