# fishbot

**Repository Path**: lskratXlskrat/fishbot

## Basic Information

- **Project Name**: fishbot
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: agent-v2
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-14
- **Last Updated**: 2026-10-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# bxdc-bot

> BXDC 智能体执行平台 — 基于 LLM + 多 Skill 编排的企业级 Agent 框架

## 项目定位

`bxdc-bot`（仓库目录名 `fishtank`）是一个由三个服务组成的 AI 智能体执行平台：

| 服务 | 端口 | 技术栈 | 职责 |
|------|------|--------|------|
| **agent-core** | 3000 | NestJS / TypeScript | LLM 调度、Skill 执行、对话管理 |
| **skill-gateway** | 18080 | Spring Boot / Java 1.8 | Skill 执行后端、异步任务调度、MySQL 持久化 |
| **frontend** | 5173 | Vue 3 / TDesign / Vite | 对话 UI / 后台管理 / 用户/Profile 编辑 |

外加一个外部依赖：**mem0**（HTTP 服务，默认 `http://39.104.81.41:8001`）提供长期记忆抽取。

## 快速上手

```bash
# 1. 后端网关（MySQL 持久化）
cd backend/skill-gateway
cp src/main/resources/application-prod.example.properties src/main/resources/application.properties
./apache-maven-3.8.5/bin/mvn -s ./settings.xml spring-boot:run

# 2. agent-core（LLM 调度）
cd backend/agent-core && npm install && npm run start:dev

# 3. 前端
cd frontend && npm install && npm run dev
```

详细部署 SOP：[`AGENTS.md §1`](./AGENTS.md) / [`backend/skill-gateway/DEPLOY.md`](./backend/skill-gateway/DEPLOY.md) / [`backend/agent-core/DEPLOY.md`](./backend/agent-core/DEPLOY.md)。

## 关键文档

| 文档 | 内容 |
|------|------|
| [`AGENTS.md`](./AGENTS.md) | 项目 AI agent 工作规则（部署 / OpenSpec / 编码约束 / 跨服务调用） |
| [`requirements/internal/`](./requirements/internal/) | 各业务能力的需求调研 + 设计文档 |
| [`CHANGELOG-v2.4.0.md`](./CHANGELOG-v2.4.0.md) | v2.4.0 发布记录 |
| [`BUGFIX_GUIDELINES.md`](./BUGFIX_GUIDELINES.md) | 历史 bug 修复指南 |
| [`doc/`](./doc/) | 技术设计文档 |

## 最近在做的事

### 🆕 OpenViking 上下文数据库集成（路径 D + 模式 B · 2026-09-01）

OpenViking（Apache-2.0 开源 AGFS 文件系统范式上下文数据库）作为**增量补位 mem0** 的子系统接入 agent-core，与 mem0 并列、互不替代：

- **路径 D**：`agent-core` `npm install @openviking/sdk@^0.1.0`，新增 `ContextService`（基于 SDK）+ `UserOvKeyService`（MySQL 持久化 per-user key）
- **模式 B（trusted mode）**：每个用户在 OV admin 端注册 → 拿独立 API key → 强制 `userId` 必填 → OV server 端强校验 → userId 隔离零绕过
- **gateway 零改动 / mem0 零改动 / frontend 最小改动**（一个跳转按钮）

详见 [`requirements/internal/openviking/`](./requirements/internal/openviking/)：

- [00-调研报告-openviking.md](./requirements/internal/openviking/00-调研报告-openviking.md) — 背景 + mem0 强化 + 4 方案对比
- [01-可行性论证-openviking.md](./requirements/internal/openviking/01-可行性论证-openviking.md) — SDK 实测 + AGPLv3 隔离 + 11 节风险评估
- [02-修改设计-openviking.md](./requirements/internal/openviking/02-修改设计-openviking.md) — 15 文件改动 + 完整 TS 代码 + 模式 B onboarding 流程
- [03-服务端部署手册-openviking.md](./requirements/internal/openviking/03-服务端部署手册-openviking.md) — 最小原型 9 步 SOP（30-45 分钟跑通）

**当前代码状态**：仅文档已落地（fishbot/temp + fishbot/agent-v2 已同步）；TS / Vue / AGENTS.md / nginx / systemd **0 改动**；`@openviking/sdk` 已 install（待评审决定保留或回滚）。

## 贡献流程

1. 阅读 [`AGENTS.md`](./AGENTS.md)（强约束：JDK 1.8 / 不改业务模块 / gatewayClient / vue-tsc 严格模式）
2. 走 OpenSpec 流程（AGENTS.md §3）：`proposal.md` + `design.md` + `tasks.md`
3. 不改 dist；commit 源码 + 文档
4. PR 时附 OpenSpec change 链接