@sendevia/pi-ask-author 1.0.0 → 1.0.1

package/README.md

@@ -15,7 +15,7 @@
 - 🖥️ **双栏响应式 TUI 交互**
   - **左栏选项决策**：直观展示单选/多选状态、完成度指示徽标、选项标签与专属批注标识。
   - **右栏实时预览**：光标移动时即时联动渲染当前选项的**剧情因果推导**与 **Markdown 正文草稿预览**。
-  - **自适应视口**：终端宽度不小于 72 列时启用双栏，窄屏下改为单栏内联展开与折叠。
+  - **自适应视口**：终端宽度不足时启用双栏，窄屏下改为单栏内联展开与折叠。
 - 📖 **小说级富文本与草稿高亮**
   - 内置紧凑轻量的终端 Markdown 渲染与小说语法高亮，完整支持 bold、italic、删除线、行内代码、引用区块。
   - 对中文小说台词（引号内对话高亮）与分段排版做了专门处理，作者可以在终端内直接检视行文节奏与语感。
@@ -26,11 +26,11 @@
   - **单题平铺模式**：快速发起单点决策（如重要剧情分歧、结局走向）。
   - **多题批量问卷模式**：支持在单次弹窗内汇集多个关联决策（如脱离路线 + 战利品搜刮 + 下章基调），配有顶部 Tab 标签栏与完成度总览页（Summary Tab），作者在一处完成全部确认。
 - 🎯 **确定性 LLM 封套与指令蒸馏 (Deterministic Envelopes)**
-  - 工具返回给 LLM 的文本采用固定的结构化 Markdown 封套（`[Author Decision Finalized]` / `[Author Decision Cancelled]` / `[Author Consultation Error]`），前缀稳定，便于 Prompt Cache 命中。
+  - 工具返回给 LLM 的文本采用固定的结构化 Markdown 封套（`[Author Decision Finalized]` / `[Author Decision Cancelled]` / `[Author Consultation Error]`），前缀稳定，便于缓存命中。
   - **草稿指令提取 (Draft Directives)**：选中的选项草稿预览会自动提炼为紧凑的单行 `[Draft directive: ...]` 指令，直接供 LLM 在后续正文执笔中原样复用或参考。
   - 尾部附带执行指令，要求模型不再寒暄，直接进入下一步正文写作。
 - ⚡ **高性能与极简依赖**
-  - 严格遵守 Pi 官方扩展生态规范，核心依赖 `@earendil-works/pi-coding-agent`、`@earendil-works/pi-tui` 与 `typebox` 均列为 `peerDependencies`，不引入其他第三方依赖。
+  - 严格遵守 Pi 官方扩展生态规范，不引入其他第三方依赖。
   - 资源回收：生命周期严格绑定 AbortSignal，定时器与事件监听幂等清理，渲染缓存按尺寸与状态键失效。
 
 ---
@@ -85,114 +85,6 @@ pi -e ./path/to/pi-ask-author
 
 ---
 
