@bolloon/bolloon-agent 0.1.0

package/docs//346/225/260/345/255/246/350/276/205/345/212/251/346/231/272/350/203/275/344/275/223-/346/240/270/345/277/203/346/225/210/346/236/234/345/256/232/344/271/211.md

@@ -0,0 +1,287 @@
+# 数学辅助智能体 - 核心效果定义文档
+
+## 一、产品定位
+
+数学辅助智能体是一个**人类-智能体协作自动化平台**。
+
+产品不求解数学问题，而是作为协作基础设施，帮助人类研究者与多个AI智能体之间实现自动化的协作网络。核心价值在于**降低人类-智能体协作的摩擦成本**——人类只需提出想法，智能体自动将其转化为结构化文档并分发给其他智能体，形成自动化的协作网络。
+
+### 生态位分离
+
+| 角色 | 职责 | 特点 |
+|------|------|------|
+| **人类** | 目标设计者 | 提出研究想法/目标，不参与具体协作执行 |
+| **智能体** | 动态协作执行者 | 可在运行中调整协作方法，负责文档化和分发 |
+
+---
+
+## 二、核心流程
+
+```
+人类（设计目标）
+    ↓ 提出想法
+智能体A（文档化）
+    ↓ 转化为结构化文档
+智能体网络（分发协作）
+    ↓
+协作结果 + 反馈人类
+```
+
+### 流程说明
+
+1. **想法输入**：人类提出研究想法或目标
+2. **文档转化**：智能体将想法转化为结构化文档
+3. **自动分发**：文档被分发给网络中的其他智能体
+4. **协作执行**：智能体网络自动形成协作，执行任务
+5. **结果反馈**：协作结果反馈给人类，形成闭环
+
+---
+
+## 三、核心功能假设
+
+基于产品定位，核心功能包括：
+
+- **想法接收**：接收人类提出的研究想法/目标
+- **文档自动化**：将自然语言想法转化为结构化协作文档
+- **智能体分发**：基于信任机制，将文档安全分发给目标智能体
+- **动态协作调整**：智能体在运行中自主调整协作方法
+- **结果反馈**：将协作结果汇总反馈给人类
+
+---
+
+## 四、典型使用场景
+
+### 场景一：研究想法快速验证
+
+1. 人类提出研究想法："我想验证拓扑量子计算的可行性"
+2. 智能体A接收想法，自动生成结构化协作文档：
+   - 研究目标
+   - 关键假设
+   - 验证步骤
+   - 所需资源
+   - 潜在风险
+3. 文档通过DID签名验证后，分发给网络中的相关智能体
+4. 各智能体根据文档执行验证任务，智能体间动态调整协作方法
+5. 验证结果汇总后反馈给人类
+
+### 场景二：跨团队协作协调
+
+1. 人类提出复杂目标："需要A团队和B团队的智能体协作完成这个课题"
+2. 智能体自动分解任务，生成跨团队协作文档
+3. 各团队智能体网络接收文档，自主协调执行
+4. 动态调整协作方法解决冲突和依赖
+5. 阶段性结果反馈给人类，人类进行目标调整
+
+### 场景三：智能体自组织协作
+
+1. 人类提出开放式目标："探索机器学习在组合优化中的应用"
+2. 智能体网络接收目标后：
+   - 自主发现可协作的智能体
+   - 动态协商分工和协作方法
+   - 根据执行情况实时调整策略
+3. 协作过程中记录操作日志供人类审计
+4. 最终结果和发现反馈给人类
+
+---
+
+## 五、智能体自组织机制
+
+### 定义
+
+智能体自组织是指智能体在运行时自主发现、协商和调整协作方式的能力，不需要人类干预具体执行过程。
+
+### 实现要素
+
+| 要素 | 说明 |
+|------|------|
+| **服务发现** | 智能体可发现网络中其他智能体的能力和状态 |
+| **动态协商** | 智能体之间可协商任务分工、优先级、资源分配 |
+| **策略调整** | 根据执行反馈，智能体自主调整协作策略 |
+| **冲突解决** | 智能体间出现冲突时，自动协商解决方案 |
+
+### 信任机制的作用
+
+- **DID身份认证**：确保参与协作的智能体身份可信
+- **签名验证**：协作过程中的关键操作需签名确认
+- **操作审计**：所有协作操作记录在链，供人类追溯
+
+---
+
+## 六、文档分发机制
+
+### 分发流程
+
+```
+结构化文档
+    ↓ DID签名
+分发层（基于信任策略）
+    ↓
+目标智能体网络
+    ↓
+智能体接收并验证签名
+```
+
+### 分发策略
+
+| 策略 | 说明 |
+|------|------|
+| **广播分发** | 文档分发到所有可达智能体 |
+| **定向分发** | 根据文档内容智能匹配目标智能体 |
+| **分层分发** | 先分发给骨干智能体，再逐层传递 |
+
+### 信任验证
+
+- 文档发送前使用发送方DID签名
+- 智能体接收后验证签名有效性
+- 验证通过才执行文档中的协作任务
+
+---
+
+## 七、反馈闭环
+
+### 反馈内容
+
+| 类型 | 说明 |
+|------|------|
+| **进度反馈** | 协作任务的阶段性进展 |
+| **结果反馈** | 最终协作产出和发现 |
+| **异常反馈** | 协作过程中出现的问题和解决情况 |
+| **审计日志** | 完整的操作记录供人类追溯 |
+
+### 反馈方式
+
+- 实时推送：协作过程中的重要事件即时通知
+- 定期汇总：周期性汇总报告
+- 按需查询：人类可随时查询协作状态
+
+---
+
+## 八、核心效果选择题（更新版）
+
+### 题目一：产品的首要核心效果是什么？
+
+**A. 协作自动化**
+- 描述：从人类想法到智能体协作的自动流转
+- 适用场景：人类提想法，智能体自动执行协作
+
+**B. 任务协作管理**
+- 描述：协调多个研究者的任务分配与进度
+- 适用场景：团队项目协作、任务分解与追踪
+
+**C. 知识传递与沉淀**
+- 描述：促进知识在团队成员间的流转和积累
+- 适用场景：跨团队知识共享、研究成果沉淀
+
+**D. 信任协作基础设施**
+- 描述：提供人类与智能体间的可信协作环境
+- 适用场景：跨组织合作、安全敏感场景
+
+---
+
+### 题目二：在人类-智能体协作框架下，产品的核心价值是？
+
+**A. 降低协作摩擦**
+- 描述：人类只需提想法，其余自动完成
+- 价值：大幅减少人类-智能体协作的沟通成本
+
+**B. 身份可验证**
+- 描述：每个参与者都有可信的身份标识
+- 价值：DID体系确保身份真实不可伪造
+
+**C. 操作可追溯**
+- 描述：所有协作操作都有完整记录可审计
+- 价值：签名机制确保操作不可否认
+
+**D. 决策可解释**
+- 描述：智能体的协作决策可被人类理解
+- 价值：透明化协作过程，建立人类信任
+
+---
+
+### 题目三：智能体在协作中的角色是？
+
+**A. 被动执行者**
+- 描述：完全按照人类指令执行，不自行决策
+
+**B. 动态协作方法**
+- 描述：智能体可在运行中调整协作方式
+- 特点：自主协商、动态分工、实时策略调整
+
+**C. 固定流程执行**
+- 描述：按照预设流程执行，不灵活调整
+
+**D. 独立工作者**
+- 描述：各智能体独立工作，不互相协调
+
+---
+
+### 题目四：人类在协作中的角色是？
+
+**A. 全程参与者**
+- 描述：人类参与每个协作环节的决策
+
+**B. 目标设计者**
+- 描述：人类设定目标，不参与具体协作执行
+- 特点：聚焦"做什么"，不问"怎么做"
+
+**C. 最终审核者**
+- 描述：智能体执行后，人类只做最终审批
+
+**D. 旁观者**
+- 描述：人类仅观察，不介入协作过程
+
+---
+
+### 题目五：信任共识在产品中的作用是？
+
+**A. 确保身份真实**
+- 描述：DID体系确保参与者身份可信
+
+**B. 确保分发可靠**
+- 描述：文档分发、协作过程的信任验证
+- 作用：签名验证保障文档来源和完整性
+
+**C. 确保决策共识**
+- 描述：关键决策需多方确认
+
+**D. 确保操作可追溯**
+- 描述：所有操作有完整审计记录
+
+---
+
+## 九、答案汇总
+
+| 题目 | 推荐选项 | 说明 |
+|------|---------|------|
+| 首要核心效果 | **A. 协作自动化** | 从想法到协作的自动流转是核心差异化 |
+| 核心价值 | **A. 降低协作摩擦** | 人类只需提想法，其余自动完成 |
+| 智能体角色 | **B. 动态协作方法** | 智能体可在运行中调整协作方式 |
+| 人类角色 | **B. 目标设计者** | 人类设定目标，不参与具体协作执行 |
+| 信任共识作用 | **B. 确保分发可靠** | 文档分发、协作过程的信任验证 |
+
+---
+
+## 十、核心效果定义
+
+**产品核心效果：人类-智能体协作自动化平台**
+
+> 数学辅助智能体不求解数学问题，而是作为人类-智能体协作自动化平台。人类提出研究想法/目标，智能体自动将其转化为结构化文档并分发给其他智能体，形成自动化的协作网络。人类负责设定目标，智能体负责协作方法的动态调整和执行。
+
+### 关键词
+
+- **协作自动化**：想法→文档→分发→协作的自动流转
+- **动态协作**：智能体在运行中自主调整协作方法
+- **降低摩擦**：人类只需提想法，其余自动完成
+- **信任机制**：基于DID的身份认证、签名验证确保分发可靠
+
+---
+
+## 十一、效果量化指标
+
+| 指标 | 目标值 | 说明 |
+|------|--------|------|
+| 想法转化成功率 | ≥ 95% | 人类想法成功转化为结构化文档的比例 |
+| 文档分发到达率 | ≥ 99% | 文档成功到达目标智能体的比例 |
+| 智能体自组织率 | ≥ 90% | 协作调整中无需人类干预的比例 |
+| 人类反馈满意度 | ≥ 85% | 人类对协作结果的满意程度 |
+| 信任建立时间 | ≤ 30秒 | 新智能体加入网络建立信任的耗时 |

