项目定位

velvet-ascent 是一个面向支持 skills 的 AI Agent 的中文成人向文字游戏 GM skill。它把 AI 对话变成一个更自由的文字版后宫养成 GalGame：玩家可以用自然语言指定世界观、主角身份、人物关系、剧情尺度、角色性癖（XP）、后宫养成节奏、行动路线和长期记忆方式。

它追求的是"为性癖服务的自然升温"——前期以吸引力、机缘、情绪铺垫和关系暗流为主，每个回合都让"欲望维度"显性化；中期让玩家选择推动人物关系和后宫格局；后期在已有伏笔上展开更强的剧情张力、角色专属的性癖反应、关系竞争、路线压力。新版设计强调单时间线推进、欲望图谱、后宫养成 6 阶段、角色差异化矩阵、NSFW 0-4 档位 × 阶段双重约束和后台文档整理，避免长对话后剧情乱线和"调性过于清水"。

核心能力

| 能力 | 说明 | |---|---| | 后宫养成 | 主角多线推进，每名角色按 6 阶段（路人→吸引→试探→暧昧→亲密→入后宫）独立养成，后宫格局自然形成。 | | 欲望图谱 | 每个角色对其他角色有独立的"欲望立场"和 4 级"显性度"（潜意识→情绪感知→主动承认→公开展示），是 NSFW 推进的结构化依据。 | | 角色差异化矩阵 | 每个角色在 6 维（性癖组合/性互动人格/欲望立场/场景偏好/触发器/关系阻力源）上有唯一指纹，避免后宫 NSFW 场景的模板化。 | | 角色性癖（XP）| 每名角色有 3-5 项具体癖好（命令/被命令/被看着/被吻/言语挑逗……），每项配可观察的"反应序列"，对话与动作中可追溯。 | | 自然升温 | 前期温和铺垫，中后期根据选择、关系和阶段自然增强张力；长线形成"铺-爽-铺-爽"的呼吸感。 | | 高自由回合制 | 支持选项推进，也支持玩家随时输入自定义行动。 | | 成人向互动剧情 | 类似自由 GalGame，以成年角色、关系推进和剧情后果为核心。 | | NSFW 档位 × 阶段 | 档位 0-4（欲望萌芽/身体自觉/直接接触/完整场景/高强度场景）× 养成阶段（路人→入后宫）双重约束，档位可写上限 = min(用户设定, 阶段上限)。 | | 单时间线推进 | 每回合沿当前时间、地点和场景目标推进，场景扰动不再无关跳线。 | | 女性向入口 | 可切换女性向剧情，以女生视角的感官与心理细腻性为核心（触觉优先/视觉/听觉/心理/主动权 5 维），女主主动权始终在场。 | | 关系网追踪 | 维护 NPC 动机、好感、信任、竞争、误会、承诺和隐藏伏笔。 | | 后台多文档记忆 | 8 文件工作区（00-游戏圣经 / 01-主角 / 02-人物卡 / 03-关系网 / 04-线索 / 05-时间线 / 06-欲望图谱 / 07-后宫状态），10 步后台更新协议。 | | 小说导出 | 将完整游戏过程整理为连续小说草稿，保留主线、关系变化和结局。 | | npx 安装 | 通过 npm 发布，一条命令安装到本地 skills 目录。 |

后宫养成与黄色爽文

velvet-ascent 的男性向默认主轴是后宫养成——多女角色同时推进，每人有独立的"入后宫"路径，中间允许爱恨情仇、嫉妒、误会、背叛等剧情钩子，但所有叙事都服务于"更好地发生肉体关系"这一目标导向，同时保留合理性约束（角色动机 + 场景物理 + 关系阶段 + 后宫格局四重约束）。

黄色爽文在这里不等于无脑堆料——它意味着：

• 主角魅力 / 地位 / 资源 / 主动性带来后宫格局的真实变化
• 每回合的"欲望维度注记"让 NSFW 推进有结构化依据
• 角色有自己的欲望、主动性、拒绝、嫉妒、反弹——她们不是为了主角存在
• 长线形成"铺垫 → 爽点爆发 → 铺垫 → 爽点爆发"的呼吸感
• 单时间线推进，避免"为了 NSFW 而强行推进"的乱线

