# 一间草堂使用手册

本手册依据当前已上线能力编写，只说明你现在可以使用的功能与操作边界。

一间草堂帮你把项目、知识和接下来要做的事留在一起。你可以自己在网页操作，也可以接入自己的AI，让它在你确认后帮你记录和整理。

## 三步开始

1. **进入工作台**：按当前注册／登录页提示完成验证，进入自己的账号。
2. **接入自己的AI**：打开“Agent管理→连接”，按说明把接入指令交给AI，再在网页核对并批准。
3. **先记一件事**：告诉AI你正在做什么，或在网页新建一个项目、知识卡或待办。

不必一次用完全部功能。先记录一个正在推进的项目，下一次回来接着做。

## 一、开始使用

### 我想让自己的AI接入

**怎么做**：进入“Agent管理→连接”，选择适合的接入方式。让AI用自己的名字接入；收到批准请求后，核对当前账号、环境、名字和权限，再作决定。

**看到什么**：网页批准和AI实际领取连接是两个阶段。回到原AI对话，确认它已完成接入、使用的是你的账号和预期环境。

你明确说“看看草堂里的某个项目”等查看请求时，AI会按你的任务和允许的范围读取，不再重复问“要不要读”。如果你还没要求读取，或范围不清，它才会先说明要看什么、内容会交给当前这个AI服务处理，再征求一次同意。同一AI、账号和范围内的有效读取同意会沿用；换AI时分别核对自己的连接和读取范围，不借用其他AI的连接或同意。

保存前先看具体拟稿，按你确认的内容和去处保存；相同内容、去处和范围的有效确认会沿用，改变后再确认。你可以在Agent管理里查看权限，或吊销不再使用的连接。

**入口**：接入说明／Agent管理。

### 我想知道先用哪项功能

- 有一个持续推进的目标：先建**项目**。
- 想留下以后还能用的经验、方法或资料：存成**知识卡**。
- 想记住下一件要做的事：记成**待办**。

你可以直接说：“我正在准备一份报价，帮我看看应该记到哪里，先给我看草稿。”

## 二、项目与知识

### 我想记录项目做到了哪里

**怎么做**：进入项目详情，记录这次发生的进展；整体判断变化时改认知摘要，进入新阶段时改阶段。也可以让AI先整理，再由你确认保存。

**看到什么**：进展保留时间顺序；认知摘要表达当前判断；阶段说明项目走到哪一步。它们各有用途，不需要把同一段话重复存几份。

例子：“这次报价已经发出，还在等客户回复。帮我记成这个项目的进展，先让我确认。”

### 我想留下一个有用的方法

**怎么做**：在知识中心新增卡片，写清它的用途、要点和来源；需要时关联到项目。点开卡片可查看全文、编辑、补充来源和管理关联。

**看到什么**：知识留在同一张卡上，项目可以引用它。网址和PDF放在来源区；保存了链接或文件，不代表AI已经读过全文。

例子：“这套页码核对方法以后还会用，帮我整理成知识卡，先给我看内容。”

### 长势有什么用

播种、生根、发芽、开花、结果，用来区分“刚存下来”“理解了”“实际用过”“复盘过”和“能反复套用”。按真实使用情况更新，不因为保存次数多就自动升级。

**入口**：项目中心／知识中心。

## 三、开工、推进与收工

### 我想接着上次的工作做

**怎么做**：在已接入的AI对话里说“看看草堂里的某个项目”，或者“帮我看看草堂”。AI按你本次任务和允许的范围查看所需记录、下一步和待办，再继续处理。你已经指定项目时，先看这个项目，不要求先读一遍全局概况。

不需要固定口令。普通查看、接着工作和开始处理任务都不会自动记录开始时间；想另外留下开始时间时，再明确让它记录。

**看到什么**：知道上次做到哪、还有什么没完成。AI看不到的内容应说明缺口，不凭空补全。

### 我想让不同AI遵循相同规矩

**怎么做**：进入“Agent管理→我的规矩”，由你添加和保存。AI可以提出建议，但不会替你直接修改这一栏。

**看到什么**：AI按你允许的范围查看草堂、接着处理任务时，可以参考这些规矩；某个项目临时的安排仍放在该项目记录中。

### 我想收工时整理一下

**怎么做**：对AI说“收工，整理今天做了什么和下一步，先给我看”。确认后再分别保存项目进展、知识或待办。

**看到什么**：已经发生的事和将来要做的事分开，没做完的不会写成已完成。方法本身可以存知识，不能因此推断今天已经实际用过。

**入口**：项目详情／日历／时间线。

## 四、待办、日历与时间线

