dsh-project-panel · 工程面板

DeepSeek Harness Web 端的低代码工程面板：把 MagicalCoder 风格的工程目录搬进会话侧栏 —— 文件树、推送状态、源码编辑、推送前校验、工程脚本，一处看全。

MagicalCoder 风格的工程是一套约定目录：页面由 page.json + index.html + page.js 三件套组成，接口是 meta.json，工程脚本叫 source-*.js，页面里必须有 magicalDragScene 容器，调平台接口要走 /magical_lowcode/ 前缀……这些约定在普通编辑器里全靠记性和手工核对。

这个插件把它们变成看得见、点得动的东西。

看得见的工程树 —— 一层目录一层文件，就地读写、改名、移动、删除
推送状态账本 —— 哪些页面 / 接口已经同步到平台，哪些改过还没同步
推送前静态校验 —— 把踩过的坑变成规则，推之前先跑一遍
源码页签 —— 树里点一下就开，带高亮和多标签，改完直接写回
工程脚本入口 —— 工作区根目录下那批 source-*.js，在面板里点着跑
空白目录也能开局 —— 服务器地址 / 账号 / 项目由面板维护，不依赖工作区里事先有 .env

一、安装

从插件市场装（推荐）：

在 DSH 插件市场里搜「工程面板」或 dsh-project-panel

命令行装：

dsh plugin --profile web add github:lzqzm/dsh-project-panel

本地开发（link: 安装，装的是你正在改的那份源码）：

dsh plugin --profile web add D:\path\to\dsh-project-panel

装完重启 dsh web。

改了代码怎么生效

改了哪	要做什么
`lib/client.js`	刷新页面
`lib/index.js`（host 半边）	重启 `dsh web`
`src/editor.js`	`npm run build:editor`，再刷新页面

二、入口在哪

先打开一个工作区的会话然后点击左侧栏底部的 「工程」 按钮，或者右侧栏的工程页签。打开后占用中栏，会话与输入框保持原样。

面板顶部是搜索框，下面四个页签：

页签	干什么
文件树	工程目录的总览 + 推送状态
源码	打开的文件，多标签，可编辑
校验	推送前静态校验的结果清单
脚本	连接配置 + 工程脚本的运行面板

三、文件树

徽章怎么读

目录和文件右侧的小标：

徽章	意思
`✔ 已推送`	内容和平台上的一致
`● 待推送`	本地改过，还没同步到平台
`✗ 定位不到`	这个目录既没有 `page.json` 的 `uuid`、也没有 `meta.json` 的 `id`，入不了账
`校验 ✗3`	这一片有 3 个错误（警告不占徽章，去「校验」页签看）

推送状态是账本：登记每个页面 / 接口在你上次推送时各文件的 mtime，之后 mtime 变了就算「改过」。所以：

徽章回答的是「本地有没有平台上还没有的改动」；
从服务器拉取之后，插件会把这一片的账删掉再重扫 —— 内容刚和服务器对齐，不该显示成待推送。

右键菜单

在树里任意一行点右键：

菜单项	作用
新建文件 / 新建文件夹	在当前位置新建（新建页面类目录会自动带模板）
引用	把该文件的 `@` 引用插进输入框
推送前校验	对这一片跑静态校验，结果落到「校验」页签
重命名 / 移动到… / 删除	常规文件操作（会同步改 `page.json` / `meta.json`）
推送这个页面 / 拉取这个页面	只跑这一个单元
标记已推送	手工记账，不改文件
刷新推送状态	只重扫，不重算账
重置推送状态	把整个工作区的账本清掉，下次扫描全部重新登记

推一个目录 = 连里面的子页面一起推。 平台的 source-page-push.js 拿到目录 uuid 时走的是「推该目录及目录下的所有页面」。所以推完目录，插件会把整棵子树的账一起更新 —— 不会出现「父目录绿了、子页面还挂着待推送」。

键盘

树里有键盘导航：上下移动、左右展开收起、回车打开。首屏如果一直「读取中」，点一下「刷新」。

四、源码

树里右键文件名选择查看源码，或者点行尾的源码按钮，就在「源码」页签里打开（多标签常驻）。用 CodeMirror 6，按扩展名选语言高亮。改完 Ctrl+S（或点写回）保存，写回后自动重扫这一片的校验与推送状态。

五、校验

「校验」页签列出推送前静态校验的结果，按文件分组，点一条直接跳到源码页签的对应行。

规则是踩过的坑固化的（V1.01 ~ V1.06 那一批）：js-syntax、css-brace、attr-mustache、sys-zone-modified、uuid-missing、no-scene、bare-mustache、api-url、no-merge-loop、no-return。

