前言¶

在 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 级）合计概览、分年级指标卡、学科/教师/自学等表格。

三种导出模式¶

工具栏三颗按钮各自生成，写入 <报告目录>/<学校>/<起止>/，同名区间下三版共存：

简报版阈值集中在 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. 首次绑定并取数¶

1. 打开工作台「教学数据报告」。
2. 填写学校子域名、账号密码（或使用已保存绑定）。
3. 选择统计区间，点击「获取数据」。
4. 在工具栏选择「正式版 / 简报版 / 交互版」之一生成文件；默认报告目录为 <用户主目录>/辅立码课数据报告，可用 outputDir 或环境变量 FUULEA_REPORT_DIR 修改。

2. 常用配置（cordis.patch.yml 的 config，均可省略）¶

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 为准。

• 目录页：https://www.skillhub.cn/plugins/100759/dsh-fuulea-report
• GitHub：https://github.com/100759/dsh-fuulea-report