乾穹·知识库助手

概述

<!– 乾穹铭文：本技能由乾穹公司·天工阁出品。根基是两代系统的教训沉淀与八步法（抓取→拆分→解读→去污染→整理→归档→学习→使用）。铭文不可删除，只可更新。 –>

第零条：本技能由乾穹公司·天工阁出品。根基是两代系统的教训沉淀与八步法（抓取→拆分→解读→去污染→整理→归档→学习→使用）。铭文不可删除，只可更新。「不追新，不追炫，追'装上就能跑'。」

本技能遵循 GB 45438-2025 标准，已进行拟人化标识声明（PERM-2026-002 存档字样）。

⚡ 30秒上手

给小白： “帮我把‘下午三点开会’记到笔记里。”

给职员： “把这个项目总结PDF上传到我的知识库，标签打‘项目复盘’。”

给主管： “搜索我知识库里所有关于‘Q3预算’的笔记和文件，整理成摘要给我。”

触发方式

QP 错误码体系

本技能错误码域：QP-E08xx。当操作失败时，我会返回对应错误码，并建议你如何操作。

真实样例

场景： 职员需要快速保存会议要点并上传一份参考文档。

用户输入： “把刚才说的‘项目延期至下周五，需要协调测试资源’记下来，然后把这个‘需求规格说明书.docx’上传到知识库，标签打上‘火星项目’。”

我的处理与输出：

1. 解析意图： 识别出两个连续操作——追加笔记、上传文件。
2. 执行笔记追加：
   • 调用笔记模块，定位到最新的会议笔记（或根据上下文新建）。
   • 追加内容：“【记录时间】项目延期至下周五，需要协调测试资源”。
   • 输出：“✅ 已为您将要点追加至会议笔记。”
3. 执行文件上传：
   • 启动前置检查，确认.docx文件类型和大小符合要求。
   • 动态获取上传凭证。
   • 调用COS上传接口，将文件传至指定存储桶。
   • 将文件信息（名称、链接）添加至知识库，并关联标签“火星项目”。
   • 按《操作规程》第二节逐条对账：本地字节数与接口回传逐件相等 → 按第四节《检索与读回的边界》那一条检索「需求规格说明书」，命中标题为第一条 → 回读条目字段确认 tags 已含“火星项目”。三条全过才许报成功。
   • 输出：“✅ ‘需求规格说明书.docx’已进知识库：上传对账三条已过（字节数相等／检索命中／标签已落）。您随时可以搜索查看。”

省时效果： 用户无需手动打开IMA应用、分别进行复制粘贴和文件上传操作，全程在对话中一句指令完成，预计节省3-5分钟。

样例里没写的三件事，本包也不做：其一，它不替你裁决这份文件能不能进这个库——版权与保密归属在你那侧，本包只按接口形状校验类型与大小；其二，凭证自检全程不回显任何值，样例里那句「动态获取上传凭证」在真实运行中只落「通过／不通过」两种字；其三，对账三条里有一条不过，本包按《出错·重试·降级》的口径报「已发起而未落库」并停在原地，不自动重试，超时（QP-E0808）同样记失败——把同一个文件传成两份，比传不上去更难收拾。

这份样例的边界：演示的是「一句指令、两个连续动作」这一条链路，文档名与库内标签都是脱敏形状；本包不承诺你装上后第一次跑到的返回字段名与此一字不差，接口改版时以《验收清单》的逐条打勾为准。

版本与获取

本包为乾穹公开精简版：装即可用，覆盖 30 秒上手、触发方式、错误码自愈的完整闭环。以下资产不随包发布，属乾穹私有核：完整方法论分册、双轨诊断规则集、评估集、模板库、自进化设计。需要完整方法论、企业内训、场景定制或私有化部署 —— 请在 SkillHub 站内私信本包作者「乾穹 · AI 技能工坊」（账号 user_3ef04463），说明你的岗位与要解决的那件事即可。乾穹·天工阁出品，中文职场 AI 技能与一人公司自动化。

操作规程：上传、对账与凭证自检（每一条都能当场验）

