补充了Library的注释

Library/Api/IDynamicContext.cs

@@ -5,12 +5,12 @@ using System.Threading.Tasks;
 namespace Serein.Library.Api
 {
     /// <summary>
-    /// 流程上下文
+    /// 流程上下文，包含运行环境接口，可以通过注册环境事件或调用环境接口，实现在流程运行时更改流程行为。
     /// </summary>
     public interface IDynamicContext
     {
         /// <summary>
-        /// 运行环境
+        /// 运行环境，包含IOC容器。
         /// </summary>
         IFlowEnvironment Env { get; }
         

Library/Api/IDynamicFlowNode.cs

@@ -6,6 +6,9 @@ using System.Threading.Tasks;
 
 namespace Serein.Library.Api
 {
+    /// <summary>
+    /// 空接口
+    /// </summary>
     public interface IDynamicFlowNode
     {
     }

Library/Api/IFlipflopContext.cs

@@ -4,7 +4,9 @@ using Serein.Library.NodeFlow.Tool;
 namespace Serein.Library.Api
 {
     /// <summary>
-    /// 触发器必须使用该接口作为返回值，同时必须用Task泛型表示，否则将不会进行等待触发。
+    /// <para>触发器必须使用该接口作为返回值，同时必须用Task泛型表示，否则将不会进行等待触发。</para>
+    /// <para>即使大多数时候，触发器传出的数据可能是任何一种数据类型，导致其泛型参数可能是无意义的 object / dynamic 。</para>
+    /// <para>但在确定传出类型的场景下，至少可以保证数据一定为某个类型。</para>
     /// </summary>
     public interface IFlipflopContext<out TResult>
     {

Library/Api/ISereinIoc.cs

@@ -4,19 +4,23 @@ using System.Text;
 
 namespace Serein.Library.Api
 {
+    /// <summary>
+    /// <para>单例模式IOC容器，内部维护了一个实例字典，默认使用类型的FullName作为Key，如果以“接口-实现类”的方式注册，那么将使用接口类型的FullName作为Key。</para>
+    /// <para>当某个类型注册绑定成功后，将不会因为其它地方尝试注册相同类型的行为导致类型被重新创建。</para>
+    /// </summary>
     public interface ISereinIOC
     {
         /// <summary>
-        /// 清空
+        /// 慎用，重置IOC容器，除非再次注册绑定，否则将导致不能创建注入依赖类的临时对象。
         /// </summary>
         /// <returns></returns>
         ISereinIOC Reset();
         /// <summary>
-        /// 注册实例
+        /// 注册实例，如果确定了params，那么将使用params入参构建实例对象。
         /// </summary>
         ISereinIOC Register(Type type, params object[] parameters);
         /// <summary>
-        /// 注册实例
+        /// 通过泛型的方式注册实例，如果确定了params，那么将使用params入参构建实例对象。
         /// </summary>
         /// <typeparam name="T"></typeparam>
         /// <param name="parameters"></param>
@@ -25,58 +29,65 @@ namespace Serein.Library.Api
         /// <summary>
         /// 注册接口的实例
         /// </summary>
-        /// <typeparam name="TService"></typeparam>
-        /// <typeparam name="TImplementation"></typeparam>
+        /// <typeparam name="TService">接口类型</typeparam>
+        /// <typeparam name="TImplementation">实例类型</typeparam>
         /// <param name="parameters"></param>
         /// <returns></returns>
         ISereinIOC Register<TService, TImplementation>(params object[] parameters) where TImplementation : TService;
 
-        ///// <summary>
-        ///// 获取或创建并注入目标类型，会记录到IOC容器中。
-        ///// </summary>
-        //T GetOrRegisterInstantiate<T>();
-        ///// <summary>
-        ///// 获取或创建并注入目标类型，会记录到IOC容器中。
-        ///// </summary>
-        //object GetOrRegisterInstantiate(Type type);
         /// <summary>
-        /// 获取类型的实例
+        /// 获取类型的实例。如果需要获取的类型以“接口-实现类”的方式注册，请使用接口的类型。
         /// </summary>
-        /// <param name="type"></param>
-        /// <returns></returns>
         object Get(Type type);
+        /// <summary>
+        /// 获取类型的实例。如果需要获取的类型以“接口-实现类”的方式注册，请使用接口的类型。
+        /// </summary>
         T Get<T>();
 
         /// <summary>
-        /// 获取指定名称的实例
+        /// <para>获取指定名称的实例。</para>
+        /// <para>正常情况下应该使用 Get(Type type) /  T Get&lt;T&gt;() 进行获取，但如果需要的实例是以CustomRegisterInstance()进行的登记，则需要通过这种方法进行获取。</para>
         /// </summary>
         /// <typeparam name="T"></typeparam>
-        /// <param name="key"></param>
+        /// <param name="key">登记实例时使用的Key</param>
         /// <returns></returns>
         T Get<T>(string key);
 
         /// <summary>
-        /// 通过名称注册实例
+        /// 指定一个Key登记一个实例。如果实例中需要注入的依赖项，需要将needInjectProperty设置为true。
         /// </summary>
         /// <param name="key">注入名称</param>
         /// <param name="instance">实例对象</param>
         /// <param name="needInjectProperty">是否需要注入依赖项</param>
-        void CustomRegisterInstance(string key, object instance, bool needInjectProperty = true);
+        /// <returns>是否注册成功</returns>
+        bool CustomRegisterInstance(string key, object instance, bool needInjectProperty = true);
 
         /// <summary>
-        /// 用于临时实例的创建，不注册到IOC容器中，依赖项注入失败时也不记录。
+        /// <para>创建实例并注入依赖项，不会注册到IOC容器中。</para>
+        /// <para>使用场景：例如 View 的构造函数中需要创建 ViewModel，而 ViewModel 存在注册过的依赖项，可以通过该接口进行创建</para>
+        /// <para></para>
         /// </summary>
         object Instantiate(Type type);
+
         /// <summary>
-        /// 用于临时实例的创建，不注册到IOC容器中，依赖项注入失败时也不记录。
+        /// <para>创建实例并注入依赖项，不会注册到IOC容器中。</para>
+        /// <para>使用场景：例如 View 的构造函数中需要创建 ViewModel，而 ViewModel 存在注册过的依赖项，可以通过该接口进行创建</para>
+        /// <para></para>
         /// </summary>
         T Instantiate<T>();
+
         /// <summary>
-        /// 实例化注册的类型，并注入依赖项
+        /// 通过已注册的类型，生成依赖关系，然后依次实例化并注入依赖项，最后登记到容器中。
         /// </summary>
         /// <returns></returns>
         ISereinIOC Build();
 
+        /// <summary>
+        /// 从容器中获取某个类型的实例进行运行
+        /// </summary>
+        /// <typeparam name="T"></typeparam>
+        /// <param name="action"></param>
+        /// <returns></returns>
         ISereinIOC Run<T>(Action<T> action);
         ISereinIOC Run<T1, T2>(Action<T1, T2> action);
         ISereinIOC Run<T1, T2, T3>(Action<T1, T2, T3> action);