@my-life-buddies/cli 0.14.1 → 0.15.0

package/resources/buddy-creator/scripts/preview_panel.py

@@ -1,80 +0,0 @@
-"""Host-observed panel presence and a durable, at-most-once reopen offer.
-
-This module cannot see browser tabs. It records the host's observations;
-it never opens a UI or interprets an interview answer as consent.
-"""
-import json
-from datetime import datetime, timezone
-from pathlib import Path
-
-import buddy_core as core
-
-VISIBILITIES = {'open', 'closed', 'unknown'}
-REMINDERS = {'not_offered', 'offered', 'accepted', 'declined', 'ignored'}
-SOURCES = {'host_inventory', 'user_report', 'unavailable'}
-
-
-def _load(path, workspace_id):
-    if not path.exists():
-        return {'workspaceId': workspace_id, 'visibility': 'unknown', 'source': 'unavailable',
-                'observedAt': None, 'reminder': 'not_offered', 'offeredAt': None}
-    try:
-        panel = json.loads(path.read_text(encoding='utf-8'))
-        valid = (isinstance(panel, dict) and panel.get('workspaceId') == workspace_id
-                 and panel.get('visibility') in VISIBILITIES and panel.get('source') in SOURCES
-                 and panel.get('reminder') in REMINDERS)
-    except (OSError, ValueError, TypeError):
-        valid = False
-    core.require(valid, 'PREVIEW_PANEL_STATE', '面板提醒记录无法读取或不属于本作品；保留记录，停止主动询问。用户仍可明确要求打开面板。')
-    return panel
-
-
-def _freshly_closed(panel):
-    if panel['visibility'] != 'closed' or panel['source'] == 'unavailable':
-        return False
-    try:
-        observed = datetime.fromisoformat(panel['observedAt'].replace('Z', '+00:00'))
-        return 0 <= (datetime.now(timezone.utc) - observed).total_seconds() <= 120
-    except (KeyError, AttributeError, TypeError, ValueError):
-        return False
-
-
-def call(workspace, request):
-    core.require(isinstance(request, dict), 'PREVIEW_PANEL_INPUT', '面板请求必须为 JSON 对象。')
-    action = request.get('action', 'status')
-    core.require(isinstance(action, str) and action in {'status', 'observe', 'offer', 'respond'},
-                 'PREVIEW_PANEL_ACTION', 'action 使用 status、observe、offer 或 respond。')
-    workspace = Path(workspace).expanduser().resolve()
-    with core.workspace_lock(workspace):
-        state = core.load(workspace)
-        path = workspace / 'preview-panel.json'
-        panel = _load(path, state['workspaceId'])
-        should_ask = False
-        if action == 'observe':
-            visibility, source = request.get('visibility'), request.get('source')
-            core.require(isinstance(visibility, str) and visibility in VISIBILITIES
-                         and isinstance(source, str) and source in SOURCES,
-                         'PREVIEW_PANEL_OBSERVATION', '提供真实 visibility 和 source；不能用服务连通性推测界面状态。')
-            core.require(source != 'unavailable' or visibility == 'unknown',
-                         'PREVIEW_PANEL_OBSERVATION', '无法检查界面时只能记录 unknown。')
-            panel.update(visibility=visibility, source=source, observedAt=core.now())
-        elif action == 'offer':
-            # Persist before returning permission to ask. A lost receipt must
-            # err on the side of silence, never a second unsolicited question.
-            should_ask = panel['reminder'] == 'not_offered' and _freshly_closed(panel)
-            if should_ask:
-                panel.update(reminder='offered', offeredAt=core.now())
-        elif action == 'respond':
-            response = request.get('response')
-            core.require(isinstance(response, str) and response in {'accepted', 'declined', 'ignored'},
-                         'PREVIEW_PANEL_RESPONSE', 'response 使用 accepted、declined 或 ignored。')
-            core.require(response != 'ignored' or panel['reminder'] != 'not_offered',
-                         'PREVIEW_PANEL_RESPONSE', '尚未询问时不能记为未回应。')
-            # Explicit requests/refusals also apply before or after an offer.
-            # None of these outcomes re-enables unsolicited offers.
-            panel['reminder'] = response
-        if action != 'status':
-            core.atomic_json(path, panel)
-        return {'workspace': str(workspace), 'panel': panel,
-                'canOffer': panel['reminder'] == 'not_offered' and _freshly_closed(panel),
-                'shouldAsk': should_ask}

package/resources/buddy-creator/scripts/sources.py

