dsh-project-panel
DSH 工程面板：把低代码工程目录树搬进 web 端 —— 左栏常驻图标 + 中栏工程浏览器（多级文件树 / 推送状态 / 文件内容）。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:lzqzm/dsh-magical-lowcode-project#5deb8fa8b7e389bb9a7f469e71fc96f8db64023dProject Panel 以 dsh-project-panel 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
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-magical-lowcode-project
本地开发（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。
分级：
✗N），因为平台真的会因此出问题；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 铺到当前目录 |
| 写入 .env | 把选中的档案合并写进工作区的 .env |
| 装依赖 | 装模板要用的 npm 包（只在缺的时候出现） |
下面那行写着当前 .env 的现状（地址 / 账号 / 密码 / 项目）。.env 里的地址和选中档案对不上时，「写入 .env」会变红提醒。
项目清单也能手动维护：选好服务器后点「＋ 项目」录一条（uuid + 名字），选中的那条可以「改名」「删除」。清单挂在服务器档案上，不挂文件树 —— 同一个服务器下的项目是同一批。另外 .env 注释里那批项目 uuid 会被自动捡出来当候选，两边在界面上合并显示。
新建一个空文件夹、注册成工作区，然后：
.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 默认是 ~/.dsh，可用环境变量覆盖。
写 .env 有两条规矩：注释行一行不动（平台爱把备选项目、备选地址注释着堆在同一份文件里，那是用户唯一的人肉清单），内容没变化就一个字节都不碰（否则跑一次脚本留一份一模一样的备份，10 份上限很快被垃圾挤满）。
面板的能力边界：所有带路径参数的 RPC 都要求路径落在已注册的工作区内，否则拒掉；跑脚本时只认工作区根目录下那一层的 source-[a-z0-9-]+\.js。
从市场装的（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（26 个）
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）
NOTES.md 开发笔记：每个设计决定和踩过的坑
npm run build:editor # 重新打包编辑器分片
npm run watch:editor # 边改边打
link: 安装不装传递依赖，所以两个半边都不许 import 第三方包，也不许 import @deepseek-ai/*（Node 从插件真实路径向上解析，够不到 profile/node_modules）。顶层 import 失败会打挂整个 profile。
设计取舍、性能数字、验证手法都记在 NOTES.md。
MIT