跳到主要内容

会话

一次持续话题由 Session 保管:消息、工具记录、澄清、Role、模型及分支状态都保存在所选 Profile。关网页或终端不会删除它。会话记录位于 state.db 和引用对象,长期个人记忆另存于 memory/USER.md、memory/MEMORY.md。

先找到要继续的对话​

Dashboard 的 Chats 是普通对话,Background 是定时、委派或常驻后台工作;旧记录按页加载。TUI 输入 /sessions,或直接:

anyy --resume SESSION_ID

查不到先核对 Profile/Home,Session ID 不会跨 Profile 搜索。新话题用 Dashboard New session 或 TUI /new。需要指定身份时,在新建入口使用 anyy --role writer_zh;恢复已有会话不能再带 --role,它保留原有身份。

待处理消息​

当前回复没结束时,仍可追加信息,但先决定它该何时生效。

入口加入方式
Dashboard Send进入输入框上方 follow-up 队列
TUI Enter加入 steering,供下一个检查点读取
TUI Alt+Enter加入 follow-up,等当前回复结束

两队列独立属于同一会话;steering 不会取消正在运行的工具。Dashboard 中对排队项点提前执行,才会把它移去 steering。编辑只改该条,未移除附件会保留,取消编辑不改原项;删除只撤下该等待项。已被助理选取的消息不能再通过队列编辑;并发冲突时会刷新,保留未发送草稿。

TUI 队列先显示 steering,再显示 follow-up。Alt+Up 把全部等待输入与附件返还编辑器,不终止工作:文字按空行分隔,放到已有草稿之前,得到 Gateway 确认后才清除成员关系。修改后再发是一条新输入。

根据目的选择停止方式​

  • 想停住、稍后保留队列继续:Dashboard 按 Escape,TUI 忙碌时按 Ctrl+C。
  • 想先收回所有待处理内容再停:TUI 流式期间按 Esc。
  • 只想收回草稿、不停:TUI Alt+Up。
  • 只想取消助理重试 backoff:重试等待时按 TUI Esc,队列与草稿不变。

局部浮层优先使用 Escape。Dashboard 停止与 TUI 流式返稿绑定按键时捕获的工作,迟到确认不会打断后来一轮。Abort 等待收尾、保留已提交记录,不自动开始下一次调用;之后发送提示词或显式继续 Session 才恢复工作。

在脚本里继续同一会话​

anyy chat "梳理本周事项"
anyy chat --session SESSION_ID --json "再加入一个截止日期"

常驻 Gateway 必须已启动。--role 只用于新建,不能和 --session 同用。CLI 按原始 submission 等待实际调用结果,后续复用 Session 的成功回答不会替换前面的失败。JSON 返回各层 ID、outcome 和记录的回答。

遇到澄清请去 Dashboard/TUI 作答;澄清暂停、失败、中断、清除输入或等待超时均非零退出。超时/取消等待不撤回已接纳工作,重发前先查看历史,详见 CLI。

模型和工具分别由谁决定​

Profile 的模型默认值用于新会话,Dashboard 模型选择器与 TUI /provider、/model、/effort 修改当前会话。分支导航会恢复适用选择;原虚拟模型已不再注册时,可以回退到最近物理回复的模型。

Role 提供 Soul 身份说明,不选择工具名称或 Codemode 模式。Session 工具可通过 CLI 参数或 session.tools.configure 更新;显式更新要求空闲、没有排队/接纳工作和摘要操作。Profile 的模式见工具集。

长历史怎样继续​

默认暂时性模型错误在首请求后最多重试三次,从两秒指数等待到一分钟上限;这项 Profile 共享设置与 provider 传输重试分开。摘要操作保留自身重试预算,后续模型调用读取最新传输默认值,关闭重试也不关闭 HTTP 超时。

上下文压缩会摘要较早内容,失败、取消或截断的摘要不应用,也不会自动写成个人记忆。

空闲时 TUI /tree 可导航同一会话:上/下选条目,Enter 确认,s 切换离开分支摘要,Esc 取消。选择用户消息会退到它之前,输入框为空时返还文本。先处理自己的草稿;导航不启动回复,旧分支仍保存。

连接客户端还可做什么​

RPC行为与限制
session.queue.peek/.list检查待处理输入
session.queue.clear清除队列成员关系并返回输入,不删除原始正文
session.queue.steer/.update/.cancel修改尚未选取的单项
session.queue.modes独立设置 steering/follow_up 为 all 或 one-at-a-time
session.reload空闲时重读当前 Profile 资源,保留历史、store、已加载工具与待处理输入
session.fork保存选定路径的独立对话后,停止并等待原会话预先捕获的工作收尾
session.delete无非终态工作时删除对话,保留仍被其他分叉引用的历史
session.goal读写目标文本及 active/paused 元数据

all 与 one-at-a-time 决定一次选取全部还是一条,不改变队列类型。资源重载按顺序进行,后段失败不保证前段全部回滚;不会自动停止工作或开新一轮。

Fork 保留所选路径的历史与标签,可从用户消息前取出文字供修改,不自动重发,也不复制运行任务、待处理队列或渠道发送权限。但它会影响原会话:先捕获当前工作,新会话持久保存成功后,再停止并等待这份工作收尾;迟到的停止不会打断后来一轮。若收尾报错,新会话仍已保存,不能把错误当作分叉已回滚。

删除遇到非终态工作会返回 conflict,需要先处理这些工作;它不会代替你停止工作后再删除。

Goal 的 set/status/pause/resume/clear 只管理元数据,不启动/停止执行或自主循环,与任务记录分开。

这些 API 不等于界面按钮。Dashboard/TUI/shell 没有 fork、单会话删除、goal 或资源 reload 操作;没有 /queue 命令。TUI /tree 已提供同会话导航。

如果历史“消失”,优先检查 Profile 与分类;如果 /sessions//tree 被拒绝,先等当前工作结束。持久数据保护请用 Profile 备份。