work-personal-secretary

工作秘书集成体（DeepSeek Harness 插件集合）：面向通用工作者的「工作助手 / 工作秘书」——不是通用聊天插件，而是能替人干活的秘书。 垂直方向：技术售前 / 售后 / 会计 / 律师（四类知识密集、文档密集、流程密集的职业）。 运行架构是总控兼读制：主对话只做拆解·派单·核对·监督·纠正·对外沟通，重活交专家子代理执行。

• 运行环境：DSH Desktop 2.0.9 / host 运行时 dsh 0.1.5-rc.1（cordis bundle 体系）
• 设计目标：一个包、一个设置入口、一个面板；子项目可独立开发/验收，再由根层整合
• 版本：集成体 正式版第一版 v1.0.0（集成体自身的语义化版本，与子模块版本解耦；子模块另打 dsh-work-memory@1.0.5 形式的 tag）；变更记录见 CHANGELOG.md，发布前逐项核对 RELEASE-CHECKLIST.md

能力总览

子项目

后续候选（待定，需先确认许可证与必要性）：多代理团队引擎、思维链可视化（见关注列表）。

安装 / 首次使用 / 卸载与数据留存

安装

前置：DSH Desktop 2.0.9（host 运行时 dsh 0.1.5-rc.1）。

整体安装（推荐：先装入口，再由它引导安装子模块）

git clone https://github.com/liangl1985/work-personal-secretary.git
dsh plugin --profile desktop add <克隆目录>/modules/work-personal-secretary   # profile 名换成你自己的
# 重启 DSH → 设置 → 工作秘书 → 「安装与检查」→ 按需安装各子模块（页面内可指定仓库目录）

dsh plugin 是 pnpm 的代理（在 profile 目录下执行），所以 add 接受目录路径，落盘后 dependencies 记为 file:<目录>；子模块之间零运行时依赖，无需 npm install。

只装某一个子模块（命令形态与上面一致）：

dsh plugin --profile <profile> add <模块目录或包名>

宿主侧代码改动需重启 DSH 才加载；仅客户端改动刷新页面即可（客户端 bundle 按 revision 缓存，故每次改动都会升版本号）。

首次使用

1. 让默认约定生效（二选一）：把 defaults/global-memory.seed.md 的语言偏好写入全局记忆；或把 defaults/AGENTS.zh-CN.md 复制到会话工作区根目录作 AGENTS.md（指令层，约束力强于记忆层）。
2. 确认岗位：装了 dsh-experts 时执行 /expert setup <域> 写入「身份专家」；/expert list 查看全部专家，/expert why <任务文本> 看打分理由。
3. 自检文档环境：/doc-doctor（等价于 py -3 modules/dsh-doc-suite/doctor.py）逐项检测 Python 依赖与 WPS COM 通道。
4. 记忆库首装为空：人设、偏好与业务记忆由使用者自己写入，包内不含任何记忆数据。

卸载与数据留存

• 卸载插件：dsh plugin --profile <profile> remove <包名>，随后重启 DSH。
• 记忆数据不随插件卸载而删除：默认位于 ~/.dsh/memories/work-memory/（Markdown 正文 + 索引/状态文件），默认备份目录 ~/.dsh/memories/work-memory-backup/。需要彻底清除时手动删除这两个目录。
• 外部知识库镜像（如已配置）是一份可读的 Markdown 副本，卸载后保留，可继续当资料使用。
• 桌宠形象素材位于 ~/.dsh/data/dsh-token-pet/skins/，属使用者自有资产，卸载插件不受影响（模块内 skins/ 是随包副本，运行时用的是部署后的那一份；安装器只补缺失、不覆盖你改过的套装）。
• 全部数据本地存放、明文、不联网、无遥测；除使用者自己配置的模型服务外，本集成体不向外发送任何内容。

已验证的安装形态（desktop profile，2026-09-13）

dsh --profile desktop --dump-config 退出码 0，上述条目均在组合树中且无 disabled。

dsh-doc-suite 的硬前置（安装前必须满足，/doc-doctor 会逐项检测并给出修复命令）： Python ≥ 3.10（建议 3.12；Windows 一律用 py -3，不要用 python——它可能是 Microsoft Store 别名 stub） 与 WPS Office（比对 / 公式重算 / 透视 / 格式转换全部依赖其 COM，本机实测 ProgID 为 KWPS.Application）。 本集成体不会自动安装解释器或 WPS。详见该子模块 README 第一节。

目录约定

work-personal-secretary/
├── modules/<子项目>/            # 每个子项目是一个可独立测试/打包的单元
│   ├── dsh-work-memory/         #   记忆插件（lib/ + client/ + scripts/regression.mjs）
│   ├── dsh-doc-suite/           #   文档能力模块（Python 脚本 + skills/ + doctor.py）
│   ├── dsh-experts/             #   专家库（experts/ 专家数据 + lib/ 匹配与注入 + 三套自测）
│   └── dsh-token-pet/           #   桌宠定制层（三方插件补丁 + 完整可安装副本 + 三套形象素材）
├── defaults/                    # 随包默认：全局记忆种子 + AGENTS 指令模板（中文）
├── CHANGELOG.md                 # 集成体版本历史（正式版第一版 v1.0.0）
├── .github/workflows/ci.yml     # 仓库级 CI：语法自检 + 遍历子项目跑回归 + 冒烟/共存 + 必需文件自检
├── RELEASE-CHECKLIST.md         # 发布检查清单（发布前逐项打勾）
└── README.md

