FonaTech/Clouds-Coder

Clouds Coder – 是什么

Clouds Coder 是一个基于 Python 的运行时，允许您在本地或云主机上运行命令行工具（CLI 执行平面），同时通过功能丰富的浏览器 IDE（Web 用户平面）与进程进行交互。它围绕通用 AI 代理构建，增加了局域网（LAN）范围的协作模式，使多个用户及其私有代理可以共同处理同一项目，而不会互相干扰。

核心理念是将繁重的执行任务（例如 git、make、docker、自定义脚本）与用户界面分离，从而带来以下优势：

• 可观察、可重放的运行（完整日志、调试控制台、终端输出）；
• 带文件级历史记录的版本化工作区；
• “提示增强器”可将用户的请求扩展为更丰富、具有深度预算的代理计划；
• 细粒度的安全性——每个工具调用必须经过管理员批准后，才能在特定工作区中运行。

---

主要组件（如 README 所述）

组件	功能
运行时（CLI 执行平面）	执行任意命令，运行 Python debugpy 或 pdb 进行调试，并将结果反馈给 UI。
浏览器 IDE	基于 Monaco 的编辑器、文件浏览器、终端、调试控制台，以及 代理聊天、任务黑板、诊断信息面板。
Liquid Kernel	不可变的控制平面，存储已签名的工具策略、提示策略和生命周期钩子（before_run、before_round、after_tool_results）。处理内测发布和回滚内核版本。
协作模式（LAN）	默认使用 P+7 的独立监听器，托管受管理的项目工作区。经批准的设备通过密码 + 设备密钥流程加入，获得 24 小时 HttpOnly 会话，可查看版本化文件、在线状态和共享任务黑板。
代理编排	在会话中，代理可担任角色（manager、explorer、developer、reviewer）。在项目层面，协调者 代理将工作切分，贡献者 代理执行不重叠的切片。
提示增强器	支持单次或持久性提示，可配置深度预算（Low → XHigh）。在发送请求给 LLM 前，添加工作区感知和可选技能编排。
安全与信任边界	管理员批准设备，定义允许的 MCP（模型控制进程）命令，并对存储在 SQLite 中的注册表进行签名。任何对已批准配置的更改都会使现有批准失效。
版本感知写入协议	文本编辑使用操作转换；二进制/全文件写入使用乐观并发；Shell/代理进程获取变更租约，以保证多文件更新的原子性。

---

典型工作流程

1. 启动运行时 – python Clouds_Coder.py --host 0.0.0.0 --port 8080（运行时在 8080，IDE 在 8085，协作在 8087）。
2. 打开 IDE – 访问 http://127.0.0.1:8085。IDE 显示会话工作区、编辑器、终端和 代理聊天 面板。
3. 向代理提问 – 输入高层次目标（例如：“用 Docker 设置一个 Flask 项目”）。提示增强器扩展请求，代理规划步骤，运行时执行 CLI 命令并流式传输输出到 IDE。
4. 协作 – 启用 --enable_collaboration。通过管理员 UI（/admin → Collaboration）邀请队友。设备批准后，队友打开项目 URL（P+7），看到相同的版本化文件、共享黑板和彼此的在线状态。
5. 解决冲突 – 如果两个代理尝试修改同一文件，系统会创建候选分支，冻结基线，并强制由两名不同成员审查后才能合并。
6. 审计与回滚 – 所有操作均签名并存储在不可变的 SQLite 审计链中。管理员可回滚内核版本或恢复之前的项目快照。

---

谁会使用它？

• 需要可复现环境来测试驱动 CLI 的 AI 代理的AI 代理开发者。
• 希望拥有低门槛、仅限局域网的协作 IDE，且能观察和审计每一条命令的开发团队。
• 教授“氛围编程”（引导 AI 完成编码任务，同时实时观察终端和文件变化）的教育者/实验室。
• 要求任何工具调用都需明确批准并希望拥有完整审计追踪的安全意识强的组织。

---

安装与快速入门（来自 README）

pip install clouds-coder   # 获取最新 PyPI 版本
# 在端口 8080 启动运行时（IDE 在 8085，协作在 8087）
python Clouds_Coder.py \
  --host 0.0.0.0 \
  --port 8080 \
  --enable_collaboration \
  --collab_host 0.0.0.0 \
  --collab_port 8087

• 打开 http://127.0.0.1:8085 访问 IDE。
• 打开 http://127.0.0.1:8080/admin 创建项目、设置密码并批准设备。
• 用于生产 LAN 环境时，提供 --collab_tls_cert/--collab_tls_key 或在前端放置 HTTPS 反向代理。

---

更多学习资源

• 变更日志 – 详细的功能历史记录在 log/CHANGELOG‑*.md 中（例如 2026-09-12 的“Liquid Kernel & Scalable Session Runtime”变更日志）。
• LLM 配置模板 – LLM.config.json 展示了如何集成服务器端 LLM 配置、技能和 RAG 资源。
• 架构图 – README 包含 Mermaid 流程图，展示运行时、控制平面和协作边界。

---

总结

Clouds Coder 是一个真实、生产级平台，将 AI 驱动的 CLI 执行器与基于 Web 的 IDE 及受管理的局域网协作层结合。其重点在于让复杂的命令行任务对多个用户和代理参与者而言，具备可观测性、可复现性和安全性。