ClassIsland / ClassHelper 灵动岛提示词套件
本仓库是「以 ClassIsland 为基准、重构 ClassHelper 灵动岛」的完整提示词交付物与相关调研记录。内容面向 ChatGPT 等代码生成模型：既可整体投喂，也可按分卷/逐章投喂。
所有内容均由静态源码分析生成，不包含 ClassIsland 或 ClassHelper 的上游代码；仓库中不含
repos/克隆、构建产物或运行时依赖。分析过程中没有构建、运行或截图任何桌面程序。
- 已发布仓库（私有，Gitea）：http://210.126.232.10:3000/Love_Chengke/classhelper-island-refactor-prompt
- 克隆地址：
git clone http://210.126.232.10:3000/Love_Chengke/classhelper-island-refactor-prompt.git
一、仓库内容
| 路径 | 说明 |
|---|---|
ClassHelper灵动岛重构-给ChatGPT的完整提示词.md |
主交付物（重构版）：在 ClassHelper 现有仓库内重构灵动岛的完整提示词；14 个 part（0–13），约 30 万字符，约 12.3 万 tokens |
out/投喂指南-重构版.md |
重构版投喂指南：准备、分卷方案、token 估算、追问话术 |
out/vol1-… ~ out/vol5-… |
重构版 5 个分卷（适合 32k–128k 上下文模型） |
out/refactor-sections/ |
重构版 14 个独立 part（逐章投喂） |
ClassIsland-给ChatGPT的完整提示词.md |
上一轮产物：ClassIsland 全功能「从零实现」规格（约 20 万 tokens），含主界面/组件/课表/提醒/自动化/主题/设置/插件/数据/动画/验收等完整规格 |
out/投喂指南.md |
上一轮产物的投喂指南 |
out/vol1-… ~ out/vol5-…（旧五卷） |
上一轮产物的分卷 |
out/sections/ |
上一轮产物 20 个独立 part |
parts/ |
上一轮 20 个 part 源文件（01–19） |
parts-r/ |
本轮 14 个 part 源文件（00–13） |
analysis/ |
调研记录：两份总简报、一致性基线、各成员的已读文件/决策/未决项 |
scripts/ |
内部工具：分卷组装、质检、指南生成、一致性修补脚本（非运行时依赖） |
二、两份主提示词如何选择
- 你的目标是「重构 ClassHelper 的灵动岛」 → 使用
ClassHelper灵动岛重构-给ChatGPT的完整提示词.md。它包含 ClassHelper 现状基线、文件级改造清单、islandLayout.version=2迁移、ClassHelper 数据契约、编辑器/设置页重构、验收与里程碑。 - 你的目标是「从零实现一个 ClassIsland 等价应用」（Electron + Vue 3） → 使用
ClassIsland-给ChatGPT的完整提示词.md。 - 两份冲突时，以重构版为准（它包含 ClassHelper 现状与迁移约束）；ClassIsland 版仅作为补充的原版细节参考。
三、重构版要点（提示词已详细展开）
- 默认采用 ClassIsland 规格：
fixed在family='classisland'下重定义为 40px 信息行（默认日期 + 课程表、行内气泡、3px 进度条）；旧「胶囊 + 详情卡」作为winisland兼容风格保留，老用户升级默认winisland。 custom布局始终按 ClassIsland 规格重构，family只影响fixed。- 消息/课程提醒/强提醒/天气/课件覆盖继续使用 ClassHelper 的服务端数据与业务规则。
islandLayout.version=2：迁移先行、备份/回滚、幂等；旧 schemes/rows/nodes/外观全部保留。- 动画表 84 条、组件 11+ 类、编辑模式/行设置/组件设置抽屉逐像素规格。
- 所有自动验证必须无头运行；
--visual才允许桌面截图/动画验收（详见提示词第 11、12 部分）。
四、使用建议
先读对应 投喂指南，按「五卷」或「逐章」投喂；给模型 ClassHelper 仓库作为代码上下文（重构版必须）；开场要求模型先输出文件级计划、迁移方案与无头验证方案，再开始改代码。
五、来源与合规
- 行为与视觉基准：ClassIsland（GPL-3.0，https://github.com/ClassIsland/ClassIsland），仅作为静态分析对象，仓库不包含其源码/资源。
- 技术栈与现状基线：ClassHelper（https://github.com/LoveChengke/ClassHelper），仅作为静态分析对象，仓库不包含其源码/资源。
- 文中引用的
packages/...:行号、repos/ClassIsland/...:行号是分析时的证据位置，不是本仓库的运行时依赖。 - 部分 FluentAvalonia 主题色值、Avalonia 缓动到贝塞尔曲线的换算不在上游仓库内，已在正文标注【推断】。
- 若将提示词用于再分发，请遵守上游项目的许可与商标要求；本仓库仅包含原创分析文本与规格描述。
六、生成与复现
- 汇总重构版：
node scripts/assemble-r.mjs --split - 汇总 ClassIsland 版：
node scripts/assemble.mjs --split - 机械质检：
node scripts/qc.mjs、node scripts/check-r.mjs、node scripts/checkfinal.mjs - 重新生成投喂指南：
node scripts/guide.mjs - 推送到 Gitea（令牌只从环境变量读取，不写入仓库）：
GITEA_TOKEN=<token> node scripts/push-to-gitea.mjs；等价 PowerShell：powershell -ExecutionPolicy Bypass -File scripts/push-to-gitea.ps1 - 这些脚本只做文本合并/统计与 Git 操作，不会构建或运行桌面应用。
七、已知限制
- 提示词长度较大（重构版约 12.3 万 tokens），请按指南分批投喂；不要指望小上下文模型一次吃下。
- 部分 ClassHelper 现状细节（
main/island.ts的行号区间、编辑器交互）以分析时源码为准，后续仓库演进可能导致行号漂移；以函数/符号名检索更可靠。 - ClassIsland 版本为分析时的 v2.1（master 分支）；上游后续变化可能产生差异。