学术论文写作套件ai4paper/ipaper

IPaper

IPaper 是面向 DeepSeek Harness (DSH) 的学术论文写作产品套件。可发布的包是 @ai4paper/dsh-ipaper；它拥有产品预设和品牌标识，同时精确复用 @isomoes/dsh-web-ui@0.5.1 作为外部共享浏览器依赖，并复用 @ai4paper/apaper-plugin@0.2.3 作为其 profile 根目录下的学术工具包。

安装、运行和更新

这三个包都必须是同一个 DSH profile 的直接依赖，因为浏览器模块和 agent 预设扩展都从 profile 根目录解析：

DSH_HOME="$HOME/.ipaper" dsh plugin --profile ipaper add @ai4paper/dsh-ipaper @isomoes/dsh-web-ui@0.5.1 @ai4paper/apaper-plugin@0.2.3 --registry=https://registry.npmjs.org
DSH_HOME="$HOME/.ipaper" dsh --profile ipaper

只有 @ai4paper/dsh-ipaper 属于 dsh.profile.bundles；Web UI 和 APaper 仍为直接普通依赖。要更新或移除：

DSH_HOME="$HOME/.ipaper" dsh plugin --profile ipaper add @ai4paper/dsh-ipaper@latest @isomoes/dsh-web-ui@0.5.1 @ai4paper/apaper-plugin@0.2.3 --registry=https://registry.npmjs.org
DSH_HOME="$HOME/.ipaper" dsh plugin --profile ipaper remove @ai4paper/dsh-ipaper @isomoes/dsh-web-ui @ai4paper/apaper-plugin

更新后重启 DSH 并刷新现有浏览器页面。

开发与验证

需要 Node ^22.19.0 || >=24.0.0、pnpm 11.7.0，以及已配置的 DSH 模型提供方。

pnpm install --frozen-lockfile
pnpm typecheck
pnpm build
pnpm test
pnpm pack:check
pnpm dev
pnpm dev:config

pnpm dev 会构建 IPaper，并将全部三个直接 profile 依赖链接到此工作区已安装的依赖图中，然后在 DSH 旁边运行 IPaper 品牌监视器。将 Web UI 和 APaper 与实时 IPaper 检出一起链接，可防止重复的 profile 根目录 DSH 运行时拆分私有服务符号，同时重建后的宿主、预设和浏览器产物仍可立即生效。pnpm dev:remove 会移除全部三个包。构建过程通过依赖的公共 ./web/* 导出复制预构建 shell，应用本地拥有的 IPaper 元数据，并且不包含也不重建共享 Web UI 源码。

内置预设
ipaper 是产品支持的内置智能体预设。它是只读的、系统信任的，并且是新会话的默认预设。该预设包含 IPaper 的 find-the-problem 技能，并激活 APaper，提供其 writing 和 creating-figures 技能以及 apaper-mcp 文献研究工具，同时保留作者意图，并禁止伪造引用、引文、书目元数据、数据和结果。用户可以从编辑器中选取 /find-the-problem，或在 Paper 状态中按下 Start guided workflow，以启动实时搜索、候选清单、边界映射、验证和三重门决策流程。在 Agent presets 中，用户可以将 ipaper 复制到其可写的配置文件预设目录，自定义所复制组合的内容和元数据，并在后续会话中选择它。通用和代码智能体预设根目录仍被排除在外。

架构与扩展

Cordis 补丁组合了产品中立的 DSH 主机/会话/传输服务、完整的共享浏览器名册、IPaper 的品牌和论文状态客户端，以及学术预设。它还在版本化的 ipaper_project DSH 存储域上挂载了一个由主机拥有的 paperProjects 服务。该服务负责工作区/会话解析、按工作区串行化、确定性图 ID、乐观节点版本、可恢复的多记录提交，以及已提交的读取快照。一个只读的可信 RPC 提供了一个工作区范围的 Paper status 主界面，其中包含以溯源为先的 Find a question 边界映射，以及动态的框架、研究、论证、产出和验证信号——绝不提供伪造的全局完成百分比。问题映射将每个研究问题与处理该问题的论文、作者、方法、贡献和局限性连接起来，将不受支持的空白保持为待验证状态，并按兴趣、新颖性和可行性比较候选方向。左侧边栏中的一个按钮——或 Mod+Shift+P——可在原位置切换该界面以替代对话，再次调用时返回聊天。ipaper 预设恰好公开两个图工具——ipaper_record 和 ipaper_state——并将其溯源和检查点协议作为作用域限定的系统提示部分注入。共享 shell 使用 DSH 注入的 window.__DSH_BOOT__，并且不是独立的 Vite 应用。
扩展保持为独立的 profile-root 包，而不是 IPaper 的分支。在扩展中定义宿主服务和 Remote/Typert 契约，在 typert-loader.config.packages 中注册所需的契约包，并发布 dsh.client 条目，这些条目注入已文档化的共享 Web UI 客户端，并占用共享的对话、编辑器、引用或设置槽位。在后续的 profile 补丁中，将宿主行添加在依赖的浏览器行之前，并使用唯一 ID 和显式排序。引用提供程序应使用 DSH 引用契约；引文提供程序应将检索/验证保留在类型化宿主服务中；编辑器集成应通过显式保存服务保留作者文件。在隔离的 profile 中使用未修改的 IPaper 包验证解析、Typert 注册、服务可用性和槽位排序。

可发布的包 README 包含完整的扩展配方和包特定的运行时细节。

历史说明

在此次迁移之前，IPaper 是一个独立的 Bun/Hono/React 19/Claude Agent SDK 聊天原型。该运行时已被移除；仓库历史保留它以供考古。

许可证

MIT