技能文档的路径约定：modules/dsh-doc-suite/skills/*/SKILL.md 里的命令使用占位符 <DOC_SUITE_SCRIPTS>（= 该模块的 scripts/ 目录），不写死任何作者机器的绝对路径。 解析方式：py -3 <模块目录>\doctor.py --emit-skill-paths（输出 JSON，含 scriptsDir）。

开发与验证

# 记忆模块：回归
node modules/dsh-work-memory/scripts/regression.mjs

# 专家库：回归 / 装载冒烟（mock ctx 真跑 apply）/ 与记忆插件共存契约
node modules/dsh-experts/scripts/regression.mjs
node modules/dsh-experts/scripts/smoke-load.mjs
node modules/dsh-experts/scripts/coexist.mjs

# 语法自检
node --check modules/dsh-work-memory/lib/index.js
node --check modules/dsh-experts/lib/index.js

# 文档模块：环境自检（Python 依赖 + WPS COM）与路径解析
py -3 modules/dsh-doc-suite/doctor.py
py -3 modules/dsh-doc-suite/doctor.py --emit-skill-paths

• JS 子项目（dsh-work-memory、dsh-experts）零运行时依赖（只用 node 内置模块；宿主 peer 缺失时自动降级），回归与自测脚本可直接执行，CI 不需要 npm install。
• 文档子模块（dsh-doc-suite）的运行时依赖是 Python 库 + WPS Office，不经 npm；CI 只做语法自检（py -3 -m py_compile），环境就绪性交给使用者本机的 doctor.py。

默认约定（随包发布时同样生效）

这些是产品默认行为，不是可选项；发布/交付件必须做到"首装即适用"。发布前逐项核对 RELEASE-CHECKLIST.md。

1. 语言：尽量使用简体中文回答与思维——回答用简体中文；推理痕迹也尽量用简体中文（分析、判断、计划、自查都是中文）；代码、命令、路径、包名、API/字段名、日志与报错原文、专有名词保留英文，不硬翻。
   • 随包提供两样（defaults/ 目录）：
     • defaults/global-memory.seed.md —— 全局记忆种子（首次使用时写入全局记忆即可，让默认语言生效）；
     • defaults/AGENTS.zh-CN.md —— 工作区指令模板（复制到工作区根目录；走 DSH 指令层，约束力强于记忆层）。
2. 总控兼读制——主对话（对话本体）= 总控 + 读稿人：拆解、派单、核对、监督、纠正、对外沟通，保持轻量；绝大多数工作交专家子代理执行，主对话对成果负责。
3. 敏感行业例外（红线）——军工 / 商密 / 烟草 / 数据安全类内容由主上下文直接处理，不派子代理。
4. 记忆纪律——全局记忆永不遗忘；热记忆按 TTL 转冷；冷归档被用到即转热；转冷前先做预审，拿不准的由助手判定、不整批推给使用者。
5. 专家库使用流程（装了 dsh-experts 时生效）——常驻只有一位身份专家（切合使用者岗位）；每轮先判断问题归属：命中单一专家 → 按该视角原生处理；跨领域多专家 / 需独立作业 → 派子代理并把 persona 内联进 prompt；未命中 → 原生处理，不硬套专家视角。模板见 defaults/AGENTS.zh-CN.md。
6. 中立与隐私——发布件不含任何个人化身份（私有助手名、私有称呼、个人账号）、不含私有路径（如 E:\...）、不含记忆数据；个性化只走设置页用户层；本地、明文、不联网、无遥测。
7. 第三方合规——内置的专家 persona / 角色定义必须来自许可允许再分发的来源（MIT / Apache-2.0 等），逐条记录来源与许可（experts/index.json + NOTICE）；无 LICENSE 的一律不收录。

运维纪律（改代码/改配置后必看，2026-09-12 事故沉淀）

• file: 依赖有缓存：改了子模块源码后，dsh plugin add <路径> 常报 Already up to date 而不同步。可靠顺序：升 package.json 补丁版本 → dsh plugin --profile <p> install --force → 仍不同步就删掉 ~/.dsh/profiles/<p>/node_modules/<模块> 再 dsh plugin add → 逐文件 SHA256 比对源码与副本；
• 必须重启 DSH：新模块 / 新版本 / host 侧代码改动都要重启才加载（客户端 bundle 另需升版本号，渲染进程按 revision 缓存）；
• 别用 PowerShell 的 Set-Content -Encoding utf8 改 profile 的 JSON 或 ~/.dsh/settings.yaml：它会写 BOM，DSH 读 profile 时 JSON.parse 直接失败（Unexpected token '\uFEFF'），YAML 则报 Nested mappings are not allowed in compact mappings。这类文件一律用 Node 的 fs（明确 UTF-8、无 BOM）写。

许可

MIT（见各子项目 LICENSE）。第三方来源与许可见 modules/dsh-experts/NOTICE 与各模块 README。