Shiju · For AI Agents
把这一页交给 AI,
它可以自己装好、自己调用。
拾句是 macOS 原生采访剪辑工具。安装包里同时带着 shiju 命令行,App 和命令行读写同一份数据——AI 既能帮你装好,也能直接读文字稿、挑句子、排片段篮、导出时间线。
一、下载与安装
安装包 1.6 MB,macOS 26.0+,Apple Silicon。为 ad-hoc 签名(未走 Apple 公证),首次打开前要清掉隔离属性,否则系统会提示「无法验证开发者」。
curl -L -o /tmp/shiju.zip https://shiju.jack-sun.com/download/shiju-1.1.zip
unzip -q -o /tmp/shiju.zip -d /Applications
xattr -dr com.apple.quarantine "/Applications/拾句.app"
open "/Applications/拾句.app"
装完先别急着识别:拾句调用豆包「录音文件识别 2.0」,需要把 API Key 写到 ~/.config/interview-cut/volc_api_key(纯文本一行),或者在 App 里「设置 → 豆包」里粘贴。没有 Key 也能安装、打开、看文字稿,只是不能开始新的识别。
二、命令行随 App 一起打包
没有单独的 CLI 安装包。可执行文件在 App 包内:
ln -sf "/Applications/拾句.app/Contents/MacOS/shiju" /usr/local/bin/shiju
shiju help
所有命令的结果是 JSON(stdout),进度是一行一个 JSON(stderr),出错时 stderr 输出 {"error": …} 并返回 1。
| 命令 | 做什么 |
|---|---|
| shiju list | 列出所有素材、是否已识别、时长、句数 |
| shiju add <文件>… | 把素材加入列表(不会自动识别) |
| shiju transcribe <素材> | 识别(已识别直接读缓存;--force 才重新花钱) |
| shiju transcript <素材> --format text|srt|json | 读文字稿,可带每句/每字时间 |
| shiju search "关键词" | 跨所有已识别素材搜句子 |
| shiju suggest "挑金句" --target 180 | AI 挑片段,只返回句子编号与理由,不改片段篮 |
| shiju basket add/remove/move/clear | 片段篮的增删与排序 |
| shiju export fcpxml|edl|mp4 | 导出时间线或成片 |
| shiju convert x.fcpxml --to resolve|finalcut | 时间线在两个剪辑软件之间转换(Sony 时间码不用重导) |
| shiju project [目录] | 看当前项目在哪 / 切换项目 |
| shiju app status|seek|play|search | 遥控正在运行的 App |
三、数据与限制
# 数据跟着项目文件夹走:第一次打开 App 时选一个目录,
# 素材列表 library.json、片段篮 basket.json、文字稿 transcripts/ 都写在那里
# 最近项目指针:~/Library/Application Support/InterviewCut/recent-project.txt
# 命令行指定项目
shiju --project /path/to/project list
IC_PROJECT=/path/to/project shiju search "关键词"
API Key:~/.config/interview-cut/volc_api_key(权限 600)
原片不会上传:只有抽取出来的音轨送去做识别。识别结果按素材内容缓存,同一个文件重复识别不再收费。识别按 0.8 元/小时计价(豆包官方口径,资源包更低)。