Shiju · For AI Agents

把这一页交给 AI,
它可以自己装好、自己调用。

拾句是 macOS 原生采访剪辑工具。安装包里同时带着 shiju 命令行,App 和命令行读写同一份数据——AI 既能帮你装好,也能直接读文字稿、挑句子、排片段篮、导出时间线。

复制完整说明 一段 Markdown,包含下载地址、安装命令、命令行清单与注意事项

一、下载与安装

安装包 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 180AI 挑片段,只返回句子编号与理由,不改片段篮
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 元/小时计价(豆包官方口径,资源包更低)。

← 回到拾句首页 使用教程 llms.txt