🔄 卡若AI 同步 2026-02-25 06:51 | 更新：水桥平台对接、水溪整理归档、总索引与入口、运营中枢参考资料、运营中枢工作台 | 排除 >20MB: 13 个

2026-02-25 06:51:09 +08:00
parent 313d9c6997
commit 8f77af9d4a
8 changed files with 190 additions and 8 deletions
--- a/02_卡人（水）/水桥_平台对接/飞书管理/SKILL.md
+++ b/02_卡人（水）/水桥_平台对接/飞书管理/SKILL.md
@@ -1,7 +1,7 @@
 ---
 name: 飞书管理
-description: 飞书日志/文档自动写入与知识库管理
-triggers: 飞书日志、写入飞书、飞书知识库、飞书运营报表、派对效果数据、104场写入、运营报表填写、派对截图填表发群、Excel写飞书、批量写飞书表格、表格日报
+description: 飞书日志/文档自动写入与知识库管理（含统一文章上传）
+triggers: 飞书日志、写入飞书、飞书知识库、飞书运营报表、派对效果数据、104场写入、运营报表填写、派对截图填表发群、Excel写飞书、批量写飞书表格、表格日报、飞书文章上传、MD转飞书JSON、同标题更新飞书
 owner: 水桥
 group: 水
 version: "1.1"
@@ -279,6 +279,36 @@ python3 scripts/wanzhi_feishu_project_sync.py

 ---

+## 统一文章上传（强制唯一入口）
+
+以后凡是“写文章并上传飞书”，统一走这一条，不再分散用旧脚本。
+
+### 一键命令（推荐）
+
+```bash
+python3 /Users/karuo/Documents/个人/卡若AI/02_卡人（水）/水桥_平台对接/飞书管理/脚本/feishu_article_unified_publish.py \
+  --parent MyvRwCVNSiTg5ok6e3fc6uA5nHg \
+  --title "文章标题" \
+  --md "/绝对路径/文章.md" \
+  --json "/绝对路径/文章_feishu_blocks.json" \
+  --webhook "https://open.feishu.cn/open-apis/bot/v2/hook/xxx"
+```
+
+### 统一规则（已固化进脚本）
+
+1. **先本地转 JSON**：`md_to_feishu_json.py`，自动清理分隔线/空块，减少飞书样式杂乱和报错。  
+2. **同标题优先更新**：在父节点下命中同名/相似标题时更新，不重复新建。  
+3. **支持图片上传**：读取 `image_paths` 上传到文档素材。  
+4. **图片块失败兜底**：若飞书 API 对图片块返回 `invalid param`，正文照常写入，图片保留在文档素材（可手动插入）。  
+
+### 当前已验证经验（线上）
+
+- 飞书 docx 接口在当前租户中，`block_type 12/18/27` 图片块都可能返回 `1770001 invalid param`。  
+- 因此采用“**正文稳定写入 + 图片素材保留 + 可手动插图**”作为稳定方案。  
+- 后续若飞书放开该能力，再切回全自动嵌图。
+
+---
+
 ## Wiki 子文档创建（日记分享 / 新研究）

 在指定飞书 Wiki 节点下创建子文档，用于日记分享、新研究等内容沉淀。
@@ -316,6 +346,9 @@ JSON 格式：与 `团队入职流程与新人登记表_feishu_blocks.json` 相
    ├── feishu_video_clip_README.md
    ├── wanzhi_feishu_project_sync.py    # 玩值电竞→飞书项目同步
    ├── feishu_wiki_create_doc.py       # Wiki 子文档创建（日记/研究）
