Zlooks · Blog

通过 Finch 连接 Zlooks MCP。App View 提供从 MCP 实时同步的文章库、Markdown 编辑与预览，并从 Blog 列表工具栏进入普通 Finch 会话。

本工具仅供获得授权的 Zlooks 管理员使用。

安装

npx --yes @finchtoys/minitools add @zlooks.cn/finch

安装完成后，在 Finch 的“小程序”中找到 Zlooks Admin，启用并授予所需权限。

如果安装后设置菜单暂时不可用，请关闭 Zlooks Admin 后重新启用一次。

配置连接

打开 Zlooks Admin 的设置菜单，选择 配置连接，填写：

• MCP 地址：Zlooks 管理服务地址，例如 https://www.zlooks.cn/mcp
• Bearer Token：由 Zlooks 管理员或部署人员提供的访问凭证

生产环境应使用 HTTPS。

Bearer Token 保存在 Finch 的加密 Secrets 中，不会写入普通配置、日志或会话内容。

开始写作

连接成功后，打开 App View：

• 首页和文章库的列表均来自 MCP Tools；打开文章时再从 hile://blog/posts/{id} Resource 读取全文。
• Blog 列表页工具栏提供会话按钮，可查看本工具最近创建的普通 Chat 会话；点击“新对话”会创建并打开一个新的 Finch Chat。文章详情页不显示此按钮。后台写作会话和旧 Assistant 容器会话不会出现在这里。
• 切换到其他 Finch 小程序再返回时，会恢复当前列表页、正文草稿、发布检查字段、检查台开合状态、排版偏好以及列表/正文/检查台滚动位置。正在执行的 AI、图片上传、审核和提交不会恢复，审核结果需要重新检查。恢复快照只保存在当前小程序进程内，不写入浏览器或磁盘；重启 Finch、停用或重新加载小程序后会清空。
• 编辑区采用参考 Finch Markdown Editor 的完整 CodeMirror 实现：支持 GFM 表格、任务列表、删除线、链接、图片、常用围栏代码语言高亮、搜索、补全和实时源码渲染；编辑期间不会自动写回服务端。
• 文章详情页工具条提供与 Finch 会话选择器一致的两级模型菜单：主菜单显示“跟随应用默认”和带模型数量的提供方，悬停、点击或按右方向键后在子菜单中显示 Finch 返回的品牌图标与完整模型名称，不重复显示已经由分组表达的 provider/model id。选择项保存在当前小程序的 Finch Storage 中，并统一用于初始建议、字段优化/修复、正文修复和选区改写/续写；选择“跟随应用默认”会恢复 Finch 的默认模型决策。列表页不显示该选择器。
• 文章列表和编辑页工具栏右侧的图片图标都会打开共用的 MCP 图片库管理视图；这里仅用于查看、搜索、分页、上传和删除图片，不显示“取消 / 使用此图片”选择栏。图片删除会先显示 Finch 原生二次确认，确认后调用 Images MCP delete-image，只有服务确认删除成功后才从列表移除。
• 点击工具条的检查与保存图标后会打开“文章设置与检查”模态抽屉。所有尺寸下都显示遮罩并禁止背景编辑，关闭后再恢复正文交互。新建文章必须先选择“AI 建议”或“手动填写”，选择后才重新拉取分类和标签并进入后续流程；只有“AI 建议”会让 AI 通读全文并生成标题、slug、摘要和分类/标签候选。编辑器中的初始建议、字段优化/修复、正文修复和选区改写/续写均通过 Finch 1.6.3 的小程序自管无容器后台会话处理并等待结果，不进入普通会话列表。
• 编辑已有文章时，默认展示已保存的标题、slug、分类、摘要、标签和封面，不自动调用 AI；标签以可删除的已选项呈现。分类和已有标签均使用与模型选择器一致的主题下拉；新标签仍填写名称与 Slug，通过 Blog MCP 创建后加入文章，不使用原生下拉或勾选列表。新建文章选择“AI 建议”时，标签区从 AI 生成的标签开始；选择“手动填写”时，标签区初始为空，可以主动选择已有标签或创建新标签。点击标签旁的 AI 按钮仍可根据当前完整正文和已有标签重新生成候选。标题、slug、摘要和标签旁有独立 AI 按钮，点击后根据当前完整正文和该字段现有值优化这一项；分类手动选择。封面仅支持手工填写 HTTP(S) URL，或从共用的 Images MCP 图片库选择。
• 单字段优化期间保留原值；手动编辑会丢弃该字段的旧 AI 结果，失败后可重试。发布前运行 MCP 内容检查，再通过 Finch 原生确认框完成提交。
• 写入成功后会从 Blog 文章 Resource 回读文章并刷新列表。
• 检查结果在检查器顶部汇总阻断、建议和提示数量，字段问题就近显示，正文问题在同一检查器内渐进展开。“修复正文内容”会让 AI 根据当前完整正文和 MCP 问题修复；修复只更新正文、保留已编辑的其他字段，并要求重新检查，并发手动修改不会被旧结果覆盖。后台会话若首次返回空结果或无效 JSON，会在同一会话内自动纠正重试一次，不会放宽请求快照和正文校验。“保存文章”只创建草稿或保存修改，正式发布仍需在文章列表中单独确认。
• 发布检查的 MCP 问题按字段展示；“建议”和“提示”只供作者参考，不阻碍提交，只有“阻断”会禁止提交。再次点击对应 AI 按钮时，会结合当前全文、字段值和该字段的审核问题修复。修复后需重新检查；分类仍手动调整。缺少审核原因或 AI 原样返回时会保留问题并报错，不视为修复成功。
• 编辑页仅在正文或发布字段存在未保存修改时，对返回文章列表、新建或切换文章进行确认；未修改、撤销回原值或提交成功后直接离开。取消后保留当前内容，提交过程中禁止离开。页面卸载也按相同修改状态注册退出保护，但当前 Finch API 没有侧边栏切换前的拦截接口：点击 Finch 侧边栏离开或宿主强制销毁页面无法保证提示，需要宿主增加支持。

