# DeepSeek「乾坤问道」V2.0

## 2.0.1 修订

- 输入框使用 1.5px 金色边界与聚焦环；选中模式使用 2px 边界、底色、侧边金线和「已选」标记。宿主侧栏选中底色同步加深。
- 占卜按钮右侧显示「今日宜」，与签卡共享同一当日数据；午夜或页面重新可见时刷新，窄侧栏省略事项并保留完整悬停提示。
- 八卦转速改由实际模型 effort 驱动，不再受手动视觉模式影响：off 静止；high 空闲 90s、思考 55s；max 空闲 48s、思考 24s。正文、工具、等待确认均暂停；未知 effort 不猜测转速，动效关闭和系统减少动态效果优先。
- 兼容只注入 `useSession`、不直接提供 `session` 的宿主槽位，避免运行状态丢失。
- 敕令增加符纹描边、金环、轻浮动与八枚粒子，生命周期改为 2400ms；关闭动效时仅静态短暂出现，正常清理。
- 10 项状态/DOM 测试通过，包括外部模型切换、不依赖视觉模式的转速、hook-only 宿主、输入框边界、已选标记、宜事项一致性、敕令出现与定时卸载。当前环境没有可用的浏览器控制工具，本次未重新进行浏览器动画截图核验，也未安装到实际 DSH。

以下为 V2.0 的基础设计与首次验证记录；转速和敕令时长以上述修订为准。

保留 DSH 工作区、聊天、模型选择器与输入框的布局和行为。皮肤通过原有 Cordis Client 槽位增量注册，运行时仍然只有 `client.js`，不替换宿主聊天组件，也不访问外部图片 CDN。

## 已实现

| 方案 | 实现 |
| --- | --- |
| 纸墨金基础 | 宣纸白 `#F8F5EE`、香槟金 `#B58A43`、墨紫黑 `#383344`、灰紫 `#766D7C`、朱砂 `#A64B3C`；沿用宿主深浅主题语义令牌 |
| 输入区 | 使用宿主真实的 `[data-composer-card]`，细金边框和柔和阴影；只在推理阶段呼吸 |
| 装饰 | 左侧低对比度书法、右上独立八卦与太极、底部渐隐水墨；按侧栏实际宽度定位山水，窗口缩放和折叠侧栏时跟随 |
| 三档 | 淡雅·浅思 / 平衡·深思 / 沉浸·悟道；在输入工具栏中打开设置 |
| 真实推理绑定 | 可选连接宿主 `modelDirectories`，读取当前模型公开的 effort 列表，通过它的 `select()` 提交真实档位；提交失败不更新视觉选中态 |
| 思考可视化 | 读取输入槽位提供的 `session.running`、`partial.blocks`、`runningCalls` 和 `pending`；推理时增强，工具执行/等待确认时安静，正文开始后锁定收敛直到本轮结束 |
| 每日卦象 | 右下起卦 → 中央显卦 → 解卦 → 收签 → 右下小签；可以重开小签、关闭小签，也可完全关闭此功能 |
| 开场 | 4.2 秒混沌、太极、八卦、归一四阶段；同一 renderer 会话仅首次出现，刷新或新建会话不重播；支持主动重看、Esc/Enter/点击跳过 |
| 可访问性 | 设置和签卡支持 Tab 焦点约束、Esc 与关闭后的焦点恢复；窄屏可通过设置内的「今日一卦」使用卦象，不依赖装饰性的品牌位 |
| 动效开关 | 手动关闭主题动效会停止旋转、呼吸、位移和发送闪屏；系统减少动态效果偏好优先，开场不播放 |

## 推理参数边界

只映射明确识别的公开语义 ID。DeepSeek 的 `off / high / max` 分别对应三档；只有 `off / high` 时，沉浸沿用 `high`，并明确标注「视觉沉浸」。未知的厂商自定义 ID 不按数组顺序猜测强弱，保留为视觉模式。模型目录未提供、加载失败或当前为不可选择的子会话时，整个皮肤仍可使用，不强制依赖模型选择插件。

「跟随实际模型档位」仅跟随真实选择，不推测任务复杂度。手动选择并成功提交真实档位后保持跟随；用户也可关闭「切换时同步模型推理」只改外观。所有推理参数仍由宿主校验，皮肤不直接修改模型配置文件。

会话实时信号来自本机 DSH 源码中的 `ConversationSnapshot` / `InputZone` 合约，模型集成复用 `ui-model-selection` 的 `ModelDirectoryResolver` / `ModelDirectory`。较旧宿主若没有这些字段，视觉安全退回空闲，不使用 DOM 文案猜测模型是否在思考。

首次开场以 `sessionStorage` 代表 renderer 会话边界；插件没有 Electron 主进程冷启动事件，因此不能保证恢复窗口时等同于一次全新进程启动。设置中的「重看开场」始终可用（关闭动效或系统减少动态效果时禁用）。

## 文件与开发

- `src/client.js`：保留的原版令牌、太极/八卦/签文与槽位入口；修正八卦太极双鱼眼颜色，补充紧凑水印规格。
- `src/qiankun.js`：真实模型连接、偏好、状态订阅、设置、卦象和开场。

设置弹层在 `shell.overlay` 独立注册，避免输入框祖先的定位或裁切影响全屏范围；工具栏只渲染选择器触发入口。
- `src/state.mjs`：可测试的档位映射、状态判定与配置校验。
- `src/qiankun.css`：V2 样式与动效；中文正文/按钮保持真实 DOM。
- `assets/ink-landscape.webp`：内置 image_gen 生成的 1672 × 941 水墨背景，约 66.8 KiB；来源与完整提示词见 `assets/GENERATION.md`。
- `scripts/build.mjs`：把以上源码、样式和 WebP 打包成独立 `client.js`。请修改 `src/` 后构建，避免直接编辑生成文件。
- `preview/`：复用真实插件工厂与槽位的仿宿主外壳。模型目录和输出为测试夹具，不调用真实模型；侧栏、标题和头像只用于演示，不会写入宿主。

```sh
npm ci
npm run build
npm run check
npm test
npm run preview
```

预览地址 `http://127.0.0.1:4173`。左下角齿轮打开仿宿主测试控制，可验证三档/两档/未知模型目录、切换失败、运行/输出/工具/等待状态、深浅主题和长文本代码表格布局。测试控制不随插件发布。

## 验证范围

7 项状态与映射测试通过。内置浏览器验证了真实插件组件在仿宿主中的三档同步、两档说明、提交失败、正文收敛、完整卦象、Tab/Esc、手动关闭、偏好保存、开场重播/跳过与不重复播放、原有回车发送和 Shift+Enter；检查了 1440 × 900 和 390 × 844、浅色/深色、正文/代码/表格。截图与对照图在 `output/`，设计核验记录见 `design-qa.md`。

尚未安装到实际 DSH Desktop，因此宿主运行时的叠层、槽位注入时序和模型 RPC 仍需安装验证。系统减少动态效果已有响应式实现，本轮未修改操作系统偏好来实测。保留原版发送按钮 CSS，其对停止按钮的识别依赖宿主图标/类名，未改动宿主发送和停止逻辑。

## 安装与回退

仓库根目录仍是可安装 bundle，安装方式沿用 README。版本升为 2.0.0。未修改本机 DSH profile；代码版本以 GitHub 提交记录为准。

原始基础提交是 `045504b`（1.4.0）。V2 的全部源码与素材保存在本地；需要回退时可恢复该提交的已跟踪文件，并删除本次新增文件。工作区中有其他修改时应先分别保存，避免无差别清理。