security-checklist

• [核心特性](#-核心特性)
• [快速开始](#-快速开始)
• [系统架构](#-系统架构)
• [使用指南](#-使用指南)
• [扩展开发](#-扩展开发)
• [文档资源](#-文档资源)

🖥️ 多端支持

• CLI命令行 - 轻量级终端交互，适合快速开发
• JWork桌面应用 - OpenWork风格的JavaFX GUI，可视化AI协作台
• IntelliJ插件 - IDE内直接集成，无缝开发体验

🤖 多Agent智能协作

内置10+专业Agent覆盖开发全流程：

| Agent | 职责 |

|-------|------|

| Default | 通用开发助手 |

| Design | 架构设计 |

| Code | 编码实现 |

| Review | 代码审查 |

| Test | 测试工程 |

| Debug | 错误诊断 |

| Doc | 文档编写 |

| DevOps | 部署运维 |

• 异步子代理：后台任务不阻塞主对话
• 动态切换：智能委派最合适的Agent
• YAML配置：无需编码自定义Agent

🪝 Hooks自动化系统

事件驱动的工作流自动化：

```yaml

name: "auto-format-java"

trigger:

type: "POST_TOOL_CALL"

tools: ["WriteFile"]

file_patterns: ["*.java"]

execution:

type: "script"

script: "google-java-format -i ${MODIFIED_FILES}"

```

支持工具调用、Agent切换、错误处理等多种触发时机。[详细文档](docs/HOOKS.md)

🔍 代码图谱系统

基于AST的代码理解与导航：

• AST解析：Java代码结构化分析
• 混合检索：图检索 + 向量检索
• 影响分析：代码修改影响范围评估
• 智能定位：自然语言快速定位代码

[详细文档](docs/GRAPH_GUIDE.md)

⚡ 自定义命令

YAML配置即可扩展命令：

```yaml

name: "quick-build"

aliases: ["qb"]

execution:

type: "script"

script: "mvn clean install"

```

支持Script、Agent、Composite三种执行类型。[详细文档](docs/CUSTOM_COMMANDS.md)

🧠 智能记忆管理

基于ReCAP论文的上下文优化：

• 有界活动提示：防止上下文无限增长
• 结构化恢复：父子Agent语义连续
• Token优化：节省30-50% Token消耗

[详细文档](docs/ReCAP记忆优化技术方案.md)

🧩 Skills技能包

领域知识模块化管理，关键词自动激活。[详细文档](docs/SKILLS_README.md)

🌐 RAG检索增强

本地向量索引，自动检索相关代码注入上下文。[详细文档](docs/RAG配置指南.md)

🔌 多模型支持

支持OpenAI、Moonshot、Qwen、DeepSeek、Claude、Ollama等主流LLM。

🌐 MCP协议集成

支持Model Context Protocol，集成外部工具服务（Git、GitHub、Database等）。

🛠️ 丰富工具生态

• 文件操作：读写、搜索、补丁
• Shell执行：命令执行、后台任务
• 网络工具：网页抓取、搜索
• 任务管理：同步/异步子Agent、待办事项
• 人机交互：AskHuman暂停等待输入
• 代码图谱：智能定位、影响分析

🔐 企业级特性

• 审批机制：敏感操作人工审批
• YOLO模式：自动批准所有操作
• 循环控制：防止无限循环
• 会话管理：持久化与断点恢复
• 上下文压缩：智能Token优化

🖥️ JWork桌面应用

可视化的AI协作台，提供丰富的图形界面：

• 工作区选择与管理
• 会话管理与流式输出
• 执行计划时间线
• Skills管理器
• Markdown渲染支持
• 本地嵌入/远程连接模式

```bash

# 启动JWork

cd jwork

mvn javafx:run

```

环境要求

• Java 17+
• Maven 3.6+
• macOS / Linux / Windows

CLI命令行

```bash

git clone https://github.com/leavesfly/Jimi.git

cd Jimi

./scripts/quick-install.sh

```

JWork桌面应用

```bash

# 构建并运行

cd jwork

mvn clean install

mvn javafx:run

# 或者使用打包后的jar

java -jar target/jwork-0.1.0.jar

```

分步安装

```bash

# 1. 检查环境

./scripts/check-env.sh

# 2. 构建项目

./scripts/build.sh

# 3. 初始化配置

./scripts/init-config.sh

# 4. 启动Jimi

./scripts/start.sh

# 指定Agent启动

./scripts/start.sh --agent design

# YOLO模式

./scripts/start.sh --yolo

```

常用命令

| 命令 | 说明 |

|------|------|

| /help | 帮助信息 |

| /status | 系统状态 |

| /tools | 工具列表 |

| /agents | Agent列表 |

| /graph build | 构建代码图 |

| /hooks list | Hooks列表 |

| /async list | 异步任务 |

| /reset | 清除上下文 |

```mermaid

graph TB

subgraph 用户交互层

CLI[CLI命令行]

IDE[IntelliJ插件]

end

subgraph 核心引擎层

Engine[JimiEngine]

Executor[AgentExecutor]

Memory[ReCAP记忆]

Approval[审批机制]

end

subgraph Agent系统

AgentRegistry[Agent注册表]

MultiAgents[10+ 专业Agent]

AsyncMgr[异步子代理]

end

subgraph 知识增强层

Skills[Skills系统]

Graph[代码图谱]

RAG[向量检索]

end

subgraph 自动化层

Hooks[Hooks系统]

Commands[自定义命令]

end

subgraph 工具系统

ToolRegistry[工具注册表]

FileTools[文件工具]

MCPTools[MCP工具]

GraphTools[图谱工具]

end

subgraph LLM层

LLMFactory[LLM工厂]

Providers[多提供商]

end

CLI --> Engine

IDE --> Engine

Engine --> Executor

Engine --> Memory

Engine --> Approval

Execut