K-Dense BYOK 命令清单:/qc、/stats-check、/replicate 等 6 大可复用科研提示词速查

原创2026-10-12 15:57:471,731 阅读

K-Dense BYOK 命令清单:/qc、/stats-check、/replicate 等 6 大可复用科研提示词速查

K-Dense BYOK 是运行在你自己电脑上的开源 AI 科研助手(内置助手 Kady)。它的聊天输入框内置了 /qc、/stats-check、/replicate、/prove-verify 等一批可复用科研提示词命令:输入 / 就能一键呼出,把重复编写的长提示词变成一行命令。本文整理完整的命令清单、参数写法与自定义模板方法,帮你快速上手。

为什么需要可复用科研提示词

科研工作中的很多请求是高度重复的:

  • 每次拿到新数据都要先做一遍质量检查;
  • 投稿前都要审一遍统计方法和图表;
  • 审稿人经常要求复现某个分析脚本。

如果每次都手写一大段提示词,既慢又不一致。K-Dense BYOK 的做法是:把这些提示词写成模板文件,命令只有一行,参数用空格跟在后面即可。模板内容在发送时从磁盘重新读取,改完立即生效,无需重启。

K-Dense BYOK 应用界面截图,展示对话区、文件浏览器与可复用科研提示词命令的工作空间

图 1:K-Dense BYOK 主界面。在左侧对话区输入 / 即可呼出命令菜单,文件浏览器中可直接引用 user_data/ 里的数据集。

快速上手:输入 / 一键呼出命令菜单

  1. 打开任意项目的聊天框,直接输入 /,会弹出命令菜单(模板与技能混合列出,最多显示 8 条,可按名称或描述筛选);
  2. 选中命令后,按提示补齐参数,回车发送;
  3. 发送后,对话里会以一个可折叠的 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。

K-Dense BYOK 演示动画:Kady 执行端到端单细胞 RNA-seq 分析,展示工具调用、生成图表与实验记录本

图 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)。

相关资料

把这 6 个命令存进你的快捷键记忆:分析前 /qc,出结果前 /stats-check,交图前 /figure-audit,投稿前 /methods-review,被质疑复现时 /replicate,遇到开放性问题就上 /prove-verify——Kady 会替你把这些科研惯例执行到位并留档。

登录后查看全文
k-dense-byok