lang-code

工具办公软件案例ID：253097

秋生

15 年经验· 平安陆金所

微信扫码沟通，客服可协助直接对接工程师；如当前档期不合，也可继续推荐相似案例作者。

案例介绍

【技术栈】
-包管理：uv
-CLI框架：Typer+Rich
-Agent框架：LangGraph
-状态管理：StateGraph+AgentState（Pydantic）
-持久化：文件系统JSON（项目/任务）+SQLite（检查点）
-配置：YAML（.lang-code/lang-code.yaml），Pydantic模型校验
【实现功能】
核心Agent：
-LangGraph图编排：START→maybe_compress→llm→human_approval→tools→check_completion→END
-多轮对话（chat）与一次性任务（run）两种运行模式
-LLM调用自动重试（指数退避）
-对话历史压缩（token超阈值时自动摘要）
-子代理（subagent）：通过spawn_subagent信号工具派生子图执行子任务，结果通过finalize节点返回
-LangGraphsubgraphs流式事件处理
工具系统：
-内置工具：读/写/编辑文件、glob、grep、ls、shell执行、计算器、web_search
-安全管理：路径沙箱（限制在workdir内且禁止操作.lang-code目录）、命令黑名单
-Todo系统：write_todo/read_todo管理项目和子任务，自动完成检测
人机协作（HITL）：
-工具调用需审批时通过interrupt()暂停，用户可选择once/always/reject
-审批状态持久化（approved_tool_calls按工具名追踪）
-支持主图和子图独立HITL
扩展能力：
-插件系统：.py文件自动加载tools列表
-技能系统：带YAMLfrontmatter的markdown文件注入systemprompt
-MCP集成：通过langchain-mcp-adapters调用外部MCP