feihong-code 0.2.3 → 0.6.0

package/dist/web/web-config.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CAPABILITY_TAGS = void 0;
+exports.defaultWebConfig = defaultWebConfig;
+exports.getWebConfigPath = getWebConfigPath;
+exports.loadWebConfig = loadWebConfig;
+exports.saveWebConfig = saveWebConfig;
+exports.toProviderConfigs = toProviderConfigs;
+/**
+ * Muse Code 中文开发版 (Muse Code 中文开发版)
+ * 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹
+ *
+ * Web 控制台「系统配置」持久化模块：
+ *   - 自定义大模型（openai-compatible / ollama）列表与运行参数
+ *   - 落盘到 <FH_HOME>/web-config.json（原子写：tmp + rename）
+ *   - 读取缺失/损坏时回退默认值，不抛错，便于离线/首启
+ */
+const fs_1 = require("fs");
+const path_1 = require("path");
+const config_1 = require("../shared/config");
+exports.CAPABILITY_TAGS = [
+    'code-gen',
+    'reasoning',
+    'long-context',
+    'vision',
+    'cheap',
+    'local',
+];
+const DEFAULT_BASE_URL_OLLAMA = 'http://localhost:11434';
+function defaultWebConfig() {
+    return {
+        models: {
+            providers: [],
+            defaultStrategy: 'cost',
+            budgetPerTaskUsd: 0.5,
+            defaultModelId: null,
+        },
+        runtime: {
+            maxConcurrency: 2,
+            webhookUrl: '',
+            temperature: 0.2,
+            maxRetries: 3,
+            workspaceDir: '',
+        },
+        security: {
+            sandboxMode: 'workspace-write',
+            requireApproval: true,
+        },
+    };
+}
+function getWebConfigPath() {
+    return (0, path_1.join)((0, config_1.resolveHomeDir)(), 'web-config.json');
+}
+/** 读取配置，缺省/损坏回退默认（深合并，保证新增字段始终存在） */
+function loadWebConfig() {
+    const def = defaultWebConfig();
+    const file = getWebConfigPath();
+    if (!(0, fs_1.existsSync)(file))
+        return def;
+    try {
+        const raw = JSON.parse((0, fs_1.readFileSync)(file, 'utf8'));
+        return mergeConfig(def, raw);
+    }
+    catch {
+        return def;
+    }
+}
+/** 深合并用户配置到默认骨架，避免缺字段导致的运行期 undefined */
+function mergeConfig(def, raw) {
+    const models = (raw.models ?? {});
+    const runtime = (raw.runtime ?? {});
+    const security = (raw.security ?? {});
+    const validTags = (arr) => {
+        if (!Array.isArray(arr))
+            return [];
+        return arr.filter((t) => exports.CAPABILITY_TAGS.includes(t));
+    };
+    const providers = Array.isArray(models.providers)
+        ? models.providers
+            .filter((p) => !!p && typeof p === 'object')
+            .map((p) => ({
+            id: String(p.id ?? ''),
+            name: String(p.name ?? ''),
+            type: (p.type === 'ollama' ? 'ollama' : 'openai-compatible'),
+            baseURL: String(p.baseURL ?? ''),
+            model: String(p.model ?? ''),
+            apiKey: String(p.apiKey ?? ''),
+            tags: validTags(p.tags),
+            costPer1k: Number(p.costPer1k ?? 0) || 0,
+            enabled: p.enabled !== false,
+            isDefault: p.isDefault === true,
+        }))
+        : [];
+    return {
+        models: {
+            providers,
+            defaultStrategy: (models.defaultStrategy ?? def.models.defaultStrategy),
+            budgetPerTaskUsd: Number(models.budgetPerTaskUsd ?? def.models.budgetPerTaskUsd) || 0,
+            defaultModelId: models.defaultModelId != null ? String(models.defaultModelId) : null,
+        },
+        runtime: {
+            maxConcurrency: clampInt(runtime.maxConcurrency, 1, 16, def.runtime.maxConcurrency),
+            webhookUrl: String(runtime.webhookUrl ?? ''),
+            temperature: typeof runtime.temperature === 'number' ? runtime.temperature : def.runtime.temperature,
+            maxRetries: clampInt(runtime.maxRetries, 0, 10, def.runtime.maxRetries),
+            workspaceDir: typeof runtime.workspaceDir === 'string' ? runtime.workspaceDir : (def.runtime.workspaceDir ?? ''),
+        },
+        security: {
+            sandboxMode: (security.sandboxMode ?? def.security.sandboxMode),
+            requireApproval: security.requireApproval !== false,
+        },
+    };
+}
+function clampInt(v, min, max, fallback) {
+    const n = Number(v);
+    if (!Number.isFinite(n))
+        return fallback;
+    return Math.min(max, Math.max(min, Math.floor(n)));
+}
+/** 原子落盘（tmp + rename），避免半写损坏 */
+function saveWebConfig(cfg) {
+    const file = getWebConfigPath();
+    (0, fs_1.mkdirSync)((0, config_1.resolveHomeDir)(), { recursive: true });
+    const tmp = file + '.tmp';
+    (0, fs_1.writeFileSync)(tmp, JSON.stringify(cfg, null, 2), 'utf8');
+    (0, fs_1.renameSync)(tmp, file);
+}
+/** 将自定义模型规整为 ProviderConfig（供注入 FH_PROVIDERS） */
+function toProviderConfigs(cfg) {
+    return cfg.models.providers
+        .filter((m) => m.enabled && m.model)
+        .map((m) => ({
+        id: m.id || m.model,
+        type: m.type,
+        baseURL: m.baseURL ||
+            (m.type === 'ollama' ? DEFAULT_BASE_URL_OLLAMA : ''),
+        model: m.model,
+        apiKey: m.apiKey || undefined,
+        tags: m.tags.length > 0 ? m.tags : ['code-gen', 'reasoning'],
+        costPer1k: m.costPer1k || 0,
+    }));
+}
+//# sourceMappingURL=web-config.js.map