package/package.json

@@ -0,0 +1,121 @@
+{
+  "name": "@bolloon/bolloon-agent",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "P2P AI Document Agent with libp2p",
+  "main": "dist/index.js",
+  "author": "Bolloon Team",
+  "scripts": {
+    "build": "npm run build --workspaces --if-present",
+    "build:main": "tsc",
+    "build:web": "npx tsx scripts/build-web.ts",
+    "build:electron": "tsc -p tsconfig.electron.json",
+    "start": "node dist/index.js",
+    "dev": "tsx -r dotenv/config src/index.ts",
+    "dev:web": "npm run build:web && npm run dev",
+    "dev:electron": "npm run build:electron && npm run electron:start",
+    "electron:start": "NODE_ENV=development electron dist/electron.js",
+    "electron:dev": "concurrently \"npm run dev:web\" \"npm run electron:start\"",
+    "electron:build": "npm run build:electron && electron-builder",
+    "electron:pack": "electron-builder --dir",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:pi-sdk": "tsx src/test/pi-sdk.test.ts"
+  },
+  "workspaces": [
+    "src/constraint-runtime"
+  ],
+  "dependencies": {
+    "@bolloon/constraint-runtime": "0.1.0",
+    "@chainsafe/libp2p-noise": "^17.0.0",
+    "@chainsafe/libp2p-yamux": "^8.0.1",
+    "@diap/sdk": "^0.1.10",
+    "@libp2p/autonat": "^3.0.20",
+    "@libp2p/circuit-relay-v2": "^4.2.5",
+    "@libp2p/dcutr": "^3.0.20",
+    "@libp2p/identify": "^4.1.6",
+    "@libp2p/kad-dht": "^16.2.6",
+    "@libp2p/tcp": "^11.0.20",
+    "@libp2p/upnp-nat": "^4.0.20",
+    "@multiformats/multiaddr": "^13.0.3",
+    "@noble/hashes": "^1.3.0",
+    "@rayhanadev/iroh": "^0.1.1",
+    "@twind/core": "^1.1.3",
+    "dotenv": "^17.4.2",
+    "esbuild": "^0.24.0",
+    "express": "^5.2.1",
+    "libp2p": "^3.3.0",
+    "mammoth": "^1.6.0",
+    "pdf-parse": "^1.1.4",
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/node": "^25.9.1",
+    "@types/pdf-parse": "^1.1.5",
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "concurrently": "^9.2.1",
+    "electron": "^42.3.0",
+    "electron-builder": "^26.8.1",
+    "playwright": "^1.60.0",
+    "tsx": "^4.0.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.6"
+  },
+  "build": {
+    "appId": "com.bolloon.agent",
+    "productName": "Bolloon Agent",
+    "directories": {
+      "output": "release",
+      "buildResources": "build"
+    },
+    "files": [
+      "dist/**/*",
+      "src/electron-main.js",
+      "package.json"
+    ],
+    "extraMetadata": {
+      "main": "src/electron-main.js",
+      "type": "commonjs"
+    },
+    "win": {
+      "target": [
+        {
+          "target": "nsis",
+          "arch": [
+            "x64"
+          ]
+        }
+      ],
+      "icon": "build/icon.ico"
+    },
+    "mac": {
+      "target": [
+        "dmg"
+      ],
+      "icon": "build/icon.icns"
+    },
+    "linux": {
+      "target": [
+        "AppImage"
+      ],
+      "icon": "build/icon.png"
+    },
+    "nsis": {
+      "oneClick": false,
+      "perMachine": false,
+      "allowToChangeInstallationDirectory": true,
+      "createDesktopShortcut": true,
+      "createStartMenuShortcut": true
+    },
+    "asar": false,
+    "asarUnpack": [
+      "node_modules/@diap/**/*",
+      "node_modules/@rayhanadev/**/*",
+      "node_modules/libp2p/**/*",
+      "node_modules/@libp2p/**/*"
+    ]
+  }
+}