分级：

error —— 会占树上的徽章（✗N），因为平台真的会因此出问题；
warn —— 只在页签里列，不占徽章。比如 no-return（接口脚本里 return '成功' 平台其实能吃），一个真实工程里能有一千多条，标出来只会让人学会忽略徽章。

六、脚本

工作区根目录下那一层的 source-*.js 会被列成卡片，点「运行」就跑（用 DSH 自己的 node，不依赖系统 PATH）。

内置认识的七个：

脚本	说明
`source-push.js`	推送整个项目
`source-clone.js`	克隆整个项目
`source-api-pull.js` / `source-api-push.js`	拉取 / 推送全部接口
`source-page-pull.js` / `source-page-push.js`	拉取 / 推送全部页面
`source-db-pull.js`	拉取数据库

不认识的 source-*.js 也会列出来（标「未登记」），一样能跑。

外网地址一律二次确认

.env 里的 SERVER_URL 只要不是本机，推送和拉取都要先确认一次：

拉取看着「只是把东西取回来」，实际是拿服务器上的状态覆盖本地文件；source-clone.js 还会一路建目录。破坏性和推送一个级别。

判据是真实主机名，不是某个「环境名」。面板里没有本地 / 线上的环境之分 —— 一条 ENV=local 配一个外网地址，脚本照样往外面推，按环境名判断只会更危险。

跑起来之后下面是输出控制台，可以随时「停止」（Windows 上连子孙进程一起杀）。推送动辄几分钟，所以是「起进程 + 增量取输出」，不是干等。

连接配置（页签顶部那一块）

服务器地址 / 账号 / 密码由面板维护，不要求工作区里事先有 .env：

按钮	作用
新建档案	存一个「服务器」（名称 / 地址 / 账号 / 密码）
铺脚手架	把插件自带的 `source-*.js` / `utils.js` / `package.json` 和三份说明（`AGENTS.md` / `project-rules.md` / `help.md`）铺到当前目录
写入 .env	把选中的档案合并写进工作区的 `.env`
装依赖	装模板要用的 npm 包（只在缺的时候出现）

下面那行写着当前 .env 的现状（地址 / 账号 / 密码 / 项目）。.env 里的地址和选中档案对不上时，「写入 .env」会变红提醒。

项目清单也能手动维护：选好服务器后点「＋项目」录一条（uuid + 名字），选中的那条可以「改名」「删除」。清单挂在服务器档案上，不挂文件树 —— 同一个服务器下的项目是同一批。另外 .env 注释里那批项目 uuid 会被自动捡出来当候选，两边在界面上合并显示。

全局开发规范（给 AI 看的）

除了往工作区里铺那三份说明，插件还能把一份全局版装到 <DSH_HOME>/AGENTS.md：

按钮	作用
安装	把插件自带的低代码平台规范装成全局指令。文件已存在就一个字节都不动，只说一句「已经存在，没有覆盖它」
移除	只删内容与插件模板逐字节相同的那一份；用户改过、或本来就是用户自己的内容，就不动

为什么需要它：低代码工程的工作区往往没有 .git，dsh-agent-instructions 一路向上找不到项目根，会把「会话工作目录」当成项目根 —— 项目根于是落在某个 <projectUuid>/ 子目录上，铺在工作区根的那份 AGENTS.md 反而读不到。装在 DSH_HOME 下的这份是每个会话的注入基线，与工作目录在哪无关。

文件树页签顶上，没装的时候会挂一条提示条，点「安装」即可。

七、空白目录从零开局

新建一个空文件夹、注册成工作区，然后：

新建档案 —— 填服务器地址 / 账号 / 密码
铺脚手架 —— 把模板脚本铺进来（已存在的文件不会被改动）
写入 .env —— 落盘；原来没有 .env 就新建一个
装依赖 —— 装 axios / archiver / form-data / unzipper

之后脚本卡片就长出来了，选个项目点「克隆整个项目」即可。

依赖只装一次，装在插件自己目录里，跑脚本时用 NODE_PATH 复用 —— 不必给每个新目录各来一次 npm install。目标目录自带 node_modules 时优先用它。

八、数据存在哪

路径	内容
`<DSH_HOME>/project-config.json`	服务器档案（含密码明文）、每个工作区绑定的服务器与项目
`<DSH_HOME>/project-push-state.json`	推送状态账本
`<DSH_HOME>/project-env-backups/`	写 `.env` 前的备份，只留最近 10 份
`<DSH_HOME>/AGENTS.md`	全局开发规范（点「安装」才会创建；已存在则不动）

