# 机制与详细设置

日常安装与操作见 [README](../README.md)，数据流向与清除方式见[数据与隐私](privacy.md)。本文保留关系进度、任务感知、角色设定和 CG 的具体规则。

## 好感度与关系进度

每个角色都从 Lv.1、0 点好感开始，状态彼此独立。亲近、普通、疏离三个回复选项分别结算 +1、0、-1，位置每轮随机；也可以自由输入，由轻量关键词规则结算。

插件运行期间，从所有工作区新观察到的 Harness `assistant/message` usage 事件会进入同一份全局 token 余额。输入与输出 token 每累计 5,000 个，结算时当前角色增加 1 点；每次结算最多兑换 3 点，余量继续保留。插件自身发起的模型调用不计入，也不回算插件启动前的历史 usage。

未活动的前 24 小时为宽限期，之后所有角色按每天 2 点衰减，最低为 0。实现按 `floor((未活动天数 - 1) × 2)` 计算本次衰减，并更新全局活动时间；关系活动时间采用 6 小时间隔的心跳更新，避免不同工作区重复结算同一段离开时间。

升级阈值为 `30 + 15 × (Lv - 1)`，即 30、45、60……。达到阈值后升级，超出部分保留到下一级，等级不设上限。角色语气随关系进度分为五档，Lv.5 后保持最高亲昵档。

普通对话的升级会尝试生成特殊 CG，成功生成需要可用的 DashScope key。小剧场结算中的升级会保留等级变化，但跳过自动 CG；该场合影由用户从小剧场记录中手动生成。

## Harness 任务事件

### 深海工坊地图的实时状态

Galgame 顶栏“工坊地图”在当前 Galgame 内打开俯视像素地图，宿舍根据 Harness 已接入的模型系列自动增减；只接入 DeepSeek 就只有一间宿舍，同系列不同版本共用一间。每排最多三间，超过三间自动增加第二排；公共工作区、茶水休息室和海底观景室保持可用。点击小人或名单会固定对应出场角色并进入单人 Galgame，保留回复模型设置及尚未结束的小剧场；“继续小剧场”可回到原场景。

地图使用独立的只读 `map-state` 接口，在可见时约每 2.5 秒查询一次。后台约每 15 秒更新已注册的可对话模型目录，按模型系列去重；有安全凭据描述能力时，明确未配置凭据的路由不会创建宿舍。只读取脱敏设置与 `configured` 布尔状态，不读取密钥值，不发送测试推理请求。模型目录读取失败时保留上次确认的住户，明确移除模型或提供商后再移除对应房间。

工作状态来自当前 Harness 进程的实时 Session 与可选 Agent 注册表，按实际请求的 provider/model 识别角色，包括其他工作区与子 Agent；这与下文用于对话话题的顶层任务类别采集范围不同。一个模型的多个任务合并到同一角色，显示任务数量；计算中的任务优先显示工作，只有等待提问或审批时显示等待确认。未知模型不归给任意角色。进程恢复或继承的未关闭历史轮次不作为正在工作的依据。

导航采用 48px 正交网格，路线穿门通行。六个主题宿舍分别参考各角色内置视觉小说背景，保留各自的家具、窗饰、配色和标志物，并加入床铺与收纳：DeepSeek 的蓝金宫殿、Claude 的暖木写作书房、GPT 的绿色协作工作坊、Gemini 的蓝紫双棱镜工坊、Kimi 的中式月夜书房和 Grok 的机械工具工坊。DeepSeek 参考深海宫殿（现为可选背景），地图主题不随默认背景变化，也不跟随用户上传背景重新生成。

主题宿舍以及公共工作区、茶水休息室、海底观景室与回廊采用完整重绘的背景，保留床铺、书架、桌椅、地毯和摆设，不把房间拆成家具贴片。专属工位布置在工作区室内地板上。整张地图是深海中的一栋建筑：宿舍排成一排，门都开向同一条主回廊，回廊下方是居中的工作区，茶水休息室和海底观景室分列两侧；建筑有连续的外墙和黄铜包边，外面是深海。回廊铺一条长地毯并分支通到每扇门。装饰图集提供盆栽、花台、落地灯、书柜、长凳和天球仪，全部靠回廊北墙摆放：相邻宿舍之间的墙垛前各一盏落地灯，宿舍一排两侧的空墙前分别是休息角和书架角；整组放不下时整组省略，布置时避开门口与通路。地图场景不显示房名或人物姓名，侧栏“工坊里的她们”继续提供角色名单、实时状态和选择入口。