package/dist/web/web-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-config.js","sourceRoot":"","sources":["../../src/web/web-config.ts"],"names":[],"mappings":"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"}

package/docs/App/344/275/277/347/224/250/350/257/264/346/230/216/344/271/246.md

@@ -0,0 +1,299 @@
+# 飞虹 Code App 使用说明书（移动控制台）
+
+**产品**：飞虹 Code 移动控制台（Android App + 手机浏览器版）
+**版本**：v1.0.0（APK）· 移动版 H5
+**日期**：2026-08-23
+**署名**：晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹
+
+---
+
+## 目录
+
+1. [产品简介](#一产品简介)
+2. [下载与安装](#二下载与安装)
+3. [登录](#三登录)
+4. [界面总览](#四界面总览)
+5. [功能详解](#五功能详解)
+6. [思维链路解读指南](#六思维链路解读指南)
+7. [大模型配置指南](#七大模型配置指南)
+8. [权限设置说明](#八权限设置说明)
+9. [常见问题（FAQ）](#九常见问题faq)
+10. [版本信息与更新](#十版本信息与更新)
+
+---
+
+## 一、产品简介
+
+飞虹 Code 移动控制台是飞虹 Code（终端 AI 编程智能体）的**手机端控制界面**。它对接部署在腾讯云服务器上的飞虹 Code 后端，让你在手机上随时随地：
+
+- 用自然语言描述需求，发起 AI 编程任务
+- 实时查看任务的思维链路（模型推理、工具调用、验证结果、最终回复）
+- 管理快捷指令（自动化）、模板库、大模型配置
+- 与企业级后端共享同一套任务体系（手机发起的任务与电脑 Web 控制台完全互通）
+
+**两种使用形态**（功能完全一致）：
+
+| 形态 | 说明 | 适用场景 |
+|------|------|----------|
+| **Android App** | 安装 APK，独立图标启动 | 日常高频使用，像普通 App 一样 |
+| **手机浏览器版** | 浏览器直接打开网址，可添加到主屏幕 | 不想安装、临时使用 |
+
+---
+
+## 二、下载与安装
+
+### 2.1 Android App 安装
+
+**方式一：直接下载 APK**
+
+1. 手机浏览器打开以下地址：
+
+   ```
+   https://www.jb.klai.top/m/fhcode-v1.0.0.apk
+   ```
+
+2. 下载完成后点击安装。若提示「未知来源」：
+
+   - 点击弹窗中的「设置」→ 允许「来自此来源的应用」
+   - 返回继续安装
+   - （不同品牌手机路径略有差异：小米/红米：设置-更多设置-安全；华为/荣耀：设置-安全-更多安全设置；OPPO/vivo：设置-安全-未知来源）
+
+3. 安装完成后，桌面出现「飞虹 Code」图标，点击启动。
+
+**方式二：浏览器直接使用**
+
+手机浏览器打开 `https://www.jb.klai.top/m/` 即可直接使用，无需安装。
+
+> 提示：Android 浏览器（Chrome/Edge）打开移动版页面后，菜单中选择「添加到主屏幕」，即可像 App 一样从桌面启动。
+
+### 2.2 环境要求
+
+- Android 8.0（API 26）及以上
+- 需要联网（访问服务器域名 www.jb.klai.top，需能正常访问国内网络）
+
+---
+
+## 三、登录
+
+打开 App 后进入登录页：
+
+1. 输入**手机号码**（任意 11 位手机号即可，演示登录、无短信验证）
+2. 点击「手机号登录」
+3. 登录成功后自动进入「对话」页
+
+**说明**：
+
+- 登录凭据由 App 内置（App 专用通道），无需手动输入服务器账号密码
+- 登录状态保存在本地，下次打开自动恢复；点击「我的-退出登录」可退出
+- 若服务器会话过期，会自动跳回登录页并提示
+
+---
+
+## 四、界面总览
+
+App 采用**底部 5 Tab 导航**，顶部为标题栏（右侧头像可打开用户菜单）：
+
+| Tab | 名称 | 功能 |
+|-----|------|------|
+| 💬 | 对话 | 发起任务、多轮对话、查看思维链路（默认页） |
+| 📋 | 任务 | 全部任务列表、查看详情、删除 |
+| ⚡ | 自动化 | 快捷指令一键运行、新建、删除 |
+| 📚 | 模板 | 内置/自定义模板，点击填入输入框 |
+| 👤 | 我的 | 大模型配置、权限设置、主题、关于、退出 |
+
+---
+
+## 五、功能详解
+
+### 5.1 对话页（💬）
+
+对话页是核心操作页，包含三部分：
+
+**① 顶部任务栏**：显示当前任务目标与状态徽章（排队中/执行中/已完成/失败），右侧「＋新建」按钮发起新任务。
+
+**② 消息区**：按时间展示当前任务的完整过程：
+- 对话流（你发的指令 + AI 的回复）
+- 思维链路（模型推理、工具调用、验证结果）
+- 最终回复 / 失败原因
+
+**③ 底部输入栏**：输入指令，点击「▶」发送。
+
+**发起新任务**：
+
+1. 点击顶部「＋新建」
+2. 填写任务描述（必填），如：`请读取当前工作区 package.json，告诉我 name 和 version`
+3. 选择智能体类型（通用助手/修复代码/编写代码/执行命令）
+4. 选择工作区（默认服务器工作区，或指定磁盘目录）
+5. 点击「创建任务」，自动跳回对话页实时追踪
+
+**多轮续接**：当前任务执行完成后，直接在输入框继续输入指令，消息会归属**同一任务**继续对话（保持上下文）。
+
+> ⚠️ 任务**执行中**时不能发送新消息，需等待完成。此时发送会提示"任务执行中，请等待完成"。
+
+### 5.2 任务页（📋）
+
+- **查看**：点击任意任务卡片 → 弹出任务详情（目标、状态、智能体、迭代次数、成本、最终结果、错误信息）
+- **删除**：长按任务卡片 → 确认后删除
+- **刷新**：右上角「刷新」按钮；页面也会每 5 秒自动刷新
+
+任务状态徽章含义：
+
+| 徽章 | 含义 |
+|------|------|
+| 📥 排队中 | 任务已入队，等待执行 |
+| ⏳ 执行中 | AI 正在推理/调用工具 |
+| ✅ 已完成 | 执行成功，可查看最终回复 |
+| ❌ 失败 | 执行失败，详情中显示原因（常见：未配置大模型） |
+
+### 5.3 自动化（⚡）
+
+快捷指令：把常用目标存成指令，一键发起任务。
+
+**新建**：右上角「＋新建」→ 填名称和目标 → 保存。
+
+**运行**：点击指令卡片「▶ 运行」→ 立即发起任务，可到对话页查看。
+
+**删除**：点击「删除」→ 确认。
+
+### 5.4 模板（📚）
+
+- **内置模板**：8 个（编写新功能/调试 Bug/重构优化/生成测试/撰写文档/代码审查/解释代码/性能优化）
+- **我的模板**：自己保存的模板（可在 Web 控制台保存，手机端同步可见）
+
+**使用**：点击模板卡片「填入」→ 模板内容自动填入对话输入框 → 切到对话页补充细节后发送。
+
+### 5.5 我的（👤）
+
+**① 大模型设置**：配置 AI 使用的模型（详见第七章）。
+
+**② 权限设置**：配置任务执行期间 AI 的可读范围与操作权限（详见第八章）。
+
+**③ 外观**：浅色/深色主题切换（自动记忆）。
+
+**④ 关于**：版本信息。
+
+**⑤ 退出登录**：清除本地登录状态。
+
+---
+
+## 六、思维链路解读指南
+
+对话页的消息区会展示任务全过程的「思维链路」，帮助你理解 AI 在做什么：
+
+| 环节 | 显示 | 含义 |
+|------|------|------|
+| 🧠 模型推理 | 推理内容 + 使用的模型 | AI 的思考过程 |
+| 🔧 调用工具 | 工具名 + 参数 | AI 正在调用文件读写/命令/搜索等工具 |
+| ✅ 验证通过 / ❌ 验证失败 | 工具名 + 输出摘要 | 工具执行结果校验 |
+| 🩹 自愈重试 | 错误类别 + 轮次 | AI 检测到错误并自我修复重试 |
+| 📦 上下文压缩 | 压缩条数 | 长对话自动压缩以节省 Token |
+| 📬 最终回复 | 完整回复文本 | 任务的最终答案（点「⚙️」可复制/编辑/分享） |
+| ⛔ 任务失败 | 失败原因 | 出错说明 |
+
+---
+
+## 七、大模型配置指南
+
+> ⚠️ **重要**：服务器默认**未配置大模型**。不配置模型时，任务会入队后失败（显示"任务失败"）。**使用前必须先配置至少一个大模型。**
+
+**配置步骤**：
+
+1. 进入「我的 → 大模型设置」
+2. 填写：
+   - **模型名称**（必填）：如 `GPT-4o`、`通义千问`、`DeepSeek` 等
+   - **API 地址**：OpenAI 兼容接口地址，如 `https://api.openai.com/v1`
+   - **密钥（API Key）**：你的模型服务密钥 `sk-...`
+   - **推理过程运行内容**（可选）：配置模型在中间推理环节的提示词
+3. 点击「保存配置」
+4. 如需设为默认：在模型列表中点击「设为默认」
+
+**模型列表操作**：编辑（点「编辑」）、删除（点「删除」）、设默认（非默认模型显示「设为默认」）。
+
+**多模型**：可保存多个模型。任务提交时默认使用"默认模型"，也可在 Web 控制台底部随时切换。
+
+**常用模型 API 地址参考**（需自行申请对应 Key）：
+
+| 服务商 | API 地址 |
+|--------|----------|
+| OpenAI | https://api.openai.com/v1 |
+| DeepSeek | https://api.deepseek.com/v1 |
+| 通义千问 | https://dashscope.aliyuncs.com/compatible-mode/v1 |
+| 硅基流动 | https://api.siliconflow.cn/v1 |
+| 本地 Ollama | http://localhost:11434/v1（仅服务器本机可用） |
+
+---
+
+## 八、权限设置说明
+
+「我的 → 权限设置」控制任务执行期间 AI 的能力边界：
+
+**可读范围**：
+
+| 选项 | 含义 |
+|------|------|
+| 仅当前工作区 | AI 只能读取当前工作区目录（推荐） |
+| 指定目录 | AI 只能读取你指定的目录路径 |
+| 全部文件 | AI 可读取服务器全部文件（谨慎） |
+
+**操作权限**（开关）：
+
+| 权限 | 说明 | 默认 |
+|------|------|------|
+| 📖 读取文件 | AI 读取文件内容 | 开 |
+| ✍️ 写入文件 | AI 修改/创建文件 | 关 |
+| ⚡ 执行命令 | AI 在服务器执行 shell 命令 | 关 |
+| 🌐 访问网络 | AI 访问互联网 | 开 |
+| 🖥 浏览器控制 | AI 控制浏览器 | 关 |
+
+> 提示：写入与执行命令默认关闭是**安全默认**。如需 AI 自动改代码/跑命令，请按需开启；任务在服务器执行，请确认操作影响。
+
+---
+
+## 九、常见问题（FAQ）
+
+**Q1：任务创建后很快显示"失败"？**
+大概率是**未配置大模型**。到「我的 → 大模型设置」添加模型（API 地址 + Key）后重试。查看失败原因：任务列表点该任务 → 详情显示错误信息。
+
+**Q2：发送消息提示"任务执行中，请等待完成"？**
+任务正在运行，需等待其完成（状态变为已完成/失败）后才能继续对话。
+
+**Q3：App 打开显示"登录已过期"？**
+服务器会话过期，重新手机号登录即可。
+
+**Q4：安装 APK 提示"未知来源"？**
+按第 2.1 节说明，在系统设置中允许该来源安装。
+
+**Q5：下载 APK 慢或失败？**
+确认网络可访问 `www.jb.klai.top`；可尝试使用手机浏览器方式直接使用。
+
+**Q6：模型配置保存失败？**
+检查网络与服务器状态；确认模型名称已填写。
+
+**Q7：删除任务/指令失败？**
+任务运行中不能删除，需等执行结束；检查网络。
+
+**Q8：App 卡顿或白屏？**
+下拉刷新页面（如有）或完全退出 App 重新打开；检查手机网络。
+
+**Q9：如何保证数据安全？**
+- 页面与登录接口受服务器 Basic Auth 保护，仅 App 内置凭据可访问
+- 业务 API 全部要求 Bearer 令牌校验（未授权请求一律拒绝）
+- 任务在服务器工作区范围执行，写入/命令权限默认关闭
+
+---
+
+## 十、版本信息与更新
+
+| 版本 | 说明 | 日期 |
+|------|------|------|
+| v1.0.0 | 首个移动控制台版本（Android APK + H5） | 2026-08-23 |
+
+**更新方式**：重新下载最新 APK 安装覆盖（需在「我的 → 关于」查看当前版本）。
+
+**Web 控制台同步**：手机端与电脑端 `https://www.jb.klai.top` 共享同一后端，任务/自动化/模板/模型配置实时互通。
+
+---
+
+**支持与反馈**：如遇问题请联系研发中心（晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 负责人：吴赐虹）。
+
+*© 2026 晋江市飞虹智科技企业管理有限公司 · 飞扬企源研发中心 · 保留所有权利*