package/scripts/build-web.ts

@@ -0,0 +1,61 @@
+/**
+ * Web 构建脚本
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { execSync } from 'child_process';
+import * as esbuild from 'esbuild';
+
+const ROOT = path.resolve(import.meta.dirname, '..');
+const DIST_WEB = path.join(ROOT, 'dist', 'web');
+
+async function main() {
+  console.log('[build-web] 开始构建...');
+
+  // 清理并创建目录
+  await fs.rm(DIST_WEB, { recursive: true, force: true });
+  await fs.mkdir(DIST_WEB, { recursive: true });
+  await fs.mkdir(path.join(DIST_WEB, 'components', 'p2p'), { recursive: true });
+
+  // 编译 TypeScript 模块
+  console.log('[build-web] 编译 TypeScript 模块...');
+  const moduleFiles = [
+    'src/web/components/p2p/types.ts',
+    'src/web/components/p2p/p2p-store-memory.ts',
+    'src/web/components/p2p/p2p-identity.ts',
+    'src/web/components/p2p/p2p-connection.ts',
+    'src/web/components/p2p/p2p-messages.ts',
+    'src/web/components/p2p/p2p-manager.ts',
+  ];
+
+  try {
+    execSync(`npx tsc --ignoreConfig --outDir dist/web/components/p2p --declaration false --skipLibCheck --target ES2022 --module ESNext --moduleResolution bundler ${moduleFiles.join(' ')}`, {
+      cwd: ROOT,
+      stdio: 'inherit'
+    });
+  } catch {
+    console.log('[build-web] TypeScript 编译有警告，继续...');
+  }
+
+  // 编译 P2P Modal UI（esbuild）
+  console.log('[build-web] 编译 P2P Modal UI...');
+  await esbuild.build({
+    entryPoints: [path.join(ROOT, 'src/web/components/p2p/index.ts')],
+    outfile: path.join(DIST_WEB, 'components/p2p/index.js'),
+    format: 'esm',
+    target: 'es2022',
+    platform: 'browser',
+    minify: false,
+  });
+
+  // 复制静态文件
+  console.log('[build-web] 复制静态文件...');
+  await fs.copyFile(path.join(ROOT, 'src/web/index.html'), path.join(DIST_WEB, 'index.html'));
+  await fs.copyFile(path.join(ROOT, 'src/web/api-config.html'), path.join(DIST_WEB, 'api-config.html'));
+  await fs.copyFile(path.join(ROOT, 'src/web/style.css'), path.join(DIST_WEB, 'style.css'));
+  await fs.copyFile(path.join(ROOT, 'src/web/client.js'), path.join(DIST_WEB, 'client.js'));
+
+  console.log('[build-web] 完成!');
+}
+
+main().catch(console.error);