发布页
将 HTML 或 Markdown 产物发布为固定地址，并通过版本、智能推荐和自动发布持续沉淀结果。
发布页用于把 Poco Agent 生成的 HTML 或 Markdown 产物发布成稳定访问地址。它适合承载日报、周报、分析报告、展示页、操作手册和可复用方案，让一次会话里的结果可以被团队持续查看、复用或接入外部系统。
如果只是临时发给别人查看，优先使用分享。如果希望长期沉淀、持续更新或接入外部系统，优先使用发布页。
发布页和分享的区别
| 对比项 | 发布页 | 分享 |
|---|---|---|
| 使用目的 | 长期沉淀可复用内容 | 临时查看某个文件或工作区 |
| 访问地址 | 固定地址，例如 /share/p/{publish_key} | 基于某次分享生成的访问链接 |
| 生命周期 | 适合长期保留和持续维护 | 更适合一次性或短期协作 |
| 版本记录 | 支持历史版本，可回看不同发布时间的内容 | 通常只对应当次分享的文件或工作区状态 |
| 自动更新 | 可绑定定时任务自动发布新版本 | 不会自动跟随后续任务生成新版本 |
| 适合内容 | 日报、周报、报告、展示页、案例、手册 | 单个文件、完整工作区、临时交付材料 |
| 管理入口 | 发布中心、产物推荐卡片、案例库 | 产物面板里的文件分享或工作区分享 |
| 典型场景 | 每天固定更新巡检报告，并让外部系统读取同一地址 | 把本次生成的压缩包或 Markdown 发给同事确认 |
适合发布的内容
- 结构完整的业务分析报告。
- 可直接查看的 HTML 展示页或数据看板。
- 团队培训材料、操作手册和排障指南。
- 每日、每周、每月固定生成的巡检报告。
- 可作为案例沉淀的方案总结或工作模板。
不建议发布草稿、占位页面、调试文件、只有个人上下文才能看懂的内容，或包含客户信息、账号、密钥、内部链接等敏感数据的文件。
从产物生成发布页
发布页依赖任务产物。先让 Poco Agent 在工作区生成 .html 或 .md 文件，再预览确认内容可用。
示例任务：
请生成一份项目周报，并保存为 `weekly-report.html`。
要求：
1. 首屏能直接看到结论。
2. 包含风险、进展、下周计划。
3. 不要包含账号、Token、客户姓名等敏感信息。
4. 页面需要适配手机和桌面端。任务完成后，建议先在产物面板检查：
- 入口文件是否存在，例如
weekly-report.html或report.md。 - 页面或文档是否能正常预览。
- 文本、表格、图片和链接是否完整。
- 工作区导出状态是否已经 ready。
如果没有生成可发布文件，继续追问：
请把最终结果保存为 `report.html`，作为后续发布页的入口文件。智能推荐发布
智能推荐发布是从一次任务结果进入发布页的快捷路径。任务完成并导出工作区后，系统会分析 HTML 或 Markdown 产物，判断是否值得沉淀为发布页。
当系统识别到合适产物时，产物面板会出现推荐卡片。你可以：
- 预览推荐的入口文件。
- 查看推荐标题、分类和推荐原因。
- 一键发布为发布页。
- 忽略不需要沉淀的推荐。
- 对已发布内容执行撤回或重新发布。
智能推荐只负责发现和推荐有价值的产物。发布后，发布中心负责固定地址、版本记录、公开访问和后续管理。
推荐卡片通常在工作区导出完成后出现，不一定和任务完成同时出现。如果没有推荐，不代表任务没有产物，只是系统没有判断出适合沉淀的 HTML 或 Markdown 文件。
在发布中心创建发布页
也可以在发布中心手动创建发布页。创建时通常需要配置：
| 配置 | 说明 |
|---|---|
| 名称 | 发布页在列表中的展示名称 |
| 发布 Key | 固定访问地址的一部分，对应 /share/p/{publish_key} |
| 描述 | 说明发布页内容和用途 |
| 默认入口文件 | 要发布的 .html 或 .md 文件路径 |
| 分类 | 用于发布广场或案例库筛选 |
| 来源 | 选择定时任务或已有会话 |
| 入口偏好 | 自动识别、优先 HTML 或优先 Markdown |
| 允许继续探索 | 允许登录用户从发布版本开启独立对话 |
当来源是已有会话时，可以使用“识别发布文件”让系统从该会话产物中选择合适入口文件。复杂页面也可以发布，但入口文件路径要稳定。
自动发布
自动发布适合定时任务。开启后，定时任务每次生成新的 HTML 或 Markdown 产物，发布中心会基于配置识别入口文件并生成新版本。
为了让自动发布稳定运行，任务提示词里要固定入口文件名：
请每天生成一份巡检报告，并保存为 `daily-report.html`。
如果数据源不可用，也要生成该文件，并在页面中说明失败原因。
不要只在对话中输出报告正文。自动发布失败时，优先检查：
- 定时任务是否成功完成。
- 工作区导出是否 ready。
- 入口文件是否存在。
- 入口文件后缀是否为
.html或.md。 - 文件内容是否过空、损坏或不适合发布。
版本和访问
发布页使用固定地址访问，默认展示最新版本。每次重新发布都会生成一个版本记录，方便回看历史结果。
常见用法：
- 对外系统固定读取同一个发布地址。
- 团队查看最新日报或周报。
- 需要追溯时切换到历史版本。
- 开启公开到案例库后，让更多团队成员浏览复用。
如果希望打开后直接呈现纯净的 Markdown 或 HTML 内容，可以在发布中心开启无干扰模式。
从产物继续探索
管理员开启全局能力后，可以为 HTML 或 Markdown 发布页启用 允许继续探索。登录用户第一次发送消息时，系统会基于当前发布版本的产物和能力快照创建独立根会话；新会话不会复制源对话历史和账号凭据，也不会回写发布内容。
发布页按版本保存快照。从历史版本继续探索时，使用的是该版本发布时的产物和能力，不会自动切换到最新版本。
开启条件、访问者操作和完整继承规则，请阅读 分享与继续探索。
发布前检查
- 先预览入口文件，再发布。
- 确认没有客户信息、账号、密钥、内部链接等敏感内容。
- 页面类产物检查桌面端和移动端。
- 文档类产物检查标题、结论、行动项和日期范围。
- 自动发布任务要固定入口文件名，不要每次生成不同路径。
- 发布失败时先看入口文件和工作区导出状态，再排查发布中心配置。