### 我想一次记几件事

**怎么做**：告诉AI各件事项，或逐条在待办页新建。AI先拆成独立条目供你核对，每条可以有自己的日期和项目。

**看到什么**：完成一件划掉一件，不会把三个不同任务塞成一个无法分别处理的大任务。

例子：“记三件待办：核对报价、联系供方、发给客户。先分别列给我看，日期还没决定。”

### 待办和日历为什么都能看到

有日期的待办会出现在日历对应日期；没有日期的留在待办清单。它们是同一件事，不需要为了显示日历再创建一份。

日历帮助你按日期看安排与记录；待办页便于筛选和处理任务；时间线便于回看已经发生的变化。

### 我完成了，或者不想做了

**怎么做**：完成就标记完成；不再做就取消。完成后，在撤销提示仍显示时可以撤销。

**看到什么**：历史记录仍可查看。当前取消不能直接撤销；更长撤销、取消恢复和待办归档仍属于后续方案。

**入口**：待办／日历／时间线。

## 五、保存结果与帮助

### 我怎么知道真的保存了

| 提示 | 该怎么理解 |
| --- | --- |
| 已保存／已完成 | 可到对应项目、卡片或待办查看，必要时刷新核对 |
| 等你确认 | 这笔操作还需要你在草稿或待确认里处理 |
| 结果未确认 | 先查这一次操作的结果，不要马上重复保存 |

AI说“已经保存”时，应能说明保存到哪里和实际结果。找不到时，先核账号、环境、筛选、草稿和待确认状态。

### 我想恢复归档内容

项目和知识可到“归档管理”查看并恢复。待办取消历史与项目／知识归档是不同机制；不能用同一说明混着操作。

### 存储空间在哪里看

工作台和账号设置会显示真实已用、总额与剩余空间。当前个人额度为500MB；文件中心和收费扩容仍是后续方案，不代表已开放购买。

### AI卡住了，或者我不知道下一步

先让它说明当前卡在哪一步：安装、等待批准、连接领取、读取，还是保存结果未确认。让它按当前接入名字核对，并阅读这份手册，不需要你自己理解一串代码。

常见问题、详细安装命令和参数放在“技术参考”中按需展开；普通使用先看任务步骤即可。

**入口**：草稿／待确认／归档管理／账号设置／接入说明。

## 六、接入后的 AI 使用指引（7 项）

这里说的是接入后怎么和 AI 配合，不是七个数据开关。按你正在做的事看，也可以把例句直接发给 AI。

1. **接入与开始使用**：核对账号与权限，接入后直接说任务。例句：“看看我的项目，帮我梳理下一步。”
2. **接手已有工作**：围绕已经明确的任务接续上下文。例句：“接着「古建资料整理」项目，看看下一步。”
3. **查找已有记录**：按主题、项目或时间找记录。例句：“找找我上周记过的屋顶修缮资料。”
4. **推进项目与记录进展**：梳理项目阶段，按需整理进展。例句：“把今天确认的方案整理成这周进展。”
5. **保存与整理知识**：整理知识、来源与自己的理解。例句：“把这份资料整理成一条私有知识。”
6. **待办与日程**：把下一步安排为事项和日程。例句：“把这个项目的下一步拆成待办。”
7. **整理记录与当天总结**：按需要归纳今天做过的事。例句：“整理我今天的记录，看看有哪些待办。”

接入后第一次可以只给一句简短介绍和例子；已经接过或换个 AI 接手时，不必重播教程，直接说要看哪个项目或做哪件事即可。只读连接不会邀请保存，未获准读取的项目也不会假装能看。网页上的权限，决定 AI 能做哪些动作；这份说明只帮助你说清任务。

**入口**：接入说明。

## 技术参考（默认折叠）

此部分供需要排错的人和AI阅读，不属于新人第一屏。安装指令复用当前接入说明；具体命令与字段以已装CLI帮助或实际MCP工具为准，不维护另一套容易过期的参数表。

AI需要核对操作规则时，可查看当前入口是否提供CLI的 `guide` 或MCP的 `get_agent_operations`。这两个入口使用同源公共说明；读取说明不访问你的项目、待办或其他私人内容，也不代表已经取得读取或保存同意。具体是否可用，以当前版本帮助和工具目录为准。安装了技能或目录里看到了名字，不代表当前AI已经取得说明正文。

阅读手册不自动授予读取私人内容、保存、公开或改配置的权限。示例只用于表达需求；AI仍按当前账号权限、本人意图和实际回执处理。

本手册网页与同源原文均读取本站点同一份使用手册文件，内容保持一致。