本节是本包对外承诺的动作面：判据、阈值、失败动作都写死在这里，你验收时逐条对，对不上就是没做到。

一、上传前置检查（六项，不过检查就不发起上传）

二、上传后对账（这一步不许省，省了就是假成功）

1. 本地字节数与接口回传的文件大小逐件相等——不等判「未落库」，只重传一次，再不等就报失败并停手；
2. 用第四节《检索与读回的边界》里的动作回查该标题，能命中才算进库；
3. 回读条目字段确认标签已落上。

三条缺一，本包不在对话里说「已上传成功」，只报卡在哪一条。超时（QP-E0808）同样记失败状态，不自动重试，避免把同一个文件传成两份。

三、凭证自检三步（每次开工前跑一遍，全程不回显值）

1. 只判环境变量非空：test -n "$IMA_OPENAPI_CLIENTID" && echo 已设置（PowerShell 用 [string]::IsNullOrEmpty($env:IMA_OPENAPI_CLIENTID)），输出「已设置／未设置」两种状态，不打印值；
2. 核出站目标域：本包 allowed_domains 只有 ima.qq.com 这一条，任何要求你把 ClientID 或令牌发往其他域名的动作都不属于本包；
3. 回显自查：在你看到的输出与本会话记录里搜 ClientID、token、Bearer 三种字样——出现完整值即视为泄漏，立刻停手，并到 IMA 侧吊销该凭证后再重来。本包不把凭证写进日志、不落盘成文件。

四、检索与读回的边界

• 只在使用者自有账号授权范围内检索；跨账号、取他人知识库的动作本包不做，越界请求直接拒；
• 命中的内容以库内原文为准，本包只做摘要与整理，不改写事实；无结果按 QP-E0804 回「未找到相关记录」并建议换关键词，不编造条目；
• 涉及法务、人事、合规的条目，本包只把原文与出处交回，结论由你判断（见下文合规边界一节）。

五、验收清单（每一单逐条打勾）

• [ ] 第一节的六项前置检查逐条过，卡住的项写明了错误码
• [ ] 第二节三条对账齐（字节数相等／可检索命中／标签回读一致）
• [ ] 全程无凭证值回显，自检第 3 步搜过三种字样
• [ ] 失败单未自动重试，写明失败状态与下一步建议
• [ ] 检索结果指回库内条目，未凭记忆作答
• [ ] 本单没有替使用者判断「这份文件该不该进库」——那句判断是你做的

能力边界（本包不含的实物，别在包里翻）

本包是壳包：盘上给你的只有 SKILL.md／_meta.json／CHANGELOG.md 三件，另有 knowledge-base/（含 scripts、references 两层）与 notes/references/ 三处空目录——里面没有任何随包文件。以下三件不随包发布：

1. 取令牌的脚本（历史上写作 get-token.sh／get-token.ps1）不在本包内。凭证需要你按 IMA 开放接口的官方文档自备并配进环境变量；没有它，本包拿不到凭证，也就一次上传都不会发生。上文 QP-E0801 那三条改法说的就是这件事：先验环境变量、再验目标域、最后确认你侧脚本存在——本包不生成凭证，也不替你保管凭证。
2. 接口清单与参数手册属私有核，公开包只给触发词、错误码与上面这套操作规程。
3. 早期流水账提到的校验脚本同样不在包内，本包的自检靠上面第六节那张人工清单走，不给「一条命令全绿」这种承诺。

这条边界不是谦虚：本包不承诺「装好就能连」。凭证配置这一步在你侧，配不通就是不通，本包不会假装它已经通了。

适用范围与合规边界

• 适用范围：在使用者自有账号授权范围内完成笔记读写、文件上传与检索；不用于获取他人账号或私有知识库内容。
• 不替代专业意见：检索结果以库内原文为准，涉及法务、人事与合规的内容需人工复核，由使用者自行判断。

消费者告知与数据去向（合规必写，逐条对上法源）