+    ├── md_to_feishu_json.py            # Markdown -> 飞书 blocks JSON（美观清洗）
+    ├── feishu_publish_blocks_with_images.py  # 同标题更新 + 图片上传 + 发布
+    ├── feishu_article_unified_publish.py     # 统一入口：文章发布（推荐唯一）
    └── .feishu_tokens.json       # Token 存储
 ```

@@ -351,5 +384,5 @@ python3 /Users/karuo/Documents/个人/卡若AI/02_卡人（水）/飞书管理/s

 ---

-**版本**: v3.3 | **更新**: 2026-02-20  
-**特性**: 静默授权、倒序插入、TNTWF规范、四象限分类、**写入完成后自动打开飞书日志页面**、**运营报表子技能（截图→填表→发群竖状格式、会议纪要图片上传、月度统计）**
+**版本**: v3.4 | **更新**: 2026-02-25  
+**特性**: 静默授权、倒序插入、TNTWF规范、四象限分类、**写入完成后自动打开飞书日志页面**、**运营报表子技能（截图→填表→发群竖状格式、会议纪要图片上传、月度统计）**、**统一文章上传（MD->JSON->飞书，同标题优先更新，支持图片上传）**
--- a/02_卡人（水）/水桥_平台对接/飞书管理/脚本/.feishu_tokens.json
+++ b/02_卡人（水）/水桥_平台对接/飞书管理/脚本/.feishu_tokens.json
@@ -1,6 +1,6 @@
 {
-  "access_token": "u-4RmqO0mFN44EsJhMOG0bsrl5mqW5k1iVWEaaIMQ00xD2",
-  "refresh_token": "ur-60CxwKhnldVH9Bd5qTDYxnl5mMW5k1MjgEaaZBQ00Ay6",
+  "access_token": "u-57b3lfJ8Z7XH0uHVO_Tnx2l5moqBk1qXXEaaFAM00wS6",
+  "refresh_token": "ur-579x5jnChbCqtQoGJxgcPpl5moMBk1Uph8aaEBw00xzj",
  "name": "飞书用户",
-  "auth_time": "2026-02-25T05:55:28.028336"
+  "auth_time": "2026-02-25T05:58:38.159179"
 }
--- a/02_卡人（水）/水桥_平台对接/飞书管理/脚本/feishu_article_unified_publish.py
+++ b/02_卡人（水）/水桥_平台对接/飞书管理/脚本/feishu_article_unified_publish.py
@@ -0,0 +1,72 @@
+#!/usr/bin/env python3
+"""
+统一入口：本地 Markdown 文章发布到飞书 Wiki（先转 JSON，再发布）
+
+能力：
+1) MD -> 飞书 blocks JSON（自动美化：去分隔线、清理空块、弱化复杂 Markdown）
+2) 同名/相似标题优先更新，不新建重复文档
+3) 自动上传图片（来自 image_paths），图片块失败时保底写正文并保留文档素材
+4) 可选 webhook 发群
+
+用法：
+python3 feishu_article_unified_publish.py \
+  --parent MyvRwCVNSiTg5ok6e3fc6uA5nHg \
+  --title "卡若：xxx" \
+  --md "/abs/path/article.md" \
+  --json "/abs/path/article_feishu_blocks.json" \
+  --webhook "https://open.feishu.cn/open-apis/bot/v2/hook/xxx"
+"""
+
+import argparse
+import subprocess
+import sys
+from pathlib import Path
+
+
+ROOT = Path("/Users/karuo/Documents/个人/卡若AI")
+MD2JSON = ROOT / "02_卡人（水）/水桥_平台对接/飞书管理/脚本/md_to_feishu_json.py"
+PUBLISH = ROOT / "02_卡人（水）/水桥_平台对接/飞书管理/脚本/feishu_publish_blocks_with_images.py"
+
+
+def run(cmd: list[str]) -> None:
+    print("▶", " ".join(cmd))
+    p = subprocess.run(cmd, text=True)
+    if p.returncode != 0:
+        raise SystemExit(p.returncode)
+
+
+def main():
+    ap = argparse.ArgumentParser()
+    ap.add_argument("--parent", required=True, help="飞书 Wiki 父节点 token")
+    ap.add_argument("--title", required=True, help="文档标题（同名/相似会更新）")
+    ap.add_argument("--md", required=True, help="Markdown 文章路径")
+    ap.add_argument("--json", required=True, help="输出 blocks JSON 路径")
+    ap.add_argument("--webhook", default="", help="飞书群 webhook（可选）")
+    args = ap.parse_args()
+
+    md_path = Path(args.md).expanduser().resolve()
+    json_path = Path(args.json).expanduser().resolve()
+    if not md_path.exists():
+        raise SystemExit(f"❌ MD 不存在: {md_path}")
+    json_path.parent.mkdir(parents=True, exist_ok=True)
+
+    # Step 1: 本地转 JSON
+    run(["python3", str(MD2JSON), str(md_path), str(json_path)])
+
+    # Step 2: 发布（同标题优先更新）
+    cmd = [
+        "python3", str(PUBLISH),
+        "--parent", args.parent,
+        "--title", args.title,
+        "--json", str(json_path),
+    ]
+    if args.webhook:
+        cmd.extend(["--webhook", args.webhook])
+    run(cmd)
+
+    print("✅ 统一发布完成")
+
+
+if __name__ == "__main__":
+    main()
+
--- a/02_卡人（水）/水溪_整理归档/经验库/待沉淀/2026-02-25_飞书文章统一上传_Skill经验.md
+++ b/02_卡人（水）/水溪_整理归档/经验库/待沉淀/2026-02-25_飞书文章统一上传_Skill经验.md
@@ -0,0 +1,49 @@
+# 2026-02-25 飞书文章统一上传（Skill 经验沉淀）
+
+## 一、目标
+
+把“写文章上传飞书”统一成一条稳定链路：
+
+`Markdown -> 飞书 blocks JSON -> 同标题更新/发布 -> 图片上传 -> 发群`
+
+以后统一走 `飞书管理` Skill，不再分散用临时脚本。
+
+## 二、统一入口（唯一推荐）
+
+脚本：
+
+`02_卡人（水）/水桥_平台对接/飞书管理/脚本/feishu_article_unified_publish.py`
+
+能力：
+
+1. 先本地转 JSON（自动清理分隔线、空块、复杂 Markdown）
+2. 在父节点下查找同名/相似标题，命中则更新，不新建重复文档
+3. 上传 `image_paths` 图片到文档素材
+4. 正文稳定写入，支持可选 webhook 通知
+
+## 三、关键经验
+
+1. 当前租户下，飞书 docx 图片块（`block_type 12/18/27`）都可能返回 `1770001 invalid param`
+2. 稳定方案是“正文先写成功 + 图片上传文档素材 + 需要时手动插图”
+3. Markdown 里大量 `---`、空行、复杂代码块，容易导致写入失败或观感差，需在转 JSON 时清洗
+4. 同标题更新比“每次新建”更适合长期知识库运营
+
+## 四、实践命令模板
+
+```bash
+python3 /Users/karuo/Documents/个人/卡若AI/02_卡人（水）/水桥_平台对接/飞书管理/脚本/feishu_article_unified_publish.py \
+  --parent MyvRwCVNSiTg5ok6e3fc6uA5nHg \
+  --title "文章标题" \
+  --md "/绝对路径/文章.md" \
+  --json "/绝对路径/文章_feishu_blocks.json" \
+  --webhook "https://open.feishu.cn/open-apis/bot/v2/hook/xxx"
+```
+
+## 五、涉及文件
+
+- `02_卡人（水）/水桥_平台对接/飞书管理/SKILL.md`
+- `02_卡人（水）/水桥_平台对接/飞书管理/脚本/md_to_feishu_json.py`
+- `02_卡人（水）/水桥_平台对接/飞书管理/脚本/feishu_publish_blocks_with_images.py`
+- `02_卡人（水）/水桥_平台对接/飞书管理/脚本/feishu_article_unified_publish.py`
+- `SKILL_REGISTRY.md`
+
--- a/SKILL_REGISTRY.md
+++ b/SKILL_REGISTRY.md
@@ -51,7 +51,7 @@
 | W04 | 自动记忆管理 | 水溪 | 记忆、存入记忆 | `02_卡人（水）/水溪_整理归档/自动记忆管理/SKILL.md` | 长期记忆写入与检索 |
 | W05 | 需求拆解与计划制定 | 水泉 | 需求拆解、任务分析 | `02_卡人（水）/水泉_规划拆解/需求拆解与计划制定/SKILL.md` | 大需求拆成可执行步骤 |
 | W06 | 任务规划 | 水泉 | 任务规划、制定计划 | `02_卡人（水）/水泉_规划拆解/任务规划/SKILL.md` | 制定执行计划与排期 |
-| W07 | 飞书管理 | 水桥 | 飞书日志、写入飞书 | `02_卡人（水）/水桥_平台对接/飞书管理/SKILL.md` | 飞书日志/文档自动化 |
+| W07 | 飞书管理 | 水桥 | 飞书日志、写入飞书、飞书文章上传、MD转飞书JSON、同标题更新飞书、飞书上传图片 | `02_卡人（水）/水桥_平台对接/飞书管理/SKILL.md` | 飞书日志/文档自动化（统一文章上传入口） |
 | W08 | 智能纪要 | 水桥 | 会议纪要、产研纪要、**飞书妙记、飞书链接、妙记下载、第几场、指定场次、批量下载妙记、cunkebao.feishu.cn、meetings.feishu.cn/minutes** | `02_卡人（水）/水桥_平台对接/智能纪要/SKILL.md` | 会议录音转结构化纪要；飞书妙记识别与下载（单条/批量），完毕用复盘格式回复 |
 | W09 | 小程序管理 | 水桥 | 小程序、微信小程序 | `02_卡人（水）/水桥_平台对接/小程序管理/SKILL.md` | 微信小程序发布与维护 |
 | W10 | Soul文章上传 | 水桥 | **Soul文章上传、Soul派对文章、第9章上传、soul上传** | `02_卡人（水）/水桥_平台对接/Soul文章上传/SKILL.md` | 《一场soul的创业实验》第9章文章写好后上传到小程序，id 已存在则更新不重复 |
--- a/运营中枢/参考资料/卡若AI外网化与外部调用方案.md
+++ b/运营中枢/参考资料/卡若AI外网化与外部调用方案.md
@@ -224,6 +224,32 @@ curl -sS https://kr-ai.quwanzhi.com/v1/chat/completions \
 3. 不要在 Base URL 末尾加 `/`
 4. 改完后重启 Cursor 一次

+## 7.3 其它同类工具配置（OpenAI 兼容客户端）
+
+适用于：Claude Desktop(OpenAI兼容插件)、Cherry Studio、LobeChat、自建 Agent、任意支持 OpenAI API 的工具。
+
+统一填写：
+
+1. `Base URL`：`https://kr-ai.quwanzhi.com/v1`
+2. `API Key`：`<dept_key>`
+3. `Model`：`karuo-ai`（或工具允许的自定义名）
+4. 关闭流式可先联调，联通后再开流式
+
+联调顺序：
+
+1. 先测 `GET /v1/models` 是否返回模型列表
+2. 再测 `POST /v1/chat/completions` 是否返回 `choices`
+3. 最后在工具内发一条真实问题验证
+
+最简请求模板：
+
+```bash
+curl -sS https://kr-ai.quwanzhi.com/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer <dept_key>" \
+  -d '{"model":"karuo-ai","messages":[{"role":"user","content":"测试连通"}]}'
+```
+
 ---

 ## 8. 健康检查与联调命令
