@coda-console/resource-manager 0.8.1 → 0.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # 资源管理器
2
2
 
3
- Coda 插件:会话旁的文件浏览器。浏览这个会话的工作目录,读文本和图片,把路径交给对话。只读。
3
+ Coda 插件:会话旁的文件浏览器。浏览这个会话的工作目录,读文本、图片、音频、视频和 3D 模型,把路径交给对话。只读。
4
4
 
5
5
  - **Mac**:在会话侧栏里,和对话并排。
6
6
  - **iPhone**:在会话右上角菜单里打开,点文件在资源页里切到预览,系统返回(左上「‹」、左边缘侧滑)回到打开它的那一层。iPad 和 iPhone Duo 用同一套界面,没有单独适配。
@@ -12,7 +12,9 @@ Coda 插件:会话旁的文件浏览器。浏览这个会话的工作目录,
12
12
  - **按键的质感**(`0.7.2`):两端按下就有底色反馈(页面自己加状态,不靠 `:active`;快点一下也看得到,滑动时不闪;菜单开着时点外面那一下只关菜单),Mac 的按钮是箭头光标;菜单有阴影,iPhone 的菜单出现时有淡入加缩放;iPhone 打开文件、属性页和返回(含侧滑)是滑动过渡,图标视图进出目录是淡入。系统打开「减弱动态效果」后所有动画和过渡都不做,按下反馈照常。没有触感(契约没有这个接口)。
13
13
  - 图标视图回上一层:iPhone 用系统的返回,Mac 点头部最左边的返回键或按 ⌘↑,退回的那一层里选中刚才进去的文件夹。**没有预览面板**:只有一个侧栏,也没有面包屑。
14
14
  - **Mac 的键盘**:点一下目录树或图标视图让它拿到焦点(Tab 也能进来),↑ ↓ 移动选中(图标视图按行列走),列表里 → 展开、← 收起或选中所在的文件夹,图标视图里 ← → 选左右的条目;⌘↓ 同双击(打开、展开、进入);⌘↑ 在图标视图里回上一层,在预览里返回目录树或图标视图;⌘F 聚焦搜索框。搜索框里 ↓ 进结果,Esc 清空;结果里 Esc 回搜索框。不做多选、按字母跳转,Return 和空格也没绑定。读屏的 `aria-activedescendant` 没做(见 `docs/backlog.md`)。
