dsh小助手（dsh-xiaozhushou）

一句话价值：给 DeepSeek Harness 装一个「看板 + 待办台账 + 三个角色」——秘书陪你聊、CEO 帮你判断、史官只记不评；所有数据留在你自己电脑上。

收起态（浮窗只剩看板娘）	看板娘形象

截图为界面示意，数据为演示内容。

给谁用

这是给不会编程的小白用的：不用写代码、不用配环境，装上之后会说话就能用。

它本质上是一个 DSH 会话管理器 + 与你共同成长的智能助理：帮你管会话、记待办、盯提醒，用秘书 / CEO / 史官三个角色陪你把事做完。

路线与状态（作者本人也在摸索）

• 现在能用：会话管理、待办台账、三角色聊天、定点提醒、共享任务板、看板娘。
• 下一步会持续更新：把记忆系统和伴生秘书做得更合理，让它越用越懂你、跨会话不丢事。
• 本项目还在持续打磨，作者本人也在摸索中；欢迎提 issue 或反馈使用感受。

它是什么

dsh小助手是 DeepSeek Harness 的一个插件（bundle）。装上之后：

• 侧栏多一个图标：点开是整页看板（待办、优先级、CEO 任务、史官摘要）；
• 右下角多一只鲸鱼娘浮窗：拖来拖去、点开卡片、右键菜单；
• 三个角色：
  • 秘书（简单陪聊 + 记录看板）：陪你聊两句、把你要记的事记成待办；不做判断，需要判断时让 CEO 来；
  • CEO（智能助理主体）：负责判断、拆解、派活与执行；给结论和下一步，能接任务/完成/归档/存为记忆；
  • 史官（格式化记录）：只做结构化记录、不判断，给伴生系统提供原生数据底层；每条带引用，判断类问题转 CEO；
• 长期记忆（简化版）：数据目录下 记忆/ 四个 Markdown（用户画像 / 近期交代 / 长期规划 / 情绪与处境），由史官按周用规则从台账与任务板重写；秘书 / CEO 只带一段有长度上限的摘要进对话；
• 所有数据都在本地：台账、任务板、审计、记忆、对话存档都是普通 JSON / Markdown 文件，可直接看、可备份、可迁移。

安装（不会编程也能装）

插件零 npm 依赖；安装 npm 包需要联网；装完重启 DSH（或刷新页面）。

方式 A：一句话让 DSH 助手装（推荐，免命令行）

把下面这句发给 DSH 助手：

帮我安装 dsh-xiaozhushou 插件，npm 包名：dsh-xiaozhushou

成功标志：返回 application: applied；装完按提示重启 DSH。

方式 B：CLI（npm，推荐）

# Web 版
dsh plugin --profile web add dsh-xiaozhushou
# 桌面版
dsh plugin --profile desktop 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 路径>

--profile 后面换成你自己的 profile 名（web / desktop / …）。 卸载：dsh plugin --profile web remove dsh-xiaozhushou（桌面版把 web 换成 desktop）。卸载不删数据。

5 分钟上手

1. 点侧栏 dsh小助手 图标 → 打开看板；
2. 在秘书框里说「记一下：周五前交周报」→ 待办台账里出现一条候选；
3. 说「确认 T-001 周五 紧急 重要」→ 进入已确认，开始参与提醒与优先级；
4. 说「问一下 CEO 这周先干哪件」→ 生成任务 K-xxx；CEO 会直接接下/完成/归档/存为记忆（按任务号说或让它自己判断）；
5. 对 CEO 说「开新会话执行 整理三季度材料」→ 真的开一个 CEO 预设会话（标题 dsh小助手 · CEO 执行），任务写进第一句，权限审批在该会话里弹；
6. 右键右下角鲸鱼娘 → 刷新 / 唤出 / 隐藏。

数据与隐私

• 数据目录默认 ~/.dsh-session-steward/data（Windows 为 C:\Users\<你>\.dsh-session-steward\data），可用配置 dataDir 改到别处；
• 史官默认开启，且默认读全部会话正文（enabled.historian: true + historian.scope.mode: all）；只想读测试内容就按下面「开发 / 测试模式」切回 sandbox；
• 插件不联网、无遥测；只有你主动在聊天框说话时，内容才会交给 DSH 宿主的模型服务；
• 插件没有删除文件的能力；写操作只发生在数据目录（以及其上一级的 史官/言行录、CEO/交接卡）；
• 长期记忆在数据目录的 记忆/ 下（四份 Markdown + 状态.json），可直接打开看、也可手工改；手写内容放在 <!-- AUTO:START -->…<!-- AUTO:END --> 自动区外，周更不会覆盖；
• 找文件默认只按文件名、只在白名单目录里找，默认不搜内容。

完整说明见 docs/PRIVACY.md。

配置

改 cordis.patch.yml（或你 profile 的 patch）里的 config：

