v10.2.1 · 原著 txt 智能读取 + 简介补触发场景

interactive-fiction-skill v10.2.1 · 原著 txt 智能读取

一个 skill 达到收费平台的体验 —— 把原著 txt 交给它，长篇设定自己记得住、对得上。

📖 原著 txt 智能读取（核心）

• 原著 txt（文件或直接粘贴）先落盘再处理：自动识别编码（UTF-8 / GBK / UTF-16）、切分章与卷，出一张「接入卡」（章数 / 字数 / 卷数 / 角色候选榜）
• 大文件先建索引再分层采样：开篇 + 各卷首章 + 世界观密度章 + 均匀抽样，主角与重要配角按出场密度定点深采 —— 正文不进上下文，只进结论
• 5 万字以内直接通读；百万字长篇也不必重读全文：原文、索引与原著时间线留在 source/，剧情中一句「查第 N 章」即可定位对照
• 覆盖 7 阶段蒸馏的取材环节，产物与作品名检索路径完全一致（世界观 6 维 / 角色五维 / 主线大纲），可随时补传原文做深蒸馏

🧭 原著锚定更准

• 原著素材统一存放 source/（原文 + 索引 + 时间线），不再散落在工作目录
• 比对时机改为「场景切换 / 进入新章节 / 主动查询」，每 10 个存档兜底一次，输出简短偏差报告（一致 / 偏差项 / 建议推进方向）

📇 简介补使用场景

• SKILL.md 的 description 在能力描述之后补上「什么时候该用它」与常用唤起说法（「加载小说包」「开个互动小说」「选项小说」「互动故事」）——只读简介做匹配的 AI 客户端同样能认出该在何时启用本 skill

🕐 存储位置更省心

• 小说数据按宿主环境取存储根：手机端落 /sdcard/Download/Operit/novels/，桌面端落 ~/novels/，环境变量与 --root 仍可覆盖
• 技能目录与数据目录分开存放，升级或重装技能不影响已有存档

📐 工程

• 新增 scripts/txt_prep.py（纯标准库）：scan 建索引 ／ slice 按章节、行范围、关键词取窗口；索引丢失可随时重建
• 单元测试 73 → 100 个（新增 27 用例）；六类门禁全过，MANIFEST 62 文件
• 发布包补入 MANIFEST.json（历次 zip 缺失该项，可据此逐文件校验完整性）

完整版本历史见 references/changelog.md。

v10.2.0 · 记忆外置助手 + 世界书式设定检索

interactive-fiction-skill v10.2.0 · 记忆外置助手

脚本记账，模型创作 —— 让长篇故事自己记得住。

📚 世界书式设定检索

• 已落盘的世界观（worldbuilding/）与角色卡（characters/）相关时自动进入每轮简报（[设定] 段）：命中才出现，无关的一行不占
• 长篇几万字后设定依然在场，又不会反复占据上下文；无命中时简报与此前逐字一致

🧠 长篇更省心

• 新增可选的记忆外置助手（scripts/novel.py，纯标准库、零第三方依赖）：brief 记忆简报 / record 每轮记账 / save·load 存档与运行时回填
• 四级记忆简报：[行动] 到期后果 ／ [事实] 长期硬事实 ／ [变化] 近 2 轮增量 ／ [背景] 软状态合并一行
• 背景事项自动褪色：近 2 轮在变化区提示 → 合并为一行 → 6 轮之后静默（--full 可查回）
• 简报读回无副作用：中性书记腔，仅作事实参考，不替作者做叙事决定
• 账本格式零改动，已有存档无缝可用；无 Python 环境时自动退回原有流程，剧情不中断

📐 工程与打磨

• 单元测试扩到 73 用例（test_novel.py 新增至 46）（新增 test_novel.py 29 用例：衰减边界、到期回收、自动记账、存档回填、错误路径）
• 工程门禁：validate.py 六类检查全过 + MANIFEST 57 文件 SHA256 一致 + 六源版本一致
• 修复两个真实问题：[变化] → [背景] 衰减衔接处的一轮静默缝隙；save / load 文件句柄未关闭

🚪 打开就能玩

• 激活指令必先输出启动页菜单（不再依赖模型自觉串联）
• 写作指导文档获得明确加载时机（进入新章节首轮 / 用户要求提升文笔）
• 每轮自检拆为落笔前预判 + 输出后核对；定情后节奏与情感/配角机制去数字化，判断归剧情

🐛 稳定性修复

• 同轮两条到期后果的简报崩溃 ／ 辅助数据损坏导致记账中断 ／ 旧档缺段计数导致后果提醒失效
• 存档名带前缀读不到 ／ close_choices 传字符串假成功 ／ 写入失败重试导致字数双计 ／ 非 UTF-8 设定文件致简报崩溃

🧹 结构与体验精简

• 移除「主题锚点 / 价值两难」机制：剧情方向由你的选择决定，不用预设主题去限制走向
• 角色卡落盘：没有小说项目时不再询问位置（直接存入通用角色卡库），有小说时才给你选
• 随机开局改为真·一键：选中即进入正文，换/改用后续指令即可

📦 安装与升级

# 新装
npx skills add Treasure-hub-agent/interactive-fiction-skill

# 已安装则升级
npx skills update Treasure-hub-agent/interactive-fiction-skill

手动安装：下载发行包覆盖，或增量覆盖变更文件（保留你的存储根目录即可，存档不受影响）。

🔍 兼容性

• 账本 meta/novel_runtime.json 格式未变 —— 旧存档可直接使用，无需迁移
• 记忆外置助手为可选增强（需 Python 3.8+）；不支持则走原有记账流程，技能功能不受影响

