# 新作文大师 · WorkBuddy / DSH 服务端入口

电脑里的小助手负责管理老师的个人要求：新任务先 preferences-read 读取已确认结构、标准和习惯；老师在对话里明确调整后，直接用 preferences-save 保存到本机，下一篇自动沿用，不再要求重复确认或手动保存。仅本次的要求不改长期设置。小助手将原稿和本次有效要求交给服务器批改，后续调版、修改继续与当前模型对话。只保存老师已确认的决定，不把整个聊天上传服务器。
当前专家版本：2.0.38。

本版故障处理：报告页面继续查询原失败批改任务，维护处理后自动取回已完成报告；逐篇保存，单篇异常不挡住其他报告。不重新上传或自动重新批改；原稿核对问题和内容质量问题仍需分别处理。

本版按篇交付：一篇异常不停止其他篇，已经完成的报告立即可取；短时断线沿原任务恢复，保留已下载报告，不重新提交付费批改。整批未完成会清楚列出剩余篇目及原因，讲评仍按老师已确认的选择继续。

在当前对话上传作文并说“帮我批改作文”，随后显示已定的毛绒写作小屋要求页；默认先收作文、再选要求。只有老师主动要求先设置时才允许先开页。已经确认的个人要求继续沿用。确认后固定程序保存任务编号、显示实际进度并取回报告；需要核对原稿或整理新的要求时，由当前助手接手，完成后继续同一任务。页面等待、任务排队不代表已经批改完成；关闭对话后需要语义核对时，回原对话继续即可，不重新提交整批。

重复安装时，注册器核准专家登记和全部10个入口文件一致后直接复用，不重复复制旧渲染依赖或制作同内容备份；需要升级或修复时仍按原流程备份并核验。批改用量随任务自动记入本机费用记录，续接及重导出按原任务去重；估算与实付分别显示，未取得的金额保留未知，不把批改小计当作聊天、OCR和讲评的全部账单。

已批改报告调整栏目顺序、标题和显示范围时，使用固定的服务端批量重排流程，复用原批改数据，不在老师电脑逐份打印、不重做OCR或批改。新增或改写个人栏目时仅生成发生变化的栏目，保留原评分和已有内容；费用、准备与模型及导出耗时单独记录。改评分标准或全文写法须明确重新批改。服务端未更新局部修改能力时会明确提示，不自动退回整篇重批。已确认模板沿用；报告不附加平台署名。

## 权限统一用手机验证码

作文大师的批改、讲评、模板、报告下载和个人经验共用一份授权。谢老师已授权的教师，在当前对话使用本人手机号和短信验证码验证即可；已有有效授权自动沿用，不要求另外注册网站账号或登录网站。任何接口提示需要验证，助手都应转到当前对话的手机验证码流程，验证成功后接着原任务。已记住手机号直接沿用，没记住才询问；验证码由老师本人提供，不自动反复发短信。授权记录未通过则联系谢老师核对，不能引导另买讲评权限。

保留“知道，共〔数字〕篇 / 我也不知道”的前置选择；每页原稿必须有记录，少字或识别失败的页保留待核对，不能当空白删除。篇数每批重新选择，原稿页数和作文篇数分别统计。本机同一次OCR请求开启方向校正，不额外自动重试。本版接通个人经验保留、问题反馈和核验后的公共改进。

连接器在授权成功后自动检查官方更新：先核对版本和文件指纹，失败保留任务，但不把未核准入口说成已就绪。批改、调版等业务命令也会自动核准；更新后助手重新读取新版用法再续接，老师无需重新发链接。服务器批改规则随服务器更新；清理旧版不等于本地连接器已经更新。2.0.9及以前的入口须先从这里更新一次，以后自动检查。有效授权和个人资料沿用，不反复卸载或发验证码。现有程序不支持的需求交维护端处理，不让老师写脚本。官方批改引擎由服务端维护，老师端只安装专家入口。

日常单篇仍用task，批量仍用batch-task：提交材料、核对原稿、取回报告。老师首次明确绑定自己的模型API Key，服务端加密保存并调用模型，核心批改提示词不下发。断线续接原任务，已成功报告不重批。照片原稿仍使用本人本机OCR并按原图核对完整性。

助手先按当前宿主分流：当前在 DSH 或从 `dsh-essay-install.md` 进入时，只执行下方“DSH 直接接入”，不要执行 WorkBuddy 专家注册步骤；当前在 WorkBuddy 时执行 WorkBuddy 安装。目录、手机号和验证码始终在当前聊天问答；已有要求和本机个人版沿用。收到作文并要求批改后显示同一份毛绒要求页；确认前不识别、不批改。本页只处理批改报告；老师另有明确讲评请求时再沿既有讲评专线，不主动增加讲评任务。

