Mud.Wechat.AI 1.0.0

dotnet add package Mud.Wechat.AI --version 1.0.0
                    
NuGet\Install-Package Mud.Wechat.AI -Version 1.0.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Mud.Wechat.AI" Version="1.0.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Mud.Wechat.AI" Version="1.0.0" />
                    
Directory.Packages.props
<PackageReference Include="Mud.Wechat.AI" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Mud.Wechat.AI --version 1.0.0
                    
#r "nuget: Mud.Wechat.AI, 1.0.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Mud.Wechat.AI@1.0.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Mud.Wechat.AI&version=1.0.0
                    
Install as a Cake Addin
#tool nuget:?package=Mud.Wechat.AI&version=1.0.0
                    
Install as a Cake Tool

Mud.Wechat.AI

AI 能力域的 层 1(线中立)单包:跨七线共享的工具面端口、会话装配契约与统一信封读取器,零业务线依赖。 2026-10 包合并:原 Mud.Wechat.AI.Abstractions(契约)与 Mud.Wechat.AI.Agent(运行时)并为这一个包, 命名空间保持 Mud.Wechat.AI.Abstractions.* 与 Mud.Wechat.AI.Agent.* 不变(下方两节分别是两个原包的面)。

层 1 / 层 2 分层(AI-G2 / AI-G3 锁定):本包为层 1(不得引用任何线专属包); Mud.Wechat.Work.AI / Mud.Wechat.Work.AI.Tools / Mud.Wechat.Work.AI.Mcp 为层 2(企微线专属)。 工程必须平铺三段 Src/AI/<Project>/——四段形态会被 verify-build.ps1 的 -Depth 2 枚举静默漏掉(AOT 假绿)。

公开面

目录 / 类型 作用
Tools/IWechatToolSurface 工具面端口:IReadOnlyList<WechatToolDescriptor> Describe()——协议层(MCP)与工具面(Tools)只在端口上相遇(AI-G5),本包自身无实现
Tools/WechatToolDescriptor 单工具描述(名称 / 描述 / 输入输出 Schema / 风险档)
Tools/WechatToolPrincipal 工具调用主体(授权/审计维度)
Tools/WechatToolRiskVocabulary 工具风险词汇表(风险档常量单一来源)
Conversations/IContextAssembler 会话上下文装配端口(按事件键路由,空串 = 兜底)
Conversations/ConversationAssembly / ConversationAssemblyInput 装配产物 / 输入(对话事实 + 事实来源标注)
Conversations/WechatConversationFacts 会话事实集(喂给模型的去隐私事实面)

依赖与钉版

仅依赖上游 Mud.AI.Abstractions(1.0.2 钉版,禁浮动;全仓版本集合大小 = 1 由 AI-G4 锁定)。 无 JsonContext / 配置面 / DI 装配——本包是被消费的叶层。

守卫索引

Tests/Mud.Wechat.AI.Tests/ContractGuards/WechatAiContractGuards.cs:AI-G1(业务域零 AI 依赖)、 AI-G2(层 1 跨线中立)、AI-G3(布局三段)、AI-G4(Mud.AI.* 单一钉版)、AI-G5(工具面/协议面单向依赖)、 AI-G7(上游版本与采纳面同批)。


原 Mud.Wechat.AI.Agent 包面(2026-10 包合并并入本工程,命名空间不变)

AI 能力域的 层 1 运行时包(线中立):基于上游 Mud.AI.Agent(1.0.2 钉版)提供会话装配与 API 结果 归一的默认实现,供层 2(Mud.Wechat.Work.AI / Mud.Wechat.Work.AI.Tools)消费。

分层与布局约束见 Mud.Wechat.AI/README.md(AI-G2 / AI-G3)。

公开面

目录 / 类型 作用
Conversations/DefaultContextAssembler IContextAssembler 默认实现(空事件键兜底:把回调信封与历史对话装配为 ConversationAssembly)
Conversations/WechatConversationRequestFactory ConversationAssembly → 上游 Agent 会话请求的出厂(消息列表 + 系统提示约定)
Results/WechatApiResultReader 上游 ToolApiOutcome / Agent 结果 → 供模型阅读文本的统一读取器
Results/WechatApiErrorCatalog 微信 errcode → 可读错误语料目录(模型自我纠错用;不透内部堆栈)

依赖与钉版

  • Mud.AI.Abstractions + Mud.AI.Agent(均 1.0.2 钉版;AI-G4 单一版本守卫)。
  • 同层引用 Mud.Wechat.AI.Abstractions(端口)。

已踩陷阱 / 设计决策(改前先读)

  1. 错误语料面向模型、不面向日志:WechatApiErrorCatalog 的文案是给模型读的(含下一步建议), 不得复用为运维日志——运维语义走各线 WorkMetrics/Activity。
  2. 装配兜底键是空串:DefaultContextAssembler.SupportedEventType => string.Empty 为「未命中专属 装配器时兜底」语义,与回调处理器兜底同形——新增事件键的专属装配器不得占用空串键。
  3. 出站转义归上游:ToolResultJson 宽松转义出站由 Mud.AI.Agent 承载,本仓不重复实现; 升级上游时跑 AI-G7 同批核对采纳面。
Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (3)

Showing the top 3 NuGet packages that depend on Mud.Wechat.AI:

Package Downloads
Mud.Wechat.Work.AI

企业微信线 AI Agent 底座:WechatAgent(ObservedDelegatingAgent 承载 ChatClientAgent、实现 IAgentSessionFacade)、WechatAgentOptions + Validator、WechatWorkAiScopeFactory(ITurnScopeFactory → UseCorpScope 桥接)、Aibot 主动回复通道、Bot 回调处理器与 AddWechatWorkAgent 装配。

Mud.Wechat.Work.AI.Tools

企业微信线 AI 工具面:WechatToolProfile(Mud.AI.Generator 剖面)、工具风险枚举与绑定类型、只读工具的策展声明(Curation)与执行器(强类型直连 Mud.Wechat.Work 接口)。

Mud.Wechat.Work.AI.Mcp

企业微信线 AI 工具面的 MCP(Model Context Protocol)协议层:把已策展的受控工具面以 JSON-RPC 2.0 暴露为 MCP server(initialize / ping / tools/list / tools/call),stdio 行帧传输 + 可嵌入的请求处理器,零反射、AOT 安全。

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.0 72 10/29/2026