ClassIsland 联动插件：新增 IslandCaller 支持

[PANDAJSR]

希望 https://github.com/SECTL/ClassIsland-SecAgent-Connector 能调用 https://github.com/HickoryTrail/IslandCaller 随机点名
次要功能（如果能实现）：
配置IslandCaller名单等设置
注册 SecAgent 前置规则匹配点名等词（参考SecAgent的SecRandom联动插件），触发后调用 IslandCaller

[PANDAJSR]

/oc 分析

[github-actions]

已达最大步骤上限（Maximum steps reached）

本代理的步骤配额已用完，工具调用已被禁用，本次只能给出文字分析总结。

---

已完成的分析

我对 issue #3「ClassIsland 联动插件：新增 IslandCaller 支持」做了完整的可行性调研，涉及的四个仓库的结构与接口都已在 GitHub 上核实。

当前架构（现状）

ClassIsland 联动由两端组成：

1. ClassIsland 端插件（SECTL/ClassIsland-SecAgent-Plugin，Plugin.cs）

   • 在 http://127.0.0.1:18789 起 HttpApiServer，暴露 /health、/tools、POST /tools/{toolName}
   • 工具目录是硬编码的（Tools() 方法），CallTool(name, arguments) 用 switch 分发，目前没有任何点名类工具

2. SecAgent 端连接插件（SECTL/ClassIsland-SecAgent-Connector，main.mjs）

   • 动态注册 ClassIsland 端 /tools 目录返回的全部工具 + classisland Skill + 课表上下文 prompt
   • 权限仅 ["agent.tools", "agent.skills", "agent.prompts", "network.http"]，没有 agent.pre_rules

IslandCaller（HickoryTrail/IslandCaller）：

• 是运行在 ClassIsland 进程内的插件，不暴露任何 HTTP API
• 随机点名入口：IslandCallerService.ShowRandomStudent(stunum)（加权随机 + TTS/通知/点名窗口）
• 已注册两个可被外部触发的钩子：
  • URI 导航 IUriNavigationService.HandlePluginsNavigation("IslandCaller/Simple", ...)
  • 自动化行动 IslandCaller.Call（IActionService.ActionMenuTree）
• 名单/权重存于 Settings.Instance.Profile.ProfileList（用户设置 JSON）
• 作者进入高三，项目停止大版本迭代（维护交予 Codex），不能指望对方改版加 API

关键结论

• 主功能可行，且不需要改动 IslandCaller 本体：因为 IslandCaller 与 ClassIsland-SecAgent-Plugin 运行在同一个 ClassIsland 进程中，后者可以通过 ClassIsland 插件宿主直接触发前者——推荐用 IAppHost.TryGetService<IslandCallerService>() 调 ShowRandomStudent(1)（最直接），或 URI 导航 / 自动化行动作为不依赖 IslandCaller 内部类型的备选。
• 次要功能（前置规则 + 名单配置）的参照物是 SECTL/SecRandom-SecAgent-Connector 的 src/main.mjs：
  • 用 api.registerPreRule("draw_students_command", parseDrawPreRule) 注册函数式前置规则（匹配「点个名/点名/抽个人/抽人/随机抽取/随机」+数量+性别），命中后直接调工具、渲染回复、绕过 LLM；权限声明里需要加 agent.pre_rules。
  • registerPreRule 的签名在 SecAgent 侧 plugin-manager.ts（PluginPreRuleMatcher，返回 { tool, arguments, render }），运行时在 runtime.ts 执行——SecAgent 宿主无需任何改动。

建议的实现方案（涉及三个仓库）

1. SECTL/ClassIsland-SecAgent-Plugin（主要改动）

   • 新增工具 call_island_caller（约 10 行）：在 Tools() 注册、在 CallTool switch 中分发；实现里 IAppHost.TryGetService<IslandCallerService>()?.ShowRandomStudent(1)（可加 count、notify 参数），返回被点到学生名/状态；IslandCaller 未安装时返回明确错误。
   • 可选新增 list_island_caller_roster / write_island_caller_roster 工具读写名单设置（需要解析 IslandCaller 的 Settings.Profile.ProfileList，属加分项、工作量较大）。

2. SECTL/ClassIsland-SecAgent-Connector（连接插件）

   • 因工具是动态发现的，call_island_caller 会被自动注册，无需改工具层。
   • 复制 SecRandom 连接插件的 parseDrawPreRule 模式：secagent-plugin.json 增加 "agent.pre_rules" 权限，main.mjs 中 api.registerPreRule("islandcaller_call", matcher)，正则匹配「点名/随机点名/抽人/抽个学生」等词，命中调用 call_island_caller 并渲染「点到：XXX」回复。
   • 可在 skills/classisland 的 SKILL.md 中补充 IslandCaller 使用说明。

