Skill 调 MCP · 页面只读 · 数据在本机

一个入口
装下所有工作台

每个工作台都是一套只读页面 + 一组 MCP 工具:Skill 听懂人话,MCP 把话变成动作,页面只负责看。数据不落服务器,图片只是路过。

不用登录 · 页面只读 · 服务没起也能先看缓存

listdeck / 项目工作台
千千工作台的清单台界面:子类导航、四项统计、明细表与备注
任务进度 图片与附件 备注
ai 场景 · scenarios

一句话,agent 自己去调工具

页面只是看板,动作全在 MCP 里。你说要做什么,agent 自己挑工具、填参数、把数据落回去。

改完一条,说一声就归档

「表头对齐那条改完了」——agent 调 issue.update,把状态、归属、备注一次写进去。页面上没有勾选框,也没有「确定要提交吗」的弹窗。

  • 状态与归属一次写清,不会只改一半
  • 同一条问题只归一个子类,写完不会被别处覆盖
  • 同一句指令重试,也只落库一次
agent → MCP200
你把「页面相关」里“表格表头对齐”那条标成已完成
issue.update{ projectId: "p_ui", issueId: "…", status: "done" }
{ ok: true, data: { id: "…", changed: 2 } }

按源码逐条核,结论写进备注

「按 xyxgame-web 的源码重核一遍」——agent 读文件、对字段,再用 group.update 把结论写进子类备注。备注在页面上默认展开,点一下能折叠。

  • 备注跟着子类走,不散落在每一条里
  • 上限 400 字,写空串就是清空
  • 页面只负责展示,改备注同样只有 MCP 一条路
agent → MCP200
你按源码把「页面相关」重新核一遍,结论写进备注
group.update{ projectId: "p_ui", groupId: "g_ui", note: "…" }
{ ok: true, data: { id: "g_ui", name: "页面相关" } }

截图丢给 agent,挂到那一条上

agent 先调 image.presign 换一次性上传地址,图进私有桶;页面读完就落到本机,桶里 30–45 分钟清扫一轮,签名地址只活 900 秒。

  • 桶是私有读,没有签名谁也拿不到
  • 页面缓存的是图本身,桶清了还能看
  • 上传、删除都由 agent 做,页面不碰写
agent → OSS200
你把这张截图挂到「表头对齐」那条下面
image.presign{ projectId: "p_ui", issueId: "…", filename: "shot.png" }
→ uploadUrl · expire 900s,PUT 200 后 GET 302 到签名地址

说明页也跟着工具走

agent 调 guide.update,把「怎么用」整段写进快照顶层;说明页只渲染,没有编辑入口。工具清单跟着返回走,写进去几条就报几条。

  • 整段替换:sections 与 tools 一次写完,不留旧段
  • updatedAt 由服务端落章,不采信调用方传的时间
  • 同一个 requestId 重试,不会写两遍
agent → MCP200
你把刚才这些工具的说明更新到「使用说明」页
guide.update{ sections: [ … ], tools: [ … ] }
{ ok: true, data: { updatedAt: "2026-11-17 16:46", sections: 3, tools: 15 } }

手机打开同一页,只读

同一个地址在手机上打开,看到的是同一份快照的只读视图。服务端不存业务数据;连不上,就退回本机最后一份缓存。

  • 内容没变就 304,不重复下载
  • 服务没起也能看最后一次镜像
  • 多设备只读,不做云同步,省得两边互相踩
手机 → 快照接口304
你在手机上打开清单台,看看进度
GET /api/listdeck/snapshotIf-None-Match: "3f1c…"
304 Not Modified · 直接用本地缓存,不重渲染

接入口:POST /mcp,任意 MCP 客户端都能接;页面侧只读,不需要登录,也不存 token。

workbenches

现在有一个,以后会更多

每接一个新工作台,这里就多一张卡。共用同一个只读壳、同一条写入口,不用另起一套。

清单台

ListDeck

任务进度与问题记录。按项目、子类看完成比例,明细里能看到图片、附件与备注。

任务进度 · 只读 可用 进入

下一个工作台

slot

新的 Skill + MCP 工作台接进来,这里就多一张卡。接口、离线策略、图片中转都复用现成的。

接入方式:MCP tools + 快照接口 待接入
for agents

为 agent 写的工作台

这里默认用户是 agent:工具好不好调,比界面好不好看更要紧。

01

工具名就是说明书

project.create、group.update、issue.update——看见名字就知道改哪一层,agent 不用先读一遍文档再猜。

02

参数有 schema

每个入参都用 zod 定义。缺字段、类型不对会明确报错,而不是悄悄写坏一份数据,让 agent 后面越改越乱。

03

重试只写一次

写工具都带 requestId,同一个 ID 重试直接回放上次结果。网络抖一下、agent 重发一次,也不会写出两条一样的记录。

04

一条只归一处

一个问题只属于一个子类。模型再啰嗦,也不会把同一件事写进两个分组,进度加起来才不等于两倍。

05

页面永远只读

没有表单、没有写接口、没有权限按钮。人和 agent 不会同时改同一份数据,也就不需要「谁覆盖谁」的合并逻辑。

06

改完就能看见

快照带 ETag:内容变了页面才重渲染,没变就 304。桌面和手机都不会白刷一遍,agent 也不用等缓存过期。

faq

几个常问的

千千工作台是什么、数据在哪、为什么页面不能编辑,一次说清。

千千工作台是什么?

一个入口,把多个工作台收在一处。每个工作台都是同一套路子:一套只读页面,加一组 MCP 工具。现在接的是清单台(ListDeck),用来记任务进度和问题;以后每接一个,这里就多一张卡。

数据存在哪里?

业务数据只在你自己的电脑上:由本地 agent 持有的数据文件,与浏览器里的 IndexedDB 镜像。服务器只发页面、转发请求,不存业务数据。

为什么页面上不能新建、编辑?

写入统一走 MCP,页面不提供任何写接口和表单。只有一条写路径,才不会出现「页面改了一半、agent 又改了一遍」这种谁也不服谁的状态。

图片会留在云端吗?

不会。图片由 agent 上传到私有 OSS 桶,页面读完就落到本机 IndexedDB;桶里最多停留 30–45 分钟,到点自动清扫,签名链接本身也是短时的。

换一台电脑能看到吗?

能,但只读。页面是多设备的,数据源还是同一份;不做云同步,一个桶只干一件事,省得两边的写入互相踩。

以后怎么加一个工作台?

新建一个页面目录、一个 MCP 服务,在首页加一张卡就行。只读壳、离线缓存、图片中转都复用现成的,不用另起一套。

数据一直在你自己电脑上

服务器只发页面、只转发请求,不存业务数据;OSS 只给图片做短命中转。真正的唯一副本,是本机那份文件和浏览器缓存。

从清单台开始