@coda-console/resource-manager 0.8.1 → 0.9.0

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 插件:会话旁的文件浏览器。浏览这个会话的工作目录,读文本、图片、音频和视频,把路径交给对话。只读。
4
4
 
5
5
  - **Mac**:在会话侧栏里,和对话并排。
6
6
  - **iPhone**:在会话右上角菜单里打开,点文件在资源页里切到预览,系统返回(左上「‹」、左边缘侧滑)回到打开它的那一层。iPad 和 iPhone Duo 用同一套界面,没有单独适配。
@@ -12,7 +12,8 @@ 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),音视频不预览。
16
17
  - 代码按语言上色:三十多种常见语言,只按文件名和扩展名认,不猜内容,深浅各一套配色;认不出的显示纯文本。超过 128 KiB 的文件不上色,说明区注明「不高亮」。用的是近似的语法规则,不是语法检查,个别文件会认错(如 `.h` 一律按 C++,`.m` 一律按 Objective-C),不保证完整支持。
17
18
  - Agent 一轮结束后,已展开的目录和正在看的文件自动更新。
18
19
  - 每行带修改日期和大小:Mac 在名字右边(按日期排序时显示日期,否则显示大小,侧栏很窄时隐藏),iPhone 在名字下面一行。右键或长按的菜单里有大小和完整修改时间。文件夹不显示大小(列表和菜单都没有),只有修改日期。