3. SECTL/secagent-plugin-marketplace（发布）

   • 两个插件 bump 版本、重新生成签名索引后，现有 SecAgent 的 10 分钟自动更新机制会自动推送。

剩余工作

• 实际编码（三个仓库）与构建：ClassIsland 插件为 .NET/C#（dotnet build）、连接插件为 JS（node --check main.mjs）
• 端到端验证：ClassIsland 里装 IslandCaller + SecAgent 插件，SecAgent 里触发「点名」语句，确认命中前置规则并弹出点名窗口
• 签名市场索引的重新生成与发布

建议下一步

在获得用户对方案（尤其「触发方式：直接调 IslandCallerService vs URI 导航」以及「是否要做名单配置工具」）的确认后，先从 ClassIsland-SecAgent-Plugin 加 call_island_caller 工具开始实现，再改连接插件加前置规则与权限，最后发布市场索引。

（说明：本次任务为 /oc 分析，未做任何代码改动，工作树保持干净。）

opencode session  |  github run

[PANDAJSR]

/oc 执行

[github-actions]

已达最大步骤上限（Maximum steps reached）

本代理的步骤配额已用完，工具调用已被禁用，本次只能给出文字总结。本轮任务为 /oc 执行，我已完成了全部调研与实现方案设计，但尚未写入任何代码改动。

---

已完成的工作

1. 核实了四个仓库（均可被 runner 访问，且均属于允许修改的 SECTL SecAgent 仓库列表）：

   • SECTL/ClassIsland-SecAgent-Plugin（ClassIsland 端插件，C#，Plugin.cs 1592 行，dotnet build 已验证可干净构建）
   • SECTL/ClassIsland-SecAgent-Connector（SecAgent 端连接插件，main.mjs + secagent-plugin.json）
   • SECTL/SecRandom-SecAgent-Connector（前置规则参照实现）
   • HickoryTrail/IslandCaller（只读调研，不会修改此仓库）

2. 确认了 IslandCaller 的触发方式（关键结论）：

   • 与 SecAgent 插件运行在同一 ClassIsland 进程内，IslandCallerService 以单例注册在 DI 容器（IAppHost.Host.Services），可通过反射 GetService(Type) + Invoke("ShowRandomStudent", count) 触发随机点名，无需改动 IslandCaller 本体。
   • ShowRandomStudent 的同步段会先完成抽取并写入 HistoryService.top20List，因此调用后读取 history 可拿到被点学生名单（供前置规则渲染“点到：XXX”）。
   • 名单是 %APPDATA%\IslandCaller\Profile\{guid}.csv（id,name,gender,manualweight），ProfileService.SaveProfile/GetMembers 可读写，Settings.Instance.Profile.ProfileList 是 Dictionary<Guid,string>。
   • 就绪状态通过 Status.IsPluginReady 判断。

3. 读通了 SecAgent 侧前置规则机制（plugin-manager.ts 的 PluginPreRuleMatcher、runtime.ts 的匹配→callTool→render 流程）：前置规则命中后若工具调用抛异常会回退 LLM，因此 call_island_caller 应返回结构化结果而非抛错。

4. 完成了完整的实现方案设计（见下）。

未完成的工作（需在下一轮执行）

A. ClassIsland-SecAgent-Plugin 的 Plugin.cs（主要改动）

• 新增 4 个工具并注册进 Tools() 目录与 CallTool switch：
  • call_island_caller（默认展示、非 hidden）：count（1–20）→ 反射调 ShowRandomStudent，读取 history 返回 {ok, installed, triggered, students, message}，IslandCaller 未安装时返回明确信息而不是抛错。
  • list_island_caller_profiles：列出 ProfileList 的名称/ID/人数。
  • read_island_caller_roster / write_island_caller_roster：反射读写名单 CSV，写后重载 ProfileService 并重新 Initialize() CoreService 使其立即生效。

B. ClassIsland-SecAgent-Connector

• secagent-plugin.json：权限追加 "agent.pre_rules"，版本 bump 至 1.1.0。
• main.mjs：仿 SecRandom 增加 registerPreRule("islandcaller_call", parseIslandCallerPreRule)，正则匹配「点名/随机点名/抽人/抽个学生/抽取/抽（N 人）」等，命中调用 call_island_caller 并渲染“点到：XXX”；连接时注册、断开时注销。
• scripts/build.mjs：zip 文件名改为 1.1.0；skills/classisland/SKILL.md 与 README.md 补充 IslandCaller 说明。

