pi-dask

Pi 的结构化提问扩展。它把可枚举的用户决策收集为单选或复选答案；不负责决定该问什么，也不维护条件分支。

当前已实现首个 npm（Node 包注册表）版本；接口契约见 doc/接口契约.md。

定位

• npm 包名：pi-dask
• Pi 工具名：dask
• 用户：需要让 Pi 在终端内低摩擦收集结构化选择的人。

dask 负责“怎么收集选择”；决策树、问题顺序、推荐判断与收束属于调用方，例如 507-grill（决策树追问）。两者可以协作，但不互相依赖。

已确认边界

• 支持单选与复选；不提供独立自由文本题。
• 每题都提供“其他（自行填写）”，并以带来源的答案值与枚举选中项区分返回。
• 单选题为 2–5 项；复选题为 2–12 项。超出上限必须由调用方先分组、收敛或拆题。
• 调用方确认确需用户决策且问题已收敛为枚举选项后，应使用 dask，而不是在回复正文中列出编号选项；即使只有一道题也一样。开放式探索和调用方本应自行收口的工程细节不使用 dask。
• 调用时已知且互不依赖的问题应合并到一次调用；答案会改变其他问题是否出现、题意或选项的问题必须分开调用。
• 以逐题向导展示；多题交互会显示当前位置和全部题号，可用数字键 1～9 直跳对应题、用 ← / → 切换相邻题，并保留各题草稿。第 10 题及以后仍可通过左右键访问。
• 最终展示答案摘要并确认提交；存在未回答题时会返回第一道未答题补答，不生成不完整结果。用户取消时以工具取消/错误结束，不返回部分答案。
• 不支持条件跳题；依赖前题答案的流程应由调用方分多次请求。

当前实现状态

• 当前版本：0.0.3。
• 根目录 index.ts 是公开入口，package.json 的 main 与 Pi 扩展清单均指向它，再映射到 src/。
• 已实现 TypeScript（类型脚本）包、接口校验、确定性向导状态机、dask 工具与 TUI（终端界面）适配。

安装与使用

pi install npm:pi-dask

安装后，Pi 会加载 dask 工具；调用方传入 questions 数组，确认后获得按题目顺序排列的结构化 answers。

明确不做

• 不提供独立自由文本题、长选项搜索、条件表单或问卷状态持久化。
• 不替代 507-grill（决策树追问）或任何目标/工作流扩展。

文档

从 doc/README.md 开始。项目术语见 doc/术语表.md。