docs + [自定义的标签和检测.md, 5.条件[Conditions].md Action.md]

maix2012 · web-flow · commit b4b572bc21e1 · 2025-11-18T20:39:59.000+08:00
diff --git a/5.条件[Conditions].md b/5.条件[Conditions].md
@@ -0,0 +1,64 @@
+# 自定义条件
+### 新条件
+```csharp
+public class CustomCondition : Pathfinder.Action.PathfinderCondition
+{
+    [XMLStorage]
+    public string Attribute;
+
+    public override bool Check(object os_obj)
+    {
+        OS os = (OS)os_obj;
+
+        // return true if actions inside condition should be triggered
+        // return false otherwise
+    }
+}
+```
+### 注册
+条件可以手动注册或使用条件属性注册。
+```csharp
+Pathfinder.Action.ConditionManager.RegisterCondition<CustomCondition>("CustomConditionXMLTag");
+```
+```csharp
+[Pathfinder.Meta.Load.Condition]
+public class CustomCondition : PathfinderCondition
+```
+### 将自定义条件添加到操作文件中
+```xml
+<CustomConditionXMLTag Attribue="value">
+    <!--Actions go here!-->
+</CustomConditionXMLTag>
+```
+Conditions的大部分情况都是搭配Mission使用或者直接被打包成了Mission的一个Goel。
+
+这里我们将通过一个简单例子来展示如何自定义条件。
+这将检查当前节点是否已经被破解（这里检查的是是否获得了管理员权限）。
+```csharp
+[Pathfinder.Meta.Load.Condition]
+public class TestCondition : Pathfinder.Action.PathfinderCondition
+{
+    [XMLStorage]
+    public string NodeID;
+    [XMLStorage]
+    public int PortNumber;
+
+
+
+    public override bool Check(object os_obj)
+    {
+        OS os = (OS)os_obj;
+        if (os.connectedComp.PlayerHasAdminPermissions())
+        {
+            return true;
+        }
+        else
+        {
+            return false;
+        }
+        // return true if actions inside condition should be triggered
+        // return false otherwise
+    }
+}
+```
+
diff --git a/Action.md b/Action.md
@@ -0,0 +1,75 @@
+# 自定义操作
+## 基础行动
+```csharp
+public class CustomAction : Pathfinder.Action.PathfinderAction
+{
+    [XMLStorage]
+    public string Attribute1;
+
+    [XMLStorage]
+    public string Attribute2 = "Default value!";
+
+    public override void Trigger (object os_obj)
+    {
+        OS os = (OS)os_obj;
+        os.write("Custom action triggered!");
+        os.write(Attribute1);
+        os.write(Attribute2);
+    }
+}
+```
+### 可延迟的行动
+DelayablePathfinderAction是PathfinderAction的子类型，实现了DelayHost和Delay属性。(无需添加    [XMLStorage]
+    public string Attribute1;属性用于存储延迟，他已经默认包含了)
+```csharp
+public class CustomDelayableAction : Pathfinder.Action.DelayablePathfinderAction
+{
+    public override void Trigger (OS os)
+    {
+        if (DelayHost != null)
+        {
+            os.write("Custom action triggered after " + Delay + " seconds with host " + DelayHost + "!");
+        }
+    }
+}
+```
+### 注册
+操作可以手动注册，也可以使用操作属性注册。
+```csharp
+Pathfinder.Action.ActionManager.RegisterAction<CustomAction>("CustomActionXMLTag");
+```
+或者
+```csharp
+
+[Pathfinder.Meta.Load.Action("CustomActionXMLTag")]
+public class CustomAction : PathfinderAction
+```
+### 将自定义操作添加到操作文件中
+```xml
+<CustomActionXMLTag Attribute1="Value" />
+```
+
+Action更类似于一个用于连接Mod功能与Extension作者推进剧情的助手，它的及时性和延迟效果更适合用来触发一些临时性的事件。同时你也可以将一些Action或者原版没有的操作进行打包，方便在Extension中使用。
+
+下一章我们会讲解它的触发条件的自定义方法。
+
+这里，我们以一个简单的Action例子为例。他的效果是延迟后执行一个指令。
+
+```csharp
+[Pathfinder.Meta.Load.Action("CommanderAction")]
+public class CommanderAction : Pathfinder.Action.DelayablePathfinderAction
+{
+    public override void Trigger (OS os)
+    {
+        [XMLStorage]
+        public string Command;
+
+
+        if (DelayHost != null)
+        {
+            os.execute(Command);
+        }
+    }
+}
+```
+
diff --git a/自定义的标签和检测.md b/自定义的标签和检测.md
@@ -0,0 +1,254 @@
+这部分很麻烦。
+
+本人不建议任何新手在未学习完全部用法且熟练掌握的前提下尝试自定义标签和检测。
+
+而且常有一些十分诡异的bug出现，甚至导致游戏崩溃。
+
+建议新手先学习完所有用法，再尝试自定义标签和检测。
+
+下面开始正式教程。
+
+---
+# Hacknet 模组开发指南：标签检测与一次性触发系统
+
+## 🎯 概述
+
+本指南将教你创建一个 Hacknet 模组，实现以下功能：
+- 检测计算机是否包含特定标签
+- 运行自定义 EXE 程序输出特定信息
+- 确保每次连接节点只触发一次
+- 支持存档持久化
+
+## 📁 文件架构
+
+```
+YourMod/
+├── YourModMain.cs      // 插件主入口
+├── ModCore.cs          // 核心逻辑管理器
+├── YourModStorage.cs   // 数据存储系统
+├── TestTagNode.cs      // 标签节点定义
+├── TestTagLoader.cs    // XML标签加载器
+└── TestTagExe.cs       // 自定义可执行程序
+```
+
+## 🔧 详细实现说明
+
+### 1. 插件主入口 (YourModMain.cs)
+```csharp
+// 作用：模组启动入口，注册所有组件
+[BepInPlugin(ModGUID, ModName, ModVer)]
+public class YourModMain : HacknetPlugin
+{
+    public override bool Load()
+    {
+        new ModCore(); // 初始化核心管理器
+        // 注册自定义EXE程序
+        Pathfinder.Executable.ExecutableManager.RegisterExecutable<TestTagExe>("#TestTagExe#");
+        return true;
+    }
+}
+```
+
+**关键点：**
+- 使用 `BepInPlugin` 属性声明模组信息
+- 在 `Load()` 方法中初始化所有组件
+- 必须使用 `ExecutableManager.RegisterExecutable` 注册EXE程序
+
+### 2. 核心逻辑管理器 (ModCore.cs)
+```csharp
+// 作用：管理触发状态、处理存档事件
+public class ModCore
+{
+    private static HashSet<string> triggeredComputers = new HashSet<string>();
+  
+    public ModCore()
+    {
+        // 注册存档加载和保存事件
+        EventManager<SaveComputerLoadedEvent>.AddHandler(OnComputerLoaded);
+        EventManager<SaveComputerEvent>.AddHandler(OnComputerSave);
+    }
+  
+    public static bool CanTriggerOnComputer(string compId)
+    {
+        // 检查是否已触发，确保每次连接只触发一次
+        if (triggeredComputers.Contains(compId))
+            return false;
+        triggeredComputers.Add(compId);
+        return true;
+    }
+}
+```
+
+**关键点：**
+- 使用 `HashSet` 跟踪已触发的计算机
+- 通过事件系统处理存档的加载和保存
+- `CanTriggerOnComputer` 方法是触发控制的核心
+
+### 3. 数据存储系统 (YourModStorage.cs)
+```csharp
+// 作用：提供全局数据访问接口
+public static class YourModStorage
+{
+    private static Dictionary<string, TestTagNode> nodes = new Dictionary<string, TestTagNode>();
+  
+    public static void AddOrUpdate(string compId, TestTagNode node)
+    {
+        nodes[compId] = node;
+    }
+  
+    public static bool HasNode(string compId)
+    {
+        return nodes.ContainsKey(compId);
+    }
+}
+```
+
+**关键点：**
+- 使用静态字典存储所有标签节点
+- 提供线程安全的访问方法
+- 计算机ID作为字典键值
+
+### 4. 标签节点定义 (TestTagNode.cs)
+```csharp
+// 作用：定义标签的数据结构
+public class TestTagNode
+{
+    public bool HasTriggered { get; set; } = false;
+  
+    public static TestTagNode FromXml(ElementInfo info)
+    {
+        var node = new TestTagNode();
+        // 从XML属性读取触发状态
+        if (info.Attributes.TryGetValue("HasTriggered", out string triggeredStr))
+        {
+            node.HasTriggered = bool.Parse(triggeredStr);
+        }
+        return node;
+    }
+}
+```
+
+**关键点：**
+- `HasTriggered` 属性用于跨游戏会话的持久化
+- `FromXml` 方法处理存档数据的反序列化
+
+### 5. XML标签加载器 (TestTagLoader.cs)
+```csharp
+// 作用：解析计算机XML中的自定义标签
+[ComputerExecutor("TestTag")]
+public class TestTagLoader : ContentLoader.ComputerExecutor
+{
+    public override void Execute(EventExecutor exec, ElementInfo info)
+    {
+        string compId = Comp.idName ?? Comp.name;
+        var node = new TestTagNode();
+        YourModStorage.AddOrUpdate(compId, node);
+    }
+}
+```
+
+**关键点：**
+- 使用 `[ComputerExecutor("TestTag")]` 属性声明标签处理器
+- 在游戏加载计算机时自动调用
+- 将标签信息存入全局存储
+
+### 6. 自定义可执行程序 (TestTagExe.cs)
+```csharp
+// 作用：实现具体的检测和输出逻辑
+public class TestTagExe : BaseExecutable
+{
+    public TestTagExe(Rectangle location, OS operatingSystem, string[] args) 
+        : base(location, operatingSystem, args)
+    {
+        // 获取目标计算机
+        var targetComp = os.connectedComp ?? os.thisComputer;
+        string compId = targetComp.idName ?? targetComp.name;
+      
+        // 检查标签存在性
+        if (!YourModStorage.HasNode(compId))
+        {
+            os.write("NO TestTag!");
+            needsRemoval = true;
+            return;
+        }
+      
+        // 检查触发权限
+        if (!ModCore.CanTriggerOnComputer(compId))
+        {
+            os.write("Computer TESTED!");
+            needsRemoval = true;
+            return;
+        }
+      
+        // 执行主要逻辑
+        os.write("test complete");
+        needsRemoval = true;
+    }
+}
+```
+
+**关键点：**
+- 继承 `BaseExecutable` 类
+- 在构造函数中完成所有逻辑（因为程序立即结束）
+- 使用 `needsRemoval = true` 让程序执行后自动移除
+- 三层检查机制确保正确触发
+
+## 🎮 使用流程
+
+### 1. 在计算机XML中添加标签
+```xml
+<computer name="TestComputer" ip="123.45.67.89" security="2">
+    <!-- 其他计算机配置 -->
+    <TestTag />
+</computer>
+```
+
+### 2. 在游戏中运行EXE
+```
+run #TestTagExe#
+```
+
+### 3. 预期输出结果
+
+| 场景 | 输出内容 | 说明 |
+|------|----------|------|
+| 首次运行（有标签） | `test complete` | 正常触发 |
+| 重复运行（同一连接） | `Computer TESTED!` | 防止重复触发 |
+| 无标签计算机 | `NO TestTag!` | 标签检测失败 |
+| 重新连接后运行 | `test complete` | 连接重置后重新触发 |
+
+## 🔄 触发机制详解
+
+### 会话级别控制
+- **EXE实例级别**：`hasTriggeredThisSession` 确保同一程序实例不重复触发
+- **连接会话级别**：`ModCore.CanTriggerOnComputer()` 确保同一连接只触发一次
+- **游戏会话级别**：`TestTagNode.HasTriggered` 记录历史触发状态（用于存档）
+
+### 重置条件
+当满足以下条件时，触发状态会被重置：
+- 玩家使用 `disconnect` 命令
+- 连接到其他计算机
+- 游戏重新加载
+
+### 修改标签名称
+将所有文件中的 `TestTag` 替换为你想要的标签名：
+```csharp
+// 在 TestTagLoader.cs 中
+[ComputerExecutor("YourCustomTag")]
+```
+
+### 修改输出信息
+在 `TestTagExe.cs` 中修改 `os.write()` 的内容：
+```csharp
+os.write("你的自定义输出信息");
+```
+
+
+
+## ⚠️ 注意事项
+
+1. **命名空间一致性**：确保所有文件使用相同的命名空间
+2. **GUID唯一性**：修改 `ModGUID` 确保不与其他模组冲突
+3. **XML标签大小写**：XML标签名称区分大小写
+4. **存档兼容性**：修改标签结构时考虑旧存档的兼容性
+
