What makes ShareOne HTML & Document Share Links notable?

2.4K downloads. Trust evidence available

How should ShareOne HTML & Document Share Links be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

ShareOne HTML & Document Share Links

Host HTML pages and share PDF/Word/PPT

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

2.4k

Updated

Oct 9, 2026

Version

1.6.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 2.4K downloads reported by the source. Last updated 10/9/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 9, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 9, 2026
Adoption signal: 2.4K downloadsadoption · observed Oct 9, 2026
Latest release: 1.6.0release · observed Oct 9, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s1738e1h5cmvnpnk4hnwhy9aa588xxxz:shareone

Install using `clawhub skill install s1738e1h5cmvnpnk4hnwhy9aa588xxxz:shareone` in an isolated environment before connecting it to live workloads.
No published capability contract is available yet, so validate auth and request/response behavior manually.
Review the upstream CLAWHUB listing at https://clawhub.ai/beep879/shareone before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-beep879-shareone/snapshot"

Documentation

CLAWHUB

160,000 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: shareone
description: Host HTML/Markdown pages and share PDF, Word, or PowerPoint docs as ShareOne short links. Use for publishing, passwords/watermarks, comments, downloads, updates, or Git-backed remote sources for ShareOne content.
license: MIT
metadata:
  slug: shareone
  display-name: ShareOne
  version: 1.6.0
  summary: Host HTML pages and share PDF/Word/PPT docs with short links
  tags:
    - shareone
    - publish
    - sharing
    - hosting
    - html
    - upload
---

# AI Agent 技能：发布到 ShareOne (shareone)

Host HTML/Markdown pages and share PDF, Word, and PowerPoint documents with ShareOne public short links. Covers page publishing, document sharing, password protection, watermarks, review comments, downloads, and updates to existing shares.

这个 Skill 允许 AI Agent 将当前生成的历史会话以及 HTML/Markdown/TXT/PDF/PPT 等文件发布到 ShareOne 线上托管服务，并为用户生成一个持久化的公网分享链接；也可以对已有 ShareOne 链接执行下载、内容更新、设置修改和评论处理。

## 内容版本管理决策

ShareOne 复用 **GitHub / GitLab 的内容版本管理**：历史、diff、分支、评审和回退在源仓库完成，ShareOne 负责展示、分享、访问控制和评论协作。`remote_url` 的 snapshot 是当前缓存，ShareOne 不维护独立的文件版本库。

涉及 ShareOne 内容的 Git 源、版本选择、历史或回退时，先读 [workflows/git-backed-versions.md](workflows/git-backed-versions.md)，再按下方路由执行发布、刷新或评论处理。该工作流包含跟随分支、固定 commit、切换版本与验收命令。**当前可直接使用公开 GitHub 文本文件；GitLab 和私有仓库认证仍需接入，不能把产品方向当作已支持能力。** 普通本地文件上传仍按原流程执行，不自行迁移到 Git。

## 脚本执行基准

本文档中所有 `node scripts/xxx.js` 命令的路径都以 **本 skill 的安装目录**（即本 `SKILL.md` 所在目录）为基准。当前工作目录通常是用户的项目目录，直接执行相对路径会失败。执行前先确定 skill 目录，使用绝对路径或先 `cd` 到 skill 目录，例如：

```bash
node /path/to/shareone-skill/scripts/ensure_credentials.js
```

## 入口隔离规则

本 skill 和用户本机可能安装的 `shareone` CLI 是两个独立入口。除非用户明确要求”使用 CLI”或指定执行 `shareone ...` 命令，否则不要调用系统 PATH 中的 `shareone` 命令。即使 `which shareone` 能找到 CLI，也不要把自然语言的发布、下载、评论处理任务改走 CLI。所有 ShareOne 操作都必须调用本 skill 目录内 `scripts/` 下的脚本。

## 使用说明与触发条件

当用户表达出以下意图时，应主动使用此技能：