所有地图场景均不含电脑或显示屏；Gemini 原参考图中的屏幕转译为画板、卡册和棱镜。当前地图背景、人物、工位与室外装饰图集均由 Codex 内置绘图制作，工具未暴露具体模型版本。

工作区独立扩大，每个工位为 192 × 192。路线脚点在桌子南侧地面，到达后切换为人物与桌椅合成的入座动作，桌面自然遮住下半身。六位角色各有三帧循环与一帧等待状态：大肥鱼做潮汐推演、Claude 羽笔校稿、GPT 圆规制图、Gemini 棱镜译码、Kimi 月卷归档、Grok 机械检修。工作结束后角色回到宿舍，再到公共区域散步、喝茶或看海。首次打开地图时，正在工作的角色直接显示在工位。

闲逛与路径动画完全在浏览器内运行，不调用 LLM、不结算好感度、不写入存档；隐藏页签暂停轮询与动画。暂停散步时办公动画与位置同时冻结，工作状态继续同步；开启系统减少动态效果时只更新目标位置。

停在宿舍或公共区休息时，每位角色做自己的休闲动作：大肥鱼抱着钢盆吃大白饭，克洛德看书批注，小吉双手捧起一团微型银河端详，双子用魔法凝出水晶，月见用望远镜观星，洛可挥斧。动作共四帧，从她停下的那一刻起播，播完定在收尾姿势约 3 秒再重复；刚打开地图时六人依次起手，相隔约 0.6 秒。暂停散步时动作定格在当前帧；开启系统减少动态效果时只静止显示收尾姿势。走动用行走图，到工位后用工位图；忙碌但还没走到工位、又没有在走时站立，名单里的小头像也始终是站姿。行走图或休闲图加载失败时退回站姿，地图照常可用。人物图集只使用第 1 行站姿，第 2～4 行是已停用的旧行走与读写帧（其中洛可那一格有三只手的画错），文件保持不变。锚点与绘制比例的算法见[庄园美术清单](../assets/workshop/README.md)。

### 对话话题中的任务类别

插件按事件来源的工作区采集顶层 Harness 会话，排除子 Agent 会话与继承的历史事件。优先读取实时会话；查询已保存会话时，最多选取 16 个候选，优先当前绑定会话，其余按创建时间排序。每个会话只扫描末尾 240 条事件，任务分类结果仅保留最近 72 小时的活动。

这里的 16 是已保存会话查询的候选上限；实时会话遍历没有同样的数量限制。72 小时限制应用于任务轮次的活动时间，并非只读取最近 72 小时内创建的会话。

本地、确定性规则将任务归为代码调试、代码开发、文档总结、文档写作、文学创作、资料调研、数据分析、视觉设计、演示文稿、翻译校对或任务规划，再将分类结果合并到全局事件队列。本地文本分类只使用真人明确提交的 `user/message` 正文，可参考工具名与轮次结束状态；不提取工具参数、工具结果或 assistant 正文，也不打开工作区文件读取内容。

只有固定的任务类别与状态提示会作为 Harness 工作上下文发给 Galgame 回复模型和 CG 生成服务。AI娘在回应当前话题时可以自然带到一句关心，例如代码调试后提醒你不要熬夜。每个角色的已消费事件指纹与最近提及时间保存在全局状态中：同一事件不会因切换工作区而再次向同一角色主动提起，不同事件之间至少间隔 30 分钟。任务事件只影响话题，不直接增减好感度。

普通对话和小剧场还会获得本地日期、时段及距离上次对话的时间提示。时间间隔优先来自该角色的对话时间戳，缺少时参考记录的上次活动时间。

## 角色、模型与存档连续性

显示角色与回复模型分别选择。角色可以跟随工作区模型或手动固定；回复可以使用插件默认的 `deepseek-v4-flash`、跟随工作区，或从 DSH 模型目录选择。

