jhfnetboy/dsh-devloop-ui

dsh-devloop-ui

为 DevLoop 仪表盘提供的原生 DSH Desktop 界面：一个侧边栏
入口，以及一个设置概览。

本包之所以存在，是因为 DevLoop 的仪表盘是 Harness 源上的一个路由
（/devloop/），而不是一个 Harness UI 插件，而仅宿主的插件无法出现在
应用的界面外壳中。DevLoop 本身没有任何变化：这是它的配套 UI 部分，单独
保留，以便无需发布 DevLoop 即可安装、移除或重写它。

HANDOFF.md 记录了两半式包契约、客户端 bundle 格式、插槽规则、DevLoop 的
HTTP API，以及那些容易出错的约束。下面两个插槽都遵循它。

下面两个插槽都不是主内容区域：一个侧边栏按钮和一个设置区块是启动器和
侧面板。对于应用中的一个页面——Chat 和 Trajectory 旁边填满视图区域的
一个标签页——请注册到 conversation.view；参见 HANDOFF.md 的 §3。

它的作用

注册两个占用者：

- sidebar.footer.action —— 侧边栏页脚中的一个图标按钮（侧边栏展开时
显示图标加标签，折叠成窄栏时仅显示图标）。点击它会在新窗口中打开
/devloop/。
- settings.section —— 设置中的一个精简概览：每个已注册项目的名称、
状态（需要你 / 运行中 / 空闲 / 完成，对应仪表盘自身的 lane 分类），
以及今日总支出。它只读取 GET /devloop/api/projects（同源 fetch，
面板打开时每 5 秒轮询一次）——启动项目、回答问题以及其他所有操作都
留在仪表盘中，一键即可通过“打开完整仪表盘 →”或点击项目行（会直接
打开该项目）到达。

两者都以窗口方式打开仪表盘，而不是将其嵌入，因为仪表盘会以
x-frame-options: DENY 和 frame-ancestors 'none' 作为响应。该窗口是
应用窗口，而不是系统浏览器：DSH Desktop 的 isTrustedAppUrl 将每个
127.0.0.1 / localhost URL 都视为可信，并允许其在应用内打开。

布局

| 文件 | 作用 |
| --- | --- |
| index.js | 宿主部分。不注册任何内容——它的存在是为了让该包成为一个 Loader 条目，而这正是让 dsh-client-modules 组合并提供浏览器部分的原因。 |
| client.js | 浏览器部分。纯浏览器 JavaScript，由客户端模块加载器逐字求值：没有 TypeScript，没有 JSX，没有打包器。 |
| cordis.patch.yml | 插入单个 Loader 条目的 bundle 补丁。 |

package.json 承载声明的两半：dsh.bundle.patch（Loader 条目）和
dsh.client（浏览器部分加上 platform: "web"）。

安装

安装到 DSH 配置文件中，从该配置文件自身的 Harness 执行：

DSH_HOME="$HOME/Library/Application Support/dsh-desktop/harness" \
PATH="$HOME/Library/Application Support/dsh-desktop/harness/.desktop-bin:$PATH" \
node "/Applications/DSH Desktop.app/Contents/Resources/app/node_modules/@deepseek-ai/dsh/lib/bin.js" \
plugin --profile web add link:/Users/jason/Dev/jhfnetboy/dsh-devloop-ui
之后重启 DSH Desktop —— 新的 bundle 在 Harness 启动时才会组合，因此不会实时生效。

移除它：

同样的 DSH_HOME / PATH 前缀
plugin --profile web remove dsh-devloop-ui

不重启 Desktop 进行验证

node check-client.mjs

针对加载器和插槽契约对 client.js 进行桩求值，覆盖两个占用者：加载器 id、导出的 face、每个注入的插槽、每个列表插槽的 id、侧边栏按钮的 onClick 目标，以及设置区的“Open full dashboard”操作（打开 /devloop/ 并调用 close()）。