dsh-skin-asuka-p01

Readme

# 明日香 · 绯色天际

`dsh-skin-asuka-p01` 为 DeepSeek Harness 提供精绘双人物、城市穹顶日夜场景、酒红金饰框架和清晰的阅读卡片。

当前版本 **0.5.0**，面向 **DeepSeek Harness 0.1.7-rc.2** 的桌面渲染界面。本包声明了该宿主版本的兼容范围；0.1.5-rc.2 请继续使用旧的 0.4.1 构建产物。

## 0.5.0 新版桌面适配

0.4.1 依赖的 `settingsScope` 和 `settings.register` 已从新宿主移除。隔离环境中已复现旧包在 0.1.7-rc.2 启动时出现 `pending (waiting for service: settingsScope)`；本次改为新版 `Config`、可实时修改的配置字段及 `configForms`。

- **设置可用**：五项主题偏好继续提供草稿、保存、恢复默认和跨窗口冲突提示；明确处理宿主拒绝写入的结果。
- **窗口顶部**：复用 macOS 原生顶栏预留空间，避免与皮肤额外留白叠加；常驻会话标题栏恢复清晰的酒红底与浅色文字。
- **账号菜单**：适配新版账号／“更多”入口，保留头像、设置、反馈等原生菜单行为。
- **工作过程分组**：为新分组摘要提供实色背景；折叠内容不再被外层阅读留白撑开，组内工具记录保持紧凑。
- **代码操作**：保留新版代码块的原生换行开关，不再用皮肤样式强制关闭换行。
- **内容宽度**：适配宽度变量的新位置，阅读列默认最大920px，欢迎页输入框最大800px，会话输入框与阅读列对齐；宿主拖动调宽继续有效。
- **字号一致**：正文和输入框与“通用设置”的字号一致，不再额外增加2px。舒适阅读可在通用设置选择16px。过程文字及代码继续按宿主字号缩放。
- **设置布局**：保存、关闭等操作移到整行操作区，并在设置内容滚动时保持可见。

人物、背景、暖白阅读面、差异代码的深绿／暗红配色及深色对应配色继续沿用。装饰不接管会话、模型、工具或权限行为。

## 安装到桌面端

1. 确认 DeepSeek Harness 的版本为 **0.1.7-rc.2**。
2. 打开侧栏 **插件 → 添加插件**。
3. 填入本机安装包的绝对路径，例如 `/绝对路径/dsh-skin-asuka-p01-0.5.0.tgz`。
4. 完成安装，按界面提示选择 **立即启用**，随后重启应用以完整重新加载插件组合。
5. 从左下角账号／**更多 → 设置 → 明日香 P01** 打开主题设置。

本项目生成的安装包位于：

```text
dist/dsh-skin-asuka-p01-0.5.0.tgz
```

桌面端通过应用内插件页管理自身配置。安装包已经包含运行代码与图片，无需在插件目录中重新构建。

如果仍然显示默认配色、没有人物，也没有“明日香 P01”设置项，先在插件页确认本包已安装并启用。只有专注模式关闭人物时，酒红配色和主题设置入口仍然存在。

## 配置与升级

新版设置入口为 **账号／更多 → 设置 → 明日香 P01**；独立 Web 环境也可能直接显示“设置”按钮。

| 设置 | 默认值 | 行为 |
| --- | --- | --- |
| 表现方式 | 角色模式 | 专注模式隐藏人物和穹顶场景，保留主题配色 |
| 显示穹顶背景 | 开 | 可独立关闭场景图片 |
| 主立绘位置 | 白衣在左 | 可交换两套不同姿态的位置 |
| 背景强度 | 55% | 欢迎页使用此值；会话两侧采用其40%，中间进一步淡化 |
| 人物大小 | 100% | 可选60–120%；仍受实际留白与输入区位置约束 |

宽屏会话人物默认最高420px；空间不足时缩小、仅显示一侧或隐藏。人物不覆盖正文、输入、审批和弹层。窄桌面窗口优先保留阅读与操作空间。

修改设置时只预览当前草稿，点击“保存”后才应用；关闭设置不会自动保存草稿。其他窗口已修改同一配置时，保留当前草稿并提示重新载入，避免覆盖别人的修改。恢复默认同样需要保存，不会重置通用设置的字号和明暗偏好。

