前言¶
在 DeepSeek Harness（DSH）里做学校侧数据分析，常见做法是手写脚本登录智慧教学云、导出 xlsx、再拼 Word 或 Markdown。账号要反复填、口径要对齐管理看板、正式公文、领导简报、可交互 HTML 往往是三套流水线。下面介绍社区工作流插件 dsh-fuulea-report（维护者 100759）：在本机 DSH 工作台绑定学校子域名后，从辅立码课站点只读拉取「管理看板」数据，在同一页面生成正式版、简报版、交互版报告，并支持版本检查与一键更新。
这是什么¶
dsh-fuulea-report 是 DSH 工作台插件，定位是「辅立码课（智慧教学云）教学数据报告工作台」。它解决三类问题：多学校账号在本机绑定与切换、按统计区间取数并清洗成报告模型、按用途导出三种互不覆盖的报告文件。插件以当前 DSH 进程权限访问本机与学校 HTTPS 接口；打开工作台页面默认不自动联网取数，需点「获取数据」或开启自动拉取。
社区目录页：https://www.skillhub.cn/plugins/100759/dsh-fuulea-report
源码与说明：https://github.com/100759/dsh-fuulea-report（MIT，当前 package.json 版本 1.5.0）
核心功能¶
工作台与取数¶
- 重启 DSH 后，左侧出现「教学数据报告」入口，进入整页工作台。
- 学校绑定：首次填写子域名与账号密码；成功后凭据与 JWT 写入本机
~/.fuulea-report/bindings.json（目录0700、文件0600），之后打开页面自动登录，可在已绑定多校之间切换。 - 取数时机：默认打开页面只回填上次学校与区间，点「获取数据」才请求平台；工具栏可勾选「打开时自动拉取」，或在
cordis.patch.yml设autoFetch: true。 - 统计区间支持近 7 / 14 / 30 天快捷选择与自定义起止；页面展示三届（2024/2025/2026 级）合计概览、分年级指标卡、学科/教师/自学等表格。
三种导出模式¶
工具栏三颗按钮各自生成，写入 <报告目录>/<学校>/<起止>/，同名区间下三版共存：
| 版本 | 用途 | 主要产出 |
|---|---|---|
| 正式版 | 送审/归档完整公文（封面、目录、逐届章节、总结、口径附录） | Markdown、HTML、Word（.docx）、PDF |
| 简报版 | 领导速览（约 1～2 页/届，对齐《使用情况简报》体例） | .docx、.pdf |
| 交互版 | 浏览器内可点选的单文件报告（图表交互、可离线双击打开） | 单文件 .html（无 CDN 外链） |
简报版阈值集中在 lib/brief.js 顶部 BRIEF 常量，可按校调整。历史报告由插件扫描输出目录分组列出，可直接打开，无需重新取数。
版本与更新¶
页面右上角显示当前版本；Host 每 10 分钟最多向 GitHub 查一次最新版。有新版本时徽标变红并提示「立即更新 / 检查更新 / 查看更新说明」。点「立即更新」会在本机 profile 执行 pnpm add github:100759/dsh-fuulea-report，完成后需重启 DeepSeek Harness 生效。内网可设 checkUpdates: false。
Agent 工具¶
插件注册只读工具 fuulea_teaching_report：action=preview 返回三届概览，action=generate 生成报告；mode 为 full / brief / interactive。与页面共用同一套 Host 逻辑与本机绑定，便于在对话中直接请求生成某校某区间的报告。
数据来源（只读）¶
平台 /v2 接口使用 Authorization: jwt <token>、uuid、fl-sec-sign（murmurhash3_x64_128，见 lib/api.js）。主要只读调用包括登录 POST /v2/auth/login/、导出统计 GET /v2/dashboard/export/、学情总览 GET /v2/dashboard/teach/。插件不写回平台数据。
安装与启用¶
安装前请自行阅读仓库源码与 MIT 许可证；插件会保存账号密码于本机（明文，与 README 所述「技能包凭据文件」做法一致），仅本机使用。
官方安装命令（README 原文，<你的 profile> 按环境替换，例如 desktop 或 web）：
dsh plugin --profile <你的 profile> add github:100759/dsh-fuulea-report
示例（desktop profile）：
dsh plugin --profile desktop add github:100759/dsh-fuulea-report
安装后 cordis.patch.yml 会自动在 profile 中插入 fuulea-report；若插件管理里显示未启用，手动启用一次并重启 DSH。本地调试源码可用 dsh plugin --profile desktop add link:/path/to/dsh-fuulea-report（link 安装时页面「立即更新」不可用）。
运行环境：package.json 要求 Node ^22.19.0 || >=24.0.0。
典型用法¶
1. 首次绑定并取数¶
- 打开工作台「教学数据报告」。
- 填写学校子域名、账号密码（或使用已保存绑定）。
- 选择统计区间，点击「获取数据」。
- 在工具栏选择「正式版 / 简报版 / 交互版」之一生成文件；默认报告目录为
<用户主目录>/辅立码课数据报告，可用outputDir或环境变量FUULEA_REPORT_DIR修改。
2. 常用配置（cordis.patch.yml 的 config，均可省略）¶
| 配置 | 默认值 | 说明 |
|---|---|---|
defaultSchool |
lyyz |
尚未绑定时默认子域名 |
outputDir |
主目录下「辅立码课数据报告」 | 报告输出路径 |
defaultDays |
14 |
页面默认统计天数（截止昨天） |
autoFetch |
false |
打开页/切校是否自动拉数 |
checkUpdates |
true |
是否联网检查 GitHub 新版本 |
repository |
100759/dsh-fuulea-report |
更新检查用的仓库 |
3. 在对话里生成报告¶
对 Agent 说明学校别名、日期区间与版本即可，例如 README 中的用法：「帮我生成 demo 学校 10 月 8 日到 21 日的报告」「给我一份这周的简报」「生成交互版数据报告」。底层调用 fuulea_teaching_report，与页面共用绑定与取数逻辑。
4. Host API（本机同源，供集成参考）¶
常见路径包括：GET /fuulea-report/api/defaults、POST /fuulea-report/api/snapshot（取数）、POST /fuulea-report/api/report（生成，mode 为 full/brief/interactive）、GET /fuulea-report/api/reports（历史列表）。完整列表见仓库 README「Host 接口」一节。
适用场景与注意¶
适合谁：需要定期从辅立码课管理看板出教学数据报告的学校信息化人员、教研管理员，或已在 DSH 中编排工作流、希望 Agent 与页面共用同一取数能力的开发者。
应注意：
- 插件以当前 DSH 进程权限运行，安装前应审查源码与许可证；密码存于本机 bindings 文件，页面仅脱敏显示账号。
- 正式版 PDF 依赖配置的 Chrome 路径（默认 macOS Chrome）；Linux 等环境需在
cordis.patch.yml调整chromePath。 - 社区目录 skillhub.cn 与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，本插件是独立维护的工作流扩展。
结尾¶
dsh-fuulea-report 把辅立码课管理看板的取数、三届口径清洗与正式/简报/交互三版导出收进 DSH 工作台，并支持多校绑定、历史报告管理与 GitHub 一键更新。需要细节、配置项与自测脚本时，以仓库 README 为准。
