dsh-go 界面配置（ui.json）

dsh-go App 会读 $DSH_HOME/dsh-go/ui.json（DSH_HOME 默认 ~/.dsh），按里面的声明改自己的原生界面。改完保存，已接线的键一两秒内自动生效，不用重启。

**当前只有部分键真正接线，见下面的「生效状态」表。**没接线的键 App 仍会解析和校验，但界面不会变——不要向用户保证写了就生效。

文件只能声明，不能执行：没有脚本、没有网络请求、不能装东西。按钮能做的事只有四种动作（见下），而且都要用户亲手点才会发生。

和官方技能的分工

• 本技能：改 dsh-go 手机 App 的原生界面（ui.json）。
• dsh-go-plugin：给手机 App 加胶囊、菜单、状态条、原生面板、工具卡；要逻辑或数据时用它，不用 ui.json。
• 官方 cordis-plugin-development 等：Harness Web UI / 桌面端的插件、装饰、槽位、页面和 MCP；目录在工作区，安装走 plugin_manager → install_bundle。
• 用户没点名界面载体时，手机上默认是 dsh-go 原生界面；先确定载体再选技能，不看加载顺序。两套配置（ui.json / Cordis bundle）不要混写，也不要拿官方网页插件的做法套到 App 上。

怎么改

1. 先读现有文件：cat "$DSH_HOME/dsh-go/ui.json"（没有就新建，目录不存在就 mkdir -p）。
2. 只改用户要求的部分，其他键原样保留。用户之前的配置不要删。
3. 写回：严格 JSON，UTF-8，不要注释，不要尾逗号，不超过 64 KiB。最好先写临时文件再 mv 过去。
4. 自查：node "$DSH_HOME/skills/dsh-go-ui/scripts/check.mjs"。输出是 App 解析器的判断，不是界面生效数；只有「生效状态」表里已接线的键会改变界面：
   • 错误 /composer/quickActions/2/action/url：只支持 https 链接：这一项不生效，其余照常；
   • 忽略：App 不认识或超出上限的部分；
   • 提示：已自动修正（比如文字太长被截断），仍然生效；
   • ui.json 没有生效：…：整份没读进去（语法错误、版本不对），App 继续用上一次有效的配置。 有错就改到没有 错误 为止。加 --json 得到机器可读结果。checker 报的「已应用 N 项」只是解析器接收的声明的数量，不要转述成「已生效」。
5. 本机（手机上的引擎）还会有 $DSH_HOME/dsh-go/ui.status.json，是 App 实际读到的结果，可以对照。
6. 告诉用户改了什么。用户想撤销某一项，就把那个键删掉；已接线的项（theme.mode、plugins.seats）还能在 App 设置里点「来自 ui.json」→「恢复默认」，这只让 App 忽略那一项，不会改文件。

完整字段定义在同目录的 schema.json，示例在 examples/。

生效状态

未接线的键先如实告诉用户「这项目前还没有应用到界面」，不要编造已生效。

字段

{
  "version": 1,
  "header": { "actions": ["schedule", "detail", "newChat",
    { "id": "daily", "icon": "bolt", "label": "日报", "action": { "type": "send", "text": "按模板写今天的日报" } }] },
  "composer": { "quickActions": [
    { "label": "总结", "action": { "type": "send", "text": "总结上面的对话，列三条要点" } },
    { "label": "压缩", "action": { "type": "command", "name": "compact" } } ] },
  "emptyState": { "suggestions": [
    { "title": "看看今天的待办", "subtitle": "读工作区里的 TODO.md", "action": { "type": "send", "text": "读一下 TODO.md，告诉我今天先做什么" } } ] },
  "drawer": { "groups": ["pinned", "folders", "today", "yesterday", "thisWeek", "earlier"], "sort": "activity", "filter": "all" },
  "density": "compact",
  "hide": ["turnFooter", "tokenCount"],
  "theme": { "mode": "system", "accentPreset": "daiqing" },
  "shortcuts": [ { "keys": "ctrl+k", "action": { "type": "open", "page": "search" } } ],
  "plugins": { "seats": { "conversation.input.dock": { "dsh-cost-meter": "hidden" } } }
}

图标（icon）：bolt star sparkle heart flag bookmark pin bell clock alarm calendar todo note document folder search code terminal globe chart lightbulb book puzzle robot chat mail translate image camera mic link summary wrench bug travel school home play refresh archive team wallet palette

要隐藏聊天页的「插件」入口，把 pluginCapsule 加进现有 hide 数组，例如 {"version":1,"hide":["pluginCapsule"]}。它只隐藏 App 的聚合入口，不停用插件、不隐藏插件自己的快捷胶囊，也不改变「全部功能」或「对话详情」的入口。删除该项或在界面配置页恢复默认即可显示。plugins.seats 配置的是插件的槽位，不是这个 App 入口；不要用 chat.panel / dsh-go.panel 座位设置替代。

动作（action）

注意

• 每台主机各有一份 ui.json，App 连哪台主机就用哪台的。
• 一项写错只影响那一项；整份语法错误时 App 保留上一次有效的配置。
• 不要在文件里放密钥、令牌等敏感信息。
• 不要编造字段或取值；不在上表里的东西 App 不认识。