Spot it. Save it. Free, local-first Chrome extension for images, videos and prompts. Explore 2,000+ curated cases and connect your library to AI Agents via MCP. 提示词导演
JavaScript ai-artai-videochrome-extensionclaude-codecodexhiggsfieldjimenglocal-firstmcpmidjourneymoodboardprompt-engineeringprompt-libraryprompt-managerreference-libraryseedancevisual-bookmarksweb-clipper
from __future__ import annotations
import re
import tempfile
from pathlib import Path
from playwright.sync_api import expect
from e2e_support import base_entry, extension_session
PNG_BASE64 = "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNk+A8AAQUBAScY42YAAAAASUVORK5CYII="
def action_geometry(page, name: str) -> dict:
button = page.get_by_role("button", name=name)
expect(button).to_have_count(1)
return button.evaluate(
"""button => {
const rect = button.getBoundingClientRect();
const stage = button.closest('.detail-visual-stage').getBoundingClientRect();
const hit = document.elementFromPoint(rect.left + rect.width / 2, rect.top + rect.height / 2);
return {
buttonTop: rect.top,
buttonBottom: rect.bottom,
stageTop: stage.top,
stageBottom: stage.bottom,
clickable: hit === button || button.contains(hit)
};
}"""
)
def assert_action_is_reachable(page, name: str) -> None:
page.get_by_role("button", name=name).scroll_into_view_if_needed()
page.wait_for_function(
"""name => {
const button = [...document.querySelectorAll('button')]
.find(node => (node.getAttribute('aria-label') || node.textContent.trim()).includes(name));
if (!button) return false;
const rect = button.getBoundingClientRect();
const stage = button.closest('.detail-visual-stage')?.getBoundingClientRect();
const hit = document.elementFromPoint(rect.left + rect.width / 2, rect.top + rect.height / 2);
return stage && stage.top <= rect.top && rect.bottom <= stage.bottom
&& (hit === button || button.contains(hit));
}""",
arg=name,
)
geometry = action_geometry(page, name)
assert geometry["stageTop"] <= geometry["buttonTop"], geometry
assert geometry["buttonBottom"] <= geometry["stageBottom"], geometry
assert geometry["clickable"], geometry
def main() -> None:
entry = base_entry(
"multi-image-case",
"多图案例",
"切换主图后保留的案例文字。",
"content:prompt:image",
1,
)
entry["mediaAssets"] = [
image_asset(f"multi-image-{index}", f"2026-08-03T00:00:{index:02d}.000Z", index)
for index in range(1, 16)
]
entry["primaryMediaId"] = "multi-image-1"
entry["mediaPrompts"] = [{"assetId":"multi-image-2","source":"manual","text":"第二张图片独立提示词"}]
with extension_session(
"prompt-director-media-actions-",
viewport={"width": 1440, "height": 900},
) as session:
setup = session.open_page("collector.html")
setup.evaluate(
"""async ({png}) => {
const {saveMediaBlob} = await import(chrome.runtime.getURL('media-store.js'));
const bytes = Uint8Array.from(atob(png), value => value.charCodeAt(0));
for (let index = 1; index <= 15; index += 1) {
await saveMediaBlob(`multi-image-${index}`, new Blob([bytes], {type: 'image/png'}), {checkCapacity: false});
}
}""",
{"png": PNG_BASE64},
)
# Seed through the shared flow so the first state migration settles before the
# fixture lands; otherwise the per-media prompt is dropped as pre-migration data.
session.seed_storage(setup, {"entries": [entry]})
library = session.open_page("library.html", wait_until="networkidle")
expect(library.locator(".case-card")).to_have_count(1)
library.locator(".case-card").click()
expect(library.locator(".detail-visual-thumb")).to_have_count(15)
expect(library.get_by_role("button", name="编辑当前图片", exact=True)).to_have_count(0)
library.locator(".entry-editor-inline > summary").click()
expect(library.locator(".entry-editor-inline textarea:visible")).to_have_count(0)
expect(library.locator(".entry-editor-inline .entry-original-editor")).to_have_count(0)
# The case editor is a floating panel above the reading pane; close it before using
# the prompt tabs it covers, exactly as an outside click would.
library.locator(".entry-editor-inline > summary").click()
expect(library.locator(".entry-editor-inline .entry-editor-body")).to_be_hidden()
library.get_by_role("tab", name="当前媒体", exact=True).click()
expect(library.get_by_role("button", name="添加当前媒体提示词", exact=True)).to_be_visible()
library.get_by_role("tab", name="原始提示词", exact=True).click()
expect(library.locator(".original-prompt-panel").get_by_role("button", name="编辑原始提示词", exact=True)).to_be_visible()
expect(library.locator(".original-prompt-panel h3")).to_have_text("原始提示词")
stable_before = library.evaluate(
"""() => {
const gallery = document.querySelector('.detail-visual-gallery');
const rail = gallery.querySelector('.detail-visual-rail');
const detail = document.querySelector('#detail-content');
gallery.dataset.stabilityProbe = 'same-gallery';
rail.scrollLeft = rail.scrollWidth;
const rect = gallery.getBoundingClientRect();
return {
railScrollLeft: rail.scrollLeft,
galleryTop: rect.top,
railTop: rail.getBoundingClientRect().top,
stageHeight: gallery.querySelector('.detail-visual-stage').getBoundingClientRect().height,
detailScrollTop: detail.scrollTop
};
}"""
)
for index in (14, 6, 11):
library.locator(".detail-visual-thumb").nth(index).click()
assert "12/15" in library.locator(".detail-visual-caption .detail-media-context > span").first.get_attribute("title")
stable_after = library.evaluate(
"""() => {
const gallery = document.querySelector('.detail-visual-gallery[data-stability-probe="same-gallery"]');
const rail = gallery?.querySelector('.detail-visual-rail');
const rect = gallery?.getBoundingClientRect();
return {
sameNode: Boolean(gallery),
railScrollLeft: rail?.scrollLeft,
galleryTop: rect?.top,
railTop: rail?.getBoundingClientRect().top,
stageHeight: gallery?.querySelector('.detail-visual-stage').getBoundingClientRect().height,
detailScrollTop: document.querySelector('#detail-content').scrollTop
};
}"""
)
assert stable_after["sameNode"], stable_after
assert abs(stable_after["railScrollLeft"] - stable_before["railScrollLeft"]) <= 1, (stable_before, stable_after)
assert abs(stable_after["galleryTop"] - stable_before["galleryTop"]) <= 1, (stable_before, stable_after)
assert abs(stable_after["railTop"] - stable_before["railTop"]) <= 1, (stable_before, stable_after)
assert abs(stable_after["stageHeight"] - stable_before["stageHeight"]) <= 1, (stable_before, stable_after)
assert abs(stable_after["detailScrollTop"] - stable_before["detailScrollTop"]) <= 1, (stable_before, stable_after)
library.locator(".detail-visual-thumb").nth(14).click()
library.get_by_role("tab", name="当前媒体", exact=True).click()
library.get_by_role("button", name="添加当前媒体提示词", exact=True).click()
original_editor = library.locator(".media-original-prompt-panel")
original_editor.get_by_role("textbox", name="添加当前媒体提示词", exact=True).fill("第十五张的独立原始")
original_editor.get_by_role("button", name="保存", exact=True).click()
expect(library.locator(".media-original-prompt-panel .prompt-read-body")).to_have_text("第十五张的独立原始")
stored = library.evaluate("async()=>{const {entries}=await import(chrome.runtime.getURL('library-storage.js')).then(({getLibraryStorage}) => getLibraryStorage().get('entries'));return entries[0]}")
assert next(p for p in stored["mediaPrompts"] if p["text"] == "第十五张的独立原始")["assetId"] == "multi-image-15"
library.locator(".entry-editor-inline > summary").click()
assert_action_is_reachable(library, "设为主图")
assert_action_is_reachable(library, "此媒体移入回收站")
library.set_viewport_size({"width": 390, "height": 844})
expect(library.locator(".detail-visual-caption")).to_be_visible()
assert_action_is_reachable(library, "设为主图")
assert_action_is_reachable(library, "此媒体移入回收站")
library.get_by_role("button", name="设为主图").click()
# The row shows the format; the primary position stays in the label's tooltip.
expect(library.locator(".detail-visual-caption .detail-media-context > span").first).to_have_attribute(
"title", re.compile("主要媒体"))
state = library.evaluate("async () => chrome.runtime.sendMessage({type: 'GET_STATE'})")
assert state["entries"][0]["primaryMediaId"] == "multi-image-15"
expect(library.locator(".case-card img[data-visual-id]")).to_have_attribute("data-visual-id", "multi-image-15")
library.get_by_role("button", name="此媒体移入回收站").click()
delete_dialog = library.locator("#promptdirector-app-dialog")
expect(delete_dialog).to_be_visible()
delete_dialog.get_by_role("button", name="媒体移入回收站", exact=True).click()
expect(library.locator(".detail-visual-thumb")).to_have_count(14)
expect(library.locator("#detail-content")).to_contain_text("切换主图后保留的案例文字。")
state = library.evaluate("async () => chrome.runtime.sendMessage({type: 'GET_STATE'})")
assert [asset["id"] for asset in state["entries"][0]["mediaAssets"]] == [f"multi-image-{index}" for index in range(1, 15)]
assert state["entries"][0]["primaryMediaId"] == "multi-image-1"
expect(library.locator(".case-card img[data-visual-id]")).to_have_attribute("data-visual-id", "multi-image-1")
library.locator(".detail-visual-thumb").nth(13).click()
library.get_by_role("button", name="此媒体移入回收站").click()
expect(delete_dialog).to_be_visible()
delete_dialog.get_by_role("button", name="媒体移入回收站", exact=True).click()
expect(library.locator(".detail-visual-thumb")).to_have_count(13)
library.locator("#detail-close").click()
library.locator("#toggle-filters").click()
expect(library.locator(".workspace")).to_have_class("workspace")
library.locator("#open-trash").click()
expect(library.locator("#trash-dialog")).to_be_visible()
# Measure the settled dialog: the shared open animation scales it for 200ms.
library.evaluate("async()=>await Promise.all(document.querySelector('#trash-dialog').getAnimations().map(a=>a.finished.catch(()=>{})))")
expect(library.locator(".trash-item")).to_have_count(2)
expect(library.locator(".trash-item-cover img")).to_have_count(2)
expect(library.locator(".trash-item-copy strong")).to_have_text(["多图案例", "多图案例"])
restore = library.locator(".trash-item button[aria-label^='恢复:']").first
remove = library.locator(".trash-item button[aria-label^='永久删除:']").first
expect(restore).to_have_attribute("title", "恢复")
expect(remove).to_have_attribute("title", "永久删除")
assert restore.evaluate("node => node.getBoundingClientRect().height") >= 44
trash_screenshot = Path(tempfile.gettempdir()) / "promptdirector-trash-mobile.png"
library.screenshot(path=str(trash_screenshot), full_page=True)
restore.focus()
restore.press("Enter")
expect(library.locator(".trash-item")).to_have_count(1)
expect(library.get_by_role("button", name="全部恢复", exact=True)).to_be_enabled()
library.get_by_role("button", name="全部恢复", exact=True).click()
expect(library.locator(".trash-empty-title")).to_have_text("回收站为空")
expect(library.get_by_role("button", name="全部恢复", exact=True)).to_be_disabled()
restored = library.evaluate("async()=> (await chrome.runtime.sendMessage({type:'GET_STATE'})).entries[0]")
assert len(restored["mediaAssets"]) == 15, restored
assert any(prompt["assetId"] == "multi-image-15" and prompt["source"] == "manual"
for prompt in restored["mediaPrompts"]), restored
expect(library.locator("#trash-dialog")).not_to_contain_text("RECYCLE BIN")
print({
"desktop_actions_reachable": True,
"mobile_actions_reachable": True,
"primary_media_updated": True,
"delete_preserved_case": True,
"trash_cover_and_keyboard_restore": True,
"trash_screenshot": str(trash_screenshot),
"rapid_selection_last_wins": "12/15",
"visual_anchor_shift_px": 1,
})
def image_asset(asset_id: str, captured_at: str, index: int) -> dict:
width, height = (1600, 900) if index % 2 else (900, 1600)
return {
"id": asset_id,
"kind": "image",
"usage": "content",
"storageMode": "managed",
"mimeType": "image/png",
"width": width,
"height": height,
"capturedAt": captured_at,
"reviewStatus": "verified",
}
if __name__ == "__main__":
main()