资讯详情

PaperSpine5 Web-First Intake 交互式采集实战指南:任务配置、浏览器交接与用户确认边界

📅 2026/10/14 17:33:20 | 华诺云谱 👁 阅读
PaperSpine5 Web-First Intake 交互式采集实战指南:任务配置、浏览器交接与用户确认边界
AI 技能AI 写作人工智能深度研究AI 应用【免费下载链接】PaperSpinePaperSpine5 — local-first, evidence-bound paper research, writing, figures, review and delivery. Download: https://wubing2023.github.io/PaperSpine/v5/项目地址https://gitcode.com/gh_mirrors/pa/PaperSpine点击查看免费下载PaperSpine5 将论文任务配置采集Intake从旧的终端向导迁移到 Web 优先的工作流宿主 Agent 通过公共命令 API 持久化任务事实用户在浏览器中确认配置科学工作始终留在宿主对话内。本文围绕dist/codex/skills/paper-spine/references/interactive-intake.md这一核心参考文档讲解交互式采集的提问顺序、Web 优先流程、浏览器与进度交接、独立 Web 启动器的使用与返回字段解析并结合仓库源码说明底层实现帮助读者掌握在 Codex/Claude 等宿主中正确发起与续跑 PaperSpine5 论文任务的方法。一、interactive-intake 在 PaperSpine5 中的角色PaperSpine5 的任务生命周期从 Intake 开始读取用户请求与已有材料根目录形成一份可编辑的配置草案。interactive-intake.md是宿主 Agent 在需要工作流配置时必读的参考页它回答三个核心问题问什么——只询问已保存配置中缺失的决策而不是重新跑一遍完整问卷在哪问——默认在 Web 工作区中交互终端向导仅是历史迁移参考如何交接——首个可见的交接物是真实的任务页面不是终端回执或打印的 URL。它与 intake.md、intent-configuration.md 共同构成采集阶段的操作手册后者负责从用户首句提取意图生成 proposal而 interactive-intake 负责如何把配置呈现给用户、如何等待确认、如何交接。宿主编排总览见 SKILL.md。二、提问顺序已保存配置优先字段清单只是解释清单文档明确要求先读取同一任务的已保存配置仅在需要输入或变更时才打开当前配置页使用真实公共 schema只询问缺失的决策。下面 11 项历史字段清单是解释已有记录的检查表不是强制问卷。2.1 工作流Workflow使用实际保存的公共值build_from_materials、rewrite_existing、audit、review、revise或transfer并保留用户要求的工作类型。不同工作流对应的实际产出在 product-v1-workflow.md 中有明确界定工作流实际工作与预期结果build_from_materials从授权材料与合理研究构筑论证与手稿rewrite_existing先读既有手稿的论证、证据与可用文字再按目标与学习论文修订audit核对论文声明、数据、引用、图表与文件交付定位到问题的发现与修正review由独立评审人评估当前论文交付真实评审意见revise按真实反馈逐条处理保留未受影响的有效工作transfer对比新目标要求与现有论文适配框架、结构、引用风格与排版2.2 场景Scene与旧字段场景使用当前公共场景 schema按用户实际的目标期刊、会议、报告、评审、竞赛等取值。注意不要提交历史report_review别名。历史intake_wizard.py中的SCENES (journal, conference, report_review, competition)仅用于解释旧记录见 intake_wizard.py当前 schema 的取值以其实际定义为准。2.3 旧层级与文献设置flash/pro这两个旧 tier 只用于解释旧记录flash对应33 篇样例加官方要求的轻量调研pro对应66 篇样例加官方要求的深度调研。当前任务使用已保存的文献学习规模与请求的科学范围不依赖历史 tier 字段。这一点与 intake.md 中tier 只选择调研/样例广度不改变交付物类型的说明一致。2.4 输出语言与格式的新旧字段对照这是交互式采集最容易踩坑的地方输出语言读取configuration.output_language与实际请求的语言含多语言请求不要把当前工作流限制在 en/zh 两值上intent-configuration.md 的映射表中支持output_languagemultilingual中英双语。输出格式使用当前formats包括请求或默认的 DOCX不要提交旧的word_output字段。翻译包使用当前output_language与 formats不要把多语言输出限制为旧的none/zh选项。历史intake_wizard.py中的WORD_OUTPUTS (none, docx)、TRANSLATION_PACKAGES (none, zh)、LANGUAGES (en, zh)仅用于解读旧配置文件intake_wizard.py当前任务一律以公共 schema 为准。2.5 其余字段目标名称期刊、会议、课程、报告类型或竞赛名称草稿路径 / 材料目录rewrite_existing用草稿路径build_from_materials用材料目录用户动机若已知官方 URL若已知特殊要求请求的输出格式见 2.4请求的语言/翻译包见 2.4。从源码结构看intake_wizard.py中的FIELD_ORDERworkflow、scene、tier、output_language、word_output、translation_package、target_name、draft_path、materials_dir、user_motivation、official_urls、reference_mode、reference_paths、citation_target_count、special_requirements、detection_platform、humanize_tier、ui_language正是这套字段的历史完整形态可作为理解旧记录的解释清单intake_wizard.py。三、Web-First Intake把首次采集留在当前宿主内文档规定首次采集的流程必须保持在当前宿主内共三步第 1 步用公共宿主工具开新任务或续跑任务。打开用户识别出的任务及其材料根然后在用户连接的浏览器中打开其工作区。不要在创建任务或打印 URL 后停下——打印 URL 不是交接。任务事实必须通过公共命令 API 持久化严禁伪造integration_job.json或直接编辑任务数据库。第 2 步否则调用已安装的launch_paperspine_ui包装器。它在后台启动同一个公共 Web 服务并用既有 profile 打开浏览器。注意科学工作始终留在宿主对话内——启动 Web 并不会启动另一个写作 Agent。web_launch的输出明确包含scientific_agent_started: false见 paperspine_public_client.py。第 3 步仅用宿主打字提问或聊天来确认精确的作者/目标/图表/贡献信息。这些信息由持久化的任务 issue 呈现答案通过同一认证 Web API 提交绝不创建并行的配置事实源parallel config truth。此外文档给出三条禁止约束防止采集动作失控不要把启动外部终端当作第一个工具动作不要仅仅为了展示采集而请求升级权限escalation不要轮询等待一个独立的窗口。paperspine5_web.py的main()在异常路径中固定输出frontend: current-hosthost 命令或web并恒为terminal_fallback_used: False从实现上保证不会悄悄回退到终端 TUIpaperspine5_web.py。四、浏览器与进度交接首个可见交接物是任务页4.1 打开正确的任务 URL创建/续跑任务后使用返回的 origin 加上skill_bridge.web_path或/?task_idsame-task-id在同一个浏览器中打开并验证三件事标题、材料/配置卡片、当前阶段。若浏览器控制可用打开该确切 URL 并检查渲染出的页面若不可用提供确切任务 URL并如实说明该页面未被打开。关键约束服务只启动一次只打开一个选定的浏览器——不要既打开默认浏览器首页又打开应用内任务标签页后台服务器本身不是交接物主页、过期任务、空白页或打印的 URL 都不算配置交接SKILL.md。4.2 里程碑与等待当科学进展或下一个用户动作发生变化时通过公共任务 API 提交一条简短的事实性里程碑milestone携带实际有用的 artifact ID。命令结果已经包含更新后的投影projection直接使用它不要立即再次抓取完整任务。其他要点交接用户输入或诊断显示问题时检查实际页面进度未变时不重复提交里程碑有用的研究笔记或草稿输出通过发布文件使其可见——阶段标签本身不暴露内容等待用户时让任务停留在该阶段使用paperspine_wait_for_task_change不要从过期的 shell 快照继续也不要静默推进多个阶段。在 CLI 层面对应的命令是python scripts/paperspine5_web.py host wait --profile-root same-profile --task-id same-task-id --after-version observed-task-versionhost wait每次公共 API 等待最多 50 秒--wait-seconds默认 50范围 1–50普通changedfalse回复会在进程内继续真正的变化发生时命令以原始 API 结果退出product-v1-workflow.md。4.3 工作台进度与实际工作对齐在进入下一工作段之前宿主必须确认上一段落的真实结果已到达同一任务的工作台读取当前快照 → 发布应可见的交付物 → 调用paperspine_commit_milestone记录事实性摘要、合适的既有阶段与实际 artifact ID → 回读同一任务的 stage、里程碑摘要、可见文件与待决选择。里程碑记录的是进度不是科学批准。五、独立 Web 启动器Standalone Web Launcher当宿主没有 Product Kernel 工具时使用已安装的启动器作为通往同一 Web 工作区的薄适配器。它不会启动历史终端向导并且在无法提供 Web 时必须清晰失败而不是假装 TUI 就是 Web。5.1 WindowsPowerShell调用方式$launcher ( $env:USERPROFILE\.codex\skills\paper-spine\scripts\launch_paperspine_ui.ps1, $env:USERPROFILE\.claude\skills\paper-spine\scripts\launch_paperspine_ui.ps1, $env:USERPROFILE\AppData\Local\hermes\skills\academic-writing\paper-spine\scripts\launch_paperspine_ui.ps1 ) | Where-Object { Test-Path $_ } | Select-Object -First 1 powershell.exe -NoProfile -ExecutionPolicy Bypass -File $launcher该脚本依次解析PAPERSPINE5_PYTHON环境变量、Skill 内捆绑的 vendor 运行时runtime_vendor\windows-py312\python.exe、系统python与py -3找不到可用解释器时明确报错launch_paperspine_ui.ps1。注意脚本仅接受-ProfileRoot走公共 Web若用户传了-OutputDir而未用-LegacyRunner会直接报错没有移动任何任务launch_paperspine_ui.ps1。5.2 macOS / Linux 调用方式LAUNCHER$HOME/.codex/skills/paper-spine/scripts/launch_paperspine_ui.sh [ -f $LAUNCHER ] || LAUNCHER$HOME/.claude/skills/paper-spine/scripts/launch_paperspine_ui.sh chmod x $LAUNCHER $LAUNCHERShell 版本定位到同目录的paperspine5_web.py依次探测python3与python最终以python -B paperspine5_web.py launch [--profile-root ...]执行-h|--help只打印帮助绝不启动或复用 Web 进程、绝不写文件launch_paperspine_ui.sh。5.3 返回字段解析公共启动器返回真实值address、process_id、binding、profile_root、reused与scientific_agent_startedfalse。字段语义如下字段含义address本机回环服务地址token 绑定process_id服务进程 IDbinding项目根、用户数据根、核心根、事件数据库、契约根等绑定信息profile_root当前使用的本地 profile 目录reused是否复用了已存活的服务器进程scientific_agent_started恒为false——启动 Web 不等于启动科研 AgentREADY只表示同一服务已响应不表示研究已运行。这是文档强调的核心语义区分。runtime_code_statuschanged表示代码在该属主服务加载之后被替换需要用同一 profile 在特定服务重启后继续没有代码指纹fingerprint的旧回执属于unverified不能作为当前加载字节的证据。web_status命令的状态机进一步印证READY就绪且绑定匹配、DIFFERENT_RUNTIME就绪但绑定不匹配、STALE_CODE就绪但代码已变化、UNCONFIRMED、STOPPEDruntime_code_status通过对比启动时记录的runtime_code.sha256与当前第一方代码/契约文件的哈希指纹得出current/changed/unverifiedpaperspine_public_client.py。5.4 旧回执与数据根语义只有显式的 legacy 启动器才返回paperspine5.web-workspace-receipt其中包含本地 URL、PID、用户数据根、构建标识、frontendweb与terminal_frontendfalse。该契约名对应源码中的READY_CONTRACT paperspine5.web-workspace-receiptpaperspine5_web.py。刷新页面复用标签页作用域的会话重复启动复用健康工作区而非创建并行状态。数据根方面需特别注意reused与server_reused描述的是存活的服务器进程output_root_preexisting与output_root_had_entries分别报告所选数据根在启动前是否已存在、是否已包含用户文件绝不要从reusedfalse推断数据根是空的/新建的。从源码看_output_root_facts()在数据根不存在时返回两个false在存在但为空时返回output_root_preexistingtrue, output_root_had_entriesfalse两者含义被明确分离paperspine5_web.py。5.5 帮助路径的零副作用保证PowerShell 的-?、-h、-help、--help与 Shell 的-h/--help是零启动帮助路径它们不得创建输出根、打开浏览器或启动/复用服务器。launch_paperspine_ui.ps1在帮助分支直接exit 0Shell 版同样提前退出。六、用户确认边界User Confirmation Boundary交互式采集的最后一个支柱是确认边界只询问当前持久化 issue 所代表的精确问题在需要用户授权时等待不要要求用户粘贴或手写配置骨架、学术 JSON 契约持久化的 JSON 或 Product Kernel 任务记录是后续阶段的事实来源source of truth。这一边界与 interaction-policy.md 的授权模型一致宿主在已保存配置范围内选择工具、写作结构、执行顺序与常规本地修复引导式贡献/动机/图表选择仍等待真实用户显式授权只允许实际被委托的决策类别作者身份、伦理、许可、费用与外部提交永远是人工闸门。七、源码佐证与可验证路径上文涉及的实现与测试均可直接在仓库中复核src/scripts/paperspine5_web.py——公共 Web 启动器/状态/API/host 命令入口定义paperspine5.web-workspace-receipt契约src/scripts/paperspine_public_client.py——web_launch/web_status/_runtime_code_status实现输出scientific_agent_startedfalse与代码指纹状态src/scripts/launch_paperspine_ui.ps1 与 src/scripts/launch_paperspine_ui.sh——宿主侧薄包装器src/scripts/intake_wizard.py——历史终端向导仅用于迁移与开发者诊断不是受支持的用户前端intake.mdsrc/skill/references/intake.md——Intake 阶段 playbook 与 legacy 配置字段表src/skill/references/intent-configuration.md——首句意图到配置草案的映射表含multilingual等当前取值dist/codex/skills/paper-spine/references/product-v1-workflow.md——公共宿主工作流、CLI 入口与同任务调用细节tests/test_cross_platform_and_ui.py——跨平台启动器与launch --no-open行为测试tests/test_suite_hardening.py——断言scripts/paperspine5_web.py launch与--no-open出现在文档中的加固测试。八、适用前提与限制本文描述的工作流以当前仓库dist/codex/skills/paper-spine/references/interactive-intake.md及其配套源码为准并有以下适用前提交互式采集面向论文生产paper production只读的解释、审计或计划类请求以请求结果收尾不需要启动配置流程SKILL.md默认路径要求宿主已安装 paper-spine Skill 且paperspine5_web.py可被定位开发源码运行时需要显式提供 project/user-data/core/events 绑定旧字段word_output、translation_packagenone|zh、scenereport_review、tierflash|pro只用于解读历史记录新任务必须遵循当前公共 schemaWeb 不可用时仅在已保存配置范围内允许独立本地修正依赖待决配置/材料/图表决策的新研究或写作必须等待。遵循已保存配置优先、只问缺失决策、Web 保存即确认、任务记录即事实来源这四条原则宿主 Agent 就能在 Codex、Claude 等环境中正确完成 PaperSpine5 的交互式采集并把后续科研工作安全地留在同一任务与同一对话中。赞分享AI 技能AI 写作人工智能深度研究AI 应用【免费下载链接】PaperSpinePaperSpine5 — local-first, evidence-bound paper research, writing, figures, review and delivery. Download: https://wubing2023.github.io/PaperSpine/v5/项目地址https://gitcode.com/gh_mirrors/pa/PaperSpine点击查看免费下载相关推荐PaperSpine5 交互式任务采集Interactive Intake实战指南Web 优先的论文工作流配置与交接PaperSpine5 交互式任务采集Interactive Intake实战指南Web 优先的论文工作流配置与交接 导读 本文围绕 PaperSpineAI 技能AI 写作人工智能深度研究AI 应用PaperSpine 交互式信息采集Interactive Intake实战指南Web-First 配置提问、任务交接与独立 Web 启动器PaperSpine 交互式信息采集Interactive Intake实战指南Web First 配置提问、任务交接与独立 Web 启动器 导读 本文面AI 技能AI 写作人工智能深度研究AI 应用PaperSpine5 交互式任务信息采集Interactive Intake实战指南从问题顺序到 Web 交接PaperSpine5 交互式任务信息采集Interactive Intake实战指南从问题顺序到 Web 交接 本篇技术指南聚焦 PaperSpine5AI 技能AI 写作人工智能深度研究AI 应用创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
📝

华诺云谱内容团队

资深建站顾问 · 行业研究员

10年+企业数字化服务经验,专注智能建站、SEO优化与品牌营销,持续输出建站技巧、行业洞察与营销干货,已帮助5000+企业实现数字化增长。

你可能需要的服务

订阅华诺云谱资讯周报

每周一封,精选建站技巧、SEO与营销干货,直达邮箱。已有 8,000+ 企业主订阅,助你少走弯路。

↑