@heycys/gallery 0.2.2 → 0.2.4

package/browser/shared/i18n/en.mjs

@@ -1,17 +1,47 @@
 // English for Gallery's UI, by the Chinese text the source writes (index.mjs t()), in the order the
 // sources use them. tests/unit/i18n.mjs holds every string to an entry here and every entry to a string.
 export default {
-  "启用扩展「{0}」？": "Enable extension “{0}”?",
-  "此扩展可以在工作台运行脚本；后台程序拥有 Gallery 的本地文件和网络访问权限。仅启用你信任的扩展。": "This extension can run workbench scripts. Its backend has Gallery’s local file and network permissions. Only enable extensions you trust.",
+  "配置错误": "Configuration error",
+  "界面错误": "UI error",
+  "后台异常": "Backend error",
+  "还没有安装扩展": "No extensions installed",
+  "把扩展的文件夹或 zip 交给 Agent，或点下面的「安装扩展」。": "Give an extension folder or ZIP to an Agent, or click Install extension below.",
+  "安装扩展": "Install extension",
+  "安装": "Install",
+  "这个扩展关着：它的按钮和后台程序都不运行。": "This extension is disabled. Its buttons and backend are not running.",
+  "尚未启动": "Not started",
+  "正在启动": "Starting",
+  "运行中": "Running",
+  "正在重试": "Retrying",
+  "文件夹": "Folder",
+  "新偏好": "New preference",
+  "删除偏好「{0}」？": "Delete preference “{0}”?",
+  "对应的 Markdown 文件会被删除，无法恢复。": "Its Markdown file will be permanently deleted.",
+  "Agent 写作前会查看启用的偏好，并按本次任务选择适用的规则。": "Before writing, the Agent checks enabled preferences and selects the rules relevant to this task.",
+  "未保存": "Unsaved",
+  "新建偏好": "New preference",
+  "启用偏好：{0}": "Enable preference: {0}",
+  "全部偏好已停用，Agent 将按本次要求写作。": "All preferences are disabled. The Agent will follow your current request.",
+  "找不到写作偏好": "Writing preference not found",
+  "扩展错误记录无效": "Invalid extension error record",
+  "偏好文件已被修改，请重新打开后再试": "The preference file changed. Reopen it before trying again.",
+  "偏好名称不能包含路径或特殊字符": "Preference names cannot contain paths or special characters",
+  "写作偏好路径无效": "Invalid preference path",
+  "写作偏好不能是链接或特殊文件": "Preferences cannot be links or special files",
+  "偏好文件夹必须是普通文件夹": "The preferences folder must be an ordinary directory",
+  "偏好列表已变更，请重试": "The preference list changed. Try again.",
+  "偏好文件夹不能是链接": "The preferences folder cannot be a link",
+  "启用状态无效": "Invalid enabled state",
+  "未知的偏好操作": "Unknown preference action",
+  "拓展列表": "Extensions",
+  "开机自启动": "Start at login",
+  "登录系统后在后台启动 Gallery，不打开浏览器窗口": "Start Gallery in the background at login without opening a browser",
+  "开机自启动设置读取失败": "Could not read startup settings",
+  "开机自启动需要 Windows 或 macOS 上正式安装的 Gallery。": "Startup requires an installed Gallery package on Windows or macOS.",
+  "开机自启动设置失败：{0}": "Could not change startup settings: {0}",
   "启用": "Enable",
   "扩展设置保存失败": "Could not save extension settings",
-  "扩展设置已保存。重新打开 Gallery 后生效。": "Extension settings saved. Reopen Gallery to apply them.",
-  "来自默认工作区，所有文档共用。": "From the default workspace, shared by all documents.",
-  "还没有安装扩展。": "No extensions installed yet.",
-  "工作台脚本": "Workbench script",
-  "工作台样式": "Workbench style",
   "后台程序": "Backend process",
-  "侧栏目录": "Sidebar directory",
   "扩展列表读取失败": "Could not load extensions",
   "扩展 {0} 加载失败": "Could not load extension {0}",
   "扩展正在更新，请稍后再试": "The extension is being updated. Try again shortly.",
@@ -39,8 +69,6 @@ export default {
   "workbench 必须是对象": "workbench must be an object",
   "server.command 必须是非空的参数数组": "server.command must be a nonempty array of arguments",
   "扩展开关的值不正确": "Invalid extension enabled value",
-  "扩展刚刚更新，请重新打开设置": "The extension was updated. Reopen settings.",
-  "请先确认扩展的脚本和后台权限": "Confirm the extension’s script and backend permissions first",
   "扩展目录刚在别处改过，请重试": "The extension directory changed elsewhere. Please try again.",
   "找不到这个扩展": "This extension could not be found",
   "扩展路径不是普通文件或文件夹": "The extension path is not a regular file or directory",
@@ -90,6 +118,8 @@ export default {
   "文档": "Documents",
   "重命名": "Rename",
   "移动到": "Move to",
+  "历史版本": "Version history",
+  "这份文档以前的样子，可以恢复到其中一版": "This document as it was before: restore any of its versions",
   "导入": "Import",
   "移至回收区": "Move to trash",
   "已移动到「{0}」": "Moved to “{0}”",
@@ -101,6 +131,7 @@ export default {
   "永久删除": "Delete forever",
   "回收区是空的": "Trash is empty",
   "偏好": "Preferences",
+  "功能": "Features",
   "显示编辑框": "Show editing frame",
   "点进一段文字时，在它周围显示蓝色虚线框": "A dashed blue frame around the text you click into",
   "减少通知": "Fewer notifications",
@@ -122,7 +153,6 @@ export default {
   "拖动调整宽度": "Drag to resize",
   "点击收起侧边栏": "Click to close sidebar",
   "Agent 写报告时照着写的规则，每次写报告前都会先读": "The rules Agents write reports by, read before every report",
-  "Agent 写报告时照着写的规则：写什么、怎么写、怎样忠于材料。每次写报告前它都会先读这里。": "The rules Agents write reports by: what to write, how, and how to stay true to the materials. They read this before writing any report.",
   "写作偏好里有一处这里显示不了：{0}。Agent 照样读得到；在这里保存后，它会被去掉。": "One part of the writing preferences can't be shown here: {0}. Agents still read it; once you save here, it will be removed.",
   "写作偏好里有 {0} 处这里显示不了，例如：{1}。Agent 照样读得到；在这里保存后，它们会被去掉。": "{0} parts of the writing preferences can't be shown here, such as: {1}. Agents still read them; once you save here, they will be removed.",
   "写作偏好没有保存：{0}": "The writing preferences weren't saved: {0}",
@@ -177,6 +207,7 @@ export default {
   "浅色": "Light",
   "深色": "Dark",
   "找不到这份文档": "Document not found",
+  "这个文档名已经有了": "A document or page already has that name",
   "令牌失效": "The token has expired",
   "请求来源不对": "Request from the wrong origin",
   "请求地址不对": "Request to the wrong address",
@@ -282,7 +313,7 @@ export default {
   "新增分栏": "Add column",
   "已调整栏宽：{0} · 双击竖线平分 · Ctrl+Z 撤销": "Column widths: {0} · double-click the line to even them · Ctrl+Z to undo",
   "已平分栏宽 · Ctrl+Z 撤销": "Columns evened · Ctrl+Z to undo",
-  "已取消调整。": "Resize cancelled.",
+  "已取消调整": "Resize cancelled",
   "复制我的文字": "Copy my text",
   "复制这一块": "Copy this block",
   "AI 的写入把你之前保存的这段修改改回去了。": "The AI's write undid an edit you had saved here.",
@@ -318,7 +349,7 @@ export default {
   "收起": "Collapse",
   "你的版本": "Your version",
   "文件里的（AI 的）": "In the file (the AI's)",
-  "已复制。": "Copied.",
+  "已复制": "Copied",
   "没有可复制的文字。": "Nothing to copy.",
   "没能完成，请再试一次。": "That didn't work; try again.",
   "你的": "Yours",
@@ -346,8 +377,8 @@ export default {
   "最后面": "bottom",
   "已移动{0} · Ctrl+Z 撤销": "Moved {0} · Ctrl+Z to undo",
   "正在移动{0} · 拖到要放的位置后松开 · 停在选项卡上切换，停在折叠块标题上展开 · Esc 取消": "Moving {0} · release where it should go · rest on a tab to switch to it, on a toggle's title to open it · Esc to cancel",
-  "已取消移动。": "Move cancelled.",
-  "位置没有变化。": "Nothing moved.",
+  "已取消移动": "Move cancelled",
+  "位置没有变化": "Nothing moved",
   "{0} · 拖动栏间的竖线调宽度 · Ctrl+Z 撤销": "{0} · drag the line between columns to resize · Ctrl+Z to undo",
   "已移动这一栏": "Column moved",
   "已把{0}放进新的一栏": "Put {0} in a new column",
@@ -385,7 +416,41 @@ export default {
   "没能确认：{0}": "Could not keep: {0}",
   "Agent 刚刚又改了文档，再看一眼": "The Agent just changed the document again: have another look",
   "撤回之后文档又改过了，没法撤销": "The document changed after the revert, so it cannot be undone",
+  "恢复之后文档又改过了，没法撤销": "The document changed after the restore, so it cannot be undone",
   "撤销已经过期": "It is too late to undo",
+  "找不到这个版本": "Version not found",
+  "这一版的内容": "This version's content",
+  "没能读出这一版": "Could not read this version",
+  "还有 {0} 块": "{0} more blocks",
+  "版本": "Versions",
+  "还没有存下的版本": "No versions kept yet",
+  "你": "You",
+  "未知": "Unknown",
+  "最早存下的样子": "The earliest version kept",
+  "Agent 在自用页面上改的": "Edited on the Agent's own page",
+  "页面上的修改": "Edited on the page",
+  "撤回了 Agent 的修改": "Reverted the Agent's changes",
+  "撤销了撤回或恢复": "Undid a revert or a restore",
+  "恢复了更早的版本": "Restored an earlier version",
+  "导出时补上了编号": "Block ids added on export",
+  "改了标题": "Renamed",
+  "改写了文件": "Rewrote the file",
+  "加了 {0} 块": "{0} blocks added",
+  "改了 {0} 块": "{0} changed",
+  "删了 {0} 块": "{0} deleted",
+  "块没有变": "No block changed",
+  "加了": "Added",
+  "改了": "Changed",
+  "删了": "Deleted",
+  "「{0}」": "“{0}”",
+  "这就是现在的样子": "This is the document as it is now",
+  "恢复到这一版？": "Restore this version?",
+  "文档会变回{0}的样子。现在的样子会先存成一个版本，之后还能恢复回来。": "The document goes back to how it was {0}. As it is now, it is kept as a version first, so you can restore that later.",
+  "已恢复到{0}的版本": "Restored the version from {0}",
+  "还有修改没保存或有冲突待处理，处理完再恢复": "Some edits are not saved yet or wait for you: deal with them, then restore",
+  "还有修改没保存或有冲突待处理": "Some edits are not saved yet or wait for you",
+  "没能恢复：{0}": "Could not restore: {0}",
+  "已撤销": "Undone",
   "预览服务器出错": "The preview server failed",
   "{0} 处修改和文件的最新版本冲突，没有保存：在左下方选择怎么处理。": "{0} edits conflict with the file's latest version and weren't saved: choose what to do at the bottom left.",
   "自定义块刚刚变了，{0} 处修改没有保存：在左下方选择怎么处理。": "A custom block just changed and {0} edits weren't saved: choose what to do at the bottom left.",
@@ -525,7 +590,6 @@ export default {
   "其余修改已保存；红框处的内容还没有保存。": "Other changes are saved; what's marked in red isn't saved yet.",
   "其余修改已保存；红框处的内容文档存不下，没有保存。": "Other changes are saved; what's marked in red can't be stored in the document and wasn't saved.",
   "其余修改已保存；还没写完的块（红框或空标题）没有保存。": "Other changes are saved; unfinished blocks (in red, or with an empty title) aren't.",
-  "已保存。": "Saved.",
   "有上次没保存的修改，但现在连不上预览服务器；连上后刷新页面即可放回。": "There are unsaved changes from last time, but the preview server can't be reached; reload once it's back to put them in.",
   "有上次没保存的修改还没能放回（文件正在被修改，或预览服务器出错）；稍后刷新页面会再试。": "Unsaved changes from last time couldn't be put back yet (the file is being changed, or the preview server failed); reloading later tries again.",
   "文件里的这一段已被修改，你的版本如下：": "This paragraph changed in the file; your version:",
@@ -784,7 +848,7 @@ export default {
   "显示为": "Show as",
   "选择视图": "Choose a view",
   "还没有链接地址。": "No link address yet.",
-  "已复制链接。": "Link copied.",
+  "已复制链接": "Link copied",
   "这个块已经不在了。": "This block is no longer here.",
   "复制块链接": "Copy link to block",
   "这一块还没有保存，保存后才能复制它的链接。": "This block isn't saved yet: copy its link once it is.",
@@ -792,7 +856,7 @@ export default {
   "没有找到这个页面。": "Page not found.",
   "没能复制：浏览器不允许写剪贴板。": "Not copied: the browser doesn't allow writing to the clipboard.",
   "不支持这种链接地址。": "This kind of link address isn't supported.",
-  "链接已移除。": "Link removed.",
+  "链接已移除": "Link removed",
   "链接：{0}": "Link: {0}",
   "链接视图": "Link",
   "标题视图": "Title",
@@ -1262,6 +1326,7 @@ export default {
   "复制批注": "Copy annotations",
   "删除批注": "Delete annotation",
   "全部删除": "Delete all",
+  "删除已处理": "Delete done",
   "{0} 条": "{0}",
   "还没有批注。选中文字或点块右边的按钮来写": "None yet. Select text or use a block's button",
   "写下建议…": "Write a suggestion…",
@@ -1329,12 +1394,10 @@ export default {
   "写作偏好没有字体与布局": "Writing preferences have no font and layout",
   "字体与布局不对": "The font and layout given are not right",
   "这份文档的标题和说明读不出来": "This document's title and description could not be read",
-  "应用到全部文档": "Apply to all documents",
-  "这份文档的字体与布局用到全部文档，新建的文档也一样": "Use this document's font and layout in every document, new ones too",
-  "这份文档的字体与布局用到它所在工作区的全部文档，新建的文档也一样": "Use this document's font and layout in every document of its workspace, new ones too",
-  "已应用到全部文档": "Applied to all documents",
-  "已应用到全部文档，替换了 {0} 篇的单独设置": "Applied to all documents; own settings replaced in {0}",
-  "没有应用到全部文档：{0}": "Not applied to all documents: {0}",
+  "已设置为全局默认": "Global default saved",
+  "全局默认设置失败：{0}": "Could not set the global default: {0}",
+  "所有工作区共用此默认字体与布局，保留文档的单独设置": "Use this default appearance across all workspaces, keeping individual document settings",
+  "设置为全局默认": "Set as global default",
   // 自定义页（侧栏「新建」「搜索」下面那几行、搜索、回收区）
   "自定义页": "Custom page",
   "更多页面": "More pages",
@@ -1526,6 +1589,8 @@ export default {
   "这就是当前的工作区": "This is the current workspace",
   "侧边栏最多 {0} 栏，放不下这个工作区了": "The sidebar holds {0} columns at most: there is no room for this workspace",
   "默认文档": "Default documents",
+  "沙盒": "Sandbox",
+  "沙盒只能使用自己的工作区。": "The sandbox can only use its own workspace.",
   "这不是 Gallery 的底稿或工作区，可以用「导入」把文件复制进来": "This is no Gallery draft or workspace: Import copies a file in",
   "这份底稿不在它工作区的第一层（在回收区里，或是写作偏好），不能添加": "This draft is not at the top of its workspace (it is in the trash, or the writing preferences): it can't be added",
   "这个文件夹的名字不是 Gallery 文档的写法（小写字母、数字和连字符），不能添加": "This folder's name is not a Gallery document's (lowercase letters, digits and hyphens): it can't be added",
@@ -1564,4 +1629,38 @@ export default {
   "将「{0}」及其子页面复制到「{1}」，原项保留。": "Copy “{0}” and its child pages to “{1}”, keeping the originals.",
   "已复制 {0} 项，原项保留": "Copied {0} items; originals kept",
   "跨工作区请复制，不能只移动目录位置": "Copy items to another workspace instead of moving their tree positions",
+  "无法打开文件夹": "Could not open the folder",
+  "已启用「{0}」": "Enabled “{0}”",
+  "已停用「{0}」": "Disabled “{0}”",
+  "刷新": "Refresh",
+  "移除扩展「{0}」？": "Remove extension “{0}”?",
+  "它的文件夹会被删除，包括它在侧栏里的栏目。这一步不能撤销。": "Its folder, including its sidebar column, will be deleted. This cannot be undone.",
+  "已移除「{0}」": "Removed “{0}”",
+  "移除扩展…": "Remove extension…",
+  "在侧栏中显示": "Show in sidebar",
+  "给 Gallery 加按钮、侧栏栏目和后台功能，所有工作区共用。": "Add buttons, sidebar columns and backend features shared by all workspaces.",
+  "界面": "Interface",
+  "Agent 说明": "Agent instructions",
+  "extension.json 读不出来：{0}": "Cannot read extension.json: {0}",
+  "后台程序退出了（退出码 {0}）": "The backend exited (code {0})",
+  "查看日志": "View log",
+  "刷新页面后生效": "Refresh the page to apply",
+  "启用扩展：{0}": "Enable extension: {0}",
+  "修好 extension.json 之后才能启用": "Fix extension.json before enabling",
+  "侧栏栏目": "Sidebar columns",
+  "{0} 个条目": "{0} entries",
+  "已安装并启用「{0}」": "Installed and enabled “{0}”",
+  "粘贴扩展的文件夹或 zip 的路径": "Paste the extension folder or zip path",
+  "ZIP 数据无效或超过 100MB": "Invalid ZIP data or ZIP exceeds 100 MB",
+  "扩展文件夹不正确": "Invalid extension folder",
+  "请选择扩展路径或 ZIP": "Choose an extension path or ZIP",
+  "Gallery 服务暂时无法响应，请稍后重试扩展操作": "The Gallery service cannot respond right now. Retry the extension operation later.",
+  "enable 必须是布尔值": "enable must be a boolean",
+  "扩展名称、版本和描述必须是短文本": "The extension name, version and description must be short text",
+  "icon 不正确": "Invalid icon",
+  "icon 必须是表情或扩展里的图片": "The icon must be an emoji or an image inside the extension",
+  "server.timeout 必须是 1000 到 600000 毫秒": "server.timeout must be between 1000 and 600000 milliseconds",
+  "找不到扩展": "Extension not found",
+  "扩展引用的文件不存在": "A file referenced by the extension is missing",
+  "找不到 extension.json": "extension.json was not found",
 };

package/browser/shared/outline-ops.mjs

@@ -0,0 +1,109 @@
+import { DOCS, isTop, newGroupId, topOf } from "./outline-shape.mjs";
+
+// The sidebar's column and entry changes as plain functions of an outline ({ groups, children }, as
+// shared/outline.mjs reads it), the same ones the workbench makes (src/workbench/app/workspace/meta.ts:
+// addColumn, renameColumn, removeColumn, straysOf, detach, leaveOut), for gallery column and gallery
+// workspaces --hide, which write the outline they make under its lock or through the running server
+// (src/cli/tree.mjs editOutline). Each returns a new outline, or null when it changes nothing or cannot;
+// the argument is never changed.
+
+const tidy = (value) => (typeof value === "string" ? value.replace(/\s+/g, " ").trim() : "");
+const listOf = (outline, key) => outline.children[key] ?? [];
+const parentOf = (outline, slug) => Object.entries(outline.children).find(([, list]) => list.includes(slug))?.[0] ?? null;
+
+function withList(outline, key, list) {
+  const children = { ...outline.children };
+  if (list.length || isTop(key)) children[key] = list;
+  else delete children[key];
+  return { ...outline, children };
+}
+
+function insert(outline, slug, parent, index) {
+  const list = listOf(outline, parent).filter((each) => each !== slug);
+  list.splice(index === undefined ? list.length : Math.max(0, Math.min(index, list.length)), 0, slug);
+  return withList(outline, parent, list);
+}
+
+/** A new column `column` ({ id, title?, owner? }) at `index` (the end when none); null for an id there is already. */
+export function addColumn(outline, column, index) {
+  if (outline.groups.some((group) => group.id === column.id)) return null;
+  const groups = [...outline.groups];
+  groups.splice(index === undefined ? groups.length : Math.max(0, Math.min(index, groups.length)), 0, column);
+  return { ...outline, groups, children: { ...outline.children, [topOf(column.id)]: [] } };
+}
+
+/** A new column's id, none of the outline's. */
+export const newColumnId = (outline) => newGroupId(outline.groups);
+
+/** Column `id` named `title` (null: back to the name it goes by); null for no such column, an extension's, an empty name or the same. */
+export function renameColumn(outline, id, title) {
+  const name = title === null ? null : tidy(title).slice(0, 100);
+  const group = outline.groups.find((each) => each.id === id);
+  if (!group || group.extension || name === "" || (name ?? undefined) === group.title) return null;
+  const groups = outline.groups.map((each) => {
+    if (each.id !== id) return each;
+    const { title: _old, ...rest } = each;
+    void _old;
+    return name ? { ...rest, title: name } : rest;
+  });
+  return { ...outline, groups };
+}
+
+/**
+ * The entries in the column `id` of a workspace that are not that workspace's drafts (documents dragged in, web
+ * links, another workspace's drafts), with each one's place: [{ slug, parent, index }], in the sidebar's order.
+ */
+export function straysOf(outline, id) {
+  const group = outline.groups.find((each) => each.id === id);
+  if (!group?.workspace) return [];
+  const own = `~${group.workspace}/`;
+  const found = [];
+  const walk = (key) => listOf(outline, key).forEach((slug, index) => {
+    if (slug.startsWith(own)) walk(slug);
+    else found.push({ slug, parent: key, index });
+  });
+  walk(topOf(id));
+  return found;
+}
+
+/**
+ * Column `id` removed from the sidebar as 从侧边栏移除 removes it. A workspace's column is hidden (`hidden`: the workspace,
+ * its files and the registry stay), what was dragged into it going last to the own column; one the user made (or an
+ * older Gallery's 链接) is deleted, its entries with those under them going last to the column of its owner's workspace
+ * (the own one), no file deleted. null for the own column, an extension's, none and one hidden already.
+ */
+export function removeColumn(outline, id) {
+  if (id === DOCS || !outline.groups.some((group) => group.id === id && !group.extension && !group.hidden)) return null;
+  if (outline.groups.some((group) => group.id === id && group.workspace)) {
+    let next = { ...outline, groups: outline.groups.map((group) => (group.id === id ? { ...group, hidden: true } : group)) };
+    for (const { slug, parent } of straysOf(outline, id)) next = insert(withList(next, parent, listOf(next, parent).filter((each) => each !== slug)), slug, "");
+    return next;
+  }
+  const top = topOf(id);
+  const owner = outline.groups.find((group) => group.id === id)?.owner;
+  const destination = owner ? topOf(outline.groups.find((group) => group.workspace === owner)?.id ?? DOCS) : "";
+  const children = { ...outline.children, [destination]: [...listOf(outline, destination), ...listOf(outline, top)] };
+  delete children[top];
+  return { ...outline, children, groups: outline.groups.filter((group) => group.id !== id) };
+}
+
+/**
+ * Draft `entry` ("~<ws id>/<slug>") taken out of the tree as 从文档树移除 takes it (the document is not touched): the entries
+ * under it go up to where it was; when its workspace's column is a whole one (not `picked`), its slug is put among that
+ * column's `left`, so that the column does not bring it back. null for an entry the outline does not hold.
+ */
+export function removeDraft(outline, entry) {
+  const parent = parentOf(outline, entry);
+  if (parent === null) return null;
+  const siblings = listOf(outline, parent);
+  const index = siblings.indexOf(entry);
+  const next = withList(withList(outline, parent, [...siblings.slice(0, index), ...listOf(outline, entry), ...siblings.slice(index + 1)]), entry, []);
+  const parts = /^~(ws-[0-9a-f]{6})\/(.+)$/.exec(entry);
+  const group = parts ? next.groups.find((each) => each.workspace === parts[1]) : undefined;
+  if (!parts || !group || group.picked) return next;
+  const left = (group.left ?? []).filter((slug) => slug !== parts[2]);
+  left.push(parts[2]);
+  const { left: _old, ...rest } = group;
+  void _old;
+  return { ...next, groups: next.groups.map((each) => (each === group ? { ...rest, left } : each)) };
+}

package/browser/shared/outline.mjs

@@ -105,6 +105,12 @@ export async function withOutlineLock(root, task, { local = false } = {}) {
       await fs.writeFile(lock, mine, { flag: "wx" });
       break;
     } catch (error) {
+      // Windows can briefly keep a just-unlinked lock delete-pending. Wait for the
+      // handle to close; do not remove a live writer's lock or treat it as stale.
+      if (process.platform === 'win32' && ['EPERM', 'EBUSY'].includes(error.code) && Date.now() <= until) {
+        await new Promise(resolve => setTimeout(resolve, 20));
+        continue;
+      }
       if (error.code !== "EEXIST") throw error;
       const age = await fs.stat(lock).then(({ mtimeMs }) => Date.now() - mtimeMs, () => 0);
       if (age > LOCK_STALE) await fs.rm(lock, { force: true });

package/browser/shared/pages.mjs

@@ -476,13 +476,15 @@ export async function createPage(slug, title, { root, icon = null, lang, blank =
 }
 
 /**
- * Custom page `slug`'s title written into its page.json (the workbench's 重命名), every other field as
- * it was; page.html is not touched (its <title> and header are the Agent's). Resolves to its meta, or
- * null when the page is not there; throws for a title that is empty or longer than 200 characters.
+ * Custom page `slug`'s title and/or icon written into its page.json (the workbench's 重命名 writes the title,
+ * gallery page set both), every other field as it was; page.html is not touched (its <title> and header are
+ * the Agent's). `icon` a value (the caller holds it to what an icon may be), or null to take it away; left
+ * out, it stays. Resolves to its meta, or null when the page is not there; throws (code "title") for a title
+ * that is empty or longer than 200 characters.
  */
-export async function renamePage(slug, title, root) {
-  const name = typeof title === "string" ? title.replace(/\s+/g, " ").trim() : "";
-  if (!name || name.length > 200) throw Object.assign(new Error("A page's title is 1 to 200 characters."), { code: "title" });
+export async function setPageMeta(slug, { title, icon } = {}, root) {
+  const name = title === undefined ? undefined : typeof title === "string" ? title.replace(/\s+/g, " ").trim() : "";
+  if (name !== undefined && (!name || name.length > 200)) throw Object.assign(new Error("A page's title is 1 to 200 characters."), { code: "title" });
   if (!pageExists(slug, root)) return null;
   const { json } = pageFiles(slug, root);
   for (let tries = 0; tries < 3; tries++) {
@@ -492,9 +494,19 @@ export async function renamePage(slug, title, root) {
       value = text === null ? {} : JSON.parse(text.replace(/^/, ""));
     } catch {}
     if (!value || typeof value !== "object" || Array.isArray(value)) value = {};
-    const next = `${JSON.stringify({ ...value, title: name }, null, 2)}\n`;
-    const written = text === null ? (await fs.writeFile(json, next, { flag: "wx" }).then(() => true, () => false)) : await writeAtomic(json, next, { expect: text });
+    const next = { ...value, ...(name !== undefined ? { title: name } : {}) };
+    if (icon === null) delete next.icon;
+    else if (icon !== undefined) next.icon = icon;
+    const body = `${JSON.stringify(next, null, 2)}\n`;
+    const written = text === null ? (await fs.writeFile(json, body, { flag: "wx" }).then(() => true, () => false)) : await writeAtomic(json, body, { expect: text });
     if (written) break;
   }
   return readPageMeta(slug, root);
 }
+
+/**
+ * Custom page `slug`'s title written into its page.json (the workbench's 重命名), every other field as
+ * it was; page.html is not touched (its <title> and header are the Agent's). Resolves to its meta, or
+ * null when the page is not there; throws for a title that is empty or longer than 200 characters.
+ */
+export const renamePage = (slug, title, root) => setPageMeta(slug, { title: typeof title === "string" ? title : "" }, root);

package/browser/shared/paths.mjs

@@ -2,6 +2,7 @@ import { existsSync, readFileSync } from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { serviceLocation } from "./service-location.mjs";
+import { userDirectory } from "./user-directory.mjs";
 import { findWorkspace, layoutOf } from "./workspace.mjs";
 
 // Where everything is on disk, for every system, in two kinds: the workspace's (the user's documents
@@ -58,8 +59,9 @@ export const starterDirectory = inPackage(["starter"], "src", "render", "starter
  * pack is installed, and gallery block add copies a block of (shared/block-packs.mjs, shared/shipped-blocks.mjs).
  */
 export const packsDirectory = inPackage(["packs"], "src", "packs");
-export const vendorDirectory = inPackage(["vendor"], "public", "vendor");
-export const kitPublicDirectory = inPackage(["kit"], "public", "kit");
+const sandboxAssets = !release && process.env.GALLERY_SANDBOX ? path.join(userDirectory("cache"), "public") : null;
+export const vendorDirectory = sandboxAssets ? path.join(sandboxAssets, "vendor") : inPackage(["vendor"], "public", "vendor");
+export const kitPublicDirectory = sandboxAssets ? path.join(sandboxAssets, "kit") : inPackage(["kit"], "public", "kit");
 /** The editor's browser modules, at their path under src/ (the preview serves them so: src/server/routes.mjs). */
 export const browserDirectory = inPackage(["browser"], "src");
 /** The emoji and icon data (the editor fetches it; the render reads it for a page's icon). */
@@ -70,6 +72,7 @@ export const workbenchDirectory = release ? path.join(packageRoot, "web") : null
 export const sdkDirectory = path.join(packageRoot, "sdk");
 /** Gallery's default 写作偏好 (shared/writing-preferences.mjs). */
 export const defaultPreferencesFile = inPackage(["assets", "writing-preferences.md"], "src", "shared", "writing-preferences.md");
+export const previewDirectory = inPackage(["assets", "preview"], "src", "preview");
 /** TypeScript (src/render/typescript.mjs): the release's own minified copy, beside the libs it reads; null: the typescript package. */
 export const typescriptFile = release ? path.join(packageRoot, "vendor", "typescript", "typescript.js") : null;
 /** Where the type check finds d3's types (the type library d3, and the d3-* it names). */

package/browser/shared/preference-documents.mjs

@@ -0,0 +1,137 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { defaultWorkspace, ensureWorkspace, markerOf, pageSlug, documentDirectory, documentFiles, DEVICE_NAMES } from './workspace.mjs';
+import { defaultPreferencesFile } from './writing-preferences.mjs';
+import { sha256, writeAtomic } from './files.mjs';
+import { withOutlineLock } from './outline.mjs';
+
+export const GENERAL_PREFERENCE = 'preferences/项目报告写作.md';
+const configFile = () => path.join(defaultWorkspace(), 'gallery.json');
+async function configuration() {
+  const text = await fs.readFile(configFile(), 'utf8').catch(error => { if (error.code === 'ENOENT') return '{}'; throw error; });
+  const { reads, value } = markerOf(text);
+  if (!reads || !value || typeof value !== 'object' || Array.isArray(value)) throw new Error('gallery.json 读不出来：改好这个文件后再试');
+  return value;
+}
+export function preferenceName(name) {
+  if (typeof name !== 'string' || !name.trim() || name !== name.trim() || name.length > 80 || /[<>:"/\\|?*\x00-\x1f]/.test(name) || /[. ]$/.test(name) || name.startsWith('.') || DEVICE_NAMES.has(name.split('.')[0].toLowerCase())) throw new Error('偏好名称不能包含路径或特殊字符');
+  return name;
+}
+export async function preferenceFile(id) {
+  if (typeof id !== 'string' || !id.startsWith('preferences/') || !id.endsWith('.md') || 'preferences/' + preferenceName(id.slice(12, -3)) + '.md' !== id) throw new Error('写作偏好路径无效');
+  const root = defaultWorkspace(), file = path.join(root, id);
+  for (const candidate of [path.join(root, 'preferences'), file]) {
+    const stat = await fs.lstat(candidate);
+    if (stat.isSymbolicLink() || (candidate === file && (!stat.isFile() || stat.nlink > 1))) throw new Error('写作偏好不能是链接或特殊文件');
+  }
+  return file;
+}
+export const titledPreference = (text, name) => /^\uFEFF?\s*#\s+[^\r\n]*(?:\r?\n|$)/.test(text) ? text.replace(/^\uFEFF?\s*#\s+[^\r\n]*(?:\r?\n|$)/, () => '# ' + name + '\n') : '# ' + name + '\n\n' + text;
+export const listPreferenceDocuments = () => withOutlineLock(defaultWorkspace(), readPreferenceDocuments);
+async function initialize(config) {
+  if (config.preferences?.initialized) return false;
+  const root = defaultWorkspace(), legacy = path.join(root, 'preferences.md');
+  const stat = await fs.lstat(legacy).catch(error => { if (error.code !== 'ENOENT') throw error; return null; });
+  if (stat && (!stat.isFile() || stat.isSymbolicLink() || stat.nlink > 1)) throw new Error('写作偏好不能是链接或特殊文件');
+  const directory = path.join(root, 'preferences');
+  await fs.mkdir(directory, { recursive: true });
+  if ((await fs.lstat(directory)).isSymbolicLink()) throw new Error('偏好文件夹不能是链接');
+  const text = titledPreference(await fs.readFile(stat ? legacy : defaultPreferencesFile, 'utf8'), '项目报告写作');
+  const file = path.join(root, GENERAL_PREFERENCE);
+  try { await fs.writeFile(file, text, { flag: 'wx' }); }
+  catch (error) {
+    if (error.code !== 'EEXIST') throw error;
+    // A previous migration may have stopped after writing the destination. Never overwrite a different document.
+    if (stat && await fs.readFile(await preferenceFile(GENERAL_PREFERENCE), 'utf8') !== text) throw new Error('偏好文件已被修改，请重新打开后再试');
+  }
+  const slug = await pageSlug(root, 'preferences.md');
+  if (slug) {
+    const json = documentFiles(documentDirectory(slug, root)).json;
+    const metadata = JSON.parse(await fs.readFile(json, 'utf8').catch(error => { if (error.code !== 'ENOENT') throw error; return '{}'; }));
+    await writeAtomic(json, JSON.stringify({ ...metadata, instructions: true, preference: GENERAL_PREFERENCE, title: '项目报告写作' }, null, 2) + '\n');
+  }
+  const mapped = values => Array.isArray(values) ? values.map(id => id === 'preferences.md' ? GENERAL_PREFERENCE : id) : [];
+  const order = mapped(config.preferences?.order);
+  config.preferences = { ...config.preferences, initialized: true, order: order.length ? order : [GENERAL_PREFERENCE], off: mapped(config.preferences?.off) };
+  await writeAtomic(configFile(), JSON.stringify(config, null, 2) + '\n');
+  if (stat) await fs.unlink(legacy);
+  return !stat;
+}
+// Readers share the writer's lock so a rename cannot temporarily hide a tab and discard its draft.
+async function readPreferenceDocuments() {
+  const config = await configuration();
+  const made = await initialize(config);
+  const directory = path.join(defaultWorkspace(), 'preferences');
+  const stat = await fs.lstat(directory).catch(error => { if (error.code !== 'ENOENT') throw error; return null; });
+  if (stat && (!stat.isDirectory() || stat.isSymbolicLink())) throw new Error('偏好文件夹必须是普通文件夹');
+  const entries = stat ? await fs.readdir(directory, { withFileTypes: true }) : [];
+  const ids = entries.filter(entry => entry.isFile() && !entry.isSymbolicLink() && entry.name.endsWith('.md') && !entry.name.startsWith('.')).map(entry => 'preferences/' + entry.name).sort();
+  const order = Array.isArray(config.preferences?.order) ? config.preferences.order : [];
+  const off = new Set(Array.isArray(config.preferences?.off) ? config.preferences.off : []);
+  return Promise.all([...new Set([...order.filter(id => ids.includes(id)), ...ids])].map(async id => {
+    let file, text;
+    try { file = await preferenceFile(id); text = await fs.readFile(file, 'utf8'); }
+    catch (error) { if (error.code === 'ENOENT') return null; throw error; }
+    return { id, file, name: path.basename(id, '.md'), enabled: !off.has(id), revision: sha256(text), slug: await pageSlug(defaultWorkspace(), id), made: id === GENERAL_PREFERENCE && made };
+  })).then(items => items.filter(Boolean));
+}
+
+/** All writers use the existing workspace lock; the rest of gallery.json survives unchanged. */
+export async function changePreferenceDocuments(change) {
+  await ensureWorkspace(defaultWorkspace());
+  return withOutlineLock(defaultWorkspace(), async () => {
+    const list = await readPreferenceDocuments();
+    const item = list.find(item => item.id === change.id);
+    const config = await configuration();
+    let order = list.map(item => item.id), off = list.filter(item => !item.enabled).map(item => item.id), selected = change.id;
+    if (change.action === 'order') {
+      if (!Array.isArray(change.order) || new Set(change.order).size !== list.length || change.order.length !== list.length || change.order.some(id => !order.includes(id))) throw new Error('偏好列表已变更，请重试');
+      order = change.order;
+    } else if (change.action === 'create' || change.action === 'duplicate') {
+      if (change.action === 'duplicate' && !item) throw new Error('找不到写作偏好');
+      const name = preferenceName(change.name), id = 'preferences/' + name + '.md';
+      const directory = path.join(defaultWorkspace(), 'preferences');
+      await fs.mkdir(directory, { recursive: true });
+      if ((await fs.lstat(directory)).isSymbolicLink()) throw new Error('偏好文件夹不能是链接');
+      const text = change.action === 'duplicate' ? await fs.readFile(await preferenceFile(item.id), 'utf8') : '';
+      await fs.writeFile(path.join(defaultWorkspace(), id), titledPreference(text, name), { flag: 'wx' });
+      const at = item ? order.indexOf(item.id) + 1 : order.length;
+      order.splice(at, 0, id); selected = id;
+    } else {
+      if (!item) throw new Error('找不到写作偏好');
+      const file = await preferenceFile(item.id);
+      if (change.action === 'enabled') {
+        if (typeof change.enabled !== 'boolean') throw new Error('启用状态无效');
+        off = off.filter(id => id !== item.id); if (!change.enabled) off.push(item.id);
+      } else if (change.action === 'rename' || change.action === 'delete') {
+        if (change.revision !== item.revision) throw new Error('偏好文件已被修改，请重新打开后再试');
+        if (change.action === 'rename') {
+          const name = preferenceName(change.name), id = 'preferences/' + name + '.md';
+          if (id === item.id) return { items: list, selected: id };
+          const text = titledPreference(await fs.readFile(file, 'utf8'), name);
+          await fs.writeFile(path.join(defaultWorkspace(), id), text, { flag: 'wx' });
+          if (item.slug) {
+            const json = documentFiles(documentDirectory(item.slug, defaultWorkspace())).json;
+            const metadata = JSON.parse(await fs.readFile(json, 'utf8'));
+            // Keep the editor's slug (and mounted iframe/draft) stable across a rename.
+            await writeAtomic(json, JSON.stringify({ ...metadata, preference: id, title: name, ...(metadata.madeSame ? { madeSame: { ...metadata.madeSame, file: sha256(text).slice(0, 16) } } : {}) }, null, 2) + '\n');
+          }
+          await fs.unlink(file);
+          order = order.map(value => value === item.id ? id : value); off = off.map(value => value === item.id ? id : value); selected = id;
+        } else {
+          await fs.unlink(file);
+          order = order.filter(id => id !== item.id); off = off.filter(id => id !== item.id); selected = order[0];
+          // Invalidate its association; the editor draft is internal and may still be mounted elsewhere.
+          if (item.slug) {
+            const json = documentFiles(documentDirectory(item.slug, defaultWorkspace())).json;
+            const metadata = JSON.parse(await fs.readFile(json, 'utf8'));
+            await writeAtomic(json, JSON.stringify({ ...metadata, preference: null }, null, 2) + '\n');
+          }
+        }
+      } else throw new Error('未知的偏好操作');
+    }
+    config.preferences = { ...config.preferences, order, off };
+    await writeAtomic(configFile(), JSON.stringify(config, null, 2) + '\n');
+    return { items: await readPreferenceDocuments(), selected };
+  });
+}