mcpField
P
paper-spine-ui

paper-spine-ui

github.com/wubing2023Agent 工作流6.1k204 次安装2 周前更新
代码仓库

关于 paper-spine-ui

paper-spine-ui 是 PaperSpine 的交互式配置技能，适用于配置缺失或用户要求交互设置的情况。它会启动终端向导；若无法使用交互终端，则改用编号菜单或聊天提问。

主要功能

  1. 01启动交互式配置向导
  2. 02在终端界面编辑字段和选项
  3. 03保存 PaperSpine 配置文件
  4. 04回退到编号菜单或聊天提问

适用场景

  1. 01配置缺失时设置 PaperSpine
  2. 02通过交互式终端完成 PaperSpine 设置
  3. 03无法使用图形终端时配置 PaperSpine

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/wubing2023/paperspine --skill paper-spine-ui

安装后在 Claude Code 中输入/paper-spine-ui确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
interactive-intake.md
scripts/
_paper_spine_utils.py
humanize_check.py
intake_wizard.py
launch_paperspine_ui.ps1
launch_paperspine_ui.sh

详细介绍

PaperSpine UI

当 paper_spine_config.json 缺失、不完整，或用户要求交互式配置 PaperSpine 时，使用此分支。

必需行为

支持的交互方式是启动一个真实的终端窗口，启动程序为已安装的 launch_paperspine_ui.ps1（在 ~/.codex/skills/... 或 ~/.claude/skills/... 下解析其绝对路径）。当宿主无法提供 stdin 时，不要在隐藏的工具界面中运行基于 input() 的 Python。

在 Claude Code 中，如果配置缺失，/paperspine 必须自动调用此分支。

在 Codex 中，启动此窗口会打开一个可见的 GUI/终端，Codex 会将其视为需要提升权限的操作——使用 sandbox_permissions: require_escalated 请求启动，否则窗口可能无法可靠显示。配置缺失时，将启动 UI 作为首要操作；不要根据材料推断配置。

# Pass the ABSOLUTE path to the installed launcher. Codex/Claude run from the
# user's project folder, where `scripts/` does not exist, so a relative path is
# the most common reason the UI window never opens. Resolve the install dir:
$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

如果未显示单独的窗口（无头环境，或没有交互式桌面的沙盒 Codex），则添加 -InPlace，在当前终端中运行向导；如果 stdin 仍不可交互，则改用编号菜单或原生提问。绝不要静默跳过配置。

UI 会写入：

paper_rewriting_output/paper_spine_config.json
paper_rewriting_output/paper_spine_config.md

UI 契约

  • 尽可能打开一个单独的交互式终端窗口。
  • 有可用的真实 Windows 终端时，提供全屏终端 UI：居中的欢迎界面、白色 ridge 字标、清晰易读的字段/选项面板，以及稳定的 30% 字段列表和 70% 详情面板。
  • 使用 Up/Down 导航字段，使用 Left/Right 选择选项字段，使用 Enter 编辑文本/列表，使用 S 保存，使用 Q 退出。
  • 右侧面板只显示一个当前活动字段的推理过程和数值详情；不要在聊天中输出冗长的类 JSON 检查清单。
  • 仅当无法使用方向键 UI 时，才回退到编号终端菜单。
  • 仅当无法执行终端操作时，才通过聊天提问。
  • 绝不要要求用户手动编写 JSON。

阅读 references/interactive-intake.md，了解问题顺序和回退模板。

评论

支持 Markdown