建议的下一步

1. 按上述方案在 /tmp/opencode/plugin 与 /tmp/opencode/connector 提交改动（各自新建分支），dotnet build 验证 C#、node --check + node --test 验证 JS。
2. 两个仓库分别 gh pr create（opencode 基础设施会自动处理 push/PR）。
3. 提醒：若用户同时安装 SecRandom 与 ClassIsland 两个连接插件，两者前置规则都可能命中「点名」，需在 PR 描述中说明“先注册者优先”的行为。

opencode session  |  github run

[PANDAJSR]

/oc 继续

[github-actions]

已达最大步骤上限（Maximum steps reached），本轮无法继续调用工具，只能给出文字总结。

本轮已完成的工作

在本轮（/oc 继续）中，我完成了全部调研与方案落地的准备，但尚未写入任何代码改动：

1. 克隆并核实了四个仓库（均在 runner 中可用）：

   • SECTL/ClassIsland-SecAgent-Connector（SecAgent 端连接插件，main.mjs 127 行 + secagent-plugin.json）
   • SECTL/ClassIsland-SecAgent-Plugin（ClassIsland 端插件，Plugin.cs 1592 行）
   • SECTL/SecRandom-SecAgent-Connector（前置规则参照实现）
   • HickoryTrail/IslandCaller（只读调研，不修改）

2. 验证构建：dotnet build 在 /tmp/opencode/plugin 通过，0 警告 0 错误。

3. 确认了 IslandCaller 全部相关 API（关键结论，均已逐一读源码核实）：

   • IslandCallerService.ShowRandomStudent(int stunum) 是 public async void，同步段先 CoreService.GetRandomStudent() 抽取并逐人写入 HistoryService.top20List（private 字段，反射可读），随后才 await Task.Delay；因此调用返回后读取 history 前 count 条即为被点学生名单。
   • 就绪门控是 Status.IsPluginReady（由 Profile/History/Core/IslandCallerService/时间状态/占用标志组合而成），未就绪时 ShowRandomStudent 直接 return。
   • 名单：ProfileService.Members（Person{Id,Name,Gender,ManualWeight}）、GetMembers(Guid)、SaveProfile(Guid,List<Person>)、LoadSelectedProfile(Guid)；ProfileRuntimeService.Reload/EnsureLoaded/Initialize 可在写名单后热重载 CoreService/HistoryService。
   • 设置：Settings.Instance.Profile.ProfileList（Dictionary<Guid,string>）与 DefaultProfile（Guid）。
   • 全部服务以单例注册在 ClassIsland DI 容器，SecAgent 插件可通过反射 IAppHost.Host.Services.GetService(type) 获取，无需改动 IslandCaller 本体。

4. 读通了 SecAgent 前置规则机制（src/plugin-manager.ts 的 PluginPreRuleMatcher / PluginPreRuleMatch，src/runtime.ts 的匹配→callTool→render 流程）：工具调用抛异常会回退 LLM 并注入失败上下文，因此 call_island_caller 应返回结构化结果而非抛错（如 IslandCaller 未安装时返回 {ok:false, message:"…"}，由 pre-rule 的 render 转成友好文案）。

剩余未完成的工作

A. ClassIsland-SecAgent-Plugin 的 Plugin.cs（主要改动）——在 Tools() 目录与 CallTool switch 中新增：

• call_island_caller（非 hidden）：count(1–20，默认 1) → 反射调 ShowRandomStudent，读取 history 前 count 条返回 {ok, installed, ready, triggered, students, message}；IslandCaller 未安装/未就绪时返回明确信息。
• list_island_caller_profiles（hidden）：列出 ProfileList 的名称/ID/人数。
• read_island_caller_roster / write_island_caller_roster（hidden）：反射读写名单 CSV，写后经 ProfileRuntimeService 热重载。

B. ClassIsland-SecAgent-Connector：

• secagent-plugin.json：权限追加 "agent.pre_rules"，版本 bump 至 1.1.0。
• main.mjs：仿 SecRandom 增加 registerPreRule("islandcaller_call", parseIslandCallerPreRule)，正则匹配「点名/随机点名/抽人/抽个学生」等，命中调 call_island_caller 并渲染「点到：XXX」；连接时注册、断开时注销。
• scripts/build.mjs：zip 文件名改 1.1.0；skills/classisland/SKILL.md 与 README.md 补充 IslandCaller 说明（注意：automation.md/coverage.md/plugins-themes.md 三个 skill 文件为 UTF-16 无 BOM 编码，编辑需先转码）。

