HKUDS/DeepCode

  ██████╗ ███████╗███████╗██████╗  ██████╗ ██████╗ ██████╗ ███████╗
██╔══██╗██╔════╝██╔════╝██╔══██╗██╔════╝██╔═══██╗██╔══██╗██╔════╝
██║  ██║█████╗  █████╗  ██████╔╝██║     ██║   ██║██║  ██║█████╗
██║  ██║██╔══╝  ██╔══╝  ██╔═══╝ ██║     ██║   ██║██║  ██║██╔══╝
██████╔╝███████╗███████╗██║     ╚██████╗╚██████╔╝██████╔╝███████╗
╚═════╝ ╚══════╝╚══════╝╚═╝      ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝

# DeepCode: 开放式智能编程 (Open Agentic Coding)

### *通过多智能体系统推动代码生成技术的发展*

### 🖥️ 界面展示

#### 🖥️ CLI 界面
**基于终端的开发体验**

*   🚀 先进的终端交互体验
*   ⚡ 快速的命令行工作流
*   🔧 开发者友好的界面
*   📊 实时进度跟踪

*面向高级用户和 CI/CD 集成的专业终端界面*

#### 🌐 Web 界面
**可视化交互体验**

*   🎨 现代 Web 面板
*   🖱️ 直观的拖拽操作
*   📱 响应式设计
*   🎯 可视化进度跟踪

*精美的 Web 界面，为各技能水平的用户提供精简的工作流*

---

### 🎬 介绍视频

*🎯 **观看我们的完整介绍** - 了解 DeepCode 如何将研究论文和自然语言转化为生产级代码*

---

> *"AI Agent 将创意转化为生产级代码的地方"*

---

## 📑 目录

- [📰 最新动态](#-最新动态)
- [🚀 核心功能](#-核心功能)
- [🏗️ 架构设计](#️-架构设计)
- [📊 实验结果](#-实验结果)
- [🚀 快速开始](#-快速开始)
- [🤖 nanobot 集成 (飞书聊天机器人)](#-nanobot-集成-feishu-chatbot)
- [💡 示例](#-示例)
  - [🎬 现场演示](#-现场演示)
- [⭐ Star 历史](#-star-历史)
- [📄 许可协议](#-许可协议)

---

## 📰 最新动态

🧭 **[2026-05-01] OpenRouter 模型选择器、会话清理与工作流 UX 强化**

- 🧠 **设置中新增 OpenRouter 模型目录。** 新的 UI 现在可以从 `https://openrouter.ai/api/v1/models` 获取 OpenRouter 模型元数据，在本地缓存，并为默认、规划和实现阶段提供可搜索的模型选择器。使用精确的 OpenRouter 模型 ID（如 `z-ai/glm-5.1`），无需手动编辑 JSON。
- 🔄 **运行时模型切换。** 在设置中保存模型选择会更新 `deepcode_config.json` 并重新加载进程内的 LLM 运行时，以便新启动的工作流立即使用选定的服务商/模型组合。
- 🗑️ **会话删除现支持安全级联清理。** 从 UI 中删除会话会移除其持久化会话存储及关联的 `deepcode_lab/tasks//` 工作区，同时保留共享的 `uploads/` 源文件。状态为 `pending`、`running` 或 `waiting_for_input` 的任务将被锁定，并返回明确的 `409 Conflict` 错误。
- 📊 **更准确的 Paper2Code 进度。** 前端现在会显示后端阶段消息，并避免在 LLM 长时间运行期间将中间阶段标记为“完成”。
- 🛡️ **工作流稳健性修复。** 上传功能现在会拒绝 Git LFS 指针文件；取消任务可立即停止后端工作；陈旧的浏览器会话 ID 可清晰恢复；当模型推迟或工具调用不正确时，规划器重试会回退到最小有效计划；文档分段跳过了可能导致进度停滞的多余验证 LLM 调用。

---

🗂️ **[2026-04-28] 持久化会话与双层日志记录**

- 🆕 **会话现已实现持久化。** 每次 CLI / UI 运行都会自动附加到 `~/.deepcode/sessions//` 下的会话中（可通过 `DEEPCODE_SESSIONS_DIR` 覆盖）。会话为 JSONL 格式 —— `tail -f session.jsonl` 开箱即用。通过 `python cli/main_cli.py session list|show |new|resume |delete ` 或后端的 `GET /api/v1/sessions` 进行列表/查看/分支管理。
- 🔄 **恢复之前的运行。** 通过向 CLI 传递 `--session ` 或向 `POST /api/v1/workflows/paper-to-code`（或 `chat-planning`）传递 `session_id` 即可恢复。后端重启不再丢失任务历史；崩溃后遗留的正在运行的任务会被标记为 `interrupted`。
- 💻 **CLI 会话 UX。** 交互式 CLI 现在支持 Cursor 风格的斜杠命令：`/resume` 打开编号的会话选择器，`/new [title]` 创建并切换会话，`/session` 显示当前活动会话，`/help` 列出所有命令。您还可以在菜单提示符处直接粘贴输入，例如 `@/path/to/paper.pdf`，`@"C:\path with spaces\paper.pdf"`，或 `@https://...`。
- 📜 **双层结构化日志。** 全局轮转 JSONL 日志位于 `logs/server-YYYYMMDD.jsonl`；每个任务的日志位于 `deepcode_lab/tasks//logs/{system,llm,mcp}.jsonl`。每个 `loguru.logger` 调用通过 contextvar 自动获取活跃的 `task_id` —— 业务代码无需改动。可通过 `deepcode_config.json` 中的新 `logger.{globalFile,taskFile,llm}` 块进行配置。
- 📡 **WebSocket 日志流。** 使用 `/ws/tasks/{task_id}/logs?channel=` 追踪单个任务日志。