更新

:i# Please enter the commit message for your changes. Lines starting

admin/src/hooks/usePaging.ts

@@ -8,6 +8,7 @@ interface Options {
     params?: Record<any, any>
     fixedParams?: Record<any, any>
     firstLoading?: boolean
+    latestOnly?: boolean
 }
 
 export function usePaging(options: Options) {
@@ -17,7 +18,8 @@ export function usePaging(options: Options) {
         fetchFun,
         params = {},
         fixedParams = {},
-        firstLoading = false
+        firstLoading = false,
+        latestOnly = false
     } = options
     // 记录分页初始参数
     const paramsInit: Record<any, any> = Object.assign({}, toRaw(params))
@@ -30,8 +32,10 @@ export function usePaging(options: Options) {
         lists: [] as any[],
         extend: {} as Record<string, any>
     })
+    let latestRequestId = 0
     // 请求分页接口；silent: true 时不改 loading（用于定时静默刷新，避免表格闪 loading）
     const getLists = (opts?: { silent?: boolean }) => {
+        const requestId = ++latestRequestId
         const silent = opts?.silent === true
         if (!silent) {
             pager.loading = true
@@ -43,16 +47,26 @@ export function usePaging(options: Options) {
             ...fixedParams
         })
             .then((res: any) => {
+                if (latestOnly && requestId !== latestRequestId) {
+                    return Promise.resolve(res)
+                }
                 pager.count = res?.count
                 pager.lists = res?.lists
                 pager.extend = res?.extend
                 return Promise.resolve(res)
             })
             .catch((err: any) => {
+                if (latestOnly && requestId !== latestRequestId) {
+                    return Promise.resolve(undefined)
+                }
                 return Promise.reject(err)
             })
             .finally(() => {
-                if (!silent) {
+                if (latestOnly) {
+                    if (requestId === latestRequestId) {
+                        pager.loading = false
+                    }
+                } else if (!silent) {
                     pager.loading = false
                 }
             })

admin/src/views/consumer/doctor/paiban.vue

@@ -89,7 +89,7 @@
                 >
                   <div class="slot-time">{{ slot.time }}</div>
                   <div class="slot-status" :class="{ 'status-available': slot.available }">
-                    {{ slot.available ? '可约' : '已约' }}
+                    {{ slot.available ? '可约' : slot.hasAppointment ? '已约' : '空号' }}
                   </div>
                 </div>
               </div>
@@ -115,6 +115,7 @@ dayjs.extend(isoWeek)
 interface TimeSlot {
   time: string
   available: boolean
+  hasAppointment: boolean
   quota: number
 }
 
@@ -186,7 +187,7 @@ const filteredTimeSlots = computed(() => {
     const slotDateTime = dayjs(`${form.date} ${slot.time}`)
     const isPast = slotDateTime.isBefore(now) || slotDateTime.isSame(now, 'minute')
     
-    // 如果时间已过，标记为不可用
+    // 如果时间已过，标记为不可用；保留原始挂号状态以区分“已约”和“空号”
     if (isPast) {
       return {
         ...slot,
@@ -315,6 +316,7 @@ const loadTimeSlots = async (silent = false) => {
     timeSlots.value = (response?.slots || []).map((slot: any) => ({
       time: slot.time,
       available: slot.available,
+      hasAppointment: Boolean(slot.has_appointment ?? (slot.available === false)),
       quota: slot.available ? 1 : 0
     }))
   } catch (error) {

admin/src/views/first_visit/conversion/index.vue

@@ -61,12 +61,23 @@
                     class="channel-select"
                     @change="loadDashboard"
                 >
-                    <el-option
-                        v-for="item in dashboard.filters.media_channels"
-                        :key="item.code"
-                        :label="item.name"
-                        :value="item.code"
-                    />
+                    <el-option-group
+                        v-for="group in mediaChannelGroups"
+                        :key="group.group_name || '_'"
+                        :label="`${group.group_name || '（未分组）'} · ${group.customer_count}`"
+                    >
+                        <el-option
+                            v-for="item in group.channels"
+                            :key="item.code"
+                            :label="item.name"
+                            :value="item.code"
+                        >
+                            <span class="channel-option">
+                                <span>{{ item.name }}</span>
+                                <span>{{ item.customer_count }} 人</span>
+                            </span>
+                        </el-option>
+                    </el-option-group>
                 </el-select>
             </div>
             <span class="range-text">{{ dashboard.meta.start_date }} 至 {{ dashboard.meta.end_date }}</span>
@@ -246,6 +257,13 @@ import vCharts from 'vue-echarts'
 import { firstVisitConversionOverview, type FirstVisitConversionParams } from '@/api/first_visit'
 
 type MetricType = 'count' | 'money' | 'ratio'
+type MediaChannelOption = {
+    code: string
+    name: string
+    tag_id?: string
+    group_name?: string
+    customer_count?: number
+}
 
 const emptyDashboard = () => ({
     meta: {
@@ -256,7 +274,7 @@ const emptyDashboard = () => ({
     filters: {
         departments: [] as any[],
         assistants: [] as Array<{ id: number; name: string }>,
-        media_channels: [] as Array<{ code: string; name: string }>
+        media_channels: [] as MediaChannelOption[]
     },
     summary: {} as Record<string, any>,
     rankings: { orders: [] as any[], amounts: [] as any[] },
@@ -303,6 +321,23 @@ const scopeDescription = computed(() => {
     if (dashboard.meta.selected_media_channel_name) parts.push(`渠道：${dashboard.meta.selected_media_channel_name}`)
     return parts.join(' · ')
 })
+const mediaChannelGroups = computed(() => {
+    const groups = new Map<string, {
+        group_name: string
+        customer_count: number
+        channels: MediaChannelOption[]
+    }>()
+    for (const channel of dashboard.filters.media_channels) {
+        const groupName = channel.group_name || ''
+        if (!groups.has(groupName)) {
+            groups.set(groupName, { group_name: groupName, customer_count: 0, channels: [] })
+        }
+        const group = groups.get(groupName)!
+        group.channels.push(channel)
+        group.customer_count = Math.max(group.customer_count, Number(channel.customer_count || 0))
+    }
+    return Array.from(groups.values())
+})
 const maxOrderValue = computed(() => Math.max(0, ...dashboard.rankings.orders.map(item => Number(item.value || 0))))
 const maxAmountValue = computed(() => Math.max(0, ...dashboard.rankings.amounts.map(item => Number(item.value || 0))))
 const targetChartOption = computed(() => ({
@@ -445,6 +480,18 @@ onMounted(loadDashboard)
 .employee-select { width: 190px; }
 .dept-select { width: 220px; }
 .channel-select { width: 180px; }
+.channel-option {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: 16px;
+    width: 100%;
+
+    span:last-child {
+        color: #98a2b3;
+        font-size: 12px;
+    }
+}
 
 .metric-grid {
     display: grid;

admin/src/views/first_visit/my_patients/components/ProgressPanel.vue

@@ -120,7 +120,7 @@
         <section class="board-section queue-section">
             <div class="section-heading queue-heading">
                 <div class="heading-copy">
-                    <h2>候诊列表</h2>
+                    <h2>{{ queueDateLabel }}候诊列表</h2>
                     <span class="heading-badge">按医生排队</span>
                     <span class="queue-count">共 {{ pager.count }} 人</span>
                 </div>
@@ -168,7 +168,7 @@
                     </template>
                 </el-table-column>
                 <template #empty>
-                    <el-empty description="当前权限范围内今日暂无候诊患者" />
+                    <el-empty :description="`当前权限范围内${queueDateLabel}暂无候诊患者`" />
                 </template>
             </el-table>
 
@@ -196,11 +196,12 @@ const formData = reactive({
     end_date: today
 })
 
-const { pager, getLists } = usePaging({
+const { pager, getLists, resetPage } = usePaging({
     fetchFun: myPatientProgressLists as any,
     params: formData,
     size: 15,
-    firstLoading: true
+    firstLoading: true,
+    latestOnly: true
 })
 
 const todayOverview = computed(() => ({
@@ -259,6 +260,10 @@ const selectedScheduleLabel = computed(() => {
     const day = selectedScheduleDay.value
     return `${day.date_text || ''} ${day.weekday || ''} `
 })
+const queueDateLabel = computed(() => {
+    if (selectedScheduleDate.value === today) return '今日'
+    return selectedScheduleLabel.value.trim() || selectedScheduleDate.value
+})
 
 const scopeLabel = computed(() => pager.extend?.scope?.label || '按权限加载')
 const scheduleRange = computed(() => {
@@ -274,7 +279,11 @@ function refreshPanel(options?: { silent?: boolean }) {
 }
 
 function selectScheduleDay(date: string) {
+    if (!date) return
     selectedScheduleDate.value = date
+    formData.start_date = date
+    formData.end_date = date
+    resetPage()
 }
 
 function doctorWindows(doctor: Record<string, any>) {

app/.env.example

@@ -0,0 +1,25 @@
+# 此文件是源码开发/企业部署模板，不会被复制进发布 ZIP/.app。
+# 生产配置应由受控启动器、设备管理或进程环境注入；禁止把密码、token、
+# UserSig、TRTC SecretKey 或其他长期凭据写进本文件或发布包。
+
+# 后端根地址。程序会自动追加 /adminapi；也可直接填写以 /adminapi 结尾的地址。
+DOCTOR_API_BASE_URL=https://api.example.com
+
+# 首次验收可设为 true，使用内置演示数据；生产必须设为 false。
+DOCTOR_DEMO_MODE=true
+
+# 当前只支持 embedded。browser 在后端提供一次性 handoff 前会被明确拒绝，且不会自动打开系统浏览器。
+DOCTOR_VIDEO_MODE=embedded
+# 可选：本地 dist 缺失时由 QtWebEngine 内嵌加载的可信 HTTPS 页面；不是 browser handoff URL，禁止携带 UserSig。
+DOCTOR_VIDEO_WEB_URL=
+
+# 生产环境必须保持 true。仅内网自签证书调试时临时关闭。
+DOCTOR_VERIFY_SSL=true
+DOCTOR_REQUEST_TIMEOUT=30
+
+# 日志级别：DEBUG / INFO / WARNING / ERROR。日志会自动脱敏 token 与 UserSig。
+DOCTOR_LOG_LEVEL=INFO
+
+# 可选：仅供企业部署/自动化验收隔离用户数据目录。
+# DOCTOR_CONFIG_DIR=
+# DOCTOR_LOG_DIR=

app/.gitignore

@@ -0,0 +1,23 @@
+.env
+.venv/
+.venv-build/
+.uv-cache/
+.uv-python/
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.pytest-tmp-*/
+artifacts/pytest_*/
+.ruff_cache/
+.coverage
+htmlcov/
+build/
+dist/
+!video_companion/dist/
+!video_companion/dist/**
+*.spec.bak
+node_modules/
+video_companion/node_modules/
+*.log
+.DS_Store
+Thumbs.db

app/Build_DoctorWorkstation.bat

@@ -0,0 +1,22 @@
+@echo off
+setlocal EnableExtensions DisableDelayedExpansion
+set "PROJECT_ROOT=%~dp0"
+set "POWERSHELL_EXE=%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe"
+
+"%POWERSHELL_EXE%" -NoLogo -NoProfile -ExecutionPolicy Bypass -File "%PROJECT_ROOT%scripts\package_windows.ps1" %*
+set "RESULT=%ERRORLEVEL%"
+
+if "%RESULT%"=="0" (
+    echo.
+    echo Package ready in: %PROJECT_ROOT%dist
+    if /I not "%~1"=="-ValidateOnly" (
+        start "" "%SystemRoot%\explorer.exe" "%PROJECT_ROOT%dist"
+    )
+) else (
+    echo.
+    echo DoctorWorkstation packaging failed. Exit code: %RESULT%
+    echo Press any key to close this window.
+    pause >nul
+)
+
+endlocal & exit /b %RESULT%

app/README.md

@@ -0,0 +1,132 @@
+# 臻阳堂医生工作站
+
+一个以 Python + PySide6 编写的跨平台医生桌面端，面向 Windows 10/11 与 macOS 13+。项目按现有 `admin` 源码的真实接口契约实现，覆盖登录、接诊台、我的处方库、已开处方、患者列表、问诊列表和腾讯云视频面诊。
+
+> 当前版本提供完整的演示数据模式，便于在没有后端账号或腾讯云配置时验收界面与流程。切换到生产模式后，数据与权限均由现有后端返回。
+
+## 一键运行与一键打包
+
+Windows 直接在项目根目录双击：
+
+- `一键运行_医生工作站.bat`：优先启动现有成品；没有成品时自动使用 `uv` 准备源码环境并运行。
+- `一键打包_医生工作站.bat`：自动同步锁定的 Python/Node 依赖，检查冻结 QtWebEngine/QtMultimedia 文件，执行应用与媒体离屏冒烟验证，最后生成 `dist/DoctorWorkstation-Windows-x64-<版本>.zip` 和 SHA-256 文件。
+
+英文稳定别名分别是 `Run_DoctorWorkstation.bat` 和 `Build_DoctorWorkstation.bat`。分发 ZIP 解压后，可直接双击其中的 `Start_DoctorWorkstation.bat`。
+
+macOS 在 Finder 中双击：
+
+- `一键运行.command`：优先打开现有 `DoctorWorkstation.app`，否则自动准备源码环境并运行。
+- `一键打包.command`：构建、QtWebEngine/QtMultimedia 文件门禁、签名检查和两项冻结冒烟验证后，生成 `.app`、可分发 ZIP 及 SHA-256 文件。
+
+Windows 打包机需预先安装 `uv` 与 Node.js 20+；脚本会自动处理项目虚拟环境和锁定依赖。首次打包需要联网下载依赖，之后会复用本机缓存。macOS 发布源码中的根 `.command` 与操作型 `scripts/*.sh` 必须以 Git mode `100755` 跟踪；源码压缩包在传输中丢失权限时，可在项目目录执行一次 `chmod +x *.command scripts/*.sh`。若 Gatekeeper 拦截未签名内部测试版，请使用右键“打开”。
+
+## 已实现范围
+
+- 账号密码登录、token 会话、记住账号（不保存密码）和退出登录。
+- 登录后读取 `/adminapi/auth.admin/mySelf`，按 `permissions` 动态控制页面和操作按钮；`*` 超级权限兼容现有后台。
+- 接诊台：今日待接诊/已过号、患者详情、医生备注、通知医助、完成接诊、发起视频面诊。
+- 我的处方库：主方/辅方与公开范围筛选，药材动态编辑，模板所有权和增删改权限。
+- 已开处方：处方号/患者/审核状态筛选、状态展示和只读详情。
+- 患者列表：复用 `/firstvisit.myPatient/lists` 的服务端数据范围，不在客户端伪造医生或部门过滤。
+- 问诊列表：按日期、状态和患者筛选，支持从有效预约发起视频。
+- 腾讯视频：沿用现有项目的 `@trtc/calls-uikit-vue` 主链；UserSig 只从后端短时获取，客户端不包含 SDKSecretKey。当前仅支持隔离的 QtWebEngine 内嵌模式。
+- PyInstaller Windows/macOS 构建脚本、macOS 摄像头/麦克风权限配置与自动化测试。
+
+## 手动运行
+
+先安装 [uv](https://docs.astral.sh/uv/)，然后在项目根目录执行：
+
+```powershell
+uv sync --extra dev --extra build
+Copy-Item .env.example .env
+uv run doctor-workstation
+```
+
+macOS/Linux：
+
+```bash
+uv sync --extra dev --extra build
+cp .env.example .env
+uv run doctor-workstation
+```
+
+`.env.example` 默认启用演示模式。演示账号：`doctor`，密码：`doctor123`。
+
+`.env.example` 仅作为源码开发/企业部署模板，不会复制进发布 ZIP 或 `.app`。生产环境请通过受控启动器、设备管理或进程环境注入配置；不要把密码、token、UserSig、TRTC SecretKey 等凭据放进 `.env` 或发布包。
+
+## 连接现有后端
+
+将 `.env` 调整为：
+
+```dotenv
+DOCTOR_API_BASE_URL=https://your-api.example.com
+DOCTOR_DEMO_MODE=false
+DOCTOR_VERIFY_SSL=true
+```
+
+程序会自动在地址末尾追加 `/adminapi`。它与现有管理端保持相同约定：
+
+- 登录：`POST /login/account`，请求包含 `account`、`password`、`terminal=1`。
+- 鉴权请求头：`token: <登录 token>`，`version: 1.9.4`。
+- 响应 envelope：`code=1` 成功、`0` 业务失败、`-1` 登录失效、`10` 需绑定企业微信。
+- 权限与数据范围：完全以后端 `/auth.admin/mySelf` 返回为准。
+
+环境配置不会保存密码、TRTC SecretKey 或腾讯云长期凭据。登录 token 优先存入系统凭据库；无法使用时仅回退到用户配置目录中的受限文件。
+
+## 视频伴随页
+
+腾讯云没有官方 Python/PySide6 客户端 SDK。本项目因此采用 Python 业务主程序 + 腾讯官方 Web TUICallKit 伴随页：
+
+```powershell
+Set-Location video_companion
+npm ci
+npm run build
+```
+
+构建输出位于 `video_companion/dist`，由桌面端内嵌加载。生产 UserSig 必须由现有 `/tcm.diagnosis/getCallSignature` 接口签发；不要把 SDKSecretKey 写入 `.env` 或 JavaScript。
+
+当前仅支持 `embedded`。在业务后端提供服务端签发、一次性消费的 browser handoff 之前，`browser` 模式会被明确拒绝，QtWebEngine 不可用时也不会自动打开系统浏览器。这样可以避免后端已记录 `startCall`、浏览器页面却没有通话票据的“幽灵通话”。
+
+```dotenv
+DOCTOR_VIDEO_MODE=embedded
+DOCTOR_VIDEO_WEB_URL=https://rtc.example.com/doctor-call
+```
+
+`DOCTOR_VIDEO_WEB_URL` 仅用于本地 `dist` 缺失时，在 QtWebEngine 中内嵌加载受信任的 HTTPS 主文档；它不是 browser handoff URL，也不得在 URL 中携带 UserSig 或其他 RTC 凭据。
+
+## 测试与打包
+
+```powershell
+uv run pytest
+uv run ruff check src tests
+.\scripts\build_windows.ps1
+```
+
+`build_windows.ps1` 只生成并验证 onedir；正式一键发布请运行 `Build_DoctorWorkstation.bat`，它在所有冻结文件/媒体门禁通过后再生成版本 ZIP 与 SHA-256。
+
+macOS 必须在 macOS 机器上构建、签名和公证：
+
+```bash
+./scripts/build_macos.sh
+```
+
+`build_macos.sh` 只生成并验证 `.app`；正式一键发布请双击 `一键打包.command`（或 `package_macos.command`），通过相同门禁后再归档并生成 SHA-256。
+
+Windows 与 macOS 的 Qt/媒体权限和签名产物不能交叉编译。首次生产发布前，应按 [research/tencent_rtc.md](research/tencent_rtc.md) 的准入清单完成摄像头、麦克风、设备插拔、休眠恢复和弱网实测。
+
+## 工程结构
+
+```text
+src/doctor_workstation/
+  core/        业务模型、权限、会话与异常
+  services/    HTTP 客户端、远程仓库、演示仓库与安全 token 存储
+  ui/          PySide6 登录、主框架、页面和对话框
+  video/       视频请求规范化、异步生命周期与隔离的内嵌窗口
+video_companion/  腾讯 TUICallKit 页面
+packaging/        PyInstaller 与 macOS 权限配置
+scripts/          Windows/macOS 构建脚本
+tests/            不依赖真实后端和腾讯云的自动化测试
+research/         admin 源码审计、架构和腾讯 RTC 官方资料研究
+```
+
+详细的接口/字段与权限审计见 [research/admin_audit.md](research/admin_audit.md)。

app/Run_DoctorWorkstation.bat

@@ -0,0 +1,16 @@
+@echo off
+setlocal EnableExtensions DisableDelayedExpansion
+set "PROJECT_ROOT=%~dp0"
+set "POWERSHELL_EXE=%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe"
+
+"%POWERSHELL_EXE%" -NoLogo -NoProfile -ExecutionPolicy Bypass -File "%PROJECT_ROOT%scripts\run_windows.ps1" %*
+set "RESULT=%ERRORLEVEL%"
+
+if not "%RESULT%"=="0" (
+    echo.
+    echo DoctorWorkstation failed to start. Exit code: %RESULT%
+    echo Press any key to close this window.
+    pause >nul
+)
+
+endlocal & exit /b %RESULT%

app/SECURITY.md

@@ -0,0 +1,14 @@
+# 安全与隐私约束
+
+医生工作台会处理患者身份、病历、处方和音视频等敏感信息。生产部署必须遵守以下基线：
+
+- 客户端不包含腾讯云 `SDKSecretKey`、COS Secret 或后端数据库凭据。TRTC `UserSig` 由服务端按当前医生和单次通话短时签发。
+- 不在 URL 查询参数、命令行或日志中传递 token、UserSig、患者身份证号和完整病历。项目日志过滤器会遮蔽常见凭据，但调用代码仍应避免记录完整请求/响应。
+- 密码从不落盘；“记住账号”只保存账号。登录 token 优先写入 Windows Credential Manager / macOS Keychain。
+- 生产 API 与浏览器视频页必须使用 HTTPS 并验证证书。`DOCTOR_VERIFY_SSL=false` 只允许在受控开发环境临时使用。
+- 页面可见性与按钮权限来自 `/auth.admin/mySelf`，但客户端权限仅用于界面体验；服务端仍必须对每个接口执行身份、租户、数据范围和动作权限校验。
+- 本地不缓存患者列表、病历、处方和通话票据。演示数据是完全虚构的静态数据。
+- 通话录制、截图和报告上传属于单独的合规能力；启用前必须确认患者告知/同意、留存周期、访问审计和删除流程。
+- 软件发布必须签名。Windows 建议 Authenticode；macOS 需要 Developer ID、Hardened Runtime、摄像头/麦克风用途说明与公证。
+
+发现凭据泄露、越权、患者数据写入日志或视频房间被未授权加入时，应立即停用相关凭据、保留审计证据并按组织的安全响应流程处置。

app/main.py

@@ -0,0 +1,10 @@
+"""Development entry point.
+
+The installed application uses the ``doctor-workstation`` console script. Keeping
+this tiny launcher makes ``python main.py`` convenient for local development.
+"""
+
+from doctor_workstation.app import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

app/package_macos.command

@@ -0,0 +1,5 @@
+#!/bin/bash
+set -u
+project_root="$(cd "$(dirname "$0")" && pwd -P)"
+exec /bin/bash "$project_root/scripts/package_macos.sh"
+

app/packaging/README.md

@@ -0,0 +1,33 @@
+# Video-enabled desktop packaging
+
+The spec creates an `onedir` build and embeds `video_companion/dist` as `video_companion_dist`. Explicit QtWebEngine imports activate PyInstaller's maintained PySide6 hooks; the build scripts then fail if the resulting artifact does not contain `QtWebEngineProcess` or Chromium `.pak` resources.
+
+`PySide6.QtMultimedia` and `PySide6.QtMultimediaWidgets` are also explicit hidden imports. Their maintained PyInstaller hooks collect the Python extension modules, `Qt6Multimedia`/`Qt6MultimediaWidgets` DLLs, dylibs or frameworks, `plugins/multimedia`, and the platform media backends. The build scripts assert those frozen files before accepting an artifact.
+
+Both build scripts launch the frozen executable twice. `--media-smoke-test` is handled by a PyInstaller runtime hook before the normal application entry point: it imports both multimedia modules, constructs `QMediaPlayer`, `QAudioOutput`, and `QVideoWidget`, checks that a decoder backend exposes formats, runs one offscreen event-loop turn, and returns non-zero on any failure. The existing `--smoke-test` then validates the packaged application bootstrap. Each process uses a temporary user/config directory, loopback-only proxy settings, and a 30-second deadline; a non-zero exit or an unhandled exception in its logs fails the build.
+
+Run the build on the target operating system. PyInstaller cannot cross-build Windows and macOS artifacts.
+
+## Windows
+
+```powershell
+.\scripts\build_windows.ps1
+```
+
+The default interpreter is `.venv-build\Scripts\python.exe`; override it with `-Python C:\path\to\python.exe`.
+
+For the one-click release ZIP and SHA-256 manifest, run `Build_DoctorWorkstation.bat`. It prepares locked dependencies, invokes the build/file/smoke gates, and archives only after all gates pass.
+
+## macOS
+
+```bash
+bash ./scripts/build_macos.sh
+```
+
+The default interpreter is `.venv-build/bin/python`. For release signing, export `MACOS_CODESIGN_IDENTITY` before building. The generated app includes camera/microphone usage descriptions and the main-process entitlements in `macos/entitlements.plist`.
+
+For the one-click release ZIP and SHA-256 file, use `package_macos.command` (or `一键打包.command`). All root `.command` files and operational `scripts/*.sh` files must be tracked with mode `100755`; `scripts/check_macos_entrypoints.sh` verifies both filesystem executability and Git index mode before packaging.
+
+Before notarization, verify the nested `QtWebEngineProcess.app` signature and preserve its Qt-provided helper entitlements. Sign nested code before the outer app, then notarize and staple the final distribution artifact.
+
+`.env.example` is a source/deployment template and is intentionally not included in the release archives. Production endpoints and non-secret policy values should be injected into the process environment by the managed launcher/MDM. Never place passwords, tokens, UserSig, TRTC SecretKey, or other long-lived credentials in a release archive.

app/packaging/doctor_workstation.spec

@@ -0,0 +1,127 @@
+# -*- mode: python ; coding: utf-8 -*-
+"""Cross-platform PyInstaller onedir spec for the video-enabled workstation.
+
+PyInstaller's official PySide6 QtWebEngine hooks are activated by the explicit
+hidden imports below.  Those hooks retain QtWebEngineProcess, Chromium .pak/
+ICU resources, locales, Qt plugins, and the macOS framework/helper layout.
+The explicit QtMultimedia imports likewise activate PyInstaller's official Qt
+dependency scan, which collects the QtMultimedia/QtMultimediaWidgets extension
+modules, Qt6Multimedia shared libraries/frameworks, multimedia plugins, and
+their platform media backends.
+"""
+
+import os
+import sys
+from pathlib import Path
+
+
+PROJECT_ROOT = Path(SPEC).resolve().parent.parent
+SOURCE_ROOT = PROJECT_ROOT / "src"
+ENTRY_POINT = SOURCE_ROOT / "doctor_workstation" / "__main__.py"
+VIDEO_DIST = PROJECT_ROOT / "video_companion" / "dist"
+RESOURCES = PROJECT_ROOT / "resources"
+ENTITLEMENTS = PROJECT_ROOT / "packaging" / "macos" / "entitlements.plist"
+VERSION_FILE = PROJECT_ROOT / "packaging" / "windows" / "version_info.txt"
+MEDIA_SMOKE_HOOK = PROJECT_ROOT / "packaging" / "runtime_media_smoke.py"
+
+if not ENTRY_POINT.is_file():
+    raise SystemExit(f"Application entry point is missing: {ENTRY_POINT}")
+if not (VIDEO_DIST / "index.html").is_file():
+    raise SystemExit("Build video_companion before running PyInstaller")
+if not MEDIA_SMOKE_HOOK.is_file():
+    raise SystemExit(f"Frozen multimedia smoke hook is missing: {MEDIA_SMOKE_HOOK}")
+
+# Some Windows developer tools add an unrelated OpenSSL installation to PATH.
+# PyInstaller's dependency scanner would then pair Python's ``_ssl.pyd`` with
+# those incompatible DLLs.  Put the running interpreter's DLL directory first
+# and collect the exact same files explicitly so the build is reproducible.
+python_runtime_binaries = []
+if sys.platform == "win32":
+    python_dll_dir = Path(sys.base_prefix) / "DLLs"
+    for dll_name in ("libssl-3-x64.dll", "libcrypto-3-x64.dll"):
+        dll_path = python_dll_dir / dll_name
+        if not dll_path.is_file():
+            raise SystemExit(f"Python runtime dependency is missing: {dll_path}")
+        python_runtime_binaries.append((str(dll_path), "."))
+    os.environ["PATH"] = os.pathsep.join((str(python_dll_dir), os.environ.get("PATH", "")))
+
+qt_webengine_hiddenimports = [
+    # Importing these modules lets PyInstaller's official Qt hooks collect the
+    # helper executable/app, resources, locales, frameworks, and plugins.
+    "PySide6.QtWebChannel",
+    "PySide6.QtWebEngineCore",
+    "PySide6.QtWebEngineWidgets",
+    "PySide6.QtNetwork",
+    "PySide6.QtPrintSupport",
+]
+
+qt_multimedia_hiddenimports = [
+    # These are intentionally explicit instead of relying on imports hidden by
+    # the application's optional media fallback.  PyInstaller's official
+    # hooks collect Qt6Multimedia*.dll/.dylib/framework, plugins/multimedia,
+    # and the platform FFmpeg/native backend dependencies.
+    "PySide6.QtMultimedia",
+    "PySide6.QtMultimediaWidgets",
+]
+
+analysis = Analysis(
+    [str(ENTRY_POINT)],
+    pathex=[str(SOURCE_ROOT)],
+    binaries=python_runtime_binaries,
+    datas=[
+        (str(VIDEO_DIST), "video_companion_dist"),
+        (str(RESOURCES), "resources"),
+    ],
+    hiddenimports=qt_webengine_hiddenimports + qt_multimedia_hiddenimports,
+    hookspath=[],
+    hooksconfig={},
+    runtime_hooks=[str(MEDIA_SMOKE_HOOK)],
+    excludes=[],
+    noarchive=False,
+    optimize=0,
+)
+
+pyz = PYZ(analysis.pure)
+
+is_macos = sys.platform == "darwin"
+exe = EXE(
+    pyz,
+    analysis.scripts,
+    [],
+    exclude_binaries=True,
+    name="DoctorWorkstation",
+    debug=False,
+    bootloader_ignore_signals=False,
+    strip=False,
+    upx=False,
+    console=False,
+    disable_windowed_traceback=False,
+    argv_emulation=False,
+    target_arch=None,
+    codesign_identity=os.environ.get("MACOS_CODESIGN_IDENTITY") if is_macos else None,
+    entitlements_file=str(ENTITLEMENTS) if is_macos else None,
+    version=str(VERSION_FILE) if sys.platform == "win32" else None,
+)
+
+collection = COLLECT(
+    exe,
+    analysis.binaries,
+    analysis.datas,
+    strip=False,
+    upx=False,
+    name="DoctorWorkstation",
+)
+
+if is_macos:
+    app = BUNDLE(
+        collection,
+        name="DoctorWorkstation.app",
+        icon=None,
+        bundle_identifier="com.zyt.doctor-workstation",
+        info_plist={
+            "CFBundleDisplayName": "臻阳堂医生工作站",
+            "NSCameraUsageDescription": "用于视频面诊时采集医生画面。",
+            "NSMicrophoneUsageDescription": "用于视频面诊时采集医生语音。",
+            "NSHighResolutionCapable": True,
+        },
+    )

app/packaging/macos/entitlements.plist

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>com.apple.security.device.camera</key>
+    <true/>
+    <key>com.apple.security.device.audio-input</key>
+    <true/>
+    <key>com.apple.security.device.microphone</key>
+    <true/>
+    <key>com.apple.security.network.client</key>
+    <true/>
+    <key>com.apple.security.cs.allow-jit</key>
+    <true/>
+    <key>com.apple.security.cs.allow-unsigned-executable-memory</key>
+    <true/>
+    <key>com.apple.security.cs.disable-library-validation</key>
+    <true/>
+</dict>
+</plist>

app/packaging/runtime_media_smoke.py

@@ -0,0 +1,85 @@
+"""Frozen-process gate for the Qt multimedia runtime.
+
+PyInstaller executes this file as a runtime hook.  Normal application starts
+are untouched; ``--media-smoke-test`` exits before the application entry point
+after proving that the frozen Qt multimedia modules and a decoder backend can
+be loaded in an offscreen Qt event loop.
+"""
+
+from __future__ import annotations
+
+import sys
+
+MEDIA_SMOKE_ARGUMENT = "--media-smoke-test"
+
+
+def _emit(message: str, *, error: bool = False) -> None:
+    # Windowed PyInstaller executables set stdout/stderr to None on Windows.
+    # The exit status is the gate contract; diagnostics are best-effort.
+    stream = sys.stderr if error else sys.stdout
+    if stream is not None:
+        print(message, file=stream, flush=True)
+
+
+def _run_media_smoke_gate() -> None:
+    # Keep these imports inside the gate.  Missing frozen extension modules or
+    # linked Qt multimedia libraries must make this process fail, while normal
+    # launches retain the application's existing fallback behaviour.
+    from PySide6.QtCore import QTimer
+    from PySide6.QtMultimedia import QAudioOutput, QMediaFormat, QMediaPlayer
+    from PySide6.QtMultimediaWidgets import QVideoWidget
+    from PySide6.QtWidgets import QApplication
+
+    application = QApplication.instance()
+    owns_application = application is None
+    if application is None:
+        application = QApplication(["DoctorWorkstationMediaSmoke"])
+
+    player = QMediaPlayer()
+    audio_output = QAudioOutput()
+    video_widget = QVideoWidget()
+    player.setAudioOutput(audio_output)
+    player.setVideoOutput(video_widget)
+
+    if not player.isAvailable():
+        raise RuntimeError("Qt reports that no multimedia backend is available")
+
+    decode_formats = QMediaFormat().supportedFileFormats(QMediaFormat.ConversionMode.Decode)
+    if not decode_formats:
+        raise RuntimeError("Qt multimedia loaded without a supported decoder format")
+
+    video_widget.resize(16, 16)
+    video_widget.show()
+    QTimer.singleShot(0, application.quit)
+    event_status = application.exec()
+    video_widget.close()
+    player.setVideoOutput(None)
+    player.setAudioOutput(None)
+    if event_status != 0:
+        raise RuntimeError(f"Qt multimedia offscreen event loop exited with {event_status}")
+
+    # QApplication cannot be recreated safely in-process.  The runtime hook is
+    # a one-shot frozen gate, but retaining this distinction makes direct test
+    # imports predictable.
+    if owns_application:
+        application.processEvents()
+
+
+def _dispatch() -> int | None:
+    if MEDIA_SMOKE_ARGUMENT not in sys.argv[1:]:
+        return None
+    try:
+        _run_media_smoke_gate()
+    except Exception as exc:
+        _emit(
+            f"Frozen Qt multimedia smoke gate failed: {type(exc).__name__}: {exc}",
+            error=True,
+        )
+        return 70
+    _emit("Frozen Qt multimedia smoke gate passed.")
+    return 0
+
+
+_media_smoke_status = _dispatch()
+if _media_smoke_status is not None:
+    raise SystemExit(_media_smoke_status)

app/packaging/windows/start_release.bat

@@ -0,0 +1,19 @@
+@echo off
+setlocal EnableExtensions DisableDelayedExpansion
+set "APPLICATION=%~dp0DoctorWorkstation\DoctorWorkstation.exe"
+
+if not exist "%APPLICATION%" (
+    echo DoctorWorkstation.exe was not found.
+    echo Please keep this launcher beside the DoctorWorkstation folder.
+    pause
+    exit /b 1
+)
+
+start "" "%APPLICATION%"
+if errorlevel 1 (
+    echo DoctorWorkstation failed to start.
+    pause
+    exit /b 1
+)
+
+exit /b 0

app/packaging/windows/version_info.txt

@@ -0,0 +1,31 @@
+# UTF-8
+# Example PyInstaller version resource. Update all four version tuples together.
+VSVersionInfo(
+  ffi=FixedFileInfo(
+    filevers=(0, 1, 0, 0),
+    prodvers=(0, 1, 0, 0),
+    mask=0x3f,
+    flags=0x0,
+    OS=0x40004,
+    fileType=0x1,
+    subtype=0x0,
+    date=(0, 0)
+  ),
+  kids=[
+    StringFileInfo([
+      StringTable(
+        '080404B0',
+        [
+          StringStruct('CompanyName', 'ZYT'),
+          StringStruct('FileDescription', '医生工作台'),
+          StringStruct('FileVersion', '0.1.0.0'),
+          StringStruct('InternalName', 'DoctorWorkstation'),
+          StringStruct('OriginalFilename', 'DoctorWorkstation.exe'),
+          StringStruct('ProductName', '医生工作台'),
+          StringStruct('ProductVersion', '0.1.0.0')
+        ]
+      )
+    ]),
+    VarFileInfo([VarStruct('Translation', [2052, 1200])])
+  ]
+)

app/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["hatchling>=1.25"]
+build-backend = "hatchling.build"
+
+[project]
+name = "zhenyang-doctor-workstation"
+version = "0.1.0"
+description = "Cross-platform doctor consultation workstation for Windows and macOS"
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "Proprietary" }
+authors = [{ name = "Zhenyangtang" }]
+dependencies = [
+  "httpx>=0.27.2,<1",
+  "keyring>=25.5,<26",
+  "platformdirs>=4.3,<5",
+  "PySide6>=6.8.2,<7",
+  "python-dotenv>=1.0.1,<2",
+]
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=8.3,<9",
+  "pytest-cov>=6,<7",
+  "ruff>=0.9,<1",
+]
+build = [
+  "pyinstaller>=6.11,<7",
+]
+
+[project.scripts]
+doctor-workstation = "doctor_workstation.app:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/doctor_workstation"]
+
+[tool.pytest.ini_options]
+addopts = "-q"
+pythonpath = ["src"]
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM"]
+ignore = ["E501"]
+

app/research/admin_audit.md

@@ -0,0 +1,820 @@
+# admin 医生端源码审计
+
+审计日期：2026-08-10  
+参考项目：D:\web\zyt\admin  
+审计方式：只读检查 Vue/TypeScript 源码、API 封装、路由守卫、Pinia store、业务组件和权限判断；未修改 admin 项目，也未把 README 当作结论来源。
+
+## 1. 结论摘要
+
+1. admin 是 Vue 3 + TypeScript + Vite + Element Plus + Pinia 项目。医生端并不是一套独立的静态路由：除登录、H5 诊单和只读诊单外，页面路径、标题、组件和菜单权限都由登录后 GET /adminapi/auth.admin/mySelf 返回的 menu 动态注入。
+2. 医生相关页面的全局状态很少。Pinia 只持有认证用户、权限、动态菜单、全局站点配置、布局与多标签；接诊台、处方、患者、问诊列表的查询条件和业务状态均保留在各页面的 ref/reactive 中，分页统一使用 usePaging。
+3. “患者列表”有两个不同实现：
+   - 医生/一诊工作台的“我的患者”：src/views/first_visit/my_patients/index.vue，带患者、订单、面诊进度三个工作区，服务端按当前角色和部门数据范围收窄。
+   - 平台注册用户列表：src/views/consumer/lists/index.vue，仅展示头像、昵称、账号、手机号、渠道和注册时间，不是医生业务患者工作台。
+4. “问诊列表”也有两个相关实现：
+   - 挂号/问诊执行列表：src/views/tcm/appointment/list.vue，默认“今天 + 待接诊”，支持通话、视频二维码、完成、开方、取消。
+   - 诊单/患者业务列表：src/views/tcm/diagnosis/index.vue，围绕诊单、挂号、确认、开方、医助指派、二维码和视频旁观。
+   最终菜单叫什么、URL 是什么取决于后端 menu 配置，不应仅根据文件名硬编码。
+5. 实际视频问诊主链是 src/components/chat-dialog/index.vue：腾讯云 Chat UIKit 单聊 + TUICallKit 音视频；通话前后还串联后端通话记录、TRTC 房间绑定、云端混流录制、可选浏览器本地录制、截屏写医生备注。src/components/video-call/index.vue 是另一套旧/独立实现，目前源码中没有被任何页面引用。
+6. 处方领域要区分三类对象：
+   - 处方库模板：tcm.prescriptionLibrary，供医生复用药材组合。
+   - 已开处方：tcm.prescription，处方笺、患者、医师签名、主辅方、审核与作废。
+   - 处方业务订单：tcm.prescriptionOrder，收货、费用、双审、支付单、药房和物流履约；它不是支付单 zyt_order。
+
+## 2. 关键源码与路由
+
+### 2.1 页面定位
+
+| 业务 | 关键源文件（绝对路径） | 路由结论 |
+|---|---|---|
+| 登录 | D:\web\zyt\admin\src\views\account\login.vue | 静态精确路由 /login |
+| 接诊台 | D:\web\zyt\admin\src\views\patient\reception\index.vue | 动态菜单组件键应指向 patient/reception/index；实际 URL 取 menu[].paths |
+| 我的处方库 | D:\web\zyt\admin\src\views\consumer\prescription\list.vue | 动态菜单组件键应指向 consumer/prescription/list；实际 URL 取 menu[].paths |
+| 药品库（不是处方库） | D:\web\zyt\admin\src\views\doctor\medicine.vue | 动态菜单组件键应指向 doctor/medicine |
+| 已开处方/处方管理 | D:\web\zyt\admin\src\views\consumer\prescription\index.vue | 动态菜单组件键应指向 consumer/prescription/index |
+| 处方业务订单 | D:\web\zyt\admin\src\views\consumer\prescription\order_list.vue | 动态菜单组件键应指向 consumer/prescription/order_list |
+| 我的患者 | D:\web\zyt\admin\src\views\first_visit\my_patients\index.vue | 动态菜单组件键应指向 first_visit/my_patients/index |
+| 平台用户列表 | D:\web\zyt\admin\src\views\consumer\lists\index.vue | 动态菜单组件键应指向 consumer/lists/index |
+| 问诊/挂号列表 | D:\web\zyt\admin\src\views\tcm\appointment\list.vue | 动态菜单组件键应指向 tcm/appointment/list |
+| 诊单列表 | D:\web\zyt\admin\src\views\tcm\diagnosis\index.vue | 动态菜单组件键应指向 tcm/diagnosis/index；另有静态 H5 路由 /tcm/diagnosis/h5 |
+| 诊单编辑/只读抽屉 | D:\web\zyt\admin\src\views\tcm\diagnosis\edit.vue | 被多个页面异步复用，不一定是独立菜单 |
+| 患者只读详情 | D:\web\zyt\admin\src\views\tcm\diagnosis\readonly.vue | 静态精确路由 /tcm/diagnosis-readonly?id=诊单ID |
+| 预约视频问诊 | D:\web\zyt\admin\src\views\tcm\diagnosis\appointment.vue | 抽屉组件，由诊单列表/我的患者调用 |
+| 诊间开方 | D:\web\zyt\admin\src\components\tcm-prescription\index.vue | 复用组件，由问诊列表和诊单编辑调用 |
+| 聊天与视频问诊 | D:\web\zyt\admin\src\components\chat-dialog\index.vue | 浮动组件，由接诊台及问诊列表调用 |
+| 医助视频旁观 | D:\web\zyt\admin\src\views\tcm\diagnosis\components\AssistantWatchCallDialog.vue | 诊单列表内异步组件 |
+
+### 2.2 动态路由机制
+
+关键文件：
+
+- D:\web\zyt\admin\src\router\routes.ts
+- D:\web\zyt\admin\src\router\index.ts
+- D:\web\zyt\admin\src\permission.ts
+- D:\web\zyt\admin\src\stores\modules\user.ts
+
+流程：
+
+1. 常量路由只注册 /login、/403、/change-password、/bind-work-wechat、/user/setting、/doctor/progress、/tcm/diagnosis/h5 和 /tcm/diagnosis-readonly 等少数页面。
+2. 登录成功后 GET /auth.admin/mySelf。
+3. user store 保存 data.user、data.permissions，并把 data.menu 交给 filterAsyncRoutes。
+4. 每个后端菜单项使用以下字段转为 Vue Router：
+   - paths：路由路径；
+   - component：src/views 下的组件键；
+   - name：菜单标题；
+   - perms：写入 route.meta.perms；
+   - is_show：控制 meta.hidden；
+   - is_cache：控制 keepAlive；
+   - params：默认 query；
+   - selected：activeMenu；
+   - type：目录或菜单。
+5. permission.ts 把转换后的路由动态挂到根布局；第一个可见菜单成为 / 的重定向目标。
+
+因此，本仓库源码能确定组件和静态路由，但不能单独确定接诊台、处方库、已开处方、我的患者、问诊列表的生产 URL 与菜单标题。要得到精确值，必须取得当前环境 /auth.admin/mySelf 的 menu 响应或检查服务端菜单表。
+
+## 3. 登录、认证、权限和状态管理
+
+### 3.1 登录链路
+
+关键文件：
+
+- D:\web\zyt\admin\src\views\account\login.vue
+- D:\web\zyt\admin\src\api\user.ts
+- D:\web\zyt\admin\src\stores\modules\user.ts
+- D:\web\zyt\admin\src\utils\request\index.ts
+- D:\web\zyt\admin\src\utils\auth.ts
+
+账号密码：
+
+- POST /login/account
+- 请求：account、password、terminal=1。
+- 响应被页面使用的字段：token、is_paw、need_bind_work_wechat。
+- token 写入本地缓存键 token，后续请求通过请求拦截器放到 HTTP 头 token。
+- “记住账号”只缓存 account，不缓存密码，缓存键为 account。
+
+企业微信：
+
+- GET /login/workWechatConfig，使用 enabled、corp_id、agent_id。
+- 企业微信内置浏览器走 OAuth，scope=snsapi_privateinfo、state=admin_login。
+- 普通浏览器动态加载 https://wwcdn.weixin.qq.com/node/wework/wwopen/js/wwLogin-1.2.7.js 显示扫码登录。
+- 回调 code 通过 POST /login/workWechatLogin，参数 code、terminal=1。
+- 另有 POST /auth.admin/bindWorkWechat、POST /auth.admin/unbindWorkWechat。
+
+守卫：
+
+- is_paw=0 强制跳转 /change-password，并通过 POST /login/changeFirstPassword 修改。
+- need_bind_work_wechat=true 强制进入 /bind-work-wechat。
+- 没有 token 的非白名单路由跳 /login?redirect=原地址。
+- /auth.admin/mySelf 没有任何有效菜单时清认证并跳 /403。
+- 响应码约定：1 成功、0 失败、-1 登录失效、10 需要绑定企微、2 打开新页面、-2 未安装。
+
+### 3.2 Pinia 与页面状态
+
+| Store/Hook | 文件 | 职责 |
+|---|---|---|
+| user | D:\web\zyt\admin\src\stores\modules\user.ts | token、userInfo、routes、perms、isPaw；登录、退出、企微登录、加载个人信息 |
+| app | D:\web\zyt\admin\src\stores\modules\app.ts | 网站配置、OSS 图片地址、移动端/侧栏状态、视图刷新 |
+| tabs | D:\web\zyt\admin\src\stores\modules\multipleTabs.ts | 多标签与 keep-alive 缓存 |
+| setting | D:\web\zyt\admin\src\stores\modules\setting.ts | 本地布局、主题配置 |
+| usePaging | D:\web\zyt\admin\src\hooks\usePaging.ts | 页码、page_size、loading、count、lists、extend；支持 silent 静默刷新 |
+
+列表接口统一期待服务端 data 为：
+
+- lists：当前页数组；
+- count：总数；
+- extend：额外统计、日期、权限范围等扩展数据。
+
+页面内筛选和弹窗状态不进入 Pinia。这一约定适合桌面端复用：认证/权限做全局 store，业务工作台保持页面级 store 或 view-model。
+
+### 3.3 权限判断语义
+
+关键文件：
+
+- D:\web\zyt\admin\src\install\directives\perms.ts
+- D:\web\zyt\admin\src\utils\perm.ts
+
+需要特别注意两套语义不同：
+
+- v-perms 数组是“任一权限命中即可显示”（OR）。
+- hasPermission 数组是“数组内每个权限都必须存在”（AND）。
+- permissions 含星号时视为全部权限。
+
+多数业务调用只传单个权限，因此差异暂时不明显；复用时不要把多权限数组在两处互换。
+
+## 4. 业务页面审计
+
+### 4.1 接诊台
+
+源码：
+
+- D:\web\zyt\admin\src\views\patient\reception\index.vue
+- D:\web\zyt\admin\src\api\patient.ts
+- D:\web\zyt\admin\src\views\tcm\diagnosis\components\PatientInfoCard.vue
+- D:\web\zyt\admin\src\views\tcm\diagnosis\components\PatientCaseCard.vue
+- D:\web\zyt\admin\src\views\tcm\diagnosis\components\DailyMatrix.vue
+- D:\web\zyt\admin\src\views\patient\reception\components\NoteTimeline.vue
+
+页面行为：
+
+- 默认显示当天 status=1 待接诊；可切到 status=4 已过号。
+- 搜索字段 patient_name；分页 page_no/page_size，固定每页 15。
+- 每 5 秒静默刷新队列和已选患者详情；页面隐藏时暂停，恢复可见后立即刷新。
+- 队列使用无限滚动，并按 id 去重。
+- 队列行主要字段：id、patient_id、patient_name、patient_phone、diagnosis_id、doctor_id/name、assistant_id/name、appointment_date/time、gender、age、status/status_desc、has_prescription、remark。
+- 详情结构按源码使用为：
+  - appointment：挂号；
+  - diagnosis：诊单/病例；
+  - doctor_notes：医生备注、舌苔和报告。
+- 日常记录不依赖 reception 响应完整下发，而由 DailyMatrix 继续按 diagnosis_id 调 trackingWindow/trackingNotes。
+
+操作：
+
+- 通知医助：POST /doctor.appointment/notifyAssistant，参数 id=挂号ID。
+- 发起通话：先 POST /tcm.diagnosis/getCallSignature，参数 patient_id、diagnosis_id，再打开 ChatDialog。
+- 备注：POST /doctor.appointment/addDoctorNote，参数 diagnosis_id、content，可追加 tongue_images、report_files。
+- 编辑病历：复用 tcm/diagnosis/edit.vue。
+- 完成接诊：POST /doctor.appointment/complete，参数 id=挂号ID；页面允许 status=1 或 4。
+
+权限：
+
+- doctor.appointment/addDoctorNote
+- tcm.diagnosis/edit
+- doctor.appointment/complete
+
+源码中的“通知医助”和“发起通话”按钮没有 v-perms；只能依赖页面菜单权限和后端接口鉴权，桌面端若拆成独立入口应补显式能力判断。
+
+### 4.2 我的处方库
+
+源码：
+
+- D:\web\zyt\admin\src\views\consumer\prescription\list.vue
+- D:\web\zyt\admin\src\api\tcm.ts
+- D:\web\zyt\admin\src\components\medicine-name-select\index.vue
+
+模型与筛选：
+
+- 查询：prescription_name、formula_type（主方/辅方）、is_public（0 仅自己、1 所有人）。
+- 列表：id、prescription_name、formula_type、herbs、is_public、disable_edit、creator_id/name、create_time。
+- herbs 项：medicine_id（可选）、name、dosage。
+- 编辑：id、prescription_name、formula_type、herbs、is_public、disable_edit。
+- disable_edit=1 表示导入模板后锁定整张处方的药材，不可增删改，只能再次导入覆盖。
+
+接口：
+
+- GET /tcm.prescriptionLibrary/lists
+- POST /tcm.prescriptionLibrary/add
+- POST /tcm.prescriptionLibrary/edit
+- POST /tcm.prescriptionLibrary/delete，参数 id
+- GET /tcm.prescriptionLibrary/detail，参数 id（API 已封装，但当前列表弹窗直接使用行数据）
+
+权限：
+
+- wcf.prescription/add
+- wcf.prescription/read
+- wcf.prescription/edit
+- wcf.prescription/delete
+
+所有权：
+
+- 普通用户只可编辑/删除 creator_id 等于当前 userInfo.id 的模板。
+- root=1 或 role_ids 包含 0、3 可管理全部模板。
+- 诊间/已开处方导入模板时会额外传 prescribing_creator_id，通常取处方 creator_id，新增时取当前登录用户 id。
+
+### 4.3 药品库（容易和处方库混淆）
+
+源码：D:\web\zyt\admin\src\views\doctor\medicine.vue
+
+接口：
+
+- GET /doctor.medicine/lists
+- POST /doctor.medicine/add
+- POST /doctor.medicine/edit
+- POST /doctor.medicine/delete
+- GET /doctor.medicine/detail
+
+模型：
+
+- id、name、supplier、unit、settlement_price、retail_price、stock、image、status、remark。
+- 图片上传直接 POST 到 VITE_APP_BASE_URL + /api/upload/image，并携带 token 头。
+
+当前页面的增删改按钮没有 v-perms。它是药材主数据管理，不应直接当作“我的处方库”复刻。
+
+### 4.4 已开处方/处方管理
+
+源码：
+
+- D:\web\zyt\admin\src\views\consumer\prescription\index.vue
+- D:\web\zyt\admin\src\components\tcm-prescription\index.vue
+- D:\web\zyt\admin\src\api\tcm.ts
+
+列表筛选：
+
+- sn：处方编号模糊查；
+- patient_name；
+- creator_ids：开方医师多选；
+- audit_filter：all、pending、passed、not_passed、rejected；
+- source_filter：all、manual、system；
+- start_time、end_time（按创建时间）。
+
+列表核心字段：
+
+- id、sn、prescription_type；
+- is_system_auto：0 手工、1 空白处方/系统代开；
+- patient_name、gender、age、phone；
+- audit_status、audit_remark、business_prescription_audit_rejected、business_prescription_audit_remark；
+- void_status、void_by_name、void_time；
+- doctor_name、creator_id、assistant_name、prescription_date、create_time；
+- has_prescription_order。
+
+处方编辑/详情模型：
+
+- 关联：id、diagnosis_id、creator_id。
+- 患者：patient_name、gender、age、visit_no、prescription_date。
+- 诊断：tongue、tongue_image、pulse、pulse_condition、clinical_diagnosis。
+- 药材：herbs，每项 medicine_id、name、dosage、formula_type（主方/辅方）、locked。
+- 剂型/用法：prescription_type、dosage_amount、dosage_unit、dosage_bag_count、need_decoction、bags_per_dose、dose_count、dose_unit、usage_days、times_per_day、usage_instruction、usage_time、usage_way、dietary_taboo、usage_notes。
+- 辅方用法 aux_usage：dosage_amount、dosage_bag_count、need_decoction、bags_per_dose、times_per_day、usage_days、prescription_name（部分页面保留模板名）。
+- 医师：doctor_name、doctor_signature（PNG data URL，保存前必填）。
+- 可见性/审核：is_shared、visible_role_ids、audit_status、audit_time、audit_by_name、audit_remark。
+
+状态规则：
+
+- audit_status：0 待审核、1 已通过、2 已驳回。
+- 驳回处方会同时作废。
+- “已通过且未作废”的有效处方不能普通编辑/删除。
+- 新增时前端强制 audit_status=0；编辑保存后提示重新进入待审核。
+- 诊间开方组件会保存 case_record 病历快照，并在已有 appointment_id 处方时直接进入只读查看。
+- 已存在业务订单时，诊间组件禁止作废处方。
+
+主要接口：
+
+- GET /tcm.prescription/lists
+- GET /tcm.prescription/detail，参数 id
+- POST /tcm.prescription/add
+- POST /tcm.prescription/edit
+- POST /tcm.prescription/delete，参数 id
+- POST /tcm.prescription/patchPatient，参数 id、patient_name、phone、gender
+- POST /tcm.prescription/audit，参数 id、action=approve|reject、remark
+- POST /tcm.prescription/void，参数 id
+- GET /tcm.prescription/listByDiagnosis，参数 diagnosis_id
+- GET /tcm.prescription/getByAppointment，参数 appointment_id
+
+权限：
+
+- cf.prescription/add、read、edit、audit、del
+- tcm.prescription/patchPatient
+- tcm.prescriptionLibrary/lists
+- tcm.prescriptionOrder/create、lists、setShipMode
+- finance.account_log/lists
+- tcm.prescriptionOrder/editRemarkExtra
+
+角色补充：消费者处方页将 root 或 role_ids 0、3 视为可审核角色；仍应以后端和 cf.prescription/audit 为最终判定。
+
+### 4.5 处方业务订单
+
+源码：
+
+- D:\web\zyt\admin\src\views\consumer\prescription\order_list.vue
+- D:\web\zyt\admin\src\views\consumer\prescription\components\PrescriptionOrderDetailDrawer.vue
+- D:\web\zyt\admin\src\views\consumer\prescription\components\prescription-order-utils.ts
+
+此页面是已开处方的相邻履约域。核心字段：
+
+- id、order_no、prescription_id、diagnosis_id；
+- recipient_name、recipient_phone、region、shipping_address；
+- fee_type、amount、internal_cost；
+- prescription_audit_status、payment_slip_audit_status；
+- fulfillment_status；
+- linked_pay_order_count、linked_pay_order_id、linked_pay_paid_total；
+- medication_days、service_channel、service_package；
+- express_company、tracking_number、ship_mode；
+- doctor_name、creator_id/name、assistant_id；
+- remark_extra、remark_assistant；
+- 药房提交号和状态。
+
+审核状态统一为 0 待审核、1 已通过、2 已驳回。履约状态：
+
+- 1 待双审通过
+- 2 待发货
+- 3 已完成
+- 4 已取消
+- 5 已发货
+- 6 已签收
+- 7 进行中
+- 8 暂不制药
+- 9 拒收
+- 10 退款
+- 11 保留药方
+- 12 制药缓发
+
+核心接口：
+
+- GET /tcm.prescriptionOrder/lists、detail、paidPayOrders、logs、logisticsTrace、export
+- POST /tcm.prescriptionOrder/create、edit、withdraw、ddcode
+- POST /tcm.prescriptionOrder/auditPrescription、auditPayment、revokeRxAudit、revokePayAudit
+- POST /tcm.prescriptionOrder/ship、complete、refund、requestCompletion
+- POST /tcm.prescriptionOrder/addPayOrder、linkPayOrder
+- POST /tcm.prescriptionOrder/patchPrescriptionPatient、patchPrescriptionUsage、updateAmount
+- POST /tcm.prescriptionOrder/setShipMode、uploadToPharmacy
+- POST /tcm.prescriptionOrder/submitGancaoRecipel、previewGancaoRecipel、confirmGancaoSubmission
+- POST /tcm.prescriptionOrder/batchAssignAssistant、addLog
+
+主要权限：
+
+- tcm.prescriptionOrder/detail、edit、export、ddcode、ship、addPayOrder、complete、refund、withdraw
+- tcm.prescriptionOrder/auditPrescription、auditPayment
+- tcm.prescriptionOrder/setShipMode、uploadToPharmacy、editRemarkExtra
+- finance.account_log/lists、prescription.order/finance
+
+前端还存在角色级显示规则：
+
+- role 2：医助；
+- role 6：下单角色；
+- role 3、8：下单筛选豁免；
+- role 0、3、6：财务字段；
+- role 0、3：可绕过双审后的创建人编辑锁、可批量改派；
+- 业务订单处方审核角色在共享工具中为 0、3、6。
+
+这些数字与服务端配置耦合，不宜在新客户端再次散落硬编码。
+
+### 4.6 我的患者
+
+首选医生端实现：
+
+- D:\web\zyt\admin\src\views\first_visit\my_patients\index.vue
+- D:\web\zyt\admin\src\api\first_visit.ts
+
+页面结构：
+
+- “患者列表”“订单管理”“面诊进度”三个工作区。
+- 筛选 keyword、status_filter、start_date、end_date。
+- status_filter：unbooked 未预约、pending_interview 待面诊、completed 已完成、missed 已过号。
+- 日期快捷：今天、明天、后天、近 7 天、近 30 天、自定义。
+- extend.summary 返回 today/tomorrow/day_after 计数。
+- extend.dates 返回对应日期。
+- extend.scope.label 直接展示后端判定的数据范围。
+
+列表使用字段：
+
+- diagnosis_id 或 id、source_patient_id；
+- patient_name、gender_desc、age、phone_masked、has_id_card；
+- assistant_id/name；
+- appointment_id、appointment_doctor_id/name、appointment_status、appointment_status_text、appointment_time_text；
+- revisit_count、confirmed、confirmation_text、diagnosis_date_text。
+
+操作与接口：
+
+- GET /firstvisit.myPatient/lists
+- GET /firstvisit.myPatient/assistants
+- POST /firstvisit.myPatient/assign：id、assistant_id、is_inherit=0|1
+- POST /firstvisit.myPatient/fillIdCard：id、id_card
+- POST /firstvisit.myPatient/createAppointment：预约完整参数
+- POST /firstvisit.myPatient/cancelAppointment：id=挂号ID
+- 订单工作区另使用 /firstvisit.myPatient/orders、orderDetail、orderEdit 及双审/发货/退款等受限代理接口。
+- 面诊进度使用 GET /firstvisit.myPatient/progress。
+
+权限：
+
+- tcm.diagnosis/edit
+- tcm.diagnosis/readonlyDetail
+- tcm.diagnosis/guahao
+- tcm.diagnosis/assign
+
+服务端按当前角色与部门范围裁剪数据；前端不自行拼接 doctor_id 或 department_id 来模拟数据权限。
+
+平台用户列表 D:\web\zyt\admin\src\views\consumer\lists\index.vue 使用 GET /user.user/lists，字段是 avatar、nickname、account、mobile、channel、create_time，只适合账号管理，不适合医生患者列表。
+
+### 4.7 问诊/挂号列表
+
+源码：
+
+- D:\web\zyt\admin\src\views\tcm\appointment\list.vue
+- D:\web\zyt\admin\src\api\doctor.ts
+
+默认条件：
+
+- status=1 待接诊；
+- start_date=end_date=今天；
+- date_preset=today；
+- 20 秒静默轮询；
+- include_status_counts=1 时从 extend.status_count 一次返回各状态角标。
+
+状态：
+
+- 1 待接诊/已预约
+- 2 已取消
+- 3 已完成
+- 4 已过号
+
+筛选：
+
+- patient_name、doctor_name；
+- status；
+- start_date、end_date、date_preset；
+- diagnosis_confirmed；
+- assistant_dept_id（选父部门含子级）。
+
+行字段：
+
+- id、patient_id、diagnosis_id；
+- patient_name、patient_phone、gender、age、height、weight；
+- doctor_id/name、assistant_name；
+- appointment_date、appointment_time、period；
+- diagnosis_confirmed；
+- has_prescription、prescription_is_system_auto、prescription_audit_status、prescription_void_status；
+- status/status_desc、remark。
+
+操作：
+
+- 编辑患者：复用诊单编辑抽屉。
+- 视频二维码：生成小程序码。
+- 通话：获取签名并打开 ChatDialog。
+- 完成：POST /doctor.appointment/complete，可同时 POST addDoctorNote。
+- 开方/查看：复用 TcmPrescription；有效已审核处方显示“查看”。
+- 取消：POST /doctor.appointment/cancel。
+
+权限：
+
+- tcm.diagnosis/edit
+- tcm.diagnosis/videoQr
+- doctor.appointment/prescription
+- doctor.appointment/complete
+- tcm.diagnosis/kaifang
+- doctor.appointment/cancel
+- doctor.appointment/addDoctorNote（完成时备注能力）
+
+角色判断：role_id 为 1 医生、2 医助；两者之外才显示医生姓名筛选。此处同时兼容 role_id 单值或数组，但其他页面多使用 role_ids，说明 user 模型尚未完全统一。
+
+### 4.8 诊单列表
+
+源码：
+
+- D:\web\zyt\admin\src\views\tcm\diagnosis\index.vue
+- D:\web\zyt\admin\src\views\tcm\diagnosis\edit.vue
+- D:\web\zyt\admin\src\views\tcm\diagnosis\readonly.vue
+
+列表筛选字段：
+
+- keyword、diagnosis_type、syndrome_type、assistant_id；
+- diagnosis_confirmed、appointment_date、has_appointment；
+- latest_appointment_start_date/end_date/channel_source；
+- latest_assign_start_date/end_date；
+- pending_booking、completed_appointment、pending_assign；
+- pending_assign_order_month、pending_assign_keyword；
+- sort_unserved_days。
+
+列表使用字段：
+
+- id、patient_name、gender_desc、age；
+- assistant_id/assistant、assign_read_at；
+- appointments 或聚合的 appointment_doctor_name、appointment_time_text、appointment_status；
+- has_appointment、diagnosis_confirmed；
+- has_prescription、followup_time_text、followup_doctor_name、followup_rx_voided；
+- unserved_days、last_blood_record_at；
+- video_call_hint。
+
+video_call_hint：
+
+- state：none、pending_room、live 等；
+- label；
+- start_time、end_time。
+
+操作权限：
+
+- tcm.diagnosis/add、edit、delete、readonlyDetail
+- tcm.diagnosis/assign
+- tcm.diagnosis/kaifang
+- tcm.diagnosis/guahao、guahaoLogList
+- tcm.diagnosis/videoQr
+- tcm.diagnosis/order
+- tcm.diagnosis/watchCall
+
+诊单编辑模型的核心字段：
+
+- 标识：id、patient_id。
+- 患者：patient_name、id_card、phone、gender、age、marital_status、height、weight、region。
+- 诊断：diagnosis_date、diagnosis_type、syndrome_type、diabetes_type、diabetes_discovery_year、local_hospital_diagnosis、local_hospital_name。
+- 指标：systolic_pressure、diastolic_pressure、fasting_blood_sugar。
+- 现病史多选：appetite、water_intake、diet_condition、weight_change、body_feeling、sleep_condition、eye_condition、head_feeling、sweat_condition、skin_condition、urine_condition、stool_condition、kidney_condition、fatty_liver_degree。
+- 既往史：past_history、trauma_history、surgery_history、allergy_history、family_history、pregnancy_history。
+- 医疗内容：symptoms、tongue_coating、pulse、treatment_principle、prescription、doctor_advice、remark、current_medications。
+- 归属与来源：assistant_id、status、create_source、show_card、external_userid。
+
+详情响应还使用 patient_basic_locked、can_edit_patient_basic、latest_prescription_order。手机号/身份证是否显示明文由 tcm.diagnosis/phonePlain 控制；已有身份证通常只有明文权限才能修改。
+
+诊单详情 Tab 权限：
+
+- tcm.diagnosis/chufang：处方
+- tcm.diagnosis/patientOrders：业务订单
+- tcm.diagnosis/huifang：视频回放
+- tcm.diagnosis/chat：聊天记录
+- tcm.diagnosis/assign 或 detail：指派记录
+- doctor.appointment/lists：挂号记录
+- tcm.diagnosis/dailyRecord：日常记录
+
+## 5. 视频问诊完整链路
+
+### 5.1 预约
+
+源码：D:\web\zyt\admin\src\views\tcm\diagnosis\appointment.vue
+
+目前预约类型只有 video。请求字段：
+
+- patient_id
+- doctor_id
+- appointment_date
+- period=all
+- appointment_time
+- appointment_type=video
+- remark
+- channel_source
+- channel_source_detail
+
+普通入口 POST /doctor.appointment/create；“我的患者”入口 POST /firstvisit.myPatient/createAppointment。可用时段来自 GET /doctor.appointment/availableSlots，字段 doctor_id、appointment_date、period=all，响应使用 slots[].time、slots[].available。页面还读取医生排班并限制不能重复预约当天 status=1/4 的号。
+
+### 5.2 医生发起通话
+
+生产主组件：D:\web\zyt\admin\src\components\chat-dialog\index.vue
+
+1. 页面调用 open({ patientId, patientName, diagnosisId })。
+2. POST /tcm.diagnosis/getCallSignature，请求 patient_id、diagnosis_id。
+3. 响应实际使用：
+   - sdkAppId
+   - userId（医生 IM/TRTC user ID）
+   - userSig
+   - patientUserId，缺省回退 patient_加患者ID
+   - assistant_id（群视频邀请）
+   - isLochostVod（是否启用浏览器本地录制）
+4. Chat UIKit 登录并创建与 patientUserId 的 C2C 会话。
+5. TUICallKitServer.init 初始化通话能力；只有成功后才显示 AudioCallPicker、VideoCallPicker 和群视频按钮。
+6. beforeCalling 时 POST /tcm.diagnosis/startCall：
+   - diagnosis_id
+   - patient_id
+   - call_type=2（视频）
+7. 呼叫状态进入 calling/connected 后从 TUIStore 或 TUICallEngine 捕获 roomID/strRoomID，再 POST /tcm.diagnosis/bindCallRoom：
+   - diagnosis_id
+   - room_id（字符串）
+8. bindCallRoom 的响应可带 cloud_recording.started、task_id、message；源码注释说明后端在这里触发腾讯云 CreateCloudRecording，混流模式由后端负责。
+9. 接通后，若 isLochostVod=true，前端从 TUICallKit 视频元素启动 MediaRecorder/Canvas 本地录制。
+10. 通话结束、挂断、IM 自定义挂断消息或用户关闭窗口时先 POST /tcm.diagnosis/endCall，再完成本地视频上传并 POST attachLocalCallRecording。
+
+群视频调用 TUICallKitServer.calls，userIDList=[patientUserId, assistant_id]，type=VIDEO_CALL。
+
+### 5.3 截屏、录制与回放
+
+关键文件：
+
+- D:\web\zyt\admin\src\utils\call-local-recorder.ts
+- D:\web\zyt\admin\src\utils\call-video-screenshot.ts
+- D:\web\zyt\admin\src\views\tcm\diagnosis\components\CallRecordPanel.vue
+- D:\web\zyt\admin\src\views\tcm\diagnosis\components\RecordingPlaybackBlock.vue
+
+视频浮窗“截屏”会：
+
+1. 抓取当前 video frame；
+2. 上传图片；
+3. POST /doctor.appointment/addDoctorNote，把路径追加到 tongue_images。
+
+通话记录字段：
+
+- id、call_type（1 语音、其他视为视频）
+- room_id
+- status：1 进行中、2 已结束、3 未接听、4 已取消
+- recording_status_text
+- recording_urls_list
+- start_time_text、end_time_text、duration_text
+
+接口：
+
+- GET /tcm.diagnosis/getCallRecords，diagnosis_id
+- POST /tcm.diagnosis/attachLocalCallRecording，diagnosis_id、file_url、可选 call_record_id
+- POST /tcm.diagnosis/createManualCallRecord，diagnosis_id
+- POST /tcm.diagnosis/startCloudRecording，diagnosis_id（API 有封装，主组件当前通过 bindCallRoom 的后端联动启动）
+
+### 5.4 医助旁观
+
+入口在诊单列表。只有同时满足：
+
+- 当前 userInfo.id 等于该诊单 assistant_id；
+- 拥有 tcm.diagnosis/watchCall；
+- video_call_hint.state=live；
+
+才可真正进入。
+
+GET /tcm.diagnosis/watchCall，参数 diagnosis_id，响应使用：
+
+- sdkAppId
+- userId
+- userSig
+- roomId 或 strRoomId
+- patientName
+
+旁观组件直接使用 trtc-sdk-v5 进入房间，只调用 startRemoteVideo，不开启本地摄像头或麦克风。pending_room 时显示入口提示但点击会阻止进入，等待房间号同步。
+
+### 5.5 视频二维码
+
+页面通过 POST /tcm.diagnosis/generateMiniProgramQrcode 生成 qrcode_url，常用字段：
+
+- diagnosis_id
+- patient_id
+- doctor_id（部分入口）
+- share_user_id
+- mini_program_path=pages/login/login（问诊列表入口）
+
+调用前先 GET 小程序配置并校验 app_id。
+
+## 6. API 总表
+
+所有 URL 会被请求层加上 baseUrl 和 adminapi 前缀；下表写的是 API 封装中的业务路径。
+
+### 6.1 认证
+
+| 方法 | 路径 | 关键请求/响应 |
+|---|---|---|
+| POST | /login/account | account、password、terminal；返回 token、is_paw、need_bind_work_wechat |
+| POST | /login/workWechatLogin | code、terminal；返回同登录结果 |
+| GET | /login/workWechatConfig | enabled、corp_id、agent_id |
+| GET | /auth.admin/mySelf | 返回 user、permissions、menu |
+| POST | /login/logout | 退出 |
+| POST | /login/changeFirstPassword | password、password_confirm |
+| POST | /auth.admin/bindWorkWechat | code |
+
+### 6.2 挂号与接诊
+
+| 方法 | 路径 | 关键字段 |
+|---|---|---|
+| GET | /doctor.appointment/lists | status、start_date、end_date、patient_name、doctor_name、diagnosis_confirmed、assistant_dept_id、page_no、page_size |
+| GET | /doctor.appointment/reception | id=挂号ID；返回 appointment、diagnosis、doctor_notes |
+| GET | /doctor.appointment/detail | id |
+| GET | /doctor.appointment/availableSlots | doctor_id、appointment_date、period |
+| POST | /doctor.appointment/create | patient_id、doctor_id、appointment_date/time、appointment_type、渠道等 |
+| POST | /doctor.appointment/cancel | id |
+| POST | /doctor.appointment/complete | id |
+| POST | /doctor.appointment/notifyAssistant | id |
+| POST | /doctor.appointment/addDoctorNote | diagnosis_id、content、tongue_images、report_files |
+| GET | /doctor.appointment/doctorNotes | diagnosis_id |
+| POST | /doctor.appointment/deleteDoctorNoteImage | note_id、image_type、image_path |
+
+### 6.3 诊单
+
+| 方法 | 路径 | 关键字段 |
+|---|---|---|
+| GET | /tcm.diagnosis/lists | 诊单列表全部筛选 + page_no/page_size；返回 lists/count/extend |
+| GET | /tcm.diagnosis/detail | id |
+| GET | /tcm.diagnosis/readonlyDetail | id；返回 appointment、diagnosis、unserved_days、last_blood_record_at、doctor_notes |
+| POST | /tcm.diagnosis/add | 完整诊单模型 |
+| POST | /tcm.diagnosis/edit | 完整诊单模型 |
+| POST | /tcm.diagnosis/delete | id |
+| POST | /tcm.diagnosis/assign | id、assistant_id、可选 is_inherit；批量场景由前端逐条调用 |
+| GET | /tcm.diagnosis/getAssistants | 医助选项 |
+| GET | /tcm.diagnosis/getDoctors | 医生选项 |
+| POST | /tcm.diagnosis/checkPhone | phone 及排除 id |
+| POST | /tcm.diagnosis/checkIdCard | id_card 及排除 id |
+| POST | /tcm.diagnosis/fillIdCard | id、id_card |
+| GET | /tcm.diagnosis/trackingWindow | id、start_date、end_date |
+| GET | /tcm.diagnosis/trackingNotes | diagnosis_id |
+| POST | /tcm.diagnosis/addTrackingNote | diagnosis_id、tracking_content |
+
+### 6.4 处方与业务订单
+
+处方、处方库、业务订单接口已在 4.2、4.4、4.5 分节完整列出。实现时必须保留三个资源命名空间，不要把 prescription、prescriptionLibrary、prescriptionOrder 合并成一个“处方”接口。
+
+### 6.5 视频
+
+| 方法 | 路径 | 关键字段 |
+|---|---|---|
+| POST | /tcm.diagnosis/getCallSignature | patient_id、diagnosis_id；返回 sdkAppId、userId、userSig、patientUserId、assistant_id、isLochostVod |
+| POST | /tcm.diagnosis/startCall | diagnosis_id、patient_id、call_type |
+| POST | /tcm.diagnosis/bindCallRoom | diagnosis_id、room_id |
+| POST | /tcm.diagnosis/startCloudRecording | diagnosis_id |
+| POST | /tcm.diagnosis/endCall | diagnosis_id |
+| GET | /tcm.diagnosis/getCallRecords | diagnosis_id |
+| POST | /tcm.diagnosis/attachLocalCallRecording | diagnosis_id、file_url、可选 call_record_id |
+| POST | /tcm.diagnosis/createManualCallRecord | diagnosis_id |
+| GET | /tcm.diagnosis/watchCall | diagnosis_id |
+| POST | /tcm.diagnosis/generateMiniProgramQrcode | diagnosis_id、patient_id、doctor_id、share_user_id 等 |
+
+## 7. 可复用约定
+
+1. 请求协议
+   - baseURL 来自 VITE_APP_BASE_URL，统一 URL 前缀 adminapi。
+   - token 放在名为 token 的请求头，不是 Bearer Authorization。
+   - POST 默认把 params 转为 body；GET 使用 params。
+   - 标准成功响应是 code=1，业务数据自动解包为 data。
+   - GET 网络失败默认最多重试 2 次，POST 不自动重试。
+
+2. 列表协议
+   - 请求 page_no、page_size。
+   - 响应 lists、count、extend。
+   - 定时刷新使用 getLists({ silent: true })，避免表格白屏闪烁。
+
+3. 标识约定
+   - diagnosis_id 是诊单主键。
+   - appointment.id 是挂号主键。
+   - prescription.id 是处方主键。
+   - prescriptionOrder.id 是处方业务订单主键。
+   - patientUserId 是腾讯云 IM/TRTC 用户名，通常 patient_加患者标识。
+
+4. 隐私
+   - 默认手机号 3-4-4 脱敏，身份证保留前 6 后 4。
+   - tcm.diagnosis/phonePlain 控制诊单编辑中的明文能力。
+   - 数据范围由后端按角色、部门、归属医助裁剪，前端只做 UI 能力门控。
+
+5. 复用组件
+   - 患者摘要/病例：PatientInfoCard、PatientCaseCard。
+   - 日常记录：DailyMatrix。
+   - 医生备注：NoteTimeline。
+   - 诊单编辑和只读：tcm/diagnosis/edit.vue 的 open、openViewOnly。
+   - 处方开立/查看：TcmPrescription 的 open、openById。
+   - 视频通讯：ChatDialog 的 open。
+   - 业务订单详情：PrescriptionOrderDetailDrawer。
+
+6. 状态文本
+   - 不建议在新客户端重复定义状态映射。优先抽取 D:\web\zyt\admin\src\views\consumer\prescription\components\prescription-order-utils.ts 中的审核、履约、支付、供货和物流格式化逻辑为共享领域模块。
+
+## 8. 未知点、歧义与风险
+
+1. 动态菜单缺口：admin 前端仓库没有生产环境 /auth.admin/mySelf 的 menu 数据，因此接诊台、处方库、患者、问诊列表的精确 URL、菜单标题和页面级 route.meta.perms 仍未知。
+2. API 类型不足：tcm.ts、doctor.ts 多数参数和返回值是 any；本文列出的响应字段来自实际页面读取，不等于完整服务端 schema。后续实现应抓取真实响应或检查服务端 DTO。
+3. patient_id 语义有重载：
+   - 挂号行中 patient_id 常被当作诊单/患者标识；
+   - 我的患者 openAppointment 又把 diagnosis_id 或 id 同时写进 id 和 patient_id；
+   - ChatDialog 则把它转换为 patient_前缀的腾讯云用户。
+   新客户端必须先确认数据库实体关系，不能只按字段名推断。
+4. 接诊台发起通话使用 diagnosis_id || row.id；row.id 本身是挂号 ID。若后端要求真正诊单 ID，这个回退可能只在特定历史数据下成立。
+5. 视频二维码参数疑点：tcm/appointment/list.vue 的一个入口把 diagnosis_id 赋为 row.doctor_id，而其他入口使用真正诊单 ID；这很可能是历史兼容或缺陷，应向后端核实后再复用。
+6. 权限命名不统一：
+   - 处方库用 wcf.prescription/*；
+   - 已开处方用 cf.prescription/*；
+   - 新增能力又混用 tcm.prescription/* 与 tcm.prescriptionOrder/*。
+   不能按字符串前缀自动推导资源。
+7. 角色配置存在差异：
+   - 消费者处方审核页面写死 0、3；
+   - 业务订单共享工具写死 0、3、6；
+   - 多处注释都声称与服务端配置一致。
+   最终角色应由服务端下发 capability，避免继续硬编码。
+8. 权限 UI 不是安全边界：部分接诊、药品和通话按钮没有 v-perms；所有写接口必须继续依赖服务端鉴权。
+9. 双 SDK 并存：
+   - 实际 ChatDialog 使用 @tencentcloud/call-uikit-vue；
+   - 未引用的 video-call/index.vue 使用 @trtc/calls-uikit-vue；
+   - 医助旁观直接使用 trtc-sdk-v5。
+   新项目应明确只保留一套主叫/被叫 UI SDK，并将纯 TRTC 旁观作为独立只拉流能力。
+10. src/components/video-call/index.vue 当前没有被任何 Vue/TS 源码引用，不应误认为生产主链。
+11. PatientCaseCard 的 caseTypeLabel 无论 consultation_type 都返回“复诊”，属于明显展示逻辑疑点。
+12. 录制启动/停止部分依赖 TUICallKit 内部 store、引擎属性和方法包装，升级腾讯云 SDK 时风险较高，必须用真实双端通话、拒接、对端挂断、网络中断和房间号延迟场景回归。
+13. 处方业务订单大量前端角色规则与 server/config/project.php 注释耦合；当前审计范围只有 admin 前端，无法验证服务端配置是否已同步。
+
+## 9. 面向新医生端的建议映射
+
+若新项目要复刻医生工作流，建议按领域而不是按现有目录命名：
+
+- /login：复用认证协议和企业微信登录。
+- /reception：复用接诊台队列、详情、5 秒静默刷新与 ChatDialog。
+- /prescription-library：复用 prescriptionLibrary 模板及所有权规则。
+- /prescriptions：复用 tcm.prescription 列表、审核、作废、打印/下载。
+- /patients：优先复用 firstvisit.myPatient，而不是 user.user/lists。
+- /consultations：复用 doctor.appointment/lists 的今天待接诊视图。
+- /diagnoses：复用 tcm.diagnosis/lists 的完整诊单工作台。
+- /video-consultation：主叫链路复用 ChatDialog/TUICallKit；医助旁观保持独立 TRTC 只拉流组件。
+
+这些建议 URL 是新端的信息架构建议，不是对 admin 当前动态 URL 的断言。

app/research/desktop_architecture.md

@@ -0,0 +1,461 @@
+# 医生桌面端工程架构与打包方案（Windows / macOS）
+
+> 结论先行：采用 **Python 3.12 + PySide6 Qt Widgets** 构建原生业务界面，以分层的 `httpx` API client 连接现有后端；会话、权限、离线队列和本地安全存储统一放在 core 层。视频不是整套应用的实现基础，而是独立的可选集成：只有当现有腾讯 TRTC Web 方案无法由原生 SDK 替代时，才在受限的 `QWebEngineView` 中承载单一视频页面。发布使用 **PyInstaller onedir**，Windows 与 macOS 必须在各自原生 CI runner 上分别构建、签名和验收，不能交叉编译。
+
+## 1. 已知上下文、边界与待确认项
+
+本结论只对 `admin/package.json` 和环境配置做了最小只读核对，没有审计管理端实现。
+
+- 管理端以 `VITE_APP_BASE_URL` 注入后端根地址；示例文件故意留空，开发示例注释仅以 `http://127.0.0.1:8080` 举例。现有环境文件还出现了 `https://css.zhenyangtang.com.cn/`、`https://admin.zhenyangtang.com.cn/` 和 60 秒请求超时，但这些地址可能是网关或前端站点，**不能据此认定为稳定的桌面 API 地址**。
+- 管理端依赖包含 Axios、腾讯 TRTC/Call/Chat UI、`hls.js` 和 COS JS SDK。可以据此判断视频、聊天、流媒体和对象存储是潜在集成面，但不能推断接口路径、认证协议、权限码或 RTC 凭证格式。
+- 桌面端不得读取或复用 Vite 环境变量，不得硬编码管理端 URL，也不得在客户端持有 COS Secret、TRTC SecretKey 或任何服务端签名密钥。
+
+编码前必须由后端确认以下契约，并固化为 OpenAPI 或最小接口文档：
+
+1. API 的正式 base URL、版本前缀、响应 envelope、错误码、分页和时间格式。
+2. 登录协议（账号密码、短信、SSO/OIDC 或 Cookie）、access/refresh 生命周期、登出和吊销语义。
+3. `/me` 等当前用户接口返回的医生身份、机构/租户、角色与细粒度权限码。
+4. 预约、患者、病历、处方等写操作的幂等键、乐观锁版本号及审计要求。
+5. 聊天的拉取/推送协议、断线续传游标；COS 上传应由后端提供短期预签名 URL 或临时凭证。
+6. TRTC 房间、`userSig` 等凭证必须由后端短时签发；确认现有 Web 页面能否作为受支持的嵌入入口。
+7. 桌面端的 CORS、代理、私有 CA、设备绑定、强制升级和最低版本策略。
+
+在这些问题确认前可以完成壳层、接口抽象和模拟服务器，但不应猜测生产 endpoint。
+
+## 2. 目标平台与技术选择
+
+### 2.1 建议支持矩阵
+
+| 项目 | 首发建议 | 说明 |
+| --- | --- | --- |
+| Python | CPython 3.12，固定 patch 版本 | 生命周期长，第三方包成熟；每个平台使用相同 minor |
+| Windows | Windows 10 22H2 / Windows 11，x86-64 | ARM64 可作为后续独立制品，不与 x64 混装 |
+| macOS | macOS 13+，先 arm64，再按客户量增加 x86-64 | 当前 PySide6 wheel 的最低系统版本必须在锁版本时再次核对 |
+| UI | PySide6 Qt Widgets | 医疗表单、表格、快捷键、打印和可访问性更稳定 |
+| 视频 | 可选 PySide6 Addons / QtWebEngineWidgets | 只隔离承载视频页，不用 WebEngine 包住整个应用 |
+| 打包 | PyInstaller onedir | 对 QtWebEngine helper、资源、签名和启动性能最稳妥 |
+
+macOS 推荐分别产出 `arm64` 与 `x86_64` 制品。`universal2` 只有在 Python、PySide6 和所有二进制依赖均提供 universal2 slice，且真实验证签名/视频后再启用；两个单架构制品更易排障且体积更小。
+
+### 2.2 依赖分档
+
+建立一份代码、两种构建 profile：
+
+- `core`：`PySide6-Essentials`、`httpx`、`pydantic`、`pydantic-settings`、`platformdirs`、`keyring`、`cryptography`。包含 QtCore/Gui/Widgets/Network/Sql/Svg/PrintSupport，不包含 WebEngine。
+- `video`：在 core 上增加与 Essentials **完全相同版本**的 `PySide6-Addons`，从而获得 QtWebEngineWidgets、WebChannel、Multimedia 等模块。
+- 开发/测试：`pytest`、`pytest-qt`、`respx`、`coverage`、`ruff`、`mypy`、`pip-audit`。
+- 构建：锁定 `PyInstaller` 及其 hooks 版本。以 2026-08-10 可验证组合为基线，可先验证 Python 3.12 + PySide6 Essentials/Addons 6.11.1 + PyInstaller 6.21.0；只有在两端打包 smoke test 通过后才更新锁。
+
+不要同时安装 PyQt、PySide2 或系统级 PySide6；必须从干净虚拟环境构建。使用平台专属、带 hash 的锁文件（例如 `requirements-win-x64.lock`、`requirements-macos-arm64.lock`），而不是在发布任务中直接安装“最新版”。
+
+如果所有医生都需要视频，可只发布 `video` 制品；仍保留 profile 边界，以便定位 WebEngine 问题。若视频是少数场景，可以发布 core 制品并在系统浏览器打开受支持的视频页，避免让每个安装包承担 Chromium 的体积和攻击面。
+
+## 3. 分层架构
+
+依赖方向固定为：`ui -> application -> domain`，`infrastructure` 在 composition root 中实现 domain/application 定义的 port。View 不允许直接调用 `httpx`、SQLite 或 keyring。
+
+```text
+app/
+├─ pyproject.toml                  # 项目元数据、依赖分组、工具配置
+├─ requirements/                  # 各 OS/架构的发布锁及 hash
+├─ src/
+│  └─ zyt_doctor/
+│     ├─ __main__.py              # 极薄入口，只调用 bootstrap.main()
+│     ├─ bootstrap.py             # QApplication、配置、DI、异常钩子、主窗口
+│     ├─ build_info.py            # 版本、commit、channel；构建时生成
+│     ├─ config/
+│     │  ├─ models.py             # 强类型配置及校验
+│     │  └─ loader.py             # defaults -> 受管配置 -> 开发环境变量
+│     ├─ domain/
+│     │  ├─ identity.py           # Principal、Tenant、Permission
+│     │  ├─ errors.py             # 与 UI/HTTP 无关的错误类型
+│     │  └─ ports.py              # Repository、Clock、SecretStore 等协议
+│     ├─ application/
+│     │  ├─ commands.py           # 写用例、幂等键和确认规则
+│     │  ├─ queries.py            # 读用例和缓存策略
+│     │  └─ result.py             # Result / Page / OperationState
+│     ├─ core/
+│     │  ├─ api/
+│     │  │  ├─ client.py          # httpx client、header、超时、重试
+│     │  │  ├─ auth.py            # token/cookie adapter 与 refresh single-flight
+│     │  │  ├─ errors.py          # HTTP/业务错误归一化
+│     │  │  ├─ models.py          # 公共 DTO
+│     │  │  └─ generated/         # 若有 OpenAPI，生成代码仅放此处
+│     │  ├─ session/
+│     │  │  ├─ manager.py         # 会话状态机、锁屏、租户切换、登出清理
+│     │  │  └─ permissions.py     # 权限快照与 guard
+│     │  ├─ storage/
+│     │  │  ├─ database.py        # SQLite、migration、单写线程
+│     │  │  ├─ secure_store.py    # Windows Credential Manager / macOS Keychain
+│     │  │  └─ cache.py           # 加密缓存、TTL、容量控制
+│     │  ├─ offline/
+│     │  │  ├─ connectivity.py    # 网络状态提示，不作为唯一真相
+│     │  │  ├─ outbox.py          # 离线写队列状态机
+│     │  │  └─ sync.py            # 重放、冲突和人工处理
+│     │  ├─ jobs.py               # QThreadPool 任务、取消、signal 适配
+│     │  ├─ events.py             # 进程内 typed event bus
+│     │  ├─ logging.py            # 脱敏日志和诊断包
+│     │  └─ paths.py              # QStandardPaths/platformdirs；绝不写 bundle
+│     ├─ modules/
+│     │  ├─ auth/
+│     │  ├─ dashboard/
+│     │  ├─ patients/
+│     │  ├─ appointments/
+│     │  ├─ consultations/
+│     │  ├─ medical_records/
+│     │  ├─ prescriptions/
+│     │  ├─ chat/
+│     │  ├─ followups/
+│     │  └─ settings/
+│     │     # 每个模块内含 domain.py、service.py、viewmodel.py、views.py、permissions.py
+│     ├─ integrations/
+│     │  ├─ realtime/             # WebSocket/轮询 adapter，不侵入模块
+│     │  ├─ object_storage/       # 仅消费后端预签名 URL/临时凭证
+│     │  └─ video/
+│     │     ├─ port.py            # join/leave/mute 等抽象
+│     │     ├─ external_browser.py
+│     │     └─ webengine.py       # 唯一允许 import QtWebEngine 的文件
+│     ├─ ui/
+│     │  ├─ shell/                # 导航、标题栏、全局离线/会话提示
+│     │  ├─ widgets/              # Loading、Empty、Error、PermissionDenied
+│     │  ├─ dialogs/
+│     │  └─ theme/
+│     └─ resources/               # qrc、图标、字体许可、翻译、默认配置
+├─ tests/
+│  ├─ unit/
+│  ├─ contract/
+│  ├─ integration/
+│  ├─ ui/
+│  ├─ packaging/
+│  └─ fixtures/                   # 全部为合成数据，禁止生产病患数据
+├─ packaging/
+│  ├─ windows/doctor-core.spec
+│  ├─ windows/doctor-video.spec
+│  ├─ macos/doctor-core.spec
+│  ├─ macos/doctor-video.spec
+│  ├─ macos/entitlements.plist
+│  └─ hooks/
+├─ scripts/                       # build、self-check、sign、notarize
+└─ docs/                          # API 映射、权限矩阵、发布 runbook
+```
+
+每个业务模块只公开一个 facade 和路由描述，例如 `ModuleDescriptor(id, title, permissions, view_factory)`。主壳根据权限注册菜单，模块内再对按钮和 command 做 guard；这样既不会形成一个巨型主窗口，也不会把权限判断散落在控件代码中。
+
+## 4. API client、并发和会话
+
+### 4.1 API client
+
+建议使用一个长生命周期 `httpx.Client`，由 composition root 创建并注入 service。所有同步请求放入 `QThreadPool/QRunnable`，结果通过 Qt signal 回到主线程；严禁 UI 线程阻塞网络。窗口关闭或查询条件变化时取消尚未开始的任务，并忽略带旧 generation id 的晚到响应。
+
+Client 的固定行为：
+
+- production base URL 只允许 HTTPS；HTTP 仅在 debug profile 且 host 为 localhost 时允许。
+- production 允许的 API、视频和上传 host 必须来自签名/受管配置或内置 allowlist，避免篡改本地配置后窃取 token。
+- 超时拆分为 connect/read/write/pool，不只设一个总数。可从 connect 10 秒、read 60 秒起步，上传/导出另设长超时。
+- 每次请求加入 `Authorization`（若契约采用 bearer）、`X-Request-ID`、客户端版本、平台、时区和租户信息；不得写入日志的 header 列表默认包含 Authorization、Cookie 和所有临时凭证。
+- GET/HEAD 和带服务端认可幂等键的写操作，才可对连接错误、超时、429、502、503、504 做指数退避 + jitter；遵守 `Retry-After`。验证错误、普通 4xx 和未知写请求不自动重试。
+- 所有关键 mutation 生成并持久化 `Idempotency-Key`，直到收到确定结果；请求超时后的状态为“结果未知”，先按键查询/重放，不能直接再创建一条。
+- 业务错误映射为稳定类型：`ValidationError`、`Unauthenticated`、`Forbidden`、`Conflict`、`RateLimited`、`Maintenance`、`TransportError`、`UnknownServerError`。UI 不解析后端文案。
+- 支持 ETag/版本字段做乐观锁。收到 409/412 时进入冲突页，展示服务器版本与本地草稿，不做静默覆盖。
+- 下载/上传流式处理并限制文件大小、MIME 和保存目录。COS 只使用后端签发的预签名 URL或短期临时凭证，绝不打包永久密钥。
+
+若后端有 OpenAPI，生成的 models/client 放入 `core/api/generated`，外面再包一层业务 adapter；模块不得直接依赖生成器的数据结构。若无 OpenAPI，先写小而明确的 typed endpoint，不做一个接受任意 path/dict 的“万能客户端”。
+
+实时聊天使用独立 adapter：WebSocket 可运行在一个后台 asyncio loop/thread 中，通过 signal 投递事件；实现心跳、指数重连、服务器 sequence/cursor 补拉、重复消息去重和应用休眠恢复。首版若后端没有可靠续传契约，应采用短轮询而不是假装 WebSocket 永不丢消息。
+
+### 4.2 Session 状态机
+
+`SessionManager` 是唯一会话真相，显式状态为：
+
+```text
+SIGNED_OUT -> AUTHENTICATING -> AUTHENTICATED
+AUTHENTICATED -> REFRESHING -> AUTHENTICATED
+AUTHENTICATED/REFRESHING -> LOCKED | EXPIRED | SIGNED_OUT
+```
+
+- access token 只保存在内存；需要“保持登录”时，refresh token 或可续期凭证保存在 OS keychain，不能放在 QSettings、SQLite 明文或日志。
+- `keyring` 启动时必须检查实际 backend。没有 Windows Credential Manager/macOS Keychain 等安全 backend 时禁用持久登录，而不是退化到明文文件。
+- 多请求同时遇到 401 时只能有一个 refresh 在飞行，其他请求等待同一个 future；refresh 失败统一切到 `EXPIRED`，避免 401 风暴。
+- 登出、切换医生或切换租户时：取消网络任务、停止实时连接、退出视频、清内存 token、清空 WebEngine profile、关闭并按用户/租户清理本地缓存密钥。
+- 支持工作站空闲自动锁定。解锁方式由后端安全策略决定；锁定界面不得继续显示患者姓名、通知正文或缩略图。
+- 用 `QLocalServer/QLocalSocket` 实现单实例，第二次启动只唤醒现有窗口，避免同一用户同时运行两个 outbox。
+
+### 4.3 权限模型
+
+权限码由后端返回并作为服务端授权的镜像，例如 `patient.read`、`record.write`、`prescription.sign`；具体字符串必须以真实契约为准。
+
+客户端执行三层防误操作：
+
+1. 路由层：无模块权限时不注册菜单/路由。
+2. ViewModel/command 层：按钮显示与执行前都检查 `PermissionGuard.require(...)`。
+3. API 层：403 统一转为 `Forbidden`，刷新权限快照并提示“权限已变更”。
+
+这些仅改善体验，真正的 RBAC/ABAC、租户隔离和审计必须由后端再次校验。不能因为客户端隐藏了按钮就省略服务端授权。对开方、签名、删除等高风险操作增加 step-up authentication 或明确二次确认，并把 request id/idempotency key 传给服务端审计。
+
+## 5. 本地数据、离线与错误态
+
+### 5.1 数据目录与加密
+
+使用 `QStandardPaths` 或 `platformdirs` 获取每用户目录：Windows 通常位于 `%LOCALAPPDATA%`，macOS 位于 `~/Library/Application Support`。安装目录和 `.app` bundle 始终只读；业务代码不要访问 `sys._MEIPASS`，资源通过 `importlib.resources`/Qt resource system 读取。
+
+SQLite 使用 WAL、schema migration 和单写入 worker（或每线程独立 connection），不在线程间共享 `sqlite3.Connection`。默认只缓存必要元数据；如果确需缓存患者/病历或离线草稿：
+
+- 使用 `cryptography` 的 AES-GCM 做版本化记录加密，随机 nonce，密钥由 OS keychain 保存；AAD 包含 tenant/user/table/record id，防止记录调包。
+- outbox、cache 和密钥按机构 + 用户分区；退出账号做 crypto-erasure（删除密钥）并清理索引。SSD 上不能承诺可靠覆盖删除，因此不能用“反复覆盖文件”作为安全保证。
+- 设置缓存 TTL、容量上限和最少字段；搜索索引不放诊断正文等敏感内容。
+- QSettings 只保存主题、窗口大小等无敏感偏好。
+- 日志不记录患者姓名、手机号、证件号、病历正文、处方内容、token、Cookie 或 URL query；提供用户确认后的脱敏诊断包。
+
+### 5.2 离线策略
+
+不要只依赖系统“在线/离线”事件；真正状态以最近请求结果和轻量 health check 综合判定。主壳常驻显示 `在线 / 网络不稳定 / 离线 / 服务维护`，且标明数据最后更新时间。
+
+写操作按风险分类：
+
+| 类别 | 离线行为 | 恢复后 |
+| --- | --- | --- |
+| 只读列表/详情 | 展示有时间戳的加密缓存，明显标记“可能已过期” | 后台重新验证并原子替换 |
+| 普通草稿、低风险备注 | 可进入 outbox，保存幂等键、base version 和依赖 | 自动重放；冲突转人工处理 |
+| 病历最终提交、开方/签方、医嘱、删除等高风险操作 | 只允许保存为本地草稿，禁止假显示“已提交” | 恢复网络后重新拉取服务端版本，由医生确认再提交 |
+| 视频/实时聊天 | 显示不可用或重连，不能伪造发送成功 | 按 cursor 补拉并去重 |
+
+Outbox 状态至少包含 `QUEUED -> SENDING -> SUCCEEDED`，以及 `NEEDS_ATTENTION`、`DEAD_LETTER`。保存 payload schema version、创建人/租户、幂等键、重试次数、next attempt、最后错误和服务端 base version。只自动重放白名单 action；切换用户时绝不重放前一用户队列。
+
+### 5.3 统一错误体验
+
+所有页面复用下列状态组件，而不是把异常 traceback 或后端原文弹给用户：
+
+- 首次加载 skeleton；刷新时保留旧数据并显示非阻塞进度。
+- 真空数据（业务上没有记录）与加载失败严格区分。
+- 离线且有缓存、离线且无缓存、权限不足、登录过期、字段校验、版本冲突、维护中、未知错误各有独立文案和可行动按钮。
+- 未知错误显示 request id、发生时间、“重试/复制诊断编号”，详细堆栈只进入脱敏日志。
+- 全局未捕获异常写入 rotating log 并打开安全错误页；不要自动上传包含医疗数据的 crash dump。
+
+## 6. 视频与 QtWebEngine 的可执行边界
+
+### 6.1 首选集成顺序
+
+1. 先确认腾讯或现有供应商是否提供受支持的 Windows/macOS 原生桌面 SDK 以及 Python 可调用层。如果维护成本可接受，原生 adapter 最可控。
+2. 若现有成熟能力是 TRTC Web 页面，后端提供一个专用、窄功能、HTTPS 的 `/desktop-call` 类入口（实际路径待定），由 `QWebEngineView` 嵌入。
+3. 若 SDK/UA/DRM/屏幕共享在 Qt Chromium 中不受支持，可靠回退是系统默认浏览器，不通过修改 UA 或关闭浏览器安全策略强行兼容。
+
+不要把整套 admin 嵌入桌面壳。JS SDK 的版本和构建产物留在专用 Web 页面侧，Python 只持有 `VideoPort(join, leave, mute, device_changed)` 抽象，这样管理端升级 TRTC SDK 不要求桌面二进制同步发版。
+
+### 6.2 安全桥接
+
+- 桌面从后端申请一次性、短有效期的 call ticket；Web 页面再用 ticket 换房间凭证。禁止把 access token、`userSig` 长期放在 URL、日志或 localStorage。
+- 使用专用 `QWebEngineProfile`。优先 off-the-record；若必须持久化设备选择，也只能保存无认证数据。通话结束时清 Cookie、HTTP cache、permissions 和页面内容。
+- 导航只允许精确的 HTTPS origin/path allowlist；拦截新窗口、任意下载、`file://`、未知 scheme、跨域跳转和证书错误。证书错误 fail closed。
+- 相机/麦克风权限只对当前 allowlisted 通话 origin、活跃通话和明确用户操作放行，结束即撤销。屏幕共享另做显式确认。
+- 若使用 Qt WebChannel，bridge 只暴露少量 typed method/signal，不暴露文件系统、shell、通用 HTTP client、token getter 或任意 Python 调用。每次调用再次校验当前 page origin 和 session/call id。
+- release 不启用 remote debugging，不设置 `QTWEBENGINE_DISABLE_SANDBOX=1`，不使用 `--no-sandbox`。应用也不以管理员/root 身份运行。
+
+### 6.3 兼容性与体积现实
+
+`PySide6` 顶层 wheel 会同时拉入 Essentials 和 Addons；core profile 应直接依赖 `PySide6-Essentials`。WebEngine 位于 Addons，wheel 和最终制品都会显著增大，不能把它当成“小插件”。最终体积以两端产物为准，不承诺一个固定数字。
+
+QtWebEngine 使用多进程 Chromium，发布物必须保留：
+
+- `QtWebEngineProcess` helper；
+- QtWebEngineCore/Widgets 库与所需平台插件；
+- `qtwebengine_resources*.pak`、`icudtl.dat`、V8 snapshot；
+- `qtwebengine_locales`（至少完整验证 `zh-CN`、`en-US` 后才可裁剪）；
+- macOS framework/helper 的 bundle 结构和 entitlements。
+
+H.264/AAC/MP3 等专有 codec 是否可用取决于 QtWebEngine 构建与许可，不能因为 `hls.js` 存在就假设一定能播放。首发验收必须覆盖真实 TRTC/WebRTC、摄像头、麦克风、扬声器切换、屏幕共享（若需求存在）、HLS/录播格式和弱网；若要自行构建启用 proprietary codecs，先完成专利/分发许可评审。
+
+## 7. PyInstaller 构建与发布
+
+### 7.1 为什么固定 onedir
+
+虽然 PyInstaller 支持 onefile，但本项目默认 `onedir`：
+
+- onefile 每次启动需解压大体积 Chromium，冷启动慢，易触发杀软且临时目录空间不可控；
+- WebEngine 是多进程，helper、framework、资源和 macOS 签名/沙箱都依赖正确目录结构；
+- onedir 更容易做增量诊断、签名验证和 installer 管理。
+
+用户最终仍拿到一个 `.exe` 安装程序或 `.dmg/.pkg`，无需手动管理 onedir 目录。
+
+### 7.2 spec 设计原则
+
+维护四个薄 spec，公共配置放 `packaging/common.py`。入口始终为 `src/zyt_doctor/__main__.py`，`pathex=["src"]`；只收集应用 resources 和必要 metadata。WebEngine profile 因 `integrations/video/webengine.py` 中有显式 import，触发 PyInstaller 官方 PySide6 hook；如通过 feature registry 动态加载，再显式加入这些 hidden imports：
+
+```python
+VIDEO_HIDDEN_IMPORTS = [
+    "zyt_doctor.integrations.video.webengine",
+    "PySide6.QtWebEngineCore",
+    "PySide6.QtWebEngineWidgets",
+    "PySide6.QtWebChannel",
+]
+
+# core spec 中排除，且 core 构建环境根本不安装 Addons
+CORE_EXCLUDES = [
+    "PySide6.QtWebEngineCore",
+    "PySide6.QtWebEngineWidgets",
+    "PySide6.QtWebEngineQuick",
+]
+```
+
+不要手工把整个 `site-packages/PySide6` 复制进 datas，也不要用 `collect_all("PySide6")`；这会拉入无关 Qt 模块并可能破坏 hook 期望的目录。优先依赖当前锁定 PyInstaller 的 Qt hooks，仅对 self-check 证实遗漏的自有动态模块写自定义 hook。
+
+macOS `BUNDLE` 至少设置稳定的 bundle id、版本、图标，并在 `Info.plist` 中写清：
+
+```python
+info_plist = {
+    "CFBundleIdentifier": "com.zhenyangtang.doctor",
+    "NSCameraUsageDescription": "用于医生视频问诊",
+    "NSMicrophoneUsageDescription": "用于医生视频问诊",
+    "NSHighResolutionCapable": True,
+}
+```
+
+仅当有实际功能时再加入其他 TCC 权限说明。不得加入放宽 ATS 的全局例外。Windows spec 使用有版本信息的 manifest、`.ico` 和 GUI subsystem，同时保留内部异常日志；开发 smoke build 可临时打开 console。
+
+### 7.3 构建命令骨架
+
+Windows x64 runner：
+
+```powershell
+py -3.12 -m venv .venv-build
+.venv-build\Scripts\python -m pip install --require-hashes -r requirements\video-win-x64.lock
+.venv-build\Scripts\python -m PyInstaller --noconfirm --clean packaging\windows\doctor-video.spec
+dist\DoctorDesktop\DoctorDesktop.exe --self-check
+```
+
+macOS arm64 runner：
+
+```bash
+python3.12 -m venv .venv-build
+.venv-build/bin/python -m pip install --require-hashes -r requirements/video-macos-arm64.lock
+.venv-build/bin/python -m PyInstaller --noconfirm --clean packaging/macos/doctor-video.spec
+dist/DoctorDesktop.app/Contents/MacOS/DoctorDesktop --self-check
+```
+
+PyInstaller 不能从 Windows 生成 macOS `.app`，反之亦然。每次构建从干净环境执行 `--clean`，记录 Python/PySide6/PyInstaller/OS SDK 版本、锁文件 hash、git commit 和产物 SHA-256，保证可追溯。
+
+### 7.4 WebEngine 自检
+
+应用提供 `--self-check`，不访问患者数据，检查：
+
+- build info、只读 resources、可写 data/log/cache 路径；
+- keyring backend 是否安全、SQLite migration 是否可运行；
+- TLS CA、production 配置和 host allowlist；
+- video profile 中通过 `QLibraryInfo` 定位 helper/resources/locales，禁止依赖写死的 `_internal` 路径；
+- release 环境没有 `QTWEBENGINE_DISABLE_SANDBOX`/`--no-sandbox`；
+- GUI smoke 模式实际创建 `QWebEngineView`，加载本地无网络测试页，然后退出；真实视频另由端到端测试覆盖。
+
+任何 helper、`.pak`、ICU、snapshot、platform plugin 或 locale 缺失都应让发布流水线失败，不在运行时静默降级。
+
+### 7.5 Windows 发布
+
+1. 使用固定、受控的 Windows x64 runner 构建；不要在装有多套 Qt/Anaconda 的个人机上发正式包。
+2. QtWebEngine 运行依赖合适的 MSVC runtime。由安装器包含/检查 Microsoft Visual C++ Redistributable（Qt 官方要求的版本下限需按锁定 Qt 再核对），并在干净 VM 验证。
+3. 用组织的 Authenticode 证书和 RFC 3161 时间戳签名主程序及最终 MSI/EXE 安装器；验证 `signtool verify /pa /all`。
+4. 安装到 Program Files，用户数据仍进 LocalAppData；普通用户可运行/升级。可用 WiX Toolset/MSIX 或 Inno Setup，选择后固定 UpgradeCode/AppUserModelID 和回滚策略。
+5. 在 Windows 10/11 干净 VM 上验证安装、升级、卸载后保留/清除用户数据的明确策略、SmartScreen、企业代理、中文路径和非管理员账户。
+
+### 7.6 macOS 发布
+
+1. 在目标架构的 macOS runner 构建。PyInstaller 修改 Mach-O 后必须重新签名；使用 Developer ID Application 身份，不用 ad-hoc 签名发布。
+2. QtWebEngine helper 是嵌套 app/process。必须保留 framework bundle 结构，并确认 helper 使用 Qt 自带的 `QtWebEngineProcess.entitlements` 所需权限签名；主 app 使用项目的 camera/microphone 权限说明和最小 entitlements。签名顺序由内向外，避免用 `codesign --deep` 掩盖错误。
+3. 执行 `codesign --verify --deep --strict --verbose=2 DoctorDesktop.app` 和 `spctl --assess --type execute`；随后用 `xcrun notarytool submit ... --wait` 公证，staple ticket，再在离线干净 Mac 验证 Gatekeeper。
+4. 用 DMG/PKG 或能保留 symlink 的方式分发。PyInstaller 6+ 的 POSIX bundle 广泛使用 symlink，普通 zip 若不保留 symlink 可能膨胀或破坏运行。
+5. 在 Intel（若支持）与 Apple Silicon 真机上分别验证 keychain 升级连续性、摄像头/麦克风 TCC、休眠唤醒、Retina、多显示器和 WebEngine helper 签名。
+
+### 7.7 常见打包坑清单
+
+- **Qt binding 混装**：同环境存在 PyQt/PySide2 或系统 Qt，hook 收到冲突库。解决：干净 venv、只安装一种 binding、锁版本。
+- **误用 onefile**：启动慢、helper/沙箱/签名问题更难复现。解决：正式版固定 onedir。
+- **动态 import 未分析**：业务模块或 WebEngine 在 registry 中字符串加载。解决：显式 import 或最小 hiddenimports，并用 frozen smoke test 覆盖。
+- **资源路径错误**：开发机相对路径可用，安装后 CWD 变化。解决：`importlib.resources`/qrc；用户数据用 QStandardPaths。
+- **过度裁剪 Qt**：删除 `.pak`、ICU、snapshot、locale、platform plugin 后只在某些机器崩。解决：先保留 hook 输出，按真实清单与测试有证据地裁剪。
+- **macOS 签名次序/entitlements 错**：QtWebEngineProcess 启动即退出或 TCC 不弹窗。解决：嵌套 helper 真机测试、由内到外签、notarize/staple。
+- **归档破坏 symlink**：`.app` 体积暴涨或 framework 无法加载。解决：DMG/ditto 或明确保留 symlink 的归档工具。
+- **GPU/远程桌面差异**：WebEngine 黑屏。不要默认全局 `--disable-gpu`；收集诊断后提供经验证的软件渲染或外部浏览器 fallback。
+- **codec 误判**：开发机能播 H.264，发布 wheel 不能播。解决：把真实媒体矩阵列入 artifact 验收和许可评审。
+- **杀软与信誉**：大量 DLL/helper 或未签名 nightly 被拦截。解决：正式证书、时间戳、稳定 installer identity、干净 VM/主流安全软件测试。
+- **升级破坏 keychain/数据**：bundle id、签名 identity 或 schema 不稳定。解决：这些值从首版固定，migration 支持备份与回滚。
+
+## 8. 安全与隐私基线
+
+- TLS 校验永远开启。企业私有 CA 应通过受管安装进入系统 trust store；不得用 `verify=False`。如需兼容企业代理，可用 `truststore` 接入 OS 证书库并做专项测试。
+- 本地配置不能提供任意 production host 重定向；敏感 token 永远不进入 URL query、clipboard、日志、analytics 或 crash report。
+- HTML 病历优先用受限 `QTextBrowser`/原生富文本展示并在服务端净化；不要因为“要展示 HTML”就引入 WebEngine。任何外链由用户确认后交给系统浏览器。
+- 限制剪贴板和通知中的患者信息；自动锁定后遮蔽窗口内容。截图阻止在跨平台上不可靠，不能作为合规控制。
+- 所有高风险业务写操作由服务端保留不可抵赖审计；客户端日志只记录事件名、耗时、状态、request id 和脱敏技术上下文。
+- 发布前完成依赖 SBOM、许可证清单和漏洞扫描。PySide6 采用 LGPLv3/GPLv3 或商业许可，QtWebEngine/Chromium/codec 还包含额外 notices；由法务确认采用的 Qt 许可与分发义务，安装包附第三方 notices。
+- 自动升级若后续实现，更新 manifest 必须签名，制品必须校验 SHA-256 与平台签名，并支持回滚；首版宁可用已签名安装器提示升级，也不要执行未签名下载内容。
+
+## 9. 测试与发布门槛
+
+### 9.1 自动化测试分层
+
+- **unit**：权限 guard、会话状态机、单飞 refresh、重试白名单、错误映射、缓存 TTL、加解密、outbox 状态和冲突决策。用 fake clock/random/secret store，保证确定性。
+- **API contract**：以 OpenAPI schema 或后端 mock 验证字段、错误码、分页、时间和幂等语义；`respx` 模拟超时、断流、401 并发、429/Retry-After、5xx 和结果未知。
+- **integration**：临时 SQLite + fake keyring + staging API，覆盖 migration、损坏缓存、磁盘满、退出清理、租户切换和代理/私有 CA。
+- **UI**：`pytest-qt` 验证路由权限、loading/empty/error/offline、键盘导航、取消和 late response；不要用脆弱的像素级截图替代行为断言。
+- **frozen artifact**：Windows/macOS 各自安装后运行 `--self-check`，启动主窗口、登录 mock/staging、访问资源、写用户目录、升级 migration、卸载。
+- **视频真机**：摄像头/麦克风授权与拒绝、无设备、设备热插拔、回声设备、弱网/断网重连、休眠唤醒、屏幕共享、录播 codec、结束后权限与 Cookie 清理。
+
+重点故障用例包括：十个请求同时 401、提交后响应丢失、服务器版本冲突、系统时钟偏差、刷新时退出、缓存被截断、keychain 被锁、两实例竞争、磁盘只读、API 维护、WebEngine helper 被杀、证书过期。测试数据必须是合成数据。
+
+### 9.2 CI 矩阵与质量门槛
+
+PR 阶段可并行运行 Windows x64 和 macOS arm64 的 lint/type/unit/UI headless 测试。release tag 阶段在原生 runner 生成制品并执行：
+
+1. `ruff`、`mypy`、unit/contract/integration 测试全绿，覆盖率阈值重点约束 core 状态机而非 UI 行数。
+2. 依赖 lock、SBOM、license、`pip-audit` 无未批准的高危项。
+3. 两端 frozen self-check 与安装/升级 smoke 通过。
+4. 签名、公证、hash、版本资源和 update channel 验证通过。
+5. video profile 在目标硬件的人工/自动验收清单签字；core profile 证明不会意外收集 QtWebEngine。
+6. staging 完成登录、权限变更、患者查询、一个低风险写操作、一个高风险确认、登出清理和离线恢复闭环。
+
+## 10. 实施顺序与验收里程碑
+
+### M0：契约和风险封板（约 3–5 天）
+
+- 获取 OpenAPI/认证/权限/RTC/对象存储契约；形成 endpoint 与权限矩阵。
+- 在 Windows/macOS 原型中用 QtWebEngine 打开专用测试页，验证 TRTC/WebRTC、设备权限和目标 codec。
+- 决定首发是 core、video 还是“core + 外部浏览器”。
+
+**退出条件**：API base 和 auth 不再是假设；视频路线有真实 PoC，而非只证明网页能打开。
+
+### M1：可发布骨架
+
+- 完成 bootstrap、配置校验、日志/路径、API client、SessionManager、PermissionGuard、shell 和统一状态组件。
+- mock server 下完成登录、`/me`、权限菜单、401 single-flight refresh、登出清理。
+- 两端 onedir unsigned nightly 可安装并通过 self-check。
+
+### M2：业务纵切
+
+- 先选一个完整纵切（例如预约 -> 患者概要 -> 诊间记录草稿），按 module 结构贯穿 UI、service、API、权限和测试。
+- 再并行扩展患者、病历、处方、随访、聊天；高风险操作必须有后端幂等/审计。
+
+### M3：离线与视频
+
+- 实现加密 cache/outbox、冲突页、断网/恢复和数据清理。
+- video adapter、受限 profile、一次性 ticket、权限撤销和外部浏览器 fallback 完成。
+
+### M4：生产发布
+
+- 锁依赖和 runner image，完成 Windows Authenticode、macOS Developer ID/notarization、SBOM/许可证。
+- 干净 VM/真机、企业代理、非管理员、升级/回滚、视频设备矩阵全部通过。
+
+## 11. 最终架构决策摘要
+
+1. 业务 UI 用原生 Qt Widgets；QtWebEngine 是隔离的视频实现细节，不是应用架构。
+2. 后端契约、服务端授权和服务端审计是权威；桌面端只做强类型 adapter、体验 guard 和安全状态管理。
+3. access token 仅在内存，长期凭证进 OS keychain；敏感离线数据加密且按用户/租户隔离。
+4. 高风险医疗写操作离线时只能保存草稿，恢复后由医生确认；普通 outbox 依赖幂等键和乐观锁。
+5. 发布固定 PyInstaller onedir、平台原生构建、签名和 artifact 级测试；不交叉编译，不依赖开发机“能跑”。
+6. production URL、SDK secret、对象存储密钥和 RTC 签名密钥都不能硬编码进客户端。
+
+## 参考资料
+
+- [Qt for Python package details](https://doc.qt.io/qtforpython-6.10/package_details.html)：Essentials/Addons 拆分和 wheel 内容。
+- [Qt for Python 与 PyInstaller](https://doc.qt.io/qtforpython-6.10/deployment/deployment-pyinstaller.html)：官方 PyInstaller 基础部署说明。
+- [Qt WebEngine 部署](https://doc.qt.io/qt-6/qtwebengine-deploying.html)：helper、resources、locales、macOS entitlements 等必需项。
+- [Qt WebEngine features](https://doc.qt.io/qt-6/qtwebengine-features.html)：WebRTC/媒体能力及专有 codec 许可提醒。
+- [PyInstaller macOS multi-arch 与签名](https://pyinstaller.org/en/stable/feature-notes.html)：架构 slice 和 codesign 行为。
+- [PyInstaller symlink/common pitfalls](https://pyinstaller.org/en/stable/common-issues-and-pitfalls.html)：PyInstaller 6+ POSIX bundle 的 symlink 分发要求。
+

app/research/diagnosis_detail_visual_spec.md

@@ -0,0 +1,565 @@
+# 诊单详情 / 编辑 / 预约视觉规格（后台源码基准）
+
+## 1. 范围与判读原则
+
+本规格只以 `D:/web/zyt/admin` 当前源码为事实源，覆盖：
+
+- 三个主视图：`src/views/tcm/diagnosis/edit.vue`、`readonly.vue`、`appointment.vue`。
+- 三个主视图直接渲染的诊单组件：患者摘要、病例、日常记录、医生备注、处方/病例记录、业务订单、视频、聊天、医助指派历史、挂号历史、待办。
+- 备注视图直接引用的 `src/views/patient/reception/components/NoteTimeline.vue`。
+- 直接生效的全局样式入口、Element Plus 变量和 Tailwind 尺寸映射。
+
+颜色、尺寸若由当前文件明确声明，标为“显式”；若控件仅沿用 Element Plus，则标为“继承”。项目使用 Element Plus `^2.9.4` 与 Tailwind CSS `^3.4.17`（`package.json:27,64`）。全局样式入口为 `main.ts:1-3`，依次加载 `element.scss`、`dark.css`、`var.css`、`tailwind.css`、`public.scss`（`src/styles/index.scss:1-5`）。因此不能把浏览器/Element 默认值误写成某个业务组件的局部规格。
+
+> 关键结论：系统实际上有两种“只读详情”。`readonly.vue` 是独立、卡片化、纵向详情页；`edit.vue` 在 `viewOnly` 模式下则仍是右侧抽屉和 Tab 结构，只禁用编辑控件。两者不能用同一个线框替代。
+
+---
+
+## 2. 全局视觉基础
+
+### 2.1 字体与字号
+
+字体栈由 Tailwind 配置明确为 `PingFang SC, Arial, Hiragino Sans GB, Microsoft YaHei, sans-serif`（`tailwind.config.js:79-80`），并赋给 `--el-font-family`（`src/styles/var.css:1-3`）。基础字号如下（`src/styles/var.css:11-18`）：
+
+| 语义 | 实际字号 |
+|---|---:|
+| extra large | 18 px |
+| large | 16 px |
+| medium | 15 px |
+| base | 14 px |
+| small | 13 px |
+| extra small | 12 px |
+
+业务层进一步压缩：编辑抽屉根节点和表单文字为 12 px（`edit.vue:1476-1504,1532-1556`）；只读病例键值为 12.5 px（`components/PatientCaseCard.vue:307-341`）；聊天气泡为 14 px（`components/ImChatRecordPanel.vue:260-286`）。
+
+### 2.2 全局颜色与表面
+
+以下均为项目显式变量（`src/styles/var.css:20-40`）：
+
+| 用途 | 色值 |
+|---|---|
+| 页面底 | `#f6f6f6` |
+| 普通/浮层底 | `#ffffff` |
+| 主文字 | `#333333` |
+| 常规文字 | `#666666` |
+| 次要文字 | `#999999` |
+| placeholder | `#a8abb2` |
+| disabled | `#c0c4cc` |
+| border / light / lighter | `#dcdfe6` / `#e4e7ed` / `#ebeef5` |
+| extra-light border | `#f2f2f2` |
+| fill / light / lighter | `#f0f2f5` / `#f8f8f8` / `#fafafa` |
+| extra-light fill | `#fafcff` |
+
+Element 语义主色未在这些诊单文件中改写，局部引用 `var(--el-color-primary)` 或显式 `#409eff`。继承的 Element Plus 2.9.4 常规控件高度为 32 px（small 24 px、large 40 px）；但编辑抽屉底部按钮被局部覆盖为最小 40 px，移动端最小 44 px（`edit.vue:1732-1740,1905-1913`）。
+
+### 2.3 间距基线和全局行为
+
+Tailwind 间距映射是 4 px 基线：`1=4`、`2=8`、`2.5=10`、`3=12`、`3.5=14`、`4=16`、`5=20`、`6=24`（`tailwind.config.js:103-125`）。业务文件里的 8/10/12/14/16/18/20/24 px 与该节奏一致。
+
+直接影响这些页面的全局规则：
+
+- Dialog 居中，最大宽 `calc(100vw - 30px)`，圆角 5 px（`src/styles/element.scss:11-27`）。
+- 全局 Drawer 主内边距变量为 16 px，Header 内边距 `13px 16px`、下边框 1 px lighter；预约 Drawer 没有重写这些值，编辑 Drawer 则只额外重写背景与边框（`src/styles/element.scss:46-56`）。
+- 全局表格字号 14 px、表头主文字色、表头字重 400、表头底 `#f8f8f8`（`src/styles/element.scss:58-68`; `src/styles/var.css:10`）。因此编辑根节点的 12 px 不应错误地传成所有表格单元字号。
+- Input、Select、Textarea 聚焦时出现 2 px primary-light 外环，radio/checkbox active 也有 2 px 外环；校验错误时切换 danger-light 外环（`src/styles/element.scss:140-175`）。
+- Tabs 底线全局压至 1 px（`src/styles/element.scss:131-133`）。
+- 消息与通知层级为 9999（`src/styles/element.scss:1-9`）。
+- 小于等于 768 px 时分页隐藏页码跳转与 page-size 选择器（`src/styles/element.scss:177-183`）。
+- Tailwind 会导入 base/components/utilities（`src/styles/tailwind.css:1-3`），但 Element 按钮背景、focus、hover 被重新还原为 Element 变量，避免被 Tailwind reset 覆盖（`src/styles/element.scss:186-200`）。
+- `body` 为 14 px 主文字、`overflow:hidden`、最小宽 375 px；页面/Drawer 自己承担滚动（`src/styles/public.scss:1-3`）。全局 `.form-tips` 为 12 px secondary、行高 24 px、上间距 4 px（`src/styles/public.scss:4-6`）。
+
+暗色主题另有一套直接全局变量：页面/表面为 `#0a0a0a / #1d2124 / #1d1e1f`，主/常规/次要文字为 `#e5eaf3 / #cfd3dc / #a3a6ad`，边框从 `#636466` 到 `#2b2b2c`，遮罩为 `rgba(0,0,0,.8)`（`src/styles/dark.css:1-31`）。不过三个诊单主视图及卡片大量显式写入白底、浅蓝渐变和 slate 色，不能完整随暗色变量切换；本规格后续均按源码默认浅色态记录，暗色不能视为已完整适配。
+
+---
+
+## 3. 独立只读详情页 `readonly.vue`
+
+### 3.1 页面骨架
+
+源码结构是单列滚动页，不使用 Tabs（`readonly.vue:1-149`）：
+
+```text
+┌─────────────────────────────────────────────────────────────────────┐
+│ ← 返回   诊单只读详情                       张三  男 · 42岁 [未服务 3天] │
+├─────────────────────────────────────────────────────────────────────┤
+│ [患者信息摘要 PatientInfoCard]                                      │
+├─────────────────────────────────────────────────────────────────────┤
+│ [患者病例 PatientCaseCard]                                         │
+├─────────────────────────────────────────────────────────────────────┤
+│ [日常记录 DailyMatrix]                         按权限可见             │
+├─────────────────────────────────────────────────────────────────────┤
+│ [医生备注/舌象/报告 NoteTimeline]                                  │
+├─────────────────────────────────────────────────────────────────────┤
+│ [业务订单 PatientOrderList]                   按权限可见             │
+├─────────────────────────────────────────────────────────────────────┤
+│ [视频录制回放 CallRecordPanel]                按权限可见             │
+├─────────────────────────────────────────────────────────────────────┤
+│ [聊天 ImChatRecordPanel]                      按权限可见             │
+├─────────────────────────────────────────────────────────────────────┤
+│ [指派医助记录 AssignLogPanel]                 按权限可见             │
+├─────────────────────────────────────────────────────────────────────┤
+│ [挂号记录 AppointmentRecordPanel]             按权限可见             │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+渲染顺序严格来自 `readonly.vue:39-146`；异常时在 hero 下方显示错误空态（`readonly.vue:31-36`）。页面根容器垂直间距 16 px、内边距 16 px（`readonly.vue:269-273`）。
+
+### 3.2 顶部 Hero
+
+Hero 是可换行的左右布局：`display:flex; justify-content:space-between; flex-wrap:wrap; gap:12px`，内边距 `12px 16px`，圆角 12 px，边框 `#dde7ff`，背景为 `#f5f8ff → #eef3ff` 的浅蓝渐变（`readonly.vue:275-285`）。
+
+- 页面标题：16 px / 700（`readonly.vue:286-303`）。
+- 患者姓名：18 px / 700；性别年龄 13 px（`readonly.vue:305-320`）。
+- 未服务状态胶囊：12 px / 600，内边距 `4px 10px`，999 px 全圆角（`readonly.vue:323-330`）。
+- 状态色：正常绿 `#16a34a` / 边框 `#bbf7d0`；提醒橙 `#ea580c` / `#fed7aa`；严重红 `#dc2626` / `#fecaca`（`readonly.vue:332-355`）。从未记录时使用 Element placeholder 灰。
+
+### 3.3 卡片规格
+
+通用详情卡为白底、1 px `#e6ebf2` 边框、14 px 圆角、18 px 内边距、14 px 内部纵向间距和轻阴影（`readonly.vue:364-373`）。卡片标题 15 px / 700，标题前为 `3 × 16 px` 蓝色标记（`readonly.vue:375-396`）。DailyMatrix 外层额外 16 px 内边距以对齐矩阵（`readonly.vue:398-405`）。错误空态卡保持 14 px 圆角并有 40 px 纵向内边距（`readonly.vue:357-362`）。
+
+患者摘要内部是浅蓝 Hero 卡：圆角 12 px，内边距 `16px 18px`，行距 6 px；患者名 22 px / 700，其余信息 13 px、行高 1.7（`components/PatientInfoCard.vue:78-123`）。字段顺序是：
+
+1. 姓名。
+2. 脱敏手机 · 性别 · 年龄。
+3. 身高 / 体重 · 地区。
+4. 预约日期时间 · 时段。
+5. 医生 / 医助。
+6. 预约状态 · 是否已开方。
+7. 备注（有值才显示）。
+
+顺序由 `components/PatientInfoCard.vue:6-25` 确定。
+
+### 3.4 病例字段顺序与网格
+
+病例卡以分组标题 + 网格键值展示；组间 `gap:10px`，除首组外顶部 12 px 内边距并有 dashed 分隔线（`components/PatientCaseCard.vue:258-269`）。分组标题 13 px / 600、蓝色，前有 4 px 圆点（`components/PatientCaseCard.vue:271-287`）。网格横向间距 16 px、纵向 8 px，并提供 1/2/3/4 等分列（`components/PatientCaseCard.vue:289-305`）。键值字号 12.5 px、行高 1.55，label 最小宽 58 px；label 为 `#6b7280`，value 为 `#1f2937` / 500，空值为 `#c0c4cc`（`components/PatientCaseCard.vue:307-341`）。
+
+只读病例的真实字段顺序（`components/PatientCaseCard.vue:8-124`）：
+
+| 分组 | 列数 | 顺序 |
+|---|---:|---|
+| 基本信息 | 4 | 诊单ID、姓名、身份证、手机、性别、年龄、婚姻、地区 |
+| 生命体征 | 4 | 身高、体重、高压、低压、诊断类型、空腹血糖、在用药物（多行） |
+| 主诉 | 4 | 当地诊断日期、糖尿病病史、当地医院、当地医院诊断结果 |
+| 现病史 | 3 | 口腔、饮水、体重变化、脂肪肝、饮食（跨2列）、肢体、睡眠、眼、头、出汗、皮肤、小便、大便、腰肾、其他补充（跨3列、多行） |
+| 既往史 | 1 | 既往史（整行） |
+| 其他病史 | 混合 | 外伤、手术、过敏、家族、妊娠 |
+| 补充与意见 | 1 | 病史补充（有值才显示）、处方意见 |
+
+超标指标采用 `#dc2626`、700 字重并带上箭头（`components/PatientCaseCard.vue:343-358`）。处方意见为 13 px、`12px 14px` 内边距、8 px 圆角、左侧 3 px 蓝条（`components/PatientCaseCard.vue:360-368`）。
+
+### 3.5 响应式事实
+
+`readonly.vue` 自身没有 media query；Hero 仅通过 `flex-wrap` 避免左右信息互相挤压。`PatientCaseCard.vue` 也没有窄屏降列规则，所以 4 列病例网格不会自动变成 1 列。实现 PySide 时不能把“可换行 Hero”误判为整页已经完整响应式。
+
+---
+
+## 4. 编辑 / 抽屉只读 `edit.vue`
+
+### 4.1 框架与模式
+
+右侧 Drawer 宽度固定为视口的 60%，方向 RTL；只读时 z-index 4000，编辑/新增时 1500（`edit.vue:2-10`）。抽屉有三种标识：只读 `info`、新建 `success`、编辑 `warning`，标题下显示“患者名 · 诊单ID”（`edit.vue:11-54,859-863`）。
+
+```text
+桌面（右侧 60% Drawer）
+┌───────────────────────────────────────────────────────────────┐
+│ 编辑诊单 [编辑]                               患者名 · #123    │ Header
+├───────────────────────────────────────────────────────────────┤
+│ 病历 │ 医生备注 │ 日常记录 │ 处方 │ 业务订单 │ 视频 │ ... → │ Tabs
+├───────────────────────────────────────────────────────────────┤
+│                                                               │
+│  [锁定提示 / 隐私提示，按条件]                                │
+│  诊单ID        [_____________________________]                 │
+│  姓名          [____________]  身份证 [____________]          │
+│                                                               │
+│  ──────────────── 生命体征 ────────────────                    │
+│  婚姻 [____]   身高 [____]   体重 [____]                       │ Scroll body
+│  ...                                                          │
+│  ──────────────── 现病史 ─────────────────                    │
+│  [可换行 radio / checkbox 组]                                 │
+│                                                               │
+├───────────────────────────────────────────────────────────────┤
+│                                     [取消/关闭] [保存]         │ Footer slot
+└───────────────────────────────────────────────────────────────┘
+```
+
+`viewOnly` 模式没有切换到独立详情卡，而是给病历 `fieldset` 禁用输入，并隐藏保存；锁定患者信息时显示 warning alert（`edit.vue:57-84,766-781`）。
+
+### 4.2 Header、Tabs、Footer
+
+- Header 背景 `#fff → #f8fafc`，底边 1 px `#e2e8f0`（`edit.vue:1776-1785`）。标题 18 px / 600 / `#0f172a`，行高 1.3；副标题 13 px（`edit.vue:1670-1717`）。
+- Body 背景 `#f8fafc`（`edit.vue:1787-1790`）。
+- Tabs 横向滚动，滚动条 4 px；nav 使用 `max-content` 且最小宽 100%，tab 水平内边距 14 px，常态 `#64748b` / 500，激活态为 Element primary / 600，激活条 3 px（`edit.vue:1798-1858`）。
+- Footer 最终生效样式为白底、上边框 1 px `#e2e8f0`，内容右对齐、gap 12 px、内边距 `14px 20px 18px`（`edit.vue:1719-1730,1860-1864`）。按钮最小高 40 px、水平内边距 20 px、600 字重、圆角 10 px（`edit.vue:1732-1740`）。
+
+这里没有 CSS `position: sticky`。底部操作之所以视觉上固定，是因为它使用 Element Drawer 的独立 footer slot，位于可滚动 body 之外（模板 `edit.vue:766-781`；结构样式 `edit.vue:1792-1796`）。PySide 应以固定底栏实现，而不是在滚动内容末尾放按钮。
+
+### 4.3 Tab 顺序、权限与内容
+
+Tab 的准确顺序和门槛（`edit.vue:55-759`）：
+
+| 序号 | Tab | 条件 | 内容组件 |
+|---:|---|---|---|
+| 1 | 病历 | 始终 | 内联表单 |
+| 2 | 医生备注 | 始终 | `NoteTimeline` |
+| — | 跟踪备注 | **已注释，不渲染** | 原拟 `TrackingNoteTimeline`（`edit.vue:644-654`） |
+| 3 | 日常记录 | `tcm.diagnosis/dailyRecord` | `DailyMatrix` |
+| 4 | 处方 | `tcm.diagnosis/chufang` | `CaseRecordList` |
+| 5 | 业务订单 | `tcm.diagnosis/patientOrders` | `PatientOrderList` |
+| 6 | 视频录制回放 | `tcm.diagnosis/huifang` | `CallRecordPanel` |
+| 7 | 聊天 | `tcm.diagnosis/chat` | `ImChatRecordPanel` |
+| 8 | 指派医助记录 | `tcm.diagnosis/assign` 或 `tcm.diagnosis/detail` | `AssignLogPanel` |
+| 9 | 挂号记录 | `doctor.appointment/lists` | `AppointmentRecordPanel` |
+
+权限变化后若当前 Tab 失权，代码会主动回到 `basic`（`edit.vue:883-913`）。除病历外的大部分 Tab 为 lazy 内容，首次选中才加载。
+
+### 4.4 病历表单布局、标签和控件
+
+桌面表单 label width 为 160 px（`edit.vue:61-63`）。根字号、label、输入/textarea/radio/checkbox/button 均显式为 12 px；label 为 500 / `#606266`（`edit.vue:1476-1504,1532-1556`）。表单项底部间距 18 px（`edit.vue:1528-1530`）。输入、选择、日期、数字框圆角 10 px（`edit.vue:1645-1667`）；普通输入高度沿用 Element 32 px。
+
+分组标题的上/下外边距为 28/22 px；中间文字 14 px / 600 / `#0f172a`、`7px 16px` 内边距、999 px 胶囊圆角，两侧 1 px `#e2e8f0` 横线（`edit.vue:1506-1525`）。单选紧凑组换行、gap 12 px；复选组 gap `12px 16px`；普通 radio/checkbox 右、下间距分别 16/8 px（`edit.vue:1558-1604`）。帮助文本 12 px、`#909399`、行高 1.5、顶部 4 px（`edit.vue:1606-1611`）。
+
+### 4.5 编辑表单的真实字段顺序
+
+以下只列实际渲染字段，不把 `formData` 中未渲染的属性当作 UI（模板 `edit.vue:57-632`）：
+
+| 区段 | 栅格 | 字段顺序与控件 |
+|---|---|---|
+| 顶部 | 24 | 诊单ID（只读） |
+| 基本身份 | 12 + 12 | 姓名；身份证 |
+| 联系信息 | 12 + 12 | 手机；性别 |
+| 年龄 | 12 | 年龄 |
+| **生命体征** | 8 + 8 + 8 | 婚姻；身高；体重 |
+|  | 8 + 8 + 8 | 地区；高压；低压 |
+|  | 8 | 空腹血糖 |
+|  | 12 | 诊断类型 |
+|  | 12 + 12 | 状态；渠道 |
+|  | 12 | 统计端就诊卡 |
+|  | 12 | 在用药物，textarea，3 行，maxlength 2000 |
+| **主诉** | 12 + 12 | 当地诊断日期；糖尿病病史 |
+|  | 24 | 当地医院诊断结果（check buttons） |
+|  | 24 | 当地医院名称 |
+| **现病史** | 24 | 口腔感觉（check buttons） |
+|  | 24 | 每日饮水量（radio buttons） |
+|  | 24 | 近月体重变化（radio buttons） |
+|  | 24 | 脂肪肝（radio buttons） |
+|  | 24 | 饮食（check buttons） |
+|  | 24 × 9 | 肢体、睡眠、眼睛、头部、出汗、皮肤、小便、大便、腰肾 |
+|  | 24 | 其他补充，textarea，3 行 |
+| **既往史** | 24 | 既往史（check buttons） |
+| **其他病史** | 8 + 8 + 8 | 外伤；手术；过敏 |
+|  | 12 + 12 | 家族；妊娠 |
+| **诊断信息** | 24 | 病史补充，textarea，2 行 |
+
+具体模板行：顶部/身份 `edit.vue:86-194`；生命体征 `edit.vue:199-368`；主诉 `edit.vue:369-412`；现病史 `edit.vue:414-549`；既往史 `edit.vue:552-564`；其他病史 `edit.vue:567-613`；诊断信息 `edit.vue:616-629`。
+
+当前模板没有显示 `syndrome_type`、`diabetes_type`、舌象、脉象、治则、医嘱等字段，即便脚本模型中存在，也不应擅自加入视觉复刻。
+
+### 4.6 移动端
+
+小于等于 768 px 时（`edit.vue:1876-2004`）：
+
+- Drawer 变为 100vw；header `12px 14px`，body `10px 12px`。
+- Footer 改为纵向、按钮全宽，gap 10 px，内边距 `12px 14px + safe-area`，按钮最小 44 px。
+- 标题 17 px；Tab 高/行高 44 px、字号 13 px、水平内边距 12 px。
+- label 改到控件上方：100% 宽、左对齐、下间距 6 px；表单项底部 14 px。
+- 所有 `el-col` 强制 100%，数字框 100%；radio gap `8px 16px`，checkbox `8px 10px`。
+- 分组标题外边距 18/14 px，文字 13 px、水平内边距 10 px。
+
+```text
+移动端（<=768）
+┌──────────────────────┐
+│ 标题 [状态]       ×  │
+│ 患者 · 诊单ID        │
+├──────────────────────┤
+│ ← 可横向滚动 Tabs →  │
+├──────────────────────┤
+│ 姓名                 │
+│ [__________________] │
+│ 身份证               │
+│ [__________________] │
+│ ... 全部单列 ...     │
+├──────────────────────┤
+│ [取消/关闭 全宽]     │
+│ [保存 全宽，44px+]   │
+└──────────────────────┘
+```
+
+---
+
+## 5. 预约抽屉 `appointment.vue`
+
+### 5.1 骨架与字段顺序
+
+预约同样是 RTL 右侧 Drawer，宽 60%，z-index 2000，且点击遮罩不能关闭（`appointment.vue:2-9`）。表单 label width 为 100 px（`appointment.vue:19`）。
+
+```text
+┌───────────────────────────────────────────────────────────────┐
+│ 预约面诊                                                    × │
+├───────────────────────────────────────────────────────────────┤
+│ [今日重复预约警告 / 其他日期提示，条件显示]                   │
+│ 上次面诊       2026-08-01 10:30                               │
+│ 预约方式       (●) 按时间预约                                 │
+│ 预约类型       (●) 视频面诊                                   │
+│ 预约患者       (●) 当前患者                                   │
+│ 渠道来源       [请选择 ▼]                                     │
+│ 自媒体详情     [请选择 ▼]   ← 仅自媒体渠道                    │
+│ 预约医生       ( ) 医生A  ( ) 医生B ...                       │
+│ 预约时间       [08月10日 周一] [08月11日 周二] ...            │
+│                ┌───────────────────────────────────────────┐  │
+│                │ 可预约时段                         [刷新] │  │
+│                │ [09:00 可约] [09:30 已满] [10:00 可约] ...│  │
+│                └───────────────────────────────────────────┘  │
+│ 备注           [_________________________________________]     │
+├───────────────────────────────────────────────────────────────┤
+│                                          [取消] [确认预约]     │
+└───────────────────────────────────────────────────────────────┘
+```
+
+字段顺序严格为（`appointment.vue:21-181`）：
+
+1. 上次面诊（文本）。
+2. 预约方式（当前只呈现按时间预约）。
+3. 预约类型（视频）。
+4. 预约患者（当前患者）。
+5. 渠道来源（必填 select）。
+6. 自媒体详情（渠道命中自媒体白名单时必填）。
+7. 预约医生（radio 列表）。
+8. 预约时间：先日期按钮，后可预约时段矩阵。
+9. 备注（textarea，2 行）。
+10. Footer：取消、确认预约。
+
+### 5.2 尺寸、颜色与交互状态
+
+- 渠道控件宽 100%、最大宽 360 px（`appointment.vue:741-750`）。
+- 医生/单选组可换行，gap 12 px（`appointment.vue:752-765,911-921`）。
+- 日期按钮 flex-wrap、gap 10 px、最小宽 130 px、高 40 px、字号 14 px、圆角 8 px；hover 上移 2 px并加阴影（`appointment.vue:771-789`）。
+- 时段容器底 `#f8f9fa`、圆角 8 px、内边距 16 px；标题 15 px / 600 / `#303133`（`appointment.vue:791-808`）。
+- 时段网格 `auto-fill minmax(110px,1fr)`、gap 10 px、最大高 450 px并滚动，滚动条宽 6 px（`appointment.vue:810-830`）。
+- 时段卡白底，2 px `#e4e7ed` 边框、8 px 圆角、最小高 70 px、水平内边距 8 px；时间 15 px / 600 / `#303133`，状态 12 px / `#909399`（`appointment.vue:831-862`）。
+- 可约 hover：`#409eff` 边框、`#ecf5ff` 底、上移并加阴影（`appointment.vue:864-873`）。
+- 不可约：`#f5f7fa` 底、opacity 0.6、文字 `#c0c4cc`（`appointment.vue:875-894`）。
+- 选中：`#409eff → #66b1ff` 渐变、白字和阴影（`appointment.vue:896-909`）。
+- Footer 右对齐、gap 12 px、上下内边距 12 px（`appointment.vue:923-928`）。
+
+状态逻辑是视觉的一部分：未选医生时显示“请先选择医生”，无排班显示空态；日期只来自当前及未来有效排班（`appointment.vue:299-326`）；当天过去时段禁用（`appointment.vue:328-357`）；当天已有预约显示 warning，其他日期重复信息为 info（`appointment.vue:359-375`）。提交按钮只有医生、日期、时间、渠道以及条件性渠道详情齐全，且不存在当天冲突时才可用（`appointment.vue:377-386`）。
+
+### 5.3 响应式事实
+
+`appointment.vue` 没有移动端 media query。内部医生、日期和 slot 网格会换行，但 Drawer 在窄屏仍保持 60% 视口宽。这是后台源码的真实缺口；PySide 若要求窗口缩小时可用，应保留桌面 60% 的视觉比例，同时设置合理最小内容宽并在不足时切到全宽/单列，而不声称这是 Vue 原实现已有行为。
+
+---
+
+## 6. 备注、日常记录、处方/订单与历史关联区
+
+### 6.1 医生备注 / 舌象 / 报告
+
+编辑 Drawer 和独立只读页均使用 `NoteTimeline`（`edit.vue:633-643`; `readonly.vue:56-72`）。编辑态顶部按权限显示“新增备注、选择舌象、选择报告”；只读态隐藏这些操作（`src/views/patient/reception/components/NoteTimeline.vue:1-123`）。
+
+视觉规格（`NoteTimeline.vue:272-436`）：
+
+- 顶部动作行 gap 12 px、底部分隔线。
+- 时间轴左内边距 22 px，轴线 2 px `#ebeef5`；节点 10 px、`#409eff`，外圈 `#ecf5ff`。
+- 日期 13 px / 600 / `#303133`，等宽数字；正文 12.5 px / `#606266` / 1.6 行高。
+- 舌象缩略图 `64 × 64 px`、圆角 6 px、带边框；删除为红色动作。
+- 报告文件 chip 为 `6px 10px`、圆角 6 px、12 px primary 字，最大宽 180 px。
+- 上传格 `90 × 90 px`、1 px dashed `#dcdfe6`、圆角 6 px、12 px；hover 转 primary。
+- 新增备注 Dialog 宽 480 px，textarea 4 行、maxlength 500。
+
+`TrackingNoteTimeline` 当前并未进入可见 Tab：`edit.vue:644-654` 将整段注释。不能在复刻中把它当作现存“跟踪备注”页签。
+
+### 6.2 日常记录、趋势与待办
+
+DailyMatrix 顶部提供最近 7 天 / 30 天 / 自定义日期和日期范围；右侧有本人记录图例、编辑动作与血糖血压/饮食/运动/备注/刷新按钮，readonly 仅保留刷新（`components/DailyMatrix.vue:1-129`）。矩阵的指标顺序为：空腹、餐后2小时、其他血糖、血压、西药、胰岛素、早餐、午餐、晚餐、运动、跟踪备注（`components/DailyMatrix.vue:410-485`）。固定指标列 120 px，日期列最小 100 px。
+
+- 根内边距 16 px；toolbar 换行、gap 12 px、下间距 12 px（`DailyMatrix.vue:1090-1105`）。
+- 趋势卡上间距 16 px、内边距 `16px 18px`、圆角 10 px，图表高 280 px（`DailyMatrix.vue:1124-1158`）。
+- 超标红 `#dc2626` / 700；本人记录用紫色浅底，徽章 `#6d28d9 / #ede9fe / #ddd6fe`（`DailyMatrix.vue:1182-1225`）。
+- <=768 px 时根内边距 12 px，图表内边距 12 px、高 240 px（`DailyMatrix.vue:1240-1260`）。
+
+待办区域位于 DailyMatrix 下方，标题 14 px / 600。表格字段依次为提醒时间、内容、状态、创建人、推送时间、错误信息、操作；toolbar 可筛全部/待推送/已推送/失败/已取消（`components/DiagnosisTodoList.vue:1-112`）。新增 Dialog 宽 520 px、label 100 px，字段顺序为提醒时间、内容（4 行/500 字）、提醒人；toolbar 换行、gap 8 px、下间距 12 px，分页右对齐（`DiagnosisTodoList.vue:291-319`）。
+
+### 6.3 处方 / 病例历史
+
+`CaseRecordList` 顶部编辑态显示小号 primary“开方”，只读时隐藏。表格字段顺序：就诊日期（120）、就诊编号（120）、诊断（min 160）、处方摘要（min 180）、医生（90）、状态（140）、操作（120 固定右侧）；根内边距 20 px（`components/CaseRecordList.vue:1-39,103-106`）。
+
+点击“开方”进入直接依赖的全局 `@/components/tcm-prescription/index.vue`，不是在诊单 Tab 内原地编辑：它另开 1200 px Drawer、禁止点遮罩关闭，表单 label 100 px（`src/components/tcm-prescription/index.vue:1-10`）。编辑态顺序为：
+
+1. 患者信息：姓名 / 性别 / 年龄三等分，电话 / 门诊号两等分。
+2. 诊断信息：面象 / 舌象两等分，临床诊断整行 2 行 textarea；舌象详情和脉象详情在模板中被注释（`index.vue:11-76`）。
+3. 中药处方 RP：药材总数与锁定提示；添加主方、添加辅方、处方库导入、粘贴导入；处方价格；主方卡片网格；辅方卡片网格（`index.vue:78-216`）。
+4. 用法信息：处方类型、主方用法、条件性辅方用法、剂数、剂量单位、用法、服用时间、服用方式、忌口、其他说明、医师、是否共享、医师签名（`index.vue:217-531`）。
+
+信息分区间距 20 px、内边距 16 px、底 `#f5f7fa`、圆角 6 px；标题 15 px / 600 / `#303133`（`index.vue:2500-2516`）。RP toolbar 可换行，gap `12px 20px`、内边距 `14px 16px`、圆角 10 px、lighter 边框；标题 16 px、说明/锁定文字 12 px。药材编辑区桌面固定 4 列、gap 12 px，卡片白底、10 px 内边距、6 px 圆角；仅在 <=960 px 时让操作按钮行占满，**没有**把 4 列药材网格降列（`index.vue:2522-2690`）。签名区最大宽 600 px、1 px `#dcdfe6`、圆角 4 px（`index.vue:2694-2711`）。
+
+保存后同一 Drawer 切换为处方预览：Tab 为“药房联 / 处方联”，上方工具条与作废/审核驳回状态，主体是 A4 `210 × 297 mm` 白纸，`8mm 10mm` 内边距、13 px 字号、28 px / 700 标题（`index.vue:536-754,2714-2782`）。患者信息是 4 列表格，药材是 2 列，底部医师/类型/天数/剂量为网格（`index.vue:2807-2966,2990-3035`）。未保存编辑态才提供 Drawer footer（`index.vue:899-905`）。
+
+### 6.4 业务订单
+
+订单 Tab/卡片顶部先显示“全局就诊序号偏移”工具条：label、tooltip、0–20 数字框（宽 120 px）、保存按钮（`components/PatientOrderList.vue:7-42`）。工具条换行、`12px 14px` 内边距、1 px lighter 边框、8 px 圆角、light fill（`PatientOrderList.vue:252-276`）。
+
+订单表为 bordered + striped，字段顺序和列宽来自 `PatientOrderList.vue:44-106`：
+
+1. 订单号，min 200。
+2. 全局就诊序号，96。
+3. 数量统计，96，Tag。
+4. 金额，120，右对齐红字。
+5. 医生，110。
+6. 医助，110。
+7. 履约状态，110，Tag。
+8. 创建时间，min 170。
+9. 详情，100，固定右侧。
+
+默认 page size 为 10，底部带分页，点击详情打开只读订单详情（`PatientOrderList.vue:108-148`）。
+
+订单详情复用 `PrescriptionOrderDetailDrawer` 的 readonly 受限版，而不是订单页内展开（`PatientOrderList.vue:113-124`）。该共享 Drawer 宽 80%，Header `16px 24px`，标题 18 px / 600，订单号与药房单号用圆角 Tag；加载态为 12 行 skeleton，body 水平内边距 24 px并独立纵向滚动（`src/views/consumer/prescription/components/PrescriptionOrderDetailDrawer.vue:13-50,1752-1757`）。内容顺序为：
+
+1. 金额概览：总金额、已付总额、退款金额、需代收、已付笔数；响应式 2 / 3 / 5 列（`PrescriptionOrderDetailDrawer.vue:154-197`）。
+2. 两栏主区：左侧处方详情，右侧未关联收款与关联收款；收款表顺序为 ID、单号、类型、金额、状态、方式（readonly 隐藏）、创建人、创建时间（`PrescriptionOrderDetailDrawer.vue:200-545`）。
+3. 履约与收货信息：3 列 descriptions，label 宽 120 px（`PrescriptionOrderDetailDrawer.vue:551-680,1782-1785`）。
+4. 物流轨迹与操作日志（有数据/开启附加加载时）（`PrescriptionOrderDetailDrawer.vue:683-824`）。
+
+readonly 明确隐藏顶部告警、流程步骤、挂号关联、内部成本、药材明细、收款方式和外部物流更新等完整版内容，但金额概览、主辅方用量/服法和基础详情仍共享（`PrescriptionOrderDetailDrawer.vue:2-11`）。面板统一 8 px 圆角，Header `14px 16px`、Body 16 px（`PrescriptionOrderDetailDrawer.vue:1759-1780`）。
+
+### 6.5 视频、聊天与历史表
+
+**视频录制回放。** CallRecordPanel 编辑态有上传 toolbar；字段为播放（min 320）、开始时间 170、结束时间 170、通话类型 100、房间 180、时长 110、状态 90、录制 100、上传 180（仅编辑）（`components/CallRecordPanel.vue:1-74`）。空态内边距 `28px 12px`，标题 14 px、说明 12 px / 1.6（`CallRecordPanel.vue:188-214`）。内嵌视频最大高 180 px、圆角 4 px、黑底；播放覆盖层为 `rgba(0,0,0,.62)`、白色 12 px（`components/RecordingVideoPlayer.vue:322-359`）。
+
+**聊天。** 顶部 info alert + 同步/刷新 toolbar，消息区最大高 `min(60vh,520px)`、gap 16 px。单条最大宽 88%；患者消息靠左、灰底，医生消息靠右、primary 浅底；meta 12 px，气泡 14 px、1.5 行高、`10px 12px` 内边距、8 px 圆角；图片最大 `240 × 200 px`（`components/ImChatRecordPanel.vue:1-70,200-293`）。
+
+**医助指派历史。** 字段依次为时间 175、原医助 min 120、新医助 min 120、继承 72 Tag、快照订单创建人 min 130、快照创建时间 190、操作人 110、账号 120、IP 130（`components/AssignLogPanel.vue:1-43`）。
+
+**挂号历史。** 字段依次为 ID 72、状态 100 Tag、患者 min 150（姓名+手机堆叠）、医生 110、医助 110、预约时间 min 130（日期+时段堆叠）、预约类型 100、渠道 110、确认 92、处方 80、备注 min 100、创建时间 165（`components/AppointmentRecordPanel.vue:1-75`）。堆叠单元垂直 gap 2 px、行高 1.35（`AppointmentRecordPanel.vue:172-178`）。
+
+### 6.6 `components/` 全目录的可达性边界
+
+三主视图的实际 import 清单见 `edit.vue:787-805` 与 `readonly.vue:151-167`。为避免把目录中保留组件误认成当前详情功能，本次也核了其余文件：
+
+| 组件 | 三主视图当前可达性 | 结论 |
+|---|---|---|
+| `PatientInfoCard`、`PatientCaseCard` | readonly 直接使用 | 当前只读摘要/病例 |
+| `DailyMatrix`、`CaseRecordList`、`PatientOrderList`、`CallRecordPanel`、`ImChatRecordPanel`、`AssignLogPanel`、`AppointmentRecordPanel` | edit/readonly 直接使用（依页面和权限而异） | 当前主链 |
+| `RecordingPlaybackBlock` → `RecordingVideoPlayer` | CallRecordPanel 间接使用 | 当前视频主链（`CallRecordPanel.vue:32,78`; `RecordingPlaybackBlock.vue:5,35`） |
+| `DiagnosisTodoList` | DailyMatrix 间接使用 | 当前日常记录主链 |
+| `TrackingNoteTimeline` | edit 有 import，但模板区整段注释 | 当前不可见（`edit.vue:644-654,803`） |
+| `BloodRecordList` | 未被三主视图 import | 旧/独立颗粒列表；其能力已由 DailyMatrix 内置 600 px 血糖血压 Dialog 承接（`BloodRecordList.vue:1-170`; `DailyMatrix.vue:131-185`） |
+| `DietRecordList` | 未被三主视图 import | 旧/独立列表；当前 DailyMatrix 内置 800 px 饮食 Dialog（`DietRecordList.vue:1-112`; `DailyMatrix.vue:187-227`） |
+| `ExerciseRecordList` | 未被三主视图 import | 旧/独立列表；当前 DailyMatrix 内置 600 px 运动 Dialog（`ExerciseRecordList.vue:1-86`; `DailyMatrix.vue:229-260`） |
+| `TrackingMatrix` | 未被三主视图 import | 非当前矩阵；当前入口明确 import `DailyMatrix`（`edit.vue:796`; `readonly.vue:161`） |
+| `AssistantWatchCallDialog` | 未被三主视图 import | 旁路观看 Dialog，不属于诊单详情/编辑/预约；自身是 auto-fill、最小 280 px 的观看网格，gap 12 px（`AssistantWatchCallDialog.vue:1-19,242-282`） |
+
+因此 PySide 对齐应以“当前可达主链”为实现范围，不能因为同目录存在旧颗粒列表而重复增加血糖、饮食、运动 Tab，也不能把观看 Dialog 或 TrackingMatrix 插入诊单详情。
+
+---
+
+## 7. 加载、空态、错误和权限状态
+
+| 场景 | 后台表现 | 源码 |
+|---|---|---|
+| 独立详情加载 | 页面级 loading | `readonly.vue:1-2` |
+| 独立详情失败 | Hero 下方错误空态卡 | `readonly.vue:31-36` |
+| 无未服务记录 | Hero 灰色“从未记录”状态 | `readonly.vue:323-355` |
+| 抽屉只读 | 状态 badge + disabled fieldset + 无保存 | `edit.vue:11-54,57-84,766-781` |
+| 患者隐私锁定 | warning Alert，身份字段不可改 | `edit.vue:71-84` |
+| Tab 失权 | 隐藏 Tab；当前失权时回 basic | `edit.vue:655-759,883-913` |
+| 预约未选医生 | 时间区提示先选医生 | `appointment.vue:100-171` |
+| 无排班/无时段 | 时间区空态 | `appointment.vue:100-171` |
+| 当天已有预约 | warning 且禁止确认 | `appointment.vue:10-18,359-386` |
+| 其他日期已有预约 | info 提示，不等同当天阻断 | `appointment.vue:359-375` |
+| 表格无数据 | 各组件 Element empty/自定义空态 | `PatientOrderList.vue:1-6`; `CallRecordPanel.vue:55-74` |
+
+操作权限应控制“是否渲染/是否可编辑”，而不是只把无权按钮做成 disabled；这正是 Tab 通过 `v-if` 实现的模式。
+
+---
+
+## 8. PySide6 组件映射
+
+### 8.1 结构映射
+
+| Vue / Element 结构 | PySide6 建议 | 必须保留的视觉行为 |
+|---|---|---|
+| `el-drawer` 右侧抽屉 | 模态 `QDialog` + 右侧面板，或主窗口上的遮罩 `QFrame` + 固定宽面板 | 桌面约 60% 宽；edit 在窄屏切全宽；Header/Body/Footer 三段分离 |
+| Drawer body | `QScrollArea` + body widget | 只让 body 滚动，footer 不随滚动 |
+| Drawer footer slot | 独立 `QFrame` + `QHBoxLayout` | 上边框、白底、固定在底部；不要放进 ScrollArea |
+| `el-tabs` | `QTabWidget` / 自定义 `QTabBar + QStackedWidget` | 可横向滚动、3 px active indicator、按 canonical permission 移除页签 |
+| `el-form` + `el-row/el-col` | `QFormLayout` 套 `QGridLayout` | 桌面 160 px 编辑标签 / 100 px 预约标签；窄屏改上标签单列 |
+| input/select/date/input-number | `QLineEdit`、`QComboBox`、`QDateEdit`、`QSpinBox/QDoubleSpinBox` | 常规高 32 px、圆角 10 px；footer 按钮 40/44 px |
+| radio/checkbox button groups | `QButtonGroup` + 可换行 FlowLayout | 12 px 字号，组间 12–16 px；小窗必须换行 |
+| textarea | `QTextEdit/QPlainTextEdit` | 2/3/4 行按源码用途设置 minimumHeight，而非无限增高 |
+| alert / empty | `QFrame + QLabel` / 统一 EmptyState | warning/info/error 色语义与文案位置一致 |
+| card | `QFrame` | 白底、1 px `#e6ebf2`、14 px radius、18 px padding |
+| table | `QTableView + QAbstractTableModel` | stripe、固定/最小列宽、状态 `QStyledItemDelegate` tag、右侧动作列 |
+| timeline | `QListView` 或纵向 QWidget 列表 + paintEvent 轴线 | 22 px 左缩进、2 px 轴、10 px node，图片缩略图 64 px |
+| appointment slot grid | `QScrollArea + FlowLayout` / `QGridLayout` 动态列 | cell min 110 × 70；选中/禁用/可用状态显式 |
+| loading | overlay `QFrame` + spinner/文字 | 遮住当前内容但保留布局尺寸，异步返回后解除 |
+
+### 8.2 推荐常量（来自源码，不是重新设计）
+
+```text
+FONT_FAMILY = "PingFang SC, Arial, Hiragino Sans GB, Microsoft YaHei"
+FONT_BASE = 14
+FONT_FORM = 12
+CONTROL_HEIGHT = 32
+FOOTER_BUTTON_HEIGHT = 40       # <=768 对应布局时 44
+CARD_RADIUS = 14
+CARD_PADDING = 18
+CONTROL_RADIUS = 10
+PANEL_GAP = 16
+BORDER = #e6ebf2
+BODY_BG = #f8fafc
+PAGE_BG = #f6f6f6
+TEXT_PRIMARY = #333333
+TEXT_REGULAR = #666666
+TEXT_MUTED = #999999
+PRIMARY = #409eff               # 继承 Element 语义主色
+READONLY_ACCENT = #2563eb
+READONLY_ACCENT_STRONG = #1d4ed8
+```
+
+### 8.3 PySide 字段装配顺序
+
+为避免实现时按数据模型字母序排字段，应按以下 UI 顺序装配：
+
+```text
+编辑病历：
+诊单ID
+→ 姓名 / 身份证
+→ 手机 / 性别
+→ 年龄
+→ [生命体征] 婚姻 / 身高 / 体重
+→ 地区 / 高压 / 低压
+→ 空腹血糖
+→ 诊断类型
+→ 状态 / 渠道
+→ 统计端就诊卡
+→ 在用药物
+→ [主诉] 当地诊断日期 / 糖尿病病史
+→ 当地医院诊断结果
+→ 当地医院名称
+→ [现病史] 口腔 → 饮水 → 体重变化 → 脂肪肝 → 饮食
+→ 肢体 → 睡眠 → 眼睛 → 头部 → 出汗 → 皮肤 → 小便 → 大便 → 腰肾
+→ 其他补充
+→ [既往史] 既往史
+→ [其他病史] 外伤 / 手术 / 过敏 → 家族 / 妊娠
+→ [诊断信息] 病史补充
+
+预约：
+上次面诊 → 预约方式 → 预约类型 → 预约患者 → 渠道来源
+→ [条件] 自媒体详情 → 预约医生 → 日期 → 时段 → 备注
+```
+
+---
+
+## 9. 验收清单
+
+1. 独立 readonly 是纵向卡片流，不出现 Tabs；抽屉 viewOnly 才是 Tabs + disabled 表单。
+2. 编辑 Drawer 桌面 60%，<=768 等效状态下全宽；预约 Drawer 源码没有该响应式覆盖，需明确属于适配增强。
+3. 编辑桌面 label 160 px，预约 label 100 px；编辑移动端 label 在控件上方。
+4. 编辑的 body 独立滚动，footer 始终可见；实现中没有把按钮放到滚动区末尾。
+5. Tab 顺序与 canonical permission 一致；“跟踪备注”不渲染。
+6. 编辑病历字段严格按 §4.5；不把脚本中未渲染字段自行加入。
+7. 只读病例按 4/3 列网格及 §3.4 顺序；小窗若做降列，需视为桌面端增强而非源码既有行为。
+8. 预约状态至少覆盖：未选医生、无排班、可约、不可约、选中、当天冲突、其他日期提示、loading。
+9. 订单、备注、视频、聊天、指派历史、挂号历史的列顺序/动作显隐与 §6 一致。
+10. 所有表格提供 loading、empty、error；权限失去时移除入口并将当前页回退到可见页。
+
+以上规格记录的是当前后台源码的可见事实；PySide 可为桌面小窗增加降列和全宽适配，但不得改变字段顺序、权限门槛、状态语义或主操作位置。

app/research/diagnosis_exact_final_report.md

@@ -0,0 +1,31 @@
+# Diagnosis 详情二次终验报告
+
+日期：2026-08-10
+
+## CLOSED
+
+- 统计端就诊卡：使用原生自绘二态 `DiagnosisSwitch`，保存值严格为 `0/1`。
+- 日常记录：提供 `+ 血糖 / + 饮食 / + 运动 / + 备注`，以及待办新增、仅待执行且 `can_cancel` 的精确取消；Remote/Demo/Protocol 均接真实方法，包含权限、DTO 校验和 generation 失效保护。
+- 诊疗笔记：接入新增/当日追加、舌象与报告上传、单附件删除；所有动作均调用现有真实 endpoint。
+- 处方与订单：处方按钮进入完整 `PrescriptionEditorDialog` 并调用 `tcm.prescription/add`；诊次偏移写入 `setRevisitSlotStartOffset`；订单详情调用真实详情方法。
+- 视频回放：列表、视频上传、手工通话记录创建、附件绑定均接真实 endpoint；播放仅允许合法 `HTTP(S)` 外链。
+- IM：固定 `only_archived=1`，支持异步同步与重新加载，并显示文本、图片、文件消息。
+- 视觉：tab 使用 4px 横向滚动条并隐藏原生左右箭头框；footer 有向上阴影；保存按钮自绘 loading spinner、成功勾、失败叉；readonly 摘要禁止拆字；表格状态改为 pill/tag。
+- Shell owner：每次 `open_for` / `showEvent` 从 `parentWidget().window()` 重新绑定，按 Shell 宽度 60% 计算抽屉，move/resize 立即同步，关闭后全部请求 generation 失效。
+- 列表补充合同：QR、挂号日志、通用订单与 exact `doctor.appointment/cancel` 均有 Protocol/Remote/Demo 方法。
+
+## OPEN（服务端合同不存在，fail-closed）
+
+- 诊疗笔记“任意改写既有正文”与“删除整条笔记”没有后端 endpoint，因此桌面端没有伪造动作。现有合同只允许“当天追加”和“删除单个附件”：
+  - `server/app/adminapi/controller/doctor/AppointmentController.php:168-192` 仅公开 `addDoctorNote`、`doctorNotes`、`deleteDoctorNoteImage`。
+  - `server/app/adminapi/logic/doctor/DoctorNoteLogic.php:14-67` 的 `addOrAppend` 按 `diagnosis_id + 当天` 追加正文/附件，不是任意正文覆盖。
+  - `server/app/adminapi/logic/doctor/DoctorNoteLogic.php:114-141` 仅实现单个附件删除。
+  - `admin/src/api/patient.ts:20-40` 同样只有上述三个客户端 API。
+
+## 验证
+
+- 定向详情与合同：`28 passed`。
+- 相关 repository/reception/video：`57 passed`。
+- 全量：`226 passed`。
+- `ruff check .`：exit 0（仅工作区不可访问缓存目录的扫描 warning）。
+- 视觉产物：`artifacts/diagnosis_visual/` 中 6 张模式图与 14 张详情状态图，共 20 张本轮详情 PNG。

app/research/diagnosis_final_visual_gate.md

@@ -0,0 +1,155 @@
+# Diagnosis 最终视觉发布门禁
+
+审计日期：2026-08-11  
+审计性质：第四次独立、只读、最终视觉发布门禁；除更新本报告外，未修改业务源码、测试或 PNG。  
+基准：`D:/web/zyt/admin/src/views/tcm/diagnosis/` 及其主链直接依赖组件。  
+当前截图：`D:/web/zyt/app/artifacts/diagnosis_visual/`。  
+Trellis：`D:/web/zyt/app/.trellis` 不存在（`Test-Path` 为 `False`），因此无可补读的 Trellis workflow/spec。  
+审计口径：只有与基准达到同型才记 PASS；Qt 与浏览器字体栅格化造成的轻微像素差不算结构问题。
+
+## 最终结论
+
+**PASS。**
+
+- 共逐张按原始像素尺寸检查 **57 张 PNG**。
+- 逐图判定：**57 PASS / 0 PARTIAL / 0 不可读 / 0 硬裁切到窗口外**。
+- 严重度：**P0 = 0，P1 = 0，P2 = 0**。
+- 旧审计中的 Notes 真实缩略图、Chat 图片缩略图、Daily 局部工具栏、1200 px 连续处方 Drawer、订单 80% 详情 Drawer、订单 offset、Shell 与预约均已闭合或保持通过。
+- 上轮唯一 P1——视频表内播放器被压成 16 px 黑条——已关闭。`diagnosis_video_inline_player_1200x560.png` 与 `diagnosis_state_video_replay_1024x640.png` 均显示完整加载遮罩、播放按钮、进度条、时间、外部打开、独立窗口和备用地址；播放器本体运行时高度为 158 px，未超过基准 180 px 上限。
+
+尺寸分布（按 PNG 实际像素而非文件名）：`1024x640` 24 张、`1024x768` 1 张、`1200x560` 1 张、`1200x900` 4 张、`1280x800` 11 张、`1440x900` 13 张、`650x620` 1 张、`820x560` 1 张、`920x780` 1 张。
+
+第四次增量完整性：目录仍为 57 张；相对上一门禁仅 3 张视频 PNG 更新（`diagnosis_video_inline_player_1200x560.png`、`diagnosis_state_video_replay_1024x640.png`、`diagnosis_state_video_upload_action_1024x640.png`）。本轮已对这 3 张全部按原始尺寸复核，并原尺寸抽查 Notes、Chat、Daily、处方四段连续态、订单 80% Drawer/offset、Shell、预约及 1024/1440 主列表；其余非视频 PNG 时间戳未变化，沿用上一轮全量逐图结论。
+
+## 此前 OPEN 逐项复核
+
+| 旧 OPEN | 终态 | 视觉与结构证据 |
+|---|---|---|
+| Notes 舌象真实缩略图 | **CLOSED** | `diagnosis_state_notes_actions_1024x640.png` 已显示实际 64x64 舌象位图，并有右上删除入口；当前 `_RemoteImageButton` 以 cover 方式加载到 `QSize(64, 64)`：`src/doctor_workstation/ui/diagnosis_drawer.py:2364-2404`。基准为真实 `el-image` 64x64 cover：`D:/web/zyt/admin/src/views/patient/reception/components/NoteTimeline.vue:52-69`。 |
+| Chat 图片消息缩略图 | **CLOSED** | `diagnosis_state_chat_archive_1024x640.png` 的患者图片消息直接显示实际图像缩略图，不再是“查看图片”文字链接；当前最大 `240x200`：`diagnosis_drawer.py:2553-2573`。基准：`ImChatRecordPanel.vue:39-50`。 |
+| Daily 待办局部工具栏 | **CLOSED** | `diagnosis_state_daily_lower_1024x640.png` 同时显示 `+ 新增待办`、全部/待执行/已发送/失败/已取消及局部“刷新”，无遮挡；当前：`diagnosis_drawer.py:1725-1761`，基准：`DiagnosisTodoList.vue:3-20`。顶部动作行也继续在 `diagnosis_state_daily_1024x640.png` 完整换行。 |
+| 处方 1200 px 连续 Drawer | **CLOSED** | `diagnosis_state_prescription_editor_1200x900.png`、`..._herbs_1200x900.png`、`..._usage_1200x900.png`、`..._signature_1200x900.png` 连续证明患者、诊断、RP 药材、用法、签名处于同一纵向滚动流，固定 footer 稳定；1024/920 窄宽度采用可用宽度而非截断。当前 `DRAWER_WIDTH = 1200` 且五段连续加入同一 `QScrollArea`：`src/doctor_workstation/ui/dialogs/prescription.py:1467,1491-1556,1902-1914`。基准：`D:/web/zyt/admin/src/components/tcm-prescription/index.vue:2-216,217-531`。旧 4-tab modal 结构已消失。 |
+| 订单 80% 详情 Drawer | **CLOSED** | `diagnosis_order_detail_drawer_1440x900.png` 的 panel 从 x=288 开始、宽 1152（80%）；`diagnosis_state_order_detail_640x540.png` 与 `diagnosis_state_order_detail_drawer_1024x640.png` 的实际像素均为 1024x640，panel 从 x=205 开始、宽 819（约 80%）。金额概览、处方详情、关联收款在首屏可见；当前连续构建收款、履约与收货、物流轨迹、操作日志：`src/doctor_workstation/ui/dialogs/diagnosis.py:669-710,3623-4065`。基准共享 readonly Drawer：`PrescriptionOrderDetailDrawer.vue:13-20,154-220,433-545,550-824`。旧 `640x540` 仅是遗留文件名，不是当前截图尺寸。 |
+| 订单 offset 文案与解释层级 | **CLOSED** | `diagnosis_state_order_offset_1024x640.png` 已为“复诊统计起始偏移”+ 问号帮助 +“第 1 笔实单计为三诊”+“保存”，与基准同型；当前：`diagnosis.py:1384-1416,3001-3058`，基准：`PatientOrderList.vue:7-41`。 |
+| 视频多地址与逐条上传 | **CLOSED（能力/动作）** | `diagnosis_state_video_upload_action_1024x640.png` 的行级“追加回放”可见；当前每行绑定精确 `call_record_id`：`diagnosis.py:3304-3342`。备用地址结构存在于 `diagnosis_media.py:358-442`。 |
+| 视频表内播放器 | **CLOSED** | 两张终态图均显示完整可操作的表内播放器与备用地址；第四次运行时复核在 1200x560、1024x640 宿主中均测得 row 243 px、cell 242 px、player 158 px，controls 全部可见。详见下节。 |
+| Shell | **CLOSED / 无回归** | `diagnosis_shell_1024x640.png` 与 `diagnosis_shell_1440x900.png` 均保持 183 px sidebar、50 px topbar、40 px tabs，操作区及固定列无错位。 |
+| 预约 Drawer | **CLOSED / 无回归** | 8 张预约 PNG 的 60% Drawer、固定 footer、时段网格、empty/error/loading/refreshing/focus 状态均完整。 |
+
+## P0 / P1 / P2
+
+### P0
+
+**0 项。** 未发现窗口级硬裁切、核心信息完全不可见、Drawer 比例失效、footer 滚走、二维码不可辨识、Shell 壳层错位或预约主流程不可操作的发布阻断。
+
+### P1
+
+**0 项。** 上轮唯一 P1“视频表内播放器被裁成 16 px 黑条”已关闭。
+
+#### 视频表内播放器关闭证据
+
+精确截图：
+
+- `D:/web/zyt/app/artifacts/diagnosis_visual/diagnosis_video_inline_player_1200x560.png`
+- `D:/web/zyt/app/artifacts/diagnosis_visual/diagnosis_state_video_replay_1024x640.png`
+
+两张图在原始尺寸中均呈现完整播放器：黑色视频 surface 内有“预览待加载 / 点击播放开始加载”，下方可见“播放”、进度条、`00:00 / 00:00`、“外部打开”和“独立窗口”；播放器下方继续显示“备用地址”及 `COS HLS 1`、`链接 2`，第二条无回放记录也保持独立普通行。1200 与 1024 宿主均无裁切、重叠或 controls 遗失。
+
+第四次运行时几何复核（使用与最终截图相同的 `RenderRepository` 与两行 fixture，未写 PNG）在 1200x560 和 1024x640 两种宿主下得到一致结果：
+
+- table row 0：243 px；可视 cell rect：242 px；`RecordingPlaybackCell`：242 px。
+- `InlineRecordingPlayer`：158 px，满足实现的 158–180 px 约束，也满足基准 `max-height: 180px`。
+- 播放按钮、slider、时间标签及整个 player 均 `visible=True`。
+- 备用地址使外层 cell 高于 180 px 是正确行为；180 px 上限只约束播放器本体，不约束播放器 + 备用地址的整行总高。
+
+当前源码的闭环点：
+
+- `src/doctor_workstation/ui/diagnosis_media.py:179-278` 构建 158–180 px 内嵌 player、视频 surface 与完整控制栏。
+- `diagnosis_media.py:359-457` 将 player、备用地址组成定高 cell，并由 `required_table_row_height()` 返回真实所需高度。
+- `src/doctor_workstation/ui/dialogs/diagnosis.py:3304-3367` 在 Qt 的 `resizeRowsToContents()` 后，以 cell 实际 hint 恢复 row 高度并写入 item size hint，避免另一列固定高按钮再次压扁整行。
+
+基准 `D:/web/zyt/admin/src/views/tcm/diagnosis/components/RecordingPlaybackBlock.vue:1-30` 在“录制回放”单元格内直接放置 `RecordingVideoPlayer`；`RecordingVideoPlayer.vue:2-13,320-329` 显示 controls、16:9、最大高 180 px 的完整播放器。当前终态在结构、信息层级和可操作性上已同型，因此关闭 P1。
+
+### P2
+
+**0 项。** 上一轮两项 P2 已闭合：Daily 待办已具精确 `+ 新增待办` 与局部刷新；订单 offset 已具精确标题、帮助入口、动态解释与“保存”文案。
+
+## 57 张 PNG 逐张判定
+
+### 预约 Drawer（8/8 PASS）
+
+| PNG | 判定 | 原始尺寸下目检结论 |
+|---|---|---|
+| `appointment_drawer_1024x640.png` | PASS | 60% Drawer、body 滚动、时段状态与固定 footer 完整。 |
+| `appointment_drawer_1440x900.png` | PASS | 医生、日期、时段网格、备注与 footer 对齐。 |
+| `appointment_drawer_empty_doctors_1440x900.png` | PASS | warning、空医生状态与禁用确认完整。 |
+| `appointment_drawer_empty_roster_1440x900.png` | PASS | 无排班 warning、医生选择与空态完整。 |
+| `appointment_drawer_error_1440x900.png` | PASS | 号源错误 banner、刷新入口、空态与禁用确认完整。 |
+| `appointment_drawer_keyboard_focus_1440x900.png` | PASS | 日期按钮 focus ring 清晰，不挤压布局。 |
+| `appointment_drawer_loading_1440x900.png` | PASS | 初始 loading overlay、spinner、文案与 footer 完整。 |
+| `appointment_drawer_refreshing_1440x900.png` | PASS | 刷新 overlay、spinner、文案与 footer 完整。 |
+
+### 诊单列表、壳层与主 Drawer（23/23 PASS）
+
+| PNG | 判定 | 原始尺寸下目检结论 |
+|---|---|---|
+| `diagnosis_1024x640.png` | PASS | 窄屏筛选换行、横向滚动、右 460 px 固定区与行语义完整。 |
+| `diagnosis_1440x900.png` | PASS | 宽屏列密度、复合挂号格、业务色与固定操作区成立。 |
+| `diagnosis_advanced_filters_1280x800.png` | PASS | 高级筛选全量展开，无控件裁切。 |
+| `diagnosis_double_appointment_cancel_1280x800.png` | PASS | 同诊单双挂号各有取消入口。 |
+| `diagnosis_edit_1024x640.png` | PASS | 60% Drawer、tab、独立滚动与固定 footer 成立。 |
+| `diagnosis_edit_1440x900.png` | PASS | 864 px Drawer 与宽屏字段比例稳定。 |
+| `diagnosis_empty_1280x800.png` | PASS | 表头、空态、横向滚动与 0 条分页保留。 |
+| `diagnosis_error_1280x800.png` | PASS | 错误态清晰，无旧数据穿透。 |
+| `diagnosis_focus_1280x800.png` | PASS | 搜索 focus ring 清晰且不挤压布局。 |
+| `diagnosis_full_menu_1280x800.png` | PASS | 8 项菜单、图标、danger 删除与“二维码”均完整。 |
+| `diagnosis_horizontal_scroll_1024x640.png` | PASS | 主表横移时右 460 px 固定区不动。 |
+| `diagnosis_hover_warning_1280x800.png` | PASS | warning 行 hover 与左侧强调条连续。 |
+| `diagnosis_loading_1280x800.png` | PASS | 表内 spinner 与淡化内容完整。 |
+| `diagnosis_order_detail_drawer_1440x900.png` | PASS | 80% Drawer、金额概览、处方详情、收款记录与固定 footer 成立。 |
+| `diagnosis_order_qrcode_1280x800.png` | PASS | QR 可辨、订单号、状态、只读 URL 与动作完整。 |
+| `diagnosis_pending_assign_1280x800.png` | PASS | 待分配医助、月份与搜索处于同一流式区域。 |
+| `diagnosis_permissions_cropped_1280x800.png` | PASS | 权限收口后只保留查看，无敏感动作残留。 |
+| `diagnosis_readonly_1024x640.png` | PASS | 独立只读页 hero、病例卡与窄屏字段无拆字。 |
+| `diagnosis_readonly_1440x900.png` | PASS | 4 列病例密度、异常指标与长页滚动成立。 |
+| `diagnosis_shell_1024x640.png` | PASS | 183/50/40 壳层、tabs、固定列及分页成立。 |
+| `diagnosis_shell_1440x900.png` | PASS | 宽屏壳层比例及顶栏图标/中文稳定。 |
+| `diagnosis_viewonly_1024x640.png` | PASS | 60% 只读 Drawer、警告、disabled 表单与仅关闭 footer 成立。 |
+| `diagnosis_viewonly_1440x900.png` | PASS | 宽屏只读栅格、全 tabs 与固定 footer 成立。 |
+
+### 详情状态与子流程（26/26 PASS）
+
+| PNG | 判定 | 原始尺寸下目检结论 |
+|---|---|---|
+| `diagnosis_state_chat_archive_1024x640.png` | PASS | info、归档同步、左右气泡与真实图片缩略图成立。 |
+| `diagnosis_state_daily_1024x640.png` | PASS | Daily 动作完整换行，无裁切。 |
+| `diagnosis_state_daily_blood_edit_650x620.png` | PASS | 血糖/血压字段、单位、必填说明与固定动作完整。 |
+| `diagnosis_state_daily_lower_1024x640.png` | PASS | `+ 新增待办`、filters、局部刷新、状态与横向滚动完整。 |
+| `diagnosis_state_empty_1024x640.png` | PASS | 处方空态与 primary“开方”成立。 |
+| `diagnosis_state_error_1024x640.png` | PASS | danger banner、重试、空表单与禁用保存完整。 |
+| `diagnosis_state_focus_1024x640.png` | PASS | 姓名 focus ring、close 与固定 footer 完整。 |
+| `diagnosis_state_loading_1024x640.png` | PASS | loading overlay、spinner 与文案完整。 |
+| `diagnosis_state_notes_actions_1024x640.png` | PASS | 新增/上传动作、实际舌象缩略图、报告 chip 与单附件删除完整。 |
+| `diagnosis_state_order_detail_640x540.png` | PASS | 实际为 1024x640 的 80% Drawer；金额与处方首屏、滚动与 footer 成立。 |
+| `diagnosis_state_order_detail_drawer_1024x640.png` | PASS | 80% Drawer 窄屏终态与上一张一致且无结构裁切。 |
+| `diagnosis_state_order_offset_1024x640.png` | PASS | 精确标题、帮助、动态解释、“保存”、列表与分页成立。 |
+| `diagnosis_state_permission_1024x640.png` | PASS | 获权 tabs、敏感字段掩码与仅关闭 footer 成立。 |
+| `diagnosis_state_prescription_editor_1024x768.png` | PASS | 窄屏连续 Drawer 首段、RP 工具栏、滚动与固定 footer 成立。 |
+| `diagnosis_state_prescription_editor_1200x900.png` | PASS | 1200 px 连续 Drawer 患者/诊断/RP 起始结构成立。 |
+| `diagnosis_state_prescription_editor_920x780.png` | PASS | 窄宿主按可用宽度适配，旧 tabbed modal 已消失。 |
+| `diagnosis_state_prescription_editor_herbs_1200x900.png` | PASS | 主方/辅方网格、剂量与删除入口处于同一滚动流。 |
+| `diagnosis_state_prescription_editor_signature_1200x900.png` | PASS | 辅方用法、医生签名板及固定 footer 成立。 |
+| `diagnosis_state_prescription_editor_usage_1200x900.png` | PASS | 主/辅方用法层级、说明字段与连续滚动成立。 |
+| `diagnosis_state_save_failure_1024x640.png` | PASS | 红色失败态与文案完整。 |
+| `diagnosis_state_save_loading_1024x640.png` | PASS | 按钮内 spinner 与“正在保存”完整。 |
+| `diagnosis_state_save_success_1024x640.png` | PASS | 绿色成功态与文案完整。 |
+| `diagnosis_state_video_player_820x560.png` | PASS | 独立播放器作为兼容兜底本身完整；不替代表内播放器要求。 |
+| `diagnosis_state_video_replay_1024x640.png` | PASS | 158 px 表内 player、加载态、完整 controls 与备用地址均可见，第二条普通行未受高行影响。 |
+| `diagnosis_state_video_upload_action_1024x640.png` | PASS | 横移后 243 px 高视频行仍保持状态、录制与“追加回放”垂直居中，第二条普通行未被错误拉高。 |
+| `diagnosis_video_inline_player_1200x560.png` | PASS | 宽屏完整显示 158 px 表内 player、controls、备用地址及相邻列，无裁切。 |
+
+## 发布判定
+
+- 旧审计的 Notes、Chat、Daily、处方、订单、视频、Shell、预约问题已经全部闭合或保持通过。
+- 两张重新录制的视频原始尺寸 PNG 与运行时实际控件几何相互印证，旧唯一 P1 已关闭。
+- 当前最终门禁：**PASS（57 PASS / 0 PARTIAL，共检查 57 张 PNG；P0=0，P1=0，P2=0）。**

app/research/diagnosis_index_visual_spec.md

@@ -0,0 +1,373 @@
+# 管理端“诊单列表”视觉规格（源码基准）
+
+> 审计日期：2026-08-10  
+> 唯一业务页面基准：`D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue`  
+> 方法：只读检查 Vue 模板、同文件 scoped SCSS、直接挂载组件、全局样式、主题生成逻辑和当前锁定的 Element Plus 源码；未启动浏览器、未改业务源码。
+
+## 1. 结论摘要
+
+1. 该页面**没有页面内标题、说明文案或独立标题栏**。路由内容从一张无边框、无阴影的筛选卡直接开始；“新增诊单”等主操作位于第二张列表卡顶部，而不是页面标题旁。证据：`index.vue:2-154`。
+2. 页面是“浅灰页面底 + 两张白卡”的高密度后台列表。外层路由容器提供左右 `8px`、上下 `16px` 的留白；筛选卡和列表卡之间为 `12px`。证据：`D:/web/zyt/admin/src/layout/default/components/main.vue:2-10`、`index.vue:154`、`D:/web/zyt/admin/tailwind.config.js:103-113`。
+3. 顶部不是常规 tabs，而是可换行的圆角文字 chip：6 个日期入口，再接“待预约 / 已完成 / 待分配医助”，计数是文字后面的普通半透明数字，不是独立 badge。当天默认选中。证据：`index.vue:6-70,964-976,2174-2182,2222-2317`。
+4. 表格声明列的最小总宽约为 **1403px**；右侧固定“视频旁观” `120px` 与“操作” `340px`，合计 `460px`。窄于该宽度时由 Element Table 横向滚动，右侧两列保持 fixed。证据：`index.vue:191-342`。
+5. 表格使用斑马纹；普通偶数行是 `#FAFAFA`，普通悬停是 `#F8F8F8`。未确认、未挂号行还声明了左侧语义色和横向渐变，但静态渐变写在 `tr`，斑马纹及 fixed cell 的 `td` 背景可能遮住它；两类行的 hover 渐变直接写在 `td`，表现更稳定。证据：`index.vue:2723-2735`、Element Plus `table.scss:560-588,665-668`。
+6. 空态不是 `el-empty` 插画，而是表格默认的 **60px 高“暂无数据”文本区**；加载态是覆盖表格的半透明蒙层和 `42px` 主色环。证据：Element Plus `table.scss:52-70`、`loading.scss:19-73`、中文 locale `zh-cn.mjs:137`。
+
+## 2. 源码证据层级
+
+| 层级 | 文件 | 本规格使用内容 |
+|---|---|---|
+| 页面模板与局部样式 | `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:1-2766` | DOM 次序、列宽、状态类、局部尺寸和颜色 |
+| 路由内容容器 | `D:/web/zyt/admin/src/layout/default/components/main.vue:1-12` | 页面底色、外层滚动、`px-2 py-4` |
+| 共享组件 | `D:/web/zyt/admin/src/components/pagination/index.vue:1-50`；`D:/web/zyt/admin/src/components/daterange-picker/index.vue:1-49` | 分页布局、页容量、日期范围控件行为 |
+| 项目全局样式 | `D:/web/zyt/admin/src/styles/index.scss:1-5`、`var.css:1-49`、`element.scss:58-68,106-115,140-151,177-201`、`public.scss:1-3` | 全局字体、颜色、表格、输入焦点、移动分页 |
+| 项目主题 | `D:/web/zyt/admin/src/config/setting.ts:1-15`、`src/utils/theme.ts:3-75`、`src/App.vue:25-34` | 默认主色、明暗主题色派生、运行时覆盖 |
+| Tailwind token | `D:/web/zyt/admin/tailwind.config.js:5-155` | 字体族、颜色映射、间距值 |
+| UI 框架 | `D:/web/zyt/admin/pnpm-lock.yaml:47-49,2412-2415`；`node_modules/element-plus/theme-chalk/src/**` | 当前锁定 Element Plus 2.13.7 的默认组件尺寸 |
+
+`package.json:27` 写的是兼容范围 `^2.9.4`，当前 lock 与已安装源码均为 **2.13.7**；本规格的框架默认尺寸以锁文件和当前安装源码为准。
+
+## 3. 页面骨架与 ASCII wireframe
+
+### 3.1 宽屏主态
+
+```text
+主内容滚动区，#F6F6F6；左右 8，上下 16
+┌────────────────────────────────────────────────────────────────────────────────────────────┐
+│  筛选卡 #FFF / r4 / 无边框无阴影；内边距 12V × 16H                                      │
+│  [昨天挂号 n] [前天挂号 n] [当天挂号 n] [明天挂号 n] [后天挂号 n] [全部 n]                │
+│  [待预约 n] [已完成 n] [待分配医助 n]                 [患者姓名 / 手机号 160] [查询 32h] │
+│  ────────────────────────────────────────────────────────────────────────────────────────  │
+│  挂号：[全部] [已挂号] [未挂号] │ 确认：[全部] [已确认] [未确认]   更多筛选⌄             │
+│  · · · 展开时：诊断类型 / 证型 / 医助 / 最近挂号日期 / 最近指派日期 / 渠道 / 重置 · · ·  │
+└────────────────────────────────────────────────────────────────────────────────────────────┘
+                                      12px
+┌────────────────────────────────────────────────────────────────────────────────────────────┐
+│  [新增诊单]  [批量指派医助]  [批量取消指派]                         已选 n 条（按需显示） │
+├────┬──────┬──────┬───────────┬──────────────┬──────┬────────┬──────┬──────┬──────────┬──────┬────────────────────┤
+│ □  │ ID   │ 患者 │ 性别/年龄 │ 挂号         │ 确认 │ 复诊   │ 助理 │ 开方 │未服务天数│旁观* │ 操作*              │
+├────┼──────┼──────┼───────────┼──────────────┼──────┼────────┼──────┼──────┼──────────┼──────┼────────────────────┤
+│ □  │123 NEW│张三 │ 男 · 42岁 │[待问诊] 医生 │未确认│日期/医生│医助  │已开方│    8     │进入  │查看 诊单 开方 … 更多│
+│    │      │      │           │时间 / 渠道   │      │        │      │      │          │      │                    │
+├────┴──────┴──────┴───────────┴──────────────┴──────┴────────┴──────┴──────┴──────────┴──────┴────────────────────┤
+│                                               共 n 条  [15条/页] [<] 1 2 … [>]  前往 [ ] 页 │
+└────────────────────────────────────────────────────────────────────────────────────────────┘
+                                                            * 右侧固定列，共 460px
+```
+
+### 3.2 结构说明
+
+- 外层 `main` 是整页垂直滚动容器；诊单表没有本页固定高度或纵向虚拟滚动，15 条数据会把页面自然撑高。证据：`layout/default/components/main.vue:2-11`、`index.vue:179-190`。
+- 两张卡都使用 `shadow="never"` 与 `!border-none`；保留 Element Card 的白底、裁切和 `4px` 圆角。框架默认：Element Plus `card.scss:9-17`、`common/var.scss:1226-1235`。
+- 页面根节点只设 `min-height:100%`、页面底色和水平居中；不设自身宽度、最大宽度或 padding。证据：`index.vue:2200-2206`。
+- 顶部全局 header、面包屑和多页签属于应用壳，不在 `index.vue` 中；它们是否出现受全局 setting 控制，不能当作本页标题复刻。
+
+## 4. 可复刻的基础 token
+
+### 4.1 字体与基础尺寸
+
+| 项 | 源码确定值 | 证据 |
+|---|---:|---|
+| 字体族 | `PingFang SC, Arial, Hiragino Sans GB, Microsoft YaHei, sans-serif` | `tailwind.config.js:79-81`、`var.css:2` |
+| body / Element base | `14px` | `public.scss:1-3`、`var.css:16` |
+| small / extra-small | `13px / 12px` | `var.css:17-18` |
+| 默认控件高度 | `32px` | Element Plus `common/var.scss:233-241` |
+| small 控件高度 | `24px` | 同上 |
+| 默认圆角 | `4px` | Element Plus `base.css:1` |
+| 卡片圆角 | `4px` | Element Plus `common/var.scss:1227-1234` |
+
+字体栅格的真实像素高度仍受 Windows 缩放、浏览器 DPR 与首个可用字体影响；页面 chip 没有固定 `height`/`line-height`，只能精确复刻 padding，不能仅凭源码承诺最终外框高度。
+
+### 4.2 亮色主题
+
+项目在 `App.vue` mount 时用 setting 重写 Element 语义色。默认主色不是 Element 原生蓝，而是 `#4A5DFF`。主题派生算法见 `src/utils/theme.ts:3-18,29-37,55-74`。
+
+| token | 默认运行值 | 使用处 |
+|---|---|---|
+| `--el-color-primary` | `#4A5DFF` | active chip、主按钮、链接、loading |
+| primary light-3 / 5 / 7 / 8 / 9 | `#808EFF / #A5AEFF / #C9CEFF / #DBDFFF / #EDEFFF` | hover、focus、轻底色 |
+| primary dark-2 | `#3B4ACC` | active 状态；页面另有硬编码近似值 `#3A4ACC` |
+| success | `#67C23A` | 已完成 chip、已确认、成功按钮 |
+| warning | `#E6A23C` | 待分配、未确认、警示行 |
+| danger | `#F56C6C` | NEW、删除/取消 |
+| info | `#909399` | 待预约、完成预约、次要态 |
+| page / card | `#F6F6F6 / #FFFFFF` | 页面底 / 卡片与普通行 |
+| primary / regular / secondary text | `#333333 / #666666 / #999999` | 标题信息 / 常规 / 辅助 |
+| placeholder / disabled | `#A8ABB2 / #C0C4CC` | 空值、禁用 |
+| border / light / lighter | `#DCDFE6 / #E4E7ED / #EBEEF5` | 控件、卡线、行分隔 |
+| fill / light / lighter | `#F0F2F5 / #F8F8F8 / #FAFAFA` | hover、表头、斑马纹 |
+| loading mask | `rgba(255,255,255,.5)` | 表格加载蒙层 |
+
+证据：`src/config/setting.ts:9-14`、`src/styles/var.css:9-43`。主色的派生结果使用项目同一 `css-color-function` 算法计算；不是页面硬编码。warning/info 的页面渐变使用 `--el-color-*-rgb`，其当前框架默认分别为 `230,162,60` 和 `144,147,153`（Element Plus `base.css:1`）。
+
+### 4.3 暗色与运行时主题边界
+
+- `.dark` 下页面底为 `#0A0A0A`、普通背景 `#1D2124`、overlay `#1D1E1F`，主/常规/次要文字为 `#E5EAF3 / #CFD3DC / #A3A6AD`，lighter border 为 `#363637`。证据：`src/styles/dark.css:1-31`。
+- `App.vue` 根据 `useDark()` 调用主题生成器，主色仍可保持 `#4A5DFF`，但 light-* 在暗色下改用 shade 算法。证据：`src/App.vue:29-34`、`src/utils/theme.ts:12-18,55-77`。
+- setting 会从本地缓存覆盖默认颜色，因此**某个真实账号的主色/语义色可能不同**。证据：`src/stores/modules/setting.ts:12-50,65-77`。上表是无用户自定义时的确定基线。
+- 页面内硬编码的 `#4A5DFF`、`#3A4ACC` 与 `rgba(74,93,255,...)` 不会随自定义主题变化，因而自定义主题下会出现两套蓝色。证据：`index.vue:2522-2529,2556-2559,2596-2599`。
+
+## 5. 顶部筛选卡
+
+### 5.1 卡与第一行
+
+筛选卡 body padding 为 `12px 16px`。第一行 `.filter-main` 是单行 flex：垂直居中、两端对齐、组间 `16px`、下边距 `8px`；**自身没有 `flex-wrap`**。左侧 `.date-chips` 才可换行，chip 间距 `6px`。证据：`index.vue:3-76,2208-2225`。
+
+| 元素 | 几何/排版 | 默认/交互颜色 | 证据 |
+|---|---|---|---|
+| 普通日期 chip | padding `6px 12px`；14px/500；r6；transition `.2s` | 常规 `#666` + `#F8F8F8`；hover `#F0F2F5`；active 白字 + 主色 | `index.vue:2227-2250` |
+| chip 计数 | 与标题相隔 `4px`；normal style；opacity `.8` | 跟随父 chip | `index.vue:23-24,2237-2241` |
+| 待预约 | 普通 chip 外再有左 margin `8px` | info / info-light-9；active info 实色 | `index.vue:26-32,2253-2265` |
+| 已完成 | 左 margin `8px` | success / success-light-9；active success 实色 | `index.vue:33-39,2268-2280` |
+| 待分配医助 | 权限控制；外容器可换行、gap `8px`、左 margin `8px` | warning / warning-light-9；active warning 实色 | `index.vue:40-70,2283-2308` |
+| 待分配月份 | default 月选择器；宽 `128px` | Element 默认输入态 | `index.vue:51-60,2310-2312` |
+| 待分配宽搜索 | default 输入；宽 `220px`，最大 `42vw` | Element 默认输入态 | `index.vue:61-69,2314-2317` |
+| 主搜索 | default 输入宽 `160px` | placeholder“患者姓名 / 手机号” | `index.vue:72-75,2320-2326` |
+| 查询 | primary default button；高 `32px`，14px，r4 | 白字/主色底 | `index.vue:74`、Element Plus `button.scss:22-43,76-82` |
+
+日期 chip 的实际顺序是：**昨天、前天、当天、明天、后天、全部**，不是按自然日期升序；随后才是 3 个业务 chip。证据：`index.vue:964-976`。页面挂载时直接选中当天并请求列表；各 chip 计数延后到 idle（不支持时延后约 `120ms`）获取，所以首帧可能只有标签、稍后才出现数字。证据：`index.vue:1046-1095,2174-2182`。
+
+### 5.2 第二行快捷筛选
+
+- 第二行上方有 `1px solid #EBEEF5`；自身 `padding-top:8px`、`margin-top:8px`、水平 gap `6px`、垂直居中。证据：`index.vue:78-102,2329-2335`。
+- “挂号：”“确认：”为 `13px #999`，label 后额外 `2px`。每组都是“全部 / 已… / 未…”。证据：`index.vue:79-97,2337-2341`。
+- 小 chip 最终 padding 是 `.chip-sm` 的 `4px 10px`，13px、r4、透明底；hover/active 用主色文字与 primary-light-9，active 权重 500。证据：`index.vue:2343-2366`。
+- 两组之间为 `1×14px` 的 lighter 分隔线，左右 margin `4px`。证据：`index.vue:2368-2373`。
+- “更多筛选”是 primary/link/small 按钮，左 margin `8px`；展开时 ArrowDown 旋转 `180°`，文字变“收起”。源码没有为该旋转指定独立 transition。证据：`index.vue:98-101,2375-2380`。
+
+### 5.3 展开筛选区
+
+展开区使用 `v-show`，所以是即时显隐而非折叠动画。它为可换行 flex，gap `10px`，上 margin/padding 各 `8px`，顶部是 `1px dashed #EBEEF5`。证据：`index.vue:104-151,2384-2391`。
+
+控件从左到右：
+
+1. 诊断类型 select（small，`24px` 高）；
+2. 证型 select（small）；
+3. 医助 select（small，可搜索）；
+4. 最近挂号日期范围（共享 `DaterangePicker`，`260px` 宽、最大 100%，未传 size，故 default `32px` 高）；
+5. 最近指派日期范围（同上）；
+6. 最近挂号渠道（small，可搜索，宽 `170px`）；
+7. 重置（small button，`24px` 高）。
+
+证据：`index.vue:104-150,2393-2405`；共享日期组件只是透传一个 `el-date-picker`，见 `components/daterange-picker/index.vue:1-11,15-31`。因此展开区客观上混有 `24px` 与 `32px` 两种控件高度。前三个 select 没有本页固定宽度；Element Select 自身是 `width:100%` 的可收缩 flex item，最终每行宽度依赖可用空间与浏览器 flex 计算，源码不能给出一个稳定像素值。
+
+## 6. 列表卡操作栏
+
+- 列表卡距筛选卡 `12px`，body padding 清零。证据：`index.vue:154,2408-2412`、Tailwind spacing `tailwind.config.js:103-113`。
+- 操作栏为左右两端布局，padding `10px 16px`，底边 `1px #EBEEF5`；未固定高度。default button 高 `32px`，故无换行时栏高至少约 `52px`。证据：`index.vue:155-177,2414-2429`。
+- 左侧依权限显示：primary“新增诊单”、success“批量指派医助”、warning/plain“批量取消指派”。后两者按选中状态禁用。右侧仅在选中数量大于 0 时显示 `13px #999` 的“已选 n 条”。证据：`index.vue:157-176`。
+- `.list-actions` 声明 `gap:8px`，但 Element 默认还有 `.el-button + .el-button { margin-left:12px }`，此处没有清零。因此相邻按钮的实际起点间空白通常是 **20px（8+12）**，而不是设计者表面写下的 8px。证据：`index.vue:2421-2424`、Element Plus `button.scss:72-74`。
+
+## 7. 表格规格
+
+### 7.1 外框与表头
+
+- 表格外围 padding `10px 16px 0`；表格宽度 100%，默认 fixed layout、无竖边框；行之间由 `1px #EBEEF5` 底边分隔。证据：`index.vue:178-190,2432-2434`、Element Plus `table.scss:11-20,188-195,217-235`。
+- 表头底 `#F8F8F8`、13px/600、文字 `#666`。默认 cell 水平 padding `12px`，行高 `23px`，纵向 padding `8px`，所以单行表头的理论最小高度约 **39px**（23+16，不含亚像素/边线差异）。证据：`index.vue:2710-2716`、Element Plus `table.scss:156-195`、`common/var.scss:1014-1031`。
+- 表头“未服务天数”有双态排序箭头，顺序只允许 descending → ascending；激活箭头使用主色。证据：`index.vue:297-304`、Element Plus `table.scss:548-552`。
+
+### 7.2 列宽与内容
+
+| 次序 | 列 | 声明宽度 | 对齐/固定 | 主要视觉内容 |
+|---:|---|---:|---|---|
+| 1 | 选择 | `48px` | center | header 全选 + 行 checkbox |
+| 2 | ID | `min 70px` | left | ID 为 14px/600；未读指派时附 small/dark/danger `NEW` |
+| 3 | 患者 | `min 60px` | left | 患者名 14px/600；头像模板已注释，不显示 |
+| 4 | 性别 / 年龄 | `100px` | left | `男 · 42岁`，继承表格 14px |
+| 5 | 挂号 | `min 175px` | left | 预约状态 badge、医生、时间、可取消链接、最近渠道；无则“未挂号” |
+| 6 | 确认 | `88px` | center | 13px 已确认/未确认文字 |
+| 7 | 复诊 | `min 120px` | left | 时间、医生、可选“处方已作废” tag；无则“无” |
+| 8 | 助理 | `100px` | left | 13px 次要文字，溢出 tooltip |
+| 9 | 开方 | `72px` | center | 13px 已开方/未开方 |
+| 10 | 未服务天数 | `110px` | center | 13px/600 tabular number，按天数绿/橙/红；可有健康打卡 tooltip |
+| 11 | 视频旁观 | `120px` | center / right fixed | small link 或 12px 次要状态 |
+| 12 | 操作 | `340px` | left / right fixed | 5 个 small/link 主动作 + click dropdown |
+
+证据：`index.vue:191-406`。声明宽度/最小宽度合计约 `1403px`；`min-width` 列在更宽窗口可继续分配余量。右固定区域为 `120+340=460px`，Element 会在滚动边缘加 fixed-column 阴影；阴影值来自框架 `common/var.scss:981-1000`。
+
+### 7.3 行高与密度
+
+- 本页再次把 body cell 设为 `padding:8px 0`，cell 内层保留 Element 的水平 `12px` 与 `23px` line-height。纯单行内容的最小行高约 **39px**。证据：`index.vue:2720-2722`、Element Plus `table.scss:188-195`。
+- 挂号 cell 有 `min-height:36px`、内 padding `4px 8px`、r6，所以含该列的常规数据行通常至少约 **52px**（cell 36 + table 上下 16）；实际由内容较高者决定。证据：`index.vue:2485-2489`。
+- 同一诊单多条预约时，每一后续预约额外带 `8px` top margin、`8px` top padding 和 `1px dashed #EBEEF5`，行高会显著增加，不是固定行高。证据：`index.vue:227-247,2490-2494`。
+- 操作区允许换行；链接数量受权限与记录状态影响，所以操作列也可能增高整行。证据：`index.vue:344-403,2683-2688`。
+
+### 7.4 斑马、hover 与业务高亮
+
+| 状态 | 静态 | hover | 判定优先级 |
+|---|---|---|---|
+| 普通奇数行 | 白 `#FFF` | `#F8F8F8` | 无业务类 |
+| 普通偶数行 | `#FAFAFA` | `#F8F8F8` | `stripe` |
+| 未确认 | 预期左侧 `3px #E6A23C`；从左到右 warning RGB `.06 → transparent` | warning RGB `.10 → transparent`，直接覆盖 `td` | 第一优先 |
+| 已确认但未挂号 | 预期左侧 `3px #909399`；info RGB `.04 → transparent` | info RGB `.08 → transparent`，直接覆盖 `td` | 第二优先 |
+
+判定函数先检查“是否确认”，只有已确认才检查“是否挂号”，所以一行不会同时得到两个业务类。证据：`index.vue:1313-1337`。页面声明见 `index.vue:2723-2735`；斑马和 hover 框架规则见 Element Plus `table.scss:560-588,665-668`。
+
+实现时必须区分“源码意图”和“浏览器可见结果”：
+
+- 静态业务渐变在 `tr`，而偶数斑马行和 fixed cell 的背景落在 `td`；不透明 `td` 会遮住下面的 `tr` 渐变。
+- 业务 hover 选择器直接命中 `td` 且带 `!important`，因此 hover 更可靠。
+- `border-left` 施加在 `tr`，在 `border-collapse:separate` 的 table 中具体像素绘制还受浏览器表格格式化上下文影响。
+
+PySide 复刻应按“意图”直接给每个可见 cell/row delegate 绘背景和 3px 左条，避免复现 CSS 遮挡缺陷；若目标是截图逐像素一致，则需先用指定 Chromium、固定数据测一张运行态截图。
+
+### 7.5 单元格内部视觉
+
+#### 患者与 ID
+
+- `.patient-name` 为 14px/600、`#333`、line-height `1.3`。ID 与患者列都复用该样式。证据：`index.vue:194-212,2461-2470`。
+- 32×32、r8、主色渐变的头像 CSS 存在，但患者模板已注释，不参与实际页面。证据：`index.vue:207,2447-2459`。
+- `NEW` 是 small (`20px` 高)、danger、dark tag：白字、danger 实色底；字体 12px、r4。证据：`index.vue:198`、Element Plus `tag.scss:66-87,142-165`、`common/var.scss:1110-1138`。
+
+#### 挂号块
+
+- 每个预约 badge：11px/600、padding `2px 6px`、r4、下 margin `2px`；医生 14px/600 `#333`；时间 12px、上 margin `2px`。证据：`index.vue:2496-2519`。
+- 活跃预约 badge 为 `#3A4ACC` / `rgba(74,93,255,.15)`，时间硬编码 `#4A5DFF`；整块为 135° 蓝色渐变 `.12 → .06`，边 `rgba(74,93,255,.3)`。证据：`index.vue:2522-2531,2556-2559`。
+- 已完成预约用 info-dark-2 / info-light-7；爽约用 warning-dark-2 / warning-light-7。整块也分别换成 info 或 warning 透明渐变。证据：`index.vue:2533-2569`。
+- 最近渠道为上 margin `6px`、12px、line-height `1.35`、`#999`；未挂号为 13px `#A8ABB2`。证据：`index.vue:2571-2581`。
+
+#### 语义文字与 tag
+
+- 已确认：13px/500 success；未确认：13px/600 warning。证据：`index.vue:2584-2594`。
+- 已开方：13px/500、硬编码 `#4A5DFF`；未开方：13px `#A8ABB2`。证据：`index.vue:2596-2605`。
+- 复诊时间 13px/500 `#333`，医生 12px `#999`，纵向 gap `4px`、line-height `1.35`；“处方已作废”是 small/plain/info tag。证据：`index.vue:268-285,2651-2676`。
+- 未服务天数：最小 `28px`、13px/600、等宽数字；空值灰 `#A8ABB2`/400，`<=2` 绿 `#16A34A`，`3-6` 橙 `#EA580C`，`>=7` 红 `#DC2626`。证据：`index.vue:305-316,1319-1329,2607-2632`。
+- 视频旁观为 12px、line-height `1.4`，左右 padding `2px`；不可进入时是 `#999`。证据：`index.vue:318-341,2690-2704`。
+
+## 8. 按钮、dropdown、tooltip
+
+### 8.1 操作列链接
+
+直接动作依次为：查看（primary）、诊单（primary）、开方/查看处方（primary）、预约（success）、补全身份证（warning），最后是 info“更多”。权限会移除部分按钮。证据：`index.vue:345-403`。
+
+- 均为 `size="small"`、`link`：12px，透明边/底，padding `2px`，高度 auto；hover 使用各语义色的 light-3。证据：Element Plus `button.scss:223-248`、`element.scss:113-127`。
+- `.action-cell` 设 flex-wrap + `gap:4px`；但相邻 `.el-button + .el-button` 仍有 `12px` 左 margin，因此连续按钮间通常是 **16px（4+12）**。dropdown 外壳与前一按钮之间只有 flex gap `4px`。证据：`index.vue:2683-2688`、Element Plus `button.scss:72-74`。
+- 340px 操作列不足时允许链接换行；没有强制单行或省略号。
+
+### 8.2 “更多”菜单
+
+- click 触发、`bottom-end` 对齐。菜单项按权限/状态可包含：指派、取消指派、视频二维码、二维码、取消挂号、挂号日志、创建订单、删除。证据：`index.vue:379-403`。
+- Element 默认 dropdown item 为 14px、line-height `22px`、padding `5px 16px`，故普通项约 `32px` 高；菜单上下净 padding 约 `5px`，r4、overlay 白底，popper 有 light border 与 shadow。hover 为 fill-light + primary。证据：Element Plus `dropdown.scss:7-24,42-70,137-176`。
+- 删除项有 divided 顶线，文字由 `.text-danger` 强制为 danger。证据：`index.vue:400,2706-2708`。
+- tooltip 使用 Element 默认 popper：12px、line-height `20px`、padding `5px 11px`；实际位置由视口碰撞计算，不能从源码固定。
+
+## 9. 分页、空态与加载态
+
+### 9.1 分页
+
+- 列表默认 `page=1, size=15`；共享组件页容量选项为 `[15,20,30,40]`。证据：`src/hooks/usePaging.ts:14-34`、`components/pagination/index.vue:18-28`。
+- 布局固定为 `total, sizes, prev, pager, next, jumper`，最多显示 5 个 pager，单页也不隐藏。证据：`components/pagination/index.vue:3-14,24-28`。
+- 容器右对齐，padding `10px 16px 16px`。默认分页按钮 `32×32px`（最小宽），14px，r2，项组间 gap token `16px`；active 仅主色文字 + bold，并未启用 background 模式。证据：`index.vue:408-410,2436-2440`、Element Plus `common/var.scss:1034-1057`、`pagination.scss:5-67`。
+- page-size select 框架宽 `128px`，jumper 输入 `56px`。证据：Element Plus `pagination.scss:73-75,118-150`。
+- 视口 `<=768px` 时，全局 CSS 隐藏 size selector 与 jumper，仍保留 total、prev、pager、next。证据：`src/styles/element.scss:177-184`。
+
+### 9.2 空态
+
+页面没有提供 table `#empty` slot，也没有在主列表使用 `el-empty`。因此空列表为：
+
+- sticky empty block，min-height `60px`；
+- 居中纯文本“暂无数据”；
+- 文字 `#999`，line-height `60px`，宽 50%；
+- 表头、底线和分页仍存在。
+
+证据：`index.vue:179-190`、Element Plus `table.scss:52-70`、`src/App.vue:5,25-28`、Element 中文 locale `zh-cn.mjs:137`。
+
+### 9.3 加载
+
+- `v-loading="pager.loading"` 直接挂表格；普通请求开始时 loading=true，完成后 false。证据：`index.vue:179-184`、`src/hooks/usePaging.ts:35-72`。
+- 蒙层绝对覆盖 table，z-index 2000，亮色为 `rgba(255,255,255,.5)`；中央环 `42px`，主色描边 `2px`，2 秒旋转、1.5 秒 dash 动画。证据：`src/styles/var.css:41-43`、Element Plus `loading.scss:19-73,85-103`、`common/var.scss:1340-1349`。
+- 页面每 20 秒静默刷新列表和计数；标签页不可见时跳过，静默刷新不打开 loading，因此不会周期性白闪。证据：`index.vue:1098-1105,2182-2195`、`src/hooks/usePaging.ts:36-42,64-71`。
+- 首次 `pager.loading` 初值是 false，但 mount 后立即调用 `getLists()`，正常网络下会很快进入蒙层；能否肉眼看到取决于响应时长。
+
+## 10. 响应式与滚动行为
+
+1. `index.vue` 的 scoped 样式**没有 media query**。页面级响应式主要来自 flex-wrap、宽度上限、Element Table 横向滚动及全局分页规则。
+2. body 被全局设为 `min-width:375px`、`overflow:hidden`；应用主内容通过 `el-scrollbar` 承担页面滚动。证据：`src/styles/public.scss:1-3`、`layout/default/components/main.vue:2-11`。
+3. 第一筛选行本身不换行。左侧日期 chip 可换行，但右侧 160px 搜索 + 32px 查询按钮仍与左侧同一 flex 行；在极窄内容宽度下可能压缩、增高左侧或溢出，源码没有把搜索行堆到下一行的断点。
+4. 待分配容器可换行，宽搜索最多 `42vw`；展开筛选区可换行，两个日期范围各为 `260px` 且 `max-width:100%`。证据：`index.vue:2298-2317,2384-2405`。
+5. 表格 min 总宽约 1403px。Element Table 内部提供横向 scrollbar；右侧 460px fixed 区保持可见，导致很窄时可见的左侧业务列空间进一步减少。
+6. 外层应用在窄屏会折叠侧栏，但那是壳层行为，不改变本页筛选/表格 DOM。证据：`src/App.vue:36-53`。
+7. dark mode 有完整全局变量，但页面的硬编码蓝/绿/橙/红不会自适应；其亮度对比应另做暗色运行态验收。
+
+## 11. 直接挂载的覆盖层（不占主页面静态布局）
+
+主列表下方常驻挂载多个异步组件或 dialog/drawer；关闭时不占主页面空间，操作后覆盖在页面之上：
+
+| 入口 | 覆盖层 | 关键尺寸 | 证据 |
+|---|---|---:|---|
+| 新增/诊单 | `edit.vue` 诊单 drawer | `60%` | `index.vue:414`、`edit.vue:1-10` |
+| 详情组件 | `detail.vue` popup | `800px` | `index.vue:415`、`detail.vue:1-10` |
+| 开方/处方 | `tcm-prescription` drawer | `1200px` | `index.vue:416`、`components/tcm-prescription/index.vue:1-8` |
+| 预约 | `appointment.vue` drawer | `60%` | `index.vue:417`、`appointment.vue:1-10` |
+| 视频旁观 | AssistantWatchCall dialog | `760px`；视频 grid min `220px` | `index.vue:418-422`、`AssistantWatchCallDialog.vue:1-19,242-284` |
+| 挂号日志 | drawer | `460px` | `index.vue:424-447` |
+| 小程序二维码 | dialog | `400px`；二维码 `256×256` | `index.vue:449-481` |
+| 指派医助 | dialog | `500px` | `index.vue:483-531` |
+| 创建订单 | dialog | `600px` | `index.vue:533-587` |
+| 补全身份证 | dialog | `400px` | `index.vue:589-615` |
+| 企微记录 | drawer | `600px` | `index.vue:617-722` |
+
+这些覆盖层说明“操作按钮点击后”的页面层级，但其完整内部视觉不应混入诊单 index 主页面的静态复刻范围。
+
+## 12. PySide 映射建议
+
+### 12.1 页面与筛选
+
+| Vue/CSS 意图 | PySide 建议 | 复刻要点 |
+|---|---|---|
+| 外层 `el-scrollbar` + 两张 card | `QScrollArea` → 单一 `QWidget/QVBoxLayout`；卡用 `QFrame` | viewport `#F6F6F6`；外 margin `16V/8H`；卡 r4、白底、无 border/shadow；卡间 12 |
+| date chips | 自定义 `FlowLayout` + checkable `QToolButton` | padding 6×12、r6、gap6；计数拼接为同一 label，保持源码顺序 |
+| 业务色 chip | 同一 button class 加 dynamic property | `pending_booking/info`、`completed/success`、`pending/warning`；active 白字实底 |
+| 第一行搜索 | `QHBoxLayout` 右侧固定 `QLineEdit(160)` + `QPushButton` | 高 32、gap8；若追求源码一致，不自行添加窄屏 stack |
+| 第二行筛选 | `QHBoxLayout`/FlowLayout + `QToolButton` | top line、上下 8；13px；active primary-light-9 |
+| 更多筛选 | 可显隐 `QWidget` + FlowLayout | 无动画；top dashed border；gap10；small 控件 24，日期范围 32 |
+
+Qt 没有内建通用 FlowLayout，建议采用 Qt 示例式 `FlowLayout`，并把 chip 的 `sizeHint()` 包含字体宽度、左右 12/10px padding；不要用固定总宽，否则计数从一位变三位时会截断。
+
+### 12.2 表格
+
+- 使用 `QTableView + QAbstractTableModel`，不要堆 15 行 QWidget。列的 initial/min widths 按本规格表设置；表头高建议从 `39px` 起，常规 row 从 `52px` 起，并由 delegate `sizeHint()` 为多预约/操作换行增高。
+- 选择列用 check-state delegate；ID/患者、确认、复诊、开方、未服务天数分别用专用 delegate 绘文字和 tag，避免嵌套控件带来的滚动性能问题。
+- 挂号列用一个复合 delegate：r6 的状态背景、11px badge、14px/600 医生、12px 时间、多预约虚线分隔。可点击“取消挂号”若必须嵌入，可在命中区域处理 mouse event，而不是每格常驻 QPushButton。
+- 两个右固定列可用**同步滚动的双 `QTableView`**：主表隐藏最后两列，右表只显示 120/340 两列，共宽 460；共享 model、selection model、vertical scrollbar 与 row height。单一 QTableView 无 Element 的 sticky fixed-column 等价物。
+- 行背景应在 delegate 对每个 cell 绘制：普通白/`#FAFAFA`，hover `#F8F8F8`；业务行覆盖渐变并在第一可见 cell 绘 3px 语义条。不要把渐变只画在 viewport 底层，否则会重现 HTML `td` 遮挡问题。
+- 操作列优先使用 delegate + 命中区域或常驻 `QWidget` 行容器；若用按钮，链接样式为 12px、2px padding、无背景/边框，并预留源码实际的较大按钮间距。
+- 横向滚动时保持右表固定；表头与 body 必须共用列宽。多预约行要同步两张表的 row height。
+
+### 12.3 dropdown、分页、空态、加载
+
+- “更多”使用 `QMenu`，item 高约 32、左右 padding16、14px；按权限/状态动态构建，删除项前 `addSeparator()` 且 danger 文本。
+- 分页建议自定义 `PaginationBar`：total、15/20/30/40 combo、prev、最多 5 页、next、jump；高度32，容器右对齐并保留 `10T/16H/16B`。窗口内容宽度 <=768 时隐藏 combo 与 jump。
+- 空态在 `QTableView.viewport()` 中央放一个透明 `QLabel("暂无数据")`，有效高度 60；不要用大插画。仍显示 header 和分页。
+- 加载态用覆盖 table rect 的半透明 widget：亮色 `rgba(255,255,255,.5)`，中央约 42px 主色 spinner。新请求显示；20 秒静默刷新不显示。
+- 用 generation/request id 丢弃过期异步响应，并只在当前请求结束时关闭 overlay；这不是 Vue 当前 `latestOnly:false` 的视觉保证，但能避免 PySide 快速筛选时旧响应造成闪回。
+
+### 12.4 主题与字体
+
+- 定义集中 token，而不是把 `#4A5DFF` 散落在 QSS；但为了忠实，挂号块与“已开方”目前应保留硬编码蓝，或在设计确认后统一为 theme primary。
+- Windows 上首选“Microsoft YaHei UI”还是源码的“Microsoft YaHei”会改变字宽；逐像素复刻应显式用 `Microsoft YaHei`，14px CSS 大致映射为 Qt pixelSize 14，而不是 pointSize 14。
+- Qt 的 devicePixelRatio 与 CSS px 不同。截图验收需固定 Windows 缩放（建议 100%）、字体、窗口内容宽度和主题。
+
+## 13. 能从源码确定 / 不能从源码确定
+
+### 可以确定
+
+- DOM 顺序、无页面内标题、两张卡、每个筛选和操作入口；
+- 页面局部 padding/gap/宽度、列声明宽度、固定列、颜色、字体大小/字重；
+- 日期 chip 的顺序与当天默认态；
+- 表格 stripe、业务类判定优先级、语义文本与预约块状态；
+- 共享分页的页容量、布局、空态文案、loading 结构；
+- 默认亮/暗 token 及运行时主题派生方式；
+- 权限或数据条件控制哪些按钮/tag 出现。
+
+### 仅运行态可最终确定
+
+1. **最终换行和行高**：取决于 viewport、数据长度、按钮权限、预约条数、字体回退、DPR；chip 和多数 row 都没有固定 height。
+2. **实际主题色**：setting 存在本地缓存，账号可改主色及语义色；dark 状态也来自浏览器存储/系统偏好。
+3. **业务行静态渐变是否完整可见**：受 `tr` 背景、striped/fixed `td` 背景与 Chromium table paint 顺序影响；源码只能确定规则叠加关系。
+4. **fixed-column 阴影和 scrollbar 尺寸**：由 Chromium/Element 的滚动状态、平台 scrollbar 策略决定。
+5. **tooltip/dropdown 的最终坐标**：popper 会做视口碰撞与翻转。
+6. **加载态停留时间和计数出现时间**：由 API 延迟、idle callback 调度决定；静默轮询通常无蒙层。
+7. **应用壳标题/面包屑/多页签**：由路由菜单、setting 和权限生成，不是 `index.vue` 的页面内视觉。
+
+若后续要求“像素级截图一致”，应在固定 `Element Plus 2.13.7 + Chromium 版本 + 100% Windows 缩放 + 默认亮色主题 + 固定权限/样本数据` 下补一轮运行态测量；本文件已经给出源码能够保证的全部静态约束与明确边界。

app/research/diagnosis_post_flow_audit.md

@@ -0,0 +1,153 @@
+# 诊单视觉重构最终业务回归审计（三次终验）
+
+- 终验日期：2026-08-10
+- 范围：生产视频/IM、医生备注与日常记录 mutation、处方/订单、多挂号精确取消、诊单 Shell owner、列表 QR/日志/订单；并复核上一版已关闭的权限、DTO、隐私与 generation 项。
+- 基准：当前最新 Python 源码与测试，以及 `D:/web/zyt/admin`、`D:/web/zyt/server` 的实际 admin 行为和服务端控制器/Logic。
+- 约束：只读业务终验；未安装依赖、未打包、未访问线上接口。除更新本报告外，未修改业务源码或测试。
+
+## 最终结论
+
+第三次终验后的剩余项为：
+
+- **P0：0，明确无 P0。**
+- **P1：1 项 OPEN。** 诊单列表“创建订单”已调用真实 `order.order/create`，但没有消费返回的 `order_no` 并调用现成的 `generate_order_qrcode`，admin 的付款二维码闭环仍中断。
+- **P2：2 项 OPEN。** 一是日常矩阵不能编辑已有血糖/饮食/运动记录；二是视频回放只显示每条记录的第一个 URL，且没有 admin 的“向具体通话记录追加回放”入口。
+- **服务端不可实现限制：不计入 P0/P1/P2。** 医生备注与跟踪备注的服务端契约只支持按当天追加；服务端没有任意旧正文覆盖或整条删除 endpoint，桌面端无法在不扩展后端的前提下实现这些动作。
+- 其余本轮复核项均 **CLOSED**：生产视频/IM 取数与同步、备注追加/附件、日常新增与待办、处方动作、订单详情/偏移、精确挂号取消、列表视频/确认 QR 与日志、真实 Shell 60%/move-resize/close generation。
+- 定向离线回归：**128/128 passed**。
+
+| 复核项 | 三次终验状态 | 最终等级 | 摘要 |
+|---|---|---:|---|
+| 生产视频/IM `only_archived`、sync、上传、回放 | **OPEN（主体 CLOSED）** | **P2** | 生产接口、同步、工具栏上传和首个回放可用；多 URL 与指定 call-record 追加入口缺失 |
+| 医生备注 mutation | **CLOSED** | — | 追加正文、上传舌象/报告、删除单附件均走真实合同；正文覆盖/整条删除属后端无 endpoint 限制 |
+| 日常记录 mutation | **OPEN（新增 CLOSED）** | **P2** | 新增血糖/饮食/运动/跟踪备注及待办新增/取消可用；已有三类记录不能编辑 |
+| 处方/详情订单动作 | **CLOSED** | — | 开方、处方查看、业务订单列表/详情与诊次偏移均真实落库/取数 |
+| 多挂号精确取消 | **CLOSED** | — | 每个挂号卡携带精确 ID，最终调用 `doctor.appointment/cancel` |
+| 诊单 owner、60%、move-resize、generation | **CLOSED** | — | 每次打开重绑真实 Shell，宽度为 Shell 60%，移动/缩放/关闭同步且所有异步代次失效 |
+| 列表 QR / 日志 / 创建订单 | **OPEN（QR/日志/创建主体 CLOSED）** | **P1** | 视频/确认 QR、日志、创建订单均真实调用；创建成功后的支付 QR 未接入 UI |
+
+上一版已关闭的 `phonePlain`、canonical `diagnosis_type`、`viewOnly` endpoint 分流、detail 失败禁存、身份证 15/18 位校验、权限 Tab 裁剪与隐私脱敏，本轮定向回归均未发现反弹。
+
+## 逐项证据
+
+### 1. 生产视频/IM：`[OPEN / P2，主体 CLOSED]`
+
+已关闭部分：
+
+- `RemoteDoctorRepository` 已实现生产 `getCallRecords`、手工 call record、附件关联及“上传 → 创建记录 → 关联”顺序：`src/doctor_workstation/services/repository.py:1875-1943`。这与 admin `CallRecordPanel` 的真实流程一致：`D:/web/zyt/admin/src/views/tcm/diagnosis/components/CallRecordPanel.vue:109-180`。
+- IM 首次读取明确发 `only_archived=1`，同步走 `triggerImChatSync`：`src/doctor_workstation/services/repository.py:1945-1965`；dialog 的 lazy 查询也固定 `only_archived=True`：`src/doctor_workstation/ui/dialogs/diagnosis.py:2016-2038`。admin 对照为 `D:/web/zyt/admin/src/views/tcm/diagnosis/components/ImChatRecordPanel.vue:148-185`。
+- edit 态视频工具栏调用真实上传，成功后按 media generation 重新加载；聊天同步成功后延时重新读取归档：`src/doctor_workstation/ui/dialogs/diagnosis.py:2541-2611`。聊天图片/文件只能通过 HTTP(S) 安全打开：`:2652-2658`。
+- production/server 合同存在：`D:/web/zyt/server/app/adminapi/controller/tcm/DiagnosisController.php:397-438`、`:505-538`；归档快路径在 `D:/web/zyt/server/app/adminapi/logic/tcm/DiagnosisLogic.php:1015-1045`。
+
+仍 OPEN 的 P2：
+
+- 服务端返回 `recording_urls_list` 数组：`D:/web/zyt/server/app/adminapi/logic/tcm/DiagnosisLogic.php:1810-1833`；admin 把完整数组交给播放器，并在每个具体 call row 提供上传入口：`D:/web/zyt/admin/src/views/tcm/diagnosis/components/CallRecordPanel.vue:30-72`。
+- Python `_fill_video` 只取 `raw_urls[0]`，其余回放不可见，且视频表没有指定 `call_record_id` 的上传操作列：`src/doctor_workstation/ui/dialogs/diagnosis.py:1126-1135`、`:2844-2881`。虽然 repository 已支持 `call_record_id`（`src/doctor_workstation/services/repository.py:1894-1913`），UI 没有把它接出来。
+
+该问题不造成错误写入，且工具栏上传与一个回放可用，故按 **P2** 而非 P1 计。
+
+### 2. 医生备注：`[CLOSED；后端限制已明确]`
+
+- NotesTimeline 已暴露新增、上传、删除单附件与打开附件信号：`src/doctor_workstation/ui/diagnosis_drawer.py:1804-1810`、`:1820-1851`、`:1887-1961`；dialog 绑定真实方法：`src/doctor_workstation/ui/dialogs/diagnosis.py:989-997`、`:2376-2487`。
+- production DTO 分别走 `doctor.appointment/addDoctorNote`、`doctor.appointment/doctorNotes`、`doctor.appointment/deleteDoctorNoteImage`：`src/doctor_workstation/services/repository.py:935-985`。权限分别按新增与删除附件 endpoint 裁剪：`src/doctor_workstation/ui/dialogs/diagnosis.py:478-483`、`:1233-1241`。
+- admin 自身也只有追加、上传、删除单附件动作：`D:/web/zyt/admin/src/views/patient/reception/components/NoteTimeline.vue:195-268`；API 定义仅三条：`D:/web/zyt/admin/src/api/patient.ts:19-40`。
+
+服务端不可实现边界：
+
+- controller 仅暴露 `addDoctorNote`、`doctorNotes`、`deleteDoctorNoteImage`，随后类即结束：`D:/web/zyt/server/app/adminapi/controller/doctor/AppointmentController.php:168-198`。
+- `DoctorNoteLogic::addOrAppend` 对当天正文使用换行追加，不支持任意旧正文覆盖：`D:/web/zyt/server/app/adminapi/logic/doctor/DoctorNoteLogic.php:12-76`；唯一删除逻辑只删除附件数组中的单项：`:111-136`。
+
+因此“任意旧笔记正文覆盖/整条删除”不是桌面端漏接已有合同，而是服务端没有 endpoint；本报告将其列为**后端限制，不计客户端 P0/P1/P2**。
+
+### 3. 日常记录：`[OPEN / P2，新增 CLOSED]`
+
+已关闭部分：
+
+- edit 态已提供血糖、饮食、运动、跟踪备注新增按钮和待办新增/取消；只读态/无权限态隐藏：`src/doctor_workstation/ui/diagnosis_drawer.py:1363-1371`、`:1431-1450`、`:1481-1511`、`:1760-1791`。
+- dialog 将 signal 接到真实 add/todo repository，并为每次 mutation 使用 diagnosis-id + generation 校验后强制刷新：`src/doctor_workstation/ui/dialogs/diagnosis.py:1089-1101`、`:2175-2358`。
+- production 合同为 `tcm.bloodRecord/add`、`tcm.dietRecord/add`、`tcm.exerciseRecord/add`、`tcm.diagnosis/addTrackingNote`、todo add/cancel：`src/doctor_workstation/services/repository.py:1745-1765`、`:1778-1805`、`:1847-1873`。
+
+仍 OPEN 的 P2：
+
+- admin 点击已有单元格时会把记录（含 `id`）放入表单，保存时分别调用 blood/diet/exercise edit：`D:/web/zyt/admin/src/views/tcm/diagnosis/components/DailyMatrix.vue:921-1013`。
+- Python matrix 明确 `NoEditTriggers`、`NoSelection`，只有 `daily_add_requested`，没有已有记录 edit signal：`src/doctor_workstation/ui/diagnosis_drawer.py:1366-1371`、`:1455-1463`。dialog 也只选择 `add_*`：`src/doctor_workstation/ui/dialogs/diagnosis.py:2260-2284`。
+- 这不是后端限制：production repository 已实现三类 edit：`src/doctor_workstation/services/repository.py:1767-1776`、`:1787-1796`、`:1807-1818`。
+
+跟踪备注例外：server 设计就是“仅给今天追加”。controller 仅有 add/list：`D:/web/zyt/server/app/adminapi/controller/tcm/DiagnosisController.php:180-214`；`TrackingNoteLogic` 只有 `addOrAppend/getByDiagnosis`，类在第 95 行结束：`D:/web/zyt/server/app/adminapi/logic/tcm/TrackingNoteLogic.php:8-95`。其任意旧正文覆盖/整条删除同样属于后端无 endpoint 限制，不计客户端问题。
+
+### 4. 处方与详情订单动作：`[CLOSED]`
+
+- “开具处方”打开真实 `PrescriptionEditorDialog`，accepted 后调用 `create_prescription`，并携带 diagnosis/appointment/case snapshot：`src/doctor_workstation/ui/dialogs/diagnosis.py:2489-2539`。
+- 历史处方的“查看”打开真实 `PrescriptionDetailDialog`：`:2791-2842`。
+- 业务订单 lazy 列表、详情权限/真实 repository 门禁、异步 order generation 及详情 dialog 均已接通：`:1998-2000`、`:2069-2074`、`:2883-2991`。
+- 全局诊次偏移调用真实 `setRevisitSlotStartOffset`，并有独立 generation：`:2613-2650`。
+
+未发现处方或详情订单的假动作/越权入口，本项 **CLOSED**。
+
+### 5. 多挂号精确取消：`[CLOSED]`
+
+- 每个可取消挂号卡按精确 primary key 生成按钮，signal 携带原 record 与该 appointment-id：`src/doctor_workstation/ui/diagnosis_index_widgets.py:150-163`、`:1121-1148`。歧义的行级“取消挂号”仍只在唯一挂号时出现：`:1403-1410`。
+- handler 选择当前诊单后再次按 ID 和状态校验，确认前后都防 stale，最终仅调用 exact capability：`src/doctor_workstation/ui/pages/consultations.py:1868-1921`。
+- production 方法明确走 `doctor.appointment/cancel`，不再误用患者工作区 endpoint：`src/doctor_workstation/services/repository.py:1545-1555`。
+- 新测试覆盖两个挂号、超 32 位 appointment-id、错误诊单、状态刷新、权限/能力缺失与 canonical endpoint：`tests/test_diagnosis_index_visual.py:340-379`、`tests/test_consultations_parity_ui.py:610-774`、`tests/test_diagnosis_detail_contract.py:90-105`。
+
+本项 **CLOSED**。
+
+### 6. 真实 Shell owner / 60% / move-resize / generation：`[CLOSED]`
+
+- `_owner` 不再在 page 构造期缓存；每次 `open_for/showEvent` 都从当前 `parent.window()` 重绑真实 Shell：`src/doctor_workstation/ui/dialogs/diagnosis.py:526-527`、`:1314-1349`、`:1398-1408`。
+- overlay 与 owner 同位置/尺寸，宽屏 drawer 固定为 owner 宽度 60%；监听 owner 的 Resize/Move/Show/Close：`:1283-1299`、`:1351-1371`。
+- `reject/done` 及 owner Close 会使 detail/save/orders/order-detail/daily/notes/media/offset/所有 lazy-tab generation 全部失效：`:1373-1383`、`:1681-1700`。
+
+真实 `ShellWindow -> QStackedWidget -> ConsultationsPage -> cached DiagnosisDialog` offscreen 探针结果：
+
+```text
+OPEN  owner_shell=True shell=(1200,760) dialog=(1200,760) panel=720 expected=720 pos=(80,60)
+MOVED shell=(1024,650) dialog=(1024,650) panel=614 expected=614 pos=(190,140)
+CLOSE visible=False generation=True media=True
+```
+
+本项 **CLOSED**。现有 `tests/test_diagnosis_drawer_visual.py:837-861` 仍只用直接顶层 owner；本次额外真实 Shell 探针补足了业务终验，但建议后续把该探针固化成回归测试。
+
+### 7. 列表 QR / 日志 / 订单：`[OPEN / P1，主体 CLOSED]`
+
+已关闭部分：
+
+- 页面只在 canonical 权限与真实 repository 方法同时存在时展示视频 QR、确认 QR、日志、订单入口：`src/doctor_workstation/ui/pages/consultations.py:704-715`、`:1005-1030`。
+- QR DTO 校验 patient/doctor/share-user/diagnosis，日志使用 diagnosis-id，所有菜单请求均受 selection generation 保护：`:1972-2091`。
+- production repository 真实调用 `generateMiniProgramQrcode`、`guahaoLogList`、`order.order/create`：`src/doctor_workstation/services/repository.py:1967-2060`。测试验证 exact DTO、权限裁剪与 stale callback：`tests/test_diagnosis_detail_contract.py:85-127`、`tests/test_consultations_parity_ui.py:777-958`。
+
+仍 OPEN 的 P1：
+
+- admin 创建订单成功后读取 `order_no`，立即调用 `generateOrderQrcode` 并展示付款 QR：`D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:1474-1509`。
+- Python `_create_diagnosis_order` 把真实 create 放进通用 `_run_mutation`；该 helper 丢弃 `_result`，只 toast + refresh，因此永远不会生成付款 QR：`src/doctor_workstation/ui/pages/consultations.py:2093-2128`、`:2460-2479`。
+- repository 明明已有 `generate_order_qrcode`：`src/doctor_workstation/services/repository.py:2062-2076`，但 UI 源码没有任何调用。现有测试也只分别测试“UI 创建订单”和“repository 可生成 QR”，未覆盖两者串联：`tests/test_consultations_parity_ui.py:777-872`、`tests/test_diagnosis_detail_contract.py:88-89`。
+
+订单已实际创建却不展示付款入口，用户容易停在半完成状态或重复建单；这是主流程闭环缺失，按 **P1 OPEN** 计。
+
+## 离线验证记录
+
+使用项目现有 `.venv`，设置 `QT_QPA_PLATFORM=offscreen`、`PYTHONDONTWRITEBYTECODE=1`，禁用 pytest cache，并把 basetemp 放在系统临时目录；未安装任何依赖：
+
+```text
+pytest -q -p no:cacheprovider \
+  tests/test_diagnosis_detail_contract.py \
+  tests/test_diagnosis_index_visual.py \
+  tests/test_diagnosis_drawer_visual.py \
+  tests/test_appointment_drawer_visual.py \
+  tests/test_consultations_parity_ui.py \
+  tests/test_prescription_security_ui.py \
+  tests/test_patients_ui.py \
+  tests/test_repository_parity.py \
+  tests/test_permissions.py
+
+128 passed
+```
+
+测试退出码为 0；`--collect-only -q` 分文件计数合计 128。另执行了上述真实 Shell owner 探针，退出码为 0。
+
+## 发布判断
+
+当前不存在错误 endpoint、歧义挂号取消、权限泄漏、隐私明文回流或关闭后旧异步回调落地等 P0 风险。生产视频/IM、备注追加、日常新增、处方、订单详情及列表主要动作均已从“假动作/未接入”进展为真实 repository 行为。
+
+但若发布标准是“完整保留 admin 的订单支付闭环与所有已存在的数据编辑/回放能力”，当前仍不满足：**剩余 P0 0 / P1 1 / P2 2**。其中任意旧医生/跟踪笔记正文覆盖或整条删除必须先扩展 server endpoint，不能作为桌面端单独修复项。

app/research/diagnosis_post_visual_audit.md

@@ -0,0 +1,113 @@
+# 诊疗工作台第三次、最终只读视觉同型审计
+
+审计日期：2026-08-10  
+审计性质：最终只读终验；除更新本报告外，未修改任何业务代码、测试、renderer 或 PNG。  
+事实源：当前 Python 源码、D:/web/zyt/admin/src/views/tcm/diagnosis/ 下 Vue 基准、三份既有视觉规格，以及 artifacts/diagnosis_visual/ 当前 43 张 PNG。  
+判定方法：43 张 PNG 均按原始尺寸逐张目检；源码只用于解释可见结果与确认真实能力。测试通过数不作为任何视觉结论的依据，本轮也未以测试替代目检。
+
+## 最终结论
+
+**PARTIAL，不是 PASS。**
+
+- P0：**0 OPEN**。语义表单、1024 栅格、右固定列、双尺寸 60% 抽屉、固定 footer、核心 loading/empty/error/focus/permission 状态均未回退。
+- 上一版 12 项 P1：**8 项 CLOSED / EXACT，4 项仍 OPEN / PARTIAL**。
+- 43 张当前 PNG：**36 张 EXACT（其中两张 edit 仅指入镜区域）、7 张 PARTIAL、0 张乱码或不可读**。
+- 列表、详情、预约与 Shell 的所有 loading 图均为真实圆弧 spinner；没有字符型 spinner、方框箭头、中文乱码或缺字。
+- 当前不能判 PASS 的原因是：1024 Daily 动作行裁切及按钮语义态被压平；完整菜单仍缺 Vue 图标、danger 删除色和精确文案；备注附件视觉仍未命中预期样式；处方/订单/视频/聊天仍有可见简化或缺少关键截图证据。
+- “既有笔记整条正文覆盖 / 删除整条笔记”另列为服务端合同限制，不计作伪造桌面能力，也不用于掩盖上述视觉 P1。
+
+## 上一版 12 项 OPEN 逐项终验
+
+| # | 上一版问题 | 状态 | 同型分类 | 最新精确证据与目检结论 |
+|---:|---|---|---|---|
+| 1 | 统计端就诊卡仍非 switch | **CLOSED** | **EXACT（组件）** | 当前已使用自绘二态 DiagnosisSwitch，44×24 轨道、圆形滑块、0/1 文本合同：src/doctor_workstation/ui/diagnosis_drawer.py:643-675；表单 show_card 分支：src/doctor_workstation/ui/dialogs/diagnosis.py:924-925；Vue 基准：D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:341-348。现有 edit PNG 没有滚到该字段，因此本项是源码级确定结论，不引用测试，也不声称有单独的 switch 截图。 |
+| 2 | Daily 编辑动作不完整 | **OPEN** | **PARTIAL** | + 血糖 / + 饮食 / + 运动 / + 备注、刷新、新增待办和精确可取消动作均已接入：src/doctor_workstation/ui/diagnosis_drawer.py:1431-1450、:1486-1512、:1764-1784；真实处理：src/doctor_workstation/ui/dialogs/diagnosis.py:2175-2356。可是 diagnosis_state_daily_1024x640.png 中最右“刷新”被抽屉右缘裁掉；原因是单个 QHBoxLayout 不换行（diagnosis_drawer.py:1398-1451），而 Vue 明确 flex-wrap（D:/web/zyt/admin/src/views/tcm/diagnosis/components/DailyMatrix.vue:1094-1109）。同时“最近7天”的 checked 态、+血糖 与新增待办的 primary 态均被 scoped 基础按钮规则压平；Vue 的主动作在 DailyMatrix.vue:25-35、DiagnosisTodoList.vue:3-19。 |
+| 3 | “更多”菜单动作被关闭 | **OPEN** | **PARTIAL** | 能力缺口已补齐：权限/真实方法策略在 src/doctor_workstation/ui/pages/consultations.py:1002-1031，handler 在 :1672-1692；diagnosis_full_menu_1280x800.png 已出现指派、取消指派、视频二维码、确认二维码、取消挂号、挂号日志、创建订单、删除。仍不同型：Python 只创建纯文字 QAction（src/doctor_workstation/ui/diagnosis_index_widgets.py:1381-1431），Vue 每项有图标，删除为 divided + danger 红，并使用“二维码”而不是“确认二维码”（D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:379-400）。QMenu 白底、边框、hover 与分隔线样式已生效（diagnosis_index_widgets.py:1371-1380），但未覆盖这些剩余语义。 |
+| 4 | Tab 溢出仍用左右箭头 | **CLOSED** | **EXACT** | 原生左右工具按钮宽度归零，额外 4 px 横向滚动条可见并驱动选中 Tab：src/doctor_workstation/ui/diagnosis_drawer.py:194-242、:749-792；Vue 基准：D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:1798-1828。所有 1024 详情状态图均无盒状左右箭头，蓝色细滚动条连续可见。 |
+| 5 | footer 缺上投影 | **CLOSED** | **EXACT** | footer 使用 blur 18、offset 0/-4、半透明深色 QGraphicsDropShadowEffect：src/doctor_workstation/ui/dialogs/diagnosis.py:784-803；Vue 为 0 -4px 24px / 7%：D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:1792-1796。edit/viewOnly/daily/save 状态图均可见 footer 上缘阴影，且 footer 始终在滚动体外。 |
+| 6 | 保存中无按钮 spinner / 结果态 | **CLOSED** | **EXACT** | SaveStateButton 以 QTimer + QPainter 画 loading 圆弧、成功勾和失败叉：src/doctor_workstation/ui/diagnosis_drawer.py:678-746；只在 editable/basic 显示：src/doctor_workstation/ui/dialogs/diagnosis.py:1652-1661；真实保存状态切换：:3044-3163。diagnosis_state_save_loading/success/failure_1024x640.png 分别完整显示“正在保存 / 保存成功 / 保存失败”，无缺字。 |
+| 7 | readonly 摘要拆“客服” | **CLOSED** | **EXACT** | 摘要值禁止换行并使用 MinimumExpanding：src/doctor_workstation/ui/dialogs/diagnosis.py:681-712；“客服：…”赋值：:1767-1770。diagnosis_readonly_1024x640.png 与 diagnosis_readonly_1440x900.png 均完整显示“客服：赵医助”，不再拆字。 |
+| 8 | Notes 缺新增、上传、删除动作 | **OPEN** | **PARTIAL** | 动作和真实端点已存在：NotesTimeline 信号/工具栏/单附件删除在 src/doctor_workstation/ui/diagnosis_drawer.py:1804-1962；处理在 src/doctor_workstation/ui/dialogs/diagnosis.py:2376-2478；远端合同在 src/doctor_workstation/services/repository.py:935-985。diagnosis_state_notes_actions_1024x640.png 已显示新增/追加、上传舌象、上传报告、打开与单附件删除。但视觉仍不同型：QSS 写的是 QLabel#DiagnosisTongueThumb 与 QLabel#DiagnosisAttachmentChip（diagnosis_drawer.py:486-500），运行时却创建 QPushButton（:1897-1900、:1932-1937），所以截图中的“舌象/查看”和报告附件退化为普通白按钮，而非 Vue 的真实缩略图、文件 chip 与叠加 CircleClose（D:/web/zyt/admin/src/views/patient/reception/components/NoteTimeline.vue:42-100）。 |
+| 9 | 处方、订单、视频、聊天仍为简化实现 | **OPEN** | **PARTIAL / MISSING** | 处方已接完整 PrescriptionEditorDialog 和真实 create_prescription（src/doctor_workstation/ui/dialogs/diagnosis.py:2489-2539），订单偏移及详情入口已接真实方法（:2613-2650、:2883-2941），视频上传/回放和聊天归档同步也已接真实方法（:2541-2611、:2844-2881）。但视觉仍未闭合：处方按钮在 diagnosis_state_empty_1024x640.png 中为普通白色“开具处方”，而 Vue 是 primary 小号“开方”（D:/web/zyt/admin/src/views/tcm/diagnosis/components/CaseRecordList.vue:1-5）；当前证据集没有处方编辑器或订单详情抽屉 PNG。diagnosis_state_video_replay_1024x640.png 只有外链“播放回放”，代码通过 QDesktopServices 打开 HTTP(S)（diagnosis.py:2652-2658、:2874-2881），而 Vue 是表格内 RecordingPlaybackBlock（D:/web/zyt/admin/src/views/tcm/diagnosis/components/CallRecordPanel.vue:17-34）。diagnosis_state_chat_archive_1024x640.png 有气泡、文件和同步/重载，但省略 Vue 的完整 info alert 和详细归档说明（D:/web/zyt/admin/src/views/tcm/diagnosis/components/ImChatRecordPanel.vue:1-20）。订单偏移可见部分本身为 EXACT。 |
+| 10 | 表格状态仍整格着色而非 pill | **CLOSED** | **EXACT** | set_status_tag 以 QLabel pill 放入 cell widget，不再染整格：src/doctor_workstation/ui/diagnosis_drawer.py:2366-2384；所有状态列经 semanticize 转换：src/doctor_workstation/ui/dialogs/diagnosis.py:1900-1921、:2752-2754、:2822-2825、:2870-2874、:2898-2902。diagnosis_state_daily_lower_1024x640.png 的“待执行”蓝色 pill 是直接视觉证据。 |
+| 11 | Shell 仍为 216/68 且无 40 px tabs | **CLOSED** | **EXACT** | 侧栏 183：src/doctor_workstation/ui/shell.py:537-540；topbar 50：:599-603；multiple-tabs 40：:683-687。diagnosis_shell_1024x640.png 与 diagnosis_shell_1440x900.png 均可直接量出 183/50/40 三段，比例一致。 |
+| 12 | Shell 颜色偏离且箭头缺字 | **CLOSED** | **EXACT（本项范围）** | 侧栏为 #1D2124：src/doctor_workstation/ui/shell.py:541-569；方向、刷新、全屏、下拉、关闭图形均由 QPainter 自绘，不依赖字体 glyph：:257-395；topbar/tab QMenu 样式：:599-628、:683-723。两张最新 Shell PNG 中“更多筛选”、行“更多”、用户菜单和 tabs 菜单箭头均正常，没有方框或乱码。 |
+
+## 最后增加的三个专项检查
+
+| 专项 | 状态 | 结论 |
+|---|---|---|
+| scoped panel 按钮 | **OPEN / PARTIAL** | src/doctor_workstation/ui/diagnosis_drawer.py:112-136 的 QDialog#DiagnosisDialogRoot QPushButton 规则确实把详情按钮从全局暖灰绿主题隔离出来；但它的 ID 选择器优先级高于全局 QPushButton[variant="primary/ghost"]（src/doctor_workstation/ui/theme.py:87-118），而局部 QSS 没有补 primary、ghost、dangerGhost、diagnosisRange:checked 规则。结果在 daily/处方/视频/待办 PNG 中所有动作都被压成同一白色按钮，选中态也不清楚。这是实图结果，不是测试推断。 |
+| QMenu | **OPEN / PARTIAL** | diagnosis_full_menu_1280x800.png 证明局部白底、细边框、32 px 左右行高、分隔线和菜单宽度已生效；但与 Vue 相比仍缺每项图标、danger 删除色，且“确认二维码”文案不精确。证据：src/doctor_workstation/ui/diagnosis_index_widgets.py:1371-1431 对照 D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:379-400、:2706-2708。 |
+| 紧凑 close | **CLOSED / EXACT** | Header close 被限定 32×32、透明常态、蓝色 hover/focus：src/doctor_workstation/ui/diagnosis_drawer.py:137-154；创建位置：src/doctor_workstation/ui/dialogs/diagnosis.py:754-782。diagnosis_state_focus_1024x640.png 显示紧凑透明常态，默认 edit/viewOnly 图显示蓝色 focus/hover 外观，没有被全局 40 px footer 按钮规则放大。 |
+
+## 43 张 PNG 原尺寸目检矩阵
+
+下表的 EXACT 只针对该张 PNG 实际入镜内容；不以不可见的滚动下方内容作证明。
+
+| PNG | 分类 | 原尺寸目检结论 |
+|---|---|---|
+| diagnosis_1024x640.png | **EXACT** | 窄屏筛选换行、表格内部横向溢出、右固定列和阴影稳定，无硬裁切。 |
+| diagnosis_1440x900.png | **EXACT** | 宽屏列密度、复合挂号卡、斑马/业务语义色和固定操作区成立。 |
+| diagnosis_advanced_filters_1280x800.png | **EXACT** | 高级筛选即时展开，日期范围、控件顺序和重置入口完整。 |
+| diagnosis_double_appointment_cancel_1280x800.png | **EXACT** | 同一诊单两条预约均有各自取消入口，虚线层级和固定列正常。 |
+| diagnosis_empty_1280x800.png | **EXACT** | 表头、内部空态、横向滚动和 0 条分页均保留。 |
+| diagnosis_error_1280x800.png | **EXACT** | 错误文本居中可读，无旧数据穿透。 |
+| diagnosis_focus_1280x800.png | **EXACT** | 搜索框蓝色 focus ring 清楚且不挤压布局。 |
+| diagnosis_full_menu_1280x800.png | **PARTIAL** | 8 项动作与分隔线齐全；缺 Vue 图标、danger 删除色，二维码文案不同。 |
+| diagnosis_horizontal_scroll_1024x640.png | **EXACT** | 主表横移、右 460 px 固定区不动，左缘阴影连续。 |
+| diagnosis_hover_warning_1280x800.png | **EXACT** | warning 行 hover 渐变、3 px 左条和固定区同步。 |
+| diagnosis_loading_1280x800.png | **EXACT** | 表内真实圆弧 spinner，内容淡化，无字符缺字。 |
+| diagnosis_pending_assign_1280x800.png | **EXACT** | 待分配 chip、月份与宽搜索保持同一流式区。 |
+| diagnosis_permissions_cropped_1280x800.png | **EXACT** | 权限裁掉 toolbar 与敏感动作，仅保留查看。 |
+| diagnosis_edit_1024x640.png | **EXACT（可见区）** | 60% 抽屉、2/3 列语义表单、细 tab 条、固定 footer 无裁切；switch 未入镜。 |
+| diagnosis_edit_1440x900.png | **EXACT（可见区）** | 宽屏密度、字段比例和 footer 稳定；switch 未入镜。 |
+| diagnosis_readonly_1024x640.png | **EXACT** | 独立只读页、hero、病例卡完整，“客服”不拆字。 |
+| diagnosis_readonly_1440x900.png | **EXACT** | 4 列病例密度和异常指标层级完整，无不必要换行。 |
+| diagnosis_viewonly_1024x640.png | **EXACT** | 60% 只读抽屉、权限提示、禁用表单与仅关闭 footer 成立。 |
+| diagnosis_viewonly_1440x900.png | **EXACT** | 宽屏只读栅格、全 Tab 条和固定 footer 成立。 |
+| diagnosis_state_daily_1024x640.png | **PARTIAL** | DailyMatrix、异常/自录内容和新增动作出现；最右“刷新”被裁，range/primary 语义态被压平。 |
+| diagnosis_state_daily_lower_1024x640.png | **PARTIAL** | 趋势、待办筛选、表格与 pill 出现；“新增待办”不是 Vue primary，toolbar 语义层级不足。 |
+| diagnosis_state_empty_1024x640.png | **PARTIAL** | 处方空态和仅取消 footer 正确；“开具处方”按钮文案/primary 样式不同，且未覆盖真实处方编辑器。 |
+| diagnosis_state_error_1024x640.png | **EXACT** | danger banner、重试、空表单、禁用保存完整。 |
+| diagnosis_state_focus_1024x640.png | **EXACT** | 姓名 focus ring、紧凑 close 常态和固定 footer 清晰。 |
+| diagnosis_state_loading_1024x640.png | **EXACT** | 圆弧 spinner 与“正在加载诊单...”完整，无旧 seed 或缺字。 |
+| diagnosis_state_permission_1024x640.png | **EXACT** | 只保留病历/医生备注，手机号与身份证掩码，footer 仅关闭。 |
+| diagnosis_state_notes_actions_1024x640.png | **PARTIAL** | 增加/上传/打开/单附件删除均出现；舌象与报告未呈现为 Vue 缩略图/chip。 |
+| diagnosis_state_order_offset_1024x640.png | **EXACT（可见区）** | 偏移数值框、保存、订单表、分页与横向滚动完整；订单详情未入镜。 |
+| diagnosis_state_save_failure_1024x640.png | **EXACT** | 红色叉与“保存失败”完整。 |
+| diagnosis_state_save_loading_1024x640.png | **EXACT** | 白色圆弧 spinner 与“正在保存”完整。 |
+| diagnosis_state_save_success_1024x640.png | **EXACT** | 绿色勾与“保存成功”完整。 |
+| diagnosis_state_video_replay_1024x640.png | **PARTIAL** | 回放动作可见且文案完整；仍是外链按钮，不是 Vue 表内播放器。 |
+| diagnosis_state_chat_archive_1024x640.png | **PARTIAL** | 左右气泡、图片/文件入口、同步/重载可见；完整 info alert 与原文案缺失。 |
+| diagnosis_shell_1024x640.png | **EXACT（本项范围）** | 183/50/40，深色侧栏、分页、三角箭头和中文均无缺字。 |
+| diagnosis_shell_1440x900.png | **EXACT（本项范围）** | 同一 Shell 比例在宽屏保持，固定列阴影和 horizontal scroll 清楚。 |
+| appointment_drawer_1024x640.png | **EXACT** | 60% 右抽屉、日期/时段、body 滚动与固定 footer 无裁切。 |
+| appointment_drawer_1440x900.png | **EXACT** | 医生 radio、四个 130×40 日期按钮、时段网格、备注与 footer 对齐。 |
+| appointment_drawer_empty_doctors_1440x900.png | **EXACT** | warning、80 px 空态插图、“暂无可预约医生”和禁用确认完整。 |
+| appointment_drawer_empty_roster_1440x900.png | **EXACT** | 无排班 warning、空态插图和“该医生暂无排班”可读。 |
+| appointment_drawer_error_1440x900.png | **EXACT** | “号源加载失败：号源服务暂时不可用”、刷新入口与空态并存。 |
+| appointment_drawer_keyboard_focus_1440x900.png | **EXACT** | 130×40 日期按钮的蓝色键盘 focus 边界清楚。 |
+| appointment_drawer_loading_1440x900.png | **EXACT** | “正在加载医生、渠道与挂号状态...”与真实圆弧 spinner 完整，无缺字。 |
+| appointment_drawer_refreshing_1440x900.png | **EXACT** | “正在刷新可用号源...”与 overlay spinner 完整，确认禁用。 |
+
+## 服务端合同限制：不归入视觉 P1
+
+当前服务端只提供“当日追加 / 查询 / 删除单个附件”，没有“任意覆盖既有正文”或“删除整条笔记”端点：
+
+- D:/web/zyt/server/app/adminapi/controller/doctor/AppointmentController.php:168-196 只公开 addDoctorNote、doctorNotes、deleteDoctorNoteImage。
+- D:/web/zyt/server/app/adminapi/logic/doctor/DoctorNoteLogic.php:14-69 按 diagnosis_id + 当天 find-or-create，并把新正文追加为新行，不是任意覆盖。
+- D:/web/zyt/server/app/adminapi/logic/doctor/DoctorNoteLogic.php:114-136 只删除 tongue_images / report_files 中的单个路径。
+- D:/web/zyt/admin/src/api/patient.ts:19-40 同样只有上述三个客户端 API。
+- Python 远端仓库与该合同一致：src/doctor_workstation/services/repository.py:935-985。
+
+因此桌面端没有伪造“覆盖旧正文 / 删除整条笔记”按钮是正确的 fail-closed 行为。该限制不能被当作视觉 PASS 的理由，也不应混入上面 4 个仍可修的 UI P1。
+
+## 最终判定
+
+- **P0：0 OPEN。**
+- **P1：4 OPEN / PARTIAL**：Daily 动作行与 scoped 按钮语义；完整菜单图标/删除色/文案；Notes 附件视觉；处方/订单/视频/聊天视觉与证据覆盖。
+- **MISSING 视觉证据**：当前 diagnosis_visual 没有滚动到 switch 的截图，也没有完整处方编辑器和订单详情抽屉截图；源码能力存在，但不能用测试代替这些像素证据。
+- **乱码 / 缺字：0。** 43 张图中的中文、圆弧 loading、箭头、保存勾叉均完整。
+- **最终：PARTIAL。** 只有消除上述 4 组可见差异并补齐处方编辑器、订单详情与 switch 的当前截图后，才可给视觉同型 PASS。
+

app/research/diagnosis_python_visual_gap.md

@@ -0,0 +1,547 @@
+# Python 医生工作站诊单视觉 / 交互差异审计
+
+> 审计日期：2026-08-10  
+> 结论：**OPEN — 当前实现不具备与管理端诊单主链做截图级验收的条件。** 主要差异不是局部颜色或间距，而是索引页层级、表格固定列、只读/编辑形态和预约选择器的组件架构不同。  
+> 约束：本轮只读检查业务源码；只新增本审计文档，未修改 Python、Vue、接口、payload、权限、状态门槛或业务流程。  
+> 环境说明：项目提示的 `D:/web/zyt/app/.trellis/` 当前不存在，因此没有可补读的 Trellis 工作流或包级规格。
+
+## 1. 范围与事实源
+
+当前 Python 审计范围：
+
+- `D:/web/zyt/app/src/doctor_workstation/ui/theme.py`
+- `D:/web/zyt/app/src/doctor_workstation/ui/widgets.py`
+- `D:/web/zyt/app/src/doctor_workstation/ui/shell.py`
+- `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py`
+- `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py`
+- `D:/web/zyt/app/src/doctor_workstation/ui/pages/patients.py` 中 `_AppointmentDialog` 及其入口
+
+管理端唯一视觉事实源：
+
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue`
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue`
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/readonly.vue`
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/appointment.vue`
+- 上述页面直接渲染的 diagnosis components、`NoteTimeline.vue` 以及直接生效的全局样式
+
+研究基线：
+
+- `D:/web/zyt/app/research/diagnosis_index_visual_spec.md:1-373`
+- `D:/web/zyt/app/research/diagnosis_detail_visual_spec.md:1-565`
+
+明确排除：其他角色页面、小程序、企微运营、二维码、视频观看弹窗、未被三主视图引用的旧 Blood/Diet/Exercise/Tracking 组件，以及任何业务接口改造。本报告提到权限时，只描述入口或 Tab 的可见状态，不重新设计权限规则。
+
+## 2. 总体判定
+
+| 领域 | 当前状态 | 阻断截图复刻的根因 |
+|---|---|---|
+| 全局主题与密度 | OPEN | Qt 是暖灰绿、13 px、36 px 控件；管理端诊单基线是冷灰白、14 px、32 px 控件，索引主色为 `#4A5DFF` |
+| 诊单索引 | OPEN | 多出页面标题；筛选永久四行；单表无右固定列；行操作、复合单元格、分页、空态和 loading 架构不同 |
+| 诊单只读 / 编辑 | OPEN | 独立 readonly 与 drawer viewOnly 被合并成同一个居中 `QDialog`；Tabs、字段布局和内容主链大量不等价 |
+| 预约 | OPEN | 60% 右 Drawer 被固定 540×560 Dialog 取代；医生、日期、时段网格全部降级为 ComboBox |
+| 1024×640 | OPEN | 880×680 诊单 Dialog 请求高度超过外窗；索引页无页面级滚动且高级筛选常驻，表格可见高度过低 |
+| 1440×900 | OPEN | 索引仍缺固定 460 px 右区；详情/预约保持固定宽度，无法随视口保持 60% 比例 |
+
+必须先完成四项结构改造，再做颜色和像素微调：
+
+1. 诊单索引改回“无页面标题 + 两张平卡 + 折叠筛选”。
+2. 诊单表使用专用 model/delegate，并实现右侧 `120 + 340 = 460 px` 固定区域。
+3. 将独立 readonly 页面与 edit/viewOnly Drawer 拆成两个视觉形态。
+4. 将预约恢复为右侧 Drawer，并恢复医生 radio、日期按钮、时段卡片网格及完整状态。
+
+## 3. 基础 token 与壳层差异
+
+### G-01 [阻断] 字体、颜色、控件与圆角是另一套设计系统
+
+管理端诊单索引基线为 `PingFang SC, Arial, Hiragino Sans GB, Microsoft YaHei`、基础 14 px、页面 `#F6F6F6`、卡片 `#FFFFFF`、主/常规/次要文字 `#333/#666/#999`、默认控件 32 px、small 24 px、索引主色 `#4A5DFF`、卡片 r4。证据：
+
+- `D:/web/zyt/admin/src/config/setting.ts:1-14`
+- `D:/web/zyt/admin/src/styles/var.css:1-43`
+- `D:/web/zyt/app/research/diagnosis_index_visual_spec.md:65-101`
+
+当前 Qt 为 Microsoft YaHei UI 优先、基础 13 px、画布/表面 `#F4F3EF/#FCFBF8`、墨绿/青绿 `#17382F/#168579`、按钮和输入最小 36 px/r9、卡片 r16。状态色也全部偏成低饱和绿褐色。证据：
+
+- `D:/web/zyt/app/src/doctor_workstation/ui/theme.py:13-33`
+- `D:/web/zyt/app/src/doctor_workstation/ui/theme.py:36-84`
+- `D:/web/zyt/app/src/doctor_workstation/ui/theme.py:87-175`
+- `D:/web/zyt/app/src/doctor_workstation/ui/theme.py:233-250`
+
+可见后果：同一页面的字宽、首屏密度、按钮高度、卡片轮廓、语义色和表格行数均不同；仅替换主色不能修复。
+
+建议边界：在 `D:/web/zyt/app/src/doctor_workstation/ui/theme.py:13-275` 增加以 `#DiagnosisIndex`、`#DiagnosisDrawer`、`#DiagnosisReadonly`、`#AppointmentDrawer` 为根的局部 token/QSS。除非另立全工作站换肤任务，不应直接改写共享 `Card`、`QPushButton`、`QTableWidget` 的全局规则。
+
+### G-02 [高] 壳层占宽与页面滚动模型不同
+
+当前 Shell 最小 1024×640，侧栏固定 216 px、顶栏固定 68 px，workspace 的 `QStackedWidget` 本身没有页面滚动容器：
+
+- `D:/web/zyt/app/src/doctor_workstation/ui/shell.py:306-325`
+- `D:/web/zyt/app/src/doctor_workstation/ui/shell.py:329-423`
+
+管理端默认侧栏宽 183 px，navbar 50 px，默认还可显示 40 px multiple tabs；路由内容由 `el-scrollbar` 承担整页纵向滚动，页面外留白为 8 px 水平 / 16 px 垂直：
+
+- `D:/web/zyt/admin/src/config/setting.ts:1-6`
+- `D:/web/zyt/admin/src/styles/var.css:4-10`
+- `D:/web/zyt/admin/src/layout/default/components/header/multiple-tabs.vue:65`
+- `D:/web/zyt/admin/src/layout/default/components/main.vue:2-11`
+
+当前诊单页又额外使用 24 px 水平边距，因此两档窗口下的静态内容宽约为：
+
+| 外窗 | 当前 workspace | 当前页面内容宽 | 管理端默认路由内容宽（约） | 差值 |
+|---|---:|---:|---:|---:|
+| 1024×640 | 808 | 760 | 824 | -64 px |
+| 1440×900 | 1224 | 1176 | 1240 | -64 px |
+
+建议边界：索引页自行增加页面级滚动及 8/16 外留白；不要为了修诊单页直接改变全工作站 216/68 壳。若最终验收要求连管理端壳一起复刻，应另行冻结侧栏、navbar、multiple tabs 的 setting 后再改 `ShellWindow`。
+
+### G-03 [高] hover、checked、focus、read-only 状态不完整
+
+- 日期和业务入口都是 checkable ghost `QPushButton`，但 QSS 没有 `QPushButton[variant="ghost"]:checked`；active 态没有确定的可见反馈。当前：`D:/web/zyt/app/src/doctor_workstation/ui/theme.py:87-118`、`D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:495-528,776-799`；基准：`D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:2227-2308`。
+- Qt 输入 focus 直接把 1 px 边改为 2 px 青绿实线，存在内部尺寸跳动；管理端是 primary-light 的 2 px 外环。当前：`D:/web/zyt/app/src/doctor_workstation/ui/theme.py:140-154`；基准：`D:/web/zyt/admin/src/styles/element.scss:140-175`。
+- 按钮、Tab、radio、checkbox 没有统一的键盘 focus ring；表格还显式 `outline:0`。当前：`D:/web/zyt/app/src/doctor_workstation/ui/theme.py:87-138,164-186,208-220`。
+- read-only `QPlainTextEdit` 没有独立 QSS，仍呈白底可编辑外观；只定义了部分 `:disabled`。当前：`D:/web/zyt/app/src/doctor_workstation/ui/theme.py:140-155`、`D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:685-689`。
+- 表格没有显式 item hover 规则；管理端普通 hover 是 `#F8F8F8`，业务行还有语义渐变。当前：`D:/web/zyt/app/src/doctor_workstation/ui/theme.py:177-197`；基准：`D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:2723-2735`。
+
+建议边界：为诊单专用 chip、输入、Tab、表格 delegate 增加状态规则；保留键盘可达性，不必复刻 HTML `span` 不可聚焦的缺陷。focus 不应通过改变边框占位宽度实现。
+
+### G-04 [中] 共享组件的视觉契约与诊单基线不同
+
+- `PageHeader` 固定生成标题/副标题层级：`D:/web/zyt/app/src/doctor_workstation/ui/widgets.py:331-365`。
+- `EmptyState` 是 30 px 圆圈 + 16 px 标题 + 说明 + 44 px 垂直留白：`D:/web/zyt/app/src/doctor_workstation/ui/widgets.py:388-420`。
+- `BusyOverlay` 是文字 + 140 px 横向 progress，非 42 px 环形 spinner：`D:/web/zyt/app/src/doctor_workstation/ui/widgets.py:489-514`、`D:/web/zyt/app/src/doctor_workstation/ui/theme.py:230-231,271`。
+- `SortableTable` 是单选、全列本地排序、纯文本 item、末列 stretch：`D:/web/zyt/app/src/doctor_workstation/ui/widgets.py:535-575`。
+- `Pager` 只有 total、上一页、页码分数、下一页：`D:/web/zyt/app/src/doctor_workstation/ui/widgets.py:585-627`。
+
+建议边界：新增诊单专用组件，不要破坏性修改这些被患者、订单、接诊页共享的类。
+
+## 4. 诊单索引页差异
+
+### I-01 [阻断] 页面层级、留白和卡片形态错误
+
+管理端页面内没有标题或说明；路由内容直接从无边框、无阴影、r4 的筛选白卡开始，第二张列表卡相距 12 px。新增诊单在列表卡工具栏：
+
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:2-177`
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:2200-2211,2408-2434`
+
+当前页面先放 25 px `PageHeader("问诊列表", …)`，并把新增按钮放在标题右侧；外边距 24/20/24、间距 14。两张卡是有边框的暖白 r16，表格自身再加 r12，形成“卡中卡”：
+
+- `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:464-587`
+- `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:590-674`
+- `D:/web/zyt/app/src/doctor_workstation/ui/theme.py:54-84,177-197`
+
+建议边界：只在 `ConsultationsPage.__init__` 移除页面内 `PageHeader`，将 add 入口移入列表工具栏；保留 Shell topbar。诊单两卡使用局部 objectName/QSS。
+
+### I-02 [阻断] 日期 / 业务 chip 顺序、文案、换行和语义态不同
+
+管理端顺序严格是“昨天挂号、前天挂号、当天挂号、明天挂号、后天挂号、全部”，随后是待预约/已完成/待分配医助；左侧 chips 可换行，计数是同行半透明文字。三种业务 chip 分别用 info/success/warning：
+
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:6-70`
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:964-970`
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:2222-2317`
+
+当前顺序是“前天、昨天、今天、明天、后天、全部”，缺“挂号”文案；九个按钮放在不可换行的 `QHBoxLayout`，全部是通用 ghost，无业务色和明确 checked 态：
+
+- `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:483-530`
+- `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:776-799`
+
+在 1024 档，按钮加入两三位计数后可能在约 760 px 内容宽内被挤压或裁字。
+
+建议边界：增加诊单局部 `FlowLayout` 和带 dynamic property 的 chip；沿用现有 `_choose_*` 与 `_update_quick_buttons()`，只换视图装配和文案。
+
+### I-03 [阻断] 筛选的两层结构被永久四行网格取代
+
+管理端：第一行右侧是固定 160 px 搜索 + 32 px primary 查询；第二行是“挂号/确认”小 chips 和“更多筛选”；高级区默认隐藏，点击后即时显隐，使用虚线上边界和可换行布局：
+
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:72-151`
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:2320-2405`
+
+当前：关键词、挂号、确认和所有高级条件永久铺成四行等宽 `QGridLayout`；查询/重置在最后一行。挂号/确认变成 ComboBox；最近日期范围被拆成四个独立 `QDateEdit`；还常驻一个管理端通过表头表达的“未服务排序”下拉：
+
+- `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:532-586`
+- `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:683-721`
+
+当前还缺待分配模式选中后显示的月份 128 px 和宽搜索 220 px / max 42vw；管理端证据为 `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:40-70,2298-2317`。
+
+建议边界：重建筛选视图，但保留 `_search()`、`_filters()`、日期校验和现有请求字段。是否补待分配月份/宽搜索涉及现有请求参数，超出本视觉报告授权；在业务层确认前先预留容器，不自行发明接口字段。
+
+### I-04 [阻断] 列表工具栏与选择模型不等价
+
+管理端列表栏无“诊单记录”标题；左侧是新增、批量指派、批量取消指派，右侧按需显示“已选 n 条”。表格首列为 48 px checkbox 多选：
+
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:154-191`
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:2414-2429`
+
+当前工具栏是标题 + 总数摘要 + 查看/诊单/开方/作废/视频/删除/刷新等全局按钮；表格无 checkbox，使用整行单选，加载后自动选第一行并出现青绿选择底：
+
+- `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:590-640`
+- `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:938-946`
+- `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:1085-1112`
+- `D:/web/zyt/app/src/doctor_workstation/ui/widgets.py:541-549`
+
+建议边界：视图层改为 checkbox check-state；不要用整行 selection 代替多选。批量动作若当前业务方法不存在，本轮只应建立视觉容器和禁用态，不得伪造 mutation。
+
+### I-05 [阻断] 表格列、固定区、排序和行操作架构不同
+
+管理端列顺序与宽度为：选择 48、ID min70、患者 min60、性别年龄 100、挂号 min175、确认 88、复诊 min120、助理 100、开方 72、未服务 110、视频旁观 120 fixed、操作 340 fixed。声明最小总宽约 1403 px，右固定区共 460 px：
+
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:191-406`
+- `D:/web/zyt/app/research/diagnosis_index_visual_spec.md:169-186`
+
+当前列约 1392 px，但无选择/操作列，额外有医生 90、作废 74；挂号 300、未服务 180、视频 90。所有列随单一 `QTableWidget` 一起滚动，末列还会 stretch：
+
+- `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:646-663`
+- `D:/web/zyt/app/src/doctor_workstation/ui/widgets.py:535-552`
+
+管理端只允许“未服务天数”走 descending → ascending 的自定义排序；当前全部表头都可做客户端排序，并另设排序 ComboBox：
+
+- 基准：`D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:297-304`
+- 当前：`D:/web/zyt/app/src/doctor_workstation/ui/widgets.py:543-549`、`D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:560-570`
+
+管理端每行右侧有查看、诊单、开方/查看处方、预约、补全身份证和“更多”菜单；当前把少量动作集中在列表栏，行内没有动作命中区：
+
+- 基准：`D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:342-403`
+- 当前：`D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:605-639`
+
+建议边界：新增 `DiagnosisTableModel`、专用 delegates 和同步的双 `QTableView`；右表只显示 120/340 两列，共享 model、selection、垂直滚动与 row height。不要把固定列能力硬塞进通用 `SortableTable`。
+
+### I-06 [阻断] 复合单元格、语义色、hover 和密度全部降级为纯文本
+
+当前 `SortableTable.set_rows()` 只创建 `QTableWidgetItem(text)`；格式化函数也只拼接字符串：
+
+- `D:/web/zyt/app/src/doctor_workstation/ui/widgets.py:554-575`
+- `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:233-322`
+
+由此缺失：
+
+- ID/患者 14 px/600；`NEW` 20 px danger tag。
+- 挂号块的 11 px badge、14 px/600 医生、12 px 时间、状态渐变、多预约虚线、取消挂号链接和最近渠道。
+- 已确认/未确认、已开方/未开方、处方作废 tag。
+- 未服务 null/`<=2`/`3–6`/`>=7` 的灰/绿/橙/红，以及健康打卡 tooltip。
+- 普通白/#FAFAFA 斑马、#F8F8F8 hover、未确认/未挂号的 3 px 左条和渐变。
+- 行级视频入口和 340 px 动作链接区。
+
+管理端证据：
+
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:193-406`
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:2442-2735`
+
+当前表格头是 12 px/700、`#EEF1EE`，alternate 为暖灰 `#F6F7F4`；基准表头为 13 px/600、`#F8F8F8`，普通预约行约 52 px。当前只调用 `resizeRowsToContents()`，无 39/52 px 基线：
+
+- 当前：`D:/web/zyt/app/src/doctor_workstation/ui/theme.py:177-197`、`D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:938-940`
+- 基准：`D:/web/zyt/app/research/diagnosis_index_visual_spec.md:163-212`
+
+建议边界：复合绘制与 `sizeHint()` 均放在诊单 delegates；不要给每格常驻 QWidget。行样本必须覆盖多预约和动作换行，且双表 row height 同步。
+
+### I-07 [高] 分页、空态、loading、error 的布局契约不同
+
+分页基线为 total、15/20/30/40 size、prev、最多 5 个数字页、next、jumper，按钮 32 px；当前只有 total、上一页、`1/N`、下一页，按钮最小 36 px：
+
+- 基准：`D:/web/zyt/app/research/diagnosis_index_visual_spec.md:254-262`
+- 当前：`D:/web/zyt/app/src/doctor_workstation/ui/widgets.py:585-627`
+
+空态基线保留表头和分页，仅在 table body 显示约 60 px 高的“暂无数据”。当前切换整个 `content_stack` 到大型 `EmptyState`，表头与分页同时消失：
+
+- 基准：`D:/web/zyt/app/research/diagnosis_index_visual_spec.md:264-273`
+- 当前：`D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:642-673`、`D:/web/zyt/app/src/doctor_workstation/ui/widgets.py:388-420`
+
+loading 基线只覆盖表格，亮色 `rgba(255,255,255,.5)` + 42 px 主色环；20 秒静默刷新不闪。当前普通加载在两卡之间插入 MessageBanner，并禁用刷新，没有 table overlay；共享 `BusyOverlay` 的形态也不匹配：
+
+- 基准：`D:/web/zyt/app/research/diagnosis_index_visual_spec.md:275-280`
+- 当前：`D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:901-956`、`D:/web/zyt/app/src/doctor_workstation/ui/widgets.py:489-514`
+
+错误当前只显示全宽 Banner，原表/旧数据仍在；管理端主表没有独立 error 插画。建议保留错误消息但不得让 Banner 插入造成卡片整体跳位。
+
+建议边界：新增诊单专用 PaginationBar、table viewport empty label 和 table-only overlay；保持现有 generation、silent refresh 与错误传递逻辑不变。
+
+### I-08 [高] 页面纵向滚动与少量数据高度不同
+
+管理端表格没有本页固定高度；15 行自然撑高并由路由 `el-scrollbar` 滚整页。当前列表卡以 stretch=1 填满余高，表格内部滚动；一行数据时会留下大块空白，15 行时筛选和工具栏固定在窗口而不是随页面滚动：
+
+- 基准：`D:/web/zyt/admin/src/layout/default/components/main.vue:2-11`、`D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:179-190`
+- 当前：`D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:642-674`
+
+建议边界：诊单页使用单一 `QScrollArea` 承载两卡，表格按 header + 实际 rows + pagination 给自然高度；不要改其他页面的内部表滚动策略。
+
+## 5. 诊单只读 / 编辑差异
+
+### D-01 [阻断] 两种只读形态被合并为一个居中 Dialog
+
+管理端有两个不可互换的只读形态：
+
+1. `readonly.vue`：独立单列页面，无 Tabs，Hero 后按顺序纵向展示摘要、病例、日常记录、备注、订单、视频、聊天、指派、挂号。
+2. `edit.vue` 的 `viewOnly`：仍是 60% 右 Drawer + Tabs + disabled 表单，只隐藏保存。
+
+证据：
+
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/readonly.vue:1-149`
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:1-84,766-781`
+- `D:/web/zyt/app/research/diagnosis_detail_visual_spec.md:75-152,156-194`
+
+当前所有查看/编辑都调用同一个 `DiagnosisDialog.open_for()`；只通过 `setReadOnly` 和保存按钮显隐切模式：
+
+- `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:245-288`
+- `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:426-464`
+- `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:1113-1129`
+- `D:/web/zyt/app/src/doctor_workstation/ui/pages/patients.py:2142-2151`
+
+建议边界：保留 `open_for()`、saved signal、现有 load bundle 和数据快照；仅拆视图为 `DiagnosisReadonlyView` 与 `DiagnosisDrawerView`，由入口决定呈现形态。不得通过给现有 QDialog 换皮来声称两种基线都已覆盖。
+
+### D-02 [阻断] Drawer 几何与 Header/Body/Footer 三段壳缺失
+
+编辑/viewOnly 基线为 RTL 右 Drawer、宽视口 60%、全高；header 为白到 `#F8FAFC` 渐变和底线，body `#F8FAFC`，footer 独立白底、上边线，按钮右对齐、40 px/r10：
+
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:3-10`
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:1670-1745`
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:1776-1864`
+
+当前是居中系统 `QDialog`，请求 880×680、最小 680×520，统一暖灰画布，四周 20/18；标题 25 px。按钮栏虽在 Tabs 外，能保持不随首 Tab 滚动，但没有 footer frame、边线和确定按钮顺序：
+
+- `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:245-288`
+- `D:/web/zyt/app/src/doctor_workstation/ui/theme.py:44-46,54-58,87-104`
+
+当前 mode 文案/颜色也不同：后台只读 info、编辑 warning、新建 success；当前只读 neutral、可编辑 success，且标题是“患者信息详情/编辑患者病历”：`D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:256-266,441-447`。
+
+建议边界：在主窗之上实现遮罩 + 右贴边 panel，按外窗宽度计算 60%；只让 body 滚动，header/footer 固定。保留 QDialog 作为临时承载会继续出现系统标题栏和居中几何差异。
+
+### D-03 [阻断] Tabs 样式、顺序、权限可见性和内容主链不等价
+
+管理端顺序：病历、医生备注、日常记录、处方、业务订单、视频录制回放、聊天、指派、挂号；“跟踪备注”已注释，不渲染。Tabs 为可横滚文本导航，4 px scrollbar，active 3 px 底条：
+
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:55-759`
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:1798-1858`
+
+当前只有患者与病历、医生备注、挂号记录、指派记录、可选患者订单；挂号先于指派，日常记录/待办、处方、视频、聊天均缺失。除订单外，Tab 没按对应权限移除：
+
+- `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:271-279`
+- `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:479-525`
+
+当前全局 Tab 是青绿填充 pill、r9、36 px，无 3 px active indicator：`D:/web/zyt/app/src/doctor_workstation/ui/theme.py:208-220`。
+
+建议边界：用诊单局部 `QTabBar + QStackedWidget` 或可横滚 TabBar；按既有 canonical permissions 移除入口，当前 Tab 失权时回病历。不要加入已注释 TrackingNote，也不要重复增加旧 Blood/Diet/Exercise Tabs。
+
+### D-04 [阻断] 编辑表单被统一成单列大文本框，字段顺序也偏离真实模板
+
+当前 `_DIAGNOSIS_FIELDS` 将全部字段装成单列 `QFormLayout + QPlainTextEdit`，每项 46–82 px；没有 160 px label、栅格、分组标题或语义控件：
+
+- `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:49-102`
+- `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:331-346`
+
+管理端是 12 px 表单、160 px label、32 px input/select/date/number、radio/check-button、24/12/8 栅格、18 px 项间距，以及横线夹胶囊的分组标题：
+
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:57-632`
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:1476-1667`
+
+当前与后台真实模板的具体偏差：
+
+- 缺少/不等价：诊单ID表单行、状态、渠道、统计端就诊卡、当地诊断日期、糖尿病病史、口腔感觉、其他补充、病史补充。
+- “当前用药”被放在末尾；后台“在用药物”位于生命体征区。
+- 当前显示后台模板未渲染的证型、糖尿病类型、自由文本主诉/现病史/症状、食欲、舌象、舌苔、脉象、临床诊断、治则、处方、处方意见、医嘱。
+- 类别项都变成自由文本，失去 radio/check/select 的密度和状态。
+
+真实后台字段次序见 `D:/web/zyt/app/research/diagnosis_detail_visual_spec.md:221-255`。
+
+患者基本信息锁定时，当前只设 read-only，没有后台 warning Alert：
+
+- 当前：`D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:659-689`
+- 基准：`D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:71-84`
+
+建议边界：只重建 `DiagnosisDialog` 的表单装配和 scoped QSS，保留字段值转换、校验、保存入口及隐私遮罩。严格按后台实际渲染字段，不把脚本模型中但模板未显示的字段继续呈现。
+
+### D-05 [阻断] 独立 readonly 的 Hero、卡片流和病例网格完全缺失
+
+readonly 基线：16 px 页面边距/卡间距；可换行浅蓝 Hero 带返回、患者名、性别年龄、未服务绿橙红 badge；白卡 r14、18 px padding、标题前 3×16 蓝条；患者摘要按确定顺序，病例按 4/3 列分组键值展示：
+
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/readonly.vue:1-149`
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/readonly.vue:257-405`
+- `D:/web/zyt/app/research/diagnosis_detail_visual_spec.md:75-152`
+
+当前没有返回、Hero、未服务 badge 或纵向卡片流。摘要是两列九项，额外含身份证/血压/血糖，却缺地区、预约状态、是否开方和备注；病例仍是单列可编辑形态：
+
+- `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:290-349`
+- `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:574-700`
+
+建议边界：单独实现只读卡片 view；不要把 disabled 编辑表单当作独立 readonly。1440 档保留后台 4/3 列；1024 档若主动降列，应在验收中标注为桌面可用性增强，而不是声称 Vue 原实现已有响应式。
+
+### D-06 [高] 备注、订单、历史表和关联内容被降级或缺失
+
+- 医生备注：后台是时间轴、64×64 缩略图、文件 chip、编辑动作；当前仅三列“时间/医生/内容”。基准 `D:/web/zyt/admin/src/views/patient/reception/components/NoteTimeline.vue:1-436`；当前 `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:351-364`。
+- 日常记录/待办：后台有日期筛选、矩阵、趋势、toolbar 和待办；当前整个 Tab 缺失。基准 `D:/web/zyt/admin/src/views/tcm/diagnosis/components/DailyMatrix.vue:1-1260`、`D:/web/zyt/admin/src/views/tcm/diagnosis/components/DiagnosisTodoList.vue:1-319`。
+- 处方历史：后台七列并有编辑态开方入口；当前缺失。基准 `D:/web/zyt/admin/src/views/tcm/diagnosis/components/CaseRecordList.vue:1-106`。
+- 业务订单：后台有就诊序号工具栏、九列、Tag/红金额、固定详情；当前八列为订单号/处方/收货人/手机/金额/发货/状态/创建，无工具栏和详情动作。当前 `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:393-424,764-787`；基准 `D:/web/zyt/admin/src/views/tcm/diagnosis/components/PatientOrderList.vue:7-148,252-276`。
+- 指派历史：后台九列；当前六列且继承只是纯文本。当前 `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:378-390,748-762`；基准 `D:/web/zyt/admin/src/views/tcm/diagnosis/components/AssignLogPanel.vue:1-43`。
+- 挂号历史：后台十二列和多个状态 Tag；当前七列。当前 `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:370-390,731-746`；基准 `D:/web/zyt/admin/src/views/tcm/diagnosis/components/AppointmentRecordPanel.vue:1-75`。
+- 视频与聊天：当前完全缺失。基准 `D:/web/zyt/admin/src/views/tcm/diagnosis/components/CallRecordPanel.vue:1-214`、`D:/web/zyt/admin/src/views/tcm/diagnosis/components/ImChatRecordPanel.vue:1-293`。
+
+当前所有表格最终都只创建纯文本 `QTableWidgetItem`：`D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:711-716`。
+
+建议边界：按当前主视图可达组件增加局部 model/delegate；不把不可达旧组件或观看弹窗混入。缺失内容若尚无当前 repository 数据来源，应明确保持 OPEN，不能用静态假数据冒充视觉完成。
+
+### D-07 [高] loading、empty、error、保存与隐私锁定状态不足
+
+- 打开详情时只显示 MessageBanner，种子内容继续可见；没有 readonly 页面级 overlay/skeleton：`D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:452-464`。
+- 加载失败只改 Banner，后台独立 readonly 应在 Hero 下显示错误 Empty：当前 `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:570-573`；基准 `D:/web/zyt/admin/src/views/tcm/diagnosis/readonly.vue:31-36`。
+- 清空表格只是 `setRowCount(0)`，没有“暂无…”状态：`D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:702-709`。
+- 订单翻页仍用全局 Banner，未遮住对应 Tab 内容：`D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:789-827`。
+- 保存只禁用按钮并显示 Banner，没有按钮 loading 动画或字段级 danger：`D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:829-917`。
+- 隐私/业务锁定只有只读控件，无 warning Alert，且 read-only 控件视觉仍像可编辑白框：`D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:659-689`、`D:/web/zyt/app/src/doctor_workstation/ui/theme.py:140-155`。
+
+建议边界：为每个内容区域提供局部 overlay/empty/error；保留 seed-first、generation 和异常处理。错误样式不能改变业务成功/失败判定。
+
+## 6. 预约差异
+
+### A-01 [阻断] 预约 Drawer 被固定居中 Dialog 取代
+
+基线为 RTL 右 Drawer、外窗 60% 宽、全高、遮罩点击不能关闭、独立 footer；表单 label 100 px：
+
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/appointment.vue:2-19,185-198`
+
+当前是居中 540×560 模态 QDialog、20/18 内边距、系统标题栏、默认 QFormLayout label 宽；内容顶部还额外放 25 px 患者名和“患者号仅用于视频”说明：
+
+- `D:/web/zyt/app/src/doctor_workstation/ui/pages/patients.py:219-299`
+
+建议边界：保留 `_AppointmentDialog` 的异步查询、状态字段、`payload()` 和 `accept()`；只把承载层替换为右贴边 panel，并将 Header/Body/Footer 分离。不要改 `PatientsPage._book_appointment()` 的业务调用：`D:/web/zyt/app/src/doctor_workstation/ui/pages/patients.py:2208-2224`。
+
+### A-02 [阻断] 字段顺序和控件类型不等价
+
+后台严格顺序是：上次就诊、预约方式、预约类型、当前患者、渠道、条件性自媒体补充、医生 radio、日期按钮、时段矩阵、备注：
+
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/appointment.vue:20-181`
+
+当前缺上次就诊、预约方式和当前患者；预约类型是 ComboBox，医生/日期/号源也全是 ComboBox：
+
+- `D:/web/zyt/app/src/doctor_workstation/ui/pages/patients.py:247-285`
+
+渠道基线宽 100%、最大 360 px；当前随 QFormLayout 拉伸，没有最大宽。`channel_source_detail` 创建后默认可见，初始化信号又被 `_setting` 拦截，因此首帧/默认渠道可能错误显示“渠道补充”；只有后续用户 change 才显隐：
+
+- 当前：`D:/web/zyt/app/src/doctor_workstation/ui/pages/patients.py:260-268,345-402,587-594`
+- 基准：`D:/web/zyt/admin/src/views/tcm/diagnosis/appointment.vue:62-75,741-750`
+
+建议边界：按真实顺序重建表单控件；沿用当前字段与校验，不改变 payload key。条件控件在初始渲染时就必须正确隐藏。
+
+### A-03 [阻断] 日期和时段的所有可见状态都被下拉框吞掉
+
+后台医生为可换行 radio；日期按钮 min 130×40、r8、14 px，hover 上移 2 px并有阴影；时段容器为 `#F8F9FA`、16 px padding，网格 cell min 110×70，显式展示可约、不可约、hover、selected 和刷新 loading：
+
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/appointment.vue:77-171`
+- `D:/web/zyt/admin/src/views/tcm/diagnosis/appointment.vue:752-921`
+
+当前只将医生、日期、可用号源放进 ComboBox；`_apply_slots()` 直接过滤不可约、quota<=0 和当天过去时段，因此不可约卡、状态标签、slot hover、selected 渐变和刷新入口均无法呈现：
+
+- `D:/web/zyt/app/src/doctor_workstation/ui/pages/patients.py:269-280`
+- `D:/web/zyt/app/src/doctor_workstation/ui/pages/patients.py:534-574`
+
+建议边界：以服务端原始 slot 列表驱动局部 Flow/Grid；业务上不可提交的时段保留为 disabled card。当前的未来日期限制、过期判定和 submit gate 保持不变。
+
+### A-04 [高] loading、空态、重复预约、hover/focus 状态不足
+
+- 后台未选医生/无排班在时间区显示 Empty；当前只是 ComboBox placeholder + Banner：基准 `D:/web/zyt/admin/src/views/tcm/diagnosis/appointment.vue:100-171`；当前 `D:/web/zyt/app/src/doctor_workstation/ui/pages/patients.py:410-493`。
+- 后台 `v-loading` 覆盖预约 body；当前所有阶段复用表单下方 MessageBanner，没有区域 overlay：基准 `D:/web/zyt/admin/src/views/tcm/diagnosis/appointment.vue:10`；当前 `D:/web/zyt/app/src/doctor_workstation/ui/pages/patients.py:286-299,439-448,521-532`。
+- 当天冲突基线在顶部持续显示 warning，切其他日期显示 info；当前只计算今日 blocking 并通过提交禁用/accept 文案表达，没有持续的 warning/info 双态：当前 `D:/web/zyt/app/src/doctor_workstation/ui/pages/patients.py:319-402,600-643`；基准 `D:/web/zyt/admin/src/views/tcm/diagnosis/appointment.vue:10-18,359-386`。
+- 后台 available hover、disabled opacity、selected 蓝渐变和 slot refresh loading 当前均不存在。
+- 当前 generic focus 仍是青绿 2 px 实边，radio/date/slot 的 focus-visible 不存在。
+
+建议边界：增加预约 body overlay、时间区 empty、顶部冲突 alert、按钮/卡片 hover/pressed/focus；保留现有 `_today_blocking` 与 submit complete 判定。
+
+### A-05 [高] 预约响应式和滚动安全不足
+
+基线预约 Drawer 自身没有 <=768 media query，但内部医生、日期、slot 可换行，body 是 Drawer 可滚区域。当前固定 540×560 且无 `QScrollArea`；恢复完整 slot 网格后若继续用当前容器，1024×640 必然裁掉内容或 footer。
+
+建议边界：桌面保持 60% 比例；当可用内容宽不足时再做全宽/单列增强，并明确这是 PySide 可用性增强。body 独立滚动，footer 永远留在可视区。
+
+## 7. 两档窗口的确定性差异
+
+### 1024×640
+
+| 视图 | 管理端基线 | 当前源码请求 | 必须验收的风险 |
+|---|---|---|---|
+| 索引 | 页面内容可整体纵向滚；表宽约1403，右460固定 | 内容约760；高级筛选四行常驻；单表约1392且无固定列 | chip 计数裁字、表格高度仅剩少数行、动作不可见、空/loading移位 |
+| edit/viewOnly | 右贴边约614 px、全高、固定 footer | 居中880×680，最小680×520 | 请求高度已超过640；系统窗口可能裁剪/强制缩放，footer不可作为稳定截图基线 |
+| appointment | 右贴边约614 px、全高 | 居中540×560 | 宽度偏小且大量留白；恢复slot后无滚动会裁内容 |
+| standalone readonly | 页面流、16px边距、无Tabs | 880px模态Tabs | 模式、层级和宽度均不可比较 |
+
+### 1440×900
+
+| 视图 | 管理端基线 | 当前 | 必须验收的风险 |
+|---|---|---|---|
+| 索引 | 内容宽约1240；仍可能横滚，右460固定 | 内容约1176；横滚约248px且无固定列 | 视频/操作随滚动消失；少量数据时列表卡被拉出大空白 |
+| edit/viewOnly | 右贴边约864 px | 居中880×680 | 宽度偶然接近，但方向、全高、三段壳仍错误 |
+| appointment | 右贴边约864 px | 居中540×560 | 明显过窄，无法呈现日期/slot网格密度 |
+| standalone readonly | 宽页面流，病例4/3列 | 固定880px单列表单 | 信息密度和卡片层级完全不同 |
+
+注：Element Drawer 的 60% 按外窗 viewport 计算，因此上表为约 614/864 px；不按 Python 扣除侧栏后的 workspace 计算。
+
+## 8. 建议改动边界（按文件 / 类）
+
+| 目标 | 允许的视觉改造 | 必须保持不动 |
+|---|---|---|
+| `D:/web/zyt/app/src/doctor_workstation/ui/theme.py:13-275` | 新增诊单局部 token、scoped QSS、checked/focus/read-only/overlay/delegate 状态 | 不全局换肤其他页面；不改变业务状态含义 |
+| `D:/web/zyt/app/src/doctor_workstation/ui/widgets.py:331-627` | 新增 FlowLayout、DiagnosisPaginationBar、局部 loading/empty、专用 model/delegate/固定表辅助 | 不破坏现有 PageHeader、EmptyState、SortableTable、Pager 的调用方 |
+| `D:/web/zyt/app/src/doctor_workstation/ui/shell.py:306-423` | 仅当全壳明确纳入验收时调整；可提供 drawer host/overlay host | 不以改壳宽度掩盖诊单页布局问题 |
+| `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:464-674` | 重建索引层级、筛选、工具栏、表格绑定、页面滚动 | 保留 repository 调用、过滤语义、权限判断、generation、mutation、视频门槛 |
+| `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:901-956` | 将普通 loading/error 映射到 table-only overlay/状态层 | 20秒 silent refresh 继续不闪；不改请求时序 |
+| `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:208-424` | 拆 readonly/drawer 视图，重建 header/tabs/form/cards/tables | 保留 `open_for` 契约、saved signal、隐私可见性和已有数据加载 |
+| `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:426-917` | 把加载/错误/锁定/保存映射到局部视觉状态 | 不改 endpoint、payload、字段校验、generation、防过期响应 |
+| `D:/web/zyt/app/src/doctor_workstation/ui/pages/patients.py:219-646` | 把预约改成 Drawer、radio/date/slot grid、overlay/empty/alert | 保留排班来源、日期/过期过滤、冲突门槛、submit gate、`payload()` |
+| `D:/web/zyt/app/src/doctor_workstation/ui/pages/patients.py:2208-2224` | 仅替换打开的视觉容器 | 不改预约保存调用与 mutation reconcile |
+
+推荐实施顺序：
+
+1. 建 scoped token 与 drawer/table 基础组件。
+2. 重建 index 层级、筛选、固定列和 states。
+3. 拆 readonly 与 edit/viewOnly，先完成壳和病历主 Tab。
+4. 补当前可达的 notes/orders/histories；数据源不存在的主链保持显式 OPEN。
+5. 重建 appointment 卡片式选择器。
+6. 最后做两档截图的字号、间距和颜色微调。
+
+## 9. 截图验收前置条件
+
+所有截图固定：Windows 缩放 100%、默认亮色、同一 Qt 字体回退、同一权限集合、相同样本数据、无本地主题覆盖。运行态字体/DPR、tooltip/dropdown 坐标和 scrollbar 像素应记录环境，不应以静态源码推断绝对像素。
+
+索引样本至少包含：`NEW`、双预约、已完成预约、爽约、未确认、已确认未挂号、处方作废、unserved=`null/2/5/8`、可进入/不可进入视频。
+
+详情样本至少包含：患者基本信息可编辑/锁定、全部权限/裁减权限、备注含图片和文件、订单有/无数据、挂号/指派有/无数据、加载失败。
+
+预约样本至少包含：未选医生、无排班、可约、不可约、当天过去时段、选中、今日冲突、其他日期 info、渠道需要/不需要补充、loading/error。
+
+## 10. 截图验收矩阵
+
+| ID | 窗口 | 状态 / 操作 | 必须同时看见 | 关键判定 |
+|---|---|---|---|---|
+| IDX-01 | 1024×640 | 默认15条、筛选收起、横滚最左 | 无页面内标题；两张平卡；两行筛选；表头、分页 | chips 不裁字；搜索完整；默认当天 active；至少能正常纵向滚整页 |
+| IDX-02 | 1024×640 | 横滚到最右 | 左表发生横滚；视频120+操作340仍贴右 | 固定区不移动；双表 header/body/row height 无错位 |
+| IDX-03 | 1024×640 | 更多筛选展开 | 虚线分隔、高级控件可换行、表格仍可达 | 显隐无动画；24/32px混合高度按源码；页面整体可滚 |
+| IDX-04 | 1024×640 | 四类 chip active + 键盘 focus | 当天/待预约/已完成/待分配各自语义色 | 计数为同行文字；focus清晰且无几何跳动 |
+| IDX-05 | 1024×640 | 普通、未确认、未挂号 hover | 斑马、#F8F8F8 hover、3px语义条/渐变 | fixed区背景连续；hover不被 selection 色覆盖 |
+| IDX-06 | 1024×640 | 慢请求 loading | 原表尺寸保持、table-only 半透明层、42px spinner | 筛选/卡位置不跳；无全宽 banner 插入 |
+| IDX-07 | 1024×640 | 空结果 | 表头、60px“暂无数据”、分页 | 无大圆圈插画；pager不消失 |
+| IDX-08 | 1440×900 | 默认15条 | 完整两卡、自然表高、完整分页 | 少量数据不拉出大空白；15条由整页滚动承载 |
+| IDX-09 | 1440×900 | 多预约 + 操作换行 | 预约 badge/渐变/虚线、340px操作链接 | 行高由内容增长；左右固定表同步 |
+| IDX-10 | 两档 | tooltip / 更多菜单 | 助理溢出、未服务、视频 tooltip；bottom-end菜单 | tooltip只在语义命中区；删除前分隔且danger |
+| DET-01 | 1024×640 | edit 基本 Tab | 右侧约614px全高 Drawer、header、横滚Tabs、固定footer | body单独滚；footer不裁；label160px；无系统标题栏 |
+| DET-02 | 1024×640 | viewOnly + 患者锁定 | info badge、disabled表单、warning Alert、关闭按钮 | 无保存；read-only外观不似可编辑；隐私字段无泄漏 |
+| DET-03 | 1440×900 | edit 全权限 | 右侧约864px、Tab正确顺序、24/12/8栅格 | 无TrackingNote；active底条3px；表单字段顺序与§4.5一致 |
+| DET-04 | 两档 | 独立 readonly | 无Tabs/模态；返回+Hero+摘要+病例+权限卡片 | 1024可用；1440病例保持4/3列；未服务三色正确 |
+| DET-05 | 两档 | 详情 loading/error/empty | overlay；Hero下错误Empty；各表局部空态 | 不残留错误seed；error不导致footer/tab位移 |
+| DET-06 | 1440×900 | 备注/订单/指派/挂号 | 时间轴图片/文件；订单工具栏/详情；完整列/Tag | 表头顺序、状态色、固定动作列与管理端一致 |
+| APT-01 | 1024×640 | 初始 loading / 未选医生 | 右侧约614px Drawer、body overlay、时间区Empty、固定footer | label100px；footer可见；渠道补充默认正确隐藏 |
+| APT-02 | 1024×640 | 无排班 | 医生radio、时间区“暂无排班”Empty | 不用ComboBox placeholder冒充空态 |
+| APT-03 | 1024×640 | 可约/不可约/hover/selected | 日期130×40；slot最小110×70；刷新 | 不可约仍显示但禁用；hover抬升；selected蓝渐变 |
+| APT-04 | 两档 | 今日冲突 / 其他日期重复 | 顶部warning切info、确认disabled/available | 状态随所选日期切换；不只在点击提交后提示 |
+| APT-05 | 1440×900 | 完整预约表单 | 右侧约864px、医生和日期自然换行、slot多列 | 不保持540px窄窗；body滚动，footer固定 |
+| A11Y-01 | 两档 | 仅键盘遍历 | chip/input/select/radio/checkbox/table/button均有focus | 顺序可预测；focus对比足够；无控件尺寸抖动 |
+
+## 11. 发布门槛
+
+以下任一项仍存在即不能标记视觉对齐完成：
+
+- 索引页仍有第二个页面标题，或高级筛选默认常驻。
+- 表格仍是单个纯文本 `QTableWidget`，右侧 460 px 不固定。
+- 空态仍替换掉表头/分页，或普通加载仍插入全宽 Banner。
+- 只读与 viewOnly 仍复用同一个居中 Tabs Dialog。
+- 编辑/预约仍不是 60% 右贴边、全高、固定 footer 的 Drawer。
+- 病历仍由一串同形态 `QPlainTextEdit` 组成。
+- 医生、日期和时段仍以 ComboBox 代替 radio/button/grid。
+- 1024×640 下任何 footer、搜索、chip 或表格固定区被裁剪。
+- 1440×900 下预约仍固定 540 px，或详情仍只有固定 880 px 居中模态形态。
+- hover/focus/loading/empty/error/disabled/selected 任一规定状态没有独立截图证据。
+
+本报告只定义视觉和交互呈现的修复边界。所有 repository、endpoint、payload、权限 code、状态门槛和 mutation reconcile 均应原样保留，并在实现后另走现有业务回归测试。

app/research/diagnosis_release_contract_audit.md

@@ -0,0 +1,164 @@
+# 诊单发布后端合同独立终验
+
+- 终验日期：2026-08-11
+- 审计对象：`D:/web/zyt/app` 当前工作区终态
+- 对照基准：`D:/web/zyt/admin/src/views/tcm/diagnosis/`、其直接引用的 API，以及 `D:/web/zyt/server` 当前服务端控制器/Logic
+- 审计性质：只读业务与后端合同终验；未访问网络、未安装依赖、未调用线上接口；除本报告和 pytest 临时产物外，未修改业务源码或测试
+
+## 发布结论
+
+**PASS（限本报告题定范围）。**
+
+| 等级 | OPEN 数 | 结论 |
+|---|---:|---|
+| P0 | **0** | 未发现错误对象写入、越权入口、错误 endpoint、旧异步回调落地或主数据破坏风险 |
+| P1 | **0** | 题定的所有主流程均已形成真实后端闭环 |
+| P2 | **0** | 前两轮发现的 Daily 既有记录不可编辑、视频只显示首条 URL/不能逐通话追加等合同缺口均已关闭 |
+
+**AVAILABLE 后端功能是否全部对齐：是。** 在“admin 诊单页面及其直接组件/API 中、本报告明确列出的可用后端功能”这一范围内，桌面端已经全部对齐：列表查询与分页、权限和菜单、多挂号精确取消、订单创建与付款二维码、三种详情模式、Daily 新增/编辑、真实 Notes 追加与附件、处方/业务订单、视频、归档 IM，以及 Shell owner/异步代次保护均为真实调用，无伪造成功动作。
+
+这里的 AVAILABLE 不扩张为对 `admin` 全仓所有未枚举页面和无关路由的声明。本报告也不把后端从未提供的功能算成桌面端缺口：**任意旧笔记正文覆盖、删除整条医生笔记，以及旧跟踪备注改写/整条删除，在当前 server 快照中没有 endpoint，属于后端合同限制，不计入 P0/P1/P2。**
+
+## 合同终验矩阵
+
+| 题定能力 | 状态 | admin / 后端合同 | 桌面端终态 |
+|---|---|---|---|
+| 诊单列表筛选、分页、权限、菜单 | **CLOSED** | `tcm.diagnosis/lists`；canonical 权限；服务端动态菜单 | 筛选字段、待分配宽搜、分页总数/末页回退、统计计数请求、菜单裁剪均对齐 |
+| 多挂号精确取消 | **CLOSED** | `POST doctor.appointment/cancel {id}` | 每张挂号卡携带精确 appointment id，确认前后重验同一诊单和可取消状态 |
+| 创建订单后生成付款二维码 | **CLOSED** | `order.order/create` → `order_no` → `tcm.diagnosis/generateOrderQrcode` | 已消费真实 `order_no`，即时请求 QR；缺 order_no / qrcode_url 时 fail-closed，可重试且有 selection/generation 防串单 |
+| edit / viewOnly / readonly | **CLOSED** | edit、viewOnly 用 `detail`；独立 readonly 用 `readonlyDetail`；保存用 `edit` | mode dispatcher 与 admin 一致，viewOnly 不误打 readonly endpoint |
+| Daily 新增与既有血糖/饮食/运动编辑 | **CLOSED** | 三类 `add` / `edit` endpoint | 已有单元格解析 record id 并走 update；新增走 add；权限、DTO、owner/generation 校验完整 |
+| Notes 真实新增与附件 | **CLOSED（AVAILABLE）** | `addDoctorNote`、`doctorNotes`、`deleteDoctorNoteImage` | 正文真实追加；舌象/报告先上传得到服务端 URI 再新增；单附件真实删除 |
+| 处方与业务订单 | **CLOSED** | `tcm.prescription/add`、`listByDiagnosis`、`tcm.prescriptionOrder/lists` / `detail` 等 | 真实开方、历史处方查看、诊单上下文订单列表/详情与诊次偏移均接通 |
+| 视频全量回放与逐通话上传 | **CLOSED** | `getCallRecords`、`createManualCallRecord`、`attachLocalCallRecording` | 完整消费 `recording_urls_list`；工具栏上传可建手工记录；行内上传传精确 `call_record_id` |
+| IM 归档读取与同步 | **CLOSED** | `only_archived=1`、`triggerImChatSync` | 首次及重载均固定归档读取；真实触发同步并按 media generation 刷新 |
+| owner resize / generation | **CLOSED** | UI 生命周期合同 | 每次打开重绑真实 Shell；overlay 同步 Move/Resize/Show/Close；宽屏 60%、窄屏全宽；关闭使全部异步代次失效 |
+
+## 逐项证据
+
+### 1. 诊单列表：筛选、分页、权限与菜单
+
+- admin 的筛选模型及待分配宽搜在 `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:773-917`；待分配有关键词时只保留分页、`pending_assign=1` 和 `pending_assign_keyword`，没有关键词时带月份。
+- 桌面端 `src/doctor_workstation/ui/pages/consultations.py:1566-1602` 发送 canonical 字段：`keyword`、`has_appointment`、`diagnosis_confirmed`、`diagnosis_type`、`syndrome_type`、`assistant_id`、最新挂号日期/渠道、最新分配日期、`appointment_date`、`pending_booking`、`completed_appointment`、`pending_assign`、`sort_unserved_days`。待分配宽搜规则与 admin 一致。
+- `consultations.py:1604-1653` 把 `page/page_size` 传入 repository，消费真实 `total`，超末页时回退并重查；每页仅接受 15/20/30/40。`:1672-1741` 的日期/待挂号/已完成/待分配计数沿用同一筛选语义。
+- production repository 在 `src/doctor_workstation/services/repository.py:1562-1589` 调用 `GET tcm.diagnosis/lists`，不丢弃当前 canonical 查询字段。
+- `src/doctor_workstation/ui/shell.py:46-254` 将 `tcm.diagnosis/lists` 作为诊单导航权限，识别 `tcm/diagnosis` 与 `tcm/diagnosis/index`；生产菜单以服务端 visible/enabled/sort/children 为事实源，同时还必须通过精确 slash 权限。空生产菜单不会静默回退出诊单入口，demo 才允许本地回退。
+- 页面动作同样使用 exact slash 权限并同时检查 repository capability；没有把 dot 形式或相似字符串当成授权。
+
+结论：查询 DTO、统计 DTO、分页和动态菜单/动作门禁均与 admin 的实际合同对齐。
+
+### 2. 多挂号精确 `doctor.appointment/cancel`
+
+- admin 从 `D:/web/zyt/admin/src/api/doctor.ts:60` 调用 `/doctor.appointment/cancel`，诊单列表在 `index.vue:1820`、`:1847` 传具体挂号 `id`。
+- 桌面端按嵌套挂号数组生成多个操作；歧义的行级“取消挂号”仅在唯一可取消挂号时成立。`consultations.py:2040-2107` 会：
+  1. 按传入的精确 appointment id 查找状态可取消的挂号；
+  2. 绑定当前 diagnosis；
+  3. 用户确认后再次从当前模型按同一 id 重验；
+  4. 最终只把该 id 传给 diagnosis 专用取消方法。
+- `repository.py:1550-1555` 明确调用 `POST doctor.appointment/cancel {"id": appointment_id}`，没有误走患者工作区的 `firstvisit.myPatient/cancelAppointment`。
+
+结论：同一诊单有多条挂号时不会取消错行，超 32 位 Python 整数也不会因 UI 转换而截断；本项 CLOSED。
+
+### 3. 创建订单 → `order_no` → `generateOrderQrcode`
+
+- admin 的完整链在 `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:1478-1499`：`orderCreate` 成功后读取 `res.order_no`，随后请求 `generateOrderQrcode({order_no})`。
+- 桌面端 `consultations.py:2279-2329` 只有在 `tcm.diagnosis/order` 权限以及 create/QR 两个 capability 都存在时开放入口。
+- `:2331-2479` 已完整串联结果：读取顶层或 `data.order_no`，创建 QR 对话框并立即请求真实 QR；缺少 `order_no` 不会伪造二维码，缺少 `qrcode_url` 显示失败；retry、当前 diagnosis/patient、权限与独立 order generation 均受保护。
+- `repository.py:2035-2076` 精确调用 `order.order/create`，返回 mapping；再调用 `tcm.diagnosis/generateOrderQrcode {"order_no": ...}`，并强制要求非空 `qrcode_url`。
+
+结论：此前“订单已创建但付款 QR 闭环中断”的 P1 已关闭。
+
+### 4. edit、viewOnly、readonly endpoint 分流
+
+- admin edit 与 viewOnly 共用 `tcmDiagnosisDetail`：`D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:1263-1322`；保存调用 `tcmDiagnosisEdit`（`:1367`）。独立 readonly 页调用 `diagnosisReadonlyDetail`：`readonly.vue:155`、`:231`。
+- API 定义分别是 `GET /tcm.diagnosis/detail`、`POST /tcm.diagnosis/edit`、`GET /tcm.diagnosis/readonlyDetail`：`D:/web/zyt/admin/src/api/tcm.ts:9-11`、`:50-52`、`:60-62`。
+- 桌面端 mode resolver 在 `src/doctor_workstation/ui/dialogs/diagnosis.py:1427-1544`：edit 与 viewOnly 均调用普通 detail；仅独立 readonly 调用 readonlyDetail。`repository.py:1591-1626` 实现同一分流和 edit 保存。
+
+结论：viewOnly 不再误用权限感知 readonly endpoint；三种模式 CLOSED。
+
+### 5. Daily：新增及既有血糖/饮食/运动编辑
+
+- admin `DailyMatrix.vue:586-648` 按日期聚合记录并保留可编辑 id，`:921-1013` 点击已有单元格时载入记录，提交时按 id 在 add/edit 之间分流。
+- admin API 的现存合同为：
+  - `tcm.bloodRecord/add` / `edit`：`D:/web/zyt/admin/src/api/tcm.ts:114-120`；
+  - `tcm.dietRecord/add` / `edit`：`:146-152`；
+  - `tcm.exerciseRecord/add` / `edit`：`:173-179`。
+- 桌面端 Daily matrix 已按同样规则合并同日血糖字段，并给已有血糖、饮食、运动单元格保留 record id；`diagnosis.py:2234-2338` 分别打开新增/编辑器，并按 id 调用 add 或 update。
+- production repository 在 `repository.py:1758-1818` 精确实现上述六个 endpoint；编辑器保留饮食/运动既有图片，mutation 完成只在 diagnosis/patient 和 daily generation 仍匹配时刷新。
+
+结论：此前“只能新增、不能编辑已有三类记录”的 P2 已关闭。跟踪备注仍按后端设计只允许当天追加，见后端限制章节。
+
+### 6. Notes：真实新增、上传与单附件删除
+
+- admin `D:/web/zyt/admin/src/api/patient.ts:20-40` 只有三条医生笔记 API：`addDoctorNote`、`doctorNotes`、`deleteDoctorNoteImage`。
+- 桌面端 `diagnosis.py:2424-2511` 的正文新增真实调用 `add_doctor_note`；舌象/报告先调用 multipart `upload_material`，取得服务端 URI 后再把 URI 交给新增接口；单附件删除携带 note id、附件类别和服务器路径。
+- production repository 在 `repository.py:906-985` 实现上传以及 `doctor.appointment/addDoctorNote`、`doctor.appointment/doctorNotes`、`doctor.appointment/deleteDoctorNoteImage`，并拒绝把本地路径当成已上传附件提交。
+- 所有按钮同时受 exact permission 和 capability 裁剪，viewOnly/readonly 不出现可写入口。
+
+结论：当前后端实际 AVAILABLE 的 Notes 能力全部对齐；没有用本地假数据或“只 toast 不落库”模拟新增/附件操作。
+
+### 7. 处方与诊单上下文订单
+
+- 详情页处方 Tab 会查询 `tcm.prescription/listByDiagnosis`，编辑态“开方”打开真实处方编辑器并调用 `tcm.prescription/add`；历史处方查看使用该真实列表返回的处方数据打开详情对话框。
+- 订单 Tab 使用 `tcm.prescriptionOrder/lists` 并带诊单上下文，详情调用 `tcm.prescriptionOrder/detail`；诊次统计偏移调用真实 `setRevisitSlotStartOffset`。
+- production endpoint 证据：`repository.py:1131-1149`、`:1220-1265`、`:1633-1645`；UI 调度与 capability 门禁在 `diagnosis.py:2048-2058`、`:2534-2689`、`:2791-3186`。
+
+结论：题定的处方创建/查看及业务订单列表/详情/偏移均为真实后端行为，未发现伪动作或无权限仍可提交。
+
+### 8. 视频：全量 `recording_urls_list` 与逐 `call_record_id` 上传
+
+- admin `CallRecordPanel.vue:32` 把完整 `row.recording_urls_list` 传给播放组件；`:150-177` 支持“上传后新建手工通话记录再绑定”，也支持向指定现有记录追加。
+- 桌面端 `diagnosis.py:2899-2967` 会归一化并去重 direct URL 与完整 `recording_urls_list`，逐一提供播放入口，不再只取数组第一个元素。每个有正 id 的行提供“追加回放”，闭包携带该行精确 `call_record_id`。
+- `diagnosis.py:2587-2613` 将可选精确 id 交给 repository。`repository.py:1875-1943` 的顺序与 admin 一致：先上传；无 id 时创建 manual call record；最后调用 `attachLocalCallRecording`。已有 id 时不创建新记录，直接绑定该 id。
+
+结论：此前“只展示首条 URL、不能逐通话记录追加”的两个 P2 缺口均已关闭。
+
+### 9. IM：`only_archived` 与 sync
+
+- admin `ImChatRecordPanel.vue:148-185` 固定 `only_archived: 1` 并调用 `triggerImChatSync`。
+- 桌面端 lazy query 在 `diagnosis.py:2084-2097` 固定 `only_archived=True`，同步动作在 `:2615-2627` 调用真实 repository，并在当前 media generation 仍有效时重载。
+- `repository.py:1945-1965` 精确发送 `GET tcm.diagnosis/getImChatMessages {diagnosis_id, only_archived: 1}` 与 `POST tcm.diagnosis/triggerImChatSync`。
+
+结论：未混入 live merge 默认值，归档读取和同步闭环 CLOSED。
+
+### 10. Shell owner、resize 与 generation
+
+- `diagnosis.py:1325-1413` 每次打开/显示都从当前 `parentWidget().window()` 重绑真实 owner；overlay 采用 owner 的全局原点与完整尺寸，drawer 在宽屏取 owner 60%，窄屏取全宽，并响应 owner Move/Resize/Show/Close。
+- `diagnosis.py:1731-1760` 在 reject/done/owner close 时统一递增 detail、save、orders、order detail、daily、notes、media、offset 及所有 lazy-tab generation，并关闭相关子对话框/播放器。
+
+结论：移动或缩放真实 Shell 后几何会立即同步；关闭后旧请求结果不能回写到下一次打开的诊单。
+
+## 后端合同限制：旧笔记不能任意覆盖或整条删除
+
+本项进行了 admin API、controller、Logic 和 `D:/web/zyt/server` 全仓关键词交叉检索，当前 server 快照的结论明确：
+
+1. `D:/web/zyt/server/app/adminapi/controller/doctor/AppointmentController.php:168-198` 仅公开 `addDoctorNote`、`doctorNotes`、`deleteDoctorNoteImage`，随后该 controller 结束；不存在医生笔记正文 edit/update 或整条 delete action。
+2. `D:/web/zyt/server/app/adminapi/logic/doctor/DoctorNoteLogic.php:14-76` 的 `addOrAppend` 按 `diagnosis_id + 当天` find-or-create，并把新正文追加到当日内容，不允许任意覆盖历史正文。
+3. 同一 Logic 的唯一删除逻辑 `deleteImage`（`:114-136`）只从 `tongue_images` 或 `report_files` 数组中删除一个附件，不删除笔记行。
+4. admin API `D:/web/zyt/admin/src/api/patient.ts:20-40` 也只有上述三条接口，没有被桌面端漏接的隐藏 edit/delete API。
+5. 跟踪备注同样只有 `addTrackingNote` 与 `trackingNotes` controller action（`DiagnosisController.php:183-214`）；`TrackingNoteLogic.php:23-95` 只有按当天追加和按诊单读取，没有历史正文覆盖或整条删除。
+
+因此：
+
+- “任意覆盖既有医生/跟踪笔记正文”与“删除整条笔记”是**后端合同限制**，不是客户端 P0/P1/P2。
+- 当前桌面端不展示无法兑现的按钮是正确的 fail-closed 行为。
+- 若产品必须新增这些能力，应先在 server 增加独立 authenticated endpoint、权限码、归属校验、审计记录、并发/版本策略和删除语义；在此之前不应由客户端通过追加接口模拟覆盖或删除。
+
+## 离线验证
+
+在当前 `.venv` 下使用 `QT_QPA_PLATFORM=offscreen`、`PYTHONDONTWRITEBYTECODE=1`，禁用 pytest cache，并把 basetemp 放到 `artifacts/pytest_release_contract_audit/`；未使用网络：
+
+```text
+python -m pytest -q -p no:cacheprovider --basetemp artifacts/pytest_release_contract_audit tests/test_diagnosis_detail_contract.py tests/test_consultations_parity_ui.py tests/test_diagnosis_drawer_visual.py tests/test_diagnosis_index_visual.py tests/test_shell_contract.py tests/test_repository_parity.py tests/test_permissions.py
+
+118 passed
+```
+
+退出码为 0。该结果覆盖 endpoint/DTO、权限裁剪、多挂号精确取消、订单 QR 串联、三种详情模式、Daily edit、Notes、视频多 URL/逐 call id、IM 和 owner/generation 的定向回归。测试通过是回归信号；最终 AVAILABLE 判定同时依赖上面的 admin/API/server 静态合同核对，不以 mock 测试单独代替生产合同证据。
+
+## 发布门槛判断
+
+- **业务/后端合同门槛：通过。**
+- **OPEN：P0 0 / P1 0 / P2 0。**
+- **AVAILABLE：题定范围内全部对齐。**
+- **唯一保留项：旧医生/跟踪笔记正文覆盖与整条删除需先扩展后端合同；这是明确的 server limitation，不阻断“当前 AVAILABLE 功能”发布。**

app/research/diagnosis_release_visual_audit.md

@@ -0,0 +1,173 @@
+# Diagnosis 发布视觉终验
+
+审计日期：2026-08-11  
+审计性质：独立只读终验；除新增本报告外，未修改业务源码、测试、renderer 或 PNG。  
+基准：`D:/web/zyt/admin/src/views/tcm/diagnosis/` 及其当前主链直接依赖组件。  
+当前实现：PySide6 + scoped QSS + QPainter，主要位于 `src/doctor_workstation/ui/`。  
+Trellis：`D:/web/zyt/app/.trellis` 当前不存在（`Test-Path` 为 `False`），因此无可补读的 Trellis workflow/spec。
+
+## 最终结论
+
+**PARTIAL，不是 PASS。**
+
+- 检查了 `artifacts/diagnosis_visual/` 当前全部 **49 张 PNG**，均以原始尺寸逐张目检；尺寸分布为：`1024x640` 22 张、`1280x800` 11 张、`1440x900` 12 张、`640x540` / `650x620` / `820x560` / `920x780` 各 1 张。
+- PNG 判定：**40 PASS / 9 PARTIAL / 0 不可读 / 0 硬裁切**。
+- **P0：0 OPEN。** 诊单列表、右固定 460 px 区、付款二维码、edit/viewOnly 的 60% Drawer、独立 readonly、预约 Drawer、固定 footer、loading/error/empty/focus/permission 状态及 Shell 183/50/40 均未发现发布阻断。
+- 上一轮明确 OPEN 中，Daily 动作行裁切与按钮语义、完整更多菜单的图标/danger/“二维码”文案已经闭合；视频的多回放、逐条追加与应用内播放器能力也已经存在。
+- 仍不能给 PASS 的原因是 4 组 P1 同型差异：Notes 不渲染真实缩略图；处方编辑器仍是另一种 tabbed modal；订单详情仍是精简 640x540 表单而非共享 80% Drawer；视频仍从表格跳到独立播放器且聊天图片仍降级为文字链接。另有 2 组 P2 文案/局部工具栏差异。
+
+严重度口径：P0 = 核心流程不可见/不可操作或窗口级裁切；P1 = 本次明确要求的主链组件结构、信息层级或媒体形态未与基准同型；P2 = 功能成立但文案、局部按钮或说明层级未精确对齐。
+
+## 此前 OPEN 复核
+
+| 项目 | 当前状态 | 精确证据 |
+|---|---|---|
+| Daily 裁切 | **CLOSED** | `diagnosis_state_daily_1024x640.png` 中“刷新”已换到下一行且完整可见；当前用 `FlowLayout`：`src/doctor_workstation/ui/diagnosis_drawer.py:1607-1609`，基准允许换行：`D:/web/zyt/admin/src/views/tcm/diagnosis/components/DailyMatrix.vue:1094-1109`。 |
+| Daily 按钮语义 | **CLOSED（主问题）** | `+血糖` 为 primary，`+饮食/+运动/+备注` 为 secondary，范围 checked 态可见，`新增待办` 为 primary；实现：`diagnosis_drawer.py:1613-1659,1691-1702`；基准：`DailyMatrix.vue:25-35`、`DiagnosisTodoList.vue:3-19`。仍有下述 P2 文案/局部刷新差异。 |
+| 完整更多菜单 | **CLOSED** | `diagnosis_full_menu_1280x800.png` 显示 8 项、每项图标、删除分隔线与 danger 红、精确“二维码”。QPainter 图标与 danger 绘制：`src/doctor_workstation/ui/diagnosis_index_widgets.py:74-175`；动作与文案：`:1478-1556`；基准：`D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:379-400`。 |
+| Notes 动作与附件 | **PARTIAL** | 新增/追加、舌象/报告上传、打开与单附件删除均已出现；但舌象始终是 64x64 的“舌象/查看”文字按钮（`diagnosis_drawer.py:2153-2183`），没有像基准那样用真实 URL 渲染 `el-image` 缩略图（`D:/web/zyt/admin/src/views/patient/reception/components/NoteTimeline.vue:52-69,370-379`）。 |
+| 处方入口 | **CLOSED** | `diagnosis_state_empty_1024x640.png` 中按钮已经是 primary “开方”；实现：`src/doctor_workstation/ui/dialogs/diagnosis.py:1012-1031`；基准：`CaseRecordList.vue:1-38`。编辑器结构仍有 P1，见下节。 |
+| 订单列表/偏移/详情 | **PARTIAL** | 列表、金额色、状态 tag、分页、详情入口均存在（`diagnosis.py:1056-1099,2980-3010`），并补了详情 PNG；但详情结构仍非基准共享 Drawer，偏移文案也未精确。 |
+| 视频多回放 | **CLOSED（能力）/ PARTIAL（同型）** | `diagnosis_state_video_replay_1024x640.png` 同一记录显示主回放 + 2 个备用回放；实现去重并逐条建链接：`diagnosis.py:2899-2952`。 |
+| 视频逐条上传 | **CLOSED** | `diagnosis_state_video_upload_action_1024x640.png` 显示行级“追加回放”；绑定精确 `call_record_id`：`diagnosis.py:2953-2967`，上传调用：`:2587-2613`。 |
+| 视频播放器 | **CLOSED（能力）/ PARTIAL（同型）** | `diagnosis_state_video_player_820x560.png` 显示应用内播放面、播放/进度/时间/安全外开；实现：`src/doctor_workstation/ui/diagnosis_media.py:38-172`。但基准播放器内嵌在表格单元格且最大高 180 px：`RecordingPlaybackBlock.vue:1-30`、`RecordingVideoPlayer.vue:1-38,320-329`。 |
+| Chat info/归档 | **CLOSED（主体）/ PARTIAL（图片）** | `diagnosis_state_chat_archive_1024x640.png` 已有完整 info、only_archived、同步/重载与左右气泡；实现：`diagnosis_drawer.py:2235-2360`。图片消息仍只创建“查看图片”链接（`:2329-2348`），基准直接渲染图片缩略图（`ImChatRecordPanel.vue:39-50,272-276`）。 |
+| Shell | **CLOSED** | 两张 Shell PNG 均为 183/50/40；当前源码：`src/doctor_workstation/ui/shell.py:540,602,686`；基准：`D:/web/zyt/admin/src/config/setting.ts:5`、`D:/web/zyt/admin/src/styles/var.css:8`、`D:/web/zyt/admin/src/layout/default/components/header/multiple-tabs.vue:65`。 |
+
+## P0 / P1 / P2
+
+### P0
+
+**0 项。** 49 张图未发现核心信息被窗口边界硬裁、60% Drawer 尺寸失效、footer 随正文滚走、中文/图标缺字、二维码不可辨识或 1024/1440 壳层错位。
+
+### P1-1 Notes 舌象不是实际缩略图
+
+- 实图：`diagnosis_state_notes_actions_1024x640.png` 中舌象为蓝色文字卡“舌象 / 查看”，不是图像；报告文件 chip 和两个删除入口可见。
+- 当前源码明确只创建 `QPushButton("舌象\n查看")`，没有加载 URL 到 pixmap：`src/doctor_workstation/ui/diagnosis_drawer.py:2153-2183`。
+- 基准用 `el-image :src="getImageUrl(url)"`、64x64 cover 缩略图与叠加 CircleClose：`D:/web/zyt/admin/src/views/patient/reception/components/NoteTimeline.vue:52-69,366-379`。
+- 建议边界：保留当前安全打开与单附件删除合同，只把可安全下载/解码的图片异步渲染为 64x64 缩略图；失败时再回退为当前文字卡。
+
+### P1-2 处方编辑器不是基准的 1200 px 连续 Drawer
+
+- 实图：`diagnosis_state_prescription_editor_920x780.png` 是 920x780 modal，按“患者与诊断 / 药材配方 / 剂型与用法 / 医师签名”拆为 4 个 tabs。
+- 当前结构：`src/doctor_workstation/ui/dialogs/prescription.py:1017-1037`；诊单入口调用该 dialog：`src/doctor_workstation/ui/dialogs/diagnosis.py:2533-2585`。
+- 基准入口直接打开 `tcm-prescription`，其根是 `size="1200px"` Drawer，并在同一滚动流中依次呈现患者信息、诊断信息、RP 药材工具栏/网格、用法和签名：`D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:416,744`；`D:/web/zyt/admin/src/components/tcm-prescription/index.vue:2-216,217-531`。
+- 当前 DTO/真实提交能力存在，本项是视觉结构 P1，不是功能缺失。
+
+### P1-3 订单详情仍是精简 modal
+
+- 实图：`diagnosis_state_order_detail_640x540.png` 只有 hero、状态 tag 和 10 行键值信息。
+- 当前源码固定 `640x540`，用单个 `QFormLayout` 罗列患者、金额、医护、地址、物流、备注：`src/doctor_workstation/ui/dialogs/diagnosis.py:3060-3135`。
+- 基准 `PatientOrderList` 打开共享 readonly `PrescriptionOrderDetailDrawer`：`D:/web/zyt/admin/src/views/tcm/diagnosis/components/PatientOrderList.vue:96-124`；共享组件宽 `80%`，readonly 仍保留金额概览、处方详情、未关联/关联收款、履约收货、物流轨迹与操作日志：`D:/web/zyt/admin/src/views/consumer/prescription/components/PrescriptionOrderDetailDrawer.vue:13-16,154-197,200-545,551-824`。
+- 因结构和信息密度均明显不同，新增截图只能证明“有详情”，不能证明“同型”。
+
+### P1-4 视频与聊天媒体形态仍非基准同型
+
+- 视频：多地址、逐条追加和 QtMultimedia 播放能力均真实存在，但表格只显示文字链接，点击后打开 820x560 独立播放器（`diagnosis.py:2934-2978`；`diagnosis_media.py:38-116`）。基准在“录制回放”单元格内直接嵌入最大高 180 px 的播放器，并把其他地址放在其下：`CallRecordPanel.vue:17-34`、`RecordingPlaybackBlock.vue:1-30`、`RecordingVideoPlayer.vue:320-329`。
+- 聊天：文字/文件气泡和 info alert 已同型；图片仍为“查看图片”文字链接（`diagnosis_drawer.py:2329-2348`），基准为最大 `240x200` 的可预览图片（`ImChatRecordPanel.vue:39-50,272-276`）。
+- 两者均可安全使用，但尚未达到这轮明确要求的媒体视觉同型。
+
+### P2-1 Daily 待办局部工具栏文案仍未精确
+
+- `diagnosis_state_daily_lower_1024x640.png` 的 primary 按钮为“新增待办”，基准为“+ 新增待办”；当前待办卡内也没有基准同一工具栏上的局部“刷新”（全 Daily 顶部已有刷新）。
+- 当前：`diagnosis_drawer.py:1691-1702`；基准：`DiagnosisTodoList.vue:3-19`。
+- 这不再造成裁切或语义压平，故降为 P2。
+
+### P2-2 订单偏移栏文案与解释层级未精确
+
+- `diagnosis_state_order_offset_1024x640.png` 显示“全局就诊序号偏移 / 0 / 个序号 / 保存偏移”。
+- 基准是“复诊统计起始偏移”+ tooltip +“第 1 笔实单计为…”+“保存”：`PatientOrderList.vue:7-41`。
+- 当前：`src/doctor_workstation/ui/dialogs/diagnosis.py:1056-1083`。数值范围与保存入口成立，本项为文案/说明层级 P2。
+
+## 尺寸与壳层精确证据
+
+| 核对项 | 1024x640 | 1440x900 | 源码/基准 |
+|---|---|---|---|
+| edit/viewOnly Drawer 60% | panel 从 x=410 开始，宽 614；x=409 仍为 overlay | panel 从 x=576 开始，宽 864 | `diagnosis.py:1336-1340`；基准 `edit.vue:3-9` |
+| appointment Drawer 60% | panel 从 x=410 开始，宽 614 | panel 从 x=576 开始，宽 864 | `appointment_drawer.py:1716-1719`；基准 `appointment.vue:2-6` |
+| Shell sidebar | x=0..182 为侧栏，x=183 进入内容；抽样 x182=`#25292D`、x183=`#F6F6F6` | 同一 183 px 边界 | `shell.py:540-543`；基准 `setting.ts:5` |
+| Shell topbar/tabs | x=200 处 y49 为 topbar 底边，y50 进入 tabs；y89 为 tabs 底边，y90 进入内容，即 50 + 40 | 同一分段 | `shell.py:602,686`；基准 `var.css:8`、`multiple-tabs.vue:65` |
+
+## 49 张 PNG 逐张判定
+
+下列 PASS 只证明该张图实际入镜内容；不会拿截图外的滚动内容代替证据。
+
+### 诊单列表与二维码（14）
+
+| PNG | 判定 | 目检结论 |
+|---|---|---|
+| `diagnosis_1024x640.png` | PASS | 窄屏筛选换行、内部横向溢出、右固定区与行语义完整，无硬裁切。 |
+| `diagnosis_1440x900.png` | PASS | 宽屏列密度、挂号复合单元格、斑马/业务色与固定操作区成立。 |
+| `diagnosis_advanced_filters_1280x800.png` | PASS | 高级筛选完整展开，日期范围、控件顺序与重置可见。 |
+| `diagnosis_double_appointment_cancel_1280x800.png` | PASS | 同诊单两条挂号各有取消入口，虚线层级正常。 |
+| `diagnosis_empty_1280x800.png` | PASS | 表头、内部空态、横向滚动与 0 条分页均保留。 |
+| `diagnosis_error_1280x800.png` | PASS | 错误态居中可读，无旧数据穿透。 |
+| `diagnosis_focus_1280x800.png` | PASS | 搜索框 focus ring 清楚且不挤压布局。 |
+| `diagnosis_full_menu_1280x800.png` | PASS | 8 项、8 个图标、删除分隔/danger 与精确“二维码”全部可见。 |
+| `diagnosis_horizontal_scroll_1024x640.png` | PASS | 主表横移时右 460 px 固定区不动，阴影连续。 |
+| `diagnosis_hover_warning_1280x800.png` | PASS | warning 行 hover 渐变、3 px 左条和固定区同步。 |
+| `diagnosis_loading_1280x800.png` | PASS | 表内真实圆弧 spinner，内容淡化，无字符 spinner。 |
+| `diagnosis_pending_assign_1280x800.png` | PASS | 待分配 chip、月份和宽搜索在同一流式区。 |
+| `diagnosis_permissions_cropped_1280x800.png` | PASS | 权限裁掉批量工具栏和敏感动作，仅留查看。 |
+| `diagnosis_order_qrcode_1280x800.png` | PASS | 订单号、可辨识 QR、成功态、只读 URL、打开/重试/关闭均完整。 |
+
+### edit / viewOnly / readonly（6）
+
+| PNG | 判定 | 目检结论 |
+|---|---|---|
+| `diagnosis_edit_1024x640.png` | PASS | 60% Drawer、2/3 列语义表单、横向 tabs、独立滚动体与固定 footer 成立。 |
+| `diagnosis_edit_1440x900.png` | PASS | 864 px Drawer、宽屏字段比例和 footer 稳定。 |
+| `diagnosis_viewonly_1024x640.png` | PASS | 60% 只读 Drawer、待配药警告、disabled 表单与仅关闭 footer 成立。 |
+| `diagnosis_viewonly_1440x900.png` | PASS | 宽屏只读栅格、全 tabs 与固定 footer 成立。 |
+| `diagnosis_readonly_1024x640.png` | PASS | 独立只读页、hero、病例卡和“客服：赵医助”不拆字。 |
+| `diagnosis_readonly_1440x900.png` | PASS | 4 列病例密度、异常指标层级及长页面滚动成立。 |
+
+### 详情状态与子流程（19）
+
+| PNG | 判定 | 目检结论 |
+|---|---|---|
+| `diagnosis_state_loading_1024x640.png` | PASS | 圆弧 spinner 与“正在加载诊单...”完整，无旧 seed 穿透。 |
+| `diagnosis_state_error_1024x640.png` | PASS | danger banner、重试、空表单和禁用保存完整。 |
+| `diagnosis_state_empty_1024x640.png` | PASS | 处方空态与 primary “开方”已对齐；编辑器另见 PARTIAL。 |
+| `diagnosis_state_permission_1024x640.png` | PASS | 仅保留获权 tabs，手机号/身份证掩码，footer 仅关闭。 |
+| `diagnosis_state_daily_1024x640.png` | PASS | Daily 动作全部可见；刷新换行而未裁切，range/primary/secondary 层级清楚。 |
+| `diagnosis_state_daily_lower_1024x640.png` | PARTIAL（P2） | 趋势、待办 filters、状态 pill 与 primary 新增成立；缺“+”及待办局部刷新。 |
+| `diagnosis_state_daily_blood_edit_650x620.png` | PASS | 血糖/血压编辑字段、单位、必填说明、备注和固定动作完整。 |
+| `diagnosis_state_focus_1024x640.png` | PASS | 姓名 focus ring、紧凑 close 和固定 footer 清楚。 |
+| `diagnosis_state_save_loading_1024x640.png` | PASS | 按钮内圆弧 spinner 与“正在保存”完整。 |
+| `diagnosis_state_save_success_1024x640.png` | PASS | 绿色勾与“保存成功”完整。 |
+| `diagnosis_state_save_failure_1024x640.png` | PASS | 红色叉与“保存失败”完整。 |
+| `diagnosis_state_notes_actions_1024x640.png` | PARTIAL（P1） | 动作、chip 和单附件删除存在；舌象仍为文字按钮而非真实缩略图。 |
+| `diagnosis_state_prescription_editor_920x780.png` | PARTIAL（P1） | 完整可用的 4-tab 编辑器已入镜；但不是基准 1200 px 连续 Drawer。 |
+| `diagnosis_state_order_offset_1024x640.png` | PARTIAL（P2） | 数值、保存、订单表与分页成立；偏移文案/tooltip/解释层级未精确。 |
+| `diagnosis_state_order_detail_640x540.png` | PARTIAL（P1） | 详情 modal 可用；缺基准 80% Drawer 的金额/支付/履约/物流/日志结构。 |
+| `diagnosis_state_video_replay_1024x640.png` | PARTIAL（P1） | 主回放 + 2 个备用回放成立；仍是链接列表，不是表内播放器。 |
+| `diagnosis_state_video_upload_action_1024x640.png` | PARTIAL（P1） | 指定行“追加回放”成立；媒体单元格结构仍未同型。 |
+| `diagnosis_state_video_player_820x560.png` | PARTIAL（P1） | 应用内播放器和安全外开成立；形态是独立 dialog，不是 180 px 表内播放器。 |
+| `diagnosis_state_chat_archive_1024x640.png` | PARTIAL（P1） | 完整 info、归档、同步/重载及左右气泡成立；图片消息退化为文字链接。 |
+
+### 预约 Drawer（8）
+
+| PNG | 判定 | 目检结论 |
+|---|---|---|
+| `appointment_drawer_1024x640.png` | PASS | 60% Drawer、body 滚动、时段状态和固定 footer 无硬裁切。 |
+| `appointment_drawer_1440x900.png` | PASS | 医生 radio、四个日期按钮、时段网格、备注和 footer 对齐。 |
+| `appointment_drawer_empty_doctors_1440x900.png` | PASS | warning、空态插图、暂无医生与禁用确认完整。 |
+| `appointment_drawer_empty_roster_1440x900.png` | PASS | 无排班 warning、空态和“该医生暂无排班”可读。 |
+| `appointment_drawer_error_1440x900.png` | PASS | 号源错误 banner、刷新入口和空态并存。 |
+| `appointment_drawer_keyboard_focus_1440x900.png` | PASS | 日期按钮蓝色键盘 focus 边界清楚。 |
+| `appointment_drawer_loading_1440x900.png` | PASS | 初始加载 overlay、圆弧 spinner、文案与禁用确认完整。 |
+| `appointment_drawer_refreshing_1440x900.png` | PASS | 刷新 overlay、圆弧 spinner、文案与禁用确认完整。 |
+
+### Shell（2）
+
+| PNG | 判定 | 目检结论 |
+|---|---|---|
+| `diagnosis_shell_1024x640.png` | PASS | 183/50/40、深色侧栏、tabs、固定列与分页均成立；无 glyph 方框。 |
+| `diagnosis_shell_1440x900.png` | PASS | 同一壳层比例在宽屏保持，箭头/刷新/全屏/关闭图形和中文完整。 |
+
+## 发布判定
+
+- **可以确认无 P0，且此前 Daily、更多菜单、Shell 的明确 OPEN 已关闭。**
+- **不能给视觉同型 PASS。** 需至少关闭 P1-1 至 P1-4，并补录对应终态 PNG；P2 可在同一轮顺手精确。
+- 本轮最终：**PARTIAL（40 PASS / 9 PARTIAL，共检查 49 张 PNG）**。