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

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

界面采用可复用的政务服务门户设计语言，完整设计规范见 docs/design-system.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，不硬编码）

参数配置面板（全维度热修改 + 持久化）

漂浮弹窗与公告控制、跑马灯与滚动条、界面视觉与个性化（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/                # 效果截图

安装与启用

# 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 主控台

验证

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，可在电子卷宗中查阅或删除。