15
- - 文本预览(带行号,可跨行选中复制,最多读 1 MiB)和图片预览(PNG、JPEG、GIF、WebP、SVG,最多 8 MiB)。
15
+ - 文本预览(带行号,可跨行选中复制,最多读 1 MiB)。
16
+ - **图片、音频、视频预览**(`0.9.0`):经 Coda 开放的本机流式服务,边播边取,不分块传、没有大小上限,音视频可拖动进度。图片:PNG、JPEG、GIF、WebP、SVG、AVIF、HEIC、BMP、TIFF;音频:MP3、M4A、AAC、WAV、FLAC、OGG(Opus)、AIFF、CAF;视频:MP4、M4V、MOV、WebM。用系统自带的播放控件;元信息行写目录、大小,音视频加时长。能不能放取决于这台设备的浏览器内核(Mac 和 iPhone 不同),放不了的写「这台设备放不了这种格式」;MKV、AVI 播放器不支持,直接写「这种格式不能预览」,只给大小和修改时间。不缓存,每次都向模块要。刷新不打断播放:文件变了,元信息行写「文件已变化」,点头部「重载」才换。旧版本的 Coda 没有这个服务:图片退回分块读取(最多 8 MiB),音视频不预览。
17
+ - **3D 模型预览**(`0.9.1`):用 [three.js](https://threejs.org/) 在页面里画,字节同样经本机流式服务取。格式:glb、glTF(外部 `.bin` 和贴图按相对路径取)、STL(二进制和 ASCII)、OBJ(按 `mtllib` 找同目录的 `.mtl` 和贴图)、PLY(含顶点色和点云)、3MF。自动取景,单指转、双指缩放平移(Mac 拖动和滚轮),「复位视角」回到取景的位置;带环境光,金属材质不发黑。glb、glTF 有动画时自动循环播放第一段,有「播放/暂停」,多于一段时可选播哪一段;只在播放时连续渲染,切到后台、关预览、换文件都会停,系统开了「减弱动态效果」时不自动播放。元信息行写目录、大小、面数(点云写点数)和动画段数。glTF、OBJ、STL、PLY 内容是文本时,头部有「3D / 文本」切换,文本走普通的文本预览(二进制的没有切换)。超过 64 MiB 的模型先问「仍然加载」。用了 Draco、meshopt、KTX2 压缩的 glTF 不能预览;这台设备没有 WebGL 时写「这台设备不能显示 3D 模型」。文件变了不打断,元信息行写「文件已变化」,点头部「重载」才换。解析在主线程,很大的模型打开时页面会卡一下。
16
18
  - 代码按语言上色:三十多种常见语言,只按文件名和扩展名认,不猜内容,深浅各一套配色;认不出的显示纯文本。超过 128 KiB 的文件不上色,说明区注明「不高亮」。用的是近似的语法规则,不是语法检查,个别文件会认错(如 `.h` 一律按 C++,`.m` 一律按 Objective-C),不保证完整支持。
17
19
  - Agent 一轮结束后,已展开的目录和正在看的文件自动更新。
18
20
  - 每行带修改日期和大小:Mac 在名字右边(按日期排序时显示日期,否则显示大小,侧栏很窄时隐藏),iPhone 在名字下面一行。右键或长按的菜单里有大小和完整修改时间。文件夹不显示大小(列表和菜单都没有),只有修改日期。
@@ -41,7 +43,7 @@ Coda 插件:会话旁的文件浏览器。浏览这个会话的工作目录,
41
43
 
42
44
  ## 开发
43
45
 
44
- 不需要安装依赖,也没有构建步骤;第三方代码只有 `view/vendor/highlight/` 下原样复制的 highlight.js(升级方法见三期设计第 15.2 节)。Node 由 Coda 提供(`$CODA_NODE`)。
46
+ 不需要安装依赖,也没有构建步骤;第三方代码只有 `view/vendor/` 下原样复制的 highlight.js 和 three.js(升级方法见三期设计第 15.2、21.2 节;three 用 `node scripts/vendor-three.mjs [版本]` 重新生成)。Node 由 Coda 提供(`$CODA_NODE`)。
45
47
 
46
48
  ```sh
47
49
  # 测试,也可以用 npm test。Node 24 上不能写成 node --test test/
@@ -87,3 +89,5 @@ npx --yes github:coda-console/coda-plugins#<提交> . --manifest
87
89
  MIT。
88
90
 
89
91
  第三方:`view/vendor/highlight/` 里是 [highlight.js](https://highlightjs.org/) 11.12.0 的浏览器构建,BSD-3-Clause 许可,版权声明和许可全文在同目录的 `LICENSE`,文件原样复制,没有修改。
92
+
93
+ `view/vendor/three/` 里是 [three.js](https://threejs.org/) 0.187.0 的构建和几个示例模块(加载器、轨道控制、房间环境、fflate),MIT 许可,版权声明和许可全文在同目录的 `LICENSE`。内容原样复制,只做两处机械改动:文件后缀 `.js` 改成 `.mjs`(含文件之间的相对导入),裸导入 `'three'` 改成相对路径;不压缩、不打包。
package/lib/media.mjs ADDED
@@ -0,0 +1,83 @@
1
+ // 音视频、图片和 3D 模型的本机流式服务(设计见 docs/design/phase-3.md 第 20、21 节):页面的 <audio>、<video>、<img> 指向 coda-view://service/media/<口令>/<相对路径>,3D 查看器用 fetch 取字节。
2
+ // 口令由主模块按视图发,映射到那个视图当时的根目录;根目录变了、换会话、视图关了就作废。只接 GET、HEAD,只读文件,路径校验同 READ。
3
+ import { randomUUID } from 'node:crypto';
4
+ import { constants } from 'node:fs';
5
+ import { open } from 'node:fs/promises';
6
+ import { pipeline } from 'node:stream/promises';
7
+ import { ErrorCode, servedType } from '../view/protocol.mjs';
8
+ import { fromFsError, resolveInRoot } from './paths.mjs';
9
+
10
+ const NOFOLLOW = constants.O_NOFOLLOW ?? 0;
11
+
12
+ const CORS = { 'access-control-allow-origin': '*', 'access-control-expose-headers': 'content-length, content-range, etag' };
13
+
14
+ const STATUS = {
15
+ [ErrorCode.INVALID_PATH]: 400, [ErrorCode.OUTSIDE_ROOT]: 403, [ErrorCode.DENIED]: 403,
16
+ [ErrorCode.NOT_FOUND]: 404, [ErrorCode.NOT_DIR]: 404, [ErrorCode.NOT_FILE]: 404,
17
+ };
18
+
19
+ // 'bytes=a-b' | 'bytes=a-' | 'bytes=-n' → { start, end }(含 end);不认得的写法(含多段)当作没带 Range,越界返回 'bad'。
20
+ function parseRange(header, size) {
21
+ const m = /^bytes=(\d*)-(\d*)$/.exec(header ?? '');
22
+ if (!m || (m[1] === '' && m[2] === '')) return null;
23
+ let start, end;
24
+ if (m[1] === '') { start = Math.max(0, size - Number(m[2])); end = size - 1; } else {
25
+ start = Number(m[1]); end = m[2] === '' ? size - 1 : Math.min(Number(m[2]), size - 1);
26
+ }
27
+ return start > end || start >= size ? 'bad' : { start, end };
28
+ }
29
+
30
+ export function createMedia() {
31
+ const grants = new Map(); // 口令 → 根目录
32
+
33
+ const grant = root => {
34
+ const token = randomUUID().replaceAll('-', '');
35
+ grants.set(token, root);
36
+ return token;
37
+ };
38
+ const revoke = token => { if (token) grants.delete(token); };
39
+
40
+ async function handler(req, res) {
41
+ const end = status => { res.writeHead(status, { 'content-type': 'text/plain; charset=utf-8', ...CORS }); res.end(); };
42
+ if (req.method === 'OPTIONS') { res.writeHead(204, { ...CORS, 'access-control-allow-methods': 'GET, HEAD', 'access-control-allow-headers': 'range, if-none-match, if-range' }); return res.end(); }
43
+ if (req.method !== 'GET' && req.method !== 'HEAD') return end(405);
44
+ const [, token, ...rest] = new URL(req.url, 'http://x').pathname.split('/');
45
+ const root = grants.get(token);
46
+ if (root === undefined) return end(404);
47
+ let path;
48
+ try { path = rest.map(decodeURIComponent).join('/'); } catch { return end(400); }
49
+ const type = servedType(path);
50
+ if (!type) return end(415);
51
+ let handle;
52
+ try {
53
+ handle = await open(await resolveInRoot(root, path), constants.O_RDONLY | NOFOLLOW);
54
+ const info = await handle.stat();
55
+ if (!info.isFile()) return end(404);
56
+ const { size } = info;
57
+ // 不缓存:每次都问(no-cache);内容没变回 304,续传带的 If-Range 对不上就整份重来。
58
+ const etag = `"${size}-${Math.floor(info.mtimeMs)}"`;
59
+ // 跨源头:3D 模型页面用 fetch 取字节、WebGL 贴图要带 crossOrigin 的 <img>,都需要。口令本身就是授权,所以放开来源。
60
+ const headers = { 'content-type': type, 'accept-ranges': 'bytes', etag, 'cache-control': 'no-cache', ...CORS };
61
+ if (String(req.headers['if-none-match'] ?? '').split(',').some(tag => tag.trim().replace(/^W\//, '') === etag)) {
62
+ res.writeHead(304, { etag, 'cache-control': 'no-cache', ...CORS });
63
+ return res.end();
64
+ }
65
+ const ifRange = req.headers['if-range'];
66
+ const range = ifRange && ifRange !== etag ? null : parseRange(req.headers.range, size);
67
+ if (range === 'bad') { res.writeHead(416, { 'content-range': `bytes */${size}`, ...CORS }); return res.end(); }
68
+ const [status, start, last] = range ? [206, range.start, range.end] : [200, 0, size - 1];
69
+ if (range) headers['content-range'] = `bytes ${start}-${last}/${size}`;
70
+ headers['content-length'] = String(size === 0 ? 0 : last - start + 1);
71
+ res.writeHead(status, headers);
72
+ if (req.method === 'HEAD' || size === 0) return res.end();
73
+ // 客户端中途断开:pipeline 随 res 关闭销毁读流。
74
+ await pipeline(handle.createReadStream({ start, end: last, autoClose: false }), res).catch(() => {});
75
+ } catch (error) {
76
+ // 被 O_NOFOLLOW 拒绝说明校验后被换成了链接,同读文本按越界处理。
77
+ const code = NOFOLLOW && (error?.code === 'ELOOP' || error?.code === 'EMLINK') ? ErrorCode.OUTSIDE_ROOT : fromFsError(error).code;
78
+ if (!res.headersSent) end(STATUS[code] ?? 500); else res.destroy();
79
+ } finally { await handle?.close().catch(() => {}); }
80
+ }
81
+
82
+ return { handler, grant, revoke };
83
+ }
package/main.mjs CHANGED
@@ -4,10 +4,11 @@ import { createListing, listDirectory } from './lib/tree.mjs';
4
4
  import { readChunk } from './lib/content.mjs';
5
5
  import { addText } from './lib/draft.mjs';
6
6
  import { dirSize, statPath } from './lib/info.mjs';
7
+ import { createMedia } from './lib/media.mjs';
7
8
  import { createSearcher } from './lib/search.mjs';
8
9
  import { NO_ROOT, queryRoot, sameRoot } from './lib/root.mjs';
9
10
  import {
10
- ErrorCode, MESSAGE_LIMIT, REQUEST_ID_MAX, ReplyOf, RootState, Type, fail, messageSize,
11
+ EntryKind, ErrorCode, MESSAGE_LIMIT, REQUEST_ID_MAX, ReplyOf, RootState, Type, fail, messageSize,
11
12
  } from './view/protocol.mjs';
12
13
 
13
14
  const POLL_MS = 2000;
@@ -22,7 +23,10 @@ const sessionOfFile = context => {
22
23
 
23
24
  // options 只给测试用,运行时不传:makeListing 换成带假文件系统的读取状态;sizeLimits 调文件夹大小的项数、用时上限;searchLimits 调文件名搜索的条数、项数、用时、队列字节、回答字节上限。
24
25
  export function activate(coda, { makeListing = createListing, sizeLimits = {}, searchLimits = {} } = {}) {
25
- const options = { makeListing, sizeLimits, searchLimits };
26
+ // 音视频和图片的本机流式服务,所有视图共用一个,口令按视图发。宿主没有这个接口(旧版本)或登记失败时 service.on 为假,页面退回分块读取。
27
+ const media = createMedia(), service = { on: true };
28
+ try { Promise.resolve(coda.services.register('media', media.handler)).catch(() => { service.on = false; }); } catch { service.on = false; }
29
+ const options = { makeListing, sizeLimits, searchLimits, media, service };
26
30
  coda.views.register('files', { open: view => serve(coda, view, sessionOfTree, options) });
27
31
  coda.views.register('file', { open: view => serve(coda, view, sessionOfFile, options) });
28
32
  }
@@ -30,7 +34,7 @@ export function activate(coda, { makeListing = createListing, sizeLimits = {}, s
30
34
  const validRequestId = id => (typeof id === 'string' && id.length <= REQUEST_ID_MAX) || Number.isSafeInteger(id);
31
35
  const errorOf = error => (error?.protocol ? { code: error.code, message: error.message } : { code: ErrorCode.IO, message: '读取失败' });
32
36
 
33
- function serve(coda, view, sessionOf, { makeListing, sizeLimits, searchLimits }) {
37
+ function serve(coda, view, sessionOf, { makeListing, sizeLimits, searchLimits, media, service }) {
34
38
  // 代次:每换一次会话加 1,所有异步出口回来后都要核对。
35
39
  const s = {
36
40
  session: sessionOf(view.context), generation: 1, root: NO_ROOT, sent: null,
@@ -45,8 +49,10 @@ function serve(coda, view, sessionOf, { makeListing, sizeLimits, searchLimits })
45
49
  const stopSizing = () => { sizing?.abort.abort(); sizing = null; };
46
50
  // 文件名搜索:同样每个视图同时只有一次,槽、待启动位和排空屏障都在 lib/search.mjs 的 searcher 里。
47
51
  const searcher = createSearcher(s.listing, searchLimits);
48
- // 换会话、根目录变化、视图关闭:读取状态丢弃,统计和搜索也停。
49
- const resetReads = () => { s.listing.clear(); stopSizing(); searcher.clear(); };
52
+ // 媒体口令:这个视图第一次要放音视频或图片时发,映射到当时的根目录。
53
+ let token = null;
54
+ // 换会话、根目录变化、视图关闭:读取状态丢弃,统计和搜索也停,媒体口令作废。
55
+ const resetReads = () => { s.listing.clear(); stopSizing(); searcher.clear(); media.revoke(token); token = null; };
50
56
 
51
57
  function post(message) {
52
58
  if (s.closed) return;
@@ -119,6 +125,13 @@ function serve(coda, view, sessionOf, { makeListing, sizeLimits, searchLimits })
119
125
  } finally { if (sizing === mine) sizing = null; }
120
126
  },
121
127
  [Type.SEARCH]: (message, { root, valid, generation, requestId }) => searcher.search(message, { root, valid, generation, requestId }),
128
+ async [Type.MEDIA](message, { root, valid }) {
129
+ const info = await statPath(s.listing, root, message.path);
130
+ if (info.kind !== EntryKind.FILE) throw fail(ErrorCode.NOT_FILE, '不是文件');
131
+ if (!valid()) throw fail(ErrorCode.NO_ROOT, '工作目录已变化');
132
+ if (service.on) token ??= media.grant(root);
133
+ return { token, size: info.size, mtimeMs: info.mtimeMs }; // token 为 null:没有流式服务,页面退回分块读取
134
+ },
122
135
  async [Type.ADD_TEXT](message, { generation }) {
123
136
  if (!s.session) throw fail(ErrorCode.NO_ROOT, '没有会话');
124
137
  return await addText(coda, s.session, message, { valid: () => !stale(generation) }) ? {} : null;
@@ -164,7 +177,7 @@ function serve(coda, view, sessionOf, { makeListing, sizeLimits, searchLimits })
164
177
  if (stale(message.generation)) return undefined;
165
178
  s.listing.detach();
166
179
  return refreshRoot();
167
- case Type.LIST: case Type.READ: case Type.STAT: case Type.DIR_SIZE: case Type.ADD_TEXT: case Type.SEARCH: return request(message);
180
+ case Type.LIST: case Type.READ: case Type.STAT: case Type.DIR_SIZE: case Type.ADD_TEXT: case Type.SEARCH: case Type.MEDIA: return request(message);
168
181
  case Type.DIR_SIZE_CANCEL: return cancelSizing(message);
169
182
  case Type.SEARCH_CANCEL: return cancelSearch(message);
170
183
  }
package/package.json CHANGED
@@ -2,8 +2,8 @@
2
2
  "id": "resource-manager",
3
3
  "name": "@coda-console/resource-manager",
4
4
  "displayName": "资源管理器",
5
- "description": "会话旁的只读文件浏览器:浏览会话工作目录,预览文本和图片,把路径交给对话。",
6
- "version": "0.8.1",
5
+ "description": "会话旁的只读文件浏览器:浏览会话工作目录,预览文本、图片、音频、视频和 3D 模型,把路径交给对话。",
6
+ "version": "0.9.1",
7
7
  "categories": ["工作流程"],
8
8
  "license": "MIT",
9
9
  "repository": {
package/view/app.mjs CHANGED
@@ -137,6 +137,7 @@ function clearSearch() {
137
137
  }
138
138
  const preview = mountPreview($('preview'), {
139
139
  read: (path, offset) => conn.link.call('read', { path, offset }), copy: text => coda.copy(text),
140
+ media: path => conn.link.call('media', { path }),
140
141
  // iPhone 预览头部右边的 ⋯(刷新、复制路径):顶部工具条在预览时只有「返回」,只留头部一行标题
141
142
  actions: isIOS ? [{ label: '更多', icon: 'ellipsis', run: (_, button) => toggleMore(button) }] : [{ label: '窗口', icon: 'window', run: openInView }], copyInHead: !isIOS,
142
143
  back: isIOS ? null : closePreview,
package/view/file-app.mjs CHANGED
@@ -41,6 +41,7 @@ const press = mountPress({ consumed: menu.consumed }); // 按下反馈:刷新
41
41
  const chat = createChat({ link: conn.link, copy: text => coda.copy(text), hint });
42
42
  const preview = mountPreview($('preview'), {
43
43
  read: (path, offset) => conn.link.call('read', { path, offset }), copy: text => coda.copy(text),
44
+ media: path => conn.link.call('media', { path }),
44
45
  selectionMenu: isIOS ? null : (event, selection) => menu.open(event, { items: chat.selectionItems(selection) }),
45
46
  consumed: menu.consumed,
46
47
  });
package/view/format.mjs CHANGED
@@ -11,6 +11,12 @@ export function formatSize(bytes) {
11
11
 
12
12
  const two = n => String(n).padStart(2, '0');
13
13
 
14
+ // 音视频时长:3:07,不到一小时不写小时。
15
+ export function formatDuration(seconds) {
16
+ const total = Math.round(seconds), hours = Math.floor(total / 3600), minutes = Math.floor(total % 3600 / 60);
17
+ return hours > 0 ? `${hours}:${two(minutes)}:${two(total % 60)}` : `${minutes}:${two(total % 60)}`;
18
+ }
19
+
14
20
  // 相对格式,按本地时间:今天 14:05,今年 11月4日,往年 2025年3月。
15
21
  export function formatDate(ms, now) {
16
22
  const date = new Date(ms), current = new Date(now);
@@ -0,0 +1,85 @@
1
+ // 3D 模型预览里不碰 DOM、不碰 three 的部分(设计见 docs/design/phase-3.md 第 21 节):服务地址、glTF 的头和压缩扩展检查、obj 的 mtllib、相对路径、文本切换的条件、动画的播放状态。Node 里能直接测。
2
+ import { ContentKind } from './protocol.mjs';
3
+
4
+ export const BIG_FILE = 64 * 1024 * 1024; // 超过这个大小先问一声再读(整份读进内存,iPhone 上可能直接崩掉页面)
5
+ export const Z_UP = new Set(['stl', 'ply', '3mf']); // 这几种格式多半是 Z 轴朝上,转成 three.js 的 Y 轴朝上
6
+
7
+ // 这三种压缩 three 自带的 GLTFLoader 不能直接解(要另外的解码器和 wasm),不带,提示不能预览。
8
+ export const UNSUPPORTED_GLTF = ['KHR_draco_mesh_compression', 'EXT_meshopt_compression', 'KHR_texture_basisu'];
9
+
10
+ const encodePath = path => path.split('/').map(encodeURIComponent).join('/');
11
+ // 流式服务里文件的地址;v 只用来在文件变了之后换地址。
12
+ export const serviceUrl = (token, path, version = '') => `coda-view://service/media/${token}/${encodePath(path)}${version ? `?v=${version}` : ''}`;
13
+ // 一个文件所在目录的地址,带结尾的斜杠:gltf 的 .bin、贴图和 obj 的 .mtl 按相对路径接在它后面。
14
+ export const directoryUrl = (token, path) => {
15
+ const dir = path.includes('/') ? path.slice(0, path.lastIndexOf('/')) : '';
16
+ return `coda-view://service/media/${token}/${dir ? `${encodePath(dir)}/` : ''}`;
17
+ };
18
+ export const extensionOf = path => (path.includes('.') ? path.slice(path.lastIndexOf('.') + 1).toLowerCase() : '');
19
+
20
+ // 「3D / 文本」切换:这四种格式既可以是文本也可以是二进制,要读一块看内容;内容是文本(模块按前 8000 字节没有 NUL 判断)才提供。glb、3mf 一定是二进制,不用读。
21
+ const TEXTUAL = new Set(['gltf', 'obj', 'stl', 'ply']);
22
+ export const mayBeText = path => TEXTUAL.has(extensionOf(path));
23
+ export const offersTextView = (path, contentKind) => mayBeText(path) && contentKind === ContentKind.TEXT;
24
+
25
+ // glTF 的 JSON:.gltf 是文本;.glb 是 12 字节头,后面第一块必须是 JSON 块。读不出来抛带原因的错。
26
+ export function gltfJson(bytes, ext) {
27
+ const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
28
+ let text;
29
+ if (ext === 'glb') {
30
+ if (bytes.byteLength < 20 || view.getUint32(0, true) !== 0x46546c67) throw new Error('不是有效的 glb(文件头不是 glTF)');
31
+ const declared = view.getUint32(8, true), length = view.getUint32(12, true), type = view.getUint32(16, true);
32
+ if (declared > bytes.byteLength) throw new Error(`glb 头里写的总长度是 ${declared} 字节,文件只有 ${bytes.byteLength} 字节(文件被截断)`);
33
+ if (type !== 0x4e4f534a) throw new Error('glb 的第一块不是 JSON');
34
+ if (20 + length > bytes.byteLength) throw new Error('glb 的 JSON 块超出文件末尾(文件被截断)');
35
+ text = new TextDecoder().decode(bytes.subarray(20, 20 + length));
36
+ } else text = new TextDecoder().decode(bytes);
37
+ try { return JSON.parse(text); } catch (error) { throw new Error(`glTF 的 JSON 读不出来:${error.message}`); }
38
+ }
39
+
40
+ // extensionsRequired 和 extensionsUsed 里有不支持的压缩,返回它们的名字(可能为空)。
41
+ export function unsupportedExtensions(json) {
42
+ const names = new Set([...(json?.extensionsRequired ?? []), ...(json?.extensionsUsed ?? [])]);
43
+ return UNSUPPORTED_GLTF.filter(name => names.has(name));
44
+ }
45
+
46
+ // obj 里第一行 mtllib 给的材质文件名(可以含空格);没有返回 null。
47
+ export function mtllibOf(text) {
48
+ const match = /^[ \t]*mtllib[ \t]+(.+?)[ \t]*$/m.exec(text);
49
+ return match ? match[1].replaceAll('\\', '/') : null;
50
+ }
51
+
52
+ // 相对路径接在目录后面:合并 ./ 和 ../,不让它跑出根目录(跑出去返回 null)。
53
+ export function joinRelative(dir, rel) {
54
+ const out = dir ? dir.split('/') : [];
55
+ for (const part of rel.split('/')) {
56
+ if (part === '' || part === '.') continue;
57
+ if (part === '..') { if (out.length === 0) return null; out.pop(); } else out.push(part);
58
+ }
59
+ return out.join('/');
60
+ }
61
+
62
+ // PLY 头里 element face 的个数(ASCII 和二进制都适用);没有或读不出头返回 0,按点云处理。
63
+ export function plyFaceCount(bytes) {
64
+ const head = new TextDecoder('latin1').decode(bytes.subarray(0, 65536));
65
+ const end = /^end_header/m.exec(head);
66
+ if (!end) return 0;
67
+ const face = /^element[ \t]+face[ \t]+(\d+)/m.exec(head.slice(0, end.index));
68
+ return face ? Number(face[1]) : 0;
69
+ }
70
+
71
+ // 动画的播放状态:是否在连续渲染(running)只看这里。clips 是动画段数;reducedMotion 为真时不自动播放。
72
+ // 选了一段就从头播;页面不可见时不跑,可见了接着跑(用户没按暂停的话);停止之后不再跑。
73
+ export function createPlayback({ clips, reducedMotion }) {
74
+ const state = { playing: clips > 0 && !reducedMotion, clip: 0, visible: true, stopped: false };
75
+ return {
76
+ get clips() { return clips; },
77
+ get playing() { return state.playing; },
78
+ get clip() { return state.clip; },
79
+ get running() { return clips > 0 && state.playing && state.visible && !state.stopped; },
80
+ toggle() { if (clips > 0) state.playing = !state.playing; },
81
+ select(index) { if (Number.isInteger(index) && index >= 0 && index < clips) { state.clip = index; state.playing = true; } },
82
+ setVisible(visible) { state.visible = visible; },
83
+ stop() { state.stopped = true; },
84
+ };
85
+ }
package/view/preview.mjs CHANGED
@@ -1,12 +1,14 @@
1
1
  // 文件预览:只接收路径和读块的能力,不依赖树的状态。readFile 是纯逻辑;mountPreview 才碰 DOM。
2
2
  import { h } from './dom.mjs';
3
3
  import { createFind } from './find.mjs';
4
- import { formatSize } from './format.mjs';
4
+ import { formatDuration, formatSize } from './format.mjs';
5
5
  import { HIGHLIGHT_LIMIT, appendAll, hasLongLine, highlight } from './highlight.mjs';
6
6
  import { icon, iconFor } from './icons.mjs';
7
7
  import { languageOf } from './languages.mjs';
8
- import { ContentKind, EntryKind, ErrorCode, IMAGE_LIMIT, TEXT_LIMIT, imageType } from './protocol.mjs';
8
+ import { ContentKind, EntryKind, ErrorCode, IMAGE_LIMIT, TEXT_LIMIT, imageType, mediaOf } from './protocol.mjs';
9
9
  import { clippedSelection, linesOf } from './selection.mjs';
10
+ import { mayBeText, offersTextView } from './model3d.mjs';
11
+ import { mountViewer } from './viewer3d.mjs';
10
12
 
11
13
  function fromBase64(data) {
12
14
  const binary = atob(data), bytes = new Uint8Array(binary.length);
@@ -63,18 +65,23 @@ export const lineCount = text => (text === '' ? 1 : text.split('\n').length - (t
63
65
  // 页面只负责入口:canFind(有显示着的文本才有)、openFind()(⌘F、iPhone 的「查找」菜单项)。consumed(event):这个按键已经被菜单消费了(菜单开着时的 Esc)。
64
66
  // selectionMenu(event, { path, text, startLine, endLine }):给了就接管正文里选中文字的右键(只有 Mac 传);预览不知道菜单里是什么。
65
67
  // 选区为空、或裁到正文里之后为空时不接管,走系统默认。内容和行号在这里取好,交出去之后和选区无关。
66
- export function mountPreview(el, { read, copy, actions = [], copyInHead = true, back = null, selectionMenu = null, consumed = () => false }) {
68
+ // media(path) → Promise<{ token, size, mtimeMs }>(第 20 节):音视频和图片经模块的本机流式服务显示,token 是这个视图的口令;token 为 null 表示宿主没有流式服务。
69
+ // 不传 media 就一律走分块读取(直接挂载预览的测试用)。
70
+ // 3D 模型(第 21 节):mountModel 挂查看器(默认 viewer3d.mjs,测试可换)。gltf、obj、stl、ply 的内容是文本时头部有「3D / 文本」切换,文本走分块读取。
71
+ export function mountPreview(el, { read, copy, actions = [], copyInHead = true, back = null, selectionMenu = null, consumed = () => false, media = null, mountModel = mountViewer }) {
67
72
  const name = h('div', { class: 'pname truncate' }), meta = h('div', { class: 'pmeta caption secondary truncate' }, ' ');
68
73
  const fileIcon = h('span', { class: 'pico', 'aria-hidden': 'true' });
69
74
  // 图标按钮:可访问名称和 Mac 的悬停提示都是 label;没有图标的退回文字。
70
75
  const action = (label, glyph, run) => h('button', { class: glyph ? 'icon' : 'link', 'aria-label': label, title: label, onclick: run }, glyph ? icon(glyph, 18) : label);
71
76
  const copyPath = () => path !== null && copy(path);
72
- const retryButton = h('button', { class: 'link', onclick: () => load(true), hidden: true }, '重试');
77
+ const retryButton = h('button', { class: 'link', onclick: () => load(!changed), hidden: true }, '重试');
73
78
  const body = h('div', { class: 'pbody', tabindex: '-1' }); // 可聚焦:关查找条后焦点回正文
79
+ const modes = [['3d', '3D'], ['text', '文本']].map(([value, label]) => ({ value, button: h('button', { class: 'link', onclick: () => setMode(value) }, label) }));
80
+ const modeBar = h('div', { class: 'pmode', role: 'group', 'aria-label': '显示方式', hidden: true }, ...modes.map(({ button }) => button));
74
81
  let gutterEl = null;
75
82
  const find = createFind({ body, gutterWidth: () => gutterEl?.offsetWidth ?? 0 });
76
83
  const extra = actions.map(({ label, icon: glyph, run }) => { const button = action(label, glyph, () => path !== null && run(path, button)); return button; });
77
- el.replaceChildren(h('div', { class: 'phead' }, ...(back ? [action('返回', 'back', back)] : []), fileIcon, h('div', { class: 'grow' }, name, meta), retryButton,
84
+ el.replaceChildren(h('div', { class: 'phead' }, ...(back ? [action('返回', 'back', back)] : []), fileIcon, h('div', { class: 'grow' }, name, meta), modeBar, retryButton,
78
85
  ...(copyInHead ? [action('复制路径', 'copy', copyPath)] : []), ...extra), find.el, body);
79
86
  find.done.addEventListener('click', () => { find.close(); body.focus(); });
80
87
  // 查找条的键盘:Esc 关(从查找条里关,焦点回正文;焦点在正文里,焦点留在正文);⌘G、⇧⌘G 下一个、上一个。输入法组字中的按键不管,菜单消费掉的 Esc 不再处理。
@@ -97,17 +104,36 @@ export function mountPreview(el, { read, copy, actions = [], copyInHead = true,
97
104
  let opens = 0, stoppedAt = -1; // 打开次数和上一次停止时的次数:释放只在停止之后没有再打开过时才做(返回的退场还没结束又打开了)
98
105
  let carry = null; // 待恢复的位置 { scroll, settle }:open 带进来,读取真正用上或作废后才清
99
106
  const settle = used => { const c = carry; carry = null; c?.settle(used); };
100
- let metaText = ' ', metaTitle = '', stale = null; // stale:后台刷新失败的原因,此时正文还是上次的
101
- // 更新失败的提示占用元信息那一行,重试按钮在头部,所以正文不会被顶动。
107
+ let metaText = ' ', metaTitle = '', stale = null, changed = false; // stale:后台刷新失败的原因,此时正文还是上次的;changed:正在播放的文件变了,等用户点「重载」
108
+ // 更新失败和文件已变化的提示占用元信息那一行,重试(重载)按钮在头部,所以正文不会被顶动。
102
109
  const paintMeta = () => {
103
- meta.textContent = stale ? `更新失败:${stale}` : metaText;
104
- meta.title = stale ?? metaTitle;
105
- meta.classList.toggle('warn', stale !== null);
106
- retryButton.hidden = stale === null;
110
+ meta.textContent = stale ? `更新失败:${stale}` : changed ? '文件已变化' : metaText;
111
+ meta.title = stale ?? (changed ? '点「重载」按新内容重新播放' : metaTitle);
112
+ meta.classList.toggle('warn', stale !== null || changed);
113
+ retryButton.hidden = stale === null && !changed;
114
+ retryButton.textContent = !stale && changed ? '重载' : '重试';
107
115
  };
108
- const setMeta = (text, title = '') => { metaText = text; metaTitle = title; stale = null; paintMeta(); };
116
+ const setMeta = (text, title = '') => { metaText = text; metaTitle = title; stale = null; changed = false; paintMeta(); };
109
117
  const setStale = reason => { stale = reason; paintMeta(); };
110
- const revoke = () => { if (objectUrl) URL.revokeObjectURL(objectUrl); objectUrl = null; };
118
+ let player = null; // 正在显示的音视频或图片元素
119
+ let viewer = null; // 正在显示的 3D 模型视图:revoke 释放它,stop 只停加载和动画
120
+ let mode = '3d', offersText = false; // 模型文件现在看 3D 还是文本;内容是文本的才有切换(换文件时都回到初始)
121
+ const paintMode = () => {
122
+ modeBar.hidden = !offersText;
123
+ for (const { value, button } of modes) button.setAttribute('aria-pressed', String(mode === value));
124
+ };
125
+ function setMode(next) {
126
+ if (path === null || mode === next) return;
127
+ mode = next;
128
+ paintMode();
129
+ load(false);
130
+ }
131
+ const stopMedia = () => {
132
+ if (!player) return;
133
+ player.pause?.(); player.removeAttribute('src'); player.load?.();
134
+ player = null;
135
+ };
136
+ const revoke = () => { stopMedia(); viewer?.dispose(); viewer = null; if (objectUrl) URL.revokeObjectURL(objectUrl); objectUrl = null; };
111
137
  const notice = (title, detail, action) => body.replaceChildren(h('div', { class: 'empty' },
112
138
  h('p', {}, title), detail ? h('p', { class: 'secondary' }, detail) : null,
113
139
  action ? h('button', { class: 'link', onclick: action.run }, action.label) : null));
@@ -157,18 +183,85 @@ export function mountPreview(el, { read, copy, actions = [], copyInHead = true,
157
183
 
158
184
  function failure(error, silent, retry) {
159
185
  if (error.stale) return;
160
- if (error.code === ErrorCode.NOT_FOUND) { shown = null; textShown = false; find.clearContent(); setMeta(' '); return notice('文件已不存在', path); }
186
+ // 文件没了(后台刷新发现):先释放,正文被换掉后,播放中的音视频和 3D 的画布不能继续占着。
187
+ if (error.code === ErrorCode.NOT_FOUND) { revoke(); shown = null; textShown = false; find.clearContent(); setMeta(' '); return notice('文件已不存在', path); }
161
188
  if (silent && shown) return setStale(error.message); // 后台刷新失败:保留正文,提示原因
162
189
  textShown = false;
163
190
  find.clearContent(); // 整页重读失败:标记清掉,计数写「—」,之后再读成功就重新找
164
191
  notice('读不到这个文件', error.message, { label: '重试', run: retry });
165
192
  }
166
193
 
194
+ const mediaMeta = size => [path.includes('/') ? path.slice(0, path.lastIndexOf('/')) : '', formatSize(size)];
195
+ const line = parts => parts.filter(Boolean).join(' · ');
196
+ const setMetaText = (text, title) => { metaText = text; metaTitle = title; paintMeta(); }; // 只换文字(时长到了),不清更新失败和文件已变化的提示
197
+ const unplayable = (size, mtimeMs, title) => {
198
+ stopMedia();
199
+ notice(title, `${formatSize(size)},修改于 ${formatTime(mtimeMs)}`);
200
+ };
201
+
202
+ // 图片和音视频:地址指向模块的流式服务,元素自己按需取,不经分块读取(第 20 节)。
203
+ function showMedia(kind, { token: key, size, mtimeMs }) {
204
+ revoke();
205
+ textShown = false; find.close(); pendingFind = null;
206
+ shown = { size, mtimeMs };
207
+ const parts = mediaMeta(size), title = `修改于 ${formatTime(mtimeMs)}`;
208
+ setMeta(line(parts), title);
209
+ const el = kind === 'image' ? h('img', { alt: path, draggable: 'false' }) : h(kind, { controls: '', playsinline: '', preload: 'metadata' });
210
+ el.addEventListener('error', () => { if (player === el) unplayable(size, mtimeMs, '这台设备放不了这种格式'); });
211
+ if (kind !== 'image') el.addEventListener('loadedmetadata', () => { if (player === el && Number.isFinite(el.duration)) setMetaText(line([...parts, formatDuration(el.duration)]), title); });
212
+ player = el;
213
+ body.replaceChildren(h('div', { class: kind === 'image' ? 'image' : 'media' }, el));
214
+ el.src = `coda-view://service/media/${key}/${path.split('/').map(encodeURIComponent).join('/')}?v=${size}-${mtimeMs}`;
215
+ }
216
+
217
+ // 3D 模型:查看器自己取字节、解析、渲染(第 21 节)。
218
+ function showModel({ token: key, size, mtimeMs }) {
219
+ revoke();
220
+ textShown = false; find.close(); pendingFind = null;
221
+ shown = { size, mtimeMs };
222
+ const parts = mediaMeta(size), title = `修改于 ${formatTime(mtimeMs)}`;
223
+ setMeta(line(parts), title);
224
+ const mine = viewer = mountModel({ body, token: key, path, size, version: `${size}-${mtimeMs}`, onMeta: extra => { if (viewer === mine) setMetaText(line([...parts, ...extra]), title); } });
225
+ }
226
+
227
+ // 媒体文件(按扩展名):返回 true 表示已经处理(显示、提示或已作废),false 表示这个文件走分块读取(宿主没有流式服务时的图片和模型,模型选了看文本时)。
228
+ // 刷新不打断播放:音视频和模型变了只在元信息行提示「文件已变化」,点「重载」才换;图片和提示页变了直接换。
229
+ async function loadMedia({ kind, preview }, silent, mark) {
230
+ if (kind === 'model' && mode === 'text') return false;
231
+ const granted = await media(path);
232
+ if (!mark()) return true;
233
+ const { token: key, size, mtimeMs } = granted;
234
+ if (key === null && preview && (kind === 'image' || kind === 'model')) return false;
235
+ if (silent && shown) {
236
+ if (shown.size === size && shown.mtimeMs === mtimeMs) { changed = false; setStale(null); return true; }
237
+ if ((player && kind !== 'image') || (viewer && kind === 'model')) { changed = true; paintMeta(); return true; }
238
+ }
239
+ if (kind === 'model') { // 内容是不是文本,用模块现有的判断(读第一块);不经查看器,没有 WebGL 的设备上文本模型也能切到文本看
240
+ const first = mayBeText(path) ? await read(path, 0) : null;
241
+ if (!mark()) return true; // 先核对作废,再动共享状态
242
+ offersText = first !== null && offersTextView(path, first.kind);
243
+ paintMode();
244
+ }
245
+ const keep = carry?.scroll ?? (silent ? { top: body.scrollTop, left: body.scrollLeft } : { top: 0, left: 0 });
246
+ if (preview && key !== null) { if (kind === 'model') showModel(granted); else showMedia(kind, granted); } else {
247
+ revoke();
248
+ textShown = false; find.close(); pendingFind = null;
249
+ shown = { size, mtimeMs };
250
+ setMeta(line(mediaMeta(size)), `修改于 ${formatTime(mtimeMs)}`);
251
+ unplayable(size, mtimeMs, preview ? '这个版本的 Coda 不能预览音视频' : '这种格式不能预览');
252
+ }
253
+ body.scrollTop = keep.top; body.scrollLeft = keep.left;
254
+ settle(true);
255
+ return true;
256
+ }
257
+
167
258
  // silent:刷新。没变化不重画;变了就换内容,并尽量留在原来的滚动位置;有待恢复的位置时用它。
168
259
  async function load(silent) {
169
260
  const mine = ++token, mark = () => mine === token;
170
261
  if (!silent) { shown = null; textShown = false; find.clearContent(); setMeta('读取中…'); revoke(); body.replaceChildren(); }
171
262
  try {
263
+ const kind = media && mediaOf(path);
264
+ if (kind && await loadMedia(kind, silent, mark)) return;
172
265
  const result = await readFile(offset => read(path, offset), {
173
266
  prev: silent ? shown : null, cancelled: () => !mark(),
174
267
  onProgress: (got, total) => { if (mark() && !silent && total > TEXT_LIMIT / 4) setMeta(`读取中 ${formatSize(got)} / ${formatSize(total)}`); },
@@ -192,6 +285,7 @@ export function mountPreview(el, { read, copy, actions = [], copyInHead = true,
192
285
  settle(false);
193
286
  if (next !== path) find.close(); // 换了文件就关查找,不靠调用方先 stop()
194
287
  opens++;
288
+ if (next !== path) { mode = '3d'; offersText = false; paintMode(); } // 换了文件:回到 3D,切换等读到内容再决定有没有
195
289
  path = next;
196
290
  const base = next.split('/').pop();
197
291
  name.textContent = base;
@@ -206,7 +300,7 @@ export function mountPreview(el, { read, copy, actions = [], copyInHead = true,
206
300
  // 内容的来源变了(根目录换了位置):旧正文不能留,也不能按元数据判断「没变」。
207
301
  reload() { find.close(); return path === null ? undefined : load(false); }, // 来源变了:查找也关
208
302
  // 停止(逻辑关闭,立即):不再读、不再刷新,待恢复的位置结算;画面(正文、图片的 URL)留着,由 release 在退场结束时清掉。
209
- stop() { settle(false); token++; path = null; shown = null; textShown = false; find.close(); stoppedAt = opens; },
303
+ stop() { settle(false); player?.pause?.(); viewer?.cancel(); token++; path = null; shown = null; textShown = false; find.close(); stoppedAt = opens; },
210
304
  // 释放(画面):停止之后又打开过就什么都不做。
211
305
  release() {
212
306
  if (stoppedAt !== opens) return; // 停止之后又打开过(打开次数变了):这一屏是新的,不是退场的旧页
package/view/protocol.mjs CHANGED
@@ -19,16 +19,16 @@ export const SEARCH_RESULTS = 500;
19
19
 
20
20
  export const Type = Object.freeze({
21
21
  HELLO: 'hello', REFRESH: 'refresh', LIST: 'list', READ: 'read', STAT: 'stat', DIR_SIZE: 'dir_size', ADD_TEXT: 'add_text',
22
- SEARCH: 'search',
22
+ SEARCH: 'search', MEDIA: 'media',
23
23
  DIR_SIZE_CANCEL: 'dir_size_cancel', SEARCH_CANCEL: 'search_cancel', // 没有回答
24
24
  SESSION: 'session', ROOT: 'root', CHANGED: 'changed',
25
- LISTED: 'listed', CHUNK: 'chunk', STATTED: 'statted', SIZED: 'sized', ADDED: 'added', SEARCHED: 'searched',
25
+ LISTED: 'listed', CHUNK: 'chunk', STATTED: 'statted', SIZED: 'sized', ADDED: 'added', SEARCHED: 'searched', MEDIA_GRANTED: 'media_granted',
26
26
  });
27
27
 
28
28
  // 请求 → 回答的类型。模块回答、页面分发都查这一张。
29
29
  export const ReplyOf = Object.freeze({
30
30
  [Type.LIST]: Type.LISTED, [Type.READ]: Type.CHUNK, [Type.STAT]: Type.STATTED,
31
- [Type.DIR_SIZE]: Type.SIZED, [Type.ADD_TEXT]: Type.ADDED, [Type.SEARCH]: Type.SEARCHED,
31
+ [Type.DIR_SIZE]: Type.SIZED, [Type.ADD_TEXT]: Type.ADDED, [Type.SEARCH]: Type.SEARCHED, [Type.MEDIA]: Type.MEDIA_GRANTED,
32
32
  });
33
33
  export const isReply = type => Object.values(ReplyOf).includes(type);
34
34
 
@@ -64,6 +64,41 @@ export function imageType(name) {
64
64
  return dot < 0 ? null : IMAGE_TYPES[name.slice(dot + 1).toLowerCase()] ?? null;
65
65
  }
66
66
 
67
+ // 音视频和图片走模块的本机流式服务(设计见 docs/design/phase-3.md 第 20 节):扩展名 → [种类, MIME 类型],页面决定怎么显示、模块决定服务哪些,都查这一张。
68
+ const MEDIA_TYPES = {
69
+ mp3: ['audio', 'audio/mpeg'], m4a: ['audio', 'audio/mp4'], aac: ['audio', 'audio/aac'], wav: ['audio', 'audio/wav'], flac: ['audio', 'audio/flac'],
70
+ ogg: ['audio', 'audio/ogg'], opus: ['audio', 'audio/ogg'], aiff: ['audio', 'audio/aiff'], aif: ['audio', 'audio/aiff'], caf: ['audio', 'audio/x-caf'],
71
+ mp4: ['video', 'video/mp4'], m4v: ['video', 'video/x-m4v'], mov: ['video', 'video/quicktime'], webm: ['video', 'video/webm'],
72
+ png: ['image', 'image/png'], jpg: ['image', 'image/jpeg'], jpeg: ['image', 'image/jpeg'], gif: ['image', 'image/gif'], webp: ['image', 'image/webp'],
73
+ svg: ['image', 'image/svg+xml'], avif: ['image', 'image/avif'], heic: ['image', 'image/heic'], heif: ['image', 'image/heif'],
74
+ bmp: ['image', 'image/bmp'], tif: ['image', 'image/tiff'], tiff: ['image', 'image/tiff'],
75
+ // 3D 模型(第 21 节):页面用 three.js 画,字节同样经流式服务取。
76
+ glb: ['model', 'model/gltf-binary'], gltf: ['model', 'model/gltf+json'], stl: ['model', 'model/stl'], obj: ['model', 'model/obj'],
77
+ ply: ['model', 'model/ply'], '3mf': ['model', 'model/3mf'],
78
+ };
79
+ // 模型的伴随文件:服务要供应(gltf 的 .bin、obj 的 .mtl),但页面不把它们当媒体预览(.mtl 仍是文本,.bin 仍是二进制)。
80
+ const COMPANION_TYPES = { bin: 'application/octet-stream', mtl: 'text/plain; charset=utf-8' };
81
+ // 查证过 Coda 播放器不支持的视频:按扩展名直接不预览,不读字节(mkv 容器不支持,avi 的 canPlayType 说 maybe 但实际报错)。
82
+ const NO_PREVIEW = new Set(['mkv', 'avi']);
83
+
84
+ // 按扩展名给出 { kind: 'audio' | 'video' | 'image' | 'model', type, preview };不是媒体文件返回 null。preview 为 false 的没有 type,不经服务。
85
+ export function mediaOf(name) {
86
+ const dot = String(name).lastIndexOf('.');
87
+ if (dot < 0) return null;
88
+ const ext = name.slice(dot + 1).toLowerCase();
89
+ if (NO_PREVIEW.has(ext)) return { kind: 'video', type: null, preview: false };
90
+ const entry = MEDIA_TYPES[ext];
91
+ return entry ? { kind: entry[0], type: entry[1], preview: true } : null;
92
+ }
93
+
94
+ // 流式服务肯供应的文件的 MIME 类型:能预览的媒体加上模型的伴随文件;其余返回 null(服务回 415)。
95
+ export function servedType(name) {
96
+ const media = mediaOf(name);
97
+ if (media) return media.preview ? media.type : null;
98
+ const dot = String(name).lastIndexOf('.');
99
+ return dot < 0 ? null : COMPANION_TYPES[name.slice(dot + 1).toLowerCase()] ?? null;
100
+ }
101
+
67
102
  // 相对路径的规则只在这一处:模块(lib/paths.mjs)校验请求,页面恢复保存的 cwd 时用同一个函数。
68
103
  // 空串是根目录;拒绝过长、控制字符、绝对路径和 `..`。返回 { segments }(去掉空段和 `.`)或 { problem }(给人看的原因)。
69
104
  export const MAX_PATH = 4096;
package/view/style.css CHANGED
@@ -176,6 +176,24 @@ button.icon svg { display: block; }
176
176
  .code .text .hljs-addition { color: var(--hl-addition); }
177
177
  .code .text .hljs-deletion { color: var(--hl-deletion); }
178
178
  .code .text .hljs-section { color: var(--hl-section); }
179
+ .media { display: grid; place-items: start center; padding: 12px; }
180
+ .media video { width: 100%; max-height: 70vh; border-radius: var(--coda-radius, 6px); background: #000; }
181
+ .media audio { width: 100%; }
182
+ /* 3D 模型(第 21 节):正文不滚动,整块是画布;状态、复位和动画控制浮在画布上。「3D / 文本」切换在头部。 */
183
+ .pmode { flex: none; display: flex; gap: 2px; }
184
+ .pmode button { padding: 2px 8px; border-radius: var(--coda-radius, 6px); }
185
+ .pmode button[aria-pressed="true"] { background: var(--coda-selection, var(--hover)); font-weight: 600; }
186
+ .pbody.model { display: flex; flex-direction: column; overflow: hidden; }
187
+ .mview { flex: 1 1 auto; min-height: 0; display: flex; flex-direction: column; }
188
+ .mstage { position: relative; flex: 1 1 auto; min-height: 160px; overflow: hidden; background: var(--coda-secondary-background, rgba(127,127,127,.08)); }
189
+ .mcanvas { position: absolute; inset: 0; width: 100%; height: 100%; display: block; outline: none; -webkit-user-select: none; user-select: none; -webkit-touch-callout: none; }
190
+ .mstatus { position: absolute; inset: 0; display: grid; align-content: center; justify-items: center; gap: 6px; padding: 20px; text-align: center; pointer-events: none; }
191
+ .mstatus[hidden] { display: none; }
192
+ .mstatus button { pointer-events: auto; }
193
+ .mbtn, .mclip { padding: 4px 10px; border-radius: var(--coda-radius, 6px); background: var(--coda-card, var(--coda-background, #fff)); border: 1px solid var(--line); color: var(--coda-accent, #0a84ff); }
194
+ .mreset { position: absolute; top: 8px; right: 8px; }
195
+ .mbar { position: absolute; left: 8px; bottom: 8px; display: flex; gap: 8px; }
196
+ .mbar[hidden], .mclip[hidden] { display: none; }
179
197
  .image { display: grid; place-items: start center; padding: 12px; }
180
198
  .image img { max-width: 100%; height: auto; border-radius: var(--coda-radius, 6px); background: var(--coda-secondary-background, transparent); }
181
199