用途:当任务涉及由 sharehtml 管理的文档时使用,包括部署或更新本地文档、分享或取消分享、将远端文档拉取到本地、比较本地改动与已部署文档、审阅未解决评论并处理反馈。
主要能力:sharehtml 可直接部署受支持的源文件,包括 .html、.md、.markdown、.json,以及 .js、.ts、.jsx、.tsx、.py、.rb、.go、.rs、.java、.c、.cpp、.css、.sh 等常见代码文件。除非用户明确要求,不要把代码或 Markdown 包裹进 HTML。二进制或不支持的文本/源格式不要直接部署。
默认行为与安全规则:文档默认保持私有,绝不主动运行 sharehtml share ...,仅当用户明确要求可分享时才执行;用户说“分享这个”即视为允许设为可分享,只说“部署”或“上传”则不允许。若部署会覆盖已有文档,先运行 sharehtml diff <file>,用平实语言概述变更并请用户确认,不得盲目确认。需要文档 id 而用户只知名称时,用 sharehtml list 查找;如有多个可能匹配,请用户选择。未经用户要求,不要粘贴原始 diff 输出。
常用命令:sharehtml deploy <file> 部署或更新;sharehtml diff <file> 比较本地与已部署内容;sharehtml pull <id> 下载远端文件;sharehtml comments <id> 读取未解决评论(--json 为机器可读输出);sharehtml list 按标题或文件名查找;sharehtml open <id> 在浏览器打开;sharehtml share <document> 设为可分享;sharehtml unshare <document> 设为私有。
典型流程:部署或更新时先确认格式受支持,运行 deploy;若提示已存在将被更新,则运行 diff、概述变更并询问是否覆盖。处理反馈时先解析文档 id 或 URL(仅名称则用 list),运行 comments <id> --json,必要时 pull <id>,本地修改后运行 diff、概述变更并等待批准,批准后再 deploy。
限制:资料未提供部署目标、认证方式、配额、收费或性能等信息。