feat: 更新DACP演示服务,重命名服务和描述,简化功能,删除不必要的日历和文档操作,增强演示效果。同时,优化了API接口和README文档,确保用户更易于理解和使用。

This commit is contained in:
sean
2025-06-18 17:29:31 +08:00
parent 741c1f8f54
commit c8f6545dd5
13 changed files with 946 additions and 753 deletions

View File

@ -1,105 +1,93 @@
# DACP PromptX Service
# DACP 协议演示服务
统一的 DACP 服务,提供多个 demo actions 供 PromptX 调用。
## 概述
## 功能特性
这是一个轻量级的DACP (Deepractice Agent Context Protocol) 协议演示服务通过calculator和email两个典型场景验证DACP协议的完整性和可行性。
- 📧 **Email Action**: 智能邮件发送功能
- 📅 **Calendar Action**: 会议日程管理
- 📄 **Document Action**: 文档创建和管理
- 🚀 **更多 Actions**: 持续扩展中...
⚠️ **重要说明**这是协议演示服务不是生产级业务服务。真实的DACP服务应该独立部署。
## 启动方式
## 设计目标
### 1. 独立启动 DACP 服务
- **协议验证**验证DACP协议标准的可行性
- **演示参考**为第三方DACP服务开发提供实现参考
- **最小复杂度**:聚焦协议本质,避免业务逻辑干扰
## 演示功能
### 1. Calculator (`calculate`)
- 中文自然语言数学表达式解析
- 智能运算符转换:`加/乘/减/除``+/*/-/÷`
- 标准数学运算和结果格式化
### 2. Email (`send_email`)
- 自然语言邮件需求理解
- 上下文感知内容生成
- 专业邮件格式化
## 快速开始
### 通过PromptX MCP启动推荐
```bash
./scripts/start-mcp.sh --with-dacp
```
### 独立启动
```bash
cd src/dacp/dacp-promptx-service
npm start
npm install
node server.js
```
服务将在 http://localhost:3002 启动。
服务地址:`http://localhost:3002`
### 2. 通过 MCP 自动启动(推荐)
## 基础测试
```bash
# 在项目根目录
promptx mcp-server --with-dacp
# 健康检查
curl http://localhost:3002/health
# 计算器演示
curl -X POST http://localhost:3002/dacp \
-H "Content-Type: application/json" \
-d '{
"service_id": "dacp-promptx-service",
"action": "calculate",
"parameters": {"user_request": "计算 25 + 37 * 3"}
}'
# 邮件演示
curl -X POST http://localhost:3002/dacp \
-H "Content-Type: application/json" \
-d '{
"service_id": "dacp-promptx-service",
"action": "send_email",
"parameters": {"user_request": "发送测试邮件"}
}'
```
这将同时启动 MCP Server 和 DACP 服务。
## 架构原则
## API 接口
基于Sean的产品哲学
### DACP 协议接口
### 奥卡姆剃刀原则
- 最小复杂度验证最大价值
- 两个典型场景覆盖协议核心能力
POST http://localhost:3002/dacp
### 架构分离
- 演示服务与生产服务分离
- 避免在MCP客户端承担过多业务逻辑
请求格式:
```json
{
"service_id": "dacp-promptx-service",
"action": "send_email",
"parameters": {
"user_request": "给张三发个会议提醒邮件",
"context": {
"urgency": "high"
}
}
}
```
### 扩展指导
- 真实DACP服务应独立部署
- 此演示提供标准协议实现参考
## 支持的 Actions
## 文档
1. **send_email** - 发送邮件
- 自然语言邮件内容解析
- 智能主题识别
- 专业邮件格式生成
详细的API调用指南请参考[DACP-API-GUIDE.md](./DACP-API-GUIDE.md)
2. **schedule_meeting** - 安排会议
- 时间解析
- 参会人员管理
- 会议议程生成
## 下一步
3. **create_document** - 创建文档
- 多种文档模板
- 智能内容生成
- Markdown 格式输出
## 开发指南
### 添加新的 Action
1.`actions/` 目录下创建新文件
2. 导出 action 函数
3. 实现 DACP 协议规范
示例:
```javascript
// actions/custom.js
async function custom_action(parameters) {
const { user_request, context } = parameters;
// 实现逻辑
return {
// 返回结果
};
}
module.exports = { custom_action };
```
## 测试
```bash
# 运行测试
npm test
```
## 配置
配置文件:`dacp.config.json`
主要配置项:
- `service.id`: 服务标识
- `deployment.port`: 服务端口
- `capabilities.actions`: 支持的 actions 列表
基于此演示框架开发独立部署的专业DACP服务
- `dacp-finance-service` (财务服务)
- `dacp-crm-service` (客户管理服务)
- `dacp-analytics-service` (数据分析服务)