用途:通过飞书官方 lark-cli,按知识库/Wiki 与云盘/Drive 两条独立路径做只读盘点、搜索和文档分析。默认使用应用身份 bot;仅当用户明确要求个人云盘、个人知识库或私有资源时,才走用户 OAuth。默认不修改远端内容,写入、移动、删除、权限变更、发送消息和导出个人数据须单独确认。
主要能力:检查应用身份、可见空间、节点树、文档类型、文件与权限元数据;按 lark-doc 规则读取正文和大纲;用 Drive Search 或 Wiki 节点查询搜索知识库、文档和云盘;安装或修复 CLI、配置应用凭证并检查 token、身份、scope 与连通性。不打印 App Secret 或 access token。
使用方式:依赖 Node.js/npm 与官方 lark-cli,安装用 npx @larksuite/cli@latest install,按需 npx skills add larksuite/cli -g -y。安装后运行 lark-cli doctor、lark-cli profile list、lark-cli auth status --json --verify、lark-cli whoami。配置示例见 assets/config.example.yml,初始化脚本为 scripts/setup_app_credentials.py,首次可用 --use,刷新须用户明确发起并加 --replace --use。调研前先读机器可读权限目录与错误目录,按 wiki-workflow.md 或 drive-workflow.md 选身份;读取文档先用 lark-cli drive +inspect --as <bot|user> --url '<URL>' --format json 解析类型与 token。
适用场景:盘点可见知识库层级与云盘文档类型、读取或总结飞书文档、检查应用可见知识空间与文档、分析迁移需求、排查 CLI 配置与权限问题。
限制:bot 不能自动代表用户读取个人知识库、个人云盘或私有文档;不要把 Wiki 空间/节点接口当云盘目录,也不要把 bot 空搜索结果解释为个人云盘为空。不要为读取申请写、删、上传或成员管理权限;不要把 Secret 放入 shell 历史、命令行参数、日志或提交记录。遇到 confirmation_required 不要静默追加 --yes;invalid_client 或错误码 20140 属凭证认证失败而非缺 scope,先修复 profile。涉及写操作时默认 dry_run=true,须用户明确确认。
分类:办公与效率。