dsh-molbio-tools

面向 DeepSeek Harness 的零依赖分子生物学研究插件：序列分析、引物自动设计与检查、限制性酶切模拟、GenBank 解析与质粒图谱、qPCR 分析、文献助手与实验台计算。除文献检索与存储外全部为确定性纯计算；插件由纯 .mjs 文件构成，可随 agent preset 目录整体复制分发。

提供的工具（39 个，模型可调用）

序列分析

引物

质粒

克隆构建

克隆验证

实验与统计

蛋白质

序列分析扩展

图谱增强

• molbio_plasmid_map / molbio_plasmid_map_file 新增 gc_skew: true（GC skew 环）与 show_unique_cutters: true（绿色标记所有单切酶）

文献助手

文献与记录

目录结构

dsh-molbio-tools/
├── index.mjs        # 插件入口：export { name, inject, apply }，注册 39 个工具
├── lib.mjs          # 基础库：IUPAC、翻译、酶表、NN 热力学、qPCR、lab math
├── design.mjs       # 引物自动设计（含跨内含子 qPCR）
├── genbank.mjs      # GenBank flatfile 解析器
├── snapgene.mjs     # SnapGene .dna 二进制解析器（含极简 XML 扫描器）
├── plasmid.mjs      # SVG 质粒图谱渲染器（环形/线形，GC skew/标记）
├── align.mjs        # Smith-Waterman 局部比对 + 锚点窗口（Sanger 验证用）
├── cloning.mjs      # 克隆模拟：选酶/酶切连接/Gibson/克隆引物/突变引物
├── sanger.mjs       # ABIF (.ab1) 解析 + 测序验证报告
├── protein.mjs      # 蛋白性质/肽段酶切/密码子优化
├── plot.mjs         # SVG 柱状/散点图渲染
├── seqio.mjs        # FASTA/FASTQ 解析与统计
├── records.mjs      # 协议库/实验日志存储
├── papers.mjs       # 文献库存储（经 harness fs 服务 + 沙箱政策）
├── cordis.patch.yml # bundle 补丁层（可选安装渠道用，按包名插入 tool-molbio 行）
├── preset/
│   └── molbio-lab/  # 推荐的专属模式预设（agent.cordis.yml + preset.yml + plugins/dsh-molbio-tools-v11/）
├── test/
│   └── smoke.mjs    # 冒烟测试（复用 harness 自身的 JSON Schema 校验器）
├── docs/
│   └── maintainer.md # 维护者文档（合规对照/开发测试/路线图）
├── package.json
└── README.md

安装（推荐：专属模式 preset）

推荐给最终用户的方式：安装后预设选择器出现 Molecular Biology Lab 专属模式， molbio 工具只在该模式出现，不会把 39 个工具和提示段注入到其它会话（避免污染无关场景）。

仓库的 preset/molbio-lab/ 即完整预设目录，把它复制到对方的 harness 用户目录即可：

~/.dsh/.agent-presets/molbio-lab/
├── agent.cordis.yml                 # 标准编码 Agent + 末尾的 tool-molbio 行
├── preset.yml                       # 显示名称与描述
└── plugins/
    └── dsh-molbio-tools-v11/        # 插件文件（版本目录，见下文）

对方重启（或刷新预设列表）后，在预设选择器中选择 Molecular Biology Lab 新建会话。

插件更新（版本目录规则）

DSH 的 standing 挂载按 ESM 模块 URL 缓存模块。每次更新必须新建版本目录 （如 dsh-molbio-tools-v12/）并同步修改 agent.cordis.yml 中的插件行；绝不在已发布 目录里原地改文件。分发者从包根目录把 .mjs 文件复制进新版本目录即可：

cp *.mjs preset/molbio-lab/plugins/dsh-molbio-tools-v12/
# 并把 agent.cordis.yml 的行改为 './plugins/dsh-molbio-tools-v12/index.mjs'

安装（可选：官方组合包 bundle，全局可见）

本包同时是官方的组合包（bundle）（dsh.bundle manifest → cordis.patch.yml）。 注意：bundle 把插件行注册到 profile 的全局 tools 层——该 profile 的所有会话都会 加载 molbio 工具与提示段。适合"整个 profile 专用于分子生物学"的用户，不适合混合用途。

验证方式（官方推荐）：

dsh plugin --profile demo add <包>      # 需要用户机器装有 pnpm（官方流程依赖）
dsh --profile demo --dump-config        # 组合树中应出现 "# == dsh-molbio-tools" 层

