zhikunqingtao/zhikuncode

解决的问题

ZhikunCode 是一款开源 AI 编程助手，设计为通过 Docker 进行自托管，让用户能直接从任何设备的网页浏览器控制整个开发工作流程。它通过提供代理委派、后台任务管理以及与各种 LLM（特别是中国供应商的模型）的直接集成，解决了设置 AI 编码环境的复杂性。

运作方式

该系统采用多层架构，包含 Java Agent Runtime、基于 React 的浏览器界面以及用于代码分析的 Python Capability Service。它采用具有六层压缩的「ContextCascade」引擎来处理极长的对话，并使用「SelfCorrectionLoop」自动诊断并修复编译或测试失败。该助手通过一组专门的代理（五种角色）并行执行任务，并设有统一的安全网关（Tool Gateway）来分析风险并管理所有工具调用的权限。

目标对象

专为希望拥有可自托管、安全且支持广泛 LLM（包括 Qwen、DeepSeek、Moonshot 和 GLM）的 AI 编码助手的开发者而设计，并提供包含终端、Git 和浏览器功能的完整工作空间。

特色亮点

• 基于浏览器的控制：完整的流程管理，包括权限批准与任务控制，无需安装客户端即可通过任何浏览器访问。
• 先进的上下文管理：六层压缩与增量折叠，在超长对话中维持高性能。
• Java 核心：高性能核心引擎以纯 Java 实现，REST API 与 WebSocket 响应无外部依赖。
• 运行时验证：使用 JSONPath 断言与证据链（截图、日志、视频）来验证 AI 生成代码输出的框架。
• 多模态支持：图像分析的智能路由，在需要时自动切换至具备视觉能力的模型。
• Docker 部署：通过 docker compose up -d 进行简单的一键式快速部署。