女性向同步重设：以女生视角的感官与心理细腻性为核心（触觉优先 / 视觉与凝视 / 听觉 / 心理 / 主动权 5 维），女主的主动权始终在场。

安装

npx @ruizhefeng/velvet-ascent-skill

默认安装到：

~/.agents/skills/velvet-ascent

如果你的 Agent 客户端使用不同的 skills 目录，可以指定安装路径：

npx @ruizhefeng/velvet-ascent-skill --target C:\Users\YourName\.agents\skills

安装后如果 Agent 没有立刻识别到 skill，重启客户端或重新加载 skills。

快速开始

开局时，GM 应先提醒可开启功能，并在第一幕前确认本局已启用配置。尤其是文档记忆、阶段整理和小说导出，不应等用户自己猜到才出现。

【可开启功能】
- 文档记忆：每回合后台保存人物、关系、时间线和伏笔。
- 阶段整理：每 4-6 回合或阶段节点整理成章节。
- 小说导出：游戏结束或阶段完成后整理为连续小说草稿。
- 尺度控制：可随时提高/降低尺度，或设置 NSFW 档位 0-4。
- 角色锁定：可锁定角色性格、XP/偏好、边界、说话方式和着装记忆点。
- 时间线修复：剧情跳线或关系混乱时回到稳定节点整理。

【本局已启用】
NSFW档位：...
记忆模式：...
整理策略：...
角色定制：...
时间线：单时间线推进

现代都市自然流：

开一个现代都市题材的自然流YY文字游戏，主角普通青年，想要爽文方向，但开局要温和自然一点。

带 NSFW 档位和角色偏好：

开一个现代都市成人向 GalGame，NSFW 档位 3，主角普通青年但有隐藏魅力。
初始女主可以系统生成，但每个人都要有明显性格、XP偏好、关系阻力和着装记忆点。
剧情按单时间线推进，不要并行跳线。

玄幻宗门成长线：

主题玄幻宗门，主角是刚入门的外门弟子。我要高度自由，后期可以有后宫争宠，但前几回合先从吸引力和机缘开始。

女性向入口：

开启女性向剧情。背景是娱乐圈，女主是刚翻红的演员，给我 3 个成年男性角色路线，强调情绪张力、主动试探和关系竞争。

长期剧情记忆：

开启文档记忆模式。以后每回合都帮我整理故事文档，人物关系别忘。当前游戏结束后我要导出成完整小说。

回合体验

每个普通回合会围绕当前身份、状态变化、核心事件、随机事件和行动选项展开： 每个普通回合会围绕当前时间、地点、场景目标、主线推进、场景扰动和行动选项展开：

【标题】
当前身份：普通青年·异变初醒
当前时间：周五傍晚
当前地点：公寓电梯
当前场景目标：处理与女邻居的第一次明显试探

【当前状态】
魅力：略有提升 | 声望：平静日常 | NSFW档位：2 | 阶段：关系升温

【主线推进】
你在电梯里遇到那位熟悉的女邻居。她注意到你今天的变化，语气比往常多了一点柔和和试探，但仍保持着惯常的克制。

【场景扰动】
电梯忽然停在 12 楼。门外有人按错了楼层又匆匆离开，短暂的停顿让她原本想说的话卡在半途。

【关系/状态变化】
林晚晴：好奇 +1，试探 +1

【行动选项】
1. 和女邻居多聊几句，试探她今天的态度。
2. 主动帮新邻居搬行李，留下自然可靠的印象。
3. 回房间研究身体和精神变化。
4. 自定义行动：...

游戏内命令

