# skills 详细内容 ## 通用函数封装 ### 简单文本文档 适用于报告、记录、会议纪要等。使用符号标记章节。 ```python def create_simple_doc(doc_name: str, content: str) -> dict: """ 创建简单文本文档 Args: doc_name: 文档名称 content: 文档内容（使用【】标记章节） Returns: dict: {"docid": "xxx", "url": "https://..."} Example: content = '''项目周报 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 【本周完成】 1. 完成用户模块开发 2. 修复登录bug 【下周计划】 1. 开始订单模块 2. 编写测试用例 ''' result = create_simple_doc("2026年第5周周报", content) """ token = get_access_token() # 1. 创建文档 create_url = f"https://qyapi.weixin.qq.com/cgi-bin/wedoc/create_doc?access_token={token}" create_resp = requests.post(create_url, json={ "doc_type": 3, "doc_name": doc_name }).json() if create_resp.get("errcode") != 0: return create_resp docid = create_resp["docid"] doc_url = create_resp["url"] # 2. 写入内容 update_url = f"https://qyapi.weixin.qq.com/cgi-bin/wedoc/document/batch_update?access_token={token}" update_resp = requests.post(update_url, json={ "docid": docid, "requests": [{ "insert_text": { "text": content, "location": {"index": 0} } }] }).json() return { "errcode": update_resp.get("errcode", 0), "docid": docid, "url": doc_url } ``` ### 合同类文档（带标题样式） 适用于合同、协议等需要标题层级的正式文档。 ```python import time def create_contract_doc(doc_name: str, sections: list) -> dict: """ 创建带标题样式的合同文档 Args: doc_name: 文档名称 sections: 内容列表，格式 [(文本, 标题级别), ...] 标题级别: 1=主标题, 2=章节标题, 0=正文 Returns: dict: {"docid": "xxx", "url": "https://..."} Example: sections = [ ("物流服务合同", 1), ("合同编号: WL-2026-0201", 0), ("", 0), ("甲方（托运方）", 2), ("公司名称: xxx公司", 0), ("", 0), ("第一条 服务内容", 2), ("1.1 服务类型：货物运输", 0), ("1.2 货物类型：xxx", 0), ] result = create_contract_doc("物流服务合同-甲方与乙方", sections) """ token = get_access_token() # 1. 创建文档 create_url = f"https://qyapi.weixin.qq.com/cgi-bin/wedoc/create_doc?access_token={token}" create_resp = requests.post(create_url, json={ "doc_type": 3, "doc_name": doc_name }).json() if create_resp.get("errcode") != 0: return create_resp docid = create_resp["docid"] doc_url = create_resp["url"] # 2. 倒序内容（因为每次在位置0插入） reversed_sections = list(reversed(sections)) # 3. 分批插入（每批最多25个，留余量） update_url = f"https://qyapi.weixin.qq.com/cgi-bin/wedoc/document/batch_update?access_token={token}" batch_size = 25 for i in range(0, len(reversed_sections), batch_size): batch = reversed_sections[i:i+batch_size] requests_list = [] for text, level in batch: para = {"elements": [{"text_run": {"content": text}}]} if level > 0: para["paragraph_style"] = {"heading_level": level} requests_list.append({ "insert_paragraph": { "location": {"index": 0}, "paragraph": para } }) resp = requests.post(update_url, json={ "docid": docid, "requests": requests_list }).json() if resp.get("errcode") != 0: return { "errcode": resp.get("errcode"), "errmsg": resp.get("errmsg"), "docid": docid, "url": doc_url } time.sleep(0.3) # 避免频率限制 return { "errcode": 0, "docid": docid, "url": doc_url } def build_contract_sections( title: str, party_a: dict, party_b: dict, clauses: list, signature: bool = True ) -> list: """ 构建合同内容结构 Args: title: 合同标题 party_a: 甲方信息 {"name": "", "code": "", "address": "", "phone": "", "legal_rep": ""} party_b: 乙方信息，格式同上 clauses: 条款列表 [{"title": "第一条 xxx", "items": ["1.1 xxx", "1.2 xxx"]}, ...] signature: 是否包含签章栏 Returns: list: 可直接传给 create_contract_doc 的 sections """ sections = [] # 标题 sections.append((title, 1)) sections.append(("", 0)) # 甲方 sections.append(("甲方", 2)) if party_a.get("name"): sections.append((f"公司名称: {party_a['name']}", 0)) if party_a.get("code"): sections.append((f"统一社会信用代码: {party_a['code']}", 0)) if party_a.get("address"): sections.append((f"地址: {party_a['address']}", 0)) if party_a.get("phone"): sections.append((f"联系电话: {party_a['phone']}", 0)) if party_a.get("legal_rep"): sections.append((f"法定代表人: {party_a['legal_rep']}", 0)) sections.append(("", 0)) # 乙方 sections.append(("乙方", 2)) if party_b.get("name"): sections.append((f"公司名称: {party_b['name']}", 0)) if party_b.get("code"): sections.append((f"统一社会信用代码: {party_b['code']}", 0)) if party_b.get("address"): sections.append((f"地址: {party_b['address']}", 0)) if party_b.get("phone"): sections.append((f"联系电话: {party_b['phone']}", 0)) if party_b.get("legal_rep"): sections.append((f"法定代表人: {party_b['legal_rep']}", 0)) sections.append(("", 0)) # 条款 for clause in clauses: sections.append((clause["title"], 2)) for item in clause.get("items", []): sections.append((item, 0)) sections.append(("", 0)) # 签章 if signature: sections.append(("签章", 2)) sections.append(("", 0)) sections.append((f"甲方（盖章）: {party_a.get('name', '')}", 0)) sections.append(("法定代表人/授权代表：________________", 0)) sections.append(("日期：________________", 0)) sections.append(("", 0)) sections.append((f"乙方（盖章）: {party_b.get('name', '')}", 0)) sections.append(("法定代表人/授权代表：________________", 0)) sections.append(("日期：________________", 0)) return sections ``` ### 使用示例 #### 简化示例 ```python # 简化示例：使用占位符 party_a = {"name": "甲方公司名称", "code": "甲方税号"} party_b = {"name": "乙方公司名称", "code": "乙方税号"} clauses = [ {"title": "第一条 服务内容", "items": ["1.1 xxx", "1.2 xxx"]}, {"title": "第二条 服务期限", "items": ["2.1 xxx"]}, ] sections = build_contract_sections("合同标题", party_a, party_b, clauses) result = create_contract_doc("合同文档名称", sections) ``` #### 完整示例 ```python # 完整示例：创建物流合同 party_a = { "name": "重庆妗晨工贸有限公司", "code": "91500104MA7EJTPA6D", "address": "重庆市大渡口区跳磴镇海康路106号1-1", "phone": "15213397998" } party_b = { "name": "北京名风新能源科技有限公司", "code": "91110106092440790K", "legal_rep": "魏小健" } clauses = [ { "title": "第一条 服务内容", "items": [ "1.1 服务类型：货物运输配送服务", "1.2 货物类型：今麦郎系列产品", ] }, { "title": "第二条 服务期限", "items": [ "2.1 合同有效期：自 2026年2月1日 至 2027年1月31日", ] }, { "title": "第三条 运费标准", "items": [ "3.1 运费标准：今麦郎产品 2.50 元/件", "3.2 结算周期：月结", ] } ] # 构建并创建文档 sections = build_contract_sections("物流服务合同", party_a, party_b, clauses) result = create_contract_doc("物流服务合同-妗晨与名风", sections) print(f"文档链接: {result['url']}") ``` ---