package/lib/media.mjs ADDED
@@ -0,0 +1,79 @@
1
+ // 音视频和图片的本机流式服务(设计见 docs/design/phase-3.md 第 20 节):页面的 <audio>、<video>、<img> 指向 coda-view://service/media/<口令>/<相对路径>。
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, mediaOf } from '../view/protocol.mjs';
8
+ import { fromFsError, resolveInRoot } from './paths.mjs';
9
+
10
+ const NOFOLLOW = constants.O_NOFOLLOW ?? 0;
11
+
12
+ const STATUS = {
13
+ [ErrorCode.INVALID_PATH]: 400, [ErrorCode.OUTSIDE_ROOT]: 403, [ErrorCode.DENIED]: 403,
14
+ [ErrorCode.NOT_FOUND]: 404, [ErrorCode.NOT_DIR]: 404, [ErrorCode.NOT_FILE]: 404,
15
+ };
16
+
17
+ // 'bytes=a-b' | 'bytes=a-' | 'bytes=-n' → { start, end }(含 end);不认得的写法(含多段)当作没带 Range,越界返回 'bad'。
18
+ function parseRange(header, size) {
19
+ const m = /^bytes=(\d*)-(\d*)$/.exec(header ?? '');
20
+ if (!m || (m[1] === '' && m[2] === '')) return null;
21
+ let start, end;
22
+ if (m[1] === '') { start = Math.max(0, size - Number(m[2])); end = size - 1; } else {
23
+ start = Number(m[1]); end = m[2] === '' ? size - 1 : Math.min(Number(m[2]), size - 1);
24
+ }
25
+ return start > end || start >= size ? 'bad' : { start, end };
26
+ }
27
+
28
+ export function createMedia() {
29
+ const grants = new Map(); // 口令 → 根目录
30
+
31
+ const grant = root => {
32
+ const token = randomUUID().replaceAll('-', '');
33
+ grants.set(token, root);
34
+ return token;
35
+ };
36
+ const revoke = token => { if (token) grants.delete(token); };
37
+
38
+ async function handler(req, res) {
39
+ const end = status => { res.writeHead(status, { 'content-type': 'text/plain; charset=utf-8' }); res.end(); };
40
+ if (req.method !== 'GET' && req.method !== 'HEAD') return end(405);
41
+ const [, token, ...rest] = new URL(req.url, 'http://x').pathname.split('/');
42
+ const root = grants.get(token);
43
+ if (root === undefined) return end(404);
44
+ let path;
45
+ try { path = rest.map(decodeURIComponent).join('/'); } catch { return end(400); }
46
+ const media = mediaOf(path);
47
+ if (!media?.preview) return end(415);
48
+ let handle;
49
+ try {
50
+ handle = await open(await resolveInRoot(root, path), constants.O_RDONLY | NOFOLLOW);
51
+ const info = await handle.stat();
52
+ if (!info.isFile()) return end(404);
53
+ const { size } = info;
54
+ // 不缓存:每次都问(no-cache);内容没变回 304,续传带的 If-Range 对不上就整份重来。
55
+ const etag = `"${size}-${Math.floor(info.mtimeMs)}"`;
56
+ const headers = { 'content-type': media.type, 'accept-ranges': 'bytes', etag, 'cache-control': 'no-cache' };
57
+ if (String(req.headers['if-none-match'] ?? '').split(',').some(tag => tag.trim().replace(/^W\//, '') === etag)) {
58
+ res.writeHead(304, { etag, 'cache-control': 'no-cache' });
59
+ return res.end();
60
+ }
61
+ const ifRange = req.headers['if-range'];
62
+ const range = ifRange && ifRange !== etag ? null : parseRange(req.headers.range, size);
63
+ if (range === 'bad') { res.writeHead(416, { 'content-range': `bytes */${size}` }); return res.end(); }
64
+ const [status, start, last] = range ? [206, range.start, range.end] : [200, 0, size - 1];
65
+ if (range) headers['content-range'] = `bytes ${start}-${last}/${size}`;
66
+ headers['content-length'] = String(size === 0 ? 0 : last - start + 1);
67
+ res.writeHead(status, headers);
68
+ if (req.method === 'HEAD' || size === 0) return res.end();
69
+ // 客户端中途断开:pipeline 随 res 关闭销毁读流。
70
+ await pipeline(handle.createReadStream({ start, end: last, autoClose: false }), res).catch(() => {});
71
+ } catch (error) {
72
+ // 被 O_NOFOLLOW 拒绝说明校验后被换成了链接,同读文本按越界处理。
73
+ const code = NOFOLLOW && (error?.code === 'ELOOP' || error?.code === 'EMLINK') ? ErrorCode.OUTSIDE_ROOT : fromFsError(error).code;
74
+ if (!res.headersSent) end(STATUS[code] ?? 500); else res.destroy();
75
+ } finally { await handle?.close().catch(() => {}); }
76
+ }
77
+
78
+ return { handler, grant, revoke };
79
+ }
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": "会话旁的只读文件浏览器:浏览会话工作目录,预览文本、图片、音频和视频,把路径交给对话。",
6
+ "version": "0.9.0",
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);
package/view/preview.mjs CHANGED
@@ -1,11 +1,11 @@
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
10
 
11
11
  function fromBase64(data) {
@@ -63,13 +63,15 @@ export const lineCount = text => (text === '' ? 1 : text.split('\n').length - (t
63
63
  // 页面只负责入口:canFind(有显示着的文本才有)、openFind()(⌘F、iPhone 的「查找」菜单项)。consumed(event):这个按键已经被菜单消费了(菜单开着时的 Esc)。
64
64
  // selectionMenu(event, { path, text, startLine, endLine }):给了就接管正文里选中文字的右键(只有 Mac 传);预览不知道菜单里是什么。
65
65
  // 选区为空、或裁到正文里之后为空时不接管,走系统默认。内容和行号在这里取好,交出去之后和选区无关。
66
- export function mountPreview(el, { read, copy, actions = [], copyInHead = true, back = null, selectionMenu = null, consumed = () => false }) {
66
+ // media(path) → Promise<{ token, size, mtimeMs }>(第 20 节):音视频和图片经模块的本机流式服务显示,token 是这个视图的口令;token 为 null 表示宿主没有流式服务。
67
+ // 不传 media 就一律走分块读取(直接挂载预览的测试用)。
68
+ export function mountPreview(el, { read, copy, actions = [], copyInHead = true, back = null, selectionMenu = null, consumed = () => false, media = null }) {
67
69
  const name = h('div', { class: 'pname truncate' }), meta = h('div', { class: 'pmeta caption secondary truncate' }, ' ');
68
70
  const fileIcon = h('span', { class: 'pico', 'aria-hidden': 'true' });
69
71
  // 图标按钮:可访问名称和 Mac 的悬停提示都是 label;没有图标的退回文字。
70
72
  const action = (label, glyph, run) => h('button', { class: glyph ? 'icon' : 'link', 'aria-label': label, title: label, onclick: run }, glyph ? icon(glyph, 18) : label);
71
73
  const copyPath = () => path !== null && copy(path);
72
- const retryButton = h('button', { class: 'link', onclick: () => load(true), hidden: true }, '重试');
74
+ const retryButton = h('button', { class: 'link', onclick: () => load(!changed), hidden: true }, '重试');
73
75
  const body = h('div', { class: 'pbody', tabindex: '-1' }); // 可聚焦:关查找条后焦点回正文
74
76
  let gutterEl = null;
75
77
  const find = createFind({ body, gutterWidth: () => gutterEl?.offsetWidth ?? 0 });
@@ -97,17 +99,24 @@ export function mountPreview(el, { read, copy, actions = [], copyInHead = true,
97
99
  let opens = 0, stoppedAt = -1; // 打开次数和上一次停止时的次数:释放只在停止之后没有再打开过时才做(返回的退场还没结束又打开了)
98
100
  let carry = null; // 待恢复的位置 { scroll, settle }:open 带进来,读取真正用上或作废后才清
99
101
  const settle = used => { const c = carry; carry = null; c?.settle(used); };
100
- let metaText = ' ', metaTitle = '', stale = null; // stale:后台刷新失败的原因,此时正文还是上次的
101
- // 更新失败的提示占用元信息那一行,重试按钮在头部,所以正文不会被顶动。
102
+ let metaText = ' ', metaTitle = '', stale = null, changed = false; // stale:后台刷新失败的原因,此时正文还是上次的;changed:正在播放的文件变了,等用户点「重载」
103
+ // 更新失败和文件已变化的提示占用元信息那一行,重试(重载)按钮在头部,所以正文不会被顶动。
102
104
  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;
105
+ meta.textContent = stale ? `更新失败:${stale}` : changed ? '文件已变化' : metaText;
106
+ meta.title = stale ?? (changed ? '点「重载」按新内容重新播放' : metaTitle);
107
+ meta.classList.toggle('warn', stale !== null || changed);
108
+ retryButton.hidden = stale === null && !changed;
109
+ retryButton.textContent = !stale && changed ? '重载' : '重试';
107
110
  };
108
- const setMeta = (text, title = '') => { metaText = text; metaTitle = title; stale = null; paintMeta(); };
111
+ const setMeta = (text, title = '') => { metaText = text; metaTitle = title; stale = null; changed = false; paintMeta(); };
109
112
  const setStale = reason => { stale = reason; paintMeta(); };
110
- const revoke = () => { if (objectUrl) URL.revokeObjectURL(objectUrl); objectUrl = null; };
113
+ let player = null; // 正在显示的音视频或图片元素
114
+ const stopMedia = () => {
115
+ if (!player) return;
116
+ player.pause?.(); player.removeAttribute('src'); player.load?.();
117
+ player = null;
118
+ };
119
+ const revoke = () => { stopMedia(); if (objectUrl) URL.revokeObjectURL(objectUrl); objectUrl = null; };
111
120
  const notice = (title, detail, action) => body.replaceChildren(h('div', { class: 'empty' },
112
121
  h('p', {}, title), detail ? h('p', { class: 'secondary' }, detail) : null,
113
122
  action ? h('button', { class: 'link', onclick: action.run }, action.label) : null));
@@ -164,11 +173,61 @@ export function mountPreview(el, { read, copy, actions = [], copyInHead = true,
164
173
  notice('读不到这个文件', error.message, { label: '重试', run: retry });
165
174
  }
166
175
 
176
+ const mediaMeta = size => [path.includes('/') ? path.slice(0, path.lastIndexOf('/')) : '', formatSize(size)];
177
+ const line = parts => parts.filter(Boolean).join(' · ');
178
+ const setMetaText = (text, title) => { metaText = text; metaTitle = title; paintMeta(); }; // 只换文字(时长到了),不清更新失败和文件已变化的提示
179
+ const unplayable = (size, mtimeMs, title) => {
180
+ stopMedia();
181
+ notice(title, `${formatSize(size)},修改于 ${formatTime(mtimeMs)}`);
182
+ };
183
+
184
+ // 图片和音视频:地址指向模块的流式服务,元素自己按需取,不经分块读取(第 20 节)。
185
+ function showMedia(kind, { token: key, size, mtimeMs }) {
186
+ revoke();
187
+ textShown = false; find.close(); pendingFind = null;
188
+ shown = { size, mtimeMs };
189
+ const parts = mediaMeta(size), title = `修改于 ${formatTime(mtimeMs)}`;
190
+ setMeta(line(parts), title);
191
+ const el = kind === 'image' ? h('img', { alt: path, draggable: 'false' }) : h(kind, { controls: '', playsinline: '', preload: 'metadata' });
192
+ el.addEventListener('error', () => { if (player === el) unplayable(size, mtimeMs, '这台设备放不了这种格式'); });
193
+ if (kind !== 'image') el.addEventListener('loadedmetadata', () => { if (player === el && Number.isFinite(el.duration)) setMetaText(line([...parts, formatDuration(el.duration)]), title); });
194
+ player = el;
195
+ body.replaceChildren(h('div', { class: kind === 'image' ? 'image' : 'media' }, el));
196
+ el.src = `coda-view://service/media/${key}/${path.split('/').map(encodeURIComponent).join('/')}?v=${size}-${mtimeMs}`;
197
+ }
198
+
199
+ // 媒体文件(按扩展名):返回 true 表示已经处理(显示、提示或已作废),false 表示这个文件走分块读取(宿主没有流式服务时的图片)。
200
+ // 刷新不打断播放:音视频变了只在元信息行提示「文件已变化」,点「重载」才换;图片和提示页变了直接换。
201
+ async function loadMedia({ kind, preview }, silent, mark) {
202
+ const granted = await media(path);
203
+ if (!mark()) return true;
204
+ const { token: key, size, mtimeMs } = granted;
205
+ if (key === null && preview && kind === 'image') return false;
206
+ if (silent && shown) {
207
+ if (shown.size === size && shown.mtimeMs === mtimeMs) { changed = false; setStale(null); return true; }
208
+ if (player && kind !== 'image') { changed = true; paintMeta(); return true; }
209
+ }
210
+ const keep = carry?.scroll ?? (silent ? { top: body.scrollTop, left: body.scrollLeft } : { top: 0, left: 0 });
211
+ if (preview && key !== null) showMedia(kind, granted);
212
+ else {
213
+ revoke();
214
+ textShown = false; find.close(); pendingFind = null;
215
+ shown = { size, mtimeMs };
216
+ setMeta(line(mediaMeta(size)), `修改于 ${formatTime(mtimeMs)}`);
217
+ unplayable(size, mtimeMs, preview ? '这个版本的 Coda 不能预览音视频' : '这种格式不能预览');
218
+ }
219
+ body.scrollTop = keep.top; body.scrollLeft = keep.left;
220
+ settle(true);
221
+ return true;
222
+ }
223
+
167
224
  // silent:刷新。没变化不重画;变了就换内容,并尽量留在原来的滚动位置;有待恢复的位置时用它。
168
225
  async function load(silent) {
169
226
  const mine = ++token, mark = () => mine === token;
170
227
  if (!silent) { shown = null; textShown = false; find.clearContent(); setMeta('读取中…'); revoke(); body.replaceChildren(); }
171
228
  try {
229
+ const kind = media && mediaOf(path);
230
+ if (kind && await loadMedia(kind, silent, mark)) return;
172
231
  const result = await readFile(offset => read(path, offset), {
173
232
  prev: silent ? shown : null, cancelled: () => !mark(),
174
233
  onProgress: (got, total) => { if (mark() && !silent && total > TEXT_LIMIT / 4) setMeta(`读取中 ${formatSize(got)} / ${formatSize(total)}`); },
@@ -206,7 +265,7 @@ export function mountPreview(el, { read, copy, actions = [], copyInHead = true,
206
265
  // 内容的来源变了(根目录换了位置):旧正文不能留,也不能按元数据判断「没变」。
207
266
  reload() { find.close(); return path === null ? undefined : load(false); }, // 来源变了:查找也关
208
267
  // 停止(逻辑关闭,立即):不再读、不再刷新,待恢复的位置结算;画面(正文、图片的 URL)留着,由 release 在退场结束时清掉。
209
- stop() { settle(false); token++; path = null; shown = null; textShown = false; find.close(); stoppedAt = opens; },
268
+ stop() { settle(false); player?.pause?.(); token++; path = null; shown = null; textShown = false; find.close(); stoppedAt = opens; },
210
269
  // 释放(画面):停止之后又打开过就什么都不做。
211
270
  release() {
212
271
  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,28 @@ 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
+ };
76
+ // 查证过 Coda 播放器不支持的视频:按扩展名直接不预览,不读字节(mkv 容器不支持,avi 的 canPlayType 说 maybe 但实际报错)。
77
+ const NO_PREVIEW = new Set(['mkv', 'avi']);
78
+
79
+ // 按扩展名给出 { kind: 'audio' | 'video' | 'image', type, preview };不是媒体文件返回 null。preview 为 false 的没有 type,不经服务。
80
+ export function mediaOf(name) {
81
+ const dot = String(name).lastIndexOf('.');
82
+ if (dot < 0) return null;
83
+ const ext = name.slice(dot + 1).toLowerCase();
84
+ if (NO_PREVIEW.has(ext)) return { kind: 'video', type: null, preview: false };
85
+ const entry = MEDIA_TYPES[ext];
86
+ return entry ? { kind: entry[0], type: entry[1], preview: true } : null;
87
+ }
88
+
67
89
  // 相对路径的规则只在这一处:模块(lib/paths.mjs)校验请求,页面恢复保存的 cwd 时用同一个函数。
68
90
  // 空串是根目录;拒绝过长、控制字符、绝对路径和 `..`。返回 { segments }(去掉空段和 `.`)或 { problem }(给人看的原因)。
69
91
  export const MAX_PATH = 4096;
package/view/style.css CHANGED
@@ -176,6 +176,9 @@ 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%; }
179
182
  .image { display: grid; place-items: start center; padding: 12px; }
180
183
  .image img { max-width: 100%; height: auto; border-radius: var(--coda-radius, 6px); background: var(--coda-secondary-background, transparent); }
181
184