liangl1985/work-personal-secretary

work-personal-secretary

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

- 运行环境：DSH Desktop 2.0.9 / host 运行时 dsh 0.1.5-rc.1（cordis bundle 体系）
- 设计目标：一个包、一个设置入口、一个面板；子项目可独立开发/验收，再由根层整合
- 版本：对外发布版 v1.0.0（集成体自身的语义化版本，与子模块版本解耦）；当前开发版 1.1.4（按「不发布」收尾，见 CHANGELOG.md）。子模块当前版本以各自 package.json 为准（下表已同步为 2026-09-17 实测值）；变更记录见 CHANGELOG.md，发布前逐项核对 RELEASE-CHECKLIST.md

能力总览

| # | 能力 | 落点 | 状态 |
|---|---|---|---|
| 1 | 强记忆：三级记忆模型（全局永不遗忘 / 热记忆按 TTL 转冷 / 冷归档被用到即转热）+ 转冷预审 + 会话原生注入 + 右侧边栏面板 + Obsidian 镜像 | modules/dsh-work-memory | ✅ v1.0.7 |
| 2 | 强文档处理：Word（处理 + 比对/红线修订）/ Excel（处理 + 重算 + 透视）/ PPT（制作 + 排版）/ PDF（只读精确提取） | modules/dsh-doc-suite（Python 脚本 + DSH 原生技能；宿主半只提供 /doc-doctor） | ✅ v0.7.12 |
| 3 | 专家库：19 位专家 / 6 域（信息安全 4 · 财务 4 · 人力资源 1 · 代码编程 3 · 金融 2 · 通用职能 5）；任务命中关键词才注入对口专家（注入上限 写死 4、设置页不提供该项，零命中不注入；身份由记忆承担，默认不常驻）；默认注入精简卡（L1，约 0.4–0.7 千字符/位，expertInjectDetail=full 可切回全文），其余派子代理激活 | modules/dsh-experts | ✅ v0.5.10 |
| 4 | 桌面宠物形象：小秘书两套形象（纯欲乖巧＝默认 / 慵懒性感）各 12 动作；插件支持多套装切换 + 「设为默认形象」；动作做到 pingPong 闭环、抠图无紫边/绿边、无背景底色 | modules/workspace-tokenpet（独立项目模块，MIT；来源致谢见模块 NOTICE） | ✅ v1.0.1 |
| 5 | 强思维链分析（方法 + 在思维过程中以流程图等形式展示） | 候选评估中，见 00_项目主页/插件关注列表.md #7–#11（首选 dsh-flowglass） | ⏳ 待评估 |

子项目

| 子项目 | 包名 | 状态 | 说明 |
|---|---|---|---|
| modules/dsh-work-memory | dsh-work-memory | ✅ 可用（v1.0.7） | 执行层长期记忆：三级记忆模型 + 转冷预审（到期前先判：保留 / 自然转冷 / 待判断）+ 会话原生注入 + remember/recall/link 工具 + 右侧边栏面板 + Obsidian 镜像。运行时 id 为 work-memory（包名与 id 均已中性化） |
| modules/dsh-doc-suite | dsh-doc-suite | ✅ 可用（v0.7.12） | 文档能力：Word 处理+比对（红线修订）/ Excel 处理+重算+透视 / PPT 制作+排版 / PDF 只读精确提取。实现是 Python 脚本 + DSH 原生技能，宿主半只提供 /doc-doctor 自检入口 |
| modules/dsh-experts | dsh-experts | ✅ 可用（v0.5.10） | 专家库：19 位专家 / 6 域。默认一位都不常驻：任务命中关键词才注入对口 persona（expertInjectMax 写死 4、设置页不提供该项，零命中不注入），可调配置层范围，>1 提示占 TOKEN）或派子代理（expert_recall 把 persona 内联进 subagent.prompt）；未命中则原生处理。来源为成熟开源件压缩/组合改写（MIT 17 · Apache-2.0+MIT 双许可 2 · Apache-2.0 1 · 自撰 1，合计 20），逐条记于 experts/index.json + NOTICE |
| modules/workspace-tokenpet | workspace-tokenpet | ✅ 可用（v1.0.1） | 独立项目模块（源码 / 构建产物 / 文档 / 素材全部自持；由三方插件独立化，对上游只保留致谢，上游 MIT 版权与许可文本保留在模块 LICENSE）：不依赖上游仓库、无需应用补丁。① 多形象套装运行时化（宿主扫描 ~/.dsh/data/workspace-tokenpet/skins/，manifest 校验 + 路径穿越防护 + 客户端解析 + blob URL 桥 + 设置面板）；② 条带切帧修复（宿主透传 rows，否则客户端回退内置模板的 2 行 → 宠物显示"两个细长人影"）；③ UI 清理（移除 aura 环绕光圈 / meter 脚底横条）；④ 默认形象 + 「设为默认形象」按钮。随包提供三套形象素材（default 上游内置 + 两套自有形象），安装时自动部署到运行时目录（只补缺失、不覆盖；新址缺套装时自旧址复制迁移） |

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

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