DSH_HOME 默认是 ~/.dsh，可用环境变量覆盖。

写 .env 有两条规矩：注释行一行不动（平台爱把备选项目、备选地址注释着堆在同一份文件里，那是用户唯一的人肉清单），内容没变化就一个字节都不碰（否则跑一次脚本留一份一模一样的备份，10 份上限很快被垃圾挤满）。

面板的能力边界：所有带路径参数的 RPC 都要求路径落在已注册的工作区内，否则拒掉；跑脚本时只认工作区根目录下那一层的 source-[a-z0-9-]+\.js。全局规范那两个 RPC 是例外 —— 它读写的是 <DSH_HOME>/AGENTS.md，跟工作区无关，也没有路径参数可传。

九、更新插件

从市场装的（github: 源）：市场会比对「已安装的 commit」和「仓库 HEAD」，有新的就出现更新按钮，点一下重跑安装，不用卸载重装。

本地 link: 装的：市场不会给更新入口（设计如此：link: 是开发工作区，永远不参与在线更新）。但你也不需要 —— 装的就是你正在改的那份源码，改完刷新页面（client）或重启 dsh web（host）即可。

所以：想用「市场一键更新」，就用仓库地址装；想改代码即时生效，就用本地路径装。

十、常见问题

树上一片全变「待推送」了 账本记的是本地文件 mtime。删掉目录再从服务器拉回来，文件全是新写的、mtime 全新，旧记录自然条条对不上。现在拉取类脚本跑完会自动把对应分区的账清掉重扫；如果之前留下的脏状态还在，右键「重置推送状态」再刷新一次。

推了父目录，子页面还显示待推送 已经修了：推一个目录会把整棵子树的账一起更新。如果徽章还是旧的，右键「刷新推送状态」。

首屏一直「读取中」 点「刷新」。扫描有 mtime 快照缓存，第二次进同一目录会快很多。

目录上是 ✗ 定位不到 这个目录里既没有 page.json（要 uuid）也没有 meta.json（要 id），账本认不出它是谁。多半是新建了目录还没建页面。

.env 里的 ENV 是什么 只决定脚本打印什么文案，不决定请求打到哪里。面板里没有这一项，恒写 local；真正连哪个地址看 SERVER_URL。

十一、开发

