# 静态资源来源（Vendoring）

`static/` 下的三个文件是「进度」单页应用的**原封不动**拷贝，来源仓库：
[lsqace-del/gantt-progress-app](https://github.com/lsqace-del/gantt-progress-app)（上游应用 v1.1.27）。

| 本仓库文件 | 来源 | 说明 |
| --- | --- | --- |
| `static/index.html` | 上游 `进展.html` | 界面骨架（图标 sprite、视图面板、对话框） |
| `static/app.js` | 上游 `app.js`（499KB） | 全部界面逻辑 + 「本地文件夹服务器」同步协议客户端 |
| `static/styles.css` | 上游 `styles.css` | 全部样式 |

维护约定：

- **不要**直接修改 `static/` 里的文件；上游更新时整体覆盖，保证「原封不动」。
- 插件与上游的衔接只发生在三处，全部在 `lib/` 内：
  - `lib/index.js` 静态托管路由 `/progress`（前缀，不带尾斜杠）；
  - `lib/index.js` 的 `/api/progress/load|save|upload|file` —— 复刻上游的文件夹协议服务端；
  - 动态 `folder-data.js`（`/progress/folder-data.js`）注入会话 id 与项目名，作用域隔离 localStorage。
- `lib/share-template.html` 同样源自上游 `html查看器/index.html`，用于 agent 端「老师只读网页」导出。

上游应用在 `http://127.0.0.1` 页面下会自动调用同源 `/api/progress/*`（见 `static/app.js` 中
`LOCAL_FOLDER_SERVER_URL` 与 `getLocalFolderApiBase`），这正是插件能在不改界面代码的前提下
把数据落到 `.progress/` 的原因。