@@ -1,239 +0,0 @@
-"""Archive original sources and actual host-tool extracts; no document converters."""
-import hashlib
-import json
-import os
-import shutil
-import tempfile
-from datetime import datetime, timezone
-from pathlib import Path
-from urllib.parse import urlsplit
-
-KINDS = {'file', 'webpage', 'history', 'mindmap', 'skill', 'oral', 'scan', 'audio', 'video'}
-TEXT_EXTENSIONS = {'.txt', '.md', '.markdown', '.csv', '.tsv', '.json', '.jsonl', '.yaml', '.yml', '.xml', '.opml', '.mm', '.html', '.htm', '.log'}
-MAX_BYTES = 512 * 1024 * 1024
-MAX_TEXT = 32 * 1024 * 1024
-
-
-def digest(value):
-    if isinstance(value, str):
-        value = value.encode('utf-8')
-    return hashlib.sha256(value).hexdigest()
-
-
-def encoded(value):
-    return json.dumps(value, ensure_ascii=False, sort_keys=True, separators=(',', ':'), allow_nan=False).encode('utf-8')
-
-
-def fail(code, message):
-    raise ValueError(code + ': ' + message)
-
-
-def _part(text, locator):
-    if not isinstance(text, str) or not text.strip() or not isinstance(locator, str) or not locator.strip():
-        fail('SOURCE_PART', '每段提取结果需要真实原文和来源位置。')
-    if len(text.encode('utf-8')) > MAX_TEXT:
-        fail('SOURCE_PART_SIZE', '单段资料过大，请按实际来源分段。')
-    return {'text': text, 'locator': locator}
-
-
-def _text(path):
-    if path.stat().st_size > MAX_TEXT:
-        fail('SOURCE_TEXT_SIZE', '文本过大，请由宿主分段读取后提交 hostResult。')
-    try:
-        result = path.read_text(encoding='utf-8-sig')
-    except UnicodeError:
-        fail('HOST_SOURCE_REQUIRED', '资料不是 UTF-8 文本，请由宿主读取后提交 hostResult。')
-    if '\x00' in result:
-        fail('HOST_SOURCE_REQUIRED', '这份资料需要宿主工具读取，不能当作普通文本。')
-    return result
-
-
-def _history(text):
-    try:
-        data = json.loads(text)
-        rows = data.get('messages', []) if isinstance(data, dict) else data
-    except json.JSONDecodeError:
-        try:
-            rows = [json.loads(line) for line in text.splitlines() if line.strip()]
-        except json.JSONDecodeError:
-            fail('HISTORY_FORMAT', '历史资料须为用户选定的可见消息 JSON/JSONL，或由宿主提取可见原文。')
-    if not isinstance(rows, list):
-        fail('HISTORY_FORMAT', '没有找到选定的可见消息列表。')
-    parts = []
-    for index, row in enumerate(rows):
-        if not isinstance(row, dict) or row.get('role') not in ('user', 'assistant'):
-            continue
-        if row.get('channel') not in (None, 'final') or row.get('hidden') or row.get('visibility') == 'hidden':
-            continue
-        content = row.get('content', row.get('text', ''))
-        if isinstance(content, list):
-            content = '\n'.join(item.get('text', '') for item in content if isinstance(item, dict) and item.get('type') in ('text', 'input_text', 'output_text'))
-        if isinstance(content, str) and content.strip():
-            parts.append(_part(content, '选定可见消息 %s / %s' % (index + 1, row['role'])))
-    if not parts:
-        fail('HISTORY_EMPTY', '没有可导入的用户或助手可见正文。')
-    return parts
-
-
-def _copy_file(path, destination):
-    if not path.is_file() or path.is_symlink():
-        fail('SOURCE_FILE', '请提供实际文件，不能用符号链接替代原件。')
-    size = path.stat().st_size
-    if size > MAX_BYTES:
-        fail('SOURCE_SIZE', '单份原件超过 512 MiB 归档上限，请选定必要部分。')
-    destination.parent.mkdir(parents=True, exist_ok=True)
-    total = 0
-    sha = hashlib.sha256()
-    with path.open('rb') as incoming, destination.open('xb') as outgoing:
-        while True:
-            block = incoming.read(1024 * 1024)
-            if not block:
-                break
-            total += len(block)
-            if total > MAX_BYTES:
-                fail('SOURCE_SIZE', '读取过程中资料超过大小上限。')
-            sha.update(block)
-            outgoing.write(block)
-        outgoing.flush()
-        os.fsync(outgoing.fileno())
-    return {'hash': sha.hexdigest(), 'bytes': total}
-
-
-def import_source(workspace, state, payload):
-    """Called under the workspace writer lock. Returns an immutable manifest."""
-    workspace = Path(workspace)
-    op_id = payload.get('operationId')
-    if not isinstance(op_id, str) or not op_id.strip() or len(op_id) > 256:
-        fail('OPERATION_ID_REQUIRED', '资料导入需要稳定的 operationId；重试沿用，补充结果使用新身份。')
-    kind = payload.get('kind')
-    if kind not in KINDS:
-        fail('SOURCE_UNSUPPORTED', '不支持这类来源；此包不包含小红书账号采集。')
-    uri = payload.get('uri', '')
-    if not isinstance(uri, str):
-        fail('SOURCE_URI', '资料位置必须是字符串。')
-    if kind == 'webpage':
-        url = urlsplit(uri)
-        host = (url.hostname or '').lower().rstrip('.')
-        if url.scheme not in ('http', 'https') or not host or url.username or url.password:
-            fail('SOURCE_URL', '网页来源需要不含账号密码的 HTTP(S) 地址。')
-        if any(host == domain or host.endswith('.' + domain) for domain in ('xiaohongshu.com', 'xhslink.com')):
-            fail('SOURCE_UNSUPPORTED', '此包不采集小红书网页或账号；用户自行提供的原文可作为本地资料。')
-    request_hash = digest(encoded({key: value for key, value in payload.items() if key not in ('operation', 'operationId')}))
-    source_id = 'source_' + digest(op_id)[:24]
-    directory = workspace / 'sources' / source_id
-    manifest_path = directory / 'manifest.json'
-    if manifest_path.exists():
-        previous = json.loads(manifest_path.read_text(encoding='utf-8'))
-        if previous.get('requestHash') != request_hash:
-            fail('IDEMPOTENCY_CONFLICT', '同一资料导入身份对应的内容已改变，请为新结果使用新的 operationId。')
-        return previous
-    host_result = payload.get('hostResult')
-    parts, extraction = [], None
-    if host_result is not None:
-        if not isinstance(host_result, dict) or not isinstance(host_result.get('tool'), str) or not host_result['tool'].strip():
-            fail('HOST_SOURCE_TOOL', '请注明实际读取资料的宿主工具。')
-        if host_result.get('coverage') not in ('complete', 'partial'):
-            fail('HOST_SOURCE_COVERAGE', 'coverage 必须如实填写 complete 或 partial。')
-        rows = host_result.get('parts')
-        if not isinstance(rows, list) or not rows or len(rows) > 10000:
-            fail('HOST_SOURCE_PARTS', '请提供真实提取的正文和定位。')
-        for row in rows:
-            if not isinstance(row, dict):
-                fail('HOST_SOURCE_PARTS', '每段资料必须是 text 和 locator 组成的对象。')
-            parts.append(_part(row.get('text'), row.get('locator')))
-        notes = host_result.get('notes', [])
-        if not isinstance(notes, list) or any(not isinstance(note, str) for note in notes):
-            fail('HOST_SOURCE_NOTES', 'notes 须为实际处理说明的文本列表。')
-        extraction = {'provider': 'host', 'tool': host_result['tool'], 'coverage': host_result['coverage'], 'notes': notes}
-    elif kind in ('webpage', 'scan', 'audio', 'video'):
-        fail('HOST_SOURCE_REQUIRED', '请先用宿主实际可用工具读取资料，再提交 hostResult。')
-    source_root = workspace / 'sources'
-    source_root.mkdir(parents=True, exist_ok=True)
-    staging = Path(tempfile.mkdtemp(prefix='.incoming-', dir=str(source_root)))
-    files = []
-    try:
-        if kind == 'webpage':
-            raw = encoded({'url': uri, 'hostResult': host_result, 'description': '宿主提取快照，不是完整网页原件'})
-            (staging / 'webpage-snapshot.json').write_bytes(raw)
-            files.append({'path': 'webpage-snapshot.json', 'hash': digest(raw), 'bytes': len(raw)})
-        elif uri:
-            path = Path(uri).expanduser()
-            if not path.is_absolute():
-                fail('SOURCE_ABSOLUTE_PATH', '本地资料请使用绝对路径。')
-            if path.is_symlink():
-                fail('SOURCE_FILE', '请提供实际原件路径。')
-            if path.is_dir() and kind == 'skill':
-                total, count = 0, 0
-                for folder, dirs, names in os.walk(str(path), followlinks=False):
-                    dirs[:] = [name for name in sorted(dirs) if name not in ('.git', 'node_modules', '__pycache__', '.venv') and not (Path(folder) / name).is_symlink()]
-                    for name in sorted(names):
-                        item = Path(folder) / name
-                        if item.is_symlink() or item.suffix.lower() not in TEXT_EXTENSIONS:
-                            continue
-                        count += 1
-                        total += item.stat().st_size
-                        if count > 5000 or total > MAX_BYTES:
-                            fail('SOURCE_SIZE', 'Skill 资料超出文本归档上限，请选定相关文档。')
-                        relative = item.relative_to(path).as_posix()
-                        saved = _copy_file(item, staging / 'original' / relative)
-                        files.append(dict(saved, path='original/' + relative))
-                        if host_result is None:
-                            text = _text(staging / 'original' / relative)
-                            if text.strip():
-                                parts.append(_part(text, relative))
-            elif path.is_file():
-                saved = _copy_file(path, staging / 'original' / path.name)
-                files.append(dict(saved, path='original/' + path.name))
-                if host_result is None:
-                    if path.suffix.lower() not in TEXT_EXTENSIONS:
-                        fail('HOST_SOURCE_REQUIRED', '此格式请先由宿主工具读取，再提交 hostResult。')
-                    text = _text(staging / 'original' / path.name)
-                    parts = _history(text) if kind == 'history' else [_part(text, path.name)]
-            else:
-                fail('SOURCE_FILE', '资料文件不存在，或该来源类型不支持目录。')
-        elif payload.get('text') is not None:
-            text = payload['text']
-            part = _part(text, '创作者提供的原文' if kind == 'oral' else '用户选定原文')
-            raw = text.encode('utf-8')
-            (staging / 'original.txt').write_bytes(raw)
-            files.append({'path': 'original.txt', 'hash': digest(raw), 'bytes': len(raw)})
-            if host_result is None:
-                parts = _history(text) if kind == 'history' else [part]
-        else:
-            fail('SOURCE_ORIGINAL_REQUIRED', '请提供本地原件路径、网页地址或用户实际提供的原文。')
-        if not parts:
-            fail('SOURCE_EMPTY', '资料中没有可归档的可读正文。')
-        if sum(len(part['text'].encode('utf-8')) for part in parts) > MAX_BYTES:
-            fail('SOURCE_SIZE', '提取结果总量超过 512 MiB，请按实际范围分批。')
-        if host_result is not None:
-            raw = encoded(host_result)
-            (staging / 'host-result.json').write_bytes(raw)
-            files.append({'path': 'host-result.json', 'hash': digest(raw), 'bytes': len(raw)})
-        chunks = [dict(part, id='chunk_%04d' % (index + 1), hash=digest(part['text'])) for index, part in enumerate(parts)]
-        complete = extraction is None or extraction['coverage'] == 'complete'
-        title = payload.get('title') or (Path(uri).name if uri and kind != 'webpage' else uri or '口述资料')
-        manifest = {'id': source_id, 'version': digest(encoded({'files': files, 'chunks': chunks})),
-                    'operationId': op_id, 'requestHash': request_hash, 'kind': kind, 'title': str(title), 'uri': uri,
-                    'status': 'ready' if complete else 'failed', 'files': files, 'chunks': chunks,
-                    'extraction': extraction, 'warnings': [] if complete else ['仅保存已提取部分，尚未完整读取。'],
-                    'parser': 'host-tools' if extraction else 'python-text-archive',
-                    'acquiredAt': datetime.now(timezone.utc).isoformat(),
-                    'error': None if complete else 'HOST_SOURCE_INCOMPLETE',
-                    'processing': {'acquisition': 'complete' if complete else 'partial',
-                                   'parsing': 'complete' if complete else 'partial', 'semanticReview': 'requires_host_calibration'}}
-        (staging / 'manifest.json').write_bytes(encoded(manifest))
-        for file in staging.rglob('*'):
-            if file.is_file():
-                with file.open('rb') as handle:
-                    os.fsync(handle.fileno())
-        os.replace(str(staging), str(directory))
-        if os.name != 'nt':
-            fd = os.open(str(source_root), os.O_RDONLY)
-            try:
-                os.fsync(fd)
-            finally:
-                os.close(fd)
-        return manifest
-    except BaseException:
-        shutil.rmtree(str(staging), ignore_errors=True)
-        raise

