文档信息
- 文档类型：第二大脑Wiki文档
- 归属项目：龙虾AI工具馆（520多Agent版）2.0架构体系
- 核心定位：定义2.0全新「先研讨、后执行」标准化工作流，统一UI交互、用户操作、底层调度逻辑，根治1.0盲目执行、黑盒运行、本地误切云端等核心问题
- 制定人：boss丁
- 生效版本：2.0模块化架构专属
一、设计核心初衷（解决1.0全部痛点）
1.1 1.0核心缺陷
1. 无前置校验机制：用户输入指令后系统直接执行，高风险任务、模糊任务盲目运行，极易触发超时、降级云端、逻辑报错问题； 2. 执行全程黑盒：用户无法查看模型调度、本地/云端分流、推理卡顿、超时卡点等运行过程，问题排查难度极大； 3. 无任务分级逻辑：简单任务、复杂任务、高风险架构任务共用一套执行逻辑，资源浪费+容错率极低； 4. 协作无标准：双AI研讨、方案确认、代码执行无固定流程，迭代混乱、无归档依据。
1.2 2.0模式核心价值
1. 建立强制前置研讨+可视化执行的标准化流程，所有任务「先确认方案，再落地执行」； 2. 分层适配不同复杂度任务，兼顾普通用户轻量化使用、开发人员深度调试需求； 3. 全程透明化运行，彻底解决本地模型卡顿、偷偷切云端、超时崩溃等疑难bug； 4. 不冗余UI界面，采用默认极简+按需激活设计，避免界面繁杂臃肿； 5. 完美适配2.0模块化调度架构、本地离线核心卖点、双AI协作开发模式。
二、双模式核心定义（Ask / Play）
2.1 Ask 研讨模式（决策前置模式）
适用场景
所有中高风险、模糊需求、架构改造、代码重构、参数调优、新功能搭建任务，强制启用。
1. 系统架构调整、模块拆分、底层代码修改； 2. Ollama本地参数、超时规则、分流逻辑配置修改； 3. 用户指令模糊、需求不明确、存在歧义的任务； 4. 所有可能触发云端降级、模型报错、系统崩溃的高危操作。
核心运行规则
1. 触发后禁止直接执行任何运算，不调用本地14B、不请求云端接口； 2. 系统自动拆解任务：分级判定（简单/中等/重度）、预判风险、给出2套以上执行方案、标注本地/云端分流策略； 3. 自动抛出待确认疑点、潜在bug、执行禁忌，等待用户确认； 4. 用户确认方案、敲定细节后，方可切换Play模式启动正式执行； 5. 全程自动留存研讨记录，同步归档至第二大脑，形成决策依据。
2.2 Play 执行模式（落地运行模式）
适用场景
所有需求明确、低风险、常规轻量化任务（95%用户日常使用场景）
1. 日常问答、文案生成、代码片段编写、内容总结； 2. 既定方案的落地执行、重复性常规操作； 3. 已通过Ask模式确认完毕的架构/代码改造任务。
核心运行规则
1. 仅在用户确认方案后激活，全自动闭环执行； 2. 全程可视化运行，实时展示调度流程、模型状态、推理进度； 3. 严格遵循2.0分流规则：中等及以下任务强制本地、重度任务云端兜底； 4. 运行中实时日志输出，卡点、超时、异常自动预警； 5. 执行完毕自动生成复盘总结，归档工作日志与Wiki记录。
三、2.0 UI界面适配方案（极简不臃肿核心设计）
3.1 界面布局原则
拒绝固定常驻双按钮导致界面杂乱，采用默认隐藏+按需展示+状态记忆极简设计，兼顾美观与功能性：
1. 普通用户默认极简模式：隐藏高级模式按钮，输入指令直接默认Play执行，无感使用； 2. 高级用户/开发模式：顶部导航栏悬浮展示【模式切换】下拉按钮，替代两个独立按钮，避免界面冗余； 3. 模式状态实时显示：对话顶部小字轻量标注「当前模式：Ask研讨 / Play执行」，无视觉负担； 4. 记忆用户偏好：自动留存上一次使用模式，无需重复切换。
3.2 UI核心功能细节
3.2.1 模式切换入口
- 入口形态：顶部轻量化下拉菜单（仅2个选项：Ask研讨模式、Play执行模式）
- 默认状态：普通用户默认Play模式，适配日常轻量化使用
- 权限适配：可在后台配置「高危任务强制锁定Ask模式」，禁止直接执行
3.2.2 专属可视化面板（2.0核心新增）
切换任意模式后，底部自动弹出轻量运行过程面板（可手动收起），展示核心运行信息：
1. 任务分级结果：简单/中等/重度任务标注； 2. 调度链路：本地14B执行 / 云端执行 / 混合执行； 3. 运行进度：推理耗时、token生成速率、显存占用状态； 4. 异常预警：超时倒计时、降级风险、模型卡顿提示； 5. 操作按钮：暂停执行、终止任务、重新研讨、强制本地锁定。
3.3 界面优势总结
1. 不破坏原有简洁UI，无多余按钮堆砌，兼顾颜值与高级功能； 2. 区分普通用户与开发用户场景，千人千态适配使用需求； 3. 可视化面板彻底告别黑盒运行，问题一键溯源； 4. 成为2.0独家差异化卖点，碾压市面无脑执行的通用AI工具。
四、底层架构调度适配（2.0模块化专属）
4.1 模式优先级规则
1. Ask模式优先级 > Play模式； 2. 高危任务强制锁定Ask模式，用户无法跳过研讨直接执行； 3. /本 /云 前缀指令可与双模式叠加，优先级：前缀指令 > 模式规则。
4.2 模块联动逻辑
1. router.js 路由层：负责模式识别、任务分级、前置拦截，是双模式核心调度入口； 2. model-service.js 模型层：仅接收Play模式指令执行运算，拒绝Ask模式直接调用； 3. context.js 上下文层：全程记录模式状态、研讨记录、运行日志，用于归档复盘； 4. utils/logger.js 日志层：实时推送运行数据至UI可视化面板。
4.3 根治历史核心bug的底层逻辑
1. Ask前置研讨：提前预判本地超时、云端降级风险，从源头规避误切云端问题； 2. Play可视化监控：实时监测本地推理速度，提前预警4分钟超时卡点； 3. 分层执行：杜绝1.0单文件盲目兜底、补丁式修bug的底层缺陷。
五、标准化完整工作流（2.0官方唯一流程）
1. 用户输入指令 → 路由层自动判定任务风险等级； 2. 高危/模糊任务：自动进入Ask模式 → 输出方案+风险+疑点 → 用户确认； 3. 确认完成 → 切换Play模式 → 系统可视化全自动执行； 4. 运行全程可监控、可暂停、可终止； 5. 执行结束 → 自动生成工作总结 → 同步归档Wiki+工作日志； 6. 同类任务下次直接复用已确认方案，无需重复研讨。
六、版本迭代说明
1. 该双模式体系为2.0架构核心标配功能，1.0版本不兼容、不迁移； 2. 后续520多Agent调度系统，将完全基于该Ask/Play双模式逻辑迭代； 3. 所有架构改造、代码开发、功能迭代，必须严格遵循「先Ask研讨、后Play执行」流程； 4. 永久解决：本地模型卡顿排查难、强制本地误切云端、高危操作改错、黑盒运行四大痛点。
七、产品差异化卖点总结
1. 行业独有「前置研讨+可视化执行」双模式AI交互体系； 2. 普通用户无感流畅使用，专业用户具备极致可控性； 3. 彻底平衡UI简洁度与功能专业性，无臃肿、无缺失； 4. 本地离线场景稳定性、可控性远超所有通用云端AI工具。