0.5.0 的设置按宿主插件条目 `ui-skin-asuka-p01` 保存到当前 profile，使用官方实时配置通道。**不自动搬迁0.4.x的旧 `asuka-p01` 设置文档**；从旧宿主升级后，请在主题页重新核对并保存五项选项。此插件不删除旧设置文档，也不更改其他插件配置。

## 预览

| 浅色欢迎页 | 深色欢迎页 |
| --- | --- |
| ![浅色](preview/light.webp) | ![深色](preview/dark.webp) |

[浅色会话](preview/active-light.webp) · [深色会话](preview/active-dark.webp) · [浅色代码差异](preview/diff-light.webp) · [深色代码差异](preview/diff-dark.webp)

[账号／更多菜单](preview/account-menu.webp) · [通用设置](preview/general-settings.webp)

![主题设置](preview/settings.webp)

预览使用本地离线内容和通用字号16px，没有执行模型或工具调用。桌面布局在隔离浏览器中启用 macOS 布局标记及最小桌面桥接替身，运行的是桌面应用随附的同版官方渲染模块；这些图片不是现用账号或真实 Electron 原生窗口的截屏。

## 验证范围

验证使用安装在本机的 DeepSeek Harness **0.1.7-rc.2** 随附运行模块、独立测试配置和本地回环地址。

- 旧包启动失败的复现与新包启动修复。
- 五项主题设置的读取、保存、刷新恢复、跨窗口冲突保护、专注模式与恢复默认。
- macOS 顶栏布局、账号／更多菜单、设置操作区及插件面板导航。
- 浅深色阅读、工作过程分组、代码差异、长代码及宽表格内部滚动。
- 1024、1280、1600和1920px桌面窗口，输入高度变化与侧栏空间变化。

没有修改用户现用的 `desktop` 配置，没有使用真实登录账号。Electron 原生窗口拖动、原生菜单和真实账号登录／退出未纳入验证；Windows／Linux原生桌面窗口以及其他宿主版本仍需单独验证。

## 从源码构建

```sh
npm ci
mkdir -p dist
npm pack --pack-destination dist
```

`prepack` 会执行 TypeScript 检查与构建。也可单独运行：

```sh
npm run typecheck
npm run build
```

安装包只包含清单内的运行文件、说明与预览图，不包含源码原图、开发依赖或临时验收脚本。图片由构建流程编码并内嵌到客户端，不依赖运行时图床；React与Cordis复用宿主运行时。

贡献者可使用同版独立 Web profile 验证：

```sh
dsh --profile asuka-test --from-default-profile web --dump-config
dsh plugin --profile asuka-test add "/绝对路径/dsh-skin-asuka-p01-0.5.0.tgz"
dsh --profile asuka-test --host 127.0.0.1 --no-open
```

该示例用于独立 Web 开发配置。桌面安装使用前面的应用内插件页。

| 文件 | 职责 |
| --- | --- |
| `src/index.ts` | Host Config schema与自定义设置页策略 |
| `src/preferences.ts` | 配置条目id、五项偏好、默认值与校验 |
| `src/client/index.tsx` | 主题、品牌插槽及configForms连接 |
| `src/client/settings.tsx` | 草稿、预览、保存与冲突处理 |
| `src/client/scene.ts` | 场景挂载、人物避让与清理 |
| `src/client/theme.css` | 配色、阅读、代码差异及设置布局 |
| `src/client/chrome.css` | 导航、账号入口、标题栏及装饰 |
| `src/client/ornaments.ts` | 金属角花、边饰与铭牌 |
| `scripts/build.mjs` | 编码图片并构建Host／Client产物 |

部分装饰与阅读面依赖官方渲染器的DOM标记。宿主升级后应重新验证这些结构，而不是通过跳过版本检查来假定兼容。

## 停用与许可

仅需减少人物装饰，可以在主题设置中选择“专注模式”并保存。完整停用或移除请使用桌面插件页，并按页面提示重新加载应用。

代码与素材的授权边界见 [LICENSE](LICENSE) 和 [NOTICE](NOTICE)。明日香相关角色权利属于原权利人，本项目不是官方授权作品；素材不随代码许可自动取得再分发授权。