安装与手机授权仍在当前对话完成。缺少模型API Key时只做一次本人Key绑定；不抽取宿主内部凭据，不使用聊天会员额度，不自动注册或充值。旧完整本地引擎和旧设置助手不再使用。

## 老师怎么装

1. 以前安装过的老师：**请选择你当初安装作文大师时选的那个文件夹。** 第一次安装的老师：请选择今后保存作文资料的文件夹。助手会在聊天提醒；已记住实际路径时直接沿用并告知，不需要重新选择。老师只需选择整个文件夹，不用判断删哪个程序文件。
2. 在 WorkBuddy 当前对话发送：**请读取 https://laoxieduxieke.cn/workbuddy-essay-expert-install.md ，在当前对话安装或更新新作文大师并清理旧程序；文件夹、手机号和验证码都在这里问我，保留作文、报告和个人设置，完成后接着使用。** WorkBuddy 自动下载并安装 [新版专家包](https://laoxieduxieke.cn/assets/workbuddy/laoxie-essay-grading.zip)，接着在原对话清理。老师不用再点击专家卡片或另发“清理”口令。
3. 已验证且权限有效的老师直接完成清理；首次使用或验证过期时，助手在当前对话询问已授权手机号、通过 auth-send 发送验证码，再询问老师本人收到的六位验证码并通过 auth-verify 提交。不打开网页表单。未开通权限先联系谢老师。验证后，助手在原对话继续，不新开空白对话。
4. 已绑定模型API Key直接沿用；未绑定时依新版SKILL的key-bind命令，经标准输入传入老师明确提供的key、provider、model。只支持登记的官方供应商，不将Key写到日志或命令行。绑定不发付费测试请求。
5. 连接器还会安装全局常驻轻入口。原对话完成后可直接上传作文；下次新建任务也只需上传作文并说“批改作文”，不用再安装、点专家卡或发连接口令。已上传的作文接着处理。

新老师和老老师安装同一个包。新电脑不需要安装完整批改 Skill、Python或报告导出环境；OCR沿用老师已部署的本机配置。安装器会先验证 WorkBuddy 自带运行时；当前机器不支持时会明确报告，不能谎称安装成功。

## DSH 直接接入

在 DSH 当前对话发送：**请读取 https://laoxieduxieke.cn/dsh-essay-install.md ，在当前对话安装或更新新作文大师并清理旧程序；文件夹、手机号和验证码都在这里问我，保留作文、报告和个人设置，完成后接着使用。**

DSH 无需安装 WorkBuddy 或注册 WorkBuddy 专家。下载同一个官方 ZIP，用系统解压工具解到 `~/.laoxie/cloud/connector/`，读取 `laoxie-essay-grading/skills/essay-grading-setup/SKILL.md`，优先用经实际验证的 DSH 自带 Node，其次已有 Node 22 以上运行 `skills/essay-grading-setup/scripts/cloud-client.mjs`。macOS DSH 已验证自带运行时：`/Applications/DeepSeek Harness.app/Contents/Resources/runtime/primary-runtime/dependencies/node/bin/node`；Windows 从实际应用位置查找并验证，不能猜路径或要求老师额外安装整套批改环境。每次安装前先读包内技能的运行时预检说明。

先确定老师实际资料目录；以前装过但路径未知时，明确提醒“请选择你当初安装作文大师时选的那个文件夹”。再执行 `connect --workspace "<资料目录>"`。`NEEDS_WORKSPACE` 就在当前聊天问路径；已有授权直接在原对话接续；返回 `NEEDS_PHONE` 就在聊天询问手机号，再用 `auth-send` 请求短信、`auth-verify` 提交老师回复的验证码，具体 stdin 调用见包内技能。`READY_IN_CURRENT_CHAT` 后读取连接器新版 SKILL；收到老师上传的作文后展示原毛绒写作小屋要求页，先收作文、再确认要求、再识别和批改，不用聊天选项替代。登录和短信授权在当前对话完成，不另开登录网页；这不限制批改要求页的展示。保留原对话，不调用旧连接器，不复制 DSH 的模型 Key。

升级仅替换 `~/.laoxie/cloud/connector/laoxie-essay-grading/` 中的官方连接器程序；保留 `~/.laoxie/cloud/` 中已有授权、目录记录和老师资料。安装会在 DSH 支持的用户级 `.agents/skills/essay-grading/` 注册常驻轻入口，新对话上传作文说“批改作文”即可复用连接。需要重发验证码时先取得老师明确要求，不因断网自动重复发短信。

## 个人设置与旧版清理