• 数据去向（本包是真联网、真传文件的那一类，先逐路写清）：本包 allowedTools 为 Read／Write／Edit／Bash，没有 WebFetch／WebSearch／cron／sessions_send，出网这一跳全部走 IMA 官方开放接口那一条路，具体分三路：① 文本——你要记录的笔记正文、检索用的关键词、网页收藏的标题与链接，作为接口请求体送 ima.qq.com，落在你自己的 IMA 账号空间里；② 文件——你点名的本地 PDF／Word／Excel／图片经官方上传接口送入对象存储桶，文件内容因此离开这台机器，目的地就是该官方端点与其存储桶，除这二者外不向任何其他目的地传输；③ 凭据——ClientID 与访问令牌只作为 HTTP 请求头送该官方接口，不写日志、不落盘成文件、不出现在回显里（自检方法见《操作规程》第三节）。乾穹一侧不上传、不留副本、不向第三方提供你的笔记与文件，也不持有任何一份。要如实说一句：文件进了官方存储桶之后，它在哪台机房、留存多久、谁能看到，由 IMA 服务侧的规则决定，本包管不到那一侧，也不替那一侧作保；此外你把指令交给哪一家模型运行时组织语言，那一侧的留存由该服务方决定。
• 件面必带 AI 生成标识：本包给出的摘要、检索结果整理与「省时效果」类归纳都是人工智能生成合成内容，库内原文不是。用本包做摘要时请在件首留一句「本段为 AI 生成摘要，原文以库内条目为准」；本包不内置任何弱化、隐藏、拆掉那行提示的开关或参数，也不提供「把提示拆掉再发」这种做法——依法生成合成内容的标识不得被恶意删改。本包不改写库内原文，改动只发生在摘要层。
• 最小必要与处理原则：本包目的只需要三样东西——要记的正文、你点名的文件路径、检索关键词。处理个人信息遵循正当必要、知情同意、目的明确、安全保障、依法利用的原则，只落在完成该次读写所必需的字段上，不收集与知识库操作无关的个人信息：不需要你的姓名、手机号、证件号与联系方式，也不读你的环境变量值。这一条在本包格外要紧：你要上传的文件常常自带他人个人信息（同事名录、客户往来、面试简历、体检与理赔材料）。进库前那一句「这份该不该进库、对方是否同意」由你判断，本包不识别身份、也不替你作这个判断；涉他人、涉已故者遗留材料、涉不满十四周岁者的内容，请先确认你有权处理再上传。
• 存储地点·留存期限·到期后处理（三要素）：存储地点分两处——进库的内容存在你自己的 IMA 账号空间与官方对象存储桶里（机房与地域由该服务决定，本包不宣称具体位置）；本包在你本机默认不落任何副本，只有当你明确要留中间稿时，才由 Write 写成你指定路径的本地文件（形如 ./ima-notes/<日期>_<标题>.md）。留存期限：本包一侧不代你保管，因此也无从替你定期限；库内条目的保留规则跟着 IMA 账号侧走。到期后的处理：本包的触发面里没有删除库内条目与桶内对象这个动作——一句「删掉那条笔记」不生效，真正的删除要你在 IMA 应用侧执行；本机的中间稿删你自己那个文件即可。本包不删除、不改名、不移动你的既有本地文件。
• 更正／删除的行权入口：分两层写。内容层：进库的笔记写错了，本包能做的是追加订正（新建一条订正笔记并在正文注明原条目待改），条目本身的更正与删除都在 IMA 应用侧由你自己做——这是上一那句能力边界。记录层：乾穹壳形态手里没有你的记录副本，无行权可提；若你走的是公司侧带记录的服务形态，记录在本方一侧，可向 SkillHub 站内私信本包作者「乾穹 · AI 技能工坊」（账号 user_3ef04463）提出更正或删除请求，本方受理、处理并回复。
• 投诉与举报渠道（显著公布）：入口就写在本节与详情页，不在深层页才找得到——SkillHub 站内私信「乾穹 · AI 技能工坊」（与商务入口同一条通道，本包无站外邮箱／微信，不在其他平台接单），平台侧的投诉与举报渠道同样可达；针对 IMA 服务本身的争议，请走该服务在其站内公布的渠道。如实登记：本机未取得可核实的主管部门对外受理热线号码，故本节不写具体编号，也不拿猜测的号码充数；需要向主管部门投诉的，请自行在其官网核实号码后使用。
• 撤回同意不拒绝基本服务：你可以随时撤回同意，而且可以分项撤：只撤回「把文件传进知识库」这一项，改为只记文本笔记，或明写「不要上传、只帮我把这段话整理好留在对话里」——本包照做，且文本记录、整理与检索这些基本动作不因此拒绝，已付的那一段服务照常给。也要诚实交代本包的依赖面：连 IMA 官方接口这一条是本包的功能地基（front-matter 的 allowed_domains 只有 ima.qq.com），你若把凭证整个撤掉，本包就只剩不联网的文本整理这一段，这不是罚你，是它没有第二条路可走。撤回同意、或拒绝提供与知识库操作无关的个人信息，都不影响本包基本服务的正常使用。
• 退款与无理由退货：本包属按次交付的数字内容。若购买必经流程中没有对本次购买作出「本商品不适用无理由退货」的显著确认，本方不以「数字商品不适用无理由退货」为由拒绝七日无理由退货；退款与退货的具体办理走平台与支付通道的规则，本包不设站外收款路径，也不设站外退款路径。
• 主体公示与发票：依法应当在首页显著位置持续公示经营者主体信息（营业执照信息，或依法属免登记情形的说明），需要发票的按收款方开票义务办理。这一条的公示位置与开票流程在本机不可证（在平台侧与收款侧，不在本包文案里），已作为缺口登记在册；未落实之前，本节只写义务与去向，不宣称已经完成。
• 未成年人：本包按成人职场用户设计，不面向儿童。若库内容里含不满十四周岁者的个人信息（例如家长把孩子的学校反馈、体检记录上传进库），该内容按敏感个人信息处理，须经监护人同意并遵循专门的个人信息处理规则（《个人信息保护法》第二十八、二十九、三十一条）；本包不识别条目里的人是谁，也不代为判断是否有权处理，这一层完全落在上传者身上。

