{"_id":"@bluerangala/feishu-lawtools","_rev":"2-ae187d4e7cebf3d2ee35e285aabc4d8e","name":"@bluerangala/feishu-lawtools","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@bluerangala/feishu-lawtools","version":"1.0.0","keywords":["pi-package","pi-skill","feishu","lark","法律","law"],"author":{"name":"BluerAngala"},"license":"MIT","_id":"@bluerangala/feishu-lawtools@1.0.0","maintainers":[{"name":"bluer-angala","email":"2128484413@qq.com"}],"homepage":"https://github.com/BluerAngala/feishu-lawtools#readme","bugs":{"url":"https://github.com/BluerAngala/feishu-lawtools/issues"},"pi":{"skills":["./SKILL.md"]},"dist":{"shasum":"b9f5598db693a4bc7c4f2f80c09ee8ca2a4e09d6","tarball":"https://registry.npmjs.org/@bluerangala/feishu-lawtools/-/feishu-lawtools-1.0.0.tgz","fileCount":3,"integrity":"sha512-YfP2sQYYjlGxDF8Ublrgy1wLKzLtkxt47rhozoOlfsaCgxc1/nwjhnOLf1oElkaq9fc+/lCxIWEW3E/h6+ZQnQ==","signatures":[{"sig":"MEYCIQCROtS/i3AwqdAATCx8bt1lN/BoAjNgfxs+VmU23FauIAIhANWjVN2Msmpyo7AbAY+JPQOiFwYcLG9tKqDeARBZES6S","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":30188},"gitHead":"68a2a17ba3b07daf9f58633e8e3829f21c17a582","_npmUser":{"name":"bluer-angala","email":"2128484413@qq.com"},"repository":{"url":"git+https://github.com/BluerAngala/feishu-lawtools.git","type":"git"},"_npmVersion":"11.12.1","description":"飞书法律工具箱 — 导入法律法规、AI划重点、AI批注解读（基于lark-cli）","directories":{},"_nodeVersion":"26.0.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/feishu-lawtools_1.0.0_1781257546507_0.43065084698771905","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@bluerangala/feishu-lawtools","version":"1.0.1","description":"飞书法律工具箱 — 导入法律法规、AI划重点、AI批注解读（基于lark-cli）","keywords":["pi-package","pi-skill","feishu","lark","法律","law"],"author":{"name":"BluerAngala"},"license":"MIT","publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/BluerAngala/feishu-lawtools.git"},"bugs":{"url":"https://github.com/BluerAngala/feishu-lawtools/issues"},"homepage":"https://github.com/BluerAngala/feishu-lawtools#readme","pi":{"skills":["./SKILL.md"]},"gitHead":"12978351cdf709c59a88321be62a59137213109f","_id":"@bluerangala/feishu-lawtools@1.0.1","_nodeVersion":"26.0.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-F2cPqPbzkFveVTDGZVsW4u8vcBw8OTM3B/W90KZfPMO1HgZkLc3V15hgR89031ffQ2NEX8HyjW8PweytNBiULQ==","shasum":"bbf390bf976a70cf977a4133b94187967630c458","tarball":"https://registry.npmjs.org/@bluerangala/feishu-lawtools/-/feishu-lawtools-1.0.1.tgz","fileCount":3,"unpackedSize":30200,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCEmdTZ/uivdu0rwLz6Q30KHuzs2JwvKrrLpZA2WXOpMAIhAODzo9j6BYA6E+ue2xrF+D++ZMOsb6cWTgoRqpNVtSpZ"}]},"_npmUser":{"name":"bluer-angala","email":"2128484413@qq.com"},"directories":{},"maintainers":[{"name":"bluer-angala","email":"2128484413@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/feishu-lawtools_1.0.1_1781257625668_0.3806501101740236"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-12T09:45:46.392Z","modified":"2026-06-12T09:47:05.923Z","1.0.0":"2026-06-12T09:45:46.639Z","1.0.1":"2026-06-12T09:47:05.792Z"},"bugs":{"url":"https://github.com/BluerAngala/feishu-lawtools/issues"},"author":{"name":"BluerAngala"},"license":"MIT","homepage":"https://github.com/BluerAngala/feishu-lawtools#readme","keywords":["pi-package","pi-skill","feishu","lark","法律","law"],"repository":{"type":"git","url":"git+https://github.com/BluerAngala/feishu-lawtools.git"},"description":"飞书法律工具箱 — 导入法律法规、AI划重点、AI批注解读（基于lark-cli）","maintainers":[{"name":"bluer-angala","email":"2128484413@qq.com"}],"readme":"# feishu-lawtools 🧑‍⚖️\n\n飞书法律工具箱 — 基于 **飞书（Lark）OpenAPI** 和 **lark-cli** 的命令集，由 AI agent 驱动，实现法律条文的导入、划重点、批注解读全流程。\n\n<p align=\"center\">\n  <strong>pi</strong> · <strong>Claude Code</strong> · <strong>Codex</strong> · <strong>Opencode</strong>\n  <br>\n  <span>兼容所有主流 AI coding agent</span>\n</p>\n\n---\n\n## 目录\n\n- [兼容性矩阵](#兼容性矩阵)\n- [安装](#安装)\n- [依赖与前提](#依赖与前提)\n- [快速开始](#快速开始)\n- [命令详解](#命令详解)\n  - [/law-import — 导入法律条文](#lawimport--导入法律条文)\n  - [/law-highlight — 划重点](#lawhighlight--划重点)\n  - [/law-annotate — AI 批注解读](#lawannotate--ai-批注解读)\n- [用户手动操作](#用户手动操作)\n- [完整工作流示例](#完整工作流示例)\n- [技术架构](#技术架构)\n- [开发指南](#开发指南)\n- [常见问题](#常见问题)\n\n---\n\n## 兼容性矩阵\n\n| Agent | 安装方式 | 触发方式 | 状态 |\n|-------|----------|----------|------|\n| **pi** | `pi install` | `/law-import` 等 skill command | ✅ 原生支持 |\n| **Claude Code** | git clone → `~/.claude/skills/` | 直接描述需求给 AI | ✅ 适配 |\n| **Codex** | git clone → `~/.codex/skills/` | 直接描述需求给 AI | ✅ 适配 |\n| **Opencode** | git clone → `~/.codex/skills/` | 直接描述需求给 AI | ✅ 适配 |\n\n> 本 skill 遵循 [Agent Skills 标准](https://agentskills.io/specification)，任何兼容该标准的 agent 均可使用。核心操作依赖 `lark-cli` 命令行工具，只要有 bash 执行能力的 agent 都能驱动。\n\n## 安装\n\n### pi\n\n```bash\n# 从 GitHub 安装（推荐）\npi install git:github.com/BluerAngala/feishu-lawtools\n\n# 或从 npm 安装\npi install npm:@bluerangala/feishu-lawtools\n```\n\n### Claude Code\n\n```bash\nmkdir -p ~/.claude/skills\ngit clone https://github.com/BluerAngala/feishu-lawtools ~/.claude/skills/feishu-lawtools\n```\n\n### Codex / Opencode\n\n```bash\nmkdir -p ~/.codex/skills\ngit clone https://github.com/BluerAngala/feishu-lawtools ~/.codex/skills/feishu-lawtools\n```\n\n### 手动（通用）\n\n```bash\ngit clone https://github.com/BluerAngala/feishu-lawtools.git\ncd feishu-lawtools\n# 在你的 agent 配置中指向这个目录\n```\n\n---\n\n## 依赖与前提\n\n### 必须安装\n\n| 依赖 | 用途 | 安装方式 |\n|------|------|----------|\n| [lark-cli](https://github.com/earendil-works/lark-cli) | 调用飞书 OpenAPI | `npm install -g @earendil-works/lark-cli` |\n| 飞书开发者应用 | 提供 API 凭证 | [飞书开发者后台](https://open.feishu.cn/app) 创建应用 |\n\n### 飞书权限（OAuth Scopes）\n\n| Scope | 用途 |\n|-------|------|\n| `docx:document:create` | 创建文档 |\n| `docx:document:readonly` | 读取文档内容 |\n| `docx:document:write_only` | 编辑文档内容 |\n| `drive:file:upload` | 上传资源 |\n| `drive:document.comment:create` | 添加批注评论 |\n\n### 认证\n\n所有操作使用 **用户身份**（`--as user`），首次使用需登录：\n\n```bash\n# 登录飞书用户身份\nlark-cli auth login --scope \"docx:document:create,docx:document:readonly,docx:document:write_only,drive:document.comment:create\"\n\n# 验证登录状态\nlark-cli auth status --format json\n```\n\n返回 `tokenStatus: \"valid\"` 即表示认证通过。\n\n---\n\n## 快速开始\n\n```bash\n# 1. 从 URL 导入一部法律\n/law-import https://flk.npc.gov.cn/民法典.txt\n\n# 2. 对关键术语划重点\n/law-highlight https://lawyerch.feishu.cn/docx/xxx \"犯罪\"\n\n# 3. AI 自动添加批注解读\n/law-annotate https://lawyerch.feishu.cn/docx/xxx --style 通俗\n```\n\n---\n\n## 命令详解\n\n### /law-import — 导入法律条文\n\n**功能**：从 URL 或本地文件提取法律文本，解析为「章节→条目」结构，创建飞书在线文档。\n\n#### 输入\n\n```\n/law-import <url|file_path> [--title \"自定义标题\"]\n```\n\n| 参数 | 必填 | 说明 |\n|------|------|------|\n| `url` 或 `file_path` | 是 | 法律文本来源。URL 自动抓取网页正文；本地文件直接读取 |\n| `--title` | 否 | 自定义文档标题，默认取法律文本第一行 |\n\n#### 支持的文件格式\n\n| 格式 | 说明 |\n|------|------|\n| `.txt` | 纯文本，UTF-8 编码 |\n| `.md` | Markdown，自动转换标题层级 |\n| URL | 网页链接，自动提取正文（依赖 `baoyu-url-to-markdown` 或 `defuddle`） |\n\n#### 解析规则\n\n输入文本格式示例：\n\n```\n中华人民共和国民法典\n（2020年5月28日通过）\n\n第一编 总则\n第一章 基本规定\n第一条 为了保护民事主体的合法权益……制定本法。\n第二条 民法调整平等主体的自然人……\n```\n\n解析后生成的飞书文档结构：\n\n```\n[标题] 中华人民共和国民法典\n  ├─ [h1] 第一编 总则\n  │   ├─ [h1] 第一章 基本规定\n  │   │   ├─ [p] 第一条 为了保护民事主体的合法权益……\n  │   │   └─ [p] 第二条 民法调整平等主体的自然人……\n```\n\n每条条文对应一个独立段落（`<p>`），并带有唯一的 `id` 属性（如 `id=\"article-1\"`），供后续划重点和批注定位。\n\n#### 幕后流程\n\n```\n用户输入 URL/文件\n       ↓\n ① 提取文本内容\n    └─ URL → baoyu-url-to-markdown / defuddle 提取正文\n    └─ 文件 → read 工具直接读取\n       ↓\n ② 解析结构化\n    └─ 正则匹配 \"第X编\" \"第X章\" \"第X条\"\n    └─ 每一条生成独立的 <p id=\"article-N\">\n       ↓\n ③ 构建飞书 XML\n    └─ <title>法律名称</title>\n    └─ <h1>第X章 章名</h1>\n    └─ <p id=\"article-1\">第一条 内容</p>\n       ↓\n ④ 调用飞书 API\n    └─ lark-cli docs +create --api-version v2 --content '<xml>' --as user\n       ↓\n ⑤ 返回文档 URL\n    └─ https://lawyerch.feishu.cn/docx/{document_id}\n```\n\n#### lark-cli 命令\n\n```bash\n# 创建文档\nlark-cli docs +create --api-version v2 \\\n  --content '<title>中华人民共和国民法典</title><h1>第一编 总则</h1><p id=\"article-1\">第一条 ...</p>' \\\n  --as user --format json\n```\n\n> **注意**：如果内容较长超出命令行参数限制，先创建空文档，再分批追加：\n> ```bash\n> # 创建空文档\n> lark-cli docs +create --api-version v2 --content '<title>法律名称</title>' --as user\n> \n> # 逐章追加\n> lark-cli docs +update --api-version v2 --doc <token> --command append --content '<h1>第一章</h1><p id=\"article-1\">...</p>' --as user\n> ```\n\n---\n\n### /law-highlight — 划重点\n\n**功能**：在飞书文档正文中对指定法律术语进行可视化标记，支持黄底高亮（荧光笔效果）和加粗。\n\n#### 与批注的区别\n\n| | 划重点 | 批注 |\n|:---|:-------|:-----|\n| **位置** | 直接在正文中修改文字样式 | 侧边栏评论，不占正文 |\n| **可见性** | 打开文档一目了然 | 需要点击批注图标展开 |\n| **适合场景** | 关键术语、易错点、核心概念 | 完整解读、案例分析、实务提示 |\n\n#### 输入\n\n```\n/law-highlight <doc_url> <term> [--style highlight|bold]\n```\n\n| 参数 | 必填 | 说明 |\n|------|------|------|\n| `doc_url` | 是 | 飞书文档 URL 或 token |\n| `term` | 是 | 要标记的词语或短语 |\n| `--style` | 否 | `highlight`（黄底+加粗，默认）\\| `bold`（仅加粗） |\n\n#### 完整示例\n\n```bash\n# 示例1：黄底高亮「犯罪」（默认）\n/law-highlight https://lawyerch.feishu.cn/docx/xxx \"犯罪\"\n\n# 示例2：黄底高亮「故意犯罪」\n/law-highlight https://lawyerch.feishu.cn/docx/xxx \"故意犯罪\"\n\n# 示例3：仅加粗「意思表示真实」\n/law-highlight https://lawyerch.feishu.cn/docx/xxx \"意思表示真实\" --style bold\n```\n\n#### 幕后流程（高亮模式）\n\n高亮不能通过简化的 XML `str_replace` 实现，因为飞书简化 XML 不支持 `background-color`，必须使用原生 OpenAPI 逐 block 编辑。\n\n步骤分解：\n\n```\n ① 关键词定位\n    └─ docs +fetch --scope keyword --keyword \"犯罪\" --detail with-ids\n    └─ 返回匹配的 block_id 列表\n       ↓\n ② 获取 block 完整结构\n    └─ GET /open-apis/docx/v1/documents/{doc_id}/blocks/{block_id}\n    └─ 返回 text.elements 数组，每个 element 包含 text_run.content 和 text_element_style\n       ↓\n ③ 构建更新数据\n    └─ 找到目标文本所在的 element\n    └─ 将其 text_element_style 改为 {\"bold\": true, \"background_color\": 2}\n    └─ 保留其他所有 element 不动\n       ↓\n ④ PATCH 写回\n    └─ PATCH .../blocks/{block_id} --data '{\"update_text_elements\":{\"elements\":[...]}}'\n```\n\n> ⚠️ **关键约束**：`update_text_elements` 必须提供该 block 的 **全部** text elements。只传要修改的那个会导致其他文本丢失。\n\n#### background_color 取值\n\n| 值 | 颜色 | 适用场景 |\n|:--:|:----:|----------|\n| `2` | 🟡 **黄色** | **默认**，高亮最醒目 |\n| `3` | 🟢 绿色 | 正面案例、合规要点 |\n| `4` | 🔵 蓝色 | 程序性规定 |\n| `5` | 🟠 橙色 | 警告、注意 |\n| `6` | 🔴 红色 | 禁止性规定、易错点 |\n| `7` | 🟣 紫色 | 特殊概念、定义 |\n\n#### 幕后流程（加粗模式）\n\n加粗可以直接用飞书简化 XML 的 `str_replace` 一步完成：\n\n```bash\nlark-cli docs +update --api-version v2 \\\n  --doc <token> \\\n  --command str_replace \\\n  --pattern \"意思表示真实\" \\\n  --content '<b>意思表示真实</b>' \\\n  --revision-id -1 \\\n  --as user\n```\n\n---\n\n### /law-annotate — AI 批注解读\n\n**功能**：对已导入的法律文档，AI（即当前 agent）逐条生成专业的条文解读，通过飞书评论系统添加到对应条文旁。\n\n#### 输入\n\n```\n/law-annotate <doc_url> [--scope \"article-1,article-5\"] [--style 通俗|专业|案例]\n```\n\n| 参数 | 必填 | 说明 |\n|------|------|------|\n| `doc_url` | 是 | 飞书文档 URL 或 token |\n| `--scope` | 否 | 限定批注范围，如 `article-1,article-5`。不填则全部条文 |\n| `--style` | 否 | 解读风格：`通俗`（默认，适合非法律人士）/ `专业`（法言法语，引用司法解释）/ `案例`（结合典型案例） |\n\n#### 风格对比\n\n以「民法典第143条（合同有效要件）」为例：\n\n| 风格 | 输出示例 |\n|:----:|----------|\n| **通俗** | \"本条说了合同有效的三个条件：1）双方都得是能自己做主的人；2）说的话都是真心的，没被骗；3）内容不违法、不违背公序良俗。\" |\n| **专业** | \"本条系民事法律行为生效要件之一般规定。行为能力的判断以《民法典》第18-22条为准；意思表示真实排除通谋虚伪表示（第146条）及欺诈胁迫（第148-150条）；不得违反强制性规定需区分效力性与管理性规定（《九民纪要》第30条）。\" |\n| **案例** | \"参考（2021）最高法民终XXX号：当事人以'意思表示不真实'主张合同无效，法院审查是否存在欺诈、胁迫或重大误解。实务中证明标准较高，需提供充分证据。\" |\n\n#### 幕后流程\n\n```\n ① 获取文档结构\n    └─ docs +fetch --detail with-ids\n    └─ 提取所有 <p id=\"article-N\"> 的 block_id 和文本内容\n       ↓\n ② AI 逐条生成解读\n    └─ 根据 style 参数调整输出风格\n    └─ 每条解读控制在 200-500 字\n       ↓\n ③ 添加飞书评论\n    └─ drive +add-comment --doc <token> --block-id <block_id>\n    └─ --content '[{\"type\":\"text\",\"text\":\"【AI解读】...\"}]'\n    └─ --type docx --as user\n       ↓\n ④ 频率控制\n    └─ 每条间隔 1-2 秒，避免 API 限流\n```\n\n#### lark-cli 命令\n\n```bash\n# 添加批注\nlark-cli drive +add-comment \\\n  --doc <token> \\\n  --block-id \"<p标签的block_id>\" \\\n  --content '[{\"type\":\"text\",\"text\":\"【AI解读】解读内容...\"}]' \\\n  --type docx \\\n  --as user\n```\n\n---\n\n## 用户手动操作\n\n以下操作无需 skill 支持，直接在飞书客户端完成：\n\n### 手动添加批注\n\n1. 在飞书文档中选中要批注的文本\n2. 点击右侧弹出的「批注」按钮\n3. 输入解读内容\n4. 按 Enter 发布\n\n### 跳转到指定条文\n\n在文档 URL 后添加 `#block_id`：\n\n```\nhttps://lawyerch.feishu.cn/docx/xxx#doxcn123456\n```\n\n---\n\n## 完整工作流示例\n\n### 场景：从全国人大网站导入《民法典》并批注\n\n```bash\n# ① 导入\n/law-import https://flk.npc.gov.cn/民法典.txt\n→ ✅ https://lawyerch.feishu.cn/docx/abc123\n\n# ② 划重点（关键术语）\n/law-highlight https://lawyerch.feishu.cn/docx/abc123 \"民事法律行为\"\n/law-highlight https://lawyerch.feishu.cn/docx/abc123 \"公序良俗\"\n/law-highlight https://lawyerch.feishu.cn/docx/abc123 \"强制性规定\"\n\n# ③ AI 批注\n/law-annotate https://lawyerch.feishu.cn/docx/abc123 --style 通俗\n→ ✅ 已为 1260 条条文添加批注\n\n# ④ 你在飞书里手动补充自己的批注\n```\n\n### 场景：从本地文件导入《刑法》\n\n```bash\n/law-import /Users/bluer/Downloads/刑法.txt --title \"中华人民共和国刑法\"\n→ ✅ https://lawyerch.feishu.cn/docx/def456\n```\n\n---\n\n## 技术架构\n\n### 系统依赖\n\n```\nfeishu-lawtools (SKILL.md)\n       │\n       ├── 调用 ── lark-cli ── 飞书 OpenAPI\n       │              │\n       │              ├── docs +create       文档创建\n       │              ├── docs +fetch        文档读取\n       │              ├── docs +update       文档编辑（str_replace）\n       │              ├── drive +add-comment  添加批注\n       │              ├── api GET/PATCH      原生 API 调用\n       │              └── auth login/status  认证管理\n       │\n       └── 依赖 ── pi agent 内置技能\n                    ├── baoyu-url-to-markdown  URL 正文提取\n                    ├── defuddle              URL 正文提取（备选）\n                    ├── lark-doc              飞书文档读写\n                    └── lark-drive            飞书评论管理\n```\n\n### 数据流\n\n```\n文本来源 ─→ 结构化解析 ─→ 飞书 XML ─→ OpenAPI ─→ 飞书云端文档\n  (URL/文件)     (章节+条文)      (格式化)     (lark-cli)     (在线可访问)\n```\n\n### 关键 API\n\n| 操作 | API 路径 | 方法 | 通过 lark-cli |\n|------|----------|:----:|:-------------:|\n| 创建文档 | `/open-apis/docx/v1/documents` | POST | `docs +create` |\n| 读取文档 | `/open-apis/docx/v1/documents/{id}/raw_content` | GET | `docs +fetch` |\n| 全文替换 | `/open-apis/docx/v1/documents/{id}/blocks/{id}/update` | PATCH | `docs +update --command str_replace` |\n| 逐 block 编辑 | `/open-apis/docx/v1/documents/{id}/blocks/{id}` | PATCH | `api PATCH` |\n| 添加评论 | `/open-apis/drive/v1/files/{token}/new_comments` | POST | `drive +add-comment` |\n\n---\n\n## 开发指南\n\n### 项目结构\n\n```\nfeishu-lawtools/\n├── SKILL.md       ← AI agent 技能指令（核心）\n├── README.md      ← 本文件\n└── .gitignore\n```\n\n### 如何新增一个命令\n\n假设要新增 `law-summarize`（AI 摘要）命令：\n\n**1. 在 SKILL.md 中添加命令文档**\n\n```markdown\n### /law-summarize — 条文摘要\n\n快速生成法律文档的摘要。\n\n/law-summarize <doc_url> [--max-length 500]\n\n步骤：\n1. docs +fetch 获取文档内容\n2. AI 生成摘要\n3. 返回摘要文本或追加到文档末尾\n```\n\n**2. 实现步骤（在 SKILL.md 中写清）**\n\n```markdown\n步骤：\n\n1. 获取文档全文\n   lark-cli docs +fetch --api-version v2 --doc <token> --as user\n\n2. AI 分析每条条文并生成摘要\n   （由 agent 自行完成，依据 skill 指令）\n\n3. 将摘要追加到文档末尾\n   lark-cli docs +update --api-version v2 --doc <token> --command append \\\n     --content '<callout>【摘要】...</callout>' --as user\n```\n\n**3. 测试**\n\n在 pi agent 中调用 `/law-summarize <doc_url>` 验证。\n\n### 开发原则\n\n1. **命令前缀统一**：所有命令以 `/law-` 开头，便于 AI agent 识别和路由\n2. **依赖显式声明**：在 SKILL.md 的 `metadata.requires` 中标明依赖的 CLI 工具\n3. **认证优先**：所有操作使用 `--as user`，不依赖 bot 身份\n4. **幂等操作**：划重点和批注支持重复调用，多次执行不会破坏文档\n5. **频率控制**：批量操作时每条间隔 1-2 秒\n\n### 发布流程\n\n```bash\n# 提交代码\ngit add -A\ngit commit -m \"feat: add law-summarize command\"\ngit push origin main\n```\n\n---\n\n## 常见问题\n\n### Q: 为什么不用 `str_replace` 直接加背景色？\n\n飞书简化 XML 不支持 `<span style=\"background-color:...\">`。背景色需要调用原生 OpenAPI 的 `PATCH .../blocks/{id}` 接口，在 `text_element_style` 中设置 `background_color`。\n\n### Q: 批量划重点有什么注意事项？\n\n`str_replace` 是全文替换，如果同一词语在多条条文中出现，会全部标记。如果只想标记某个特定位置的词语，用 `--scope` 限定范围或手动操作。\n\n### Q: 批注内容有长度限制吗？\n\n建议每条批注不超过 500 字。过长可能导致 API 截断或显示不佳。\n\n### Q: 能否多人协作？\n\n可以。飞书文档本身支持多人实时编辑。批注和划重点的操作会同步给所有有权限的协作者。\n\n### Q: 文档导入后还能继续编辑吗？\n\n能。导入生成的飞书文档是标准的飞书在线文档，你可以在飞书客户端直接编辑、删除、分享。\n\n---\n\n## 许可证\n\nMIT\n","readmeFilename":"README.md"}