个人使用经验保存在资料文件夹的“我的使用经验”中，程序更新保留当前经验和历史。老师明确纠正或本机验证有效的办法，由助手保存；以后新任务结合适用的个人经验和官方改进。程序发现的问题先在本机记录，连接时把问题类型、环节、版本及同账号任务编号反馈给维护方；断网会保留待同步记录，不额外识别或重批。个人经验正文、学生原稿和密钥不随反馈上传；老师明确同意分享处理办法时才发送去除个人资料的摘要。维护方核验和修复后再发布公共改进，老师不用承担修产品的责任。

个人版和个人标准继续保存在老师自己的资料文件夹。每次批改都会读取本机当前选择，并随本次任务提交服务端；服务端不会用另一个账号默认版把本机设置盖掉。调版样张确认后保存回本机。同一台电脑换资料文件夹，或换电脑，需要带上原来的个人设置文件夹。

旧版清理只停用已确认归属的旧 Skill、旧专家发现入口，先留可恢复备份，再接新版入口。老师的原稿、报告、个人模板、个人标准、讲评、经验，以及支持个人版的旧渲染程序和依赖均原位保留，不删除整个文件夹。同名但归属不明的入口不删除，先说明冲突。只清理已确认资料目录及登记入口，不凭当前目录声称全电脑已清理。后续批改走新连接器，保留旧依赖不表示继续运行旧批改流程。

## WorkBuddy 安装执行说明

使用本包 register-expert.mjs 按内置 expert-manager 的目录格式静默注册，保持专家身份 `laoxie-essay-grading`。只替换这个专家核准的入口与连接器文件，保留旧 bundle、渲染程序及依赖，不能删除混在其中的个人资料。先封存该专家旧程序目录，个人资料若混入其中须保留。**注册后不跳转、不新建聊天、不要求老师点击“清理旧程序”卡片。** 当前助手直接读取新专家的 agent 和 `skills/essay-grading-setup/SKILL.md`，运行 `cloud-client.mjs connect --workspace "<当前资料目录>"`。需要验证时在当前对话完成 `auth-send` / `auth-verify`；收到实际清理成功回执后在原对话给出明确的上传作文提示。安装目录必须取注册器实际返回路径，不能继续调用旧专家缓存。不要下载 `essay-grading.bundle.enc`，不要执行旧 `expert_install.py`、`chat_onboarding.py` 或项目本地批改 SKILL。

新电脑没有 Python 时，不要为专家注册另装 Python。先用系统自带的解压能力解开这个 ZIP（Windows `Expand-Archive`，macOS `ditto -x -k`），再用经过验证的 WorkBuddy Electron Node 模式运行包内 `skills/essay-grading-setup/scripts/register-expert.mjs`。它采用内置 expert-manager 的相同目录与注册格式，不写入并清除旧 `.created-by-session` 会话标记，避免触发宿主专家详情/测试侧栏；不要另调 expert-manager 创建/预览工具；随后当前助手直接读取安装后的新版文件并运行 connect，无需切换对话才能调用脚本。注册脚本已检查包身份和文件完整性，旧专家先备份，新入口覆盖；旧渲染程序、bundle 和个人文件原位保留。

专家内连接器只使用 Node 标准库。macOS 已验证 WorkBuddy Electron Node 模式及 DSH 自带 Node；Windows 按实际应用路径先验证运行时，不猜路径。手机号和老师本人收到的验证码在当前对话提供，连接器通过 stdin 接收 JSON 后调用正式短信接口。验证码不落盘、不回显，会话凭据不进入聊天或命令行参数。缺凭据时先问手机号，不能直接说用户未授权；未授权不自助开通。连接器已经移除网页表单，旧 setup-browser 口令也回到聊天流程，缺Key时只做一次明确绑定。

服务端版本未就绪、授权失效或网络中断时停止并保留任务编号，不转用旧本地批改，不自动重复调用付费 OCR 或模型。

## 新旧老师的日常用法相同

新老师仍安装“小学作文批改助手／新作文大师”，首次在聊天验证授权；老老师更新并清理后保留同一入口。两者后续新建任务上传作文，说“批改作文”即可。连接器保留已验证授权、资料目录和常驻触发入口，服务器每次核验权限。权限过期才在原对话重新验证，不要求每次安装。

本机保留的是轻入口、授权凭据、老师个人模板/个人标准、原稿和取回的报告。正式官方规则、OCR选型与流程、证据及内容检查、报告排版和PDF导出由服务端维护；付费OCR请求在老师电脑用本人账户发起。旧发现入口停用，渲染依赖原位保留；入口备份在技能扫描目录外，不能作为批改流程执行。老师自己制定的批改标准保留，每次按当前选择提交给服务端，不是继续执行旧官方引擎。

多页照片由服务端免费拆页和处理原稿选区，连接器在老师电脑按本人OCR额度并行识别，回传同次原始结果并按原页序还原。批改由服务端使用老师明确绑定的模型API Key执行；不向老师端交付核心提示词。

