CRITICAL — 开始前 MUST 先用 Read 工具读取 ../weaver-e10-shared-connector/SKILL.md,其中包含安装、E10 认证、JSON 输出和高风险写入规则。该文件由连接器随包提供,读取失败时必须停止执行;不要自行安装 CLI 或 Skill。
认证和登录态只能按共享规则通过 weaver-work-cli auth ... 命令判断;禁止直接读取、列出、打印或解析用户主目录下的旧 .e10-cli、auth、config 或 Keychain 数据。
登录与请求头凭证契约
本 Skill 是 CLI 型技能,不自行发起 HTTP 请求:认证与会话统一由连接器托管(即 weaver-work-cli auth ...),禁止自建或绕过登录流程。CLI 调用 E10 接口时按契约注入以下三项用户信息,缺一不可:
接口请求头(由 CLI 注入,Agent 不手写):
Cookie: <登录返回的完整原始 Cookie 串> # 禁止裁剪、去重或改写
eteamsid: <登录返回的 ETEAMSID>
User-Agent: AgentType=<agentType>,IsAgent=true
| 凭证 | 取值与要求 |
|---|---|
Cookie |
登录返回的完整原始 Cookie 串,禁止裁剪、去重或改写 |
eteamsid |
登录返回的 ETEAMSID |
User-Agent |
AgentType=<agentType>,IsAgent=true |
Agent 不得自行拼接、改写或向用户索取上述凭证(禁止要求用户贴 Cookie / ETEAMSID / token),也不得直接 curl / fetch E10 接口。
所有命令通过 weaver-work-cli --profile eteams --json archive run <operation> 执行:简单 JSON 优先传 --input-json '<json>',复杂或多行 JSON 先写入 UTF-8 文件再传 --input <path>,只有确认当前 shell 能稳定传管道时才使用 --input -。调用前先按需读取 references 下对应的文件,查参数结构,不要猜字段;references 是第一信息源,weaver-work-cli archive schema 是 operation、字段和风险等级的合约来源。
命令示例、提示词和临时说明必须同时兼容 Windows 和 macOS/Linux;涉及 JSON 输入、用户目录、路径分隔符、Python 启动器、文件删除、目录查看或文件比对时,同时给 Windows PowerShell 与 macOS/Linux(bash/zsh)两套示例。Agent 先根据当前系统和 shell 选择对应示例,不确定时用 node -p "process.platform" 判断。Windows/PowerShell 下不要使用 printf、$HOME/...、~/...、bash 反斜杠续行、rm/ls/diff/python3 等 Unix-only 写法。
涉及档案附件、图片、本地文件、借阅原文 zip 或文件上传的操作,执行前必须提醒用户:文件内容可能被上传到 E10 文书定档案系统、文件服务器或下载到本地磁盘,并可能进入当前大模型上下文用于理解和处理;必须等待用户明确确认后才继续。
泛微E10文书定档案管理
认证与请求头契约
登录与会话由 E10 登录能力统一提供:文档型约定为 weaver-e10-login 技能;连接器场景下由连接器完成授权(weaver-work-cli auth login),业务命令统一通过 --profile eteams 读取该登录态。业务 Skill 不自建登录流程,不索取、打印或转存任何凭证。
CLI 发往 E10 的每个请求都自动携带以下三项用户信息参数,缺一不可(业务入参里不要传这些字段,也不要手工拼装请求头):
Cookie: <weaver-e10-login 返回的完整原始 Cookie 串,原样透传,禁止裁剪/去重/改写>
eteamsid: <weaver-e10-login 返回的 ETEAMSID>
User-Agent: AgentType=<agentType>,IsAgent=true
路由优先级(先判断是不是文书定档案,再选 operation)
文书定档案不是通用 E10 对象。只要用户的核心对象是档案、全宗、借阅车、借阅单、档案借阅/续借或预归档上传,就优先使用 weaver-e10-wenshuding-connector。
明确归 weaver-e10-wenshuding-connector 的高优先级语义
出现以下任一语义时,优先走本 Skill:
- 文书定 / 档案 / 全宗 / 收集库 / 管理库 / 预归档库 / 电子文件库
- 档案检索 / 全文检索 / 可借档案 / 档号 / 案卷 / 保管期限 / 密级 / 库位
- 借阅车 / 加入借阅车 / 我的借阅车
- 借阅单 / 我的借阅 / 借阅记录 / 续借 / 归还期限
- 档案下载 / 原文下载 / 借阅单打包 / 水印件
- 发起借阅 / 借阅申请 / 借阅流程
- 预归档上传 / 电子文件上传 / 归档入库
判定规则: 只要最终动作是对文书定档案做查询、检索、加入借阅车、查看借阅单、下载原文、发起借阅/续借或预归档上传,就归 weaver-e10-wenshuding-connector。只有当用户处理的是非档案类 E10 业务、通用工作流或尚未封装的档案能力时,才不使用本 Skill。
选哪个命令
| 想做什么 | 命令 | 按需读取 reference |
|---|---|---|
| 查看可用 operation、字段和风险等级 | archive schema |
archive-agent-entry.md |
| 查询全宗 / 预归档电子文件库节点 | archive run archive.fonds.list / archive.prelib.tree |
archive-fonds.md |
| 全文检索可借档案(默认卡片视图展示) | archive run archive.search.run |
archive-search.md |
| 查看档案基本信息 | archive run archive.info.get |
archive-info.md |
| 查看借阅车 | archive run archive.borrow-car.list |
archive-borrow-car.md |
| 加入借阅车(免确认) | archive run archive.borrow-car.add |
archive-borrow-car.md |
| 查看借阅单 / 详情 | archive run archive.borrow-list.list / .detail |
archive-borrow-list.md |
| 下载借阅单原文 | archive run archive.borrow-list.download.prepare/apply |
archive-download.md |
| 从借阅车发起借阅 | archive run archive.flow.borrow-car.prepare/apply |
archive-flow.md |
| 从检索结果发起借阅 | archive run archive.flow.search.prepare/apply |
archive-flow.md |
| 借阅单续借 | archive run archive.flow.renew.prepare/apply |
archive-flow.md |
| 上传到预归档电子文件库 | archive run archive.upload.prelib.prepare/apply |
archive-upload.md |
| 借阅提交、借阅车移除、归还/催还等未暴露能力 | 无可用命令 | archive-disabled-capabilities.md |
处理链:
- 检索并借阅:
archive.search.run-> 用户选择条目 ->archive.borrow-car.add(免确认直接加入)-> 需要时archive.borrow-car.list复核 - 从借阅车发起借阅:
archive.borrow-car.list取arcDangan与dataId->archive.flow.borrow-car.prepare-> 用户确认 ->.apply-> 用系统默认浏览器打开返回的流程创建页 URL(仅用户强调内置打开时用 IDE 内置视图) - 从检索结果直接发起借阅:
archive.search.run取id+formId->archive.flow.search.prepare-> 用户确认 ->.apply-> 同上默认系统浏览器打开 URL - 续借:
archive.borrow-list.list取dataId->archive.flow.renew.prepare-> 用户确认 ->.apply-> 同上默认系统浏览器打开 URL - 下载原文:
archive.borrow-list.list取dataId->archive.borrow-list.download.prepare(校验未超期且有可下载原文)-> 用户确认 ->.apply(轮询打包并落盘) - 预归档上传:
archive.fonds.list取全宗id-> 需要时archive.prelib.tree取treeId->archive.upload.prelib.prepare-> 用户确认 ->.apply
执行原则(减少误路由、误重试和无效消耗)
1) 先拿最小必要信息,再执行
- 只是查列表时,优先直接用
archive.borrow-car.list/archive.borrow-list.list,默认小页(pageSize=10) - 用户没有要求全量时不要自动翻完整列表
- 用户已给出
dataId时,不要先查列表再过滤,直接用archive.borrow-list.detail或对应 prepare - 全宗
id与电子文件库treeId只在预归档上传前查一次,同轮内复用;检索、借阅车、借阅单、下载等流程不需要查询全宗,已有展示位置里的全宗信息照常显示
1.5) 大结果只摘要给用户
- 当前 CLI 会把完整 JSON envelope 写 stdout;Agent 回复时不要原样贴完整 JSON
- 全文检索结果的默认返回展示样式 = 「卡片视图」,与
weaver-work-cli --profile eteams archive search --format card(或archive search --key <词> --format card)输出保持一致;除用户明确要求其他样式(text / html / 表格)外,一律按卡片视图返回,禁止退化成普通表格或贴 JSON:- 每条固定三段:
序号. 【类型】 可点击题名链接+ 空行 + 命中高亮摘要 + 空行 +全宗 / 分类 / 日期;标题必须是可点击的档案视图链接(域名取当前 baseUrl) - 最多先给前 10 条;不要把
dataId、formId、arcDangan等内部 ID 作为展示内容,它们只用于后续 operation 入参 - Agent 需要卡片时优先直接调用
archive search ... --format card拿渲染结果,避免手工拼字段
- 每条固定三段:
- 借阅车 / 借阅单列表的默认返回展示样式 = 「Markdown 表格」(与检索的卡片视图区分开),除用户明确要求其他样式外一律用表格渲染:
- 借阅车表格列:
序号 / 题名 / 类型(className) / 分类(categoryNames) / 形成日期(fileDate);借阅单表格列:序号 / 题名 / 借阅时间 / 归还时间 / 归还状态 / 是否超期 - 各列取对应 operation 返回的可读字段;不要把
dataId、workflowId、arcDangan等内部 ID 放进展示,它们只用于后续操作入参 - 表格样式:分隔行统一
| :---: |(表头与各列内容都居中显示);序号列只放1/2… 纯序号,不放其他说明 - 最多先给前 10 条;列数多时可只保留用户关心的关键列,题名超长时省略号截断
- 借阅车表格列:
- 超长响应优先落本地文件并向用户提供摘要和文件路径
2) 已知对象时直达动作
- 已拿到
dataId、档案标识或本地文件路径时,优先调用对应 operation - 同一轮里已有足够的新鲜查询结果时,不要重复查询同一列表或同一详情
- 不要默认走
list -> detail -> prepare -> apply全链路;对象已明确时应压缩步骤
3) 错误语义驱动,而不是盲目重试
- 失败后先看进程退出码、
error.type、error.subtype和error.message - 除非错误明确提示可恢复或需要补充参数,否则不要重复刷同一个 operation
- 写请求已经发出后,遇到结果不确定必须停止;不要把
.apply当成可重试读操作 - 下载是异步任务,
.apply会持续轮询进度;不要因为等待时间长就中断重放 - 错误为
authentication或session_expired时:立即停止当前操作,不要用示例占位域名或自行猜域名登录,也不要盲目重试。先读取共享规则../weaver-e10-shared-connector/references/e10-auth-and-session.md,按其中流程引导用户断开并重新连接本连接器完成重新登录,然后再继续原操作。
4) 附件、图片和文件解析确认
- 执行
archive.upload.prelib.prepare/apply、archive.borrow-list.download.prepare/apply,或任何会读取本地文件、上传文件内容、下载借阅原文 zip、解析图片/PDF/OFD 的步骤前,必须先提醒用户文件内容可能进入大模型上下文,也可能发送到 E10 文书定档案系统或文件服务器,或落到本地磁盘。 - 用户未明确确认前,不要运行上传、下载或解析命令。
写操作失败处理:partial/write_uncertain 决策树
当加入借阅车、发起借阅/续借、下载或上传返回 partial/write_uncertain,或提示网络中断、部分成功、回查失败、回查字段不一致时,按下面规则处理:
- 先停止盲目重试,不要连续重复提交相同
.apply - 优先从以下角度解释:
- 写请求可能已经到达服务端,但连接在结果确认前中断
- 服务端可能只处理了部分档案或只完成了部分上传步骤
- 异步打包任务可能仍在后台进行,重新提交会再起一个任务
- continuation、目标文件、目标借阅单或登录上下文可能已经变化
- 如需确认,只补 一次 只读查询(例如
archive.borrow-car.list或archive.borrow-list.detail),不要陷入 query/write 循环 - 最终给用户明确结论、已知状态、成功/失败项和下一步人工确认建议,而不是继续无意义重试
特别注意: 上传和下载最容易因重复提交造成重复入库或重复打包,更要严格执行上述规则。
Windows PowerShell:
weaver-work-cli --profile eteams archive schema
weaver-work-cli --profile eteams --json archive run archive.fonds.list --input-json '{"menuSign":"collectLib"}'
weaver-work-cli --profile eteams --json archive run archive.search.run --input-json '{"key":"会计凭证","pageNo":0,"pageSize":10}'
weaver-work-cli --profile eteams --json archive run archive.borrow-car.list --input-json '{"pageNo":1,"pageSize":10}'
weaver-work-cli --profile eteams --json archive run archive.borrow-car.add --input-json '{"formAndIds":[{"formId":"1190991330335571989","ids":["1252600626189156465"]}]}'
weaver-work-cli --profile eteams --json archive run archive.borrow-list.download.prepare --input-json '{"dataId":"1302806508947652629"}'
weaver-work-cli --profile eteams --json archive run archive.flow.borrow-car.prepare --input-json '{"arcIds":["1252600626189156465_1190991330335571989"],"carIds":["1302754028599656449"]}'
weaver-work-cli --profile eteams --json archive run archive.upload.prelib.prepare --input-json '{"file":"./档案.pdf","fondsId":"1042286256822697531"}'
macOS/Linux(bash/zsh):
weaver-work-cli --profile eteams archive schema
weaver-work-cli --profile eteams --json archive run archive.fonds.list --input-json '{"menuSign":"collectLib"}'
weaver-work-cli --profile eteams --json archive run archive.search.run --input-json '{"key":"会计凭证","pageNo":0,"pageSize":10}'
weaver-work-cli --profile eteams --json archive run archive.borrow-car.list --input-json '{"pageNo":1,"pageSize":10}'
weaver-work-cli --profile eteams --json archive run archive.borrow-car.add --input-json '{"formAndIds":[{"formId":"1190991330335571989","ids":["1252600626189156465"]}]}'
weaver-work-cli --profile eteams --json archive run archive.borrow-list.download.prepare --input-json '{"dataId":"1302806508947652629"}'
weaver-work-cli --profile eteams --json archive run archive.flow.borrow-car.prepare --input-json '{"arcIds":["1252600626189156465_1190991330335571989"],"carIds":["1302754028599656449"]}'
weaver-work-cli --profile eteams --json archive run archive.upload.prelib.prepare --input-json '{"file":"./档案.pdf","fondsId":"1042286256822697531"}'
不在本 skill 范围
- 禁止加载原始接口文档版 Skill 代替 CLI;本 Skill 通过
weaver-work-cli执行业务操作。 - 禁止 curl、fetch、浏览器自动化或直接访问 E10
/api/archive/**、/api/ebuilder/**、/api/file/**。 - 禁止读取或复制 CLI runtime 内部 Token、Cookie、ETEAMSID。
- 禁止读取、列出、打印或解析用户主目录下的旧
.e10-cli、auth、config 或 Keychain 数据。 - 借阅申请表单提交、借阅车移除、归还/催还等能力当前未纳入 CLI manifest;需要先在页面操作或使用流程创建页 URL。
- 非档案类 E10 能力、通用流程编排、非文书定的表单/审批/组织等业务不由本 Skill 承载。