来源：notes/projects/feishu_base_sync/01_个人助理多维表格同步方案.md

个人助理多维表格同步方案

1. lark-cli 能力验证

当前可用能力

lark-cli 当前没有 bitable 命令，相关能力在 base 命令下：

  • base +base-create：创建 Base 资源
  • base +table-create：创建数据表
  • base +field-create：创建字段
  • base +record-upsert：创建/更新记录
  • base +record-list / +record-search：读取记录

另一个可用入口是：

  • wiki +node-create --obj-type bitable：创建多维表格 Wiki 节点

实测结果

已用 company_analyze profile 测试：

  • 直接 base +base-create 失败，缺少权限：base:app:create
  • 通过 wiki +node-create --obj-type bitable 创建多维表格节点成功
  • 对该 bitable 继续执行 base +table-list 失败，缺少权限：base:table:read
  • 创建表 base +table-create 失败，缺少权限：base:table:create

测试创建的临时多维表格：

  • 标题：Codex Personal Assistant Test Bitable 20260604
  • Wiki URL：https://my.feishu.cn/wiki/UF9iw1JixiPgzjkgS2scak6cnxe
  • Base/Object Token：LhPJbBJZBansjXshH0DcZEWbn5p

结论：当前 lark-cli 支持创建多维表格，但当前飞书应用权限不完整。现在只能创建 bitable 容器，不能创建表、字段或写记录。

用户授权后复测结果

2026-06-04 通过 lark-cli auth login --domain base,wiki,docs,drive,markdown 由用户完成授权后，默认 profile 已具备 Base 用户权限。

已成功验证：

  • 创建 Base：Codex Personal Assistant Auth Test 20260604
  • Base URL：https://my.feishu.cn/base/IYkUbQQcGa2B8gsYLYncVp6sndb
  • Base Token：IYkUbQQcGa2B8gsYLYncVp6sndb
  • 创建表：待办事项
  • Table ID：tblTpZg5MFIk12GK
  • 创建字段：标题、状态、优先级、来源文件、更新时间
  • 写入测试记录：验证个人助理多维表格写入
  • Record ID：recvlxnxCxkZmZ

更新后的结论：使用用户授权后的默认 profile，可以完成 Base 创建、表创建、字段创建和记录写入。后续正式同步个人助理数据应优先使用该用户授权 profile，而不是 company_analyze bot profile。

2. 需要补充的飞书权限

至少需要申请：

  • base:app:create：直接创建 Base 资源，可选；如果继续用 wiki 创建 bitable，可以不作为第一优先级。
  • base:table:read：读取数据表。
  • base:table:create：创建数据表。
  • base:field:read：读取字段。
  • base:field:create：创建字段。
  • base:record:read：读取记录，用于去重和同步。
  • base:record:create：新增记录。
  • base:record:update：更新记录。

如果要删除、归档或重建：

  • base:table:delete
  • base:record:delete

3. 当前个人助理目录可入表内容

当前目录：/home/admin/code/cc-connect-work-space/codex_personal_assistant

3.1 待办事项

来源文件：

  • tasks/todo.md
  • tasks/in_progress.md
  • tasks/done.md

当前内容基本为空，但结构适合入表。

建议表：待办事项

字段：

  • 标题：文本，任务标题。
  • 状态：单选，Todo / In Progress / Done。
  • 优先级：单选，High / Medium / Low。
  • 截止时间：日期时间，可空。
  • 下一步动作：长文本。
  • 来源文件：文本，如 tasks/todo.md。
  • 本地路径：文本。
  • 创建时间：日期时间。
  • 更新时间：日期时间。
  • 备注：长文本。

3.2 每日记录

来源文件：

  • logs/daily_log.md

当前已有：

  • 2026-06-03 返程通勤、家务记录。
  • 2026-06-04 早晨打车通勤记录。

建议表：每日记录

字段：

  • 日期：日期。
  • 时间：文本或日期时间。
  • 类型：单选，通勤 / 家务 / 工作 / 阅读 / 生活 / 复盘。
  • 标题：文本。
  • 详情：长文本。
  • 耗时分钟：数字。
  • 地点/节点：文本。
  • 交通方式：单选，打车 / 地铁 / 步行 / 公交 / 自驾 / 其他。
  • 来源文件：文本。
  • 本地路径：文本。

