Peach: Local-first video metadata scraper and media manager.
docs(preview): 默认接入预览文案编辑
longmeidaoa9f0e09b6328
diff --git a/.claude/skills/peach-web-ui/SKILL.md b/.claude/skills/peach-web-ui/SKILL.mdindex 6a3554a2d..a4a3f47ed 100644--- a/.claude/skills/peach-web-ui/SKILL.md+++ b/.claude/skills/peach-web-ui/SKILL.md@@ -5,8 +5,8 @@ description: 在新增、修改、预览或复核 Peach 页面、控件、提示# Peach Web UI 复用门槛-最后复核:2026-10-22-证据来源:现有 UI 契约、`docs/TESTING.md`、本机重复文案与异步轮询回归记录、jakubkrehel/skills 与 emilkowalski/skills 摘录、`docs/reference-snapshots/open-claude-ui.md`、用户真实小样本预览与明确确认后测试的约定。+最后复核:2026-10-23+证据来源:现有 UI 契约、`docs/TESTING.md`、本机重复文案与异步轮询回归记录、jakubkrehel/skills 与 emilkowalski/skills 摘录、`docs/reference-snapshots/open-claude-ui.md`、用户真实小样本预览、明确确认后测试及所有预览默认接入 `?edit` 的约定。## 开工顺序@@ -87,6 +87,7 @@ description: 在新增、修改、预览或复核 Peach 页面、控件、提示## 验收门槛- 监听预览端口前由启动入口调用 `check_ui_preview.py`,取得成功的 `real-ledger-subset` 报告;提供地址时说明已读约定、实际样本与已查看场景。缺少清单、伪造字段或关联、图像缓存缺失均拒收,不以进程就绪代替实图验收。+- 交给用户的所有预览默认接入 `?edit`,覆盖首次设置、登录、错误页、主界面及演示站;复用现有编辑器,按 `docs/UI_PREVIEW.md`「文案编辑」核对工作树归属、浮条与保存生效链路,不能只给地址追加参数。- 预览前核对标题、说明、持久提示与操作回执的职责,同一事实只在承担该职责的位置说明;检查加载、空态、错误和完成态,避免重复说明与残余内容。- 界面改动先构建并保留可访问的预览,提供地址;只有用户明确确认当前预览后才能运行测试,确认绑定该预览与范围,范围内沿用。发出地址、用户继续纠正和等待超时都不算确认;收到界面新纠正时停止本任务运行中及排队的测试,修好后重新等待确认。确认前只做实现、预览构建与视觉查看;用户明确只要图片时才仅提供截图。- UI 标签、身份、反馈状态和搜索推荐属于语义契约:按实际影响验证数据层、组件或浏览器行为。diff --git a/docs/UI_PREVIEW.md b/docs/UI_PREVIEW.mdindex b037fb20b..42ec3cd89 100644--- a/docs/UI_PREVIEW.md+++ b/docs/UI_PREVIEW.md@@ -18,6 +18,18 @@## 确认与交付-提供可访问预览,并说明读取的约定、使用的真实样本与已查看的场景。原账本、原媒体与凭据保持独立;预览拦截修改请求,关闭后台调度、账本同步、mDNS 与详情自动播放。+提供可访问预览,并说明读取的约定、使用的真实样本与已查看的场景。原账本、原媒体与凭据保持独立;预览拦截业务修改请求,关闭后台调度、账本同步、mDNS 与详情自动播放。只有用户明确确认当前预览后才能运行界面回归;新增纠正后停止本任务运行及排队的测试,修复并重新提供预览。测试、生产切换与发布结果分别报告,不以预览代替已生效结论。++## 文案编辑++交给用户的所有页面预览默认开启 `?edit`,包括首次设置、登录、错误页、主界面、新路由与演示站。链接保留已有查询参数和片段:无查询参数时加 `?edit`,已有查询参数时加 `&edit`。用户明确要求普通查看时按其要求提供。++复用[源码环境改字](OPERATIONS.md#源码环境改字)的核心、适配器和保存接口。主界面的注入不会自动覆盖首次设置等独立页面壳;目标页面缺少接入时,在当前界面任务中补齐共用入口。不得把参数存在当成已启用,也不另造一套编辑器。++源码预览的页面、`PROJECT_ROOT`、文案来源、备份和构建产物必须指向本任务隔离工作树。预览仍拦截业务写入,只向本机同源编辑器放行 `POST /dev/copy-save` 和 `POST /dev/copy-apply`;沿用认证、来源摘要校验与备份。Python 文案的重载只针对本任务预览进程,不交给生产托盘。演示站沿用浏览器草稿,不宣称已写回源码。++提供预览前,在目标页面确认「文案编辑」浮条、悬停范围、原位输入和取消操作可用。首次接入或保存链路变化时,用隔离的临时源码副本核对保存、构建或重载、刷新后生效及 `edit` 参数保留;同一工作树和入口的有效证据可复用。核对后恢复临时文案,保留用户修改。未取得某项能力时说明具体页面和错误,不宣称可编辑预览已就绪。++布局验收和控件操作使用「暂停编辑」或普通查看状态;交付给用户的入口保留编辑模式。编辑器产生的源码修改纳入当前任务的 diff、回归和集成,不写真实账本或修改生产配置。