@givolt/i3-composer-agent 2.3.7 → 3.1.0

package/docs/ui-prototype-native/MAIN-SESSION-REPORT.md

@@ -1,66 +0,0 @@
-# 主会话原型改造验证报告
-
-<!-- i3:zh-guide:start -->
-## 中文使用说明
-
-按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
-
-默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
-<!-- i3:zh-guide:end -->
-
-日期：2026-10-17。源码分支：feature/prototype-native-pilot。首期为CodeBuddy＋admin-list小模板＋Vue 3/antDv-next设备流程。实施及样例技术验收完成，补充复核后的当前收据已完成；用户视觉/业务评审仍为pending-review。正式main与上游保全基线未变，未合并或发布。
-
-## 已完成改造
-
-取消prototype-specialist专责Agent、常驻分派规则及父子JSON强制；自然语言、using、/i3-prototype、直接Skill均由主会话执行。using以原版aeac41d4为基线，只增加普通原型分支和Quick Reference行；移除两行后SHA256为30787ef2c77bf1a4729fffed0f6523ba6fcbe81bdc436b36371b78c21394d3c3。三宿主命令格式仍是薄入口，不承担企业调度。
-
-企业SOP在外层组织PRD、设计取舍、制作、技术验证、人工认可与工程交接；原型Skill按需复用前端、官方框架、UIUX和浏览器方法。业务/技术规格、任务tracker及正式发布仍依上游方法，不增加企业审批库或专属Agent。
-
-HTML继续可离线修改，是内容和能力输入。生成原型采用真实ConfigProvider/Table/Form/Drawer等组件；本次需求明确绑定“明亮、暗黑、清新、科技”，首次默认明亮，页面内切换，不重挂应用或丢失筛选/页码/选择/未保存输入。旧HTML及未绑定主题的固定实例不自动加入主题、不重写摘要。模板内容和最终框架效果分别验证。
-
-已有安装按清单归属＋已审原字节指纹安全退出旧角色/规则；修改过、来源不明的受管退出资产会阻断，force不绕过；用户文件保留。维护宿主工具不自动成为上游/全局Hook。
-
-## 主要实证
-
-证据根：工作区artifacts/verification/prototype-main-session-20261017/。
-
-| 范围 | 实际结果 | 证据 |
-|---|---|---|
-| 源码与分发 | 全回归528/528、零跳过；实际打包/安装各340/340；最终冻结复验以相邻JSON/log为准 | source-final-guidance.*、source-delivery-final.*、candidate-3-*-test.*、delivery-package/ |
-| 退出与升级 | 真实旧tgz→新tgz项目/global角色5→4，用户规则保留；16项迁移保护通过 | installation/real-upgrade-RESULT.json |
-| 离线HTML | 实际断网file://修改、展示、同步提取，3本地请求、0外部请求/console错误，未起服务 | offline-html-check/ |
-| CLI四入口 | 真实Skill调用、完整分析回传，无Agent；734文件前后同一，SDK/工具/缓存未变 | ENTRY-MATRIX.json、probe-*/ |
-| CodeBuddy IDE入口 | 实际识别/展开命令、UseSkill及主会话中文回传，732安装文件比较无异常差异 | ide-command/ |
-| 全新业务冷生成 | 100工具/22MCP，无Agent，processComplete=true；官方/前端/browser Skill及真实UIUX查询/设计/构建；7/7单测、类型与构建通过 | cold-main-session-v2/、cold-v2-preflight.json |
-| 完整原型专项 | 23/23、零console错误/警告，同一candidate/build，含四主题/状态/偏好/隔离、Drawer动效/毛玻璃/焦点、窄屏/键盘和故障对照 | cold-project-v2/prototypes/main-devices/qa/runs/chrome-1792253902290/ |
-| UIUX实际Skill复查 | Skill(ui-ux-pro-max)真实加载，31工具，零文件/缓存变更；采纳/拒绝与效果分别核对，无阻断 | uiux-final-review/ |
-| 真实交互DevTools补录 | 实际browser Skill，44次MCP/51工具，trace含13 click/1 input，六类观测与操作后console/network已保存；48轮上限后无最终模型回复，未算该轮自动完成 | devtools-interaction-supplement/ |
-| 独立输入/焦点诊断 | 实际固定MCP原生Backspace恢复21；空名保存拒绝、错误/焦点/抽屉/列表均正确，console0 | mcp-empty-fill-diagnostic/run-006/ |
-| 审定与交付 | 原始事件审计、修正登记后build/browser/devtoolsReview/delivery均current，nextAction=return-result；passed、pending-review | FINAL-COLD-AUDIT.json、audited-state-final.json、实例qa/delivery.json |
-| 兼容保护 | 337摘要/模式未变、原先REPORT/TASKS字节前缀保留；旧v1/v2固定合同不追随新模板 | protected-current.json |
-
-当前原型：main-devices/r001，candidateDigest=793e0a1eee86bad6e9a081548840cc6408aded05347fa8485f050611f71f1954；buildId=b-193a4dfa2f1be867ceb1，buildDigest=193a4dfa2f1be867ceb103690bdc451ceabcbee0ef29875d388fc420c88f637c。
-
-## 发现、修复与证据纠正
-
-真实冷运行发现原生分页内部隐藏链接仍能获得焦点。中央starter只将page项渲染为不可聚焦span，保留外层LI及鼠标/键盘；新固定快照启用paginationFocusGuard，旧快照缺字段维持原合同。AX普通鼠标可复现、故障负例能失败、修复后的23项与零候选warning均有实证。
-
-CodeBuddy2.168.2初层fill参数scalar与后层完整对象换ID格式，维护宿主已做极窄兼容（固定managed1.11.0、非只读、精确PreToolUse和fill），19/19及独立审查通过，实际新补录也无auditDenied。不能据此建立通用跨层deny绑定保证；实际文件边界另由OS策略及差异证明，不扩大写目录，不改上游Hook/全局配置。
-
-独立审计发现初版模型报告的时区错误、调用ID占位、MCP网络摘要和冷缓存措辞不实，性能trace只覆盖reload。原始字节与原最终回复保留，未接受其自评结论。当前报告从真实UTC/call_*生成；MCP仅确认URL/状态，真实响应字节SHA来自独立Playwright观测。UIUX原生成有provider查询但没有Skill调用，真实Skill复查由后续只读阶段完成，不改写历史。
-
-补录的完整五分钟交互trace解压70,406,491字节，登记器64MiB边界正确拒绝。原件未改；以明确标注来源、摘要和窗口的前120秒连续原事件导出登记（34,338,470字节、7 click/1 input），不改上限、不筛事件类别、不宣称该片段就是完整录制。索引在实例qa/devtools/audited/trace-excerpt-index.json。
-
-另独立复现固定MCP1.11.0的空fill直接清DOM而未发input/change：查询/校验仍读旧绑定。正常键盘/Playwright为空可正确工作。真实MCP以当前文本和末尾光标为准逐次Backspace验证通过；Meta+A/Control+A未全选、空格可能追加旧值等失败保留。自有Skill已补实测指引，上游浏览器Skill/MCP/组件库不改。该工具事件问题与宿主scalar参数兼容分别记录。诊断run-004在抛弃的独立profile中误做一次非空保存已披露；通过run-006无成功保存，应用文件、共享模型profile、旧QA均未变。
-
-第一次源码/机械浏览器失败、第一次冷生成120轮未完、维护者误期待revise自动刷新快照而停止的阶段、补录48轮上限、客户端参数/解析错误、64MiB拒绝均保留。revise只接受已整理输入摘要，不自动迁移framework；旧实例未手补新字段。
-
-## 结论边界
-
-首期样例经过实际主会话制作、专项回归及补充复核后具备待评审交付条件。不能扩展为所有模型/宿主/页面或单轮无人复核都可靠。短种子未触发长文本ellipsis的专门视觉用例，未声称该效果已经实测。技术验证不代替人类认可，不执行confirm-baseline。
-
-四CLI入口和IDE入口来自C1；C2的using/三命令字节相同，C2完成新业务冷生成。其后仅自有输入事件指引与维护文档修订；最终包与C2实现/模板/框架/浏览器执行器/入口的字节比较、精确包摘要和最终打包/安装结果以delivery-package/及FINAL-PACKAGE.json为准，不冒认最终说明版本另跑了一次完整冷生成。
-
-只读CLI的工具限制、OS写保护及零缓存结论不外推到任意IDE/全工具配置；IDE实际界面请求保留无害残留前缀，项目根重定位只归一确切安装路径，不对用户级会话日志宣称零写入。可写冷生成使用独立npm缓存产生正常依赖缓存/日志；SDK与固定工具未改。
-
-本次改造提交保留在试点分支，未安装覆盖用户现有全局环境、未合并、未发布。最终可预览当前候选，仍需用户针对明确revision/digest进行业务和视觉评审。

