pi-ask-author

专为作家、轻小说创作者与 AI 协同写作设计的 Pi 终端交互式提问请示扩展。

通过在问题中提供带有 Markdown 渲染的正文草稿预览、剧情因果推演与灵活的批注系统，让创作分歧在同一次询问内得到确认。

核心特性

• 双栏响应式 TUI 交互
  • 左栏选项决策：直观展示单选/多选状态、完成度指示徽标、选项标签与专属批注标识。
  • 右栏实时预览：光标移动时即时联动渲染当前选项的剧情因果推导与 Markdown 正文草稿预览。
  • 自适应视口：终端宽度不足时启用双栏，窄屏下改为单栏内联展开与折叠。
• 小说级富文本与草稿高亮
  • 内置紧凑轻量的终端 Markdown 渲染与小说语法高亮，完整支持粗体、斜体、删除线、行内代码、引用区块。
  • 对中文小说台词（引号内对话高亮）与分段排版做了专门处理，作者可以在终端内直接检视行文节奏与语感。
• 题目与选项两级批注体系
  • 题目级补充说明：对该题整体提出全局创作指令或氛围补充。
  • 选项专属补充说明：光标位于选项行时按 n 即可为特定选项追加细化批注（未勾选的选项同样可以填写补充说明，便于模型借鉴未选方案中的可取之处）。
• 单题平铺与批量问卷双模式
  • 单题平铺模式：快速发起单点决策（如重要剧情分歧、结局走向）。
  • 多题批量问卷模式：支持在单次弹窗内汇集多个关联决策（如脱离路线 + 战利品搜刮 + 下章基调），配有顶部 Tab 标签栏与完成度总览页（Summary Tab），作者在一处完成全部确认。
• 高性能与极简依赖
  • 严格遵守 Pi 官方扩展生态规范，不引入其他第三方依赖。
  • 资源回收：生命周期严格绑定 AbortSignal，定时器与事件监听幂等清理，渲染缓存按尺寸与状态键失效。

工具预览

安装与加载

方式一：通过 Pi 包管理器安装（推荐）

# 从 GitHub 仓库安装
pi install git:github.com/sendevia/pi-ask-author

# 或从 npm 安装
pi install npm:@sendevia/pi-ask-author

添加到全局或项目配置后，每次启动 pi 时将自动加载该扩展。

方式二：临时体验

pi -e git:github.com/sendevia/pi-ask-author

方式三：本地开发加载

将仓库克隆至本地后，在项目 .pi/extensions/ 或全局 ~/.pi/agent/extensions/ 中添加引用，或在运行时通过 -e 引入：

pi -e ./path/to/pi-ask-author

终端快捷键

开发

本项目开启 TypeScript 严格模式：

# 安装开发依赖
pnpm install

# 严格类型检查
pnpm run check

开源许可证

本项目基于 MIT License 开源发布。欢迎贡献代码或提出改进建议！