GUIDE
平台使用指南
原型环境各服务的开通与使用流程。全部指南随正式环境建设持续完善。
一、账户注册与额度
平台原型阶段不单独建设账户系统，统一使用 Token 智能网关的账户体系：注册一次即可获得 API 密钥分发、余额与用量统计能力；交互计算与数据工作台的账户在试点期内独立开通。
- 访问 Token 智能网关，使用邮箱注册账号；
- 管理员审核通过后，在「控制台 → API 令牌」创建密钥（
sk- 前缀）；
- 在「用量」页查看输入 / 输出 / 缓存分类的 Token 用量与余额；
- 课题组免费交互额度（每月 200 核时）与体验积分由管理员按批次核配。
体验积分仅限指定国产模型渠道使用，按批次有效期择优消耗；免费额度按自然月重置，超额可通过课题组负责人申请扩容。
二、Token 智能网关接入
网关提供 OpenAI 兼容接口，科研工具与分析脚本只需将接入点与密钥替换即可：
# OpenAI 兼容接口（以 GLM 渠道为例）
curl https://tk.huang.zj.cn/v1/chat/completions \
-H "Authorization: Bearer sk-你的平台密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "glm-4.6",
"messages": [{"role": "user", "content": "hello"}]
}'
- 渠道调度：按模型名路由渠道组，组内按优先级与健康度选择，同一会话粘性路由；
- 计量：按输入（未命中 / 缓存命中）与输出分别计量，日终折算积分扣减；
- 限流：默认用户级并发 5，账号级按上游配额单独设置。
三、交互计算环境（JupyterHub）
- 从门户服务列表进入「交互计算环境」；
- 试点账户由管理员开通（首次登录使用初始口令并立即修改）；
- 登录后自动启动个人会话（约 1.5 核 / 640MB 内存限额），内置 Python 科学计算与 Scanpy 单细胞环境；
- 工作文件保存在个人目录，会话回收后再次登录可继续；
- 会话空闲 30 分钟自动回收释放资源，不影响已保存文件。
试点期会话限额开放，正式硬件到位后将按建设方案提供 24 个 CPU 并发位与免费 GPU 会话位，并接入 Slurm 队列与抢占机制。
四、电子实验记录本（ELN）
- 访问 eln.huang.zj.cn 登录（账号由课题组负责人 / 管理员开通）；
- 按模板创建实验记录，支持公式编辑、表格组件、附件与仪器/样品关联；
- 完成态记录经批注审阅后归档锁定，可申请解锁或由项目负责人直接解锁（全程留痕）；
- 支持 PDF / Word / CSV 导出（带修订版本与页码）与交互式统计图表。
完整文档见 ELN 文档中心（含四角色使用指南视频与系统手册）。
五、数据工作台
- 从门户进入「生物信息数据工作台」；
- 按关键词、数据类别（转录组 / 单细胞 / 空间转录组 / 表观组等）检索数据集；
- 查看数据集详情：样本信息、参考基因组、版本历史、引用格式与关联项目编码；
- 课题组数据发布：通过平台管理员登记（数据文件保留在项目存储区，记录册保存标识与校验值）。
数据工作台当前为登记与检索原型；正式环境迁移至 InvenioRDM，提供 DOI 注册、受控发布与公开下载能力。
六、生信分析流程
- 流程引擎：Nextflow（已部署演示流水线），目标态随 Slurm 集群以 Apptainer 容器运行；
- 标准流程：nf-core 流程集（RNA-seq、ChIP/ATAC-seq、变异、甲基化等）按需迁移；
- 分析模板：RNA 样品表质控、单细胞方法试算与培训复现三类首批场景以 Notebook 模板维护；
- 版本固定：软件版本、参数与日志自动进入流程报告，关联项目编码与样品标识。
七、常见问题
| 问题 | 说明 |
|---|
| 如何获得交互计算账号？ | 试点期联系平台管理员开通；正式环境将接入统一账户平台实现单点登录。 |
| 模型渠道如何选择？ | 默认通用渠道（GLM / Kimi），涉敏数据仅使用本地渠道（推理池交付后开放）。 |
| 会话被回收后文件还在吗？ | 在。个人目录持久保存，回收仅释放计算资源，重新登录即可继续。 |
| 额度用完了怎么办？ | 免费额度按月重置；临时超额由课题组负责人向管理员申请工单扩容。 |