六个角色各自保存好感度、等级、角色设定、聊天记录、回复选项、已消费任务记忆、自定义立绘与 CG 图鉴，并在工作区之间全局共享。当前角色、token 结算余额与插件偏好也连续保留。新工作区沿用这些状态，工作区和会话仅用于定位事件来源与采集去重。

### 自定义角色设定

在 Galgame 顶栏点击“个性化 → 角色设定”，编辑当前角色的昵称、对用户的称呼、首次问候、性格、语气和 CG 外观描述。

“保存设定”或“恢复默认”只修改当前角色的上述六项，不重置好感度与等级、长期记忆或自定义立绘。若该角色尚未开始真实对话，修改或恢复“首次问候”会原位更新当前开场问候，自动生成的登场旁白保持不变；一旦已有用户或角色对话，就不再插入、替换或重播历史。CG 外观描述用于之后生成的 CG，不改写图鉴中已经保存的图片。

未自定义称呼的旧存档自动使用新的默认称呼，已自定义的称呼保持原值。大肥鱼未自定义昵称时，各角色时间线里的插件括号旁白与开头名牌、以及小剧场记录里的角色名牌会改用“大肥鱼”；小剧场记录里玩家的名牌与由头改用“你”，用户和角色说过的原话保持不变。

自定义设定仍受插件的安全约束与单句回复限制约束。

### 内置角色风格

克洛德（Claude）是细心较真的书虫审校者，小吉（GPT）是自信傲娇、爱整理要点的远古白龙娘，洛可（Grok）是嘴快护短、爱玩宇宙梗的吸血鬼小公主。六位 AI娘的默认称呼各不相同：大肥鱼“主人”、克洛德“您”、小吉“小家伙”、双子“旅人”、月见“执笔人”、洛可“老板”，并有各自在工坊里的同伴关系；称呼和风格可以通过角色设定修改。

## 舞台、图片与显示设置

台词有慢、中、快、瞬间四档打字速度。点击台词或按 Space / Enter 可补全整句；小剧场中整句显示后再次操作推进下一句。等待回复时先显示用户刚说的话，并显示角色“正在回应”的提示。在对话框上向上滚动可打开记录，回看角色台词及当时的表情。

按 H 或在背景、立绘处右键可隐藏界面，点击任意处或按 H / Esc 恢复。齿轮中的“显示设置”可选择文艺或系统字体，控制氛围特效、音效、BGM 和音量。文艺字体使用本机已安装字体；音效和 BGM 由 Web Audio 合成，默认均关闭。

背景与立绘换图时交叉淡入，新角色从下方滑入，立绘带有待机呼吸动画。表情根据角色自己的回复判断，没有表情差分时使用情绪气泡与动作。小剧场中说话的角色会轻跳，名牌带有指向角色的小尾巴；好感变化时飘出“♡±N”，升级时播放全屏演出。对话框使用黄铜与深海风格及角色专属强调色，背景有粒子与水纹光影，矮窗口和窄屏下会为角色的脸留出空间。

背景和立绘支持 PNG、JPEG、WebP、AVIF，浏览器端单个文件上限为 12 MB。切换角色时同步切换对应内置背景：大肥鱼默认使用海边书房，`palace-night.webp` 深海宫殿是内置可选替代；其余五位使用各自背景。用户上传的背景或保存为背景的 CG 是全局覆盖项，直到恢复内置背景。

桌宠已内置，新安装默认开启，显示在 DSH 主界面右下角，点击即可打开 `galgame` 标签页。顶栏和插件设置中的桌宠开关保持同步。关闭“启用插件”会隐藏桌宠并暂停对话与好感度结算，存档保留。Desktop 的窗口覆盖层会避让 Windows 自绘标题栏与 macOS 红绿灯按钮。

大肥鱼工作时掏出笔记本打字，等待回话时招手，从工作回到待机后开饭；闲置时按固定顺序偶尔顶铁盆、要饭或打盹。悬停显示笑脸，待机时会按从正上方顺时针每 22.5° 一帧的 16 个朝向看向窗口内的指针，1.1 秒没有指针移动就恢复待机眨眼；看向指针不重置闲置小动作计时，小动作、悬停、拖拽和开饭 / 落地过场优先。按住移动超过 6 CSS 像素可拖拽，松手后停在新位置；聚焦桌宠后，方向键每次移动 16 像素，Shift 加方向键移动 64 像素，Enter / 空格仍可打开 Galgame。位置以视口右、下偏移保存在本机 `whg-pet-position` 中，窗口缩放时会夹回可见范围；插件设置中“显示桌宠”旁的“归位”会清除该位置并返回默认角落。系统开启“减少动态效果”时，各工作状态使用静帧，关闭看向指针、闲置小动作、呼吸与摆动，拖拽仍可使用。

