# dobuddy

**Repository Path**: zhengbaitech/dobuddy

## Basic Information

- **Project Name**: dobuddy
- **Description**: 集成有福科技开发人员使用工具, 一体化AI调用
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-09
- **Last Updated**: 2026-10-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# dobuddy

> 面向公司开发人员的 AI 一站式工具：**查询**（知识库 / 文档 / 历史问题）、**处理**（工单 / 告警 / 常见操作）、**排查**（日志 / 监控 / 链路）。
>
> 底层基于 [deepseek-harness（dsh）](https://github.com/deepseek-ai/deepseek-harness) —— DeepSeek 官方开源的 Agent 框架，"一切皆插件"。

## 产品组成

| 部分 | 说明 |
|---|---|
| 官网 | 项目展示 + 客户端下载入口 + 注册登录（`website/`） |
| 客户端 | harness 桌面版改造：dobuddy 品牌 + 内置 dobuddy 插件（`client/`） |
| 后端 | 用户注册登录、会话管理，MySQL + Redis（`server/`） |
| 插件 | 公司内部系统能力封装为 AI 工具：知识库 / 日志 / Runbook |

账号体系 v1：用户名 + 密码注册登录；**模型 API Key 由每个用户在客户端里自己填写**，密钥只存本机、随账号隔离；客户端登录复用 Web 账号（打开浏览器认证后回传客户端）。

## 仓库结构（单仓库，目录划分）

```
dobuddy/
├── client/              # harness fork（git subtree 引入）＝ 客户端代码基座
│   └── packages/dobuddy/core/   # dobuddy 主插件（工具注册，随客户端打包）
├── website/             # 官网静态站（首页 / 登录 / 注册，nginx 直接托管）
├── server/              # 后端服务（TS + Express + MySQL + Redis）
├── deploy/              # 部署配置（nginx.conf）
├── docker-compose.yml   # 一体化编排：MySQL + Redis + server + nginx
├── docs/                # 架构 / 计划 / 工作流文档
└── AGENTS.md            # AI 辅助开发约定
```

- `client/` 整体来自上游 [deepseek-harness](https://github.com/deepseek-ai/deepseek-harness)，通过 `git subtree` 引入并持续跟进上游；本地另有一份**永远干净**的上游基线克隆（`../deepseek-harness`），只用于同步，见 [docs/dev-workflow.md](docs/dev-workflow.md)。
- `client/website` 是 harness 自带的文档站构建包，与本仓库根的 `website/`（官网）无关。

## 快速开始

### 前置条件

- Node.js ≥ 22.19、pnpm ≥ 10、Docker（后端与基础设施）

### 客户端插件开发（client/）

```sh
cd client
pnpm install
pnpm run build            # 全量构建（含 dobuddy 插件，首次较久）

# 联调：把 cordis.example.yml 里的插件绝对路径改成本机路径后
pnpm dsh web --patch ./cordis.example.yml   # http://127.0.0.1:3080
```

插件源码在 `client/packages/dobuddy/core/src/`，新增工具步骤见 [docs/dsh-notes.md](docs/dsh-notes.md)。

### 官网（website/）

纯静态站，无构建步骤，本地预览：

```sh
cd website && python3 -m http.server 8090   # 或任何静态服务器
```

登录/注册页默认调用同源 `/api/auth/*`；前后端分离开发时在页面里先设 `window.DOBUDDY_API_BASE`。

### 后端（server/）

```sh
docker compose up -d mysql redis          # 仓库根，起 MySQL + Redis
docker compose exec -T mysql mysql -uroot -proot-password < server/schema.sql
cd server && cp .env.example .env && npm install && npm run dev   # :8080
```

### 一键部署

仓库根 `docker-compose.yml` 包含 MySQL + Redis + 后端 + nginx（官网 / API 反代 / 安装包下载），目标环境为腾讯云轻量服务器；部署由运维负责，见 compose 文件头注释与 [deploy/nginx.conf](deploy/nginx.conf)。

## 文档索引

| 文档 | 内容 |
|---|---|
| [docs/architecture.md](docs/architecture.md) | 架构分层与工具集规划 |
| [docs/client-release-plan.md](docs/client-release-plan.md) | 官网 + 客户端发布方案（含已定决策与账号体系设计） |
| [docs/dev-workflow.md](docs/dev-workflow.md) | 上游同步（subtree）与日常开发工作流 |
| [docs/roadmap.md](docs/roadmap.md) | 里程碑与验收标准 |
| [docs/dsh-notes.md](docs/dsh-notes.md) | deepseek-harness 插件开发笔记 |

## 相关资料

- deepseek-harness：https://github.com/deepseek-ai/deepseek-harness （中文 README 与 `docs/zh/` 下有完整的插件开发教程）
- 内部代码仓库：https://gitee.com/zhengbaitech/dobuddy