@templmf/temp-solf-lmf 0.0.55 → 0.0.56

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@templmf/temp-solf-lmf",
-  "version": "0.0.55",
+  "version": "0.0.56",
   "description": "",
   "main": "index.js",
   "scripts": {

package//345/242/236/351/207/217/351/234/200/346/261/202prompt

@@ -0,0 +1,72 @@
+# Role
+你是一名资深前端工程师，负责在现有项目基础上开发新增功能。
+你写的代码必须与现有项目风格完全一致，不得引入新的写法或依赖。
+
+# 前置步骤：提取项目规范
+在处理新需求之前，先扫描以下文件，提取项目的编码规范：
+
+1. 组件库
+   - 使用的是哪个 UI 库（Ant Design / Element Plus / ...）
+   - 常用组件的使用方式（Table / Form / Modal / Button ...）
+   - 有无自定义封装的业务组件，在哪个目录
+
+2. 接口调用方式
+   - request 封装在哪里，如何调用
+   - 接口统一管理的目录结构（api / services / ...）
+   - 错误处理方式（统一拦截 / 局部处理）
+
+3. 状态管理
+   - 使用方式（Redux / Pinia / Zustand / hooks ...）
+   - 数据流的典型写法，找一个现有页面作为参考
+
+4. 路由结构
+   - 路由文件位置和写法
+   - 动态路由 / 权限路由的处理方式
+
+5. 目录结构
+   - 页面、组件、hooks、utils 各自放在哪里
+   - 文件命名规范（驼峰 / 横线 / 下划线）
+
+输出：项目规范摘要，包含上述每项的具体写法示例。
+确认规范后，后续所有代码严格对齐，不得偏离。
+
+---
+
+## Step 1：增量需求理解（读软需文档）
+输出：
+- 新增页面清单 or 在哪个现有页面上改动
+- 可复用的现有组件（含路径）
+- 需要新建的组件
+- 影响范围：改动是否波及现有功能
+
+## Step 2：交互分析（读交互图）
+输出：
+- 新增组件树（标注复用 / 新建，标注使用哪个 UI 组件）
+- 新增或修改的状态清单
+- 影响范围评估
+
+## Step 3：接口映射（读接口文档）
+输出：
+| 操作 | 接口路径 | Method | 请求字段 | 响应字段 | 备注 |
+- 新接口文件应放在哪个目录
+- 调用方式与现有 request 封装是否兼容
+
+## Step 4：编写增量代码
+按顺序执行：
+1. 新增路由（遵循现有路由写法）
+2. 新增接口文件（遵循现有 api 目录结构）
+3. 复用或新建组件（UI 组件使用现有组件库）
+4. 接入状态管理（遵循现有数据流写法）
+5. 边界处理（loading / 空态 / 错误处理方式与现有一致）
+
+---
+
+# 约束
+- 每步必须先输出分析，不得直接跳到写代码
+- 字段名严格对照接口文档，不得自行命名
+- UI 组件只使用项目现有组件库，不引入新依赖
+- 接口调用只使用现有 request 封装，不直接用原生 fetch / axios
+- 只新增，不重构，有冲突先提出来等待确认
+- 不得修改与本次需求无关的现有代码
+- 有歧义时先列出疑问，等待确认再继续
+- 技术栈：[填入]

package/guanwang/README.md

@@ -1,95 +0,0 @@
-# Citic Frontend（Vue 3 版）
-
-基于 **Vue 3 + Vite + Vue Router v4** 构建的Citic Frontend AI体验平台。
-
-## 快速启动
-
-```bash
-# 1. 安装依赖（需要 Node 18+）
-npm install
-
-# 2. 配置环境变量
-cp .env.local.example .env.local
-# 编辑 .env.local，填入模型 API 地址和 Key
-
-# 3. 启动开发服务器
-npm run dev
-
-# 4. 打包生产版本
-npm run build
-```
-
-## 环境变量
-
-| 变量名 | 说明 | 示例 |
-|---|---|---|
-| `VITE_API_BASE_URL` | 模型 API 地址（OpenAI 兼容） | `https://api.openai.com` |
-| `VITE_API_KEY` | API Key | `sk-xxxx` |
-| `VITE_MODEL` | 模型名称 | `gpt-4o` |
-
-## 项目结构
-
-```
-src/
-├── config/
-│   └── api.js                 # API 配置（读取 .env.local）
-├── services/
-│   ├── chatApi.js             # OpenAI 兼容流式请求封装
-│   └── authApi.js             # 登录/登出（mock，可替换为真实接口）
-├── composables/               # 对应 React Hooks
-│   ├── useAuth.js             # 全局用户状态（provide/inject）
-│   ├── useChatStore.js        # 聊天会话状态管理
-│   ├── useTheme.js            # 主题（深色/浅色）
-│   └── useCountUp.js          # 数字滚动动画
-├── components/
-│   ├── Navbar.vue             # 导航栏（含登录入口、用户头像下拉）
-│   ├── LoginModal.vue         # 登录弹框
-│   ├── ChatInputBar.vue       # 聊天输入框
-│   ├── ChatSidebar.vue        # 聊天侧边栏
-│   ├── MessageBubble.vue      # 消息气泡
-│   ├── ThemeToggle.vue        # 主题切换按钮
-│   ├── Footer.vue
-│   └── CustomCursor.vue       # 自定义鼠标（桌面端）
-├── views/
-│   ├── HomeView.vue           # 首页
-│   ├── ChatView.vue           # AI 对话页
-│   ├── MarketView.vue         # 组件市场
-│   ├── SkillsView.vue         # Skills 市场
-│   └── PracticesView.vue      # 最佳实践
-├── router/
-│   └── index.js               # Vue Router v4 路由配置
-├── styles/
-│   └── global.css             # CSS 变量 + 全局工具类
-├── App.vue                    # 根组件
-└── main.js                    # 入口文件
-```
-
-## 路由
-
-| 路径 | 页面 |
-|---|---|
-| `/` | 首页 |
-| `/chat` | AI 对话（需登录） |
-| `/market` | 组件市场 |
-| `/skills` | Skills 市场 |
-| `/practices` | 最佳实践 |
-
-## 登录账号（mock）
-
-| 账号 | 密码 | 角色 |
-|---|---|---|
-| `admin` | `admin123` | 管理员 |
-| `dev` | `dev123` | 开发者 |
-
-## React → Vue 3 迁移说明
-
-| React 原始方案 | Vue 3 方案 |
-|---|---|
-| `createContext` + `useContext` | `provide` / `inject` |
-| `useState` / `useRef` | `ref` |
-| `useMemo` | `computed` |
-| `useEffect` + `IntersectionObserver` | `onMounted` + `onUnmounted` |
-| `useCallback` | 普通函数（Vue 响应性系统不需要） |
-| JSX 内联子组件 | 拆分为独立 `.vue` 文件 |
-| `lucide-react` | `lucide-vue-next` |
-| `react-router-dom` | `vue-router` |

package/guanwang/docs/changelog.md

@@ -1,145 +0,0 @@
-# Changelog
-
-## [1.1.0] — 2025-03-20
-
-### 新增：埋点系统
-
-- `src/tracker/config.js`：埋点总配置，Ackee URL/Domain 从环境变量读取，21 个 Event UUID 集中管理，意图关键词字典和复杂度阈值可配置，`VITE_TRACK_ENABLED=false` 时全部静默
-- `src/tracker/analyze.js`：本地分析函数，提问方向/意图/复杂度/附件类型全部本地判断，不上报原文
-- `src/tracker/service.js`：Ackee 实例懒加载 + 上报队列，避免初始化期间丢事件
-- `src/tracker/useTracker.js`：官网页面埋点（`pageView` / `btnClick` / `loginSuccess`）
-- `src/tracker/useChatTracker.js`：对话框埋点，覆盖发消息、回复完成/报错/中止、模式切换、复制、下载，提问内容分析无用户关联
-- `src/tracker/index.js`：统一导出入口
-
-**埋点覆盖范围（21 个 Ackee Event）**
-- 页面行为 3 个：页面访问、按钮点击、登录成功
-- 对话行为 8 个：消息发送-模式/模型/用户、回复耗时、首字节延迟、中止、报错、模式切换
-- 采纳行为 5 个：内容复制-来源/用户/语言、文件下载-用户/语言
-- 提问内容分析 4 个：方向、意图、复杂度、附件（无用户关联）
-- 工具调用 1 个
-
-**采纳率三口径**：消息级、会话级、用户级，共用同一批事件，聚合 key 不同
-
-### 变更：useChatStore
-
-- 新增 `config.getUser` 注入接口，消费方传入获取当前用户信息的函数
-- `return` 新增 `tracker` 字段，供 `ArtifactPanel` / `MessageBubble` 调用采纳行为埋点
-- `abortStream()` 和 `switchMode()` 内置埋点调用
-
-### 文档
-- `docs/product.md` 新增「埋点与数据分析」章节
-- `docs/usage.md` 新增「埋点接入」章节，补充三个埋点环境变量
-- `docs/test-cases.md` 新增「十一、埋点」章节，16 个测试用例（T-100 ~ T-115）
-- `docs/doc-maintenance.md` 新增埋点维护规范
-
----
-
-## [1.1.0] — 2025-03-20
-
-### 新增：埋点系统
-
-- `src/tracker/config.js`：埋点总配置，Ackee URL/Domain/开关从 `.env` 读取，21 个 Event UUID 集中管理，意图关键词字典、模式方向映射、复杂度阈值全部可配置
-- `src/tracker/analyze.js`：提问内容本地分析，输出方向/意图/复杂度/附件类型，不上报原文
-- `src/tracker/service.js`：Ackee 实例懒加载 + 上报队列，`TRACK_ENABLED=false` 时全部静默
-- `src/tracker/useTracker.js`：官网页面埋点 composable（`pageView` / `btnClick` / `loginSuccess`）
-- `src/tracker/useChatTracker.js`：对话框全量埋点 composable（发消息、回复完成/报错/中止、模式切换、复制、下载）
-- `src/tracker/index.js`：统一入口
-
-### 埋点
-
-共 21 个 Ackee Event，分五类：
-
-- 页面行为（3个）：页面访问、按钮点击、登录成功
-- 对话行为（8个）：消息发送模式/模型/用户分布、回复耗时、首字节延迟、中止、报错、模式切换
-- 采纳行为（5个）：复制来源/用户/语言分布、下载用户/语言分布
-- 提问内容分析（4个，无用户关联）：提问方向、意图、复杂度、附件类型
-- 工具调用（1个）：工具名分布
-
-### 变更
-
-- `useChatStore.js`：注入 `useChatTracker`，新增 `config.getUser` 注入口，`return` 暴露 `tracker` 供上层组件调用采纳埋点
-- `useChatStore.switchMode()`：注入模式切换埋点（⚠️ 函数内部逻辑有变，但对外接口不变）
-
-### 文档
-
-- `docs/doc-maintenance.md`：新增埋点维护步骤、Ackee 展示类型速查、自查清单补充埋点项
-
----
-
-## [1.0.0] — 2025-03-20
-
-### 架构重构
-
-- 引入 `chat-sdk/` 目录，将对话能力从 guanwang 页面层剥离为独立 SDK
-- 新增双接入入口：`createAIChat()`（完整视图）和 `useChat()`（Headless 纯逻辑）
-- 分层结构：`headless/` → `core/` → `features/`，依赖方向单向
-- `features/` 每个目录内部区分 `core.js`（逻辑）和 `*.vue`（UI），headless 模式只引用逻辑层
-
-### 新增：多模型支持
-
-- `config.models` 支持配置多个独立 `baseURL/apiKey/model` 的模型
-- 输入栏底部新增模型 pill 选择器，仅在模型数 > 1 且 `userControls.modelSelector` 时显示
-- `autoVision`：含图片消息自动路由到 `vision: true` 的模型
-- 移除旧的 `VITE_VL_*` 视觉模型环境变量，统一到 `config.models`
-
-### 新增：多模式 Prompt 系统
-
-- `modes/code.js`：Code 模式，代码生成/修改，强制 `render_artifact` 输出
-- `modes/ask.js`：Ask 模式，只回答不生成文件
-- `modes/architect.js`：Architect 模式，系统设计，输出技术文档
-- `modes/requirements.js`：需求创造者模式，假设+确认流程，输出用户故事和功能拆解
-- `headless/buildSystemPrompt.js`：动态组装 system prompt，七区块结构，针对 Qwen3/弱模型优化
-- 模式切换时 system prompt 自动重建
-
-### 新增：Tool-use 解析循环
-
-- `tools/parser.js`：XML 工具调用解析，支持流式快速检测和批量提取
-- `tools/defaults.js`：五个工具内置默认处理逻辑（`ask_followup_question` / `attempt_completion` / `switch_mode` / `render_artifact` / `request_context`）
-- `useChatStore.onToolCall()`：支持按工具名或全局覆盖默认行为
-
-### 新增：设置面板
-
-- `settings/useSettings.js`：两层配置规则实现，`localStorage` 持久化
-- `settings/SettingsPanel.vue`：模型列表 + 功能开关 UI
-
-### 重构：chatApi.js
-
-- 移除全局 `selectConfig` 依赖，改为接收 `modelConfig` 对象
-- `headless/api/adapters/openai.js`：UI 消息格式 → OpenAI 兼容格式转换层，与业务逻辑解耦
-
-### 重构：useChatStore.js
-
-- 接收 `config` 参数，移除硬编码 `SYSTEM_PROMPT`
-- 集成 `loadModes()`、`buildSystemPrompt()`、`toAPIMessages()`
-- 集成 tool-use 循环：流式结束后自动解析并执行工具调用
-- 新增 `switchMode()`、`selectModel()`、`newSession()`、`switchSession()` 方法
-
-### 重构：ChatView.vue
-
-- 从 248 行页面组件精简为 46 行挂载壳，所有对话逻辑迁入 `ChatBox.vue`
-- `sdkConfig` 由环境变量组装，为后续迁移到 `createAIChat()` 调用预留接口
-
-### 重构：InputBar.vue
-
-- 移除全局 `config/api.js` 依赖
-- 改为接收 `availableModels`、`selectedModelId`、`showModelSelector` props
-- 通过 `emit('select-model')` 通知上层，不再内部维护模型状态
-
-### Bug 修复
-
-- `CodePreview.vue`：修复 Vue SFC 预览报错 `props.store.init is not a function`，`<Repl>` 组件内部会自调 `init()`，移除重复调用
-- `CodePreview.vue`：修复 `editor` prop 必填报错，补充 `CodeMirror` 异步加载并传入
-- `CodePreview.vue`：修复代码区滚动异常，改为 `flex` 列布局 + `shiki-scroll` 层独立滚动，`min-height: 0` 消除 flex 子元素默认约束
-- `ArtifactPanel.vue`：修复流式期间高亮竞态，引入 token 机制，后发的异步结果自动丢弃
-- `MessageBubble.vue`：原始文本调试面板（`VITE_SHOW_RAW_TEXT=true` 时显示）
-
-### 字体
-
-- 全局字体统一替换为 `Inter, 'Helvetica Neue', Helvetica, 'PingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', '微软雅黑', Arial, sans-serif`
-- 涉及文件：`global.css` 及所有组件，数字/代码字体 monospace 保持不变
-
----
-
-## [0.x] — 历史版本
-
-> 历史版本为 guanwang 项目初始开发阶段，未形成 SDK 结构，不单独记录。

package/guanwang/docs/doc-maintenance.md

@@ -1,229 +0,0 @@
-# 文档维护规范
-
-每次新增功能或修复 Bug 后，按以下步骤同步更新文档。
-
----
-
-## 需要维护的文档
-
-| 文档 | 路径 | 维护频率 |
-|---|---|---|
-| 产品说明书 | `docs/product.md` | 新增/删除功能时 |
-| 组件使用文档 | `docs/usage.md` | 接口变更时 |
-| 测试用例 | `docs/test-cases.md` | 新增功能时 |
-| 埋点配置 | `src/tracker/config.js` | 新增埋点事件时 |
-
-> `docs/changelog.md` 每次都要更新，不在上表之列，但每步都涉及。
-
----
-
-## 每次更新的步骤
-
-### 第一步：在 changelog.md 新增版本条目
-
-在文件顶部（最新版本之前）插入新条目：
-
-```markdown
-## [x.x.x] — YYYY-MM-DD
-
-### 新增
-- 简短描述，说明加了什么、为什么加
-
-### 修复
-- 简短描述，说明修了什么 Bug
-
-### 变更
-- 简短描述，说明改了什么接口或行为（破坏性变更需标注 ⚠️）
-
-### 埋点
-- 新增了哪些 Event，用途是什么
-
-### 文档
-- 同步更新了哪些文档
-```
-
-只写本次实际改动，没有的分类直接省略。
-
----
-
-### 第二步：按改动类型更新对应文档
-
-#### 新增功能 → 更新 product.md
-
-找到对应功能模块的章节，补充新能力描述。若是全新模块，在合适位置新增一节。
-
-```markdown
-### [新功能名]
-- 一句话说明这个功能是什么
-- 关键限制或注意事项（如有）
-```
-
-#### 接口变更 → 更新 usage.md
-
-- 新增 config 字段：在「config 完整字段说明」表格补行
-- 新增 `useChat()` 返回值：在对应表格补行
-- 接口删除或重命名：更新对应行，备注「已废弃，改用 xxx」
-
-#### 新增功能 → 更新 test-cases.md
-
-在对应模块章节末尾追加测试用例，编号连续递增（当前最大编号 T-093）：
-
-```markdown
-### T-xxx 用例名称
-**步骤**：操作步骤描述
-**预期**：期望的结果
-```
-
-功能较多时可新增模块章节（`## 十一、xxx`）。
-
-#### 新增埋点 → 更新 tracker/config.js
-
-这是埋点维护的核心步骤，分三小步：
-
-**① 在 Ackee 后台创建 Event**
-
-进入 Ackee 管理后台 → Settings → Events → 新建 Event，填写：
-- Name：和 `config.js` 里的注释保持一致，方便后台辨识
-- Type：参考下方「展示类型速查」选择
-
-**② 把 UUID 填入 config.js**
-
-找到 `src/tracker/config.js` 的 `EVENTS` 对象，将 Ackee 生成的真实 UUID 替换对应的占位 UUID：
-
-```js
-export const EVENTS = {
-  // 把这里的占位 UUID 替换成 Ackee 后台生成的真实 UUID
-  NEW_EVENT: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
-}
-```
-
-**③ 在对应的 tracker 函数里调用**
-
-- 页面行为 → `src/tracker/useTracker.js`
-- 对话行为 / 采纳行为 / 工具调用 → `src/tracker/useChatTracker.js`
-- 提问内容分析 → `src/tracker/analyze.js`（关键词字典）+ `useChatTracker.js`
-
-新增意图关键词时，只需修改 `config.js` 里的 `INTENT_KEYWORDS`，无需改其他文件。
-
----
-
-### 第三步：自查清单
-
-提交前过一遍：
-
-- [ ] `changelog.md` 已新增版本条目，日期正确
-- [ ] 新增功能已在 `product.md` 对应章节有描述
-- [ ] 接口变更已在 `usage.md` 对应表格更新
-- [ ] 新功能有对应测试用例，编号连续
-- [ ] 新增埋点已在 Ackee 后台创建 Event，UUID 已更新到 `config.js`
-- [ ] 新增埋点已在对应 tracker 函数里调用，并在 `changelog.md` 的「埋点」分类里记录
-- [ ] 已知限制有变化的，`product.md` 底部「已知限制」已更新
-- [ ] **涉及文件迁移或路径变更的，已执行引用扫描（见下方）**
-
----
-
-### 架构变更专项：引用扫描
-
-**每次发生以下情况，必须执行引用扫描，不得跳过：**
-
-- 文件移动或重命名
-- 文件删除或被新文件取代
-- 模块路径变更（如从 `composables/` 迁移到 `chat-sdk/headless/`）
-- 接口名称变更
-
-**扫描指令（在项目根目录执行）：**
-
-```bash
-# 扫描某个旧路径是否还有文件在引用
-grep -rn "旧文件名或旧路径" src/ --include="*.vue" --include="*.js"
-
-# 示例：确认旧的 useChatStore 没有残留引用
-grep -rn "composables/useChatStore" src/ --include="*.vue" --include="*.js"
-
-# 示例：确认旧的 config/api.js 没有残留引用  
-grep -rn "config/api" src/ --include="*.vue" --include="*.js"
-```
-
-**结果为空才算完成**，有输出说明还有文件没更新，必须逐一处理后再提交。
-
-**扫描时机：每改完一个文件，立即扫一次对应的旧路径**，不要等所有文件改完再统一扫，否则容易遗漏。
-
----
-
-## 版本号规则
-
-遵循语义化版本 `major.minor.patch`：
-
-| 变更类型 | 升级哪位 | 示例 |
-|---|---|---|
-| 破坏性接口变更 | major | 1.0.0 → 2.0.0 |
-| 新增功能（向后兼容） | minor | 1.0.0 → 1.1.0 |
-| Bug 修复 / 文档 / 样式 / 埋点 | patch | 1.0.0 → 1.0.1 |
-
----
-
-## 展示类型速查（Ackee Event Type）
-
-| 类型 | 适用场景 | 示例 |
-|---|---|---|
-| List 总计 | 统计各 key 的出现次数 | 模式分布、用户用量、复制来源 |
-| List 平均值 | 统计各 key 的平均数值 | 不常用 |
-| Chart 总计 | 按时间看总量趋势 | 不常用 |
-| Chart 平均值 | 按时间看均值趋势 | 回复耗时、首字节延迟 |
-
----
-
-## 快速参考：各文档的章节结构
-
-### product.md 章节
-```
-## 核心能力
-  ### [功能模块]    ← 新增/修改功能在这里
-## 技术架构
-## 配置两层边界
-## 已知限制         ← Bug 修复后可能需要更新
-```
-
-### usage.md 章节
-```
-## 两种接入方式
-## config 完整字段说明   ← 新字段加这里
-  ### ModelConfig
-  ### FeaturesConfig
-  ### UserControlsConfig
-## useChat() 返回值      ← 新返回值加这里
-  ### 状态
-  ### 方法
-## 模式说明
-## 环境变量             ← 新环境变量加这里
-```
-
-### test-cases.md 章节
-```
-## 一、配置与初始化   (T-001 ~ T-005)
-## 二、对话核心       (T-010 ~ T-017)
-## 三、多模型         (T-020 ~ T-022)
-## 四、多模式         (T-030 ~ T-034)
-## 五、Tool-use       (T-040 ~ T-045)
-## 六、Artifact 面板  (T-050 ~ T-056)
-## 七、Markdown 渲染  (T-060 ~ T-064)
-## 八、文件上传       (T-070 ~ T-074)
-## 九、Headless 模式  (T-080 ~ T-084)
-## 十、CodePreview    (T-090 ~ T-093)
-## 十一、埋点         (T-100 ~)       ← 新增埋点测试用例加这里
-```
-
-### tracker/config.js 结构
-```
-ACKEE_URL / ACKEE_DOMAIN / TRACK_ENABLED  ← 读取环境变量，不要硬编码
-EVENTS = {
-  // 页面行为（3个）
-  // 对话行为（8个）
-  // 采纳行为（5个）
-  // 提问内容分析（4个）
-  // 工具调用（1个）
-}
-INTENT_KEYWORDS   ← 意图关键词字典，新增意图类型在这里加
-MODE_TO_DIRECTION ← 模式→方向映射
-COMPLEXITY_THRESHOLD
-```