用途:通过 agent-first 的 papermark CLI 检查 Papermark 数据室,适合数据室发现与分析类任务,而非手动浏览器点击。
主要能力:列出数据室;查看单个数据室详情;读取文件夹优先的内容树;检查访问模型(链接、组、权限组);查看分析数据(views、views-count、viewers、stats);查看已有导出任务(export-visits,只读,不创建新导出)。
使用方式:若 PATH 中缺少 papermark,可用 npm i -g papermark-cli 安装;无法全局安装时可在本地检出目录用 npm link。默认流程:先运行 papermark doctor --json 做检查;再运行 papermark datarooms list --json 列出数据室;需要时用 --team-id <id> 覆盖已保存的工作区;从列表结果取数据室 id 供后续命令使用。查看单个数据室用 papermark datarooms get <id> --json;读取内容树用 papermark datarooms folders <id> --json,可用 --limit 获取更宽泛的摘要,仅在确实需要完整嵌套树时用 --raw。访问模型用 links、groups、permission-groups 子命令;分析用 views、views-count、viewers、stats;导出任务用 export-visits。
认证:交互式登录用 papermark auth login;已有可见 Chrome 远程调试会话时用 papermark auth login --cdp-port 9333;也可通过 stdin 写入本地配置,或设置 PAPERMARK_SESSION_TOKEN 与 PAPERMARK_CURRENT_TEAM_ID 作为临时方式。若保存的团队 id 有误,在数据室命令上传 --team-id <id>,无需重新认证。
限制与注意:该适配器面向私有认证界面,并非公开文档化的管理 API。数据室内容以文件夹优先。export-visits 为只读。建议使用 --json,此时 stdout 应只含一个 JSON 对象,进度与状态输出到 stderr。退出码:0 成功,1 请求或上游失败或检查失败,2 需要认证/用户操作或输入无效。常见错误码包括 AUTH_MISSING、AUTH_INVALID、NOT_FOUND、RATE_LIMITED、UPSTREAM_5XX、TIMEOUT、VALIDATION、CHECK_FAILED。避免将完整会话令牌粘贴到日志或聊天中,数据室、分析、链接、组和访客输出应视为敏感工作区数据。