dsh-gov-portal

Readme

# dsh-gov-portal · Deepseek Harness 综合智能办事平台

一个以**中国地方政务网站视觉规范**为设计基准的独立 WebUI 插件：在独立端口（默认 **3081**）提供政务风办事大厅界面，通过宿主进程内的 **apiProxy 网关** 1:1 对接 DeepSeek Harness 的会话、模型、模式、权限、统计等**全部真实 Agent 能力**（零业务硬编码）。

界面采用可复用的政务服务门户设计语言，完整设计规范见 [`docs/design-system.md`](docs/design-system.md)；宿主集成面调研见 [`docs/harness-integration.md`](docs/harness-integration.md)。

---

## 功能总览

### 页面架构（严格政务风）
- **顶部工具条**（政务网站深蓝底白字 + WindowsXP 原版像素点阵字体：宋体 12px 点阵关闭抗锯齿）：`[设为首页] [加入收藏] [无障碍浏览]` + 居中红色标语（可配置）+ 右侧实时日期时间（精确到秒）+ **访问次数统计「本站已被访问：xxxxxx 次」**（服务端持久化计数，6 位补零，`/plugin/visits` 端点，存于 `~/.dsh/gov-portal.json`）。
- **主 Header**：红色公章徽标（预设红/蓝/绿/金印章或上传图片）+ 平台名/副标题 + 政务搜索框（蓝色 `[查询]`）+ 绿色状态圆点 `系统状态: 正常运行`。
- **主导航**：经典深蓝渐变（`#1874cd → #0d47a1`）白字黑体，`平台首页 / 业务大厅 / 电子卷宗 / 督办流水 / 参数配置 / 政策法规`，Hover 高亮。
- **双通道跑马灯**：左侧【重要通知】与右侧【行情指数】反向滚动，速度/方向/内容/真实轮询 API 均可配。
- **80/20 主布局**：左侧直办大厅（工单编号条 → 交互回执窗口 → 统计行 → 公文输入表单），右侧支撑侧栏（常用办事通道 / 便民服务提示）。
- **动态飘窗 ×2**（DVD 屏保匀速碰撞反弹，悬停暂停、`[×]` 销毁）：红头重要通知弹窗 + 官方矩阵二维码弹窗。
- **办结盖章**：流式输出完成时右上角盖半透明 `【准予办结】` 红色印章动画（可关闭）。

### 与 DeepSeek Harness 的真实对接（1:1，不硬编码）
| 界面元素 | 宿主能力 | 说明 |
| --- | --- | --- |
| 模型下拉 + 推理强度 | `session.models` / `session.selectModel` | 按 provider 分组动态枚举，推理强度随模型动态刷新 |
| 模式下拉（标准/创造/PTC/极简/自定义 preset） | `agentPreset.list` / `agentPreset.select` | 全量动态枚举，创建工单时随 `session.create` 传入 |
| 权限下拉（read-only / workspace-write / danger-full-access） | `settings.describe` + `settings.update('permission', {defaultPreset})` | 从 settings schema 动态枚举；所选权限在新建工单时写入宿主「新会话默认」，由宿主初始化（零 Token 消耗，不向会话发送权限消息） |
| 回执流（文本/思考/工具/轨迹/todo） | `events.mux` → `session/event` 帧 | 与主 GUI 同一事件源 |
| 统计行（轮/步/LLM时长/工具时长/首token/速度/缓存命中/输入输出/TPS） | `sessionStats` 投影 + `assistant/message` usage 聚合 | 全实时计算 |
| 沙箱审批弹窗（准予执行/不予批准） | `approval/requested` 帧 + `POST /api/respond` | 与权限预设联动 |
| 系统咨询弹窗（问题答复） | `question/requested` 帧 + `respond` | 多选支持 |
| 电子卷宗（会话索引/查阅/导出 JSONL） | `session.list` / `session.history` / `session.search` / `GET /api/session.export` | — |
| 督办流水（轨迹事件表） | `session/event` 实时追加 | chunk 级可过滤 |
| DSH 原生系统设置（模型/凭据/沙箱等全部命名空间） | `settings.describe`（schemastery schema 驱动表单）/ `settings.update` | 可调整原版 Harness 的全部配置 |

