本色 · 老板 IP 工作台

用日常工作素材持续准备真人口播内容。一个轻量 npm 包，同时提供本地网页和 boss-ip CLI；桌面智能体通过四个 Skills 读取资料、整理选题和写回结果。

Node.js 22+，运行时无 npm 依赖。网页仅监听 127.0.0.1。飞书模式依赖已安装并完成用户授权的 lark-cli，本包不会读取或保存飞书访问令牌。

安装与启动

从 npm 安装（需要该版本已发布到所用 registry）：

npm install -g @1agents/boss-ip
boss-ip init --mode demo
boss-ip skills install
boss-ip serve --open

也可以在源码目录打包安装：

npm pack
npm install -g ./1agents-boss-ip-0.1.0.tgz
boss-ip init --mode demo
boss-ip skills install
boss-ip serve --open

打开 http://127.0.0.1:4318。在 Codex / WorkBuddy 的浏览器预览中也可以打开这个地址。聊天由桌面产品提供，工作台不再内置另一套模型或聊天服务。

默认工作区为 ~/.1agents/boss-ip。使用 --home <目录> 或 BOSS_IP_HOME 选择独立工作区。网页里复制的任务指令会包含当前工作区，避免智能体把结果写到另一份数据中。

飞书个人账号

boss-ip auth status
boss-ip auth login
# 用户在返回链接完成授权后：
boss-ip auth complete --device-code <本次授权返回的代码>
boss-ip init --mode feishu --sample
boss-ip serve --open

init --mode feishu 创建工作台文件夹、五张关联表、老板档案。--sample 另外加入明确标记为虚构的演示访谈、内容原子和选题。没有此参数时不写演示记录。飞书模式始终使用用户身份，不会自动切换为机器人身份。

已有本地演示空间可切换为飞书模式，但本地演示记录不会自动迁入；云端样例由 --sample 明确创建。正式资料建议另建工作区。只有远端完整读取成功后才更新缓存；连接失败不会降级为“模拟成功”。

已使用个人账号完成云端初始化、关联记录写入回读、修改意见及稿件版本留存联调，并在本地网页验证。验证版本为 lark-cli 1.0.65 的 Base v3 +shortcut 接口；其他版本需验证响应结构。演示记录为虚构样例，发布记录和效果观察保持为空。

工作流

1. 在网页添加访谈转写，或者运行 boss-ip ingest --title 访谈 --file transcript.txt --type 访谈。首版接受文字与原文件链接；音视频上传、ASR 使用已有工具。
2. 在素材页面发起“整理素材”，复制任务指令到桌面智能体。
3. 智能体读取原文，提取内容原子，策划选题，结果通过 CLI 写回。
4. 在内容计划中确认选题，再让智能体撰写口播稿。
5. 网页审核稿件；修改意见写入内容记录，新稿以新文档版本保存。确认只对当前稿件版本生效。
6. 使用现成提词、拍摄及剪辑工具制作视频。工作台记录制作阶段。
7. 通过 CLI 登记发布记录及效果观察，让智能体写复盘文档。首版不自动发布或抓取社交平台数据。

网页中的“交给智能体”创建待处理任务并生成指令，不会自行启动 Codex / WorkBuddy，也不暗示模型已在后台执行。四个 Skills 可安装至指定目录：boss-ip skills install --to <技能目录>，已有同名目录保持不变。

数据与 CLI

| 数据类型 | 云端归属 | | --- | --- | | 老板档案、转写、口播稿、复盘正文 | 飞书云文档 | | 音频、视频、图片 | 飞书云盘等已选文件存储，本包保存引用 | | materials / atoms / contents / publications / metrics | 五张关联多维表格 | | 连接配置、最近成功读取的缓存、待执行任务、恢复日志 | 当前本地工作区 |

表格关联使用实际飞书 record ID，CLI 使用稳定业务 ID。完整字段约定运行 boss-ip schema 查看。业务查询默认读缓存，--sync 或 boss-ip sync 读取云端。首版面向单机操盘、少量客户 Demo；未提供多人同时写入的分布式锁。

boss-ip status
boss-ip list contents --sync
boss-ip get contents content-demo-01
boss-ip put atoms --file atom.json
boss-ip script content-demo-01 --file script.txt --revision 1
boss-ip review content-demo-01 --decision approve --revision 2
boss-ip jobs list
boss-ip jobs get <任务ID>
boss-ip jobs complete <任务ID> --file outputs.json

put 以 id 去重，输入是业务字段对象，不是飞书底层字段名。更新口播稿必须使用 script，审核使用 review，避免覆盖旧稿或绕过版本校验。history 保存历次稿件链接与当时的审核意见。

发布记录示例（真实发布后填入真实链接）：

{
  "id": "pub-001",
  "title": "第一条内容",
  "contentIds": ["content-demo-01"],
  "platform": "视频号",
  "account": "演示账号",
  "date": "2026-09-23 20:00:00",
  "url": "",
  "sample": true
}

指标输入包括 publicationIds、date、views、likes、inquiries、leads、source。不同观察时间使用不同 ID。复盘只取每次发布的最新快照，不累加历史快照；跨平台合计不代表去重客户。

失败恢复与边界

跨飞书文档和表格的操作不是事务。创建类操作先记本地执行日志；发生超时或中断时保留 pending，不盲目重新创建。核对云端已创建的对象后，用 boss-ip recover --key <操作键> --file <实际返回结果JSON> 关联回来，再继续。未确认的结果不能伪造为成功。

HTTP 写接口检查来源与会话令牌；无通用 shell 执行接口。包内不含个人数据、账号配置、授权链接、原会话归档或本地执行日志。

开发验证

npm run check
npm test
npm pack --dry-run

9 项测试覆盖：重复导入、并发持久化、稿件历史、过期审核、来源引用、任务结果回填、HTTP 来源校验、不确定创建恢复、授权输出解析、Base v3 数据解析及写入回读比较。云端已验证素材、内容原子、内容记录和文档版本流程；发布记录及效果指标尚未进行真实业务数据验证。