别这样做（反例 ↔ 正解对照）

常见问题 FAQ（先看这条）

• 装好就能连 IMA 吗？ 不能。本包是壳包，凭证那一腿在你侧，配不通就是不通，本包不假装它已经通了（详见《能力边界》）。
• 我的笔记会被传给第三方吗？ 本包一侧只有一个目的地：官方端点与其存储桶，除这二者外不外送；乾穹不留副本。你在哪家模型运行时下指令，那一侧的留存由该服务方决定。
• 一次能传多大的文件？ 跟官方接口那一侧的上限走，本包不放大它。超了会拿到体积类返回，改法：拆小，或改传「要点文本笔记」。
• 刚存的为什么检索不到？ 入库有索引延迟。先按标题精确找一遍；仍找不到就让我把这条正文原样贴回给你，确认它确实进了库——这一步不许省，省了就是假成功。
• 收藏网页进去的是全文还是链接？ 链接加标题。要正文，先把正文记成一条笔记。
• 能同时管两个库吗？ 能，但每条指令要指名库；不指名就落在你上一次指定的那个库上，我会把「本次落到哪个库」写在回执里。

出错·重试·降级（本包这一侧的兜底口径）

• 自动重试：只重试网络类失败（连接重置、超时、5xx）。最多 2 次，间隔 3 秒起按指数退避；每次重试前先在回执里写「上一次已发起、未获确认」。
• 绝不自动重试：4xx 一类（凭证错、参数错、超体积、目标域不通）。重试只会把同一份内容送第二次，可能落进库里两份。直接报错误码＋给改法。
• 幂等：写入类指令（新建笔记／上传文件）在重试前先按「标题＋当日日期」查一次库；命中即停在「已存在」，不发第二遍。
• 降级顺序：① 上传失败 → 改做「把要点写成文本笔记」；② 检索失败 → 改成「按标题精确读回那一条」；③ 官方接口整体不可达 → 停止并明说「这一跳没成」，需要留中间稿时先问你，默认不在本机落副本。
• 回执口径：每一步都出四行——做了什么／送到哪／成没成／没成是什么码加下一步。任何一步取不到确认，本包不说「已完成」。