给你的 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. 确认可以正常和助手对话。

如果你现在还没有办法正常和小龙猫里的助手聊天，请先把小龙猫的基础配置完成，再继续后面的步骤。


![image.png](https://dl.playground.lazycat.cloud/guidelines/779/c5489a95-9c8a-4598-ae5a-599ac26bd9c2.png "image.png")

## 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 打开局域网端口转发工具

在懒猫微服中打开“局域网端口转发工具”，新增一条端口转发规则。


![image.png](https://dl.playground.lazycat.cloud/guidelines/779/19e7c06c-6ffc-409c-9bbd-e257e24372fd.png "image.png")

### 2.2 填写基础信息和入口配置

请按下面方式填写：

1. `备注`：填写 `AgentTODO 端口开放`
2. `协议`：选择 `TCP`
3. `局域网入口类型`：选择 `微服物理网卡`
4. `监听端口 / 端口段`：填写 `3300`

这里最重要的是 `局域网入口类型`。

一定要选择：

```text
微服物理网卡
```

这样转发出来的地址才会变成局域网里可以访问的地址。


![image.png](https://dl.playground.lazycat.cloud/guidelines/779/a283caf5-04ef-486f-bd32-e11c3feedaba.png "image.png")

### 2.3 填写目标配置

继续填写目标配置：

1. `转发目标类型`：选择 `微服应用`
2. `微服应用`：选择 `AgentTODO`
3. `实例用户`：选择当前 AgentTODO 所在的用户，一般保持默认即可
4. `服务`：选择 `agenttodo`
5. `目标端口`：填写 `3300`

填写完成后，点击 `测试目标连接`。

- 如果测试成功，保存这条规则。
- 如果测试失败，请先看后面的常见问题。


![image.png](https://dl.playground.lazycat.cloud/guidelines/779/f45763d5-b794-4692-a8bf-e50adaa7c9c9.png "image.png")

### 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`。


![image.png](https://dl.playground.lazycat.cloud/guidelines/779/5b25f453-383c-4fe9-a09f-7732fdfdd209.png "image.png")

## 3. 在小龙猫中安装 AgentTODO 技能

这一部分的目标是让小龙猫助手学会怎么使用 AgentTODO。

技能地址是：

```text
https://github.com/iHunterDev/agenttodo-assistant
```

### 3.1 直接让助手安装技能

打开你在小龙猫中创建好的助手，直接发送下面这段话：

```text
请帮我安装这个技能：
https://github.com/iHunterDev/agenttodo-assistant
```


![image.png](https://dl.playground.lazycat.cloud/guidelines/779/fce9c03d-f264-4ccf-9cf5-702cc8b1c900.png "image.png")

### 3.2 等待技能安装完成

安装完成后，小龙猫应该会告诉你技能已经安装成功，或者可以开始使用这个技能。

如果安装失败，请先确认：

- GitHub 地址是否复制完整。
- 小龙猫当前是否可以正常联网。


![image.png](https://dl.playground.lazycat.cloud/guidelines/779/87e8220a-1b64-4cfa-856b-56cd1d84d127.png "image.png")

## 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 页面地址即可。


![image.png](https://dl.playground.lazycat.cloud/guidelines/779/c52e3e41-92b0-43d2-9bbb-f9f094c60525.png "image.png")

## 5. 测试是否连接成功

现在用一两句话测试一下即可。

### 5.1 查看今天的任务

对助手发送：

```text
帮我看看今天要做什么。
```

如果连接成功，助手会去 AgentTODO 中读取今天的任务，然后再回复你。

如果你今天还没有任务，它可能会告诉你今天没有待办。


![image.png](https://dl.playground.lazycat.cloud/guidelines/779/903176ae-1adb-4c9b-b923-e979069140cc.png "image.png")

### 5.2 创建一个简单任务

继续测试创建任务：

```text
帮我创建一个任务：明天下午 3 点前提交周报。
```

创建完成后，你可以打开 AgentTODO 页面（去应用列表，打开 AgentTODO 这个应用，可以看到当前的任务和管理任务），看任务是否已经出现。


![image.png](https://dl.playground.lazycat.cloud/guidelines/779/f722c322-a367-467a-9a66-393f98c75c5f.png "image.png")

![image.png](https://dl.playground.lazycat.cloud/guidelines/779/28cf1dbe-5bfa-4204-a5f4-6b1f426d1075.png "image.png")

## 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. 助手可以创建任务、拆分子任务、记录进展。

完成以后，你就可以把小龙猫当成自己的任务助理来用了。