🔄 卡若AI 同步 2026-03-13 10:42 | 更新：水桥平台对接、卡木、火炬、运营中枢、运营中枢工作台 | 排除 >20MB: 11 个
This commit is contained in:
182
02_卡人（水）/水桥_平台对接/智能纪要/脚本/sync_missing_txt.py
Normal file
182
02_卡人（水）/水桥_平台对接/智能纪要/脚本/sync_missing_txt.py
Normal file
@@ -0,0 +1,182 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""对比 聊天记录/soul 下已有 txt 与妙记列表，只下载缺失场次的文字。"""
|
||||
import re
|
||||
import sys
|
||||
import sqlite3
|
||||
import shutil
|
||||
import tempfile
|
||||
import time
|
||||
import requests
|
||||
from pathlib import Path
|
||||
|
||||
TXT_DIR = Path("/Users/karuo/Documents/聊天记录/soul")
|
||||
COOKIE_PATH = Path.home() / "Library/Application Support/Cursor/Partitions/cursor-browser/Cookies"
|
||||
LIST_URL = "https://cunkebao.feishu.cn/minutes/api/space/list"
|
||||
EXPORT_URL = "https://cunkebao.feishu.cn/minutes/api/export"
|
||||
MAX_PAGES = 30
|
||||
PAGE_SIZE = 50
|
||||
|
||||
|
||||
def get_cookie():
|
||||
if not COOKIE_PATH.exists():
|
||||
return "", ""
|
||||
tmp = tempfile.mktemp(suffix=".db")
|
||||
shutil.copy2(COOKIE_PATH, tmp)
|
||||
try:
|
||||
conn = sqlite3.connect(tmp)
|
||||
rows = conn.execute(
|
||||
"SELECT name, value FROM cookies WHERE (host_key LIKE '%feishu%' OR host_key LIKE '%cunkebao%') AND value != ''"
|
||||
).fetchall()
|
||||
conn.close()
|
||||
finally:
|
||||
Path(tmp).unlink(missing_ok=True)
|
||||
cookie_str = "; ".join([f"{n}={v}" for n, v in rows])
|
||||
bv = ""
|
||||
for key in ("bv_csrf_token=", "minutes_csrf_token="):
|
||||
i = cookie_str.find(key)
|
||||
if i != -1:
|
||||
s = i + len(key)
|
||||
e = cookie_str.find(";", s)
|
||||
val = cookie_str[s : e if e != -1 else len(cookie_str)].strip()
|
||||
if len(val) == 36:
|
||||
bv = val
|
||||
break
|
||||
return cookie_str, bv
|
||||
|
||||
|
||||
def have_pairs_from_dir():
|
||||
have = set()
|
||||
for f in TXT_DIR.iterdir():
|
||||
if not f.is_file() or f.suffix.lower() != ".txt":
|
||||
continue
|
||||
nums = re.findall(r"(\d+)场", f.name)
|
||||
dates = re.findall(r"(20\d{6})", f.name)
|
||||
for n in nums:
|
||||
for d in dates:
|
||||
have.add((int(n), d))
|
||||
if not dates:
|
||||
have.add((int(n), ""))
|
||||
return have
|
||||
|
||||
|
||||
def topic_to_pair(topic):
|
||||
nums = re.findall(r"(\d+)场", topic)
|
||||
dates = re.findall(r"(20\d{6})", topic)
|
||||
if not nums:
|
||||
return None, None
|
||||
return int(nums[0]), (dates[0] if dates else "")
|
||||
|
||||
|
||||
def sanitize(topic):
|
||||
s = topic.strip()
|
||||
for c in r'\/:*?"<>|':
|
||||
s = s.replace(c, "_")
|
||||
return s[:85].strip()
|
||||
|
||||
|
||||
def fetch_list(headers):
|
||||
all_items = []
|
||||
last_ts = ""
|
||||
for page in range(1, MAX_PAGES + 1):
|
||||
url = f"{LIST_URL}?size={PAGE_SIZE}&space_name=1"
|
||||
if last_ts:
|
||||
url += f"&last_time={last_ts}"
|
||||
r = requests.get(url, headers=headers, timeout=30)
|
||||
if r.status_code != 200:
|
||||
break
|
||||
data = r.json()
|
||||
if data.get("code") != 0:
|
||||
break
|
||||
items = data.get("data", {}).get("list", [])
|
||||
if not items:
|
||||
break
|
||||
all_items.extend(items)
|
||||
last_ts = items[-1].get("create_time", "")
|
||||
if len(items) < PAGE_SIZE:
|
||||
break
|
||||
time.sleep(0.25)
|
||||
return all_items
|
||||
|
||||
|
||||
def export_txt(headers, object_token):
|
||||
params = {"object_token": object_token, "format": 2, "add_speaker": "true", "add_timestamp": "false"}
|
||||
r = requests.post(EXPORT_URL, params=params, headers=headers, timeout=25)
|
||||
r.encoding = "utf-8"
|
||||
if r.status_code == 200 and (r.text or "").strip():
|
||||
return (r.text or "").strip()
|
||||
return None
|
||||
|
||||
|
||||
def main():
|
||||
import argparse
|
||||
ap = argparse.ArgumentParser(description="同步缺失场次文字到 聊天记录/soul")
|
||||
ap.add_argument("--max-download", type=int, default=0, help="最多下载条数，0=全部")
|
||||
ap.add_argument("--dry-run", action="store_true", help="只列缺失不下载")
|
||||
args = ap.parse_args()
|
||||
|
||||
TXT_DIR.mkdir(parents=True, exist_ok=True)
|
||||
cookie_str, bv = get_cookie()
|
||||
if len(cookie_str) < 100:
|
||||
print("无法获取 Cookie（请用 Cursor 打开过飞书妙记）", file=sys.stderr)
|
||||
sys.exit(1)
|
||||
headers = {
|
||||
"User-Agent": "Mozilla/5.0",
|
||||
"Cookie": cookie_str,
|
||||
"Referer": "https://cunkebao.feishu.cn/minutes/",
|
||||
}
|
||||
if bv:
|
||||
headers["bv-csrf-token"] = bv
|
||||
|
||||
have = have_pairs_from_dir()
|
||||
print(f"目录已有场次对: {len(have)}", flush=True)
|
||||
|
||||
all_items = fetch_list(headers)
|
||||
print(f"API 拉取: {len(all_items)} 条", flush=True)
|
||||
|
||||
missing = []
|
||||
seen_tokens = set()
|
||||
for it in all_items:
|
||||
topic = it.get("topic", "")
|
||||
token = it.get("object_token", "")
|
||||
if not token or token in seen_tokens:
|
||||
continue
|
||||
n, d = topic_to_pair(topic)
|
||||
if n is None:
|
||||
continue
|
||||
if (n, d) in have or (n, "") in have:
|
||||
continue
|
||||
seen_tokens.add(token)
|
||||
missing.append({"topic": topic, "object_token": token, "n": n, "d": d})
|
||||
|
||||
print(f"缺失需下载: {len(missing)} 条（已按 object_token 去重）", flush=True)
|
||||
if not missing:
|
||||
return 0
|
||||
if args.dry_run:
|
||||
for m in missing[:50]:
|
||||
print(f" {m['n']}场 {m['d']} {m['topic'][:55]}", flush=True)
|
||||
if len(missing) > 50:
|
||||
print(f" ... 共 {len(missing)} 条", flush=True)
|
||||
return 0
|
||||
|
||||
to_do = missing[: args.max_download] if args.max_download else missing
|
||||
ok = 0
|
||||
for i, m in enumerate(to_do):
|
||||
topic = m["topic"]
|
||||
token = m["object_token"]
|
||||
body = export_txt(headers, token)
|
||||
if body and len(body) > 50:
|
||||
base = sanitize(topic) + ".txt"
|
||||
path = TXT_DIR / base
|
||||
path.write_text("标题: " + topic + "\n\n" + body, encoding="utf-8")
|
||||
print(f" [{i+1}/{len(to_do)}] OK {m['n']}场 -> {base[:50]}", flush=True)
|
||||
ok += 1
|
||||
else:
|
||||
print(f" [{i+1}/{len(to_do)}] 跳过(无转写) {m['n']}场 {topic[:40]}", flush=True)
|
||||
time.sleep(0.4)
|
||||
print(f"完成: 新写入 {ok} 个 txt（本次处理 {len(to_do)}，剩余 {len(missing)-len(to_do)} 可再次运行本脚本补全）", flush=True)
|
||||
return ok
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
File diff suppressed because it is too large
Load Diff
@@ -1,11 +1,11 @@
|
||||
---
|
||||
name: 全栈开发
|
||||
description: 卡若AI 全栈开发（火炬）— 知己及类似项目经验 + 官网/全站开发与「开发文档 1～10」标准流程；吸收 Superpowers 实施计划粒度、TDD 推荐、两阶段评审与分支收尾。含分销、RAG、向量化；官网/全站类任务时按 1～10 调研→计划→执行→评审→复盘。**以后开发新网站一律用本 Skill 做调研与执行。**
|
||||
triggers: 全栈开发/知己项目/分销/存客宝/RAG/向量化/Next.js/知识库/卡若AI官网/官网开发/全站开发/开发文档/1～10/开发模板/官网全站/v0前端/v0生成/毛玻璃/前端规格/神射手/毛狐狸/前端标准/实施计划/两阶段评审/橙色锁/配色/API调用
|
||||
description: 卡若AI 全栈开发（火炬）— 知己及类似项目经验 + 官网/全站开发与「开发文档 1～10」标准流程；吸收 Superpowers 实施计划粒度、TDD 推荐、两阶段评审与分支收尾。含分销、RAG、向量化；官网/全站类任务时按 1～10 调研→计划→执行→评审→复盘。**以后开发新网站一律用本 Skill 做调研与执行。** 使用手册一律按卡若AI 使用手册结构（书籍式+图文+images）生成，见开发模板 9、手册。
|
||||
triggers: 全栈开发/知己项目/分销/存客宝/RAG/向量化/Next.js/知识库/卡若AI官网/官网开发/全站开发/开发文档/1～10/开发模板/官网全站/v0前端/v0生成/毛玻璃/前端规格/神射手/毛狐狸/前端标准/实施计划/两阶段评审/橙色锁/配色/API调用/使用手册
|
||||
owner: 火炬
|
||||
group: 火
|
||||
version: "2.3"
|
||||
updated: "2026-02-17"
|
||||
version: "2.4"
|
||||
updated: "2026-03-12"
|
||||
---
|
||||
|
||||
# 全栈开发（火炬）
|
||||
@@ -24,7 +24,7 @@ updated: "2026-02-17"
|
||||
- **根目录**：仅保留一个 **README.md**，作为 1～10 索引入口；**全部文档归入 10 个目录**，不在根目录散落。
|
||||
- **1～10 目录**：需求 | 架构 | 原型 | 前端 | 接口 | 后端 | 数据库 | 部署 | 手册 | 项目管理。
|
||||
- **入口**：第一次用先读 `1、需求/卡若AI项目使用说明.md`（或该项目等价说明），再读 `10、项目管理/开发文档使用指引（卡若交互式）.md`。
|
||||
- **手册**：`9、手册/使用手册（带图）.md` 为访客/开发者操作手册；配图放 `9、手册/images/`。
|
||||
- **手册**：使用手册**一律按卡若AI 使用手册结构**书写（书籍式：README 总目录 + 篇/章多文件 + 附录），并**图文并茂**。配图放 `9、手册/images/`，在章节内引用，并在 `images/README.md` 登记。详见 `开发模板/9、手册/使用手册生成规范_卡若AI结构.md`；入口可保留 `9、手册/使用手册（带图）.md` 作导航或单页摘要。
|
||||
- **复盘**：迭代结尾用 `10、项目管理/迭代复盘模板.md`（卡若复盘格式，含 Human 3.0 反思与总结）。
|
||||
|
||||
### 1.2 执行流程（调研 → 计划 → 执行 → 评审 → 复盘）
|
||||
|
||||
@@ -1,7 +1,9 @@
|
||||
# 📚 手册智能展开引擎 (Manual Auto-Expand)
|
||||
|
||||
> **角色激活**: 将此文件拖入 AI，即刻激活 **技术文档专家 + 内容运营** 角色
|
||||
> **核心能力**: 用户手册、FAQ、营销文案、落地方案
|
||||
> **角色激活**: 将此文件拖入 AI，即刻激活 **技术文档专家 + 内容运营** 角色
|
||||
> **核心能力**: 用户手册、FAQ、营销文案、落地方案
|
||||
> **强制约定**: 生成使用手册时，**一律按卡若AI 使用手册结构**（书籍式：README + 篇/章多文件 + 附录），并**图文并茂**（配图放 `9、手册/images/`，见本目录《使用手册生成规范_卡若AI结构》）。
|
||||
> **更新**: 2026-03-12
|
||||
|
||||
---
|
||||
|
||||
@@ -298,17 +300,30 @@ graph LR
|
||||
### 8.1 文档原则
|
||||
```yaml
|
||||
必须做:
|
||||
- [ ] 每个步骤配截图
|
||||
- [ ] 每个步骤配截图（图放 9、手册/images/，章节内引用并登记 images/README.md）
|
||||
- [ ] 使用大白话
|
||||
- [ ] 价值前置
|
||||
- [ ] 提供联系方式
|
||||
- [ ] 使用手册按「卡若AI 使用手册」结构：README 总目录 + 篇/章独立 .md + 附录 + images/
|
||||
|
||||
禁止做:
|
||||
- [ ] 使用技术术语
|
||||
- [ ] 长篇大论无重点
|
||||
- [ ] 只说功能不说价值
|
||||
- [ ] 使用手册仅单文件无篇章、无配图
|
||||
```
|
||||
|
||||
### 8.2 使用手册结构（卡若AI 结构）
|
||||
|
||||
生成使用手册时必守：
|
||||
|
||||
1. **README.md**：序 + 总目录表（篇→章→文件→内容），与 `卡若AI/运营中枢/使用手册/README.md` 形式一致。
|
||||
2. **多文件**：每篇一文件夹，每章一 .md；章内可引用 `../images/xxx.png` 或 `images/xxx.png`。
|
||||
3. **images/**：所有配图放此目录；`images/README.md` 登记「文件名 | 说明 | 引用章节」。
|
||||
4. **图片流程**：列配图清单 → 建 images → 生成/采集图 → 章节引用 → 登记索引 → 与手册一并同步。
|
||||
|
||||
详见本目录 **使用手册生成规范_卡若AI结构.md**。
|
||||
|
||||
---
|
||||
|
||||
> **下一步**: 手册完成后，拖入 `10、项目管理/_智能展开.md` 进行项目管理
|
||||
|
||||
@@ -1,48 +1,81 @@
|
||||
# 使用手册提示词 (User Manual Prompt) - 智能自生长文档
|
||||
# 使用手册提示词 (User Manual Prompt)
|
||||
|
||||
> **提示词功能 (Prompt Function)**: 将本文件拖入 AI 对话框，即可激活“技术文档专家”角色，生成小白也能看懂的操作手册。
|
||||
> **强制**：生成任何项目的使用手册时，一律按 **卡若AI 使用手册** 的结构与分类书写，并**图文并茂**。
|
||||
> **规范**：详见本目录 [使用手册生成规范_卡若AI结构.md](使用手册生成规范_卡若AI结构.md)
|
||||
> **更新**：2026-03-12
|
||||
|
||||
## 1. 基础上下文 (The Two Basic Files)
|
||||
### 1.1 角色档案：卡若 (Karuo)
|
||||
- **受众**：小白用户、合作方老板。
|
||||
- **风格**：大白话、傻瓜式、图文并茂。
|
||||
---
|
||||
|
||||
### 1.2 文档原则
|
||||
- **价值先行**：先说能赚多少钱，再说怎么操作。
|
||||
- **步骤清晰**：Step 1, 2, 3。
|
||||
## 1. 角色与原则
|
||||
|
||||
## 2. 手册核心 (Master Content)
|
||||
### 2.1 功能介绍 (Value)
|
||||
- **话术**：不要说“分布式”，要说“账目自动同步，谁也改不了”。
|
||||
- **核心**：帮你自动分钱的工具。
|
||||
- **角色**：技术文档专家（卡若式），面向小白用户、合作方、管理员。
|
||||
- **结构**：按卡若AI 使用手册——**书籍式**（README 总目录 + 篇/章 多文件 + 附录），每章独立 .md，目录清晰。
|
||||
- **形式**：聊天的形式、大白话、步骤一二三清晰；价值先行（先说能解决什么问题，再说怎么操作）。
|
||||
- **图文**：**必须配图**。架构图、流程图、界面截图放 `9、手册/images/`，在章节内引用，并在 `images/README.md` 登记。
|
||||
|
||||
### 2.2 快速上手 (How-to)
|
||||
- **Step 1**: 登录与绑定 (截图)。
|
||||
- **Step 2**: 开启流量池 (核心操作)。
|
||||
- **Step 3**: 提现与分润 (钱)。
|
||||
---
|
||||
|
||||
### 2.3 常见问题 (Q&A)
|
||||
- **痛点**：如果不显示收益怎么办？
|
||||
- **解法**：点击刷新，检查网络。
|
||||
## 2. 生成前必读
|
||||
|
||||
## 3. AI 协作指令 (Expanded Function)
|
||||
**角色**：你是我（卡若）的内容运营。
|
||||
**任务**：
|
||||
1. **文档撰写**：根据功能描述，写出“傻瓜式”操作手册。
|
||||
2. **话术优化**：将技术术语翻译成“老板听得懂的话”。
|
||||
3. **用户旅程**：用 Mermaid 展示用户操作流程。
|
||||
1. 读 **使用手册生成规范_卡若AI结构.md**（本目录）。
|
||||
2. 读 卡若AI 使用手册入口：`卡若AI/运营中枢/使用手册/README.md`（总目录与篇章形式）。
|
||||
3. 根据当前项目确定：篇数、章数、配图清单（架构图、流程图、截图）。
|
||||
|
||||
---
|
||||
|
||||
## 3. 手册结构（与卡若AI 对齐）
|
||||
|
||||
### 示例 Mermaid (用户旅程)
|
||||
```mermaid
|
||||
journey
|
||||
title 合作方使用流程
|
||||
section 注册
|
||||
打开小程序: 5: 合作方
|
||||
手机号登录: 4: 合作方
|
||||
section 赚钱
|
||||
开启流量池: 5: 合作方
|
||||
查看今日收益: 5: 合作方
|
||||
section 提现
|
||||
申请提现: 4: 合作方
|
||||
到账: 5: 合作方
|
||||
```
|
||||
9、手册/
|
||||
├── README.md ← 序 + 总目录表（篇→章→文件→内容）
|
||||
├── images/ ← 配图，与手册同步
|
||||
│ ├── README.md ← 配图索引
|
||||
│ └── *.png
|
||||
├── 第一篇_XXX/
|
||||
│ ├── 01_xxx.md
|
||||
│ └── 02_xxx.md
|
||||
├── 第二篇_XXX/ ...
|
||||
├── 附录/
|
||||
│ ├── A_速查表.md
|
||||
│ ├── B_常用命令.md
|
||||
│ ├── C_FAQ.md
|
||||
│ └── D_更新记录.md
|
||||
└── （本提示词与规范）
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. 图片流程（必须执行）
|
||||
|
||||
1. **列配图清单**：架构图、流程图、关键页截图，写入 `images/README.md` 或实施计划。
|
||||
2. **建 images 目录**：`9、手册/images/`，所有图放此目录。
|
||||
3. **生成或采集图**：Mermaid 导出 / AI 生成示意图 / 实际截图，命名规范如 `功能名_说明.png`。
|
||||
4. **在章节中引用**：``，并加图题 **图 X-X 标题**。
|
||||
5. **登记索引**：在 `images/README.md` 维护「文件名 | 说明 | 引用章节」。
|
||||
6. **同步**：手册与 images 一并提交、一并同步。
|
||||
|
||||
---
|
||||
|
||||
## 5. 话术与风格（卡若式）
|
||||
|
||||
- 价值先行：先说能赚多少钱/解决什么问题，再说怎么操作。
|
||||
- 步骤清晰：Step 1 / 2 / 3，每步可配截图。
|
||||
- 话术转换：技术术语 → 用户能听懂的话（例：「调用 API」→「点击刷新，数据自动更新」）。
|
||||
- 每章：文首「返回 [总目录](../README.md) | 上一章」；文末「下一章：…」。
|
||||
|
||||
---
|
||||
|
||||
## 6. AI 协作指令示例
|
||||
|
||||
| 指令 | 动作 |
|
||||
|:---|:---|
|
||||
| 生成使用手册 | 按本提示词 + 使用手册生成规范，建 README、篇/章、images、配图与索引 |
|
||||
| 按卡若AI 手册结构写手册 | 同上，结构严格对齐卡若AI 使用手册（篇/章/附录 + 图文） |
|
||||
| 给手册加图 | 按「图片流程」补图、引用、登记 images/README.md |
|
||||
|
||||
---
|
||||
|
||||
## 7. 与开发文档 1～10 的联动
|
||||
|
||||
- 手册内容可引用：`1、需求` 功能说明、`3、原型` 页面描述、`4、前端` 页面与路由、`8、部署` 运维说明。
|
||||
- 手册更新后，在 `附录/D_更新记录.md` 追加版本与变更说明。
|
||||
|
||||
127
04_卡火（火）/火炬_全栈消息/全栈开发/开发模板/9、手册/使用手册生成规范_卡若AI结构.md
Normal file
127
04_卡火（火）/火炬_全栈消息/全栈开发/开发模板/9、手册/使用手册生成规范_卡若AI结构.md
Normal file
@@ -0,0 +1,127 @@
|
||||
# 使用手册生成规范（卡若AI 结构）
|
||||
|
||||
> **强制**：任何项目生成使用手册时，一律按本规范执行。
|
||||
> **参照**：卡若AI 使用手册（`卡若AI/运营中枢/使用手册/`）
|
||||
> **版本**：1.0 | **更新**：2026-03-12
|
||||
|
||||
---
|
||||
|
||||
## 一、为什么按这个结构
|
||||
|
||||
- **统一体验**：在任意项目上生成的使用手册，结构一致、导航清晰，用户和卡若AI 都能快速查找。
|
||||
- **书籍式**：每篇一个文件夹、每章一个 .md，像一本书，便于维护和增量更新。
|
||||
- **图文并茂**：必须包含配图（架构图、流程图、截图），配图与手册一起存放、一起同步。
|
||||
|
||||
---
|
||||
|
||||
## 二、标准目录结构（必须遵守）
|
||||
|
||||
生成使用手册时，在项目的 **`开发文档/9、手册/`** 下按以下结构创建（可根据项目规模精简篇数，但**结构形式一致**）：
|
||||
|
||||
```
|
||||
9、手册/
|
||||
├── README.md ← 序 + 总目录（入口）
|
||||
├── 使用手册（带图）.md ← 可选：导航页/单页摘要
|
||||
├── images/ ← 配图目录（与手册同步）
|
||||
│ ├── README.md ← 配图索引（文件名、说明、引用章节）
|
||||
│ └── [架构图/流程图/截图].png
|
||||
├── 第一篇_XXX/ ← 按主题分篇
|
||||
│ ├── 01_章节名.md
|
||||
│ └── 02_章节名.md
|
||||
├── 第二篇_XXX/
|
||||
│ └── ...
|
||||
├── 附录/
|
||||
│ ├── A_速查表.md
|
||||
│ ├── B_常用命令.md
|
||||
│ ├── C_FAQ.md
|
||||
│ └── D_更新记录.md
|
||||
├── 使用手册提示词.md ← 本目录原有
|
||||
├── 使用手册生成规范_卡若AI结构.md ← 本文件（可复制到各项目）
|
||||
└── _智能展开.md
|
||||
```
|
||||
|
||||
- **README.md**：序言 + 总目录表格（篇→章→文件→内容），与卡若AI 使用手册 README 形式一致。
|
||||
- **每章独立 .md**：章内可含图片引用，如 `` 或 ``（视层级而定）。
|
||||
- **images/**：所有配图放此目录，并在 `images/README.md` 登记「文件名、说明、引用章节」。
|
||||
|
||||
---
|
||||
|
||||
## 三、书写形式（聊天的形式 / 卡若式）
|
||||
|
||||
- **语气**：大白话、用户能听懂；避免堆砌术语。
|
||||
- **结构**：每章有「小结/概述」、分节清晰、必要时用表格与列表。
|
||||
- **导航**：每章文首「返回 [总目录](../README.md) | 上一章」；文末「下一章：[第X章](链接)」。
|
||||
- **复盘友好**：若手册由卡若AI 生成，结尾可带简要复盘或更新记录。
|
||||
|
||||
---
|
||||
|
||||
## 四、图文要求（强制）
|
||||
|
||||
### 4.1 必须包含图片
|
||||
|
||||
使用手册**必须图文并茂**，不得仅有文字。至少包含：
|
||||
|
||||
| 类型 | 说明 | 示例 |
|
||||
|:---|:---|:---|
|
||||
| 架构/系统图 | 产品架构、模块关系、数据流 | 系统架构图、功能模块图 |
|
||||
| 流程图 | 操作流程、业务流程、状态流转 | 用户操作流程图、上线流程图 |
|
||||
| 界面截图 | 关键页面、操作步骤截图 | 登录页、核心功能页、设置页 |
|
||||
|
||||
### 4.2 图片流程（生成手册时的执行顺序）
|
||||
|
||||
1. **确定配图清单**：根据目录与章节，列出需要的图（架构图、流程图、截图），写入 `images/README.md` 的「计划」或直接写表。
|
||||
2. **创建 images 目录**：在 `9、手册/images/` 下存放所有图片；单张建议 <5MB，格式以 PNG 为主。
|
||||
3. **生成或采集图片**：
|
||||
- 架构/流程图：可用 Mermaid 生成后导出 PNG，或由 AI 生成示意图，保存到 `images/`。
|
||||
- 界面截图：从实际项目/原型截取，命名规范如 `页面名_功能说明.png`。
|
||||
4. **在章节中引用**：在对应章节用 Markdown 插入，例如 ``，并配图题（**图 X-X 标题**）。
|
||||
5. **登记配图索引**：在 `images/README.md` 中维护「文件名 | 说明 | 引用章节」表格，与卡若AI 使用手册的 `images/README.md` 形式一致。
|
||||
6. **同步**：手册与 images 一并提交、一并同步（如 Git/Gitea），不分离。
|
||||
|
||||
### 4.3 图片命名与索引示例
|
||||
|
||||
**images/README.md 示例**：
|
||||
|
||||
```markdown
|
||||
# 使用手册配图
|
||||
|
||||
| 文件名 | 说明 | 引用章节 |
|
||||
|:---|:---|:---|
|
||||
| 系统架构图.png | 整体架构与模块关系 | 第1章 总览 |
|
||||
| 登录流程.png | 用户登录步骤 | 第2章 快速开始 |
|
||||
| 控制台首页.png | 控制台首页截图 | 第3章 功能说明 |
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 五、与卡若AI 使用手册的对应关系
|
||||
|
||||
| 卡若AI 使用手册 | 项目使用手册可对应 |
|
||||
|:---|:---|
|
||||
| 第一篇 认识… / 第二篇 快速入门 | 第一篇 产品介绍 / 第二篇 快速开始 |
|
||||
| 第三篇 功能详解（按模块） | 第三篇 功能说明（按功能/页面） |
|
||||
| 第四篇 运营/规范 | 第四篇 配置与运维（若有） |
|
||||
| 第五篇 网站/控制台 | 按项目实际（如 第五篇 API 与集成） |
|
||||
| 第六篇 进阶 | 按项目实际（如 进阶与扩展） |
|
||||
| 附录 A/B/C/D | 附录 速查/命令/FAQ/更新记录 |
|
||||
|
||||
项目可只保留 2～4 篇 + 附录，但**目录清晰、每章独立 .md、配图在 images/ 并写索引**三项不变。
|
||||
|
||||
---
|
||||
|
||||
## 六、生成时的 AI 协作指令
|
||||
|
||||
当用户说「生成使用手册」「写使用手册」「按卡若AI 手册结构写手册」时：
|
||||
|
||||
1. **先读**：本规范 + 卡若AI `运营中枢/使用手册/README.md`（了解总目录与篇章形式）。
|
||||
2. **再规划**：根据当前项目功能，列出「篇→章」目录草案，并列出配图清单（架构图、流程图、截图）。
|
||||
3. **执行**：按本规范创建 `9、手册/` 下 README、各篇文件夹、各章 .md；创建 `images/` 与 images/README.md；生成或采集图片并引用、登记。
|
||||
4. **校验**：是否每章有导航、是否所有图在 images/ 且已登记、README 总目录是否完整。
|
||||
|
||||
---
|
||||
|
||||
## 七、参考路径（卡若AI 主仓库）
|
||||
|
||||
- **使用手册总目录**：`/Users/karuo/Documents/个人/卡若AI/运营中枢/使用手册/README.md`
|
||||
- **配图索引示例**：`运营中枢/使用手册/images/README.md`
|
||||
- **单章示例**：`运营中枢/使用手册/第一篇_认识卡若AI/02_架构总览.md`（含图片引用与图题）
|
||||
@@ -1,11 +1,11 @@
|
||||
---
|
||||
name: 开发文档操控
|
||||
description: 操控采用「1～10 目录」的网站开发文档，实现调研、生成、更新、整合与复盘。每个网站项目可复制本 Skill 一份，将「开发文档路径」改为该项目路径即可按本能力操作该站开发文档。
|
||||
description: 操控采用「1～10 目录」的网站开发文档，实现调研、生成、更新、整合与复盘。每个网站项目可复制本 Skill 一份，将「开发文档路径」改为该项目路径即可按本能力操作该站开发文档。9、手册按卡若AI 使用手册结构（书籍式+图文+images）生成与维护。
|
||||
triggers: 开发文档操控/开发文档/1～10文档/网站开发文档/文档维护/开发文档维护
|
||||
owner: 火炬
|
||||
group: 火
|
||||
version: "1.0"
|
||||
updated: "2026-02-17"
|
||||
version: "1.1"
|
||||
updated: "2026-03-12"
|
||||
---
|
||||
|
||||
# 开发文档操控（火炬）
|
||||
@@ -38,7 +38,7 @@ updated: "2026-02-17"
|
||||
- **根目录**：仅保留一个 `README.md`，作为 1～10 索引入口；**全部文档归入 10 个目录**，根目录不散落其他文档。
|
||||
- **1～10 目录**：`1、需求` | `2、架构` | `3、原型` | `4、前端` | `5、接口` | `6、后端` | `7、数据库` | `8、部署` | `9、手册` | `10、项目管理`。
|
||||
- **入口文档**：`README.md`（1～10 索引）、`1、需求/卡若AI项目使用说明.md` 或该项目等价总览、`10、项目管理/开发文档使用指引（卡若交互式）.md`。
|
||||
- **手册**：`9、手册/使用手册（带图）.md`；配图放 `9、手册/images/`。
|
||||
- **手册**：使用手册按**卡若AI 使用手册结构**（README 总目录 + 篇/章多文件 + 附录 + 图文）；配图放 `9、手册/images/`，章节内引用，`images/README.md` 登记。规范见全栈开发「开发模板/9、手册/使用手册生成规范_卡若AI结构.md」。
|
||||
- **复盘**：迭代结尾用 `10、项目管理/迭代复盘模板.md`（卡若复盘格式）。
|
||||
|
||||
---
|
||||
@@ -64,7 +64,7 @@ updated: "2026-02-17"
|
||||
| 6、后端 | 后端开发规范 |
|
||||
| 7、数据库 | 数据库管理规范、数据设计 |
|
||||
| 8、部署 | 部署方案与脚本、Next 等自动化部署流程 |
|
||||
| 9、手册 | 使用手册（带图）、FAQ 详细、手册与落地方案提示词 |
|
||||
| 9、手册 | 使用手册（按卡若AI 结构：README+篇/章+附录+images 图文）、使用手册生成规范_卡若AI结构、使用手册提示词、FAQ 详细、落地方案提示词 |
|
||||
| 10、项目管理 | 项目落地执行表、迭代复盘模板、前端任务细项、开发文档使用指引、前端实施记录等 |
|
||||
|
||||
前端子任务按 `4、前端/前端开发流程（卡若式）.md` 与组件规格、检查清单执行；改需求/架构时同步更新接口、前后端、执行表（见使用指引 § 文档联动）。
|
||||
|
||||
@@ -8,6 +8,7 @@
|
||||
|
||||
| 日期 | 版本 | 变更说明 |
|
||||
|:---|:--:|:---|
|
||||
| 2026-03-12 | v2.2 | 全栈开发「9、手册」与卡若AI 对齐：新增开发模板 9、手册/使用手册生成规范_卡若AI结构.md（书籍式结构+图文+图片流程）；使用手册提示词、_智能展开 改为按卡若AI 结构书写并强制图文；全栈开发 SKILL 2.4、开发文档操控 SKILL 1.1 更新，使用手册一律按本结构生成，便于任意项目统一用同一 Skill 生成手册 |
|
||||
| 2026-03-12 | v2.1 | 配图与结构完善：新增 images/ 目录，同步人设/团队/核心功能/对话运转/记忆系统v3/基因胶囊概念与完整流程图共 7 张图；第2章架构总览、第5章第一次对话、第15章记忆系统、第16章基因胶囊写入图片引用与完整说明（四层记忆、自动化脚本、基因胶囊全功能介绍与 Mermaid 流程图）；README 增加手册目录结构与配图说明 |
|
||||
| 2026-03-12 | v2.0 | 手册重构为多文件书籍结构：6篇24章+4附录；按篇分子文件夹，每章独立 .md；覆盖全部架构、69技能、网站功能、运营规范、进阶用法 |
|
||||
| 2026-03-01 | v1.0 | 初版：单文件，目录+五组+运营中枢章节，与 SKILL_REGISTRY 对齐 |
|
||||
|
||||
@@ -319,3 +319,4 @@
|
||||
| 2026-03-12 23:23:58 | 🔄 卡若AI 同步 2026-03-12 23:23 | 更新：卡木、运营中枢工作台 | 排除 >20MB: 11 个 |
|
||||
| 2026-03-12 23:41:41 | 🔄 卡若AI 同步 2026-03-12 23:41 | 更新：水桥平台对接、总索引与入口、运营中枢、运营中枢工作台 | 排除 >20MB: 11 个 |
|
||||
| 2026-03-12 23:48:18 | 🔄 卡若AI 同步 2026-03-12 23:48 | 更新：水桥平台对接、运营中枢工作台 | 排除 >20MB: 11 个 |
|
||||
| 2026-03-12 23:58:33 | 🔄 卡若AI 同步 2026-03-12 23:58 | 更新：水桥平台对接、运营中枢、运营中枢工作台 | 排除 >20MB: 11 个 |
|
||||
|
||||
@@ -322,3 +322,4 @@
|
||||
| 2026-03-12 23:23:58 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-12 23:23 | 更新：卡木、运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |
|
||||
| 2026-03-12 23:41:41 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-12 23:41 | 更新：水桥平台对接、总索引与入口、运营中枢、运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |
|
||||
| 2026-03-12 23:48:18 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-12 23:48 | 更新：水桥平台对接、运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |
|
||||
| 2026-03-12 23:58:33 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-12 23:58 | 更新：水桥平台对接、运营中枢、运营中枢工作台 | 排除 >20MB: 11 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |
|
||||
|
||||
Reference in New Issue
Block a user