dsh-project-panel/
  package.json          依赖只有给脚手架用的那 4 个（axios / archiver / form-data / unzipper）
  cordis.patch.yml      insert: dsh-project-panel
  lib/index.js          host 半边：desktopProject/* RPC（30 个）
  lib/client.js         client 半边：手写 ESM，改了刷新即生效
  lib/client.editor.js  ⚠ 构建产物（CodeMirror 6）—— 不要手改
  src/editor.js         编辑器分片的源码，npm run build:editor 生成上面那个
  scaffold/             自带的工程脚本模板 + 规范说明（source-*.js / utils.js / package.json / AGENTS.md / AGENTS.global.md / project-rules.md / help.md）
  NOTES.md              开发笔记：每个设计决定和踩过的坑

npm run build:editor     # 重新打包编辑器分片
npm run watch:editor     # 边改边打

link: 安装不装传递依赖，所以两个半边都不许 import 第三方包，也不许 import @deepseek-ai/*（Node 从插件真实路径向上解析，够不到 profile/node_modules）。顶层 import 失败会打挂整个 profile。

设计取舍、性能数字、验证手法都记在 NOTES.md。

License

MIT

dsh-project-panel · 工程面板

DeepSeek Harness Web 端的低代码工程面板：把 MagicalCoder 风格的工程目录搬进会话侧栏 —— 文件树、推送状态、源码编辑、推送前校验、工程脚本，一处看全。

这个插件把它们变成看得见、点得动的东西。

看得见的工程树 —— 一层目录一层文件，就地读写、改名、移动、删除
推送状态账本 —— 哪些页面 / 接口已经同步到平台，哪些改过还没同步
推送前静态校验 —— 把踩过的坑变成规则，推之前先跑一遍
源码页签 —— 树里点一下就开，带高亮和多标签，改完直接写回
工程脚本入口 —— 工作区根目录下那批 source-*.js，在面板里点着跑
空白目录也能开局 —— 服务器地址 / 账号 / 项目由面板维护，不依赖工作区里事先有 .env

一、安装

从插件市场装（推荐）：

在 DSH 插件市场里搜「工程面板」或 dsh-project-panel

命令行装：

dsh plugin --profile web add github:lzqzm/dsh-project-panel

本地开发（link: 安装，装的是你正在改的那份源码）：

dsh plugin --profile web add D:\path\to\dsh-project-panel

装完重启 dsh web。

改了代码怎么生效

改了哪	要做什么
`lib/client.js`	刷新页面
`lib/index.js`（host 半边）	重启 `dsh web`
`src/editor.js`	`npm run build:editor`，再刷新页面

二、入口在哪

先打开一个工作区的会话然后点击左侧栏底部的 「工程」 按钮，或者右侧栏的工程页签。打开后占用中栏，会话与输入框保持原样。

面板顶部是搜索框，下面四个页签：

页签	干什么
文件树	工程目录的总览 + 推送状态
源码	打开的文件，多标签，可编辑
校验	推送前静态校验的结果清单
脚本	连接配置 + 工程脚本的运行面板

三、文件树

徽章怎么读

目录和文件右侧的小标：

徽章	意思
`✔ 已推送`	内容和平台上的一致
`● 待推送`	本地改过，还没同步到平台
`✗ 定位不到`	这个目录既没有 `page.json` 的 `uuid`、也没有 `meta.json` 的 `id`，入不了账
`校验 ✗3`	这一片有 3 个错误（警告不占徽章，去「校验」页签看）

推送状态是账本：登记每个页面 / 接口在你上次推送时各文件的 mtime，之后 mtime 变了就算「改过」。所以：

徽章回答的是「本地有没有平台上还没有的改动」；
从服务器拉取之后，插件会把这一片的账删掉再重扫 —— 内容刚和服务器对齐，不该显示成待推送。

右键菜单

在树里任意一行点右键：

菜单项	作用
新建文件 / 新建文件夹	在当前位置新建（新建页面类目录会自动带模板）
引用	把该文件的 `@` 引用插进输入框
推送前校验	对这一片跑静态校验，结果落到「校验」页签
重命名 / 移动到… / 删除	常规文件操作（会同步改 `page.json` / `meta.json`）
推送这个页面 / 拉取这个页面	只跑这一个单元
标记已推送	手工记账，不改文件
刷新推送状态	只重扫，不重算账
重置推送状态	把整个工作区的账本清掉，下次扫描全部重新登记

推一个目录 = 连里面的子页面一起推。 平台的 source-page-push.js 拿到目录 uuid 时走的是「推该目录及目录下的所有页面」。所以推完目录，插件会把整棵子树的账一起更新 —— 不会出现「父目录绿了、子页面还挂着待推送」。

键盘

树里有键盘导航：上下移动、左右展开收起、回车打开。首屏如果一直「读取中」，点一下「刷新」。

四、源码

五、校验

「校验」页签列出推送前静态校验的结果，按文件分组，点一条直接跳到源码页签的对应行。

分级：

error —— 会占树上的徽章（✗N），因为平台真的会因此出问题；
warn —— 只在页签里列，不占徽章。比如 no-return（接口脚本里 return '成功' 平台其实能吃），一个真实工程里能有一千多条，标出来只会让人学会忽略徽章。

六、脚本

工作区根目录下那一层的 source-*.js 会被列成卡片，点「运行」就跑（用 DSH 自己的 node，不依赖系统 PATH）。

内置认识的七个：

脚本	说明
`source-push.js`	推送整个项目
`source-clone.js`	克隆整个项目
`source-api-pull.js` / `source-api-push.js`	拉取 / 推送全部接口
`source-page-pull.js` / `source-page-push.js`	拉取 / 推送全部页面
`source-db-pull.js`	拉取数据库

不认识的 source-*.js 也会列出来（标「未登记」），一样能跑。

外网地址一律二次确认

.env 里的 SERVER_URL 只要不是本机，推送和拉取都要先确认一次：

拉取看着「只是把东西取回来」，实际是拿服务器上的状态覆盖本地文件；source-clone.js 还会一路建目录。破坏性和推送一个级别。

跑起来之后下面是输出控制台，可以随时「停止」（Windows 上连子孙进程一起杀）。推送动辄几分钟，所以是「起进程 + 增量取输出」，不是干等。

连接配置（页签顶部那一块）

服务器地址 / 账号 / 密码由面板维护，不要求工作区里事先有 .env：

按钮	作用
新建档案	存一个「服务器」（名称 / 地址 / 账号 / 密码）
铺脚手架	把插件自带的 `source-*.js` / `utils.js` / `package.json` 和三份说明（`AGENTS.md` / `project-rules.md` / `help.md`）铺到当前目录
写入 .env	把选中的档案合并写进工作区的 `.env`
装依赖	装模板要用的 npm 包（只在缺的时候出现）

下面那行写着当前 .env 的现状（地址 / 账号 / 密码 / 项目）。.env 里的地址和选中档案对不上时，「写入 .env」会变红提醒。

全局开发规范（给 AI 看的）

除了往工作区里铺那三份说明，插件还能把一份全局版装到 <DSH_HOME>/AGENTS.md：

按钮	作用
安装	把插件自带的低代码平台规范装成全局指令。文件已存在就一个字节都不动，只说一句「已经存在，没有覆盖它」
移除	只删内容与插件模板逐字节相同的那一份；用户改过、或本来就是用户自己的内容，就不动

文件树页签顶上，没装的时候会挂一条提示条，点「安装」即可。

七、空白目录从零开局

新建一个空文件夹、注册成工作区，然后：

新建档案 —— 填服务器地址 / 账号 / 密码
铺脚手架 —— 把模板脚本铺进来（已存在的文件不会被改动）
写入 .env —— 落盘；原来没有 .env 就新建一个
装依赖 —— 装 axios / archiver / form-data / unzipper

之后脚本卡片就长出来了，选个项目点「克隆整个项目」即可。

依赖只装一次，装在插件自己目录里，跑脚本时用 NODE_PATH 复用 —— 不必给每个新目录各来一次 npm install。目标目录自带 node_modules 时优先用它。

八、数据存在哪

路径	内容
`<DSH_HOME>/project-config.json`	服务器档案（含密码明文）、每个工作区绑定的服务器与项目
`<DSH_HOME>/project-push-state.json`	推送状态账本
`<DSH_HOME>/project-env-backups/`	写 `.env` 前的备份，只留最近 10 份
`<DSH_HOME>/AGENTS.md`	全局开发规范（点「安装」才会创建；已存在则不动）

DSH_HOME 默认是 ~/.dsh，可用环境变量覆盖。

九、更新插件

从市场装的（github: 源）：市场会比对「已安装的 commit」和「仓库 HEAD」，有新的就出现更新按钮，点一下重跑安装，不用卸载重装。

所以：想用「市场一键更新」，就用仓库地址装；想改代码即时生效，就用本地路径装。

十、常见问题

推了父目录，子页面还显示待推送 已经修了：推一个目录会把整棵子树的账一起更新。如果徽章还是旧的，右键「刷新推送状态」。

首屏一直「读取中」 点「刷新」。扫描有 mtime 快照缓存，第二次进同一目录会快很多。

目录上是 ✗ 定位不到 这个目录里既没有 page.json（要 uuid）也没有 meta.json（要 id），账本认不出它是谁。多半是新建了目录还没建页面。

.env 里的 ENV 是什么 只决定脚本打印什么文案，不决定请求打到哪里。面板里没有这一项，恒写 local；真正连哪个地址看 SERVER_URL。

十一、开发

dsh-project-panel/
  package.json          依赖只有给脚手架用的那 4 个（axios / archiver / form-data / unzipper）
  cordis.patch.yml      insert: dsh-project-panel
  lib/index.js          host 半边：desktopProject/* RPC（30 个）
  lib/client.js         client 半边：手写 ESM，改了刷新即生效
  lib/client.editor.js  ⚠ 构建产物（CodeMirror 6）—— 不要手改
  src/editor.js         编辑器分片的源码，npm run build:editor 生成上面那个
  scaffold/             自带的工程脚本模板 + 规范说明（source-*.js / utils.js / package.json / AGENTS.md / AGENTS.global.md / project-rules.md / help.md）
  NOTES.md              开发笔记：每个设计决定和踩过的坑

npm run build:editor     # 重新打包编辑器分片
npm run watch:editor     # 边改边打

设计取舍、性能数字、验证手法都记在 NOTES.md。

License

MIT

lzqzm/dsh-magical-lowcode-project

dsh-project-panel · 工程面板

一、安装

改了代码怎么生效

二、入口在哪

三、文件树

徽章怎么读

右键菜单

键盘

四、源码

五、校验

六、脚本

外网地址一律二次确认

连接配置（页签顶部那一块）

全局开发规范（给 AI 看的）

七、空白目录从零开局

八、数据存在哪

九、更新插件

十、常见问题

十一、开发

License

Community comments

lzqzm/dsh-magical-lowcode-project

dsh-project-panel · 工程面板

一、安装

改了代码怎么生效

二、入口在哪

三、文件树

徽章怎么读

右键菜单

键盘

四、源码

五、校验

六、脚本

外网地址一律二次确认

连接配置（页签顶部那一块）

全局开发规范（给 AI 看的）

七、空白目录从零开局

八、数据存在哪

九、更新插件

十、常见问题

十一、开发

License

Community comments