给你的 AI 助理加上 To Do 功能：让它真正帮你管任务

让懒猫微服里的“小龙猫”助手，通过 `agenttodo-assistant` 技能，连接到 AgentTODO，然后帮你查看、创建、拆分和更新待办任务。 你可以把它理解成： - AgentTODO 负责保存你的任务。 - 小龙猫负责和你聊天、理解你的需求。 - `agenttodo-assistant` 技能负责告诉小龙猫应该怎么调用 AgentTODO。 ## 0. 准备条件 ### 0.1 需要先安装的应用 请先在懒猫微服中安装并启动下面几个应用。 1. 小龙猫 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.totoro 2. AgentTODO https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.agenttodo 3. 局域网端口转发工具 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.forward ### 0.2 先在小龙猫中创建一个助手 打开小龙猫后，你需要先完成这些基础配置： 1. 安装或创建一个 Agent。 2. 创建一个助手。 3. 配置好这个助手使用的 AI 模型。 4. 确认可以正常和助手对话。 如果你现在还没有办法正常和小龙猫里的助手聊天，请先把小龙猫的基础配置完成，再继续后面的步骤。  ## 1. 为什么需要端口转发 在懒猫微服里，每个应用都是一个独立的容器。 这意味着： - 小龙猫是一个应用容器。 - AgentTODO 是另一个应用容器。 - 它们虽然都装在同一个懒猫微服里，但并不能直接用 `localhost` 互相访问。 很多新手最容易出错的地方，就是让小龙猫访问： ```text http://localhost:3300 ``` 这通常是不对的。 因为这里的 `localhost` 指的是“小龙猫自己所在的容器”，不是 AgentTODO 所在的容器。 所以我们需要先用“局域网端口转发工具”，把 AgentTODO 的 `3300` 端口转发到微服的物理网卡 IP 上。这样小龙猫助手就可以通过一个局域网地址访问 AgentTODO。 ## 2. 配置 AgentTODO 端口转发 这一部分的目标是得到一个小龙猫可以访问的 AgentTODO 地址，格式类似： ```text http://192.168.1.140:3300 ``` 其中 `192.168.1.140` 要替换成你自己的微服物理网卡 IP。 ### 2.1 打开局域网端口转发工具 在懒猫微服中打开“局域网端口转发工具”，新增一条端口转发规则。  ### 2.2 填写基础信息和入口配置 请按下面方式填写： 1. `备注`：填写 `AgentTODO 端口开放` 2. `协议`：选择 `TCP` 3. `局域网入口类型`：选择 `微服物理网卡` 4. `监听端口 / 端口段`：填写 `3300` 这里最重要的是 `局域网入口类型`。 一定要选择： ```text 微服物理网卡 ``` 这样转发出来的地址才会变成局域网里可以访问的地址。  ### 2.3 填写目标配置 继续填写目标配置： 1. `转发目标类型`：选择 `微服应用` 2. `微服应用`：选择 `AgentTODO` 3. `实例用户`：选择当前 AgentTODO 所在的用户，一般保持默认即可 4. `服务`：选择 `agenttodo` 5. `目标端口`：填写 `3300` 填写完成后，点击 `测试目标连接`。 - 如果测试成功，保存这条规则。 - 如果测试失败，请先看后面的常见问题。  ### 2.4 记住微服物理网卡 IP 保存端口转发规则后，请记住你的微服物理网卡 IP。 比如你的微服物理网卡 IP 是： ```text 192.168.1.140 ``` 那么 AgentTODO 的访问地址就是： ```text http://192.168.1.140:3300 ``` 后面要把这个地址告诉小龙猫助手。 请注意： - 不要写成 `localhost`。 - 不要写成 `127.0.0.1`。 - 不要漏掉前面的 `http://`。 - 不要漏掉后面的端口 `:3300`。  ## 3. 在小龙猫中安装 AgentTODO 技能 这一部分的目标是让小龙猫助手学会怎么使用 AgentTODO。 技能地址是： ```text https://github.com/iHunterDev/agenttodo-assistant ``` ### 3.1 直接让助手安装技能 打开你在小龙猫中创建好的助手，直接发送下面这段话： ```text 请帮我安装这个技能： https://github.com/iHunterDev/agenttodo-assistant ```  ### 3.2 等待技能安装完成 安装完成后，小龙猫应该会告诉你技能已经安装成功，或者可以开始使用这个技能。 如果安装失败，请先确认： - GitHub 地址是否复制完整。 - 小龙猫当前是否可以正常联网。  ## 4. 告诉助手 AgentTODO 地址 技能安装好以后，还需要告诉助手你的 AgentTODO 地址。 假设你前面记下来的微服物理网卡 IP 是： ```text 192.168.1.140 ``` 那么你就对助手发送： ```text My AgentTODO address is http://192.168.1.140:3300 ``` 请把 `192.168.1.23` 换成你自己的微服物理网卡 IP。 发送以后，助手会根据这个地址自动推导出 AgentTODO API 地址： ```text http://192.168.1.140:3300/api ``` 一般情况下，你不需要手动填写 `/api`，只需要告诉助手 AgentTODO 页面地址即可。  ## 5. 测试是否连接成功 现在用一两句话测试一下即可。 ### 5.1 查看今天的任务 对助手发送： ```text 帮我看看今天要做什么。 ``` 如果连接成功，助手会去 AgentTODO 中读取今天的任务，然后再回复你。 如果你今天还没有任务，它可能会告诉你今天没有待办。  ### 5.2 创建一个简单任务 继续测试创建任务： ```text 帮我创建一个任务：明天下午 3 点前提交周报。 ``` 创建完成后，你可以打开 AgentTODO 页面（去应用列表，打开 AgentTODO 这个应用，可以看到当前的任务和管理任务），看任务是否已经出现。   ## 6. 配置完成后可以怎么用 上面的步骤走完以后，基础配置就完成了。 下面这些不是必须操作的流程，只是一些日常使用时可以参考的说法。你可以按自己的习惯直接和助手说。 ### 6.1 查看任务 ```text 今天我有哪些任务？ ``` ```text 帮我看一下最近有哪些还没完成的事情。 ``` ```text 我这周的任务压力大不大？ ``` ### 6.2 创建任务和计划 ```text 帮我添加一个任务：明天下午 3 点前提交周报。 ``` ```text 帮我创建一个学习 Python 的计划，拆成 5 个步骤。 ``` ```text 帮我记录一个每周五下午整理工作台的重复任务。 ``` ### 6.3 记录进展 ```text 我已经写完周报初稿了，帮我记录一下。 ``` ```text Python 学习计划里，环境安装这一步已经完成了。 ``` ```text 搬家计划完成了，帮我把它标记为完成。 ``` ### 6.4 查找任务 ```text 帮我找一下和搬家有关的任务。 ``` ```text 我之前是不是记过一个买显示器的任务？ ``` ## 7. 常见问题 ### 7.1 为什么不能用 `localhost:3300` 因为小龙猫和 AgentTODO 是两个不同的应用容器。 在小龙猫里，`localhost` 指的是小龙猫自己的容器，不是 AgentTODO 的容器。所以小龙猫访问 `localhost:3300` 时，通常找不到 AgentTODO。 正确做法是使用微服物理网卡 IP，例如： ```text http://192.168.1.140:3300 ``` ### 7.2 端口转发测试失败怎么办 建议按下面顺序检查： 1. AgentTODO 是否已经启动。 2. `协议` 是否选择了 `TCP`。 3. `局域网入口类型` 是否选择了 `微服物理网卡`。 4. `监听端口 / 端口段` 是否填写了 `3300`。 5. `转发目标类型` 是否选择了 `微服应用`。 6. `微服应用` 是否选择了 `AgentTODO`。 7. `服务` 是否选择了 `agenttodo`。 8. `目标端口` 是否填写了 `3300`。 如果这些都正确，但仍然失败，可以重启 AgentTODO 后再测试一次。 ### 7.3 助手说无法连接 AgentTODO 优先检查你告诉助手的地址是否正确。 地址应该类似： ```text My AgentTODO address is http://192.168.1.140:3300 ``` 请重点检查： - IP 是否是微服物理网卡 IP。 - 端口是否是 `3300`。 - 前面是否有 `http://`。 - 有没有错误地写成 `localhost` 或 `127.0.0.1`。 ### 7.4 浏览器能打开 AgentTODO，但助手还是访问失败 请确认你是在同一个网络环境下测试。 有时候你的电脑浏览器能打开某个地址，不代表小龙猫所在的容器也一定能访问它。 在本教程的场景中，建议使用“局域网端口转发工具”暴露出来的微服物理网卡地址，也就是： ```text http://微服物理网卡IP:3300 ``` ### 7.5 技能安装失败怎么办 请检查下面几项： 1. 技能地址是否完整： ```text https://github.com/iHunterDev/agenttodo-assistant ``` 2. 小龙猫是否可以正常访问 GitHub。 3. 当前助手是否已经完成 AI 模型配置。 4. 当前助手是否支持安装技能。 如果只是网络问题，可以稍后再试或者使用小猪佩奇（找 VIP 群获取）。 ### 7.6 任务创建了，但内容不是我想要的 你可以直接让助手修改，例如： ```text 把刚才那个搬家计划改得更细一点，每一步都写清楚要做什么。 ``` 或者： ```text 这个任务不要放到下周了，改成这周五之前完成。 ``` 对于比较重要的任务，建议你让助手先列出计划，确认后再创建： ```text 先不要创建任务，先帮我列一个计划，我确认后你再写入 AgentTODO。 ``` ### 7.7 需要把 AgentTODO 暴露到公网吗 不建议。 AgentTODO 技能的默认使用场景是可信局域网。请不要把 AgentTODO 直接暴露到公网，避免不必要的安全风险。 ## 8. 最后确认 如果下面几件事都能完成，就说明配置成功了： 1. 你可以通过 `http://微服物理网卡IP:3300` 打开 AgentTODO。 2. 小龙猫已经安装 `agenttodo-assistant` 技能。 3. 你已经告诉助手 AgentTODO 地址。 4. 助手可以读取今天的任务。 5. 助手可以创建任务、拆分子任务、记录进展。 完成以后，你就可以把小龙猫当成自己的任务助理来用了。