--- a/运营中枢/工作台/gitea_push_log.md
+++ b/运营中枢/工作台/gitea_push_log.md
@@ -130,3 +130,4 @@
 | 2026-02-24 20:10:45 | 🔄 卡若AI 同步 2026-02-24 20:10 | 更新：运营中枢、运营中枢工作台 | 排除 >20MB: 12 个 |
 | 2026-02-24 21:16:30 | 🔄 卡若AI 同步 2026-02-24 21:16 | 更新：水桥平台对接、运营中枢工作台 | 排除 >20MB: 12 个 |
 | 2026-02-24 21:33:10 | 🔄 卡若AI 同步 2026-02-24 21:33 | 更新：总索引与入口、水桥平台对接、运营中枢工作台 | 排除 >20MB: 13 个 |
+| 2026-02-25 05:57:01 | 🔄 卡若AI 同步 2026-02-25 05:56 | 更新：水桥平台对接、运营中枢参考资料、运营中枢工作台 | 排除 >20MB: 13 个 |
--- a/运营中枢/工作台/代码管理.md
+++ b/运营中枢/工作台/代码管理.md
@@ -133,3 +133,4 @@
 | 2026-02-24 20:10:45 | 成功 | 成功 | 🔄 卡若AI 同步 2026-02-24 20:10 | 更新：运营中枢、运营中枢工作台 | 排除 >20MB: 12 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |
 | 2026-02-24 21:16:30 | 成功 | 成功 | 🔄 卡若AI 同步 2026-02-24 21:16 | 更新：水桥平台对接、运营中枢工作台 | 排除 >20MB: 12 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |
 | 2026-02-24 21:33:10 | 成功 | 成功 | 🔄 卡若AI 同步 2026-02-24 21:33 | 更新：总索引与入口、水桥平台对接、运营中枢工作台 | 排除 >20MB: 13 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |
+| 2026-02-25 05:57:01 | 成功 | 成功 | 🔄 卡若AI 同步 2026-02-25 05:56 | 更新：水桥平台对接、运营中枢参考资料、运营中枢工作台 | 排除 >20MB: 13 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |