Nuanskill Infinitynikki Helper

无限暖暖游戏管理 + 奇想手账工具集

概述

本技能为《无限暖暖》(AppID: 3164330) 提供以下能力集：

所有 Steam 操作由 scripts\nuanskill-infi-manager.ps1 统一调度，所有奇想手账操作通过 Chrome（{USER_DATA_DIR}chrome-profile\ 持久化凭据）访问网页完成。

📖 阅读优先级：Agent 首次加载本 Skill 时，按以下顺序阅读：

1. 强制规则（第 10-15 条）→ 阅读后再进行任何操作
2. 意图路由表 → 了解用户意图对应哪个能力
3. references/nuanskill-data-spec.md → 了解数据文件格式与路径
4. references/nuanskill-browser.md → 了解浏览器操作（Chrome 启动、CDP、CF 验证等通用技能）
5. 触发具体任务时 → 前往对应 references/*.md 读取完整执行流程
6. 卡住了？ → 查阅 references/nuanskill-known-issues.md，按能力标签查找对应踩坑

强制规则

以下规则在任何场景下必须遵守，不得跳过或变通。

示例：用户问「日活做完了吗」，只需回答日活状态，不需要附带活跃能量、美鸭梨、周本、登录天数等无关信息。

关联输出例外

以下三类每日清理任务属于关联询问，可一口气给出，不需用户逐一提问：

这三项（朝夕心愿 / 体力 / 美鸭梨挖掘）均为每日上线需清理的内容，Agent 应理解为同一语境下的连续询问，主动一并汇报。
除此之外的数据（周本状态、登录天数、游戏时长、服装数量等）仍遵守第 10 条规则，不主动附带。

用户数据持久化

目录约定

所有用户运行时数据统一存放在 Agent 平台提供的用户数据目录中，Skill 内不硬编码任何平台路径或个人标识。

{USER_DATA_DIR}                             # 由 Agent 平台在运行时注入
├── nuan_profile.json                       # 用户凭据（多子域名分组）
├── nuan_gacha_stats.json                   # 抽卡聚合统计
├── nuan_gacha_history.json                 # 抽卡历史明细
├── nuan_journal.json                       # 奇想手账页面快照
├── nuan_explore.json                       # 探索进度缓存
├── nuan_recharge_history.json              # 氪条消费历史（只增补）
└── chrome-profile\                         # Chrome 持久化 Profile

路径变量：Skill 内统一使用 {USER_DATA_DIR} 代表以上根目录，脚本和文档中均不得硬编码平台路径或用户标识。{USER_DATA_DIR} 的解析规则（各平台对应实际路径、环境变量优先级、回退方案）见 references/nuanskill-data-spec.md 第一节。

浏览器凭据管理

NuanSkill 所有需要浏览器的场景必须使用 {USER_DATA_DIR}chrome-profile\ 持久化 Profile：

• 该目录下的 Cookie/localStorage 由 Chromium 原生管理，不再需要单独导出 cookie JSON
• 与其他 Skill、插件、默认浏览器完全隔离

浏览器凭据优先级：
第一级：{USER_DATA_DIR}chrome-profile\（本 Skill 专用）  ← 默认
   ├─ Chrome 浏览器路径 → --user-data-dir 指向此目录
   ├─ 无 Chrome → Edge / Brave 等 Chromium 内核浏览器 → 同样指向此目录
   └─ 连 Chromium 都没有 → 使用 agent 内置浏览器 → 但仍需将 Cookie 写入 {USER_DATA_DIR}nuan_profile.json
第二级：其他 Skill 的临时凭据                            ← 严禁使用
第三级：用户系统默认 Chrome 凭据                         ← 严禁使用

⚠️ 禁止行为清单（以下为红线）：

• ❌ 严禁使用 --user-data-dir 指向用户系统默认的 Chrome Profile
• ❌ 禁止借用其他 Skill 生成的临时 Cookie/Profile
• ❌ 禁止使用任何浏览器配置工具/命令切换默认 Chrome 用户资料

浏览器降级策略

查找浏览器可执行文件：
├─ Google Chrome（chrome.exe）         ← 首选
├─ Microsoft Edge（msedge.exe）        ← 降级一
├─ Brave / Vivaldi 等 Chromium 内核    ← 降级二
└─ 以上均无 → agent 内置浏览器         ← 最终降级
                                          Cookie 写入 {USER_DATA_DIR}nuan_profile.json

无论使用哪种浏览器，--user-data-dir 必须始终指向 {USER_DATA_DIR}chrome-profile\。

使用规则

初始化逻辑

{USER_DATA_DIR}chrome-profile\ 存在？
├─ 是 → 复用该目录下的 Profile（Cookie/缓存均保留）
└─ 否 → 自动创建该目录 → 查找 Chrome.exe
         ├─ 找到 → 启动 Chrome --user-data-dir="{USER_DATA_DIR}chrome-profile"
         ├─ 未找到 → 查找 Edge.exe → 同样指向该目录
         └─ 均未找到 → 使用 agent 内置浏览器，Cookie 写入 {USER_DATA_DIR}nuan_profile.json

浏览器操作通用技能（Chrome 启动、CDP 连接、CF 验证、Cookie 提取）见：

references/nuanskill-browser.md

持久化方案和数据文件格式见：

references/nuanskill-data-spec.md

意图路由

根据用户输入的关键词，路由到对应能力（各能力细节见 references/ 下对应文档）：

关键：Agent 必须根据「能力」列明确识别当前任务属于哪个能力，然后前往对应的 references/*.md 读取完整执行流程，不得跨能力使用文档或凭记忆操作。

脚本概览

非交互式 / 自动化调用：steamdb-check 用 -NoInteractive 跳过确认，update/skeletonize/restore/lock/unlock 用 -Force（两者不可混用，详见 nuanskill-steamdb-check.md）。未传对应参数时 Read-Host 在非交互式 shell 中返回空串，操作会静默取消。

所有脚本从技能根目录执行，工作目录为 nuanskill-infinitynikki-helper/。

各能力的详细执行流程见对应 references/*.md 文件。意图路由表已标明每个能力对应的参考文档。

错误处理速查

文件清单

nuanskill-infinitynikki-helper/               # 技能根目录（发行版）
├── SKILL.md                                  # 技能主文件（v1.4.0）
├── CHANGELOG.md                               # 完整版本历史
├── README.md                                 # 项目说明与更新日志
├── icon.png                                  # 应用图标
├── scripts/
│   ├── nuanskill-infi-manager.ps1            # Steam 全功能管理脚本
│   ├── nuanskill-gacha-lookup.ps1            # 抽卡套装查询脚本
│   └── nuanskill-time-calc.ps1               # 体力回满/挖掘时间计算脚本
├── references/
│   ├── nuanskill-browser.md                  # 浏览器操作通用参考（Chrome/CDP/CF/Cookie）
│   ├── nuanskill-steamdb-check.md            # SteamDB 检测完整执行流程
│   ├── nuanskill-journal-monitor.md          # 奇想手账日程监控执行流程
│   ├── nuanskill-gacha-query.md              # 奇想手账抽卡查询执行流程
│   ├── nuanskill-explore-overview.md         # 奇想手账探索总览执行流程
│   ├── nuanskill-known-issues.md             # 已知问题与踩坑记录
│   ├── nuanskill-steamdb-assets.md            # Steam 商店资源下载（能力①子技能）
│   ├── nuanskill-data-spec.md                 # 数据文件规范（格式 + 持久化方案）
│   ├── nuanskill-schedule-templates.md       # 定时任务配置模板
│   ├── nuanskill-game-knowledge.md           # 无限暖暖游戏常识参考
│   └── nuanskill-public-query.md            # 公开信息查询（兑换码 + 氪条）

工作目录说明：技能根目录（包含 SKILL.md 的文件夹）即为开发/发行共用目录，所有路径引用均以技能根目录为相对起点。

用户数据：{USER_DATA_DIR} 由 Agent 平台在运行时注入，Skill 内不存储用户数据。详情见 references/nuanskill-data-spec.md。

数据文件格式规范

所有数据文件的精确字段结构、写入规则和目录约定统一由 references/nuanskill-data-spec.md 定义。Agent 写入任何文件时，必须先查阅该文档，不得凭记忆写入。

定时任务配置模板

两个内置定时任务模板（每日监控 + 每月抽卡更新）详见：

references/nuanskill-schedule-templates.md

Agent 在用户请求设置定时任务时先查阅该文档，按模板话术引导用户配置。

版本历史

完整版本历史见 CHANGELOG.md。

当前版本：v1.4.0（2026-06-28）。查看所有历史版本请参阅 CHANGELOG.md。