- "帮我把 `index.html` 发布到 ShareOne"
- "把我刚才生成的网页发布，给我个链接"
- "生成一个可分享的链接给我的团队看"
- "Upload this presentation to ShareOne and protect it with password 'secret'"
- "发布这个 PDF 到 ShareOne，并加上密码 1234"
- "把这个网页发布到 ShareOne，加上水印 '内部绝密'"
- "把这个网页发布到 ShareOne，链接叫 product-demo"
- "发布这份设计稿并开启协同评论模式"
- "用 shareone 分享上一轮对话"
- "把我刚才写的代码/大段文字分享出去"
- "Share your last response as a note"
- "帮我下载这个 ShareOne 链接的文件：https://s.shareone.vip/s/xxx"
- "拉取一下这个链接的评论：https://s.shareone.vip/s/xxx"
- "删掉/删除这个 ShareOne 链接：https://s.shareone.vip/s/xxx"
- "我 push 了，刷新一下这个 ShareOne 远程链接的内容：https://s.shareone.vip/s/xxx"
- "给这个 ShareOne 链接加水印：https://s.shareone.vip/s/xxx"
- "根据这个链接的评论修改页面：https://s.shareone.vip/s/xxx"
- "修改这个 ShareOne 链接的内容：https://s.shareone.vip/s/xxx"
- "把这个 GitHub 文件发布到 ShareOne：https://github.com/org/repo/blob/main/report.html"
- "用远程 URL 发布这个页面"
- "Publish this GitHub raw URL to ShareOne"

## 路由判定顺序（唯一路由依据）

入口文件只负责判断用户意图、选择需要阅读的 workflow。不要一次性读取所有 `workflows/*.md`；只读取当前任务命中的子文件。

持续监听评论、接收持久通知或唤醒 scode / 其他 Agent：先读 `workflows/environment-and-credentials.md`，再读 `workflows/agent-notifications.md`，使用 `scripts/agent_watch.js`。普通评论查看和单次处理按以下路由执行，不启动常驻监听。

按以下顺序从上到下判断，**命中第一条即停止**，按该条给

README.md

# ShareOne Skill：AI Agent 发布与文档分享工具

<p align="center">
  <strong>把 AI 生成的网页、Markdown、PDF、Word 和 PowerPoint 文档发布为 ShareOne 短链接。</strong>
</p>

<p align="center">
  <a href="https://shareone.vip"><img alt="Website" src="https://img.shields.io/badge/website-shareone.vip-0f766e"></a>
  <img alt="ShareOne" src="https://img.shields.io/badge/ShareOne-skill-2563eb">
  <img alt="License" src="https://img.shields.io/badge/license-MIT-64748b">
</p>

官网：https://shareone.vip



本仓库包含 ShareOne Agent Skill。它让 Codex、Claude Code、OpenAI Agent、Dify、工作流自动化工具等 AI Agent 可以把本地生成的内容快速发布到 ShareOne，并生成可访问、可转发、可更新的公网分享链接。

ShareOne 适合用于发布 AI 生成页面、分享 Markdown 在线文档、托管 HTML 演示页、上传 PDF/Word/PPT 文件、生成团队评审链接，以及为文档添加访问密码、水印和评论协作能力。

## 关键词

ShareOne 覆盖以下搜索场景：AI Agent 发布工具、HTML 页面托管、Markdown 在线分享、PDF 短链接分享、Word 文档分享、PPT 在线分享、文档水印、访问密码分享链接、AI 生成网页发布、Codex Skill 文档发布、Agent workflow publishing。

## ShareOne 是什么

ShareOne 是一个面向 AI Agent 和开发者的轻量级内容发布服务。它可以把 HTML、Markdown、TXT、PDF、Word、PowerPoint 等文件发布为短链接，方便用户在聊天、项目协作、客户沟通、产品演示和内容交付场景中快速分享。

通过 ShareOne Skill，AI Agent 不需要让用户手动上传文件，也不需要额外搭建静态站点。Agent 可以直接调用 Skill 脚本完成发布、更新、下载、评论读取和设置修改。

## 免费托管

ShareOne 提供免费的页面与文档托管能力，适合临时演示、项目评审、AI 生成内容分享、客户预览和团队协作。