package/resources/buddy-creator/scripts/widget_render.py

@@ -1,66 +0,0 @@
-"""Versioned read-only prototypes; existing files retain their renderer contract."""
-import hashlib
-from pathlib import Path
-
-import buddy_core as core
-
-
-def files(artifact, item=None):
-    version = artifact['data'].get('rendererVersion')
-    core.require(version in (1, 2, 3, 4), 'WIDGET_RENDERER_VERSION', '不支持的原型模板版本。')
-    if version == 1:
-        from widget_render_v1 import files as render_files
-    elif version == 2:
-        from widget_render_v2 import files as render_files
-    elif version == 3:
-        from widget_render_v3 import files as render_files
-    else:
-        from widget_render_v4 import files as render_files
-    return render_files(artifact, item)
-
-
-def directory(workspace, artifact):
-    root = Path(workspace) / 'widget-assets'
-    path = root / artifact['hash']
-    core.require(re_full_hash(artifact['hash']) and not root.is_symlink() and not path.is_symlink(), 'WIDGET_ASSET_PATH', '小挂件资源目录无效。')
-    return path
-
-
-def re_full_hash(value):
-    return isinstance(value, str) and len(value) == 64 and all(c in '0123456789abcdef' for c in value)
-
-
-def render(workspace, state, artifact):
-    import widgets
-    item = next(i for i in widgets.items(state) if i['id'] == artifact['data']['widgetId'])
-    output = directory(workspace, artifact)
-    output.mkdir(parents=True, exist_ok=True)
-    from completion import _atomic
-    for name, raw in files(artifact, item).items():
-        core.require(not (output / name).is_symlink(), 'WIDGET_ASSET_PATH', '资源文件不能为符号链接。')
-        _atomic(output / name, raw)
-
-
-def asset_status(workspace, artifact, state=None):
-    if not artifact:
-        return {'pass': False, 'message': '原型尚未生成'}
-    try:
-        import widgets
-        state = state or core.load(workspace)
-        core.require(artifact['data'].get('rendererVersion') in (1, 2, 3, 4), 'WIDGET_RENDERER_VERSION', '原型模板版本已变化，需要重新生成并确认设计。')
-        item = next(i for i in widgets.items(state) if i['id'] == artifact['data']['widgetId'])
-        core.require(widgets.item_hash(item) == artifact['data']['itemHash'], 'WIDGET_ITEM_STALE', '清单项已更新，需要重绘原型。')
-        output = directory(workspace, artifact)
-        expected = files(artifact, item)
-        for name, raw in expected.items():
-            path = output / name
-            core.require(not path.is_symlink() and path.read_bytes() == raw, 'WIDGET_ASSET_CHANGED', '原型资源缺失或被修改，请用 widget_render 恢复当前版本。', {'file': name})
-        return {'pass': True, 'message': '尺寸、字体、只读控件及两视图三态资源检查通过；内容和阅读体验由开发者单独验收。',
-                'files': [{'name': name, 'sha256': hashlib.sha256(raw).hexdigest()} for name, raw in expected.items()]}
-    except (core.BuddyError, OSError, StopIteration, KeyError, ValueError) as error:
-        return {'pass': False, 'message': str(error) or '当前资源不可用，请重新生成原型。'}
-
-
-def require_assets(workspace, state, artifact):
-    status = asset_status(workspace, artifact, state)
-    core.require(status['pass'], 'WIDGET_ASSETS_REQUIRED', status['message'])

