PACTHub← 返回首页

已有 AI 算法接入指南

项目方的 AI 算法已经完成。这里说明如何把已有成果接入数据集网站，并整理公开发布所需的可复现信息；不要求重新设计或重新实现算法。

1. 先明确展示与可用性

网站应分别说明：

  • 算法解决的任务、适用数据和已知限制。
  • 算法本身的完成状态。
  • 代码、权重、论文、使用文档是否已公开，以及是否需要申请访问。
  • 网站接入状态；“算法已完成”不自动意味着“当前站点可运行算法”。

当前框架没有在线推理后端，也不包含算法源码、模型权重、性能数据或用户数据上传功能。有关资源未提供时保持待接入状态，不能给空链接显示“下载”或“在线运行”。

2. 整理最小公开材料

建议从现有项目提取以下材料，避免另造技术结论：

  1. 算法名称与简短介绍，明确输入信号/体数据和输出内容。
  2. 实际代码仓库、版本标签或精确提交，以及对应论文或技术说明。
  3. 合法可分发的模型权重、对应配置、版本、文件大小和校验值。
  4. 环境说明：操作系统、语言/框架、依赖锁定文件、CPU/GPU 与显存需求。
  5. 已验证的安装和推理步骤，包括输入目录结构、配置和输出路径。
  6. 使用许可证、权重许可、引用方式，以及适用范围和已知失败情形。

材料尚未获得公开授权时可以继续完善本地框架；不要先公开文件再补审批。

3. 与已完成数据标准的对应关系

算法说明应引用现有数据标准及其版本，并核实：

  • 数组轴顺序、坐标系、数据类型、单位和体素间距。
  • 波长、采样率、阵列几何、采集或重建参数中哪些是算法必需输入。
  • 数据标准中的原字段如何映射到网站索引；网站索引不是模型输入文件格式。
  • 重采样、归一化、裁剪、掩膜和缺失值处理的实际步骤。
  • 输出的形状、单位、空间对应关系，以及后处理方式。

如果实际算法不需要某个字段，明确标注不适用；不要为满足页面模板而捏造参数。网站模板字段不足时，应扩展并校验映射层，而不是静默改变已有标准。

4. 可复现验证

用已获准用于复现的真实样例验证一次完整流程，记录实际结果：

  • 数据、代码、权重、配置的版本和校验值。
  • 环境、硬件、随机种子，以及是否存在非确定性算子。
  • 预处理 → 推理/重建 → 后处理的真实命令和顺序。
  • 预期输出名称、格式、维度、单位及可接受误差范围。
  • 若有评估指标，附定义、参考真值、划分、聚合方式和运行条件。
  • 若展示速度、内存或 GPU 开销，附测量口径和硬件条件。

本仓库的 DEMO 是页面测试元数据，不能用于证明算法效果或生成有效科学基准。尚未交付的结果应写“待提供/待核验”，不要用虚构 PSNR、SSIM、准确率或耗时占位。

5. 在网站中接入

  1. 更新 data/site-config.json 的 algorithm.name、algorithm.status、algorithm.repository_url、algorithm.weights_url，保留其他未知字段的 null。仓库和权重链接必须实际核验。
  2. 更新算法介绍页面，使用项目方批准的文字、图表和结果。示意图继续注明其性质。
  3. 用清楚的标签区分“阅读文档”“查看代码”“获取权重”“申请访问”。
  4. 同步更新数据版本、算法版本与引用信息。不要让最新数据默认关联到不兼容的旧权重。
  5. 在空白浏览器会话验证每个链接和访问条件，并按发布清单完成审核。

当前配置提供算法名称、摘要、状态、仓库与权重入口；论文、环境、命令、指标和版本对应关系可先写入此指南的维护版与 HTML 版。若为它们增加结构化配置字段，也需同步页面读取逻辑，不能只添加 JSON 后假定会自动显示。downloads 中的算法资料包入口独立配置，其 url、version、size_label、sha256 也需指向真实发布包。

此框架可在外部提供已验证的代码、权重和文档链接。若以后需要在线推理，应另行设计后端、访问控制、计算资源、隐私处理和服务限制；当前静态站点不会自动获得这些能力。

6. 尚待项目方提供的接入信息

以上是网站接入所需材料清单，不是对研究进度的判断。