收到老师上传的作文并要求批改后，在WorkBuddy/DSH内部显示同一份 `report-page` 毛绒选择页，一次确认本次批改要求与个人定版，已知信息预填；默认先收原稿再选要求；只有老师主动要求先设置时才先开页。确认后用 `report-wait` 等待，需要核对时由当前助手完成一次核对，再用 `report-continue` 沿原任务继续，不能把保存或排队当完成。没有另行要求讲评时只交批改报告；老师已经明确要求讲评的，沿既有专线完成后一起交付，不在批改中擅自增加。页数按本批内容确定；本机已确认的个人版优先，没有则使用服务端版式，沿用已有授权。最多100篇批次逐篇推进，服务器并发以实时状态为准，本次升级默认为全站128篇、每账号8篇；模型等待与原稿准备、报告导出分开，实际额度服从供应商限制，配置容量不等于实测吞吐。帮改版给具体改法和修改稿，引导版用批注和局部示范；关怀档达到本次要求即停，提优档按文章需要提升。已有个人结构直接沿用，新结构经老师确认后才保存为默认。

## 正式用户自有算力与报告署名（2.0.12）

只有网站“作文试用”可以使用谢老师的模型Key和OCR。此WorkBuddy/DSH专家属于正式使用入口，即使账号处于限时授权，也只用老师明确绑定的模型API Key及本人已部署的OCR；绝不能改走网站试用或旧服务器OCR接口兜底。

`run`及`ocr`已自动处理本机百度手写OCR：优先使用当前进程的`BAIDU_OCR_ACCESS_TOKEN`或`BAIDU_OCR_API_KEY`/`BAIDU_OCR_SECRET_KEY`，否则读取本机`~/.laoxie/config.json`中的`baidu_ocr_api_key`和`baidu_ocr_secret_key`。其他已部署位置可用`LAOXIE_OCR_CONFIG`指向老师明确指定的配置文件（同样字段，或`ocr.api_key/secret_key/qps`），不读出/回显密钥、不上传、已绑定模型Key自动沿用。配置不在登记位置时，只在当前对话问已部署配置在哪里；不重新安装OCR、不弹供应商网页、不能声称已经调用未接入的MCP。

OCR按本人已确认额度设置`baidu_ocr_qps`或`BAIDU_OCR_QPS`；未登记时保守按2QPS。老师已开通并确认10QPS时沿用10。同一电脑多篇和多进程共享该账户的发起速率，不能每篇各算10QPS。QPS是每秒请求数，不是同时在途数量。识别结果逐页落盘，断线续接不重做已有结果。结果不明时先说明，再取得本次明确同意，用原`run --retry-ocr <错误里给出的原稿任务编号>`只重试未成功页，每个编号只使用一次授权；不得循环重试。

报告正文、页眉页脚与交付文件名不附加“谢华版”“谢华老师”“老谢读写课”等平台署名；选择页允许沿用模板内部名称，但最终报告用中性名称“作文批改报告”。不删除作文原文中的真实姓名、老师自己填写的署名或教学内容。

## 讲评与等待

讲评按实际内容安排页数，不固定29页；已有内容只做一次格式适配，服务器固定排版导出，不再重新写稿。已有定版优先沿用。报告与讲评共用当前授权，失败只重做出错的环节；导出故障不要求老师改内容。批改选择页由同一份HTML在WorkBuddy/DSH内部预览，确认后回原任务，默认不弹系统浏览器。批改与讲评回执分别记录模型等待、服务端导出与下载耗时，正常只显示必要进度和成品。

新批量及批改后讲评统一使用当前SKILL的batch-task固定口，单篇仅报告用task。先读本机已确认要求，已知事项不重复询问；程序保存任务、拆PDF与归拢成品，宿主只回传分篇、核对及教学内容数据，不临时编写技术程序。核心引擎不安装到教师端。

选择页回传失败或点击后聊天未继续时，提供“生成并复制继续批改提示词”，在原对话发送以续接；不把网页按钮当作宿主唤醒接口。先核对已有批次、OCR和响应，不重建或重复付费。分篇按完整篇增量提交，当前篇task启动后继续核对余页，最后核齐全部原稿才交付全批。

### 2.0.38 批量续接修复

提前提交完整分篇不会停止后续页识别。沿用原资料目录和原batch_id，已经识别的页面与已产生的报告继续复用，不手改批次状态、不故意少交最后一篇、不新建重批任务。更新完成后，有运行中任务就沿原任务续接；没有任务时等待老师上传作文，再弹批改要求页。识别进度、报告数量和真实暂停原因用中文显示。

当前批改统一规则：只选帮改或引导，再选关怀或提优。帮改须达到字数和目标，提优再改善；引导保留原文，只用红字教修改。新任务不按20分切换方式。