skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
q.hikecapital.com91 installs

hike-publish

山行资本文件发布 CLI:把本地 HTML 网页(含页面里的图片)变成互联网可公开访问的 URL(h.hikecapital.com)——目标是公开链接,不是聊天附件。只要用户意图是把 .html 发布/上线/挂网/传上去/发出去、要"一个能点开的链接"、"发我一份 URL"、或要把网页链接转给 LP/投资人,都使用本 skill 上传到 h.hikecapital.com。也覆盖三类管理操作:① 文件改好后重新上传覆盖更新("链接不能变""重新传一下",同名覆盖则 URL 不变、已发出的链接不断);② 列出/查询自己发布过哪些文件;③ 删除已发布文件。即使内容可公开性尚未确认也照常调用——公开前确认由本 skill 正文流程承接。边界:把文件当附件发到飞书群/个人用 lark-drive;只生成或修改 HTML、没要公开链接的不用本 skill(但生成完 HTML 后要公开发布的,发布这步回到本 skill)。

How do I install this agent skill?

npx skills add https://q.hikecapital.com --skill hike-publish
view source ↗

Is this agent skill safe to install?

No partner audit is available yet. Read the source before installing.

What does this agent skill do?

HIKE Publish(文件发布)

把单个 HTML 文件上传到公司文件发布服务,获得互联网公开访问 URL(https://h.hikecapital.com/...)。带图片的页面用 --assets 一并发布图片附件(见「图片附件」)。与 hike-lightyear / hike-seek 共用同一套认证(同一份 ~/.hike/config.json)。

publish_cli

CLI 脚本: scripts/publish_cli.ts(相对本 skill 目录)

⚠️ 路径与工作目录(agent 必读):本文所有示例命令中的 scripts/publish_cli.ts 均为相对本 skill 目录(即本 SKILL.md 所在目录)的路径。执行前先确认当前工作目录是否为本 skill 目录;若不是,把示例中的 scripts/publish_cli.ts 替换为绝对路径 <本 skill 目录>/scripts/publish_cli.ts 再执行——否则会报 error: Module not found "scripts/publish_cli.ts"。npx skills add 安装到项目 .agents/skills/hike-publish 的场景同理,用安装位置的绝对路径。

前置依赖: 本 skill 的 CLI 脚本依赖 bun 运行时。首次使用前确认已安装:

bun --version

未安装时执行(或提示用户执行):

curl -fsSL https://bun.sh/install | bash

安装后可能需要重开终端让 PATH 生效。若运行命令时报 bun: command not found,即未安装 bun。

配置文件位置:

  • 默认:~/.hike/config.json(用户 home 目录下)
  • 若设置了环境变量 HIKE_CLI_CONFIG_DIR,则使用 $HIKE_CLI_CONFIG_DIR/config.json(优先级更高)

API Key 管理

# 通过浏览器授权配置 key(推荐: 网页上点一次授权即可,key 全程不经过对话/剪贴板)
# ⚠️ 会等待网页授权最长 5 分钟: agent 执行时应后台运行或延长命令超时,完成后用 whoami 确认
bun run scripts/publish_cli.ts login

# 设置 API key(交互式输入,保存为 0600 权限;login 不可用时的兜底)
bun run scripts/publish_cli.ts set-key

# 查看当前 key(脱敏显示)
bun run scripts/publish_cli.ts show-key

# 验证 key / 查看身份(请求成功即 key 有效)
bun run scripts/publish_cli.ts whoami

API key 从 https://seek.hikecapital.com/ 获取。

⚠️ API key 安全规则(硬性要求):严禁引导用户把 API key 发送到对话/聊天中——会话记录可能留存 key 造成泄露。配置或更换 key 首选 login(浏览器授权,agent 也执行不了 key 输入);login 不可用时引导用户本地输入:

  • Claude Code 会话内:让用户输入 ! <本 skill 目录>/scripts/publish_cli.ts set-key(! 前缀在用户本地终端交互执行,输入的 key 不经过模型);
  • 普通终端:bun run scripts/publish_cli.ts set-key。

若用户已在对话中发送过 key:提醒该 key 应视为已泄露,建议到 https://seek.hikecapital.com/ 重置后再按上述方式配置,勿继续使用。

上传前确认(⚠️ 硬性要求,不可跳过)

上传成功后文件即互联网公开——任何拿到 URL 的人都能访问(域名已设置不被搜索引擎收录,但 URL 本身无访问控制)。执行 upload 前,必须先与用户确认以下两点:

  1. 内容不含机密信息(客户名称、估值、条款、个人信息、未公开数据等敏感内容)——带图页面同样要覆盖图片,截图比正文更容易夹带敏感信息(聊天记录、后台界面、真实数据);
  2. 用户明确同意公开该文件。

未确认就上传属于违规操作。用户只是说"传一下/发出去"不算确认,要把公开后果讲清楚并得到明确答复。若用户对内容是否含敏感信息犹豫,先帮用户检查内容再让其决定。带图页面确认时一并说明:将发布 xxx.html 及 N 张图片(共 X MB)。

上传命令

bun run scripts/publish_cli.ts upload <文件路径> [--name <对象名>] [--assets]

文件要求(不满足时 CLI 会拒绝,应直接告知用户、不要尝试绕过或转换):

  • 仅支持单个 HTML 文件(扩展名必须是 .html;.htm 必须先改名),其他类型一律不支持;
  • 大小不超过 1 MB;
  • 页面里的图片走 --assets 单独发布(见「图片附件」),当前不支持其他类型。

覆盖(同名更新):修正已发布内容时,用同名文件再传一次即可原地覆盖(限本人上传的文件)——URL 不变、无缓存延迟,已分发的链接刷新即见新内容;文件尚未分发过时正常起名上传即可,不需要复用旧名。

命名规则:

最终 URL 的构成是固定的三段:

https://h.hikecapital.com/{部门前缀}/{对象名}
例: https://h.hikecapital.com/investment/example-ipo-one-pager.html

图片附件(带图页面): https://h.hikecapital.com/{部门前缀}/{对象名去掉 .html}_files/{图片名}
例: https://h.hikecapital.com/investment/example-ipo-one-pager_files/chart1.a1b2c3d4e5f6.png
  • 域名固定为 h.hikecapital.com;
  • 部门前缀由服务器按当前用户所属部门自动派生(如 IR Team → ir/),上传时自动带上,用户不能指定、CLI 也不接受目录成分;
  • 对象名就是用户上传的文件名,它直接出现在公开 URL 里;带图页面时附件目录名由对象名派生,所以本地 HTML 文件名应当就是最终的对象名(若用 --name 改名,附件目录与 HTML 内的引用都要按新对象名来);
  • 若原文件名含中文、空格或特殊字符,先向用户提议一个 URL 友好的英文名(kebab-case、有互联网语义,如 被投企业周报-9月.html → portfolio-weekly-sep.html),用 --name 传入;名字仅允许字母/数字/. _ -;
  • 提议的名字顺带在"上传前确认"环节一并让用户过目即可,不必单独再问一轮。

输出解读(务必向用户如实转述):

  • 输出含 "overwritten": true → 本次覆盖了此前上传的同名文件,已发出的旧 URL 现在指向新内容;要明确告诉用户"刚才的文件覆盖了之前的文件";
  • 输出含 "overwritten": false → 全新上传,返回的 url 就是公开访问地址,原样告知用户;
  • 带 --assets 时以开头的 📌 行判断:已存在且属于你 → 是覆盖更新(同样要告知用户"覆盖了之前的文件");已预定 → 全新发布。不要用 "overwritten": true 判断带图发布是否覆盖——那可能只是在覆盖本次自己写入的占位页;
  • 无论哪种情况,都把最终的公开 URL 完整展示给用户;带图发布再说明新增/跳过了多少张图片。

常见错误:

  • 409:同名文件已存在,但是别人(同部门其他用户)传的——只能覆盖自己上传的文件。换一个文件名重试,或让原上传者本人操作;
  • 404:父页面不存在或不属于你(带图发布时父 HTML 必须先占位成功);
  • 413:超过 1 MB 上限(HTML 与单张图片都是这个上限,客户端与服务器都会拦);
  • 415:内容不是 HTML / 不是 png/jpg/webp(客户端会预检魔数,勿改名伪装);
  • 400:图片名不含内容哈希,或哈希与内容不符;
  • 422:用户的部门未配置上传目录,提示其联系管理员;
  • 401:key 失效,CLI 会提示重新输入。

图片附件(带图页面)

页面里的图片不能 base64 内联(会撑爆 1 MB 上限),要放在 HTML 同目录下的附件目录里,用 --assets 一并发布。

目录与命名约定(硬性)

  • 附件目录:{HTML 对象名去掉 .html}_files/,与 HTML 文件同级。例:report.html 对应 report_files/;
  • HTML 内的引用:必须是相对路径 {附件目录}/{图片名}(写成 ./report_files/x.png 等价)。绝对地址(https://…、data:、#)不由本服务管辖,CLI 不检查;
  • 图片名必须带内容哈希:{原名}.{sha256 前 12 位}.{png|jpg|webp},例 chart1.a1b2c3d4e5f6.png。哈希让图片"内容一变名字就变",因此更新后绝不会读到旧图;图片走 4 小时缓存(不是永久缓存),所以删除后图片最长 4 小时内仍可能从 CDN 缓存取到(页面本身是立即失效的);
  • 格式:只支持 png / jpg / webp;.jpeg 必须归一化为 .jpg(大写扩展名同理);
  • 单图 ≤ 1 MB,张数不限;
  • 附件目录内不允许子目录;CSS/JS 必须内联进 HTML,不能作为相对引用外链。

上传前必做的检查(不可跳过)

  1. 用 hash 命令算出每张图应使用的名字:

    bun run scripts/publish_cli.ts hash <附件目录>
    # chart1.png  (48 KB)  →  chart1.a1b2c3d4e5f6.png
    
  2. 按输出重命名本地图片文件;

  3. 把 HTML 里对这些图片的引用同步改写为新名字;

  4. 跑 check 复查,必须通过:

    bun run scripts/publish_cli.ts check <HTML 路径>
    

check 会逐项列出问题(引用没带哈希、扩展名不对、哈希与内容不符、引用了附件目录之外的文件、被引用但本地缺失、附件目录里有子目录……)并给出"应改成什么"。报的错要在本地改掉,不要试图绕过——upload 会执行同一套校验并直接拒绝。

发布带图页面

bun run scripts/publish_cli.ts upload <HTML 路径> --assets

执行顺序是先占位、再传图、最后传正式 HTML:先用占位页占住名字(避免与他人撞名,也保证图片只会落进自己的目录),再逐张传图(内容未变的自动跳过),最后覆盖成正式页面——所以页面上线时图片一定是齐的。

  • 带图页面必须加 --assets;HTML 引用了附件目录却没加,CLI 会直接报错拒绝上传(防止发出破图页面);
  • 图片按 60 次/分钟限流逐张上传,触发限流会自动等待重试;中途失败不会上传正式页面,占位页留在原地,重跑即可(内容寻址使重跑幂等);
  • 图片内容改了名字就会变(这正是缓存不会脏的原因),旧图成为不再被引用的残留文件——无害,删除页面时会随附件目录一并清掉。

查询已发布列表

bun run scripts/publish_cli.ts list                     # 默认前 20 条
bun run scripts/publish_cli.ts list --limit 50 --offset 50
  • 只返回自己上传过的文件(按当前用户部门前缀过滤);--limit 默认 20、上限 100,更多结果用 --offset 翻页;

  • 只列 HTML 页面;带图页面的图片单独查:

    bun run scripts/publish_cli.ts assets <文件名>     # 列出该页面下的图片附件
    
  • files[].url 为公开访问地址;updated_at 晚于 uploaded_at 说明该文件被覆盖更新过——覆盖/删除后可用 list 核对状态;

  • 适用场景:用户问"我发布过哪些文件";以及覆盖/删除前先 list 核对文件名是否存在、是否本人上传——避免盲试撞 409/404。

删除命令

bun run scripts/publish_cli.ts delete <文件名>
  • 只传文件名(如 report.html),不含目录前缀——目录由服务器按当前用户部门派生,接口层面指不到别人的目录;
  • 只能删除自己上传的文件;文件不存在或非本人上传统一返回 404(不区分,避免探测他人文件);
  • 会级联删除该页面的全部图片附件(服务器按附件目录前缀清空),执行后会回报删除了多少张图片。

⚠️ 删除前必须与用户确认(硬性要求,不可跳过)。删除不可恢复,且已分发的公开 URL 会立即失效(对方访问变 404)。执行前向用户复述:

  1. 要删除的确切文件名;
  2. 后果:该 URL 将永久失效,之前发给别人的链接全部打不开;带图页面连页面里的图片一并删除,其中页面立即失效,图片最长 4 小时内仍可能从 CDN 缓存被取到(不要对用户说"图片链接已立刻失效");

用户明确确认后才执行 delete。用户想"换个内容重发"时应引导其用同名 upload 覆盖(URL 不断),而不是删除。

错误解读:

  • 404:文件不存在,或不是你上传的文件——告知用户这两种可能,不要猜测是哪种。

注意事项

  • 开放 API 限流:/api-open/* 各端点共用每 key 60 次/分钟的限流预算。
  • 传错敏感内容时:删除(delete,需用户确认)会让页面 URL 立即失效,但图片最长 4 小时内仍可能从 CDN 缓存取到,且内容可能已被他人保存——务必如实告知用户这个窗口,并强调下次上传前先做公开确认。

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/q.hikecapital.com/hike-publish">View hike-publish on skillZs</a>