-## 🤖 智能体提示词与调用规范 (Agent Guidelines)
-
-在系统提示词或 Skill 中声明以下规则，可以引导 LLM 按预期调用该工具：
-
-```markdown
-Whenever plot branches, character decisions, scene atmosphere, or outline directions need confirmation:
-
-- Call `ask_author` directly without conversational preambles.
-- Always provide a concise `formTitle`.
-- Use the `questions` array to batch interrelated decisions into ONE invocation; avoid consecutive single calls.
-- Include causal plot deductions in `description` and scene draft excerpts in `preview`.
-- Omit optional default fields (`id`, `description`, `minSelect`, `maxSelect`, `allowEmpty`, `allowCustom`) to maximize token economy and prompt caching.
-```
-
-### 参数示例：多题批量问卷
-
-```json
-{
-  "formTitle": "第七幕逃生抉择与伏笔分配",
-  "questions": [
-    {
-      "title": "第一幕脱离路线选择",
-      "options": [
-        {
-          "label": "炸毁地下蒸汽管网断后",
-          "description": "引爆管网阻断追兵，代价是彻底暴露行踪并波及城区管线。",
-          "preview": "“听着，艾略特，”雷恩咬紧牙关按下阀门，“我数到三，你往排污井跳！”\n蒸汽在接缝处发出濒临极限的尖啸，暗红警示灯将二人面孔映得如同凝血。"
-        },
-        { "label": "遁入旧排水暗渠迂回脱离", "description": "周旋于暗渠迷宫，隐匿行踪但有遭遇感染体风险。" }
-      ]
-    },
-    {
-      "title": "主角搜刮战利品与剧情伏笔（多选）",
-      "multiSelect": true,
-      "options": [
-        { "label": "过载超频模块", "description": "战斗中可触发高热熔毁，但易过载自伤。" },
-        { "label": "加密军方识别铭牌", "description": "揭示军方秘密人体实验编号，引发信任危机。" }
-      ]
-    }
-  ]
-}
-```
-
-### 返回封套示例
-
-```text
-[Author Decision Finalized]
-1. [第一幕脱离路线选择]: 【炸毁地下蒸汽管网断后】引爆管网阻断追兵，代价是彻底暴露行踪并波及城区管线。 [Author note: 注意描写气压表的指针爆表碎裂细节] [Draft directive: '听着，艾略特，'雷恩咬紧牙关按下阀门，'我数到三，你往排污井跳！' / 蒸汽在接缝处发出濒临极限的尖啸，暗红警示灯将二人面孔映得如同凝血。]
-2. [主角搜刮战利品与剧情伏笔（多选）]: 【过载超频模块】战斗中可触发高热熔毁，但易过载自伤。; 【加密军方识别铭牌】揭示军方秘密人体实验编号，引发信任危机。
-Execute workflow and writing strictly according to the author decisions and draft directives above without conversational acknowledgments.
-```
-
----
-
-## 🏗️ 架构与模块设计 (Architecture)
-
-插件采用严格的单向无环依赖图分层构建，保证各个组件职责清晰、高内聚且易于测试：
-
-```mermaid
-flowchart LR
-  theme --> texts
-  theme --> novel-markdown
-  theme --> view-rows
-  theme --> view-summary
-  theme --> component
-  texts --> format
-  texts --> schema
-  texts --> model
-  texts --> novel-markdown
-  texts --> view-rows
-  texts --> view-summary
-  texts --> component
-  texts --> index
-  format --> sanitize
-  format --> model
-  format --> novel-markdown
-  format --> view-rows
-  format --> view-summary
-  format --> component
-  format --> index
-  schema --> sanitize
-  schema --> model
-  schema --> index
-  model --> novel-markdown
-  model --> view-rows
-  model --> view-summary
-  model --> component
-  model --> index
-  sanitize --> index
-  novel-markdown --> component
-  view-rows --> component
-  view-summary --> component
-  component --> index
-```
-
-箭头由被依赖模块指向依赖它的模块（`A --> B` 表示 `B` 导入 `A`）。
-
-- **`index.ts`**：扩展主入口，注册 `ask_author` 工具与 `/ask-author` 命令，负责结果工厂构造与卡片记忆化渲染。
-- **`component.ts`**：TUI 状态机核心组件，自行维护按键派生、光标记忆、视口滑动窗口与双栏排版。
-- **`model.ts`**：问卷表单数据模型，负责规范化题目前期推导、选项校验与答案序列化。
-- **`schema.ts`**：基于 TypeBox 构建的静态类型与运行时 Schema 单一数据源。
-- **`texts.ts`**：常量、终端图标、小说语法表与面向作者/LLM 双向文案的集中字典。
-- **`novel-markdown.ts`**：小说语法终端高亮层，在原生 Markdown 引擎解析前注入语义标记。
-- **`sanitize.ts`**：入参防御性清洗与别名兼容。
-- **`view-rows.ts` / `view-summary.ts`**：列表行与总览页的排版生成器。
-
----
-
 ## 🧪 开发与质量验证 (Development)
 
 本项目开启 TypeScript 严格模式：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sendevia/pi-ask-author",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "面向文字创作者的创作决策询问 Pi 扩展：交互式双栏 TUI 问卷、Markdown 草稿预览与题目/选项两级批注",
   "keywords": [
     "pi-package",