dsh-gov-workbench

5. 配置

5.1 服务端配置：$DSH_HOME/gov-workbench.json

路径由 configPath() 决定：DSH_HOME 存在时用它，否则回落到 ~/.dsh。写入是原子的（先写临时文件再 rename）。合并优先级（递增）：内置默认值 → 配置文件 → cordis.patch.yml 该行的 config。

字段	默认值	含义
port	3091	插件监听端口。刻意避开 3080（dsh 主 GUI）与 3081。取值必须落在 1–65535，非法值静默回落默认值。改动需重启 dsh。
host	'127.0.0.1'	监听地址。只接受非空字符串。改成 0.0.0.0 会把工作台暴露到局域网，请自行评估。改动需重启 dsh。
token	''（启动时自动生成）	配对令牌，32 字节 base64url。首次启动自动生成并写回配置文件；已有值不会被覆盖。
requireToken	true	是否强制校验配对令牌。默认开启，可在配置文件里置 false 关闭。
allowNoOrigin	true	是否放行无 Origin 头的请求（同源导航、curl、本地脚本）。置 false 则无 Origin 一律拒绝。
requireJsonContentType	true	是否要求写请求的 Content-Type 必须是 application/json。用于堵掉 text/plain 简单请求绕过预检的路径。
visits	0	访问次数统计，随 workbench.visits / /plugin/visits 递增并落盘。
marquee	三条内置通知	首页「重要通知」跑马灯内容，字符串数组。空数组会回落默认值。
sealOnComplete	true	是否在办结时显示「准予办结」盖章动画。
floatEnabled	true	便民提示浮窗（飘窗）开关。

5.2 前端偏好：localStorage

键名固定为 dsh.govWorkbench.v1，只放界面偏好，不放服务端配置。包含：page（当前栏目）、sessionId（当前事项）、workspace / permission / preset / provider / model / reasoningEffort（参数行选择）、autoScrollTrace / traceChunkFilter（轨迹视图）、sealOnComplete / floatEnabled（界面开关）、largeFont / highContrast（无障碍）、marquee。读写失败一律静默回落默认值。

5.3 插件自有端点

端点	方法	说明
/plugin/status	GET	运行信息，不回显令牌
/plugin/config	GET / PUT	读写配置。PUT 只改传入字段；端口 / host 变动时回 needsRestart: true
/plugin/token	GET	回显令牌（能走到这里的请求已通过令牌校验）
/plugin/visits	GET / PUT	读取（自增）/ 清零访问计数
/plugin/marquee	GET / PUT	读写跑马灯内容

5.1 服务端配置：$DSH_HOME/gov-workbench.json

路径由 configPath() 决定：DSH_HOME 存在时用它，否则回落到 ~/.dsh。写入是原子的（先写临时文件再 rename）。合并优先级（递增）：内置默认值 → 配置文件 → cordis.patch.yml 该行的 config。

字段	默认值	含义
port	3091	插件监听端口。刻意避开 3080（dsh 主 GUI）与 3081。取值必须落在 1–65535，非法值静默回落默认值。改动需重启 dsh。
host	'127.0.0.1'	监听地址。只接受非空字符串。改成 0.0.0.0 会把工作台暴露到局域网，请自行评估。改动需重启 dsh。
token	''（启动时自动生成）	配对令牌，32 字节 base64url。首次启动自动生成并写回配置文件；已有值不会被覆盖。
requireToken	true	是否强制校验配对令牌。默认开启，可在配置文件里置 false 关闭。
allowNoOrigin	true	是否放行无 Origin 头的请求（同源导航、curl、本地脚本）。置 false 则无 Origin 一律拒绝。
requireJsonContentType	true	是否要求写请求的 Content-Type 必须是 application/json。用于堵掉 text/plain 简单请求绕过预检的路径。
visits	0	访问次数统计，随 workbench.visits / /plugin/visits 递增并落盘。
marquee	三条内置通知	首页「重要通知」跑马灯内容，字符串数组。空数组会回落默认值。
sealOnComplete	true	是否在办结时显示「准予办结」盖章动画。
floatEnabled	true	便民提示浮窗（飘窗）开关。