普通分享链接会按最后活跃时间保留：只要链接持续有有效访问，就会继续保持可用；当距离最后一次有效访问超过 90 天后，链接才可能被自动清理。也就是说，链接不是从发布时间开始固定 90 天过期，而是每次有效访问都会延续它的活跃状态。

发布到 Explore 公开广场、被知识库引用，或绑定了远程 URL 的内容，不参与普通链接的无活跃自动清理。

## 能力地图

| 文件类型 | 分享链接生成 | 密码访问 | 水印 | 自定义短链接 | 评论反馈 | 更新同一链接 |
| --- | --- | --- | --- | --- | --- | --- |
| TXT | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 |
| Markdown | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 |
| HTML | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 |
| PDF | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
| Word | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |
| PowerPoint | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 |

## 核心能力

- **HTML 页面发布**：将 AI 生成的网页、报告、原型页面或数据看板发布为在线链接。
- **Markdown 在线分享**：直接发布 `.md` 或 `.txt` 内容，适合笔记、方案、会议纪要和技术文档。
- **文档文件分享**：支持 PDF、Word、PowerPoint 文件上传与分享。
- **短链接访问**：生成 ShareOne 公网短链接，便于在微信、邮件、飞书、Slack、Notion、GitHub Issue 等渠道传播。
- **访问密码**：为敏感文档或内部材料设置访问密码。
- **水印保护**：给页面或文档增加水印，降低外泄和二次传播风险。
- **原链接更新**：在保留同一个分享链接的情况下更新内容，适合反复修改的方案、演示稿和评审页面。
- **评论协作**：文本页面可开启评论，方便团队直接围绕页面内容反馈和修改。
- **文件下载控制**：支持下载公开文件，也能在权限允许时取回源内容。

## 适用场景

- AI Agent 生成一个 HTML 页面后，需要立即发布给用户预览。
- 把 Markdown 报告、技术方案、产品说明发布成可分享链接。
- 将 PDF、Word、PPT 文件分享给客户、同事或外部协作者。
- 给内部资料添加访问密码或水印。
- 把已有 ShareOne 链接内容更新为最新版本。
- 根据 ShareOne 页面评论修改内容，并重新发布到原链接。
- 把 GitHub 上的远程 HTML 或文档 URL 发布为 ShareOne 链接。

## Agent 使用方式

Agent 在识别到“发布到 ShareOne”“生成分享链接”“分享这个 PDF”“更新这个 ShareOne 链接”“拉取评论”等意图时，会读取 [SKILL.md](./SKILL.md) 中的完整工作流，并调用本 Skill 的 `scripts/` 脚本完成操作。

常见自然语言指令：

```txt
把 index.html 发布到 ShareOne，给我一个链接
把这份 PDF 上传到 ShareOne，并设置访问密码 1234
把刚才生成的 Markdown 报告分享出去
更新这个 ShareOne 链接的内容：https://s.shareone.vip/s/xxx
读取这个 ShareOne 页面上的评论并处理
给这个链接加上水印“内部资料”
```

## 链接与文档

- ShareOne 官网：https://shareone.vip
- Skill 完整说明：[SKILL.md](./SKILL.md)

_meta.json

{
  "ownerId": "kn73tjvxf6qkw5beygj5y939n988wsag",
  "slug": "shareone",
  "version": "1.6.0",
  "publishedAt": 1791560364919
}

scripts/api_contract.json

