@templmf/temp-solf-lmf 0.0.55 → 0.0.56

package/guanwang/docs/usage.md

@@ -1,291 +0,0 @@
-# chat-sdk 使用文档
-
-## 两种接入方式
-
-### 方式一：完整视图模式
-
-挂载整套对话界面，无需自己写 UI。
-
-```js
-import { createAIChat } from '@/chat-sdk'
-
-createAIChat({
-  el: '#chat-container',
-
-  models: [
-    { id: 'qwen3-32b', name: 'Qwen3 32B', baseURL: 'http://192.168.1.100:8080', apiKey: 'sk-xxx', vision: false },
-    { id: 'qwen-vl',   name: 'Qwen VL',   baseURL: 'http://192.168.1.101:8080', apiKey: 'sk-yyy', vision: true  },
-  ],
-  defaultModel: 'qwen3-32b',
-  autoVision: true,
-
-  features: {
-    artifact:    true,
-    markdown:    true,
-    upload:      true,
-    codepreview: true,
-  },
-
-  userControls: {
-    modelSelector: true,
-    artifact:      true,
-    upload:        true,
-  },
-
-  modes: ['code', 'ask', 'architect', 'requirements'],
-  defaultMode: 'code',
-  customInstructions: '你是公司内部 AI 助手，回答请简洁专业。',
-})
-```
-
----
-
-### 方式二：Headless 模式
-
-只接入能力，自己控制视图。
-
-```vue
-<script setup>
-import { useChat } from '@/chat-sdk/headless'
-
-const {
-  messages,
-  isLoading,
-  currentMode,
-  selectedModel,
-  availableModels,
-  activeArtifacts,
-  send,
-  abort,
-  switchMode,
-  selectModel,
-  clearSession,
-  newSession,
-  onToolCall,
-} = useChat({
-  models: [
-    { id: 'qwen3-32b', name: 'Qwen3 32B', baseURL: 'http://192.168.1.100:8080', apiKey: 'sk-xxx', vision: false },
-  ],
-  defaultModel: 'qwen3-32b',
-  modes: ['code', 'ask'],
-  defaultMode: 'code',
-  features: { artifact: true, markdown: true },
-})
-
-// 可选：覆盖工具默认行为
-onToolCall('ask_followup_question', ({ params, resolve }) => {
-  // 自己渲染选项 UI，用户选择后调用 resolve(answer)
-  showMyOptions(params.suggests, resolve)
-})
-</script>
-
-<template>
-  <div v-for="msg in messages" :key="msg.id">
-    <span>{{ msg.role }}</span>
-    <span>{{ msg.content }}</span>
-    <!-- activeArtifacts 自己决定如何渲染 -->
-  </div>
-  <button @click="send({ text: '你好' })">发送</button>
-</template>
-```
-
----
-
-## config 完整字段说明
-
-| 字段 | 类型 | 必填 | 说明 |
-|---|---|---|---|
-| `el` | `string \| HTMLElement` | 完整视图必填 | 挂载节点，如 `'#app'` |
-| `models` | `ModelConfig[]` | 是 | 模型列表，见下方 |
-| `defaultModel` | `string` | 是 | 默认模型 id |
-| `autoVision` | `boolean` | 否 | 消息含图片时自动切 `vision:true` 的模型 |
-| `features` | `FeaturesConfig` | 否 | 控制哪些 chunk 加载，见下方 |
-| `userControls` | `UserControlsConfig` | 否 | 控制哪些开关对用户可见 |
-| `modes` | `string[]` | 否 | 启用的模式，默认 `['code']` |
-| `defaultMode` | `string` | 否 | 默认模式 id |
-| `customInstructions` | `string` | 否 | 追加到所有模式 prompt 末尾的自定义指令 |
-| `title` | `string` | 否 | 对话框标题，默认 `'AI 助手'` |
-| `placeholder` | `string` | 否 | 输入框占位文字 |
-
-### ModelConfig
-
-```ts
-{
-  id:      string   // 模型唯一标识（也是发给 API 的 model 字段）
-  name:    string   // 显示名称
-  baseURL: string   // 接口地址，如 'http://192.168.1.100:8080'
-  apiKey:  string   // API Key，内网可传空字符串
-  vision:  boolean  // 是否支持图片输入
-}
-```
-
-### FeaturesConfig
-
-控制对应 chunk 是否下载，`false` 时代码完全不加载。
-
-| key | 说明 |
-|---|---|
-| `artifact` | 代码文件生成面板 |
-| `markdown` | Markdown / 代码高亮 / KaTeX 渲染 |
-| `upload` | 文件和图片上传 |
-| `codepreview` | 代码预览弹框（含 Vue SFC / HTML 预览）|
-
-### UserControlsConfig
-
-声明哪些开关在设置面板里对用户可见。
-
-| 值 | 含义 |
-|---|---|
-| `true` | 显示开关，默认开启，用户可关闭 |
-| `false` | 显示开关，默认关闭，用户可开启 |
-| 不填 | 不显示开关，强制开启 |
-
----
-
-## useChat() 返回值
-
-### 状态（只读 ref）
-
-| 名称 | 类型 | 说明 |
-|---|---|---|
-| `messages` | `Ref<Message[]>` | 当前会话消息列表 |
-| `isLoading` | `Ref<boolean>` | 是否请求中 |
-| `currentMode` | `Ref<string>` | 当前模式 id |
-| `selectedModel` | `ComputedRef<ModelConfig>` | 当前选中模型 |
-| `availableModels` | `ModelConfig[]` | 全部可用模型（非响应式） |
-| `activeArtifacts` | `Ref<Artifact[]>` | 当前会话的 artifact 列表 |
-
-### 方法
-
-| 名称 | 签名 | 说明 |
-|---|---|---|
-| `send` | `(input: SendInput) => void` | 发送消息 |
-| `abort` | `() => void` | 中止当前流式请求 |
-| `switchMode` | `(modeId: string) => void` | 切换模式 |
-| `selectModel` | `(modelId: string) => void` | 切换模型 |
-| `clearSession` | `() => void` | 清空当前会话 |
-| `newSession` | `() => number` | 新建会话，返回会话 id |
-| `onToolCall` | `(name, handler) \| (handler)` | 注册工具回调 |
-
-### SendInput
-
-```ts
-// 纯文本
-send({ text: '帮我写一个登录组件' })
-
-// 带附件
-send({
-  text: '分析这张截图',
-  attachments: [{ type: 'image', file: File }],
-})
-```
-
-### Message 格式
-
-```ts
-{
-  id:        number
-  role:      'user' | 'assistant' | 'system-tip' | 'followup'
-  content:   string          // AI / 用户文字内容
-  parts:     Part[]          // 结构化内容（text / image / file）
-  streaming: boolean         // 是否流式输出中
-  error:     boolean         // 是否出错
-  artifacts: string[]        // 关联的 artifact id 列表
-}
-```
-
----
-
-## 模式说明
-
-| 模式 id | 名称 | 职责 |
-|---|---|---|
-| `code` | Code | 编写、修改、重构代码，输出完整代码文件 |
-| `ask` | Ask | 解释概念、回答技术问题，不生成代码文件 |
-| `architect` | Architect | 系统设计、技术方案、架构拆解，输出技术文档 |
-| `requirements` | 需求 | 梳理需求，输出用户故事和功能拆解列表 |
-
-模式切换方式：
-```js
-// 代码切换
-switchMode('architect')
-
-// AI 自动触发（通过 switch_mode 工具）
-// 消费方监听
-onToolCall('switch_mode', ({ params, resolve }) => {
-  if (confirm(`切换到 ${params.mode_slug} 模式？`)) {
-    switchMode(params.mode_slug)
-    resolve()
-  }
-})
-```
-
----
-
-## 埋点接入
-
-### 官网页面埋点
-
-在 `App.vue` 路由钩子和登录成功回调里接入：
-
-```js
-import { useTracker } from '@/tracker'
-const tracker = useTracker()
-
-// 路由 afterEach
-router.afterEach((to) => tracker.pageView(to.path))
-
-// 按钮点击
-tracker.btnClick('hero_cta', '立即体验')
-
-// 登录成功
-tracker.loginSuccess(user.name)
-```
-
-### 对话框埋点
-
-对话行为埋点（发消息、回复、中止、模式切换）已内置在 `useChatStore` 中，只需在 `createAIChat` config 里注入 `getUser`：
-
-```js
-createAIChat({
-  // ...其他配置
-  getUser: () => ({ name: currentUser.name, id: currentUser.id }),
-})
-```
-
-采纳行为埋点（复制、下载）在 `ArtifactPanel` 和 `MessageBubble` 里通过 `chatStore.tracker` 调用，已自动处理，无需额外接入。
-
-### 环境变量
-
-```env
-VITE_ACKEE_URL=http://your-ackee-server:3000    # Ackee 服务地址
-VITE_ACKEE_DOMAIN=your-domain-uuid              # Ackee Domain ID
-VITE_TRACK_ENABLED=true                          # false 时全部静默，默认 true
-```
-
-### 自定义关键词字典
-
-在 `src/tracker/config.js` 的 `INTENT_KEYWORDS` 里维护意图匹配关键词，修改后无需改动其他文件。
-
----
-
-## 环境变量（guanwang 项目专用）
-
-项目根目录创建 `.env.local`：
-
-```env
-VITE_API_BASE_URL=http://192.168.1.100:8080
-VITE_API_KEY=sk-xxx
-VITE_MODEL=qwen3-32b
-
-# 多模型（逗号分隔）
-VITE_MODELS=qwen3-32b,qwen3-7b,qwen-vl
-
-# 调试：AI 气泡底部显示原始文本
-VITE_SHOW_RAW_TEXT=false
-
-# 埋点
-VITE_ACKEE_URL=http://192.168.1.200:3000
-VITE_ACKEE_DOMAIN=your-domain-uuid
-VITE_TRACK_ENABLED=true
-```

