DeepTutor 开发者与智能体手册¶

从这里开始安装、诊断或修改 DeepTutor。本手册描述的是 1.7.0 源码树；在其他发布版本上工作时，请使用同一标签（tag）对应的文档。版本权威依据是 deeptutor/__version__.py。除非某个页面另行说明，以下命令均从仓库根目录运行。

选择阅读路径¶

对于具备终端能力的智能体，请在编辑前阅读本索引、AGENTS.md 和任务指南。SKILL.md 是精简的 CLI 参考。在参考示例之前，请检查检出内容、工作树更改、Python 环境和运行时主目录。将现有用户数据和凭证与一次性测试夹具分开存放。在决定重新安装之前，先对失败的安装进行诊断。

主题地图¶

运行时与扩展开发¶

• 架构与源码所有者：入口点、持久轮次、前端边界与配置。
• 工具与能力：单次（single-shot）工具、负责轮次的管道、上下文门控和结果封装。
• 模块：发行包所有权、安装与生命周期。
• 插件：清单、审查、Worker、HTTP 和静态页面。
• 阅读扩展：经校验的选择上下文和有界结果。
• 事件与进度：轮次回放与索引进度，以及进程本地通知。
• 运行时设计：懒加载、隔离解析、私有模型历史和提示缓存可观测性。
• 远程 Hermes 后端：网关协议和 Connected Agents 集成。

存储、部署与功能契约¶

• 数据存储 与工作区：运行时主目录、账户/工作区范围、备份、资源分配和迁移。
• 容器化 与请求筛选：部署配置、OAuth 回调端口和代理边界。
• 知识迁移、索引恢复 与源视觉资料：摄取、发布、原始证据和视觉评估。
• 科学研究：论文工具、证据和 MCP 授权。
• 练习：题目导入、复习记录和调度。
• 视频学习 与语音：阅读媒体迁移、字幕、语音适配器和验证。
• 答案质量诊断：可复现的检索、引用、上下文和评估失败。

保持本手册的实用性¶

为每个契约保留一个规范页面，并链接到该页面。每个主题应指向其实现所有者或回归测试。当命令、路由、所有权或存储变更时，更新受影响的示例；生成的 schema 和模块清单优先于文字描述。记录每项检查所证明的内容，包括提供商/网络或平台限制。

将任务计划、一次性测试计数、截图、私有路径、下载的参考仓库以及无关的产品研究排除在本手册之外。使用 PR 或本地被忽略的输出作为执行证据。设计提案只有在实现可以被定位并验证后，才能被视为当前行为。