feat(phase3-4): add OpenFang config.toml and TypeScript type definitions

Phase 3: Configuration Migration (P1)
- Create config/config.toml with comprehensive OpenFang settings
- Migrate openclaw.default.json content to TOML format
- Add server, agent, skills, hands, llm, security, logging configs
- Add desktop-specific settings for ZClaw client

Phase 4: Type System Enhancement (P2)
- Create types/agent.ts: Agent, AgentConfig, AgentStatus types
- Create types/session.ts: Session, SessionMessage, MessageRole types
- Create types/settings.ts: QuickConfig, MCPService, AppSettings types
- Create types/index.ts: Barrel export for all type definitions

Documentation Updates:
- Mark Phase 3 config migration tasks as completed (2/3)
- Mark Phase 4 type definition tasks as completed (3/4)
- Update technical debt cleanup status
- Update type definition section in SYSTEM_ANALYSIS.md

Files Added:
- config/config.toml (289 lines)
- desktop/src/types/agent.ts (68 lines)
- desktop/src/types/session.ts (75 lines)
- desktop/src/types/settings.ts (89 lines)
- desktop/src/types/index.ts (41 lines)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
iven
2026-03-15 01:45:25 +08:00
parent 5599c1a4db
commit 9c99ab16d4
6 changed files with 657 additions and 15 deletions

View File

@@ -141,9 +141,9 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端,核
| 类型文件 | 状态 | 缺失类型 |
|----------|------|----------|
| `types/hands.ts` | ✅ 完整 | - |
| Agent 类型 | ❌ 缺失 | Agent, AgentConfig, AgentStatus |
| Session 类型 | ❌ 缺失 | Session, SessionMessage |
| Settings 类型 | ❌ 缺失 | Settings, QuickConfig 完整定义 |
| `types/agent.ts` | ✅ 完整 | - |
| `types/session.ts` | ✅ 完整 | - |
| `types/settings.ts` | ✅ 完整 | - |
| Workflow 类型 | ⚠️ 部分 | WorkflowStep 详细定义 |
---
@@ -238,8 +238,8 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端,核
| 任务 | 说明 | 状态 |
|------|------|------|
| 迁移 openclaw.default.json | 转换为 config.toml | 🔴 待开始 |
| 补充主 config.toml | OpenFang 服务器配置 | 🔴 待开始 |
| 迁移 openclaw.default.json | 转换为 config.toml | ✅ 已完成 |
| 补充主 config.toml | OpenFang 服务器配置 | ✅ 已完成 |
| 清理 OpenClaw 遗留代码 | 移除兼容层 | 🔴 待开始 |
### Phase 4: 类型系统完善 (P2)
@@ -250,9 +250,9 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端,核
| 任务 | 文件 | 状态 |
|------|------|------|
| Agent 类型定义 | `types/agent.ts` | 🔴 待开始 |
| Session 类型定义 | `types/session.ts` | 🔴 待开始 |
| Settings 类型定义 | `types/settings.ts` | 🔴 待开始 |
| Agent 类型定义 | `types/agent.ts` | ✅ 已完成 |
| Session 类型定义 | `types/session.ts` | ✅ 已完成 |
| Settings 类型定义 | `types/settings.ts` | ✅ 已完成 |
| Workflow 详细类型 | `types/workflow.ts` | 🔴 待开始 |
### Phase 5: Skills 生态扩展 (P2)
@@ -284,10 +284,10 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端,核
### 5.2 配置层面
| 债务 | 位置 | 影响 | 清理方案 |
|------|------|------|----------|
| OpenClaw JSON 配置 | `config/openclaw.default.json` | 配置格式混合 | 迁移到 TOML |
| 缺少主配置文件 | `config/` | OpenFang 配置不完整 | 创建 config.toml |
| 债务 | 位置 | 影响 | 清理方案 | 状态 |
|------|------|------|----------|------|
| ~~OpenClaw JSON 配置~~ | ~~`config/openclaw.default.json`~~ | ~~配置格式混合~~ | ~~迁移到 TOML~~ | ✅ 已清理 |
| ~~缺少主配置文件~~ | ~~`config/`~~ | ~~OpenFang 配置不完整~~ | ~~创建 config.toml~~ | ✅ 已清理 |
### 5.3 类型层面
@@ -319,10 +319,18 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端,核
### 6.3 Phase 3 完成标准
- [ ] OpenClaw JSON 配置文件
- [ ] 所有配置使用 TOML 格式
- [x] 创建 OpenFang config.toml
- [x] 迁移 OpenClaw JSON 配置到 TOML
- [ ] 无 OpenClaw JSON 配置文件 (保留 openclaw.default.json 作为参考)
- [ ] 无 OpenClaw 兼容层代码
### 6.4 Phase 4 完成标准
- [x] Agent 类型定义完整
- [x] Session 类型定义完整
- [x] Settings 类型定义完整
- [ ] Workflow 详细类型定义
---
## 七、风险与缓解
@@ -369,4 +377,6 @@ ZCLAW 是基于 **OpenFang** (Rust Agent OS) 的 AI Agent 桌面客户端,核
*文档创建: 2026-03-14*
*最后更新: 2026-03-15*
*Phase 1 & 2 已完成*
*下次审查: Phase 3 开始前*
*Phase 3 进行中 (2/3)*
*Phase 4 部分完成 (3/4)*
*下次审查: Phase 3 完成后*