package/guanwang/env.example

@@ -1,27 +0,0 @@
-# 复制此文件为 .env.local 并填入真实配置
-# .env.local 已加入 .gitignore，不会提交到代码库
-
-# ─────────────────────────────────────────────
-# LLM 接口（默认模型，必填）
-# ─────────────────────────────────────────────
-VITE_VL_API_BASE_URL=http://192.168.1.100:8080   # vl 独立 endpoint
-VITE_VL_API_KEY=sk-your-key-here           # vl 独立 key
-VITE_VL_MODEL=qwen3-vl-8b-instruct
-
-VITE_API_BASE_URL=http://192.168.1.100:8080
-VITE_API_KEY=sk-your-key-here
-VITE_MODEL=qwen3-32b
-
-# ─────────────────────────────────────────────
-# 埋点（Ackee，选填）
-# 不填 VITE_ACKEE_URL 则埋点自动关闭
-# ─────────────────────────────────────────────
-VITE_ACKEE_URL=http://192.168.1.200:3000
-VITE_ACKEE_DOMAIN=your-domain-id-here
-VITE_TRACK_ENABLED=true
-
-# ─────────────────────────────────────────────
-# 调试（开发时使用，生产环境保持 false）
-# ─────────────────────────────────────────────
-# AI 气泡底部显示原始文本，方便调试 Markdown 渲染
-VITE_SHOW_RAW_TEXT=false

package/guanwang/index.html

@@ -1,13 +0,0 @@
-<!doctype html>
-<html lang="zh-CN">
-  <head>
-    <meta charset="UTF-8" />
-    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>Citic Frontend</title>
-  </head>
-  <body>
-    <div id="app"></div>
-    <script type="module" src="/src/main.js"></script>
-  </body>
-</html>