World OS AutoCode 使用说明与维护指南
💡
关于本文档
本文档是 World OS AutoCode 的完整使用说明和维护指南，涵盖从快速开始、核心功能使用到日常维护、故障排除的全方位内容。
项目概述
World OS AutoCode 是一个基于 DIKW + Harness + Cognitive Agent 方法论的企业级认知型工程 Agent 平台。
核心特性
🏗️ DIKW 四层知识架构
- D层 (Data): 原始代码文件的元数据索引
- I层 (Information): 文件摘要和向量存储，支持语义检索
- K层 (Knowledge): 依赖图谱和实体关系
- W层 (Wisdom): 架构决策和经验模式
技术栈概览
| 层级 |
技术选型 |
版本 |
| Agent Runtime |
Python |
3.12+ |
| Web前端 |
React + TypeScript + Vite |
18+ |
| 向量数据库 |
Qdrant |
- |
| 图数据库 |
SQLite + Neo4j |
- |
安装部署
环境要求
| 组件 |
最低版本 |
说明 |
| Python |
3.9+ |
推荐 3.12 |
| Node.js |
18+ |
可选，仅前端开发需要 |
| Git |
2.30+ |
- |
| 操作系统 |
Windows 10+ / macOS 12+ / Ubuntu 20.04+ |
- |
安装方式
方式一：pip 安装（推荐）
pip install worldos-autocode
方式二：源码安装
git clone https://github.com/your-org/worldos-autocode.git
cd worldos-autocode
pip install -e .
方式三：使用安装脚本
bash install.sh
安装验证
worldos --version
worldos verify
卸载
pip uninstall worldos-autocode
架构说明
🏗️
系统架构
World OS AutoCode 采用分层架构设计，包含 DIKW 知识层、Harness 信任层和 Agent 执行层。
整体架构
架构层次
- 表现层: Web UI / CLI
- 应用层: Agent 运行时 / 工作流引擎
- 知识层: DIKW 四层知识架构
- 信任层: Harness 验证机制
- 基础设施层: Python Runtime / 向量数据库 / 图数据库
核心组件
DIKW 知识引擎
DIKW（Data-Information-Knowledge-Wisdom）模块负责构建和管理项目知识图谱：
- D层: 原始数据索引和元数据管理
- I层: 信息抽取和向量化存储
- K层: 知识图谱和实体关系
- W层: 智慧层，存储架构决策和模式
Harness 信任层
Harness 提供Invariant验证机制，确保代码变更符合预期：
- 类型检查 (type-check)
- 测试套件 (test-suite)
- 架构规范 (arch-lint)
- 技能验证 (agile-skills-check)
Agent 运行时
基于 Claude Code 的认知型 Agent，提供智能化编码能力。
DIKW使用
🧠
DIKW 知识架构
DIKW 是 World OS AutoCode 的核心知识管理框架，实现从数据到智慧的逐层提炼。
四层架构
D层 - Data（数据层）
原始代码文件的元数据索引，包括文件路径、大小、修改时间等基础信息。
I层 - Information（信息层）
文件摘要和向量存储，支持语义检索和相似度匹配。
K层 - Knowledge（知识层）
依赖图谱和实体关系，构建项目知识的结构化表示。
W层 - Wisdom（智慧层）
架构决策和经验模式的沉淀，指导代码生成和优化。
使用方式
# 初始化 DIKW
worldos dikw init
# 构建知识索引
worldos dikw build
# 语义搜索
worldos dikw search "用户认证逻辑"
Harness核心
🛡️
Harness 信任层
Harness 通过 Invariant 验证机制，确保代码变更符合预期规范。
核心概念
Invariant（不变式）
Invariant 是 Harness 的核心验证单元，代表必须保持不变的约束条件。
State（状态）
记录项目的当前运行态，包括模块状态、需求完成度等。
Knowledge（知识）
项目知识空间，存储产品需求、技术规范、业务规则等。
验证类型
| 类型 |
名称 |
说明 |
| type-check |
类型检查 |
Python 类型注解验证 |
| test-suite |
测试套件 |
单元测试和集成测试 |
| arch-lint |
架构规范 |
代码结构和命名规范 |
| agile-skills-check |
技能验证 |
Agile 技能可用性检查 |
运行验证
# 运行所有 Invariant
bash harness/invariants/run-all.sh
# 运行单个验证
bash harness/invariants/type-check.sh
配置管理
# 查看状态
worldos status
# 更新状态
worldos state update --module core --status completed
Agent运行时
🤖
Agent 运行时
基于 Claude Code 的认知型 Agent，提供智能化编码能力。
Agent 类型
Code Agent
负责代码编写、修改和重构。
Review Agent
负责代码审查和质量评估。
Debug Agent
负责故障定位和问题修复。
执行流程
- 任务解析: 解析用户需求，提取关键信息
- 知识检索: 从 DIKW 获取相关上下文
- 方案生成: 生成实现方案
- 代码执行: 执行代码变更
- 结果验证: 运行 Invariant 验证
- 状态更新: 更新项目状态
使用示例
# 创建任务
worldos task create "实现用户登录功能"
# 执行任务
worldos task execute --id task-001
# 查看任务状态
worldos task status --id task-001
维护指南
🔧
日常维护
本节介绍 World OS AutoCode 的日常维护操作。
状态管理
查看状态
worldos status
更新模块状态
worldos state update --module core-framework --status completed
重置状态
worldos state reset
知识同步
本地同步
python3 harness/scripts/sync_knowledge.py --local-only
飞书同步
python3 harness/scripts/sync_knowledge.py
依赖更新
pip install --upgrade worldos-autocode
pip install -r requirements.txt --upgrade
日志管理
日志位置
- 主日志:
logs/worldos.log
- Agent 日志:
logs/agent/
- Harness 日志:
logs/harness/
故障排除
安装问题
Python 版本不兼容
症状: 安装失败，提示 Python 版本过低
解决方案: 升级 Python 到 3.9+
pyenv install 3.12
pyenv local 3.12
依赖安装失败
症状: pip install 失败
解决方案: 使用虚拟环境
python -m venv venv
source venv/bin/activate
pip install worldos-autocode
运行问题
命令找不到
症状: worldos 命令不存在
解决方案: 检查 PATH 或重新安装
pip install --force-reinstall worldos-autocode
which worldos
Harness 验证失败
症状: invariant 检查失败
解决方案: 查看具体失败原因并修复
bash harness/invariants/run-all.sh 2>&1 | tee debug.log
性能问题
知识索引慢
症状: DIKW 构建时间过长
解决方案: 增量索引或调整配置
worldos dikw build --incremental
获取帮助
技术支持
- 文档: 返回概述
- 问题反馈: GitHub Issues
- 社区支持: Discord / Slack