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-publishIs 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 前,必须先与用户确认以下两点:
- 内容不含机密信息(客户名称、估值、条款、个人信息、未公开数据等敏感内容)——带图页面同样要覆盖图片,截图比正文更容易夹带敏感信息(聊天记录、后台界面、真实数据);
- 用户明确同意公开该文件。
未确认就上传属于违规操作。用户只是说"传一下/发出去"不算确认,要把公开后果讲清楚并得到明确答复。若用户对内容是否含敏感信息犹豫,先帮用户检查内容再让其决定。带图页面确认时一并说明:将发布 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,不能作为相对引用外链。
上传前必做的检查(不可跳过)
-
用
hash命令算出每张图应使用的名字:bun run scripts/publish_cli.ts hash <附件目录> # chart1.png (48 KB) → chart1.a1b2c3d4e5f6.png -
按输出重命名本地图片文件;
-
把 HTML 里对这些图片的引用同步改写为新名字;
-
跑
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)。执行前向用户复述:
- 要删除的确切文件名;
- 后果:该 URL 将永久失效,之前发给别人的链接全部打不开;带图页面连页面里的图片一并删除,其中页面立即失效,图片最长 4 小时内仍可能从 CDN 缓存被取到(不要对用户说"图片链接已立刻失效");
用户明确确认后才执行 delete。用户想"换个内容重发"时应引导其用同名 upload 覆盖(URL 不断),而不是删除。
错误解读:
404:文件不存在,或不是你上传的文件——告知用户这两种可能,不要猜测是哪种。
注意事项
- 开放 API 限流:
/api-open/*各端点共用每 key 60 次/分钟的限流预算。 - 传错敏感内容时:删除(
delete,需用户确认)会让页面 URL 立即失效,但图片最长 4 小时内仍可能从 CDN 缓存取到,且内容可能已被他人保存——务必如实告知用户这个窗口,并强调下次上传前先做公开确认。
How can the creator link this skill?
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>