| 命令 | 作用 | |---|---| | 查看系统面板 | 查看主角状态、阶段和关键属性。 | | 查看关系网 | 查看当前重要 NPC 的关系状态。 | | 查看后宫状态 | 在关系自然形成后查看多线关系局势。 | | 提高尺度 / 降低尺度 | 调整剧情强度和表达直白程度。 | | 设置NSFW档位：0-4 | 设置成人向表达上限。 | | 开启女性向剧情 | 切换到女性向剧情入口和关系推进逻辑。 | | 锁定角色设定：... | 固定角色性格、说话方式、着装记忆点或关系阻力。 | | 设置角色XP：... | 设置或修正某角色的偏好、边界和主动方式。 | | 阶段总结 | 总结近期关系、能力、冲突和下一阶段方向。 | | 保存本回合 | 保存当前回合记录。 | | 整理故事文档 | 更新世界观、人物、关系和伏笔文档。 | | 导出小说 | 将游戏过程整理为连续小说草稿。 | | 自定义行动：... | 执行玩家自定义行动。 | | 修复时间线 | 当剧情跳线或关系混乱时，回到稳定节点整理事实。 |

文档记忆系统

开启文档记忆后，skill 会按职责拆分故事资料，避免长期游戏中人物关系和伏笔被遗忘：

velvet-ascent-runs/
  <game-slug>/
    00-game-bible.md
    01-protagonist.md
    02-character-ledger.md
    03-relationship-web.md
    04-plot-threads.md
    05-timeline.md
    turns/
      turn-001.md
      turn-002.md
    chapters/
      chapter-001.md
    exports/
      novel-draft.md

文档记忆不会默认假装开启。开局时 GM 应明确展示当前是“临时游玩”还是“文档记忆”，并说明是否启用每回合后台保存、阶段整理和最终小说导出。开启后，文档整理默认放在后台完成；主线剧情不会因为存档而被大段打断，除非你明确要求查看文档内容。

Skill 设计结构

SKILL.md 只保留核心调度协议，长规则拆到 references/，让 Agent 按场景加载：

references/
├── narrative-engine.md   # 单时间线、场景扰动、选项、时间线修复
├── character-engine.md   # 人物卡、XP/偏好、着装锚点、对话和关系推进
├── nsfw-style-guide.md   # NSFW档位、成人向节奏、女性向入口和安全边界
└── memory-system.md      # 文档工作区、后台保存、上下文漂移提醒、小说导出

适用场景

• 想让支持 skills 的 AI Agent 长期扮演中文文字游戏 GM。
• 想玩自由度高、回合推进、选择影响后续剧情的文字冒险。
• 想创建成人向、GalGame 风格、但比固定选项游戏更自由的 AI 对话剧情。
• 想让故事具备人物记忆、关系连续性和最终小说导出能力。
• 想让角色有稳定的性格、XP/偏好、说话风格和服装记忆点。
• 想长线游玩时减少时间线混乱、人物关系遗忘和伏笔丢失。

不适合

• 只想要一次性短篇故事。
• 不需要持续状态、人物关系或多回合推进。
• 想跳过铺垫，直接生成无上下文的极端内容。
• 想要不受成年、自愿、边界限制的内容。
• 想要单女主纯爱（这是后宫养成向，不是单一角色深度情感向）。
• 想要写实主义或严肃文学风格的成人内容（这是 GalGame 引擎，不是文学创作工具）。

仓库结构

.
├── SKILL.md              # skill 元数据和运行规则
├── bin/install.js        # npx 安装器
├── assets/               # README 封面和可选素材
├── references/           # 长参考文档目录
├── scripts/              # 可选辅助脚本目录
├── evals/evals.json      # 开发测试用例，不随 npm 包安装
├── package.json          # npm 包元数据
├── README.md             # 项目说明
└── LICENSE               # MIT 许可证

本地开发

验证安装器：

node bin\install.js --help
node bin\install.js --target .\tmp-skills

预览 npm 发布内容：

npm pack --dry-run

evals/ 目录用于开发测试，不会包含在最终 npm 安装包里。

发布

更新 package.json 里的版本号后发布：

npm publish --access public

如果 npm 要求双因素认证，按终端提示完成浏览器验证或输入 OTP。

内容边界

这个 skill 面向虚构的成人文字冒险。它强调自然推进、成年角色、合意互动和故事后果，不用于生成未成年、非自愿、剥削性或违法性内容。

License

MIT