完整变更说明：references/changelog.md ／ 发版记录：根目录 CHANGELOG.md

interactive-fiction v10.1.0 — 定情之后 + 文艺感

💗 定情之后，故事仍在继续

情感叙事从「心动 → 暧昧 → 定情」延伸到「定情之后」——日常亲密 / 共同决策 / 冲突 / 和解 四档场景。

• 新增 data/emotion_daily.json（4 档 × 5 词 = 20 词标签池 + 15 触发关键词）
• 双锚定触发：cp{}.stage = "定情" + 关键词命中 → 自动切换定情后语态
• 角色语态四类演变范式（沉淀/释放/震荡/恒定）

📖 长篇不再健忘

• 每章「章摘要」（≤200 字）+ 每 5 章「卷总结」（≤1000 字）
• 新指令：「章回顾」「卷回顾」「第N章讲了什么」
• 摘要可手动校准（generated_by 标记）

🎨 README 文艺感升级

• 全新水墨 Hero 首屏（居中宋体主标 + 诗化引文 + 朱砂印章落款，克制不堆砌）
• 深色主题适配版（GitHub 官方 #gh-dark-mode-only 切换）
• 顶部去重，视觉焦点唯一

🧭 工程

• 标签池切换决策树（emotion / emotion_daily / general 三池互斥）
• validate.py 升级 + 单元测试 4 件套（27 用例全过）
• MANIFEST 55 文件 SHA256 全校验

安装：npx skills add Treasure-hub-agent/interactive-fiction-skill
预览 README：仓库主页

v10.0.0

💗 情感描写强化（核心）

• 新增「情感递进」三阶段：心动 → 暧昧 → 定情，聚焦微表情、视线交汇、潜台词对话与氛围意象
• 内置心动场景示范写法；扩充意象库：潜台词对话、信物、雨天共伞、并肩而行、称谓递进、耳语低音
• 选项标签池升级：温柔靠近 / 克制心动 / 主动试探 / 热烈回应 / 退让留白 / 欲言又止 / 心意暗涌

🧭 指令与玩法完善

• 指令域扩至 16 类：新增场景卡、回顾、回退/重做；查询域新增伏笔/悬念
• 存档支持「加载存档 #N」「删除存档 #N」批量管理；导出支持全量 + md/txt 双格式
• 蒸馏新增「对话试演」模式；穿越开局支持 AI 推荐作品、自动识别已有角色卡
• 沉浸模式指令边界明确；回响核对并入锚定钩子，每 8 段硬核对

📦 工程与体验

• 新增 validate.py 工程门禁：版本一致性、标签去重、文件引用完整性自动校验
• wordcount 补充情感场景区间；schema 全字段中文注释
• VERSION / package.json / MANIFEST.json / SKILL.md frontmatter 全部同步至 10.0.0

v9.4.0

interactive-fiction-skill v9.4.0

AI agent 互动小说创作完整规范：选项驱动的沉浸式剧情体验。

🎭 蒸馏角色功能强化（重点）

• 角色卡新增「存在形态」维度（人类 / 非人 / 化身 / 组织 / 多身份），覆盖神明、人造人、兽耳、福瑞、历史人物等角色
• 新增「信息充足度评估（强制）」：五维逐一标注 高 / 中 / 低 + [待补] 标记，低充足度维度禁止编造
• 新增「冷门配角轻量卡路径」：信息量不足时走轻量卡，可经「补全角色卡」渐进升级为完整五维

🗃️ 数据层外置（实验性）

• 标签词库 / 字数区间 / 指令快速路由 / 随机开局池 从纯文字 prompt 固化为 data/*.json，AI 按需读取，SKILL.md P0 瘦身
• 新增 schema/novel_runtime.schema.json 定义运行时 JSON 格式（含 choices[] 升级字段 + distill），旧存档兼容
• 删除 data/ + schema/ 即回退 v9.3.x

🔄 叙事与体验闭环

• 自由输入优先落地：自由行为 / 台词产生的后果正式记账，按 surface_by 到期正面回收
• 记忆核对三查（设定 / 后果 / 回响）全量接入每轮自检清单
• 随机开局池数据化 + 换批去重「拒绝采样」强制 + 主角模板均匀约束
• 亲密池扩充至 7 项，A/B/C 三节奏组合数提升 4 倍
• 版本号全源统一为 9.4.0

🧹 规范与文档修复（双玩家 30 轮实测 + 8 项专项功能实测驱动）

• 修复 19+ 项：启动页子Agent 配置行 / 切换路线语义 / 断连恢复交叉引用 / 台词转义 / E 标签例外 / 状态条次序 / 「重新开始」归零 / 拒绝后选项池归属 / 铁律#0 双豁免 / 路线互斥 / 世界观引入计字数 / 存档时点快照 等

⚠️ 兼容性：data/ + schema/ 为 v9.4.0 新增，删除即回退 v9.3.x

MIT License

v9.3.0

interactive-fiction-skill v9.3.0

AI agent 互动小说创作规范：选项驱动的沉浸式剧情体验。

特性

• 🔴 铁律 #0 选项机制：每轮正文后强制 A/B/C/D/E 五选项
• 🎭 视角一致性 + 📏 字数区间 + 💾 存档系统 + 🎴 角色卡系统
• 📖 三种模式（主线/沉浸/爽文）+ 🤖 子Agent 生成模式
• 📖 使用指南（发送「帮助」查看全量指令）

v9.3.0 变更

• 性别通用化（视角/命名/规范/示例中性化，随机开局性别等权随机）
• 移除隐藏模式开关与情感门控流程
• 描写规范精简（渐进推进保留三阶段框架）
• 新增使用指南 references/usage-guide.md

MIT License