新建和编辑文章时封面均可留空；清空已有封面会移除封面。点击现有封面或空白占位区域会打开共用的 MCP 图片库，可以搜索、分页、上传、删除并选择图片；正文 / 菜单和已选中图片也复用同一个选择视图。删除始终需要二次确认，已引用图片的地址会失效且无法恢复。从图片库选中的封面使用 Images MCP 返回的持久 HTTP(S) URL，并在应用后要求重新运行发布检查。手工填写时也必须是可持久化且能在审核页预览的 HTTP(S) URL；地址不得含用户名或密码。URL 校验不保证长期可达，仍需人工检查预览。Finch 不提供 AI 生成封面的入口。

连接状态

• 尚未配置：需要填写 MCP 地址和 Bearer Token
• 正在连接：Finch 正在注册 Zlooks MCP 服务
• 连接正常：可以同步和管理 Blog 内容
• 已断开：连接已手动断开
• 连接失败：请检查地址、Token 和网络连通性

可以在设置菜单中选择 连接诊断，查看不包含 Token 的诊断信息。

更新

npx --yes @finchtoys/[email protected] update zlooks-admin

安全提示

• 不要向其他人发送 Bearer Token
• 不要把 Token 写入对话、截图或普通配置文件
• 写入或破坏性操作会先说明影响并等待确认
• 不再使用当前设备时，请在设置菜单中清除连接配置

使用要求

• Finch 1.6.3（2179）或更高版本
• 可以访问 Zlooks MCP 地址
• 有效的管理员 Bearer Token

草稿卡片底部右侧提供“正式发布”图标。确认后通过 Blog 文章 Resource 读取最新文章、检查正文、调用 publish-post 并通过同一 Resource 回读发布状态；阻塞问题会提示进入文章修复。该操作不生成 AI 元数据，也不要求填写封面。

详情页提交成功并回读确认后，自动返回文章列表并更新卡片，不再弹出离开确认；提交失败时保留编辑内容。