stories 是 iii 工作区中面向 React 项目的组件故事（Component Stories）工具，归属于 iii-hq/workers。
用途 它用于审查 UI 代码改动对组件和状态的影响，并支持在不打开浏览器的情况下进行视觉或结构验证。适用于拉取请求、分支或聊天轮次触及 UI 代码时确认哪些组件与状态受到直接或间接影响；也可供智能体获取指定组件状态、指定 props 下渲染出的 DOM、计算样式、布局盒或 React 树；控制台用户还可在聊天旁打开资源管理器或比较视图。
主要能力
- 索引工作区中每个项目的 CSF 故事文件（*.stories.tsx），并使用项目自身的 Vite 构建。
- 组件对应一个故事文件（标题、分组、标签、源文件）；状态对应其一个具名导出（args、argTypes、推断控件）。
- 线（line）表示一棵源码树：worktree（实时）、prev（上一次构建）、HEAD 或 main 之类 ref、完整 sha，或 ide worker 保留轮次快照时的 turn:<session>/<turn>/before|after。
- 比较两条线时，把每个组件分类为直接（其故事文件或直接导入发生变化）、间接（更深层输入变化）、新增、删除或未变更，并列出变更背后的文件。
- stories::screenshot、stories::tree 与 stories::diff 通过浏览器 worker 渲染，冻结时间、随机性、区域和动效，相同输入产生相同像素。
- 在缺少浏览器 worker 与 ADE 时，components::*、compare 和 diff::file 仍可工作。
使用方式 通过 stories::builds::create 触发构建，建议设置 wait: true，或轮询 stories::builds::get；每条线只构建一次并按 sha 缓存。渲染截图、树和差异依赖浏览器 worker 与 ADE（其地址来自 console::status，或已设置的 console_url）。审查工作流可参考 component-review.md：界定影响范围、验证每个受影响状态、撰写报告。
适用场景 拉取请求、分支或聊天轮次改动 UI 代码后的影响面审查；无需人工打开浏览器的视觉或结构验证（按状态、按 prop 值、对照上一版本）；智能体获取指定状态与 props 下的渲染信息；控制台侧边查看资源管理器或比较视图。
限制 不是测试运行器：play 函数、MDX 文档和插件被忽略，交互测试仍由项目自身工具承担。渲染依赖浏览器 worker 和 ADE；缺失时仅组件、比较和文件差异可用。大型单体仓库构建 main 可能耗时数十秒。触及应用单例的故事会携带 error 字段，应读取该字段而非重试。