K-Dense BYOK 命令清单:/qc、/stats-check、/replicate 等 6 大可复用科研提示词速查
K-Dense BYOK 命令清单:/qc、/stats-check、/replicate 等 6 大可复用科研提示词速查
K-Dense BYOK 是运行在你自己电脑上的开源 AI 科研助手(内置助手 Kady)。它的聊天输入框内置了 /qc、/stats-check、/replicate、/prove-verify 等一批可复用科研提示词命令:输入 / 就能一键呼出,把重复编写的长提示词变成一行命令。本文整理完整的命令清单、参数写法与自定义模板方法,帮你快速上手。
为什么需要可复用科研提示词
科研工作中的很多请求是高度重复的:
- 每次拿到新数据都要先做一遍质量检查;
- 投稿前都要审一遍统计方法和图表;
- 审稿人经常要求复现某个分析脚本。
如果每次都手写一大段提示词,既慢又不一致。K-Dense BYOK 的做法是:把这些提示词写成模板文件,命令只有一行,参数用空格跟在后面即可。模板内容在发送时从磁盘重新读取,改完立即生效,无需重启。
图 1:K-Dense BYOK 主界面。在左侧对话区输入 / 即可呼出命令菜单,文件浏览器中可直接引用 user_data/ 里的数据集。
快速上手:输入 / 一键呼出命令菜单
- 打开任意项目的聊天框,直接输入
/,会弹出命令菜单(模板与技能混合列出,最多显示 8 条,可按名称或描述筛选); - 选中命令后,按提示补齐参数,回车发送;
- 发送后,对话里会以一个可折叠的 Prompt 标签展示"命令名 + 你填的参数",点开可查看模板展开后的完整内容,保持对话整洁。
如果还没有安装 K-Dense BYOK,可先获取仓库并启动(macOS / Linux):
git clone https://gitcode.com/gh_mirrors/kd/k-dense-byok
cd k-dense-byok
./start.sh
启动后浏览器会自动打开 http://localhost:3000,新建项目、放入数据即可使用这些命令。
6 个内置命令速查表
| 命令 | 用法 | 作用 | 输出位置 |
|---|---|---|---|
/qc |
/qc <file> |
建模前的数据集质量检查(只读,不改文件) | 报告写入 derived/,关键发现记入实验记录本 |
/stats-check |
/stats-check <file-or-result> |
以挑剔的方法审稿人身份审查统计设计与分析 | 区分 blocker / concern / note 三级严重度 |
/figure-audit |
/figure-audit <figure> |
对照数据来源与代码审计图表 | 以实验记录本 observation 形式报告 |
/methods-review |
/methods-review |
审查当前成果的方法与可复现性 | 写入记录本决策条目,可附 Methods 草稿 |
/replicate |
/replicate <script> |
用拷贝的输入重跑脚本并逐一对比输出 | 全新 derived/replicate/<run-id>/ 目录 |
/prove-verify |
/prove-verify <question> [rounds N] [investigators N] [budget $N] |
多智能体并行调查 + 对抗式验证,直到通过审查或触及预算 | derived/prove-verify/<slug>-<时间>/(含 ledger 与 report) |
逐个命令怎么用
/qc 数据集质量检查
/qc user_data/expression.csv
Kady 会按固定流程执行:检查格式与体量(大文件会声明是完整扫描还是抽样)、缺失值与重复行、数值列的异常值(3 MAD)、类别列的近重复拼写、以及样本/批次的设计平衡性。全程不修改、不填充任何数据,最后产出一份"必须在分析前解决"的问题清单,并记入实验记录本。
/stats-check 统计方法审查
/stats-check results/de_table.csv
它会先弄清研究问题、独立单元和研究设计,然后只检查与你的模型真正相关的假设(聚类/重复测量、技术重复与生物学重复、缺失机制、多重检验、效应量与不确定性等),不会机械要求"一切测试都要正态性"。能重算的关键计算会实际重算,算不了的会明确标注"未验证"。每条结论给出证据,并区分确认错误与一般性关切。
/figure-audit 图表审计
/figure-audit figures/volcano.png
Kady 会借助来源记录(provenance)定位生成该图的脚本和数据:能重算的就在全新输出目录里重新推导图中的数值,对比坐标轴范围、分组数量与误差棒定义;无法验证的只做视觉审计并明确标注,不会"看图猜数"。同时检查标签、单位、颜色可及性,以及截断轴、双轴夸大效应等常见问题。
/methods-review 方法学复查
不需要参数。它会用记录本检索和 provenance 记录锁定"当前成果"的范围,把步骤分为计划中 / 已尝试 / 已完成 / 未验证四类并逐一给出证据,标记未记录的手动编辑、缺失脚本和断链的来龙去脉,最终写入一条决策条目,并可以顺手生成论文风格的 Methods 草稿。
/replicate 分析脚本复现
/replicate scripts/deseq_analysis.py
这是最"较真"的命令:
- 先识别脚本的真实输入(浏览器上传件、项目文件、挂载路径都算);
- 创建全新的
derived/replicate/<run-id>/目录,把所有写入重定向进去,绝不覆盖原结果; - 运行前记录基线:文件哈希、参数、随机种子、环境版本;
- 用相同科学参数重跑,对比输出清单、哈希与表格/绘图数据的语义值,容忍度在查看差异之前就确定。
⚠️ 注意:官方明确提示,同一份数据重跑不等于独立的科学复现——它验证的是计算可复现性。
/prove-verify 对抗式多轮验证
/prove-verify 某基因是否是该表型的驱动因素 rounds 2 budget $5
适合"开放性问题":Kady 作为编排者不亲自推导,而是每轮派出若干 investigator 专家并行探索不同方向,每份草稿都要过两道闸门——对应领域的验证者(math-checker、statistical-reviewer、code-reviewer 等)+ 横向比较者 comparative-reviewer,只有双双通过才算数。ledger.md 记录 Verified(已验证结果)、Excluded(被排除方向及反例)和 Attempts(各次尝试与结论),下一轮还会带上本轮的教训。不指定参数时,默认最多 3 轮、每轮最多 3 名调查者。详见 docs/sub-agents.md。
图 2:Kady 完整执行科研任务的演示——流式展示工具调用、生成图表与报告,所有步骤同步记入实验记录本。
进阶调用:/skill: 与状态命令
除提示词模板外,/ 菜单还能直接调用技能(skill):
/skill:lab-protocol PCR plate 3
在 Settings → Skills → User-invoked only 中开启的技能会退出自动发现,只保留 /skill:<name> 这种手动入口,适合不想让 Kady 随手调用的流程类技能。
此外还有一类状态命令(由扩展处理,不消耗模型轮次,直接返回通知卡片):
| 命令 | 用途 |
|---|---|
/subagents |
查看子智能体相关状态 |
/subagents-watchdog status |
检查看门狗(watchdog)审查器是否正常工作,排查静默失败 |
自定义提示词模板:写你自己的命令
内置 6 个模板只是起点。在 Settings → Prompt templates 点 New template 即可创建:
- 文件名即命令名(小写字母、数字、
_、-); - 支持可选的 frontmatter:
description(菜单里的说明)和argument-hint(参数提示,如<topic> [years]); - 正文中用
$1、$2表示位置参数,$@/$ARGUMENTS表示全部参数,${2:-default}提供默认值,${@:2}截取尾部参数; - 不带任何占位符的模板,发送时参数会被整体追加到模板末尾。
示例:一个文献扫描命令。
---
description: Literature scan for a topic
argument-hint: <topic> [years]
---
Search the literature on $1 from the last ${2:-5} years.
两个作用域:项目级模板放在 sandbox/.pi/prompts/,用户级全局模板放在 ~/.kady/pi-agent/prompts/;同名时项目级优先。内置模板被本地修改或删除后不会在升级时被覆盖;如果手滑改坏了,Settings → Prompt templates → Restore defaults 可以恢复 6 个内置版本(其他自定义模板不受影响)。
注意事项与常见问题
- 命令只认第一行:第一行以外的内容和文件引用会原样附在展开文本之后,多行消息里只有首行参与命令解析(见 server/src/agent/prompt-expansion.ts)。
- 拼错的命令会原样发送:未匹配的
/xxx不会被展开,会当作普通消息发给模型,注意核对。 - 模板 64 KiB 上限:模板内容过长会被拒绝保存。
/replicate需要可访问的输入:脚本输入不在项目内时会先报告并询问,不会盲目重跑。- 看门狗是可选的第二道审查:默认关闭,开启后另计模型费用;"没有警告"不等于结果正确(见 docs/watchdog.md)。
相关资料
- 官方文档:docs/prompt-templates.md(模板与命令机制)
- 内置模板源码(6 个模板的完整提示词):server/src/agent/prompts.ts
- 命令展开实现:server/src/agent/prompt-expansion.ts
- 前端命令菜单与 Prompt 标签:web/src/lib/command-blocks.ts、web/src/components/command-block-chip.tsx
/qc模板参考样例:server/test/fixtures/prompt-defaults/qc-v1.md- 专家与验证机制:docs/sub-agents.md
把这 6 个命令存进你的快捷键记忆:分析前 /qc,出结果前 /stats-check,交图前 /figure-audit,投稿前 /methods-review,被质疑复现时 /replicate,遇到开放性问题就上 /prove-verify——Kady 会替你把这些科研惯例执行到位并留档。

