@coda-console/resource-manager 0.4.0 → 0.6.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 +12 -6
- package/lib/draft.mjs +57 -0
- package/lib/info.mjs +137 -0
- package/lib/paths.mjs +5 -11
- package/lib/tree.mjs +2 -2
- package/main.mjs +50 -15
- package/package.json +1 -1
- package/view/app.mjs +222 -111
- package/view/chat.mjs +49 -0
- package/view/connection.mjs +50 -24
- package/view/dom.mjs +9 -0
- package/view/file-app.mjs +19 -3
- package/view/file.html +2 -0
- package/view/format.mjs +27 -0
- package/view/gestures.mjs +62 -0
- package/view/grid.mjs +213 -0
- package/view/hint.mjs +20 -0
- package/view/icons.mjs +139 -22
- package/view/index.html +3 -0
- package/view/info.mjs +117 -0
- package/view/menu.mjs +195 -0
- package/view/model.mjs +120 -14
- package/view/preview.mjs +15 -11
- package/view/protocol.mjs +28 -2
- package/view/restore.mjs +57 -0
- package/view/selection.mjs +33 -0
- package/view/style.css +85 -24
- package/view/tree.mjs +15 -49
package/README.md
CHANGED
|
@@ -7,14 +7,19 @@ Coda 插件:会话旁的文件浏览器。浏览这个会话的工作目录,
|
|
|
7
7
|
|
|
8
8
|
## 功能
|
|
9
9
|
|
|
10
|
-
-
|
|
10
|
+
- 两种视图:**列表**(目录树,按需展开,超大目录分页显示)和**图标**(一次看一层,每个条目是类型图标加名字,名字最多两行,`package.json` 这样的名字优先在扩展名前折行)。在「更多」菜单(Mac)或「⋯」菜单(iPhone)的「显示」›「视图」里切换,全局一份,两种视图各自保留滚动位置。
|
|
11
|
+
- 图标视图里**单击文件夹进入这一层**,单击文件打开(Mac 在侧栏里切到文件,iPhone 推入文件页);回上一层:iPhone 用系统的返回,Mac 点头部最左边的返回键。**没有预览面板**:只有一个侧栏,不会单击选中再在旁边预览,也没有面包屑。
|
|
11
12
|
- 文本预览(带行号,可跨行选中复制,最多读 1 MiB)和图片预览(PNG、JPEG、GIF、WebP、SVG,最多 8 MiB)。
|
|
12
13
|
- Agent 一轮结束后,已展开的目录和正在看的文件自动更新。
|
|
13
14
|
- 每行带修改日期和大小:Mac 在名字右边(按日期排序时显示日期,否则显示大小,侧栏很窄时隐藏),iPhone 在名字下面一行。右键或长按的菜单里有大小和完整修改时间。文件夹不显示大小(列表和菜单都没有),只有修改日期。
|
|
14
|
-
- 可以按名称、种类、日期、大小排序,在「更多」菜单(Mac)或「⋯」菜单(iPhone
|
|
15
|
+
- 可以按名称、种类、日期、大小排序,在「更多」菜单(Mac)或「⋯」菜单(iPhone)的「显示」›「排序」里选,当前项有对勾。两种视图用同一个排序。每种排序的方向固定:名称、种类升序,日期、大小降序(最新、最大在前),没有升降序切换。超过 2 万条的目录,日期和大小排序不可用,退回按名称并提示。排序全局一份,换了排序滚动位置回到顶部,选当前项什么都不做。
|
|
15
16
|
- 切换会话时换成新会话的内容,切回来恢复展开状态和滚动位置。
|
|
16
|
-
- Mac
|
|
17
|
-
- iPhone
|
|
17
|
+
- 右键(Mac)或长按(iPhone)一行:添加到聊天、复制相对路径、复制绝对路径、属性。「添加到聊天」把相对路径接在输入框已有文字后面;指向工作目录外或已失效的链接、不能打开的条目没有这一项。成功时底部提示「已添加到输入框」,约 2 秒消失;写不进去时改为复制,提示「没能写入输入框,已复制」;剪贴板也写不进去时提示「没能写入,也没能复制」。
|
|
18
|
+
- **选中文字右键(只有 Mac)**:在文件预览(侧栏和独立窗口)里选中文字后右键,有「添加到聊天(内容)」「添加到聊天(位置)」「复制」。位置是 `src/app.ts:12-18`,只选一行时是 `src/app.ts:12`,只精确到行。选中的内容太长放不进一条消息时直接复制,提示「选中内容太长,已复制」。iPhone 用系统自带的选区菜单,不加这一项。
|
|
19
|
+
- 属性页:行菜单里选「属性」,在当前页里打开一层,用系统的返回退出。显示种类、大小、链接到、位置、完整路径、修改和创建时间、权限;文件夹的大小在打开后统计,不跟随链接,最多 20 万项或 5 秒,超出时显示下限(如「超过 3.2 GiB(已统计 20 万项)」),一轮结束后已有的结果标「上次统计」,可以重新统计。
|
|
20
|
+
- **写入输入框用的是 Coda 没有公开的接口**,以后可能失效或改变;失效时「添加到聊天」会改为复制路径或文字。**已知风险**:输入框里的附件还在上传时添加,上传完成后,这段时间里打的字和那个附件可能消失;刚打完字的一瞬间添加,也可能丢掉这几个字。
|
|
21
|
+
- Mac:把文件拖到输入框也行;预览可以开到独立窗口;工具栏只有一个「更多」按钮,按下弹出菜单:刷新、显示隐藏文件、「显示」›。鼠标移到「显示」或点它,在菜单左边弹出二级菜单(视图和排序);侧栏太窄放不下时,在菜单里切到下一层,顶上一行「返回」。侧栏预览头部最左边的「返回」回到目录树或图标视图。
|
|
22
|
+
- iPhone:长按出同样的菜单;目录树页(或图标视图)右上角「⋯」里有刷新、显示隐藏文件和「显示」,点「显示」在菜单里切到下一层(视图和排序),顶上一行「返回」;文件页底部工具条有刷新和「复制路径」。
|
|
18
23
|
- 默认隐藏 `.git`、`.DS_Store`,Mac 在工具栏的「更多」菜单里、iPhone 在目录树页右上角的「⋯」里可切换显示全部。
|
|
19
24
|
|
|
20
25
|
只能读这个会话的工作目录。指向工作目录之外的符号链接只显示,不能打开。
|
|
@@ -38,8 +43,8 @@ Coda 插件:会话旁的文件浏览器。浏览这个会话的工作目录,
|
|
|
38
43
|
# 不进 Coda,用假的 window.coda 在浏览器里看真实页面
|
|
39
44
|
"$CODA_NODE" test/harness/server.mjs <会话A的目录> [会话B的目录] [端口]
|
|
40
45
|
|
|
41
|
-
# 真实布局的断言和截图:无头 Chrome 打开 Mac 侧栏、iPhone
|
|
42
|
-
#
|
|
46
|
+
# 真实布局的断言和截图:无头 Chrome 打开 Mac 侧栏、iPhone 竖屏和横屏的目录树、图标视图与文件页(浅色、深色),
|
|
47
|
+
# 量行高、工具条、菜单和二级菜单的位置和尺寸,图标视图的单元格和滚动。自己起服务和临时目录,用完删掉;截图在系统临时目录里,路径在最后打印。
|
|
43
48
|
# 失败时退出码非 0。Chrome 不在默认位置时把路径作参数传入
|
|
44
49
|
"$CODA_NODE" test/harness/layout.mjs [Chrome 的路径]
|
|
45
50
|
|
|
@@ -55,6 +60,7 @@ npx --yes github:coda-console/coda-plugins#<提交> . --manifest
|
|
|
55
60
|
|
|
56
61
|
- [一期设计](docs/design/phase-1.md):消息协议、路径校验和页面规则。
|
|
57
62
|
- [二期设计](docs/design/phase-2.md):iPhone 适配和独立文件视图。
|
|
63
|
+
- [三期设计](docs/design/phase-3.md):文件信息和排序、右键操作和类型图标、图标视图。
|
|
58
64
|
- [可选需求清单](docs/backlog.md):之后可能做的需求。
|
|
59
65
|
- [评审准则](.coda/review.md)。
|
|
60
66
|
|
package/lib/draft.mjs
ADDED
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
// 把文字追加到会话的输入框草稿(设计见 docs/design/phase-3.md 第 13.5 节)。
|
|
2
|
+
// 用的是 Coda 未公开的草稿接口:依赖它的代码只在这一个文件里,上游开放正式接口后只改这里。
|
|
3
|
+
// 流程:读草稿 → 拼文字 → 保存。保存带上现有附件的 ID,否则会删掉用户已添加的附件。
|
|
4
|
+
import { DRAFT_LIMIT, ErrorCode, fail } from '../view/protocol.mjs';
|
|
5
|
+
|
|
6
|
+
const RETRIES = 2; // 版本不符后用服务端的内容重拼,最多再试这么多次
|
|
7
|
+
|
|
8
|
+
// block 为 false(路径、位置):接在现有文字后面,前后各留一个空格(已有空白或为空时前面不加)。
|
|
9
|
+
// block 为 true(内容):另起一行,结尾换行;文字本身已以换行结尾的不再多加,免得多出空行。只能追加到末尾。
|
|
10
|
+
export function compose(current, text, block) {
|
|
11
|
+
if (block) return `${current}${current === '' || current.endsWith('\n') ? '' : '\n'}${text}${text.endsWith('\n') ? '' : '\n'}`;
|
|
12
|
+
return `${current}${current === '' || /\s$/.test(current) ? '' : ' '}${text} `;
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
// 接口路径只在这里写:测试和 harness 的假接口也从这里取。
|
|
16
|
+
export const draftPath = session => `threads/${encodeURIComponent(session)}/draft`;
|
|
17
|
+
// 反过来:路径是草稿接口的返回会话,不是返回 null。
|
|
18
|
+
export function draftSession(path) {
|
|
19
|
+
const match = /^threads\/([^/]+)\/draft$/.exec(path);
|
|
20
|
+
return match ? decodeURIComponent(match[1]) : null;
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
const failed = () => fail(ErrorCode.DRAFT_FAILED, '读写草稿失败');
|
|
24
|
+
|
|
25
|
+
// 接口回答里的草稿 → { text, revision, ids };形状不对算失败。
|
|
26
|
+
function parseDraft(draft) {
|
|
27
|
+
if (typeof draft?.text !== 'string' || !Array.isArray(draft.attachments)) throw failed();
|
|
28
|
+
const ids = draft.attachments.map(attachment => attachment?.id);
|
|
29
|
+
if (!ids.every(id => typeof id === 'string')) throw failed();
|
|
30
|
+
return { text: draft.text, revision: draft.revision, ids };
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
// 追加成功返回 true;valid() 变假(会话换了、视图关了)静默结束,返回 false:不写、不报。
|
|
34
|
+
// 每次保存之前、每个 await 回来之后都核对,重试也始终写传进来的这个会话。
|
|
35
|
+
// 失败抛 draft_failed(保存的回答不带合法的 draft 也算失败),拼完超过上限抛 draft_too_long,不截断。
|
|
36
|
+
export async function addText(coda, session, { text, block }, { valid = () => true } = {}) {
|
|
37
|
+
if (typeof text !== 'string' || text.includes('\0') || typeof block !== 'boolean') throw failed();
|
|
38
|
+
const path = draftPath(session);
|
|
39
|
+
const call = async body => {
|
|
40
|
+
try { return await (body ? coda.api(path, body) : coda.api(path)); } catch { throw failed(); }
|
|
41
|
+
};
|
|
42
|
+
|
|
43
|
+
const first = await call();
|
|
44
|
+
if (!valid()) return false;
|
|
45
|
+
let draft = parseDraft(first);
|
|
46
|
+
for (let attempt = 0; ; attempt++) {
|
|
47
|
+
const next = compose(draft.text, text, block);
|
|
48
|
+
if (next.length > DRAFT_LIMIT) throw fail(ErrorCode.DRAFT_TOO_LONG, '草稿太长,放不下');
|
|
49
|
+
const saved = await call({ text: next, attachments: draft.ids, revision: draft.revision });
|
|
50
|
+
if (!valid()) return false;
|
|
51
|
+
const reply = parseDraft(saved?.draft); // 成功和版本不符的回答都带 draft;没有或形状不对,不能当成已写入
|
|
52
|
+
if (!saved.conflict) return true;
|
|
53
|
+
if (attempt >= RETRIES) throw failed();
|
|
54
|
+
draft = reply;
|
|
55
|
+
if (!valid()) return false;
|
|
56
|
+
}
|
|
57
|
+
}
|
package/lib/info.mjs
ADDED
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
// 属性和文件夹大小(设计见 docs/design/phase-3.md 第 13.3、13.4 节)。
|
|
2
|
+
// 只读:都经视图共用的读取状态(lib/tree.mjs 的 createListing)的 fs 和并发上限,不另起一套。
|
|
3
|
+
import { basename, join, relative, sep } from 'node:path';
|
|
4
|
+
import { EntryKind } from '../view/protocol.mjs';
|
|
5
|
+
import { fromFsError, parseRelative, resolveInRoot } from './paths.mjs';
|
|
6
|
+
import { classifyLink } from './tree.mjs';
|
|
7
|
+
|
|
8
|
+
export const DIR_SIZE_ITEMS = 200_000;
|
|
9
|
+
export const DIR_SIZE_MS = 5000;
|
|
10
|
+
// 一批同时排进并发上限的 lstat 数;等它们回来才排下一批。
|
|
11
|
+
const BATCH = 4;
|
|
12
|
+
|
|
13
|
+
const integer = value => (Number.isFinite(value) ? Math.floor(value) : undefined);
|
|
14
|
+
|
|
15
|
+
// 一个条目自己的元数据:size 只有文件有,读不到的不带。
|
|
16
|
+
function metaOf(info, kind) {
|
|
17
|
+
const meta = {};
|
|
18
|
+
const mtimeMs = integer(info.mtimeMs), birthtimeMs = integer(info.birthtimeMs), mode = integer(info.mode);
|
|
19
|
+
if (kind === EntryKind.FILE && integer(info.size) !== undefined) meta.size = integer(info.size);
|
|
20
|
+
if (mtimeMs !== undefined) meta.mtimeMs = mtimeMs;
|
|
21
|
+
if (birthtimeMs !== undefined && birthtimeMs > 0) meta.birthtimeMs = birthtimeMs; // 0 是文件系统没有这个值
|
|
22
|
+
if (mode !== undefined) meta.mode = mode & 0o7777;
|
|
23
|
+
return meta;
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
const kindOf = info => (info.isDirectory() ? EntryKind.DIR : info.isFile() ? EntryKind.FILE : EntryKind.OTHER);
|
|
27
|
+
|
|
28
|
+
// 先解析父目录,再 lstat 最后一级,不跟随链接。
|
|
29
|
+
// 指向工作目录内的链接按目标显示(target 是目标的相对路径);指向外面或已失效的链接只给自己的元数据,不给目标路径。
|
|
30
|
+
export async function statPath(listing, root, path) {
|
|
31
|
+
const segments = parseRelative(path);
|
|
32
|
+
const { fs } = listing;
|
|
33
|
+
let name, dir, item;
|
|
34
|
+
try {
|
|
35
|
+
if (segments.length === 0) {
|
|
36
|
+
name = basename(root);
|
|
37
|
+
item = { kind: EntryKind.DIR, info: await listing.run(() => fs.lstat(root)) };
|
|
38
|
+
} else {
|
|
39
|
+
name = segments[segments.length - 1];
|
|
40
|
+
dir = await resolveInRoot(root, segments.slice(0, -1).join('/'));
|
|
41
|
+
const own = await listing.run(() => fs.lstat(join(dir, name)));
|
|
42
|
+
if (own.isSymbolicLink()) {
|
|
43
|
+
const linked = await listing.run(() => classifyLink(fs, root, dir, name));
|
|
44
|
+
item = linked.link
|
|
45
|
+
? { kind: linked.kind, info: linked.info, link: true, target: relative(root, linked.real).split(sep).join('/') }
|
|
46
|
+
: { kind: EntryKind.LINK, info: own, link: true };
|
|
47
|
+
} else item = { kind: kindOf(own), info: own };
|
|
48
|
+
}
|
|
49
|
+
} catch (error) { throw fromFsError(error); }
|
|
50
|
+
const { kind, info, link, target } = item;
|
|
51
|
+
const body = { name, kind };
|
|
52
|
+
if (link) body.link = true;
|
|
53
|
+
if (target !== undefined) body.target = target;
|
|
54
|
+
return { ...body, ...metaOf(info, kind) };
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
// 文件夹大小:边读边统计,不一次性为全部条目建任务。
|
|
58
|
+
// - 同一时间只读一个目录,用只取名字的 readdir(不用 opendir、withFileTypes:文件系统不报类型时它们可能同步 lstat)。
|
|
59
|
+
// - lstat 一批最多 BATCH 个,经视图的并发上限排队,等回来才排下一批;排到名额后先核对停止条件再读。
|
|
60
|
+
// - 不跟随链接:链接算一项,不计大小。
|
|
61
|
+
// - 项数到 limit 或用时到 timeoutMs,立刻回答 complete: false,已发出的读取结果不再计入;
|
|
62
|
+
// signal 中止、valid() 为假(会话、根目录变了或视图关了)静默停止,返回 null,不回答。
|
|
63
|
+
// - 5 秒从收到请求算起:计时和取消监听先建,解析起点(resolve,默认 resolveInRoot)与它们竞速;
|
|
64
|
+
// 解析回来先核对 valid() 和 signal,才读。到点还没解析完回答 items: 0、complete: false;解析失败按错误回答。
|
|
65
|
+
// - 子目录读不到、条目 lstat 失败都计入 unreadable;起点读不到才算错误。
|
|
66
|
+
export async function dirSize(listing, root, path, {
|
|
67
|
+
valid = () => true, signal, limit = DIR_SIZE_ITEMS, timeoutMs = DIR_SIZE_MS, resolve: resolvePath = resolveInRoot,
|
|
68
|
+
} = {}) {
|
|
69
|
+
const { fs } = listing;
|
|
70
|
+
const total = { size: 0, items: 0, unreadable: 0 };
|
|
71
|
+
let over = false;
|
|
72
|
+
|
|
73
|
+
return new Promise((resolve, reject) => {
|
|
74
|
+
let timer = null;
|
|
75
|
+
// 结算一次:之后的一切读取结果、定时器、中止都不再有影响。
|
|
76
|
+
const settle = done => {
|
|
77
|
+
if (over) return;
|
|
78
|
+
over = true;
|
|
79
|
+
clearTimeout(timer);
|
|
80
|
+
signal?.removeEventListener('abort', onAbort);
|
|
81
|
+
done();
|
|
82
|
+
};
|
|
83
|
+
const end = result => settle(() => resolve(result));
|
|
84
|
+
const onAbort = () => end(null);
|
|
85
|
+
// 停了没有。valid() 为假或已中止的在这里顺便结算成静默停止。
|
|
86
|
+
const stopped = () => {
|
|
87
|
+
if (over) return true;
|
|
88
|
+
if (signal?.aborted || !valid()) { end(null); return true; }
|
|
89
|
+
return false;
|
|
90
|
+
};
|
|
91
|
+
|
|
92
|
+
if (signal?.aborted) return end(null);
|
|
93
|
+
signal?.addEventListener('abort', onAbort, { once: true });
|
|
94
|
+
timer = setTimeout(() => end({ ...total, complete: false }), timeoutMs);
|
|
95
|
+
|
|
96
|
+
// 数一个条目。读失败的也算一项。
|
|
97
|
+
async function measure(dir, name, dirs) {
|
|
98
|
+
if (stopped()) return; // 排到名额之后先核对
|
|
99
|
+
let info = null;
|
|
100
|
+
try { info = await fs.lstat(join(dir, name)); } catch { /* 下面计入 unreadable */ }
|
|
101
|
+
if (stopped()) return; // 已经停了,回来的结果不再计入
|
|
102
|
+
total.items++;
|
|
103
|
+
if (!info) total.unreadable++;
|
|
104
|
+
else if (info.isDirectory()) dirs.push(join(dir, name));
|
|
105
|
+
else if (info.isFile()) total.size += Math.max(0, Math.floor(info.size) || 0);
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
async function walk() {
|
|
109
|
+
// 解析慢时由计时和中止先结算;这里回来之后 stopped() 再核对一遍,已经停了就不读。
|
|
110
|
+
const start = await resolvePath(root, path);
|
|
111
|
+
if (stopped()) return;
|
|
112
|
+
const dirs = [start]; // 待访问的目录,数量不超过项数上限
|
|
113
|
+
while (dirs.length > 0 && !stopped()) {
|
|
114
|
+
const dir = dirs.pop();
|
|
115
|
+
let names;
|
|
116
|
+
try { names = await fs.readdir(dir); } catch (error) {
|
|
117
|
+
if (dir === start) throw fromFsError(error);
|
|
118
|
+
if (stopped()) return;
|
|
119
|
+
total.unreadable++;
|
|
120
|
+
continue;
|
|
121
|
+
}
|
|
122
|
+
let at = 0;
|
|
123
|
+
while (at < names.length) {
|
|
124
|
+
if (stopped()) return;
|
|
125
|
+
if (total.items >= limit) return end({ ...total, complete: false });
|
|
126
|
+
const batch = names.slice(at, at + Math.min(BATCH, limit - total.items));
|
|
127
|
+
at += batch.length;
|
|
128
|
+
await Promise.all(batch.map(name => listing.run(() => measure(dir, name, dirs))));
|
|
129
|
+
}
|
|
130
|
+
if (!stopped() && total.items >= limit && dirs.length > 0) return end({ ...total, complete: false });
|
|
131
|
+
}
|
|
132
|
+
end({ ...total, complete: true });
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
walk().catch(error => settle(() => reject(error)));
|
|
136
|
+
});
|
|
137
|
+
}
|
package/lib/paths.mjs
CHANGED
|
@@ -1,21 +1,15 @@
|
|
|
1
1
|
// 路径校验:页面只传相对路径,读取只用这里返回的规范路径。
|
|
2
2
|
import { realpath } from 'node:fs/promises';
|
|
3
3
|
import { join, sep } from 'node:path';
|
|
4
|
-
import { ErrorCode, fail } from '../view/protocol.mjs';
|
|
5
|
-
|
|
6
|
-
const CONTROL = /[\u0000-\u001f\u007f]/;
|
|
7
|
-
const MAX_PATH = 4096;
|
|
4
|
+
import { ErrorCode, fail, hasControl, splitRelative } from '../view/protocol.mjs';
|
|
8
5
|
|
|
9
6
|
// 名字里能不能带进路径(含控制字符的名字只显示,不能打开)。
|
|
10
|
-
export const isSafeName = name => !
|
|
7
|
+
export const isSafeName = name => !hasControl(name);
|
|
11
8
|
|
|
12
|
-
// 相对路径 →
|
|
9
|
+
// 相对路径 → 片段。规则在 view/protocol.mjs 的 splitRelative,页面恢复 cwd 时用的是同一个。
|
|
13
10
|
export function parseRelative(path) {
|
|
14
|
-
|
|
15
|
-
if (
|
|
16
|
-
if (path.startsWith('/')) throw fail(ErrorCode.INVALID_PATH, '只接受相对路径');
|
|
17
|
-
const segments = path.split('/').filter(part => part !== '' && part !== '.');
|
|
18
|
-
if (segments.includes('..')) throw fail(ErrorCode.INVALID_PATH, '路径不能含 ..');
|
|
11
|
+
const { segments, problem } = splitRelative(path);
|
|
12
|
+
if (problem) throw fail(ErrorCode.INVALID_PATH, problem);
|
|
19
13
|
return segments;
|
|
20
14
|
}
|
|
21
15
|
|
package/lib/tree.mjs
CHANGED
|
@@ -104,14 +104,14 @@ function decodeCursor(cursor) {
|
|
|
104
104
|
|
|
105
105
|
// 只有符号链接要额外解析:目标在根目录内按目标显示(目标的 lstat 带回去给读元数据用,不解析第二次),在外或已失效显示为 link。
|
|
106
106
|
// 校验之后用 lstat 读目标,不跟随链接:realpath 之后目标被换成别的链接,读到的就是符号链接,按 link 处理,不带外面的元数据。
|
|
107
|
-
async function classifyLink(fs, root, dir, name) {
|
|
107
|
+
export async function classifyLink(fs, root, dir, name) {
|
|
108
108
|
try {
|
|
109
109
|
const real = await fs.realpath(join(dir, name));
|
|
110
110
|
if (!isInside(root, real)) return { name, kind: EntryKind.LINK };
|
|
111
111
|
const info = await fs.lstat(real);
|
|
112
112
|
if (info.isSymbolicLink()) return { name, kind: EntryKind.LINK };
|
|
113
113
|
const kind = info.isDirectory() ? EntryKind.DIR : info.isFile() ? EntryKind.FILE : EntryKind.OTHER;
|
|
114
|
-
return { name, kind, link: true, info };
|
|
114
|
+
return { name, kind, link: true, info, real };
|
|
115
115
|
} catch { return { name, kind: EntryKind.LINK }; }
|
|
116
116
|
}
|
|
117
117
|
|
package/main.mjs
CHANGED
|
@@ -2,9 +2,11 @@
|
|
|
2
2
|
// 协议见 docs/design/phase-1.md 第 6 节,消息格式见 view/protocol.mjs。
|
|
3
3
|
import { createListing, listDirectory } from './lib/tree.mjs';
|
|
4
4
|
import { readChunk } from './lib/content.mjs';
|
|
5
|
+
import { addText } from './lib/draft.mjs';
|
|
6
|
+
import { dirSize, statPath } from './lib/info.mjs';
|
|
5
7
|
import { NO_ROOT, queryRoot, sameRoot } from './lib/root.mjs';
|
|
6
8
|
import {
|
|
7
|
-
ErrorCode, MESSAGE_LIMIT, REQUEST_ID_MAX, RootState, Type, fail, messageSize,
|
|
9
|
+
ErrorCode, MESSAGE_LIMIT, REQUEST_ID_MAX, ReplyOf, RootState, Type, fail, messageSize,
|
|
8
10
|
} from './view/protocol.mjs';
|
|
9
11
|
|
|
10
12
|
const POLL_MS = 2000;
|
|
@@ -17,16 +19,17 @@ const sessionOfFile = context => {
|
|
|
17
19
|
return typeof session === 'string' && session !== '' ? session : null;
|
|
18
20
|
};
|
|
19
21
|
|
|
20
|
-
// options
|
|
21
|
-
export function activate(coda, { makeListing = createListing } = {}) {
|
|
22
|
-
|
|
23
|
-
coda.views.register('
|
|
22
|
+
// options 只给测试用,运行时不传:makeListing 换成带假文件系统的读取状态;sizeLimits 调文件夹大小的项数、用时上限。
|
|
23
|
+
export function activate(coda, { makeListing = createListing, sizeLimits = {} } = {}) {
|
|
24
|
+
const options = { makeListing, sizeLimits };
|
|
25
|
+
coda.views.register('files', { open: view => serve(coda, view, sessionOfTree, options) });
|
|
26
|
+
coda.views.register('file', { open: view => serve(coda, view, sessionOfFile, options) });
|
|
24
27
|
}
|
|
25
28
|
|
|
26
29
|
const validRequestId = id => (typeof id === 'string' && id.length <= REQUEST_ID_MAX) || Number.isSafeInteger(id);
|
|
27
30
|
const errorOf = error => (error?.protocol ? { code: error.code, message: error.message } : { code: ErrorCode.IO, message: '读取失败' });
|
|
28
31
|
|
|
29
|
-
function serve(coda, view, sessionOf, makeListing) {
|
|
32
|
+
function serve(coda, view, sessionOf, { makeListing, sizeLimits }) {
|
|
30
33
|
// 代次:每换一次会话加 1,所有异步出口回来后都要核对。
|
|
31
34
|
const s = {
|
|
32
35
|
session: sessionOf(view.context), generation: 1, root: NO_ROOT, sent: null,
|
|
@@ -36,6 +39,12 @@ function serve(coda, view, sessionOf, makeListing) {
|
|
|
36
39
|
const turns = new Map();
|
|
37
40
|
const stale = generation => s.closed || generation !== s.generation;
|
|
38
41
|
|
|
42
|
+
// 文件夹大小:每个视图同时只有一次统计。新的开始、换会话、根目录变化、视图关闭时旧的静默停止(不回答)。
|
|
43
|
+
let sizing = null; // { generation, requestId, abort }
|
|
44
|
+
const stopSizing = () => { sizing?.abort.abort(); sizing = null; };
|
|
45
|
+
// 换会话、根目录变化、视图关闭:读取状态丢弃,统计也停。
|
|
46
|
+
const resetReads = () => { s.listing.clear(); stopSizing(); };
|
|
47
|
+
|
|
39
48
|
function post(message) {
|
|
40
49
|
if (s.closed) return;
|
|
41
50
|
if (messageSize(message) > MESSAGE_LIMIT) {
|
|
@@ -61,7 +70,7 @@ function serve(coda, view, sessionOf, makeListing) {
|
|
|
61
70
|
try { next = await queryRoot(coda, s.session); } catch { /* 保留上一次 */ }
|
|
62
71
|
if (stale(generation) || seq !== s.rootSeq) return;
|
|
63
72
|
if (next) {
|
|
64
|
-
if (next.path !== s.root.path)
|
|
73
|
+
if (next.path !== s.root.path) resetReads();
|
|
65
74
|
s.root = next;
|
|
66
75
|
}
|
|
67
76
|
syncPoll();
|
|
@@ -86,32 +95,57 @@ function serve(coda, view, sessionOf, makeListing) {
|
|
|
86
95
|
stopPoll();
|
|
87
96
|
s.session = session ?? null;
|
|
88
97
|
s.generation++;
|
|
89
|
-
|
|
98
|
+
resetReads();
|
|
90
99
|
s.root = NO_ROOT;
|
|
91
100
|
s.sent = null;
|
|
92
101
|
if (s.hello) postSession();
|
|
93
102
|
refreshRoot();
|
|
94
103
|
}
|
|
95
104
|
|
|
105
|
+
// 各种请求的处理:返回回答的内容;返回 null 表示静默结束,不回答。
|
|
106
|
+
const handlers = {
|
|
107
|
+
[Type.LIST]: (message, { root, valid }) => listDirectory(root, message.path, message.cursor, { listing: s.listing, sort: message.sort, valid }),
|
|
108
|
+
[Type.READ]: (message, { root }) => readChunk(root, message.path, message.offset),
|
|
109
|
+
[Type.STAT]: (message, { root }) => statPath(s.listing, root, message.path),
|
|
110
|
+
async [Type.DIR_SIZE](message, { root, valid, generation, requestId }) {
|
|
111
|
+
stopSizing();
|
|
112
|
+
const mine = { generation, requestId, abort: new AbortController() };
|
|
113
|
+
sizing = mine;
|
|
114
|
+
try {
|
|
115
|
+
return await dirSize(s.listing, root, message.path, { ...sizeLimits, valid, signal: mine.abort.signal });
|
|
116
|
+
} finally { if (sizing === mine) sizing = null; }
|
|
117
|
+
},
|
|
118
|
+
async [Type.ADD_TEXT](message, { generation }) {
|
|
119
|
+
if (!s.session) throw fail(ErrorCode.NO_ROOT, '没有会话');
|
|
120
|
+
return await addText(coda, s.session, message, { valid: () => !stale(generation) }) ? {} : null;
|
|
121
|
+
},
|
|
122
|
+
};
|
|
123
|
+
// 回答依赖根目录的:读完回来根目录换了,不能带旧根目录的内容。
|
|
124
|
+
const rootBound = new Set([Type.LIST, Type.STAT]);
|
|
125
|
+
|
|
96
126
|
async function request(message) {
|
|
97
127
|
const { type, generation, requestId } = message;
|
|
98
128
|
if (stale(generation) || !validRequestId(requestId)) return;
|
|
99
|
-
const reply = type
|
|
129
|
+
const reply = ReplyOf[type];
|
|
100
130
|
try {
|
|
101
131
|
if (s.root.state !== RootState.READY) throw fail(ErrorCode.NO_ROOT, '没有可浏览的工作目录');
|
|
102
132
|
const root = s.root.path;
|
|
103
133
|
// 读的途中根目录换了(同一会话从 A 换到 B),回答不能带 A 的内容。
|
|
104
134
|
const valid = () => !stale(generation) && s.root.state === RootState.READY && s.root.path === root;
|
|
105
|
-
const body = type
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
if (type === Type.LIST && !valid() && !stale(generation)) throw fail(ErrorCode.NO_ROOT, '工作目录已变化');
|
|
135
|
+
const body = await handlers[type](message, { root, valid, generation, requestId });
|
|
136
|
+
if (body === null || (type === Type.DIR_SIZE && !valid())) return; // 统计完成时根目录已变:不回答
|
|
137
|
+
if (rootBound.has(type) && !valid() && !stale(generation)) throw fail(ErrorCode.NO_ROOT, '工作目录已变化');
|
|
109
138
|
if (!stale(generation)) post({ type: reply, generation, requestId, ...body });
|
|
110
139
|
} catch (error) {
|
|
111
140
|
if (!stale(generation)) post({ type: reply, generation, requestId, error: errorOf(error) });
|
|
112
141
|
}
|
|
113
142
|
}
|
|
114
143
|
|
|
144
|
+
// 取消统计:代次和请求号都对上才停,迟到的取消不会误伤新的统计。
|
|
145
|
+
function cancelSizing({ generation, requestId }) {
|
|
146
|
+
if (!stale(generation) && sizing?.generation === generation && sizing.requestId === requestId) stopSizing();
|
|
147
|
+
}
|
|
148
|
+
|
|
115
149
|
view.onMessage(async message => {
|
|
116
150
|
if (!message || typeof message !== 'object') return;
|
|
117
151
|
switch (message.type) {
|
|
@@ -121,7 +155,8 @@ function serve(coda, view, sessionOf, makeListing) {
|
|
|
121
155
|
if (stale(message.generation)) return undefined;
|
|
122
156
|
s.listing.detach();
|
|
123
157
|
return refreshRoot();
|
|
124
|
-
case Type.LIST: case Type.READ: return request(message);
|
|
158
|
+
case Type.LIST: case Type.READ: case Type.STAT: case Type.DIR_SIZE: case Type.ADD_TEXT: return request(message);
|
|
159
|
+
case Type.DIR_SIZE_CANCEL: return cancelSizing(message);
|
|
125
160
|
}
|
|
126
161
|
});
|
|
127
162
|
|
|
@@ -148,7 +183,7 @@ function serve(coda, view, sessionOf, makeListing) {
|
|
|
148
183
|
|
|
149
184
|
view.onClose(async () => {
|
|
150
185
|
s.closed = true;
|
|
151
|
-
|
|
186
|
+
resetReads();
|
|
152
187
|
stopPoll();
|
|
153
188
|
try { await (await watching)?.dispose(); } catch { /* 已经取消 */ }
|
|
154
189
|
});
|