一句话,agent 自己去调工具
页面只是看板,动作全在 MCP 里。你说要做什么,agent 自己挑工具、填参数、把数据落回去。
改完一条,说一声就归档
「表头对齐那条改完了」——agent 调 issue.update,把状态、归属、备注一次写进去。页面上没有勾选框,也没有「确定要提交吗」的弹窗。
- 状态与归属一次写清,不会只改一半
- 同一条问题只归一个子类,写完不会被别处覆盖
- 同一句指令重试,也只落库一次
按源码逐条核,结论写进备注
「按 xyxgame-web 的源码重核一遍」——agent 读文件、对字段,再用 group.update 把结论写进子类备注。备注在页面上默认展开,点一下能折叠。
- 备注跟着子类走,不散落在每一条里
- 上限 400 字,写空串就是清空
- 页面只负责展示,改备注同样只有 MCP 一条路
截图丢给 agent,挂到那一条上
agent 先调 image.presign 换一次性上传地址,图进私有桶;页面读完就落到本机,桶里 30–45 分钟清扫一轮,签名地址只活 900 秒。
- 桶是私有读,没有签名谁也拿不到
- 页面缓存的是图本身,桶清了还能看
- 上传、删除都由 agent 做,页面不碰写
说明页也跟着工具走
agent 调 guide.update,把「怎么用」整段写进快照顶层;说明页只渲染,没有编辑入口。工具清单跟着返回走,写进去几条就报几条。
- 整段替换:sections 与 tools 一次写完,不留旧段
- updatedAt 由服务端落章,不采信调用方传的时间
- 同一个 requestId 重试,不会写两遍
手机打开同一页,只读
同一个地址在手机上打开,看到的是同一份快照的只读视图。服务端不存业务数据;连不上,就退回本机最后一份缓存。
- 内容没变就 304,不重复下载
- 服务没起也能看最后一次镜像
- 多设备只读,不做云同步,省得两边互相踩
接入口:POST /mcp,任意 MCP 客户端都能接;页面侧只读,不需要登录,也不存 token。
现在有一个,以后会更多
每接一个新工作台,这里就多一张卡。共用同一个只读壳、同一条写入口,不用另起一套。
清单台
ListDeck任务进度与问题记录。按项目、子类看完成比例,明细里能看到图片、附件与备注。
下一个工作台
slot新的 Skill + MCP 工作台接进来,这里就多一张卡。接口、离线策略、图片中转都复用现成的。
为 agent 写的工作台
这里默认用户是 agent:工具好不好调,比界面好不好看更要紧。
工具名就是说明书
project.create、group.update、issue.update——看见名字就知道改哪一层,agent 不用先读一遍文档再猜。
参数有 schema
每个入参都用 zod 定义。缺字段、类型不对会明确报错,而不是悄悄写坏一份数据,让 agent 后面越改越乱。
重试只写一次
写工具都带 requestId,同一个 ID 重试直接回放上次结果。网络抖一下、agent 重发一次,也不会写出两条一样的记录。
一条只归一处
一个问题只属于一个子类。模型再啰嗦,也不会把同一件事写进两个分组,进度加起来才不等于两倍。
页面永远只读
没有表单、没有写接口、没有权限按钮。人和 agent 不会同时改同一份数据,也就不需要「谁覆盖谁」的合并逻辑。
改完就能看见
快照带 ETag:内容变了页面才重渲染,没变就 304。桌面和手机都不会白刷一遍,agent 也不用等缓存过期。
几个常问的
千千工作台是什么、数据在哪、为什么页面不能编辑,一次说清。
千千工作台是什么?
一个入口,把多个工作台收在一处。每个工作台都是同一套路子:一套只读页面,加一组 MCP 工具。现在接的是清单台(ListDeck),用来记任务进度和问题;以后每接一个,这里就多一张卡。
数据存在哪里?
业务数据只在你自己的电脑上:由本地 agent 持有的数据文件,与浏览器里的 IndexedDB 镜像。服务器只发页面、转发请求,不存业务数据。
为什么页面上不能新建、编辑?
写入统一走 MCP,页面不提供任何写接口和表单。只有一条写路径,才不会出现「页面改了一半、agent 又改了一遍」这种谁也不服谁的状态。
图片会留在云端吗?
不会。图片由 agent 上传到私有 OSS 桶,页面读完就落到本机 IndexedDB;桶里最多停留 30–45 分钟,到点自动清扫,签名链接本身也是短时的。
换一台电脑能看到吗?
能,但只读。页面是多设备的,数据源还是同一份;不做云同步,一个桶只干一件事,省得两边的写入互相踩。
以后怎么加一个工作台?
新建一个页面目录、一个 MCP 服务,在首页加一张卡就行。只读壳、离线缓存、图片中转都复用现成的,不用另起一套。