## 小剧场与 CG

小剧场提供角色间日常短剧、工作事件复盘与里程碑剧情，完成的片段归档到“小剧场”记录中，可回看台词。联网取材默认开启；在“设置 → 插件 → 大肥鱼 → 小剧场取材”中选择“只用本地任务类别”可关闭检索。剧情生成仍通过所选模型进行，详见[数据与隐私](privacy.md)。

小剧场中，每位角色提到或直接对玩家说话时使用自己的有效称呼（含自定义值）；玩家发言的姓名牌和记录名统一显示“你”。由头在界面写“你”，在模型提示中写“玩家”。

升级 CG 默认通过 DashScope 的 `qwen-image-3.0` 生成，尺寸为 1920 × 1080。提示由角色 CG 外观描述、升级等级、场景与固定任务类别的视觉线索组成。小剧场合影使用出场角色的外观描述与该场情境，由用户从记录中点击触发。

图像请求只发送文本提示，不上传用户背景或立绘。返回的图片下载为 data URL，连同生成提示、状态及错误信息存入 CG 记录。图鉴可查看图片，也可以将其设为 Galgame 背景。没有可用 key 时，聊天、角色切换、历史、好感度和自定义图片仍可使用。

在启动 DSH 的本地环境中设置 `DASHSCOPE_API_KEY`；环境变量示例见 [README 的使用说明](../README.md#使用)。真实 key 留在本地环境中。

## 美术清单与构建说明

安装包保留 22 项默认美术：六张角色立绘、七张内置背景、八张原始分辨率透明 `whale-*.webp` 表情，以及一张 6 列 × 7 行（2304 × 3584，24 张原动作帧与 16 张朝向帧）的 `pet-dafeiyu.webp` 桌宠动画图集；另内嵌公共区、高清工作区、主题宿舍、角色、三张行走关键帧、休闲动作、专属办公与室外装饰十张图。逐文件用途、来源与改动保留在[默认美术清单](../assets/default/README.md)、[庄园美术清单](../assets/workshop/README.md)和 [NOTICE](../NOTICE.md)，SHA-256 由发布审计清单校验，许可索引见[第三方许可](../THIRD_PARTY_LICENSES.md)。

npm 包只携带内嵌美术的客户端 bundle，不重复收录导出原图或生成图源码。Galgame 布局、对话框、控件与装饰的实现公开在 `src/client/index.ts`，没有额外的未公开 UI 图片包。地图图块与人物动作渲染在 `src/client/workshop-art.ts`，交互和路径分别在 `workshop-map.ts` 与 `workshop-world.ts`。当前公共区使用 1254 × 1254 的 `public-rooms-atlas.png` 四格图集，主题宿舍使用 1536 × 1024 的 `themed-rooms-atlas.png` 六格图集，角色行走图集为 1536 × 1024 透明 PNG，专属办公图集为 1374 × 1145 透明 PNG，新增 `decor-atlas-builtin.png` 为 1536 × 1024 的透明六格装饰图集；来源、提示、像素尺寸与完整性记录见 [`assets/workshop/README.md`](../assets/workshop/README.md)。这五张图集随客户端 bundle 内嵌，不需运行时下载。旧 `manor-atlas-image26.png` 及其生成记录仅保留在源码历史素材中，不再作为当前运行图内嵌。README Logo 说明见 [`docs/brand/README.md`](brand/README.md)。

`lib/`、`src/client/art.generated.ts` 和 `src/client/workshop.generated.ts` 是不提交的构建产物。`prepare` 在源码安装时嵌入默认美术与庄园图集后执行 `tsdown`；克隆后执行 `npm install` 可在本地生成。`npm run sanitize:backgrounds` 剥离六张角色背景的非画面 WebP 元数据，`npm run embed:art` 将白名单原图与校验后的庄园素材写入运行时，`npm run export:art` 反向导出原有 22 项默认美术以供核对。
