elio040208/paper2agent-dsh

paper2agent-dsh

License: MIT
DeepSeek Harness

将研究论文和源代码仓库转换为可安装的、原生的 Cordis 包，用于 DeepSeek Harness。

paper2agent-dsh 会清点研究输入、检查源代码、检测运行时、提出可调用的能力，并生成一个带有原生 ctx.tools 注册的 DeepSeek Harness 插件包。该流水线本身由 17 个小型 Cordis 插件组成，因此每个阶段都可以独立替换或配置。

中文简介：将科研论文和代码仓库分析、整理并生成为可直接安装到 DeepSeek Harness 的 Cordis 插件包。

为什么使用它？

- 将研究仓库转换为模型可调用的 DeepSeek Harness 工具。
- 将科学计算保留在原始仓库中，而不是重新实现算法。
- 检测 Node.js、Python、R、Rust 和 Go 项目。
- 发现导出的函数和类作为候选能力。
- 生成包元数据、Cordis 配置、运行时适配器和工具注册。
- 在安装前验证生成的包。
- 通过专用的状态服务检查工作流进度和失败情况。

安装

将带标签的公共仓库安装到 Web 配置文件中：

dsh plugin --profile web add github:elio040208/paper2agent-dsh#v0.2.0

或者在开发时安装本地检出：

git clone https://github.com/elio040208/paper2agent-dsh.git
cd paper2agent-dsh
dsh plugin --profile web add .

确认该包已组合完成：

dsh --profile web --dump-config

面向模型的工具

| 工具 | 用途 |
| --- | --- |
| paper2agent_inspect | 清点输入、扫描仓库、检测运行时并提出能力建议。 |
| paper2agent_generate | 根据经过审查的、由命令支持的能力生成原生 Cordis 包。 |
| paper2agent_verify | 验证生成的文件和包声明。 |
| paper2agent_status | 检查单个工作流运行，或列出当前进程中的所有运行。 |

安装后的示例请求：

Inspect /absolute/path/to/research-repository and propose native Cordis tools.
Show me the command bindings for review before generating the bundle.

生成过程刻意设置了审查关卡：在 paper2agent_generate 写入输出项目之前，每个提出的能力都必须获得具体的命令绑定。

架构

该包挂载以下单一用途的 Cordis 插件：

| 领域 | 插件 |
| --- | --- |
| 输入 | 源输入、论文提取、资产索引 |
| 审查 | 论文审查、仓库扫描、运行时检测、能力设计 |
| 生成 | 运行时生成器、工具生成器、清单生成器、包生成器 |
| 质量 | 包验证器、产物打包器 |
| 协调 | 工作流状态、编排器、模型工具 API、系统指导 |
完整组合参见 cordis.patch.yml。

生成的工具接受来自模型的 JSON 对象，将其通过标准输入传递给经过审查的命令，观察 Harness 取消，并返回捕获的标准输出、标准错误和退出码。

要求

- DeepSeek Harness
- Node.js 22.19 或更高版本
- pnpm，dsh plugin 所需
- 提取 PDF 文件时需要 pdftotext
- 被转换的研究仓库所需的语言运行时

当前范围

- 仓库扫描可识别常见的顶层函数和类声明。它不会从任意源代码中推断出完整的输入模式。
- 生成的能力需要显式的命令绑定。生成器会拒绝未解析的绑定。
- 科学正确性仍需要在代表性输入上运行原始代码并审查其输出。
- 论文提取目前通过 pdftotext 支持 Markdown、纯文本和 PDF。

开发

npm test
npm run pack:check

测试套件涵盖仓库检查、运行时检测、能力发现、包生成以及生成包的验证。

许可证

MIT