Imported from xuyangjie1998-spec/MoJing-AI (
AGENTS.md). Install upstream withnpx skills add xuyangjie1998-spec/MoJing-AI. Copyright stays with the author.
AGENTS.md — AI 网文共创平台
项目概述
Android 应用，AI 辅助网文创作平台，支持 Agent 自主工作流、多轮思考、流式输出。
架构
- MVVM + Clean Architecture：ChatViewModel → UseCase → Repository → Room/Api
- Agent 系统：AgentRuntime（思考→行动→检查循环）+ AgentOrchestrator + AgentRunController
- 流式通信：OkHttp SSE + channelFlow + 节流控制
- 工具系统：内置工具 + MCP 远程工具 + InkOS 工具
核心文件
| 文件 | 职责 | 行数 |
|---|---|---|
ChatViewModel.kt |
聊天状态管理 + 用例调度 | ~530 |
AgentStateHolder.kt |
Agent 专属状态（角色卡/审批/快照） | ~104 |
AgentRunController.kt |
Agent 执行控制器 | ~250 |
AgentOrchestrator.kt |
AgentRunner 实现 + 工具注册 | ~250 |
AgentRuntime.kt |
核心 Agent 循环引擎 | ~500 |
StreamUseCase.kt |
流式 AI 响应用例 | ~200 |
StreamContinuationEngine.kt |
自动续写引擎 | ~150 |
OpenAiCompatAgentLlm.kt |
LLM 通信层（原生 FC + JSON 协议） | ~350 |
AiApiService.kt |
OkHttp SSE 通信 + 多模态序列化 | ~210 |
McpClientManager.kt |
MCP 客户端管理 + 自动重连 | ~260 |
已完成功能（11/11）
- ✅ 原生 Function Calling（P0-1）
- ✅ Thinking 可视化（P0-2）
- ✅ Token 用量追踪（P0-3，含 API 实际值管道）
- ✅ Schema 自动校验（P1-1）
- ✅ 历史回放增强（P1-2）
- ✅ 用户确认机制（P1-3，ToolApprovalDialog + CompletableDeferred）
- ✅ Plan-Execute 分离（P2-1）
- ✅ 渐进式压缩（P2-2）
- ✅ 代码沙箱（P3-1）
- ✅ 多模态输入（P3-2，附件 → base64 → OpenAI vision API）
- ✅ Agent 人格系统（P3-3）
Bug 修复
- ✅ Agent 卡死修复（OkHttp 120s + withTimeout + CompletableDeferred 清理）
- ✅ 重启后"执行中"修复（recoverInterruptedRuns 时序 + sessionId 等待）
- ✅ resume/retry 配置丢失修复（persona/planExecute/onToolApproval 全链路传递）
- ✅ NPE crash 修复（Gson null-safety + tc.index 累积）
架构重构
- ✅ AgentOrchestratorConfig（14 参数 → Config 对象）
- ✅ AgentStateHolder（从 ChatViewModel 提取 Agent 状态）
- ✅ MultimodalMessageSerializer（自定义 Gson 序列化，支持 OpenAI vision 格式）
低优先级待办
| 项目 | 影响 | 状态 |
|---|---|---|
| Token 用量 UI 接入实际值 | 显示精确 token 数 | 管道已就绪，UI 层待对接 |
| 测试覆盖 | 质量保障 | 仅 GuardrailsTest |
| TODO 项 | PerformanceBaseline/FeedbackCollector | 功能缺口 |
