READMESource: main@071bce5f
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，不硬编码）
| 界面元素 | 宿主能力 | 说明 |
|---|---|---|
| 模型下拉 + 推理强度 | 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/ # 效果截图
安装与启用
# 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，可在电子卷宗中查阅或删除。
No comments yet. Be the first to write one.