前言¶
在 DeepSeek Harness（DSH）里，多数插件面向会写配置、会调 API 的开发者。日常「记待办、排优先级、到点提醒、把事拆成任务执行」若全靠手写脚本或外部 SaaS，要么门槛高，要么数据不在本机。下面介绍社区插件 dsh-xiaozhushou（npm 包名 dsh-xiaozhushou）：侧栏一块工作任务看板，屏幕边一只鲸鱼娘浮窗；待办、提醒与秘书 / CEO / 史官三角色对话收在一处，数据以 JSON / Markdown 留在用户目录，插件本身不联网、无遥测。
这是什么¶
dsh小助手是 DSH 的一个 bundle 插件，维护者为 Flamencoff，在 SkillHub 目录中归类为客户端。当前包版本 0.47.4（见仓库 package.json），适配 DSH 0.2.1-rc.3（engines.dsh），Node ≥ 20，Windows 10 / 11 已适配；Linux、macOS、鸿蒙未验证。代码 MIT 许可，零 npm 依赖。
定位是给不会编程的用户：装上后主要通过自然语言与侧栏 / 浮窗操作，不必写代码、不必单独配运行环境。
核心功能¶
侧栏工作任务看板¶
点侧栏 dsh小助手 图标打开整页看板。待办台账、优先级卡、任务板与三角色聊天集中在一页：优先级卡侧重紧急 / 重要项，待办卡展示全部事项与大致用时。
鲸鱼娘浮窗¶
常驻屏幕边缘，收起时只留形象；点开浮窗可看最急事项、快速记一条待办。可拖拽位置，右键隐藏或唤回。配置项 pet.enabled 默认 true。完整版浮窗 pet 仍在制作中，当前版本使用现有形象。
三个角色¶
- 秘书：简单陪聊、记待办。
- CEO：判断、拆解、派活与执行；可说「开新会话执行 …」在 DSH 里开 CEO 预设会话（标题
dsh小助手 · CEO 执行），权限审批由宿主在新会话中弹出。 - 史官：结构化记录，为长期记忆供数据；默认开启，且默认读取全部会话正文（
historian.scope.mode: all），可在 patch 中改为sandbox或关闭。
首次启动会自动创建三个角色会话（已有则复用）；角色聊天需绑定这些真实会话。
待办、优先级与提醒¶
支持候选待办确认（如确认编号、截止日期、紧急 / 重要标记）、已确认项参与提醒与优先级。定点提醒默认 09:00、13:00、18:00（alarm.fixedTimes）；确认制策略 alarm.policy: confirmed，静默时段默认 23:00–07:00。
长期记忆（简化版）¶
数据目录下 记忆/ 中四份 Markdown 由史官按规则周更，只重写 <!-- AUTO:START -->…<!-- AUTO:END --> 自动区；自动区外手写内容保留。秘书 / CEO 对话仅带入摘要，不做语义检索。
本地数据与接口¶
- 默认数据目录：
~/.dsh-session-steward/data（Windows 为C:\Users\<你>\.dsh-session-steward\data），可用dataDir修改。 - 插件向 DSH 本机 Web 服务注册 26 条 HTTP 路由，前缀
/api/dsh-xiaozhushou/*，仅监听127.0.0.1，不另开端口、不对外网关。 - 只有你主动在聊天框说话时，内容才会交给 DSH 宿主的模型服务。
安装与启用¶
安装 npm 包需联网；装完需重启 DSH 或刷新页面。--profile 请换成自己的 profile 名（如 web、desktop）。
方式 A：让 DSH 助手安装（免命令行）¶
把下面这句发给 DSH 助手：
帮我安装 dsh-xiaozhushou 插件，npm 包名：dsh-xiaozhushou
成功标志为返回 application: applied，再按提示重启 DSH。
方式 B：CLI（npm）¶
桌面版：
dsh plugin --profile desktop add dsh-xiaozhushou
Web 版：
dsh plugin --profile web add dsh-xiaozhushou
方式 C：CLI（GitHub 源码）¶
网络可访问 GitHub 时：
dsh plugin --profile web add github:Flamencoff/dsh-xiaozhushou
方式 D：本地路径或 tgz¶
在 DSH 里让 Agent 执行 plugin_manager · action=install_bundle，target 为本仓库绝对路径或 tgz 路径。
卸载示例（不删数据）：
dsh plugin --profile web remove dsh-xiaozhushou
桌面版将 web 换成 desktop。
典型用法¶
README 中的 5 分钟上手流程可复现如下：
- 点侧栏 dsh小助手 → 打开看板。
- 在秘书框说「记一下：周五前交周报」→ 待办台账出现候选。
- 说「确认 T-001 周五 紧急 重要」→ 进入已确认，参与提醒与优先级。
- 说「问一下 CEO 这周先干哪件」→ 生成任务
K-xxx；CEO 可按任务号接下 / 完成 / 归档 / 存为记忆。 - 对 CEO 说「开新会话执行 整理三季度材料」→ 新开 CEO 预设会话，任务写入首句。
- 右键右下角鲸鱼娘 → 刷新 / 唤出 / 隐藏。
常用配置写在 profile 的 cordis.patch.yml 的 config 下，例如三角色开关 enabled.secretary / enabled.ceo / enabled.historian，史官范围 historian.scope.mode，提醒时间与 dataDir 等；完整表格见仓库 README「配置」一节。没有独立设置页 UI。
适用场景与注意¶
适合：希望在 DSH 内用中文界面管理个人待办、定点提醒，并借助三个预设角色拆分与执行任务，且要求数据留在本机的 Windows 用户。
注意：
- 插件以当前 DSH 进程权限运行；史官默认读全部会话正文，涉密或演示环境应改用
historian.scope.mode: sandbox或关闭史官。安装前建议阅读源码与 MIT LICENSE、docs/PRIVACY.md。 - 「开新会话执行」与按钮开新会话共用限频（每小时最多 4 个）；出问题可先查
GET /api/dsh-xiaozhushou/health与数据目录维修站.md。 - DSH 社区目录（如 SkillHub）为独立生态站点，与 DeepSeek / 幻方无官方从属关系；本插件亦在 SkillHub 目录页 收录。
结尾¶
dsh小助手把看板、浮窗、待办台账、定点提醒与秘书 / CEO / 史官分工收进一个 DSH 客户端插件，强调本地文件与零插件 npm 依赖。项目仍在持续打磨，记忆与伴生秘书能力在路线图中继续迭代。