C. 发布：两个仓库各自新建分支提交、dotnet build / node --check 验证后开 PR（opencode 基础设施会自动处理 push/PR）。

建议的下一步

1. 直接在 /tmp/opencode/plugin 与 /tmp/opencode/connector 按上述方案写代码并各自建分支。
2. dotnet build 验证 C#、node --check + 手动测试验证 JS（预规则匹配）。
3. 两个仓库分别 gh pr create。
4. 在 PR 描述中说明：若同时安装 SecRandom 与 ClassIsland 两个连接插件，「点名」类关键词可能都被前置规则匹配，SecAgent 按先注册者优先执行。

opencode session  |  github run

[PANDAJSR]

/oc 继续

[github-actions]

GitHub Actions is not permitted to create or approve pull requests. - https://docs.github.com/rest/pulls/pulls#create-a-pull-request

opencode session  |  github run

[PANDAJSR]

/oc 重试

[PANDAJSR]

/oc 重试

[opencode-agent]

本次 /oc 重试 已完成 IslandCaller 支持的完整实现。三个仓库各有一个已提交的分支，等待基础设施自动推送并开 PR。

已完成的改动

1. SECTL/ClassIsland-SecAgent-Plugin — 分支 feat/island-caller-support

Plugin.cs 新增 4 个 HTTP 工具（全部通过反射访问 IslandCaller，不编译期依赖其程序集，未安装时返回明确信息而不是抛错）：

• call_island_caller（非 hidden）：count(1–20，默认 1) → 通过 DI 反射取得 IslandCallerService，校验 Status.IsPluginReady，在 UI 线程调用 ShowRandomStudent(count)，再读 HistoryService.top20List 私有字段返回被点学生名单。返回 {ok, installed, ready, triggered, count, students, message}。
• list_island_caller_profiles（hidden）：列出 Settings.Instance.Profile.ProfileList（GUID/名称/成员数）。
• read_island_caller_roster（hidden）：读名单 CSV。
• write_island_caller_roster（hidden）：写名单 CSV 并调用 ProfileRuntimeService.Reload 热重载。
• manifest.yml 版本 bump 至 0.1.1.0；README 补充说明。
• 验证：dotnet build 0 警告 0 错误。

2. SECTL/ClassIsland-SecAgent-Connector — 分支 feat/island-caller-support

• secagent-plugin.json：权限增加 agent.pre_rules，版本 bump 至 1.1.0。
• main.mjs：新增 parseIslandCallerPreRule（仿 SecRandom），正则匹配「点名/随机点名/抽人/抽个学生/抽N个人」等（含中文/阿拉伯数字人数，1–20），命中后调 call_island_caller 并渲染「点到N人：…」；仅在 catalog 暴露 call_island_caller 时注册前置规则，连接时注册、断开时注销。
• scripts/build.mjs：zip 文件名改为从 secagent-plugin.json 读版本。
• 新增 test/main.test.mjs（5 个用例，npm test 全绿）验证正则与渲染。
• skills/classisland/SKILL.md 与 README 补充 IslandCaller 工具说明。

3. SECTL/secagent-plugin-marketplace — 分支 feat/classisland-island-caller

plugins/classisland-connector.json 的 permissions 增加 agent.pre_rules（与 plugins/secrandom.json 一致），供定时索引生成器发布新权限。

关键设计说明

• 无需改动 IslandCaller 本体：其服务已注册在 ClassIsland 共享 DI 容器，SecAgent 插件通过 IAppHost.Host.Services.GetService(type) + 反射直接驱动。
• 线程安全：ShowRandomStudent 内部会创建 Avalonia 窗口，通过 Dispatcher.UIThread.Invoke 在 UI 线程执行；top20List 在调用前/后各读一次计数，只返回本次新增的被点学生。
• 容错：IslandCaller 未安装/未就绪时返回结构化 {ok:false, ...}，前置规则渲染友好文案，不会抛错回退 LLM。

遗留说明

• 若同时安装 SecRandom 连接插件，两者都可能命中「点名」类关键词，SecAgent 按插件注册顺序先注册者优先——已在两个 README 中注明。
• 名单 CSV 读写与 IslandCaller 的 %APPDATA%\IslandCaller\Profile\{guid}.csv 格式（id,name,gender,manualweight）对齐，gender 0=男、1=女。
• 端到端（ClassIsland 内实际安装 IslandCaller + 触发点名窗口）需要 Windows/ClassIsland 环境，本次仅在 runner 上完成构建与单测验证。

opencode session  |  github run

[opencode-agent]

User opencode-agent[bot] does not have write permissions

github run