{
  "errors": {
    "BAD_REQUEST": {
      "status": 400,
      "category": "validation",
      "hint": "Correct the request using the operation's input schema.",
      "retryable": false
    },
    "AUTH_REQUIRED": {
      "status": 401,
      "category": "auth_failed",
      "hint": "Sign in or provide the existing account's X-API-Key.",
      "retryable": false
    },
    "INVALID_API_KEY": {
      "status": 401,
      "category": "auth_failed",
      "hint": "Check or update this account's API key; retain the identity that owns the share.",
      "retryable": false
    },
    "FORBIDDEN": {
      "status": 403,
      "category": "permission",
      "hint": "Use an identity authorized for this resource and operation.",
      "retryable": false
    },
    "NOT_FOUND": {
      "status": 404,
      "category": "not_found",
      "hint": "Check the resource reference and the current account's access.",
      "retryable": false
    },
    "METHOD_NOT_ALLOWED": {
      "status": 405,
      "category": "validation",
      "hint": "Use the HTTP method declared for this operation.",
      "retryable": false
    },
    "PAYLOAD_TOO_LARGE": {
      "status": 413,
      "category": "validation",
      "hint": "Reduce the request to the operation's size limit.",
      "retryable": false
    },
    "UNSUPPORTED_MEDIA_TYPE": {
      "status": 415,
      "category": "validation",
      "hint": "Use the operation's declared request content type.",
      "retryable": false
    },
    "CONFLICT": {
      "status": 409,
      "category": "conflict",
      "hint": "Read the reported precondition and correct it before retrying.",
      "retryable": false
    },
    "VALIDATION_ERROR": {
      "status": 422,
      "category": "validation",
      "hint": "Correct the fields listed in detail using the operation's input schema.",
      "retryable": false
    },
    "RATE_LIMIT_EXCEEDED": {
      "status": 429,
      "category": "rate_limited",
      "hint": "Wait for Retry-After, then retry the same operation.",
      "retryable": true
    },
    "SERVER_ERROR": {
      "status": 500,
      "category": "transient",
      "hint": "Back off. Replay writes only with a supported idempotency key or an idempotent operation.",
      "retryable": true
    },
    "PASSWORD_REQUIRED": {
      "status": 401,
      "category": "access_gate",
      "hint": "Supply the share password or its verified viewer cookie; keep the current API key.",
      "retryable": false
    },
    "PASSWORD_INVALID": {
      "status": 401,
      "category": "access_gate",
      "hint": "Correct the share password; keep the current API key.",
      "retryable": false
    },
    "EMAIL_GATE_REQUIRED": {
      "status": 401,
      "category": "access_gate",
      "hint": "Sign in as a viewer or use the owner's/collaborator's API key.",
      "retryable": false
    },
    "COMMENTS_DISABLED": {
      "status": 403,
      "category": "permission",
      "hint": "The owner must enable comments before this act

workflows/agent-notifications.md

# 持久评论通知与 Agent 唤醒

当用户要求持续监听评论、通知 scode 或其他 Agent 时使用本工作流。先完成 `environment-and-credentials.md`，使用页面 owner 的凭据。接收器不创建新账号。

## 接到现有 Agent

通用接收器运行在 Agent 所在机器，无需公网 webhook。服务端持久保存事件和每个消费者的确认位置；即使接收器离线，回来后仍会收到未确认的批次。

```bash
node scripts/agent_watch.js --consumer review-agent --share '<分享链接>' \
  --cwd '<项目目录>' --command-json '["node","receive-shareone.js"]'
```

`--command-json` 是可执行文件和参数的 JSON 数组，不经过 shell。接收命令从 stdin 读取一行 JSON：

```json
{"source":"shareone","consumer":"review-agent","events":[{"id":"事件UUID","sequence":1,"event_type":"comment.created","share_id":"稳定分享ID","comment_id":"评论UUID","parent_id":null,"actor_role":"visitor","status":"open","created_at":"UTC时间"}]}
```

接收命令必须在**处理完成或可靠写入自己的持久收件箱后**才返回退出码 0。失败返回非零；不能先启动一个易丢失的后台任务就报告成功。事件只带引用，不含评论正文、截图、API Key 或确认令牌。处理前调用评论 API 读最新线程，按 `comments-process.md` 的认领、修改、同链接更新和明确回复流程执行。分享或评论已删除时跳过失效引用。

## 恢复 scode 会话

```bash
node scripts/agent_watch.js --consumer scode-review --share '<分享链接>' \
  --cwd '<项目目录>' --scode-session '<已有会话路径>'
```

接收器启动 `scode acp`，通过 ACP 的 `session/load` 加载指定会话，再用 `session/prompt` 交付事件。只有会话返回 `end_turn` 才确认；交互权限请求会被取消并保留未确认批次。需要机器已安装并配置 scode，且该会话的权限适合任务。请使用专供监听的会话；不要同时在另一个进程操作同一会话。接收器不会增加 scode 权限。不要猜会话路径或自动选择最近一次会话。

默认使用 scode 配置；需要指定模型或认证模式时，可加 `--scode-args-json '["--auth","api-key","--model","sonnet"]'`。这里只放 scode 参数，API Key 仍保存在 scode 的凭据配置里。

## 可靠性与运行方式

- 默认消费上线后记录的全部历史事件；`--start now` 仅在首次注册时从当前位置开始。重复启动同名消费者不会清空进度。上线前已有评论仍需先用 `comment_list.js` 做一次基线检查。
- `--share` 可省略（接收该 owner 全部分享）；使用者确定范围后再开启。消费者名称和范围固定；更换范围使用新名称。
- 默认只把访客变化交给命令，避免 Agent 的回复唤醒自己；其他事件也会正常推进确认位置。`--all-actors` 明确开启全部作者事件。
- 持续长轮询，断网或命令失败后退避重试，最长间隔 60 秒。一个消费者同一时刻只有一个有效批次租约；处理时自动续租。进程崩溃后，5 分钟租约到期即可重领。
- 语义为**至少一次**。处理完成但确认前崩溃可能重复送达；以事件 `id` 去重，并检查当前评论状态，不能假定恰好一次。
- `--timeout-seconds` 默认 1800，超时终止本接收器启动的命令进程树，保留未确认事件。`--once` 只检查并处理一个批次，适合排障和验收。
- 常驻运行由机器的服务管理器监督：Linux 可用 systemd，Windows 可用任务计划程序（登录启动、失败重启、禁止重叠实例）。工作目录指向项目；命令指向安装目录内本脚本。把 API Key 放凭据文件或安全环境配置，不放命令行或任务参数。机器休眠或接收器停止时不会立即唤醒；恢复后补发。
- 启动常驻监听前确定接收项目、消费者范围和具体会话/命令。只完成脚本安装不表示已开始后台监听。

## HTTP 接口

均需 owner 鉴权，路径前缀 `/api/v1/agent-consumers`：

| 请求 | 含义 |
|---|---|
| `PUT /<name>`，`{"share_id":null,"start":"beginning"}` | 幂等注册；可传稳定 ID 或 slug |
| `GET /`（实际不带尾斜杠） | 列出自己的消费者和游标 |
| `GET /<name>` | 查看游标和租约到期时间 |
| `POST /<name>/poll`，`{"limit":50,"wait_seconds":20}` | 最多 100 条、最多等 25 秒；空批次无令牌 |
| `POST /<name>/renew`，`{"lease_token":"..."}` | 将当前租约续到 5 分钟后 |
| `POST /<name>/ack`，`{"lease_token":"..."}` | 确认整个已交付批次；重试同一确认幂等 |
| `POST /<name>/release`，`{"lease_token":"..."}` | 处理失败后释放，不推进游标 |
| `DELETE /<name>` | 删除消费者；需要重置进度时明确执行再注册 |

读取不会确认。`ack` 不接受任意目标游标，过期/被替换的令牌返回 409。每个 owner 的事件有独立递增序号；不同 Agent 使用不同消费者名。当前事件不自动过期，删除消费者不会删事件；不承诺无限保存评论正文，事件中的引用可能已失效。

## 防止重投产生重复写入

事件按至少一次投递：处理成功后才 ACK。发布新页面、上传文件或回复评论时，使用稳定的 `--idempotency-key`，例如 `<event.id>.reply`；重试必须保留同一键和同一请求内容。回复脚本返回实际 `parent_status` / `parent_agent_stance`。幂等冲突时先检查原操作与资源状态，不要换键绕过冲突后重复创建；操作返回 409 busy 时按 `Retry-After` 等待。直接上传确认重试应保留原 `share_id`。

Github ReposUpdated 6h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.