本仓库已验证：--dump-config 输出以 # == dsh-molbio-tools + - id: tool-molbio / name: dsh-molbio-tools 开头（层序在 dsh-base 之上），且从 profile 目录按包名 import('dsh-molbio-tools') 成功注册全部 39 个工具。两种安装方式可以共存（同名工具 由 preset 层 shadow 全局层，无冲突），但通常二选一即可。

版本目录规则的原理（维护者必读）：DSH 的 standing preset 挂载在整个进程生命周期 内存在，且 Node 的 ESM 模块缓存以文件 URL 为键——同一 URL 的 import() 永远返回 第一次加载的模块，包括插件内部的相互 import（给入口加查询串只能破坏入口自身的 缓存，依赖文件仍会命中旧缓存）。因此原地替换 .mjs 不会让新会话加载新代码；目录名 变化使所有模块 URL 一次性更新。旧目录可删除（已运行的 generation 持有内存中的模块， 不受磁盘删除影响）。

行为与假设

• 纯计算工具（序列/引物/统计）确定性、无副作用；输入输出均为可持久化的 JSON。
• 图谱工具直接写文件：molbio_plasmid_map / molbio_plasmid_map_file 把 SVG 写入工作区（ctx.fs + 会话沙箱政策），模型上下文里只出现文件路径，避免大文本截断。
• 克隆模拟约定：酶切-连接要求"插入片段按 5'→3' 书写、上游酶在 5' 端"；单酶连接会给出双向连接说明与两种方向的验证酶切；特征坐标按插入/缺失自动平移，跨越连接点的特征标注 spans_insertion。
• Sanger 验证：参考序列按环状处理（读段跨 origin 也能正确对齐）；.ab1 低质量（<20）位点单独标注且不计入"differences_found"判定；氨基酸后果按 frame 1 假设报告。
• 文献库与检索走 harness 的 fs/web 服务：库文件默认 papers.json 在工作区内，写入遵循会话的沙箱政策（ctx.sandboxPolicy），与其他文件工具同权。
• IUPAC 序列：输入支持 A C G T U R Y S W K M B D H V N；U 按 T 处理；简并碱基在酶切位点匹配与引物设计中视为不匹配/不可用。
• Tm 是估算值：SantaLucia 1998 NN + 盐校正，报告时应说明是估算，不能替代仪器校准。
• 图谱坐标：特征 1-based 闭区间；strand: -1 表示 complement 链；酶切标记使用酶表的标准切点记号。
• 引物设计性能：区域扫描 + 候选缓存 + 排序裁剪，几十 kb 模板在亚秒级完成；找不到满足约束的组合时返回空并提示放宽条件。

典型用法示例

"解析这个 .dna 文件并画出质粒图谱"        → molbio_plasmid_map_file(path, enzymes:[...]) → 工具直接写入 <名称>.svg
"看看 pUC118.dna 里有哪些特征和引物"      → molbio_parse_snapgene(path)
"把这段序列克隆进 pUC118（EcoRI/HindIII），模拟最终质粒" → molbio_unique_cutters 选酶 → molbio_clone_simulate → molbio_plasmid_map 画新质粒
"给插入片段设计带酶切位点的克隆引物"      → molbio_clone_primers
"帮我验证这个测序结果和质粒是否一致"      → molbio_verify_sanger(trace_path, reference_path)
"帮我在外显子 3 上设计一对 qPCR 引物，产物 80-150 bp" → molbio_design_primers (amplicon_min/max) → molbio_primer_check 复核
"搜一下 KRAS G12D 抑制剂的最新文献并存进阅读库" → molbio_pubmed_search → molbio_paper_add

SnapGene .dna 支持说明

• 解析器支持现代 SnapGene 格式（cookie + DNA 包 + XML 包：features 0x0A、primers 0x05、notes 0x06）；序列编码自动检测（ASCII 与旧式数字编码）；环状/线形由 DNA 包 flags 推断。
• 特征区段支持多段 join（如 AmpR 的编码区 + 信号肽），directionality 映射为链向（1→正链，2→负链）。
• SnapGene 注释里的 HTML 文本（<html>…）会自动清洗为纯文本。
• .dna 是二进制文件，普通 read 工具读不了——请直接给工具传文件路径，不要尝试自己读内容。

维护者（开发者）请参阅 docs/maintainer.md：官方规范对照、冒烟测试与发布/版本目录维护流程。