package/docs/ui-prototype-native/USAGE.md

@@ -1,93 +0,0 @@
-# 原型制作与续接
-
-<!-- i3:zh-guide:start -->
-## 中文使用说明
-
-按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
-
-默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
-<!-- i3:zh-guide:end -->
-
-当前默认内容模板为完整企业管理后台，生成目标为 Vue3＋antDv-next。HTML 参考可以离线编辑；生成的框架工程需要安装依赖、构建并启动预览。安装方式见 [CodeBuddy 说明](../codebuddy-setup.md)。
-
-## 在 CodeBuddy 发起
-
-```text
-/i3-prototype analyze 根据 PRD 分析原型范围和模板适用能力，先不写入或安装
-/i3-prototype create 根据 PRD，参考完整 enterprise-admin 模板，生成 Vue3＋antDv-next 原型，ID 为 assets
-```
-
-自然语言、命令、using 选择及直接调用 Skill 均由主会话执行，无原型专责 Agent。using 按普通发现逻辑选择原型 Skill；原型流程按阶段复用前端、官方框架、UIUX 和浏览器能力，避免一次加载全部模板、依赖源码及历史日志。
-
-只读分析交付覆盖、选型、验收计划及缺口，不创建原型、安装依赖、启动浏览器或保存用户级记忆。创建／修订的写入限于本次项目与明确范围，长期记忆、全局配置及其他项目另需明确授权。
-
-## 可选官方 Skill 与后续检测
-
-从业务项目根运行：
-
-```sh
-node .codebuddy/skills/i3-ui-prototype/scripts/prototype-dependencies.cjs check --project .
-# 以下仅在明确选择安装后执行，可单独选 uiux 或 antdv：
-node .codebuddy/skills/i3-ui-prototype/scripts/prototype-dependencies.cjs install --project . --skills uiux,antdv
-```
-
-i3 默认不安装这两项依赖，跳过不永久禁用。后续补装后重新检测即可，无需重装 i3；必要时重载 CodeBuddy 窗口或新建会话让宿主发现。已有可用全局 UIUX 可复用，已有第三方技能和工具不覆盖。缺 Python 仅报告，不安装系统运行环境。官方正文、许可、版本和来源保留，详情见已安装 Skill 的 references/optional-skills.md。
-
-UIUX 专业模式为默认，缺少可用查询资源会提示，不静默降级；用户明确选择基础模板模式后仍完成同样业务功能、四主题和验收。安装依赖不会自动改变既有原型的模式、源码或证据。检测不代表真实宿主调用；CodeBuddy 仍须通过其 Skill 工具实际加载。
-
-antDv 官方 Skill 和组件库是独立部分：未安装 Skill 时可使用对应版本官方文档／类型／源码，记录实际渠道；生成工程仍需 antDv-next 库。新工具目录为对应宿主基址下的 tools/i3-prototype/antdv-cli，支持项目和全局安装；旧 .prototype-tools/antdv-cli 保留读取兼容；只读检测返回可执行的 Node 入口，也识别既有 .prototype-tools/node_modules 布局。固定 CLI 0.0.0-beta.1 的 1.5.2 知识仅作参考，目标组件库 1.5.3 仍核对实际类型／源码。不自动升级 CLI，不以 Error 文本、exit 0 或占位 lint 代替成功。
-
-## 内置模板与业务原型
-
-```sh
-node .codebuddy/skills/i3-ui-prototype/scripts/native-pilot.cjs template-page --page models-page
-```
-
-默认只读使用 Skill 安装目录 assets/templates/enterprise-admin 中随版本发布的完整模板，业务项目不生成 ui-templates。可双击内置 index.html 离线查看；模板内容由维护者在 Skill 源码中修改、校验并随包发布，业务使用期间不修改安装目录。索引在内存只读计算，随生成时的模板、范围与能力快照固定到 inputs。业务修改直接落在 prototypes/<id>/app/，Skill 升级不隐式改写已有原型。
-
-只读取本次相关页面。完整索引提供参考页面、路由和资源清单，不表示自动理解或实现全部旧业务。已有 ui-templates 副本保留，不自动读取、覆盖或删除；明确需要其手工内容时，先显式 sync-template 该副本，再在 create 时传 --template-root <已有目录>。旧 prepare-template 命令继续用于兼容，不是新流程必需步骤。
-
-## 需求范围与创建
-
-主会话根据实际 PRD 整理 schemaVersion=2 的 prototypes/.preparation/assets/scope.json，moduleIds 填实际模块 ID（未关联填 []），索引 appliesTo 自动去重生成：逐页声明业务标题、referencePage、区域类型、需求原文及来源。列表适用查询、复选、分页、批量与状态反馈；编辑区域适用校验、保存失败保留和重试。豁免须有明确需求依据。不能漏报实际区域来逃避能力。
-
-新原型默认提供明亮、暗黑、清新、科技，默认明亮，无编号。列表默认可调分页 10／20／50，默认 10；在 scope 的区域参数中明确覆盖真实需要。旧实例仍按原有固定输入，不追溯修改。
-
-```sh
-node .codebuddy/skills/i3-ui-prototype/scripts/native-pilot.cjs create --project . --id assets --scope prototypes/.preparation/assets/scope.json --host codebuddy
-# 仅在明确选择基础模板模式后，增加 --expert-mode template。
-```
-
-必须提供有来源的 scope，不再自动回退设备演示需求。目标存在时先读取 state，按修订流程保留已有手改，不重新 create。初始化仅提供需求对应的原生框架骨架和主题，business.status 为 needs-adaptation；主会话继续实现实际业务页面、字段、模拟数据和交互后才可验收。
-
-## 实现、构建与真实验收
-
-按需使用 i3-frontend-ui-engineering、可调用的 antDv 官方 Skill、UIUX 查询和取舍。官方 Skill 可调用时先实际加载；无法调用时记录官方资料等效渠道。UIUX 的加载、真实查询、建议采用与效果验证分别有依据。
-
-```sh
-node .codebuddy/skills/i3-ui-prototype/scripts/native-pilot.cjs state prototypes/assets
-node .codebuddy/skills/i3-ui-prototype/scripts/native-pilot.cjs build prototypes/assets --install
-node .codebuddy/skills/i3-ui-prototype/scripts/native-pilot.cjs preview prototypes/assets
-```
-
-首次且允许安装工程依赖时用 --install，之后复用已安装依赖。业务流程覆盖查询、多选、分页、编辑抽屉、校验失败、提交失败、重试保存及列表同步；另验抽屉进入／退出、模糊遮罩、四主题保留状态、窄屏、键盘与焦点恢复。
-
-主会话实际加载 i3-browser-testing-with-devtools，通过 Chrome DevTools MCP 对当前构建检查 DOM／计算样式、截图、console、network、可访问性及性能。缺少工具时保留未验证；读取 Skill、只有截图或运行补充脚本不能冒充该链路通过。浏览器使用项目 localhost 和隔离测试环境。
-
-按 inputs/acceptance.json 的本次业务场景实测，保存真实报告，再登记：
-
-```sh
-node .codebuddy/skills/i3-ui-prototype/scripts/native-pilot.cjs record-run prototypes/assets --report /absolute/path/actual-business-report.json
-node .codebuddy/skills/i3-ui-prototype/scripts/native-pilot.cjs record-devtools-review prototypes/assets --report /absolute/path/actual-devtools-report.json
-node .codebuddy/skills/i3-ui-prototype/scripts/native-pilot.cjs state prototypes/assets
-```
-
-从 state 取得当前准确的 finalize／revise 命令；不要复用修改前摘要。结构校验及报告导入不证明真实 Skill 调用，仍须核对原始宿主调用记录。源码或固定输入变化后重建并重验受影响场景。native-pilot 的历史 browser 子命令仅服务旧设备合同，不适用于新完整模板业务。
-
-## 续接、兼容与交付
-
-新会话先 state 恢复身份、范围、模式、构建与证据，按 nextAction 继续，不重新生成覆盖。已有 v1 HTML 与旧 v2 原生实例按原合同检查，保留原摘要、手改和认可基线；小模板仅保留测试夹具，旧设备框架起点在 legacy-starter，不作为新生成入口。
-
-最终回复给出原型路径、范围、revision、实际模式、已执行检查、证据及未决项。完成本地技术验证仍为 pending-review，人工认可具体 revision／digest 后才能冻结基线；不把骨架、安装通过或自填报告当作业务完成。
-
-共享索引为 prototypes/index.json，旧根索引保持兼容。只安装不创建业务目录；全局 Skill 仍把原型留在业务项目，缓存按宿主与项目隔离。查询、同步、显式迁移和浏览器输出命令见 Skill 的 references/project-layout.md。