用途与实际影响
这项功能怎样使用
为什么需要它
一个能力写好了，不代表当前对话能找到它，也不代表它能在真实任务里工作。这里帮我按用途找到正确工具，并分清来源、安装、当前可见、下次新任务可见和实际完成。
举个实际例子
我可以说：“以前把图片放清楚的工具在哪？把这张图做成指定尺寸。”系统先查现有用途清单，确认原图、画幅和目标，再用已有工具交回新 PNG，原图保留。如果我问“这个 Skill 已经写好，为什么新任务看不到”，才逐层检查源码、安装、当前任务、全新任务与真实场景，说明具体缺口和恢复入口。
最后我会得到什么
问“以前让图片更清楚的工具在哪”时，会拿到真实入口、要提供的原图与目标尺寸，以及已有使用证据；实际运行才会产生新图片。工具找不到或新任务仍看不到时，会指出具体卡在哪一步。
正常时
工具来源、安装和这次实际使用各有结果；只把已证实的那一步说成成功。
发现问题时
目录指错、安装中断或新任务找不到时，说明受影响的入口和恢复办法，不把全部能力都说坏了。
入口不可用或证据不足时
唯一来源或安装位置读不到时，明确说现在无法确认；旧文件或旧测试不能证明它今天可用。
从哪里开始
在已接入能力目录的 AI 对话中直接描述用途，或在本站 Skills 页查入口；具体运行仍由对应工具完成。
需要准备什么
- 要做的事和材料类型
- 是否已有指定 Skill、插件或账号
从开始到拿到结果
- 1
按用途找入口
AI 在当前目录中找真实可用能力，告诉你需要的材料、账号或本机环境。
- 2
执行对应工作
取得所需授权后由实际 Skill、工具或连接器处理，不把能找到入口当成已安装且能完成。
- 3
读回结果
交回文件或操作结果；来源、安装、当前任务与真实使用分别说明，缺一个只标该层缺口。
技术实现与依据
这里保留实现、关键条件、精确入口、历史记录和验证结果。
供应源码、安装和事务当前通过；运行 E2E（端到端验证）不能由安装推断关键规则与设计选择
Source（源码）、quick validation（快速校验）、junction（目录联接）和 transaction（安装事务）全部通过才算安装层健康。
Current task（当前任务）、Fresh task（全新任务验证）和 E2E（端到端验证）没证据时显示 Unknown（证据不足）。
当前公开范围内31个安装意图与31个公开条目分别回读；公开项中个人入口29个、宿主集成2个。browser-control-continuity的既有fresh自然路由只证明当时场景，不证明未来任意浏览任务。
安装中断时按 recovery capsule（恢复胶囊）回滚或 reconcile（收敛修复）。
退役 Skill 的目录或旧测试不能让它重新出现。
本模块用到的名词
- Canonical source（唯一维护源）
- 唯一可维护正文；用户目录只是发现链接，不是第二份源码。
- Install intent（安装意图）
- registry（登记清单） 要求安装，不等于宿主已经注入，也不等于场景 E2E（端到端验证） 已通过。
- Fresh task（全新任务验证）
- 在安装完成之后启动的另一个任务真实看见该能力，不能由当前任务或旧回执替代。
- Authoritative success（权威成功态）
- 页面或最终平台记录实际确认成功；文件名、100% 进度和导航都不能替代。
- Recovery capsule（恢复胶囊）
- 记录固定 roots、目标、source 和 pre-image，使 registry（登记清单） 漂移时仍能安全恢复。
专业定义
一份清单管住能力的唯一源码和安装入口，再把 source、install、current（当前状态）、fresh、E2E（端到端验证） 五层分别验清；浏览连续性仍以真实页面和平台回读为准。
解决什么
Skill 源码、用户目录可发现性、当前任务注入和真实自然语言 E2E（端到端验证） 是不同事实。如果只看文件存在或 junction（目录联接） 存在就声称能力可用，最终会得到一份看起来很满、实际无法判断的清单。
当前怎样实现
- E:\.agents\skills 与 plugins 是 canonical source（唯一维护源）；personal-skill-supply.json 是名称、来源和 install 意图的唯一 registry（登记清单）。
- 用户目录只保存由事务 installer 创建的同名 junction（目录联接），不允许手工维护第二份源。
- 安装事务记录 intent、applied、pre-image 和 recovery capsule（恢复胶囊）；回滚不依赖当前 registry（登记清单），避免 registry（登记清单） 漂移后无法恢复。
- 可用状态分成 source、install、current task（当前任务）、fresh task（全新任务验证） 和 end-to-end 五层；transaction（事务） 单独记录 install 过程与恢复，不冒充第六种可用状态。
- browser-control-continuity 只叠在当前 managed browser Provider 之上：保留受控标签页，登录先复用已有会话，再在本地 Chrome 选择匹配的已保存账号；普通填充不读取密码，弹窗选择、填充结果和登录成功分开证明。云端浏览器按自己的安全登录交接，不能假定拥有本地密码、Cookie 或扩展。必要时用受限 helper 补三个缺失运行文件，上传与提交分别要求页面/平台回读。
- 外部提供但已经真实接入且有持续价值的能力可以进入面板，来源必须与个人维护区分。有复用价值的小工具不用各自立项：比如我说“以前让图片变清楚的工具在哪”，系统先按用途查现有清单，交回真实入口、需要什么环境、已有验证与备份，再按当前任务使用。图片超分改善观感，不能恢复未知真实细节；用过的工具和一次性过程文件按各自用途保留或清理。
- 这里还包括资料搜索与核查、文档/表格/演示制作、数据处理与可视化、代码执行、浏览器和桌面操作，以及通过已连接账号使用的外部服务。它们按实际任务组合：给出问题与材料，选择必要入口，交回可编辑文件、图表、图片或真实操作结果。通用模型、原生工具和个人项目各自贡献不同部分；可发现的工具、已连接账号和具体任务验收仍分开判断。
- 状态探针也是工具能力：读取电脑、服务、连接和端口的当前状态，或分析明确选定的系统轨迹，交回观测、异常与证据缺口。探针响应只证明所测的一层；接口通、程序启动和真实工作成功分别判断，不靠多跑检查制造健康结论。
- 活动能力规则中的 local_tool_catalog_route（本机工具清单路由）只保留稳定入口：E:\Tools\LocalToolbox\catalog.json。按用途查找用 E:\Tools\LocalToolbox\Find-LocalTool.ps1 -Query '图片变清楚' -Json；它按关键词匹配，返回用途、实际入口、入口是否存在、说明、验证与备份，不执行工具、不采集、不联网。清单掌握工具事实，E 不复制工具型号或文件哈希。
- 2026-09-14清单有9项：3个独立工具（图片超分、Windows轨迹分析、.NET方法字符串检查）、1条既有Codex打开做法、5个现有能力指针。新增可见一次性任务等待由PCConfig运行模块承接：能看检查状态并停止，排队提醒不等于AI已接到或业务完成。正式 Skill 和壁纸项目继续由各自来源维护；查询未命中或入口不存在时如实说明，不能把目录当全机工具的完整清单。
- 选定工具的源码、必要运行依赖、许可和恢复说明已保留在固定工具目录，并保存 G:\80_Backup\Tools\LocalToolbox\lightweight-tools-20260909T062945Z.zip：42,880,045 bytes，SHA-256=3efe2caf405a643f82238d7611e5b8fe94c7cfe7b20dc6cb4e39678a11cbf6ac。这份9月9日包的大小与哈希只证明当时保留集，不证明9月14日新指针已加入旧包；当时4个正式能力指针也不代表对应项目全量入包，H冷副本未在本模块独立验证。轨迹分析器保全了源码与依赖，本轮未新采集或分析系统活动。三个独立工具的输入、输出与边界如下：
- 图片超分入口 E:\Tools\ImageSuperResolution\Invoke-ImageSuperResolution.ps1 接收本地 PNG/JPG/JPEG、全新 PNG 输出路径与 Width/Height；Real-ESRGAN ncnn Vulkan v0.2.0 先以 general（柔和绘画质感）或 anime（更锐利线条）模型真实放大4倍，再缩至指定尺寸。依赖 Vulkan GPU 与 LocalGpuBroker（本地 GPU 调度器） 串行租约；比例差超过约0.2%先另行扩图或裁切，已有目标拒绝覆盖，原图保持只读。清晰度改善不证明未知细节真实。
- Windows轨迹入口 E:\Tools\WindowsTraceAnalyzer\runtime\trace-analyzer.exe 只分析明确选中的 ETL（Windows事件轨迹文件），在标准输出汇总CPU、RPC、DPC/ISR（驱动中断处理）耗时和DWM（桌面合成器）事件间隔；可选第二个PID参数会在轨迹同目录写.focus.json。依赖Windows/.NET 10与TraceEvent 3.2.6；--collect的新15秒内核采集是另一项有授权的诊断，查工具不触发采集。画面刷新卡顿与鼠标键盘响应分开，汇总不能单独证明根因。
- .NET方法入口 E:\Tools\DotNetMethodStrings\Get-MethodStringLiterals.ps1 使用 AssemblyPath、TypeName、MethodName 精确选择程序集、类型和方法，以JSON列出IL（中间语言）里的字符串常量。PowerShell 7独立进程加载选定程序集，结束释放且不修改原文件；不遍历电脑上的程序集。固定目录的示例程序集验收是2026-09-09历史事实，本轮没有读取真实程序或重新运行。
- 图像生成与编辑也是系统可用的外部能力：描述画面或提供参考图，可通过当前宿主的 image_gen 入口生成封面、改背景和细节，并继续迭代；.agents 负责按需求选择和衔接，不开发基础图像模型，也不为每次模型换代另建项目。
- 2026-09-09 已核对 OpenAI 官方图像生成文档，API 示例包括 gpt-image-2.5-sunburst 与 gpt-image-2.5-flare，支持文字生成与已有图像编辑。当前宿主的工具元数据证明图像入口可用，但没有暴露其实际后台型号；官方 API 型号、宿主工具接入与一次真实生成结果分别陈述，本轮没有为介绍能力额外生成图片。官方参考：https://developers.openai.com/api/docs/guides/image-generation
执行流程
- 1
从 registry（登记清单） 读取 active、inactive 和 retired 声明
- 2
验证每个 canonical source（唯一维护源） 的 SKILL、编码和 frontmatter
- 3
验证 discovery junction（目录联接） 精确指向 source
- 4
检查是否存在 unfinished 或损坏的安装事务
- 5
按宿主回执分别判断 current（当前状态）、fresh 和 E2E（端到端验证），不从 install 倒推
- 6
浏览工作还分别核对同一标签页、异步控件、逐文件成功态与提交后平台记录
- 7
新增或恢复时走事务 installer，失败时用 capsule 预览并回滚
边界
- 不手工创建或修补 discovery junction（目录联接）
- 源文件通过不能证明安装、任务注入或真实 E2E（端到端验证）
- 本地浏览 runtime（运行环境） 恢复不授权登录、上传、验证码、删除或最终提交
- 退役 Skill 不会因历史目录或测试存在而恢复
- 插件分发单位和 Skill 触发入口不是同一层
失败与恢复
- Source 缺失或映射漂移
- 供应验证 BLOCK，不从用户目录反向复制成新 source。
- 安装事务中断
- 通过最新 recovery capsule（恢复胶囊） 先预览，再执行 rollback 或在 desired state 完整满足时 reconcile。
- 当前任务没有回执
- 显示 unknown（未验证），而不是把 install=true 翻译成已启用。
- 浏览运行文件缺失
- 先走官方刷新；只有同官方包族、只补精确缺失且不覆盖现有目标时，才用 Inspect→Repair，并在真实连接回读后凭 receipt（执行回执） Cleanup。
- 上传显示文件名或100%，提交后发生导航
- 仍不称为完成；逐个读取页面成功态，并从最终平台记录核对关键字段、附件数和文件名。
真实入口
E:\.agents\config\personal-skill-supply.json个人 Skill 名称、source、kind 和 install 意图的唯一 registry（登记清单）
E:\.agents\skills个人维护 Skills 的 canonical root（唯一维护根目录）
E:\.agents\plugins插件提供 Skills 的 canonical root（唯一维护根目录）
E:\.agents\docs\personal-skill-supply-recovery.md事务安装、回滚、reconcile，以及五层可用状态与安装事务证据说明
E:\.agents\skills\browser-control-continuity\SKILL.md浏览标签页恢复、异步控件、逐文件成功态、提交回读与教训沉淀边界
E:\.agents\skills\browser-control-continuity\scripts\Invoke-BrowserControlContinuity.ps1同官方包族三个精确缺失文件的 Inspect、Repair、哈希回读和 Cleanup helper
如何验证
- PersonalSkillSupply 验证 registry（登记清单）、source、junction（目录联接） 和事务
- 2026-09-04 历史供应回读 29 个 active install intent（安装意图）、41/41 terminal transaction（事务）；当前数量以本页生成快照为准；browser-control-continuity source/install 通过，来源 Owner 的 fresh 自然路由验收通过
- 网站任务未执行未来浏览站点、文件上传、最终提交或 helper 修复，不把供应/路由证明冒充新的页面 E2E（端到端验证）
- PersonalSkillAutonomy 与 SemanticCuration 验证 metadata（元数据） 是否窄而有用
- Current task（当前任务）、fresh task（全新任务验证） 和 E2E（端到端验证） 必须来自对应宿主回执；本快照未取得的显示 unknown（未验证）
与其他模块的关系
Skills 供应提供窄能力入口，能力路由决定何时使用；授权合同继续约束它产生的现实 effect（外部现实动作）。