键	默认	说明
enabled.secretary / enabled.ceo / enabled.historian	true / true / true	三个角色开关；0.47.0 发布默认全开（史官可关）
historian.scope.mode	all	发布默认读全部会话；sandbox 只读 [实验] 前缀 + 三个角色会话（开发测试用）
historian.scope.prefixes	['[实验]']	sandbox 模式的会话标题前缀
alarm.fixedTimes	['09:00','13:00','18:00']	每天定点提醒时间（HH:mm）
alarm.quietHours	23:00–07:00	静默时段（照常算，不弹）
dataDir	用户目录默认	数据目录；写了就优先用它
pet.enabled	true	看板娘浮窗
find.allowedRoots	[]（数据目录上一级）	允许被「找文件」搜索的根目录
find.content	false	是否允许按内容搜索（隐私默认关）

开发 / 测试模式（史官只读测试会话）

本地开发、演示或涉密环境，不想让史官读真实会话，把 patch 里的 historian.scope 改回 sandbox：

        enabled:
          historian: true          # 也可以 false，直接关掉史官
        historian:
          scope:
            mode: sandbox
            prefixes:
              - '[实验]'

sandbox 下只读两类会话：标题以 [实验] 开头的测试会话，以及三个角色自己的会话（dsh小助手 · 秘书 / CEO / 史官 对话）。 真实工作会话会被跳过并在结果里计数（filteredByScope）；想恢复读全部就把 mode 改回 all。

接口与网络边界（24 条本地回环路由）

• 插件向 DSH 本机 Web 服务注册 24 条 HTTP 路由，全部挂在 /api/dsh-xiaozhushou/* 下，地址形如 http://127.0.0.1:<端口>/api/dsh-xiaozhushou/health；
• 它们是回环接口：只随 DSH 自己的 Web 服务监听 127.0.0.1（localhost），插件不另开端口、不监听 0.0.0.0、不对外提供网关/代理；
• 端口每次启动会变，脚本调用先探 /health；写接口只接受 POST，并拦截跨源提交（Origin 与 Host 不一致直接 403）；
• 也就是说：别人在另一台机器上连不到这些接口；它们只服务本机页面上的看板/浮窗。

兼容性

• DSH：适配 0.2.1-rc.3（engines.dsh = "0.2.1-rc.3"；其它版本不保证能装能跑）；
• Node：≥ 20；
• 平台：Windows 10 / 11 已适配；Linux、macOS、鸿蒙（HarmonyOS）没有做适配，未验证；
• 依赖：零 npm 依赖；客户端只使用 DSH 宿主提供的 react。

自测与自检

node test/harness.mjs          # 185 项自测
node scripts/check-release.mjs # 发布自检（版本/包体/个人痕迹/文档）
node scripts/check-imports.mjs # 模块依赖体检（无循环、无外部依赖）

已知限制

1. 角色聊天必须先绑定真实会话：首次启动会自动建好三个角色会话（已有则复用）；若被删，重启 DSH 会重新建；仍不可用时看 /health 与数据目录 维修站.md；
2. 长期记忆是简化版：四份 Markdown 由规则生成（台账/任务板统计 + 角色对话与言行录摘句），不做语义检索；周更只重写 <!-- AUTO:START -->…<!-- AUTO:END --> 自动区，你在自动区外手写的内容会保留；周更由「跑一次史官」触发；
3. 端口每次启动会变，写脚本调用时先探测 /health；
4. 没有独立的设置页 UI，配置改 cordis.patch.yml；
5. 「开新会话执行」与按钮开新会话共用限频（每小时最多 4 个）；权限审批由 DSH 宿主在新会话里弹窗，插件不代点；
6. 仅中文界面文案（英文 locale 只有标题与描述）。

回退与卸载

• 卸载：插件管理器 remove_bundle，或 dsh plugin --profile web remove dsh-xiaozhushou（桌面版把 web 换成 desktop）；卸载不删数据。
• 回退：装回上一个 tag 的版本即可（v0.47.3 / v0.47.2 / v0.47.1 / v0.47.0 / v0.46.0 都有发布包）；数据在 ~/.dsh-session-steward/data，换版本不会丢。
• 彻底清掉：先备份数据目录，再删 %USERPROFILE%\.dsh-session-steward\（指针与数据）；插件本体由 profile 卸载。
• 出问题先看：GET /api/dsh-xiaozhushou/health（ok/version/degraded），以及数据目录下的 维修站.md（插件自检生成的诊断）。

仓库结构

路径	作用
index.js	宿主半入口：24 条 HTTP 路由 + 角色/工具/定时器注册
client.js	客户端半：侧栏图标 + 整页看板 + 浮窗
core/	30 个纯逻辑模块（台账、提醒、史官、长期记忆、任务板、CEO 执行、模型调用等）
roles/	三个角色 preset 与身份提示词
locale/	中英文文案
test/harness.mjs	零依赖自测台（185 项）
scripts/	发布自检、依赖体检、市场索引生成
docs/	架构、发布流程、隐私说明、截图

架构与「模块如何解耦、分支怎么开」见 docs/ARCHITECTURE.md； Git 协作规范见 CONTRIBUTING.md。

许可

代码 MIT（见 LICENSE）。看板娘等素材来源见 THIRD_PARTY_NOTICES.md。