用途:面向 Yanzi 本地扩展的开发技能,帮助智能体创建、检查、编辑和安装扩展,包括编写 manifest.json、编写 C# 或 PowerShell 动作扩展,以及调用本地 Agent API。
扩展形态:支持 JSON 扩展、C# 或 PowerShell 动作扩展、托管视图扩展。运行时可选 csharp 或 powershell:复杂逻辑、JSON/HTTP/文件处理、原生 WPF 窗口、P/Invoke、强类型 .NET API 用 csharp;Windows 自动化、注册表/服务/进程/计划任务/系统命令、剪贴板与文件自动化、已有 PowerShell cmdlet 的任务用 powershell。
存储与配置:扩展位于应用 Extensions/ 目录,Windows 下实际路径为 %LOCALAPPDATA%\OpenQuickHost\Extensions\,配置与存储文件在 %LOCALAPPDATA%\OpenQuickHost\。本地 Agent API 令牌位于 %LOCALAPPDATA%\OpenQuickHost\appsettings.local.json 的 agentApiToken 字段。
本地 Agent API:默认基址 http://127.0.0.1:53919,请求头 X-Yanzi-Token。端点包括 GET /health、GET /v1/extensions、GET /v1/extensions/template、GET /v1/extensions/{id}、POST /v1/extensions、PUT /v1/extensions/{id}、PATCH /v1/extensions/{id}/rename、PATCH /v1/extensions/{id}/shortcut、DELETE /v1/extensions/{id}。
关键规则:新建扩展必须用 POST /v1/extensions 而非直接写盘,以便正确注册并获得置顶排序;C# 调用外部进程时显式设置 StandardOutputEncoding = System.Text.Encoding.UTF8 并用 ReadToEndAsync() 防止中文乱码;执行 dotnet build 后应立即启动编译产物。与 API 通信时在 Content-Type 中加 charset=utf-8,并手动将载荷编码为 UTF-8 字节流。
限制:资料未提供收费、价格、平台支持范围等细节;具体请求与响应结构需查阅 references/local-agent-api.md,manifest 与脚本细节见 references/manifest.md 和 references/script-extensions.md。