安装
前置：DSH Desktop 2.0.9（宿主运行时 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  add

| 子模块 | 额外前置 |
|---|---|
| dsh-work-memory | 无（零运行时依赖，只用 node 内置模块） |
| dsh-experts | 无（零运行时依赖） |
| dsh-doc-suite | Python ≥ 3.10（建议 3.12；Windows 用 py -3）+ WPS Office —— 两者都不会被自动安装，由 /doc-doctor 检测并给出修复命令 |
| workspace-tokenpet | 无（零运行时依赖：宿主半只用 node 内置模块，客户端为预构建产物；npm install 只在开发/重建时需要） |

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

首次使用

1. 让默认约定生效（二选一）：把 modules/work-personal-secretary/defaults/global-memory.seed.md 的语言偏好写入全局记忆；或把 modules/work-personal-secretary/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. 记忆库首装为空：人设、偏好与业务记忆由使用者自己写入，包内不含任何记忆数据。

目录模型：一个存储根目录 + memory-data / obsidian-data

「核心配置」页只要求选一个存储根目录，记忆体与知识库各自在它下面新建自己的子文件夹，各自要建立的东西只放在自己的文件夹里 —— 这样两个目录天然是兄弟，不会互相嵌套。

/
├── memory-data/                        # 记忆体（dsh-work-memory 用）
│   ├── MEMORY.md  USER.md  GRAPH.json  #   全局记忆 / 偏好 / 关联图
│   ├── PROJECTS/  DAILY/  ARCHIVE/     #   项目记忆 / 今日日志 / 冷归档
│   └── （运行后还会有 .access.json / .triage.json / SUGGESTIONS.jsonl 等索引与状态文件）
└── obsidian-data/                      # 知识库（Obsidian vault）
├── 🏠 主页.md
├── 00_全局记忆/                    #   记忆体镜像（由记忆插件单向同步，勿手改）
├── 工具/                           #   预留框架，见下
├── /             #   只登记已存在的，不新建、不猜名字
└── .obsidian/app.json

- 两个子目录名由宿主 modules/work-personal-secretary/lib/basedeck.js 的 ROOT_SUBDIR_MEMORY / ROOT_SUBDIR_VAULT 定义，经 GET /setup-state 的 rootSubdirs 交给客户端（客户端不硬编码）。派生值默认只读显示；确有需要时在页面上点「单独指定」改写（改写后不再跟随根目录，可点「跟随根目录」回到派生值）。既有配置若不是这套布局，页面推不出根目录就留空并原样显示你的路径，绝不擅自改写。
- 知识库只新建、不搬迁：已有知识库不会被自动搬动。要搬，必须由使用者指定文件夹后再逐项对照导入（入口是配置完成后的「导入引导卡」；「列清单 → 勾选 → 写入」的完整流程属后续版本）。
- 只有记忆体自动迁移：切换记忆库目录时，执行链先迁移旧库（逐文件只补还没有的文件、绝不覆盖，旧目录原样保留，写后逐文件 SHA256 校验，失败回滚），再补建缺失的结构。顺序不可颠倒：反过来先建结构，旧库的 MEMORY.md / USER.md / GRAPH.json / PROJECTS/工作秘书.md 会被判成「同名但内容不同」而全部跳过，等于旧记忆一个都进不来。

