dsh-molbio-tools 0.19.0 → 0.20.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +100 -0
- package/README.md +65 -21
- package/align.mjs +28 -0
- package/batch.mjs +185 -0
- package/benchmark/README.md +27 -8
- package/benchmark/sequences.mjs +7 -0
- package/benchmark/tasks/02-primers.json +132 -19
- package/benchmark/tasks/03-restriction.json +113 -29
- package/benchmark/tasks/04-cloning.json +167 -34
- package/benchmark/tasks/05-plasmids.json +172 -29
- package/benchmark/tasks/06-analysis.json +387 -100
- package/benchmark/tasks/09-formats.json +132 -23
- package/benchmark/tools.mjs +28 -2
- package/benchmark/verifications.mjs +17 -1
- package/build/release-preflight.mjs +2 -2
- package/crispr.mjs +392 -78
- package/docs/history.md +10 -0
- package/docs/maintainer.md +8 -6
- package/docs/roadmap.md +22 -8
- package/docs/rules.md +1 -1
- package/docs/workflow.md +7 -7
- package/fastq-qc.mjs +735 -735
- package/index.mjs +573 -36
- package/lib/client.js +665 -86
- package/multiplex.mjs +87 -0
- package/package.json +9 -4
- package/packages/molbio-panel/lib/client.js +665 -86
- package/packages/molbio-panel/package.json +1 -1
- package/preset/molbio-lab/agent.cordis.yml +4 -4
- package/preset/molbio-lab/preset.patch.yml +2 -2
- package/preset/molbio-lab/preset.yml +1 -1
- package/silent-site.mjs +286 -0
- package/snapgene.mjs +17 -1
- package/taqman.mjs +163 -7
- package/test/contract.mjs +14 -0
- package/test/release.mjs +23 -3
- package/test/smoke.mjs +377 -3
- package/benchmark/reports/20260923-142935-suite.json +0 -545
- package/benchmark/reports/20260923-142935-suite.md +0 -30
- package/benchmark/reports/20260923-190149-suite.json +0 -2024
- package/benchmark/reports/20260923-190149-suite.md +0 -235
- package/benchmark/reports/20260923-192913-suite.json +0 -1856
- package/benchmark/reports/20260923-192913-suite.md +0 -158
- package/benchmark/reports/20260923-200212-suite.json +0 -3587
- package/benchmark/reports/20260923-200212-suite.md +0 -163
- package/benchmark/reports/20260923-202830-suite.json +0 -3129
- package/benchmark/reports/20260923-202830-suite.md +0 -99
- package/benchmark/reports/20260923-203856-suite.json +0 -71
- package/benchmark/reports/20260923-203856-suite.md +0 -16
package/docs/history.md
CHANGED
|
@@ -16,6 +16,7 @@
|
|
|
16
16
|
|
|
17
17
|
| 包版本 | preset 版本 | 内容 | 工具数 |
|
|
18
18
|
| --- | --- | --- | --- |
|
|
19
|
+
| 0.20.0 | — | **Cas 家族几何**(SpCas9/SaCas9/Cas12a/Cas13a/b/d)+ 反向链脱靶定位修复;TaqMan MGB/订购 CSV;multiplex 退火温度/浓度;批量分析 CSV;静默位点突变;并入 0.19.1 硬化 | 60 |
|
|
19
20
|
| 0.19.0 | — | 环形/扇形的**旋转多行标签**(画面正确性);新增 `molbio_alignment_postprocess`(共识/修剪/同一性矩阵/覆盖度) | 58 |
|
|
20
21
|
| 0.16.0 | — | **修掉 benchmark 交出的前两条缺陷**:引物朝向、甲基化参考表(各带串联/来源回归) | 57 |
|
|
21
22
|
| 0.15.3 | — | 补回客户端宿主锚点(两个侧边栏 tab 曾静默消失) | 57 |
|
|
@@ -40,6 +41,15 @@
|
|
|
40
41
|
|
|
41
42
|
---
|
|
42
43
|
|
|
44
|
+
## v0.20.0(2026-10-17,包 0.20.0)
|
|
45
|
+
|
|
46
|
+
这一版把 0.19.1 的四项硬化并入 0.20.0,并落地 2.3 / 2.5 / 2.7 / 2.8 与 survey #8。**最重要的教训是
|
|
47
|
+
反向链脱靶的静默错误**:`findProtospacers` 的反向几何一直有 smoke 覆盖,但 `finalizeSites` 的
|
|
48
|
+
top-strand 起点对反向命中减了 `guideLength-1`,所以反向脱靶整体偏移 19 nt 并大多被越界丢弃;
|
|
49
|
+
正向 fixture 全绿,缺陷只在"用反向完美位点互指"时暴露。Cas12a/Cas13 的家族几何又是同一类问题的
|
|
50
|
+
放大版:一个写死的 3' PAM/20 nt 假设,对 5' PAM 的 Cas12a 和 RNA/PFS 的 Cas13 会给出错误坐标。
|
|
51
|
+
几何必须来自一张**按家族声明**的表,而不是散落在扫描函数里的常量。
|
|
52
|
+
|
|
43
53
|
## v0.19.0(2026-10-11,包 0.19.0)
|
|
44
54
|
|
|
45
55
|
roadmap 2.4(画面正确性)与 2.2(比对后处理)两条候选一起落地。完整条目见
|
package/docs/maintainer.md
CHANGED
|
@@ -30,13 +30,13 @@
|
|
|
30
30
|
|
|
31
31
|
## 60 秒速览
|
|
32
32
|
|
|
33
|
-
- **包**:`dsh-molbio-tools`,零依赖 DSH 插件包,**
|
|
33
|
+
- **包**:`dsh-molbio-tools`,零依赖 DSH 插件包,**60 个 `molbio_*` 工具**(其中
|
|
34
34
|
`molbio_plot` 一个工具承载 8 种图表)。
|
|
35
|
-
- **基线**:DSH **0.
|
|
35
|
+
- **基线**:DSH **0.2.0-rc.2**;`package.json` 版本 0.20.0。
|
|
36
36
|
- **两条分发渠道**:根包(工具 + 面板)与 `packages/molbio-panel`(只面板),
|
|
37
37
|
**两个独立的 npm 条目、两条独立的版本线**,必须分别发布。
|
|
38
38
|
- **工具只在专属模式里出现**(设计如此):bundle 的 `cordis.patch.yml` 是**空列表**,
|
|
39
|
-
|
|
39
|
+
60 个工具由 preset 层承载,只会挂进 "Molecular Biology Lab" 模式。
|
|
40
40
|
- **测试**:`npm test` = 插件(`smoke`)+ 画面(`svgpng`/`svgio`/`charts`)+ 客户端四套件 +
|
|
41
41
|
DSH 契约(`contract`)+ 组合(`preset-health`)+ 漂移守卫(`drift-probe`)+
|
|
42
42
|
发布守卫(`release`)+ benchmark 的 profile 守卫与**离线期望值校验**。
|
|
@@ -44,14 +44,14 @@
|
|
|
44
44
|
`build/release-preflight.mjs`,然后用 **OIDC 可信发布**(仓库里没有任何长期 token)分两步发
|
|
45
45
|
两个 npm 条目,最后用 CHANGELOG 该版本段落建 GitHub Release。**首次发布必须手动做一次**
|
|
46
46
|
(可信发布要求包已存在),完整步骤见 [workflow.md](workflow.md) 第 4 节的 CD 段。
|
|
47
|
-
- **benchmark**:`npm run bench` 用真实模型跑 core 档 14 题(`bench:full` 全部
|
|
47
|
+
- **benchmark**:`npm run bench` 用真实模型跑 core 档 14 题(`bench:full` 全部 61 题),分
|
|
48
48
|
`tools_ok` / `args_ok` / `answer_ok` 三项判分;`npm run bench:offline` 零成本校验期望值。
|
|
49
49
|
|
|
50
50
|
包内目录结构:
|
|
51
51
|
|
|
52
52
|
```
|
|
53
53
|
dsh-molbio-tools/
|
|
54
|
-
├── index.mjs # 插件入口:export { name, inject, apply },注册
|
|
54
|
+
├── index.mjs # 插件入口:export { name, inject, apply },注册 60 个工具
|
|
55
55
|
├── lib.mjs # 基础库:IUPAC、翻译、酶表、NN 热力学、qPCR、lab math、甲基化/buffer 参考表
|
|
56
56
|
├── design.mjs # 引物自动设计(含跨内含子 qPCR)
|
|
57
57
|
├── taqman.mjs # TaqMan 水解探针设计(复用 design.mjs 的引物引擎)
|
|
@@ -66,11 +66,13 @@ dsh-molbio-tools/
|
|
|
66
66
|
├── msa.mjs # 多序列渐进式比对与保守性分析
|
|
67
67
|
├── align-post.mjs # 比对后处理:共识/缺口修剪/同一性矩阵/逐列覆盖度
|
|
68
68
|
├── logo.mjs # 序列标识图(信息量 + SVG)
|
|
69
|
-
├── crispr.mjs # CRISPR gRNA 设计(
|
|
69
|
+
├── crispr.mjs # CRISPR gRNA 设计(SpCas9/SaCas9/Cas12a/Cas13 家族几何、评分、脱靶搜索)
|
|
70
70
|
├── cloning.mjs # 克隆模拟:选酶/酶切连接/Gibson/Golden Gate/克隆引物/突变引物
|
|
71
|
+
├── silent-site.mjs # 静默酶切位点突变(同义密码子内添加/移除位点)
|
|
71
72
|
├── sanger.mjs # ABIF (.ab1) 解析 + 测序验证
|
|
72
73
|
├── plot.mjs # SVG 柱状/散点图 + 虚拟琼脂糖凝胶
|
|
73
74
|
├── seqio.mjs # FASTA/FASTQ 解析与统计
|
|
75
|
+
├── batch.mjs # 批量文件分析:同一套摘要/ORF/酶切位点 → CSV/TSV
|
|
74
76
|
├── records.mjs # 协议库 / 实验日志存储
|
|
75
77
|
├── papers.mjs # 文献库存储
|
|
76
78
|
├── view.mjs # auto-view:把 SVG 交给系统默认应用打开
|
package/docs/roadmap.md
CHANGED
|
@@ -10,12 +10,12 @@ L = 需要新机制或外部资源)。
|
|
|
10
10
|
|
|
11
11
|
---
|
|
12
12
|
|
|
13
|
-
## 1. 当前状态(0.
|
|
13
|
+
## 1. 当前状态(0.20.0)
|
|
14
14
|
|
|
15
|
-
-
|
|
15
|
+
- 60 个 `molbio_*` 工具,零依赖,随 preset 分发(见 [README](../README.md))。
|
|
16
16
|
- 离线测试金字塔 + 组合漂移守卫全绿;`benchmark/` 提供**模型使用**维度的评估
|
|
17
17
|
(见 [benchmark/README.md](../benchmark/README.md))。
|
|
18
|
-
- 基线:DSH **0.
|
|
18
|
+
- 基线:DSH **0.2.0-rc.2**。
|
|
19
19
|
- **CI 已在位**(`.github/workflows/test.yml`,0.18.2 起):push / PR / 手动都跑全套;harness 装
|
|
20
20
|
**钉死版本**,并用 `npm prefix -g` 显式导出 `DSH_HARNESS_ROOT`。0.18.4 起**同时跑
|
|
21
21
|
`ubuntu-latest` 与 `windows-latest`**——3.6 已修,套件不再依赖宿主分隔符。
|
|
@@ -25,6 +25,8 @@ L = 需要新机制或外部资源)。
|
|
|
25
25
|
0.18.0 落地小提琴/火山/热力图与连续色带 —— `molbio_plot` 现共 **8 种图表**(见 2.10)。
|
|
26
26
|
- **2.4 与 2.2 已在 0.19.0 交付**:环形/扇形的旋转多行标签(含像素断言),以及
|
|
27
27
|
`molbio_alignment_postprocess`(共识/修剪/同一性矩阵/覆盖度)。
|
|
28
|
+
- **2.3 / 2.5 / 2.7 / 2.8 与 survey #8 已在 0.20.0 交付**:批量分析 CSV、Cas12a/Cas13 家族几何
|
|
29
|
+
(含反向链脱靶定位修复)、multiplex 退火温度/浓度建议、TaqMan MGB/订购 CSV、静默位点突变。
|
|
28
30
|
|
|
29
31
|
---
|
|
30
32
|
|
|
@@ -65,7 +67,10 @@ L = 需要新机制或外部资源)。
|
|
|
65
67
|
- **共识有三种可辩护的定义**,必须由调用方选:`plurality` / `union` / `strict`。
|
|
66
68
|
`conservationAnalysis` 只是选了其中一种并写明。
|
|
67
69
|
|
|
68
|
-
### 2.3
|
|
70
|
+
### 2.3 ✅ 已做(0.20.0)批量分析 + 表格导出(M)
|
|
71
|
+
|
|
72
|
+
新增 `molbio_batch_analyze` + `batch.mjs`:目录/显式 paths、递归、FASTA/FASTQ/GenBank/SnapGene,
|
|
73
|
+
CSV/TSV,坏文件成 error 行而不中断。
|
|
69
74
|
|
|
70
75
|
survey 第 7 条:对工作区里所有匹配文件跑同一项分析并出 CSV。
|
|
71
76
|
牵连点是"写文件"路径已经齐备(`ctx.fs` + sandboxPolicy),主要是参数设计。
|
|
@@ -86,7 +91,10 @@ unsupported),径向分支用**四角是否都在绘图矩形内**做精确
|
|
|
86
91
|
③**折行宽度不能随角度变**——三种角度相关规则实测全部产生窄列或长行柱;
|
|
87
92
|
④旋转文字的墨迹比几何宽度宽约 1 px(光栅化器用圆角描边画字形),预算要额外留出。
|
|
88
93
|
|
|
89
|
-
### 2.5 Cas12a/Cas13 等 PAM 家族(M)
|
|
94
|
+
### 2.5 ✅ 已做(0.20.0)Cas12a/Cas13 等 PAM 家族(M)
|
|
95
|
+
|
|
96
|
+
`CAS_FAMILIES` 表给出 PAM/PFS 侧、crRNA 长度与种子;Cas12a 用 5' TTTV/23 nt/5' 种子,
|
|
97
|
+
Cas13 用 RNA/PFS(不是 PAM)。同时修掉反向链脱靶定位的 19 nt 偏移。
|
|
90
98
|
|
|
91
99
|
`pam` 参数已能传 `NNRT`,缺**家族特定的评分曲线与几何校验**(PAM 位置、种子区定义、
|
|
92
100
|
crRNA 长度差异)。需要参考表,不需要外部二进制。
|
|
@@ -96,12 +104,18 @@ crRNA 长度差异)。需要参考表,不需要外部二进制。
|
|
|
96
104
|
当前把传入序列当参考。基因组规模需要先建一次索引再复用(索引的生命周期、内存上限、
|
|
97
105
|
跨调用缓存都是新机制),且**不能**引入外部二进制(本包的零依赖约束)。
|
|
98
106
|
|
|
99
|
-
### 2.7
|
|
107
|
+
### 2.7 ✅ 已做(0.20.0)多重 PCR 的温度梯度/浓度配平建议(S/M)
|
|
108
|
+
|
|
109
|
+
`checkMultiplex` 输出 `annealing`(最低引物 Tm − offset,含范围/离散警告)与
|
|
110
|
+
`primer_concentrations`(按扩增子大小比例的起始计划)。
|
|
100
111
|
|
|
101
112
|
`molbio_multiplex_check` 已报告互扰;缺的是"给一组引物建议退火温度与各引物浓度"这类
|
|
102
113
|
可执行结论。纯计算。
|
|
103
114
|
|
|
104
|
-
### 2.8 TaqMan 的 MGB / 双标记探针与订购 CSV(S/M)
|
|
115
|
+
### 2.8 ✅ 已做(0.20.0)TaqMan 的 MGB / 双标记探针与订购 CSV(S/M)
|
|
116
|
+
|
|
117
|
+
`probe_chemistry: 'mgb'`(未修饰 NN Tm 明确标注、不施加误导性的 Tm 差值罚分)+ 订购 CSV
|
|
118
|
+
(引物/探针、5'/3' 修饰、规模、纯化)。
|
|
105
119
|
|
|
106
120
|
v16 的 CRISPR 已有订购 CSV 先例,可直接复用格式。
|
|
107
121
|
|
|
@@ -152,7 +166,7 @@ v18 想做"工具写一个工作区 PNG 文件"而**不能**:`dsh-fs` 明文
|
|
|
152
166
|
|
|
153
167
|
### 3.2 benchmark 的覆盖面
|
|
154
168
|
|
|
155
|
-
-
|
|
169
|
+
- 61 条任务覆盖 **60/60 个工具**(0.15.0 起由 `test/benchmark-coverage.mjs` 机器断言;
|
|
156
170
|
core 档 14 题)。**但多数工具只出现在一条任务里,覆盖是浅的**——见
|
|
157
171
|
[benchmark/README.md](../benchmark/README.md) 的"What this benchmark does NOT measure"。
|
|
158
172
|
- 没有断言 **`attach_image` 交付的图片内容**(只当参数用),也不加载客户端产物。
|
package/docs/rules.md
CHANGED
|
@@ -147,7 +147,7 @@ ctx.effect(() => ctx.slots.inject(座位, () => ctx.slots.register({name: 座位
|
|
|
147
147
|
|
|
148
148
|
这条规则有两道**机器守卫**,它们让"忘了"变成"红":
|
|
149
149
|
|
|
150
|
-
- `test/benchmark-coverage.mjs` 断言 **
|
|
150
|
+
- `test/benchmark-coverage.mjs` 断言 **60/60 个已注册工具都被至少一个任务覆盖**。
|
|
151
151
|
新增工具而没加任务 = **直接 FAIL**。它同时守住 fixture 的前提(Golden Gate 的载体必须
|
|
152
152
|
无 BsaI 位点、诱变模板必须仍能设计出引物)与 tier/占位符的健全性。
|
|
153
153
|
- `test/benchmark-score.mjs` 用**真实模型响应的冻结副本**(`test/fixtures/benchmark-traces.json`)
|
package/docs/workflow.md
CHANGED
|
@@ -20,7 +20,7 @@
|
|
|
20
20
|
| 使用 | 模型找得到、用得对吗? | `benchmark/`(见 [benchmark/README.md](../benchmark/README.md)) |
|
|
21
21
|
|
|
22
22
|
```bash
|
|
23
|
-
node test/smoke.mjs # 插件:mock 注册表跑全部
|
|
23
|
+
node test/smoke.mjs # 插件:mock 注册表跑全部 60 个工具 + 输出 schema 校验
|
|
24
24
|
node test/svgpng.mjs # 光栅化器:PNG 结构 + inflate 回像素断言 + 真实渲染器子集检查
|
|
25
25
|
node test/svgio.mjs # 共享绘图助手:几何手算值 + 每种助手拼一张文档后光栅化必须干净
|
|
26
26
|
node test/charts.mjs # 图表:CSV/TSV 读取层 + 八种图表(含色带)的统计量与光栅化
|
|
@@ -50,7 +50,7 @@ node benchmark/run.mjs --offline # benchmark 的期望值是否仍等于工具
|
|
|
50
50
|
|
|
51
51
|
### 各套件到底在防什么
|
|
52
52
|
|
|
53
|
-
- **`smoke.mjs`** 证明**插件**可用:mock 注册表运行全部
|
|
53
|
+
- **`smoke.mjs`** 证明**插件**可用:mock 注册表运行全部 60 个工具,并用 harness 自身的
|
|
54
54
|
`assertSupportedJsonSchema` / `validateJsonSchemaValue` 校验每个输出 schema 与返回值;
|
|
55
55
|
覆盖已知值用例(EcoRI 酶切、ΔΔCt=-3 → fold 8、GenBank/SnapGene 解析、引物对一致性、
|
|
56
56
|
SVG 文件写入与无旋转标签断言、克隆模拟手算序列比对、合成 ABIF 夹具、环状参考跨原点
|
|
@@ -218,7 +218,7 @@ benchmark 不是"每天跑一遍"的门禁,而是**行为的验收测试**—
|
|
|
218
218
|
|
|
219
219
|
| 这次改了什么 | benchmark 要不要动 | 为什么 |
|
|
220
220
|
| --- | --- | --- |
|
|
221
|
-
| 新增一个工具 | **必须**:加任务 + `verifications.mjs` 的 invocation | `test/benchmark-coverage.mjs` 会**直接 FAIL**(`
|
|
221
|
+
| 新增一个工具 | **必须**:加任务 + `verifications.mjs` 的 invocation | `test/benchmark-coverage.mjs` 会**直接 FAIL**(`60/60 tools covered` 是断言) |
|
|
222
222
|
| 改工具的参数、默认值、输出字段、渲染文本 | **必须**:更新受影响任务的断言,重跑 `--offline`,再重跑该任务 | 断言比对的是**渲染文本**,改了文本就改了对错 |
|
|
223
223
|
| 改工具的描述或参数说明(prompt 面) | **必须**:重跑对应任务 | 这正是 benchmark 唯一能测的东西——模型是否还选得对 |
|
|
224
224
|
| 改 `preset/molbio-lab/agent.cordis.yml`(行清单) | **必须**:先 `node test/benchmark-profile.mjs`,再重建 profile | 行清单变了,benchmark 的 headless profile 是**推导**出来的,守卫会 FAIL |
|
|
@@ -237,7 +237,7 @@ benchmark 不是"每天跑一遍"的门禁,而是**行为的验收测试**—
|
|
|
237
237
|
|
|
238
238
|
```bash
|
|
239
239
|
node benchmark/run.mjs --offline # 每条 where:"tool" 断言是否仍等于工具的真实渲染输出
|
|
240
|
-
node test/benchmark-coverage.mjs #
|
|
240
|
+
node test/benchmark-coverage.mjs # 60/60 工具有任务覆盖、fixture 前提仍成立、tier 与占位符健全
|
|
241
241
|
node test/benchmark-score.mjs # 判分器对冻结的真实响应仍判对,且仍能判错
|
|
242
242
|
```
|
|
243
243
|
|
|
@@ -254,7 +254,7 @@ offline 证明"期望值仍然为真",model 测量"模型是否仍然会用"
|
|
|
254
254
|
| 改了**几个**工具 | `--tools a,b,c`(也接受 `molbio_` 前缀与 `primer_*` 通配) | 并集 |
|
|
255
255
|
| 改了**一个**已知任务 | `--task <id>` | 一题 |
|
|
256
256
|
| 改了**共享模块**,想知道影响面 | `--list --changed`(不花钱) | 0 |
|
|
257
|
-
| 发版前 | `node --run bench:full` |
|
|
257
|
+
| 发版前 | `node --run bench:full` | 61 题 |
|
|
258
258
|
| 只是提交文档 | `--changed` 会回答"无事可跑" | 0 |
|
|
259
259
|
|
|
260
260
|
```bash
|
|
@@ -299,7 +299,7 @@ $ touch lib.mjs && node benchmark/run.mjs --list --changed
|
|
|
299
299
|
1. **不可判定 → 全量**:没有 git / 没有 HEAD / 读不到插件结构,一律回落全量并打印原因;
|
|
300
300
|
2. **认不出的文件 → 全量**:新模块、重命名的文件(`not in the plugin's module set`);
|
|
301
301
|
3. **`index.mjs` → 全量**:它是绑定全部工具的那个入口;
|
|
302
|
-
4. **映射到的工具有题没覆盖 → 全量**(并由 `test/benchmark-coverage.mjs` 断言
|
|
302
|
+
4. **映射到的工具有题没覆盖 → 全量**(并由 `test/benchmark-coverage.mjs` 断言 60/60 覆盖)。
|
|
303
303
|
|
|
304
304
|
反过来,**唯一会返回"无事可跑"的情况**是改动**可证明**不影响工具行为:`docs/`、
|
|
305
305
|
`CHANGELOG.md`、`README.md`、`test/`、`benchmark/`、`package.json`。这不是走后门——
|
|
@@ -456,7 +456,7 @@ git status --short # lib/client.js 与 packages/molbio-panel/lib/clien
|
|
|
456
456
|
### DSH 升级后:preset 组合的维护(必做)
|
|
457
457
|
|
|
458
458
|
`preset/molbio-lab/agent.cordis.yml` 是官方 `standard` 预设的**行清单**副本 + 末尾一行
|
|
459
|
-
`tool-molbio`(当前基线:**dsh 0.
|
|
459
|
+
`tool-molbio`(当前基线:**dsh 0.2.0-rc.2**)。它不会自动跟随 DSH 升级,因此每次升级
|
|
460
460
|
DSH 后:
|
|
461
461
|
|
|
462
462
|
1. 取新版的 shipped `standard`:
|