### 参数配置面板（全维度热修改 + 持久化）
漂浮弹窗与公告控制、跑马灯与滚动条、界面视觉与个性化（4 套预设主题 + 自定义全站主色/渐变/边框色 + 单位落款与文案 + 徽标上传）、Agent 运行与通信（端口/WS/工单前缀/默认模型/温度/上下文轮数/权限确认等级/盖章开关）、DSH 原生系统参数、存储与重置（保存 / 导出 JSON 卷宗 / 导入 / 恢复出厂）。前端配置存 `localStorage`（键 `dsh.govPortal.v1`），插件端口等存 `~/.dsh/gov-portal.json`。

---

## 目录结构

```
Dsh_GovUI/
├── package.json          # 插件包（dsh.bundle.patch → cordis.patch.yml）
├── cordis.patch.yml      # 向 profile 插入插件行（inject: [apiProxy]）
├── lib/
│   └── index.js          # Cordis 插件：3081 服务 + 静态资源 + /api 桥 + /plugin 端点
├── public/               # 前端（无构建，零依赖）
│   ├── index.html
│   ├── css/gov.css       # 政务风设计系统（CSS 变量 + 四套主题）
│   └── js/{util,api,store,marquee,float,panels,app}.js
├── docs/
│   ├── design-system.md  # 政务服务门户设计规范
│   └── harness-integration.md  # DSH 集成面调研（473 行）
├── test/
│   ├── server-smoke.mjs  # 插件冒烟测试（mock ctx）
│   ├── e2e-check.mjs     # 浏览器运行时检查（Edge headless + CDP，17 项）
│   ├── e2e-chat.mjs      # 真实 Agent 对话端到端测试
│   └── screenshot.mjs    # 各面板截图
└── shots/                # 效果截图
```

---

## 安装与启用

```bash
# 1. 安装到 web profile（pnpm link + 自动 reconcile 进 dsh.profile.bundles）
cd <本目录>
dsh plugin --profile web add link:<本目录绝对路径>

# （如遇 pnpm 写入 package.json 的 EPERM，可手动补：
#   dependencies: "dsh-gov-portal": "link:../../../Desktop/test/Dsh_GovUI"（按实际相对路径）
#   dsh.profile.bundles 末尾追加 "dsh-gov-portal"）

# 2. 重启 dsh web（插件在 dsh 进程内，需重启生效）
dsh web

# 3. 访问
#    http://127.0.0.1:3081/         政务办事大厅（本插件）
#    http://127.0.0.1:3080/         DeepSeek Harness 主控台
```

---

## 验证

```bash
node test/server-smoke.mjs      # 静态资源 + API 桥分发 + SSE + respond + 导出（mock ctx）
node test/e2e-check.mjs         # 浏览器运行时 17 项检查（需 3081 在线）
node test/e2e-chat.mjs          # 真实对话：创建会话→提交→事件链→统计（消耗少量 API 额度）
node test/screenshot.mjs        # 各面板截图（输出 shots/*.png）
```

已验证记录：
- 模式下拉动态枚举出 `standard 标准模式 / code PTC 模式 / minimal 极简模式 / cordis 创造模式 / liangshen 梁神模式`；
- 权限下拉动态枚举出 `read-only / workspace-write / danger-full-access` 三档；
- `settings.describe` 动态渲染 11 个宿主命名空间表单；
- 真实对话事件链 `turn/start → user/message → assistant/chunk → assistant/message → turn/end(completed)` 与 `sessionStats` 投影（turns/steps/llmMs/toolMs/ttftMs/decodeMs/decodeTokens）全部通过。

## 注意事项
- 修改端口后需重启 dsh（监听参数在插件启动时读取）。
- 事件通道默认使用本插件与宿主同进程的 SSE 桥（最稳）；配置面板保留 WebSocket 地址/重试间隔项。
- 插件仅在宿主进程（dsh web）内运行；3081 页面不能脱离 dsh 单独使用。
- 测试会话会真实写入 `~/.dsh/sessions`，可在电子卷宗中查阅或删除。