3.3 阅读书籍

来源目录：

  • notes/books/为什么精英都是时间控/

当前书籍 Markdown：

  • 01_内容全梳理.md
  • 01_内容全梳理_基于EPUB新版.md
  • 02_方法卡片.md

建议表：阅读书籍

字段：

  • 书名：文本。
  • 作者：文本。
  • 状态：单选，待读 / 阅读中 / 已读 / 复盘中。
  • 主题：多选，例如 时间管理、精力管理、个人成长。
  • 开始日期：日期。
  • 完成日期：日期。
  • 一句话总结：文本。
  • 本地目录：文本。
  • 飞书文档链接：URL 或文本，指向书籍总文档或索引文档。
  • 最后同步时间：日期时间。

3.4 阅读笔记 / 文档资产

来源：

  • notes/books/**/*.md
  • notes/knowledge_base.md
  • 未来的 notes/projects/**/*.md、notes/topics/**/*.md

建议表：文档资产

字段：

  • 标题：文本。
  • 类型：单选，书籍内容梳理 / 方法卡片 / 落地计划 / 复盘 / 项目笔记 / 主题笔记。
  • 所属主题：文本，如 为什么精英都是时间控。
  • 本地路径：文本。
  • 飞书文档链接：URL 或文本。
  • 摘要：长文本。
  • 标签：多选。
  • 最后修改时间：日期时间。
  • 最后同步时间：日期时间。

3.5 知识库索引

来源文件：

  • notes/knowledge_base.md

建议表：知识索引

字段：

  • 标题：文本。
  • 分类：单选，People / Projects / Preferences / References / Reading Notes。
  • 路径：文本。
  • 摘要：长文本。
  • 关联文档链接：URL 或文本。
  • 更新时间：日期时间。

4. 书籍 Markdown 上传到飞书并回填链接

推荐流程：

  1. 扫描 notes/books/<书名>/*.md。
  2. 每个 Markdown 上传为飞书文档。
  3. 上传时必须设置 FEISHU_SKIP_BITABLE=1，避免上传脚本自动写入旧多维表格。
  4. 拿到飞书文档链接。
  5. 在 文档资产 表写一条记录。
  6. 在 阅读书籍 表写或更新该书记录，保存书籍目录、总链接和同步状态。

推荐使用已有脚本：

FEISHU_SKIP_BITABLE=1 python /home/admin/code/cc-connect-work-space/ashare_monitor/company_analyze/invest_community/tools/feishu/create_doc_from_md.py <markdown_file>

注意：这个脚本当前依赖 company_analyze/invest_community/.env 的飞书配置。为了个人助理长期使用，建议迁移出一个独立的个人助理飞书配置，避免继续复用研报项目的表格配置。

5. 推荐正式多维表格结构

建议新建一个 Base：Codex Personal Assistant

包含 5 张表：

  • 待办事项
  • 每日记录
  • 阅读书籍
  • 文档资产
  • 知识索引

第一阶段优先同步：

  1. 每日记录：已有真实数据，结构稳定。
  2. 阅读书籍：已有一本书和 3 份 Markdown，可以验证“上传文档 -> 回填链接”。
  3. 文档资产：用于承载所有 Markdown 文档链接。

第二阶段再同步：

  1. 待办事项：当前内容为空，等后续任务体系稳定后再自动同步。
  2. 知识索引：可从 knowledge_base.md 解析，但建议先统一索引格式。

6. 下一步动作

  1. 在飞书开放平台给 company_analyze 应用补充 Base 权限，至少包含 table/field/record read/create/update。
  2. 权限生效后，用 wiki +node-create --obj-type bitable 正式创建 Codex Personal Assistant Base。
  3. 创建 5 张表和字段。
  4. 写一个同步脚本：scripts/sync_to_feishu_base.py。
  5. 先同步 logs/daily_log.md 和 notes/books/为什么精英都是时间控/*.md。