## 项目亮点 - **多 Agent 协作而非单次 Prompt**：通过 LangGraph 编排 Planner、项目分析、代码审查、RAG、监督和报告节点。 - **Harness Runtime 运行时治理**：统一任务上下文、事件时间线、产物、策略、人工审核、持久化与恢复执行。 - **真正可执行的可视化 Workflow**：前端拖拽画布会编译成 LangGraph 工作流执行，而不只是展示图。 - **LLM 可观测与可治理**：可查看 Prompt 版本、调用 Trace、token/cost、fallback、A/B Test，以及按 Agent 配置模型。 - **安全可治理的 Skill 插件体系**：Skill 有契约校验、权限分级、严格审批、版本快照、依赖检测、测试用例和执行日志。 - **插件市场与外部兼容**：支持内置包、本地路径、URL、GitHub 风格来源，以及外部 `SKILL.md` 自动转换。 - **Docker 代码型 Skill 沙箱**：第三方代码可以在禁网、只读、限时限资源的临时容器中运行。 - **受控长期记忆**：对话先经 LLM/规则提取为候选记忆，再通过质量评分、冲突检测、人工确认、生命周期策略和 scope 权限边界沉淀到 RAG。 - **遗忘衰减而非无限累积**：稳定规则长期保留；普通偏好进入 90 天复核，到期后标记为 `expired` 并退出检索，但保留审计记录，可由用户刷新、更新或删除，避免陈旧偏好和过时决策持续干扰 Agent。 - **RAG 治理与可评测**：知识库支持增量索引、文档版本化、ACL 权限过滤、BM25/向量混合检索、可选 LLM Rerank 和 Chunk Gold Set。 - **缤纷 / 清透双主题 UI**：顶部可在带黄绿蓝粉彩色环境光柱的“缤纷”主题与 SVG 折射水玻璃“清透”主题之间切换；清透模式支持边缘折射、悬浮阴影、点击涟漪和模式按钮液态连贯切换，并在浏览器本地保存用户选择。 ### 首次使用流程 1. 首次安装且应用私有工作区全空时，系统会自动生成示例项目 `/workspace/DevAgent-Studio`。只有分析自己的项目时，才需要先把项目目录放入应用数据的 `workspace` 文件夹，再在页面填写 `/workspace/<项目名>`，见附图。 2. 进入 `LLM`，确认顶部显示“LLM 已配置 · 模型名”。如果显示“LLM 未配置”，请先检查安装配置中的 API Key、Base URL 和模型 ID；未配置时只能使用确定性分析与 fallback，不能得到完整模型报告。 3. 进入 `运行`，选择 `Collab`。项目路径填写 `/workspace/DevAgent-Studio`，目标可填写：`请分析项目结构、核心模块与数据流，列出三个最高优先级的改进建议，并为每条建议给出验证方法。` 文件数填写 `80`，关闭“人工审核”。 4. 点击“运行多 Agent 协作”。执行事件会依次展示 Planner、Project Analyzer、Code Reviewer、RAG Processor、Supervisor 和 Reporter；等待右侧当前状态变为 `completed`。项目分析和 RAG 结果中的文档、切片数量应大于 0，否则应先检查项目路径和工作区内容。 5. 进入 `报告`，依次打开“最终报告”“架构导师视角”“Mermaid 图”“治理建议”，确认四类内容均能显示。刷新页面后，当前报告分栏仍会通过 URL 中的 `reportTab` 参数恢复。 6. 进入 `追问`，输入：`把最高优先级建议拆成一周内可完成的三步计划，并为每一步补充验收标准。` 页面应结合刚完成的任务与报告返回回答。至此，项目扫描、多 Agent 协作、RAG、报告和上下文追问的首次核心流程即完成。 ### 日常使用方式 - **选择执行模式**：在 `运行` 中按任务选择模式。`Agent` 适合快速完成项目分析，`Collab` 适合完整的规划、分析、审查、RAG 与报告协作，`Workflow` 执行当前画布，`Planner` 根据目标生成流程；`Tool` 和 `Knowledge` 分别用于工具调用与知识检索。 - **跟踪与复盘任务**：运行时在“执行事件”查看节点状态、Agent 输出和工具调用；结束后到 `历史` 重新选择任务并查看报告。需要继续细化结论时，到 `追问` 围绕当前任务提问，不必重新运行整个分析。 - **阅读与分享结果**：在 `报告` 切换“最终报告 / 架构导师视角 / Mermaid 图 / 治理建议”。分栏会写入 `reportTab` 参数，复制当前链接或刷新页面后仍可恢复同一视角。 - **编排可复用流程**：在 `编排` 中拖放节点、连接执行顺序，先点击“校验 Workflow”，再保存或运行。Skill 节点按 `skill_code + agent_code` 审批，MCP 节点按 `server_id + tool_name + agent_code` 审批；审批身份必须与实际执行身份一致。 - **维护项目知识**：通过 Collab 中的 RAG Processor 增量处理项目，在报告或知识相关入口查询 `project-memory`、保存知识笔记，并通过 ACL、Gold Set 和评测结果检查检索质量。 - **治理模型调用**：在 `LLM` 查看调用次数、Token/Cost、fallback、Agent/模型/Prompt 汇总和单次 Trace；使用 Prompt A/B Test 比较两个提示词版本后，再结合 Trace、耗时和输出质量选择版本。 - **使用 MCP 与 Skills**：在 `MCP` 保存 server 后先点击 `Discover`，为具体 `agent_code` 审批工具，再做测试调用并查看日志。在 `Skills` 查看权限、风险、输入输出 Schema、版本快照和执行日志；第三方代码 Skill 应先审查再审批。 - **管理插件**：在 `Market` 先预览来源、TRUST、权限和 manifest，再安装内置资源包、ZIP、`plugin.json` 或单独 `SKILL.md`。