package/resources/buddy-creator/scripts/widget_render_v1.py

@@ -1,176 +0,0 @@
-"""Deterministic, portable read-only prototypes. No supplied executable H5."""
-import hashlib
-import html
-import json
-from pathlib import Path
-
-import buddy_core as core
-
-CSS = '''*{box-sizing:border-box}html,body{margin:0;width:100%;height:100%;font:400 16px/1.5 -apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;color:#222;background:#fff}button{font:inherit;color:inherit;cursor:pointer}button:focus-visible,a:focus-visible,summary:focus-visible{outline:3px solid var(--accent);outline-offset:3px}header{height:88px;display:flex;align-items:center;justify-content:space-between;padding:28px 20px 12px;font-weight:500}main{padding:12px 16px 100px}.bubble{background:#f1f3f4;border-radius:18px;padding:14px 16px;margin:12px 0;max-width:calc(100% - 36px);white-space:pre-wrap;overflow-wrap:anywhere}.user{margin-left:auto;background:#e5f6fc}.buddy{margin-left:32px}.chat-card{margin:16px 0 0 32px;border:1px solid #eee;border-radius:18px;padding:16px;max-width:calc(100% - 32px)}h1,h2,h3,p{margin:0}h1,h2,h3{font-weight:500;font-size:var(--title-size)}.chat-card p{margin:12px 0;white-space:pre-wrap;overflow-wrap:anywhere}.open{width:100%;background:#f1f3f4;border:0;border-radius:12px;padding:9px}.caption{color:#73777c;font-size:13px;margin-top:12px}.composer{position:fixed;bottom:20px;left:16px;right:16px;background:#f7f8f9;border:1px solid #eee;border-radius:14px;padding:12px;color:#767b80;font-size:14px}.overlay{position:fixed;inset:0;background:#0003;display:grid;place-items:center}.overlay[hidden],.detail[hidden]{display:none}.sheet{width:calc(100% - 32px);height:65%;background:#fff;border-radius:24px;display:flex;flex-direction:column;overflow:hidden;box-shadow:0 20px 80px #0001}.sheet-head{display:flex;align-items:center;gap:12px;padding:16px;flex:none;border-bottom:1px solid #f1f1f1}.sheet-head h2{flex:1;text-align:center;overflow-wrap:anywhere}.close{border:1px solid #eee;background:#fff;border-radius:50%;width:36px;height:36px;flex:none}.spacer{width:36px}.scroll{overflow-y:auto;overscroll-behavior:contain;padding:16px;flex:1;min-height:0}.tabs,.filters{display:flex;gap:8px;overflow-x:auto;padding:2px 2px 14px;flex:none}.tabs button,.filters button{flex:none;border:1px solid #eceff1;background:#f1f3f4;border-radius:28px;padding:10px 16px;font-size:16px}.tabs button[aria-pressed=true],.filters button[aria-pressed=true]{border:2px solid var(--accent);padding:9px 15px;font-weight:500}.section{margin:8px 0 22px}.section h3,summary{margin:0 0 12px;font-size:16px;font-weight:500}summary{cursor:pointer}.row{padding:10px 0;border-bottom:1px solid #f2f3f4;overflow-wrap:anywhere}.row-label{color:#777;margin-bottom:4px}.row-value{white-space:pre-wrap}.detail-open{border:0;background:#f1f3f4;border-radius:8px;padding:6px 10px;margin-top:8px;font-size:14px}.cards .row{padding:14px;border-radius:14px;background:#f7f8f9;margin-bottom:10px;border:0}.timeline .row{border-left:2px solid var(--accent);padding-left:16px;margin-left:4px;border-bottom:0}.detail{position:absolute;inset:0;background:#0003;display:grid;place-items:center}.detail-box{width:calc(100% - 32px);max-height:60%;overflow:auto;border-radius:20px;padding:20px;background:#fff;white-space:pre-wrap;overflow-wrap:anywhere}.detail-box button{float:right}.note{font-size:14px;color:#73777c;margin-top:20px}.screen-title{max-width:75%;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}@media(prefers-reduced-motion:no-preference){button{transition:background .15s ease}}'''
-
-JS = '''"use strict";
-const data=JSON.parse(document.getElementById("prototype-data").textContent);
-const params=new URLSearchParams(location.search);
-const index=Math.max(0,data.states.findIndex(s=>s.id===params.get("state")));
-const sample=data.states[index], interactions=data.interactions;
-const make=(tag,text,cls)=>{const e=document.createElement(tag);if(text!==undefined)e.textContent=text;if(cls)e.className=cls;return e;};
-document.documentElement.style.setProperty("--accent",data.design.accent);
-document.documentElement.style.setProperty("--title-size",data.design.titleSize+"px");
-document.querySelector(".screen-title").textContent=data.name;
-const main=document.querySelector("main");
-main.append(make("div",sample.userMessage,"bubble user"),make("div",sample.buddyMessage,"bubble buddy"));
-const card=make("article",undefined,"chat-card");card.append(make("h1",data.name),make("p",sample.summary));
-const open=make("button","去查看","open");card.append(open,make("div","内容随对话更新","caption"));main.append(card);
-const overlay=document.querySelector(".overlay"),scroll=document.querySelector(".scroll"),detail=document.querySelector(".detail");
-document.querySelector(".sheet-head h2").textContent=data.name;
-scroll.classList.add(data.design.layout);
-let selected=interactions.includes("tabs")?sample.sections[0].id:"all";
-function render(){scroll.replaceChildren();
- for(const mode of ["tabs","filter"]){if(!interactions.includes(mode))continue;
- const nav=make("nav",undefined,mode==="tabs"?"tabs":"filters");nav.setAttribute("aria-label",mode==="tabs"?"切换阅读分组":"筛选已有内容");
- const options=mode==="filter"?[{id:"all",title:"全部"},...sample.sections]:sample.sections;
- for(const section of options){const b=make("button",section.title);b.setAttribute("aria-pressed",String(section.id===selected));b.onclick=()=>{selected=section.id;render();};nav.append(b);}scroll.append(nav);}
- for(const section of sample.sections){if(selected!=="all"&&section.id!==selected)continue;
- const group=make(interactions.includes("collapse")?"details":"section",undefined,"section");
- if(group.tagName==="DETAILS")group.open=true;
- group.append(make(group.tagName==="DETAILS"?"summary":"h3",section.title));
- for(const row of section.rows){const cell=make("div",undefined,"row");cell.append(make("div",row.label,"row-label"),make("div",row.value,"row-value"));
- if(row.detail){const b=make("button","查看说明","detail-open");b.onclick=()=>{document.querySelector(".detail-text").textContent=row.detail;detail.hidden=false;detail.querySelector("button").focus();detail.returnFocus=b;};cell.append(b);}group.append(cell);}scroll.append(group);}
- scroll.append(make("p","如需修改内容，请回到对话中告诉搭子。","note"));}
-function closeDetail(){detail.hidden=true;if(detail.returnFocus)detail.returnFocus.focus();}
-function closeSheet(){closeDetail();overlay.hidden=true;open.focus();}
-open.onclick=()=>{overlay.hidden=false;overlay.querySelector("button").focus();};
-document.querySelector(".sheet-close").onclick=closeSheet;
-document.querySelector(".detail-close").onclick=closeDetail;
-document.addEventListener("keydown",e=>{if(e.key==="Escape"){if(!detail.hidden)closeDetail();else if(!overlay.hidden)closeSheet();}
- if(e.key==="Tab"&&!overlay.hidden){const area=detail.hidden?document.querySelector(".sheet"):document.querySelector(".detail-box");const nodes=[...area.querySelectorAll("button,summary")].filter(n=>n.getClientRects().length);const first=nodes[0],last=nodes[nodes.length-1];if(e.shiftKey&&document.activeElement===first){e.preventDefault();last.focus();}else if(!e.shiftKey&&document.activeElement===last){e.preventDefault();first.focus();}}});
-render();overlay.hidden=params.get("view")!=="expanded";
-'''
-
-
-def _svg(data, sample, expanded):
-    """Export two annotated visual views per data state; HTML is the full scrollable view."""
-    d = data['design']
-    w, h = d['screenWidth'], d['screenHeight']
-    parts = ['<svg xmlns="http://www.w3.org/2000/svg" width="%s" height="%s" viewBox="0 0 %s %s"><rect width="100%%" height="100%%" fill="white"/><g font-family="-apple-system, sans-serif" font-size="16" fill="#222">' % (w, h, w, h)]
-    def rect(x, y, width, height, fill, radius=16):
-        parts.append('<rect x="%s" y="%s" width="%s" height="%s" rx="%s" fill="%s"/>' % (x, y, width, height, radius, fill))
-    def lines(text, x, y, width, limit=4, size=16, weight=400):
-        chars, current, measured = [], '', 0
-        for ch in text:
-            measure = size if ord(ch) > 127 else size * .55
-            if measured + measure > width or ch == '\n':
-                chars.append(current); current, measured = '', 0
-            if ch != '\n':
-                current += ch; measured += measure
-        if current:
-            chars.append(current)
-        if len(chars) > limit:
-            chars = chars[:limit]; chars[-1] = chars[-1][:-1] + '…'
-        for i, line in enumerate(chars):
-            parts.append('<text x="%s" y="%s" font-size="%s" font-weight="%s">%s</text>' % (x, y + i * (size + 8), size, weight, html.escape(line)))
-        return y + len(chars) * (size + 8)
-    lines('9:41', 24, 28, 70, 1, 14, 500)
-    lines(data['name'], 48, 73, w-96, 1, 16, 500)
-    rect(64, 106, w-80, 82, '#e5f6fc'); lines(sample['userMessage'], 80, 133, w-112, 2)
-    rect(48, 204, w-64, 106, '#f1f3f4'); lines(sample['buddyMessage'], 64, 230, w-96, 3)
-    rect(48, 326, w-64, 178, '#fafafa'); lines(data['name'], 64, 354, w-96, 1, d['titleSize'], 500)
-    lines(sample['summary'], 64, 386, w-96, 2)
-    rect(64, 442, w-96, 42, '#eff1f3', 10); lines('去查看', w/2-24, 469, 80, 1)
-    rect(16, h-80, w-32, 52, '#f6f7f8', 12); lines('在对话中告诉搭子你的修改', 32, h-48, w-64, 1, 14)
-    if expanded:
-        parts.append('<rect width="100%" height="100%" fill="#000" opacity=".18"/>')
-        height = h*.65; top = (h-height)/2
-        rect(16, top, w-32, height, '#fff', 24)
-        lines('×', 32, top+38, 28, 1, 20); lines(data['name'], 76, top+37, w-128, 1, d['titleSize'], 500)
-        parts.append('<defs><clipPath id="content"><rect x="32" y="%s" width="%s" height="%s"/></clipPath></defs><g clip-path="url(#content)">' % (top+64, w-64, height-100))
-        y = top+89
-        if 'tabs' in data['interactions'] or 'filter' in data['interactions']:
-            x=32
-            for section in sample['sections'][:3]:
-                rect(x, y-21, 84, 42, '#f1f3f4', 20); lines(section['title'], x+10, y+5, 64, 1); x+=92
-            y+=54
-        sections = sample['sections'][:1] if 'tabs' in data['interactions'] else sample['sections']
-        for section in sections:
-            y=lines(section['title'], 32, y, w-64, 2, 16, 500)+8
-            for row in section['rows']:
-                x, width = 32, w-64
-                if d['layout'] == 'cards':
-                    rect(32, y-18, w-64, 116 if row.get('detail') else 92, '#f7f8f9', 14)
-                    x, width, y = 46, w-92, y+4
-                elif d['layout'] == 'timeline':
-                    rect(36, y-16, 2, 84, d['accent'], 0)
-                    x, width = 52, w-84
-                parts.append('<g fill="#777">')
-                y=lines(row['label'], x, y, width, 1)+2
-                parts.append('</g>')
-                y=lines(row['value'], x, y, width, 2)
-                if row.get('detail'):
-                    y=lines('查看说明', x, y+4, width, 1, 14)
-                y+=22
-        parts.append('</g>')
-        lines('上下滚动阅读 · 修改请通过对话', 32, top+height-20, w-64, 1, 14)
-    parts.append('</g></svg>')
-    return ''.join(parts).encode('utf-8')
-
-
-def files(artifact, item=None):
-    data = artifact['data']
-    # The exact template contract travels with the prototype; callers supply the confirmed item.
-    item = item or artifact.get('renderItem')
-    core.require(item, 'WIDGET_RENDER_ITEM', '生成原型需要对应清单项。')
-    value = {**data, 'name': item['name'], 'interactions': item['readInteractions']}
-    raw_json = json.dumps(value, ensure_ascii=False).replace('<', '\\u003c').replace('>', '\\u003e').replace('&', '\\u0026')
-    page = '''<!doctype html><html lang="zh-CN"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>小挂件原型</title><link rel="stylesheet" href="style.css"></head><body><header><span>‹</span><span class="screen-title"></span><span>···</span></header><main></main><div class="composer">在对话中告诉搭子你的修改</div><div class="overlay" hidden><section class="sheet" role="dialog" aria-modal="true" aria-label="小挂件展开页"><div class="sheet-head"><button class="close sheet-close" aria-label="关闭小挂件">×</button><h2></h2><span class="spacer"></span></div><div class="scroll"></div></section><div class="detail" hidden><section class="detail-box" role="dialog" aria-modal="true" aria-label="只读详情"><button class="close detail-close" aria-label="关闭详情">×</button><p class="detail-text"></p></section></div></div><script type="application/json" id="prototype-data">''' + raw_json + '''</script><script src="app.js"></script></body></html>'''
-    result = {'index.html': page.encode('utf-8'), 'style.css': CSS.encode('utf-8'), 'app.js': JS.encode('utf-8')}
-    for sample in data['states']:
-        for view in ('chat', 'expanded'):
-            result[view+'-'+sample['id']+'.svg'] = _svg(value, sample, view == 'expanded')
-    return result
-
-
-def directory(workspace, artifact):
-    root = Path(workspace) / 'widget-assets'
-    path = root / artifact['hash']
-    core.require(re_full_hash(artifact['hash']) and not root.is_symlink() and not path.is_symlink(), 'WIDGET_ASSET_PATH', '小挂件资源目录无效。')
-    return path
-
-
-def re_full_hash(value):
-    return isinstance(value, str) and len(value) == 64 and all(c in '0123456789abcdef' for c in value)
-
-
-def render(workspace, state, artifact):
-    import widgets
-    item = next(i for i in widgets.items(state) if i['id'] == artifact['data']['widgetId'])
-    output = directory(workspace, artifact)
-    output.mkdir(parents=True, exist_ok=True)
-    from completion import _atomic
-    for name, raw in files(artifact, item).items():
-        core.require(not (output / name).is_symlink(), 'WIDGET_ASSET_PATH', '资源文件不能为符号链接。')
-        _atomic(output / name, raw)
-
-
-def asset_status(workspace, artifact, state=None):
-    if not artifact:
-        return {'pass': False, 'message': '原型尚未生成'}
-    try:
-        import widgets
-        state = state or core.load(workspace)
-        core.require(artifact['data'].get('rendererVersion') == 1, 'WIDGET_RENDERER_VERSION', '原型模板版本已变化，需要重新生成并确认设计。')
-        item = next(i for i in widgets.items(state) if i['id'] == artifact['data']['widgetId'])
-        core.require(widgets.item_hash(item) == artifact['data']['itemHash'], 'WIDGET_ITEM_STALE', '清单项已更新，需要重绘原型。')
-        output = directory(workspace, artifact)
-        expected = files(artifact, item)
-        for name, raw in expected.items():
-            path = output / name
-            core.require(not path.is_symlink() and path.read_bytes() == raw, 'WIDGET_ASSET_CHANGED', '原型资源缺失或被修改，请用 widget_render 恢复当前版本。', {'file': name})
-        return {'pass': True, 'message': '尺寸、字体、只读控件及两视图三态资源检查通过；内容和阅读体验由开发者单独验收。',
-                'files': [{'name': name, 'sha256': hashlib.sha256(raw).hexdigest()} for name, raw in expected.items()]}
-    except (core.BuddyError, OSError, StopIteration, KeyError, ValueError) as error:
-        return {'pass': False, 'message': str(error) or '当前资源不可用，请重新生成原型。'}
-
-
-def require_assets(workspace, state, artifact):
-    status = asset_status(workspace, artifact, state)
-    core.require(status['pass'], 'WIDGET_ASSETS_REQUIRED', status['message'])