工具/ 的三个子目录（技能/ 脚本/ MCP/）目前只是预留框架：本版只建目录与一份 00_工具总览.md，不实现任何同步。也就是说它们现在是空的，需要放什么请先手工放；自动同步属后续版本、未立项。总览文件里写的是预留用途，不是当前行为。

卸载与数据留存

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

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

⚠️ 本表是 2026-09-13 的历史快照（当时的安装形态与版本）；当前版本以上方能力表与各模块 package.json 为准。

| 插件 | 版本 | 来源 |
|---|---|---|
| dsh-work-memory | 1.0.5 | 本地（file:node_modules/dsh-work-memory） |
| dshmarket | 1.45.1 | npm（插件市场本体，市场界面通常不列自己） |
| dsh-mermaid | 0.4.0 | npm |
| dsh-doc-suite | 0.2.0 | 本地（file:/modules/dsh-doc-suite） |
| dsh-experts | 0.4.0 | 本地（file:/modules/dsh-experts） |
| workspace-tokenpet | 1.0.0 | 本地（file:/modules/workspace-tokenpet；素材随安装部署到 ~/.dsh/data/workspace-tokenpet/skins/） |

本机 desktop profile 尚需一次迁移（旧 id dsh-token-pet@0.2.1-lina.1 → 新 id workspace-tokenpet@1.0.0）：卸载旧 id → 安装新 id → 确认素材目录；步骤见 modules/workspace-tokenpet/CHANGELOG.md 1.0.0 段。本次未改动本机 profile。

dsh --profile desktop --dump-config 退出码 0（2026-09-14 独立化后复核：退出码仍为 0；本机换 id 之前，组合树中的桌宠条目仍显示旧 id token-pet / dsh-token-pet，迁移后应为 workspace-tokenpet）。

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/ 匹配与注入 + 三套自测）
│   └── workspace-tokenpet/      #   桌面形象（独立项目模块：src/ 源码 + lib/ 产物 + client/ 预构建 + skins/ 三套素材）
├── defaults/                    # 随包默认：全局记忆种子 + AGENTS 指令模板（中文）
├── CHANGELOG.md                 # 集成体版本历史（含 v1.1.x 未发布段）
├── .github/workflows/ci.yml     # 仓库级 CI：语法自检 + 遍历子项目跑回归 + 冒烟/共存 + 必需文件自检
├── RELEASE-CHECKLIST.md         # 发布检查清单（发布前逐项打勾）
└── README.md

技能文档的路径约定：modules/dsh-doc-suite/skills/*/SKILL.md 里的命令使用占位符
（= 该模块的 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

语法自检bash
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。workspace-tokenpet 的宿主半同样零运行时依赖（lib/ 只用 node 内置模块，client/client.js 为预构建产物）。
- 文档子模块（dsh-doc-suite）的运行时依赖是 Python 库 + WPS Office，不经 npm；CI 只做语法自检（py -3 -m py_compile），环境就绪性交给使用者本机的 doctor.py。

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

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

1. 语言：尽量使用简体中文回答与思维——回答用简体中文；推理痕迹也尽量用简体中文（分析、判断、计划、自查都是中文）；代码、命令、路径、包名、API/字段名、日志与报错原文、专有名词保留英文，不硬翻。
- 随包提供两样（都在 modules/work-personal-secretary/defaults/）：
- global-memory.seed.md —— 全局记忆种子（首次使用时写入全局记忆即可，让默认语言生效）；
- 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  install --force → 仍不同步就删掉 ~/.dsh/profiles//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。