前言¶

在 DSH 里接智能体，常见两难：要么每次手动开 Session、跟进度，要么把自动化拉满却把整组人的注意力都占掉。DeepSeek Harness 的生态走「一切皆插件」——能力以 Bundle 形式挂进 profile，由 Cordis 编排服务与工具。dsh-personal-agent（中文名 搭档）把原型的 super-agent 架构收成面向一个人的 proactive agent：一个入口、真实 Ticket、默认观察再行动，适合想在面板或微信里委派杂事、又希望工单可追溯的开发者自行试用。

下面按定位、能力、安装与注意点说明；事实以仓库 README 与 release 安装说明为准。仓库写明这是仅供参考的研究原型，非 DeepSeek 官方产品，使用前请阅读源码与 MIT 许可证。

这是什么¶

dsh-personal-agent 由 yinguobing/dsh-personal-agent 维护，在 SkillHub 目录中归类为工作流。包名与发布标识使用 dsh-personal-agent；内部仍保留原型里的 orchestrator 服务名与 orchestrator_* 工具名，便于与上游 diff。

一句话定位：以 DSH Bundle 发布的个人超级智能体——你在面板或微信里说话、往监控目录丢材料，仅在你发起或规则允许时开工单（Ticket），在独立 Session 与目录里执行，并把结果回到原对话；Web 面板展示进行中事项与需要你拍板的内容。设计理念在仓库 docs/000-philosophy.md 中概括为：尽量少占用人注意力，尽量多交付价值；未获授权或规则不允许时不主动开口、不擅自决策。

上游原型 dsh-superagent 面向单个 GitHub 仓库（监听 GitHub，可选飞书）。本 fork 弱化了「整仓库协作」叙事，强调单人日常：对话、收件监控、工单与面板。README 注明公开版与内部版及论文 Exploring Super-agent Design 中部分设想并不完全一致，未实现项见 docs/known-gaps.md。

核心功能¶

以下能力均来自 README 与 package.json 导出说明，不扩写未列出的集成。

1. Bundle 形态接入 DSH
   通过 cordis.patch.yml 作为 DSH bundle 安装；客户端注入 web 侧 locale、settings、renderer、layout、sidebar、workspace 等模块（见 package.json 的 dsh.client.inject）。

2. 工单（Ticket）驱动执行
   授权请求在 Policy 下评估后变为 Ticket，各自在独立 DSH Session 中执行——与个人使用场景下的「一件事一张单」一致。

3. 多来源监听（按需启用）
   包导出包含 github-watch、feishu-watch、chat-watch、weixin-watch、inbox-watch 等入口；个人安装路径侧重面板、微信与监控目录，具体接线见 docs/006-deployment.md 与 docs/008-cookbook.md。

4. Web 面板
   面向使用者的界面：会话、进行中事项、智能体建议动作；运维向标签页可折叠到一处切换（见 docs/005-panel.md）。

5. 可选长期记忆
   安装脚本默认写入记忆索引；传 --no-memory 可跳过。行为细节见 docs/memory.md。

6. 文档链
   编号文档从哲学、领域模型、授权、执行、提示词、面板、部署、架构到 Cookbook，建议按 000–008 顺序阅读；上手五分钟见 docs/using.md。

当前 release 版本为 0.10.0（package.json）。SkillHub 页显示星标为 0，仅作目录元数据，不代表功能完备度。

安装与启用¶

安装前请准备：

• Node ^22.19.0 或 ≥24.0.0（package.json engines）
• DSH 版本满足 >=0.2.1-alpha.2 <0.3.0 或 >=0.2.2-rc.1 <0.3.0
• 用户主目录下 ~/.credentials.yaml 配置 DEEPSEEK_API_KEY；安装器会提示：无 key 则每轮失败

README 明确：不支持直接从 git 安装（构建产物未提交，且 pnpm 对每次构建有审批要求）。推荐从 release tarball 安装。

方式一：release 包（推荐）

dsh plugin --profile personal add \
  https://github.com/yinguobing/dsh-personal-agent/releases/download/v0.10.0/dsh-personal-agent-0.10.0.tgz

若未用安装脚本，可参考仓库 examples/profile.cordis.patch.yml 自行写入与脚本等价的配置。

方式二：已有 clone 时的一键安装

在仓库根目录执行（会创建 personal profile、安装 bundle 与记忆索引并打印启动命令与材料目录）：

node scripts/install.mjs --profile personal --port 3082

可加 --no-memory 禁用长期记忆安装。

安装后按终端提示启动 DSH；面板默认端口示例为 3082（与上述命令一致）。插件以当前 DSH 进程权限运行，安装前请自行审查源码与 MIT 许可证，勿在未审计的环境直接用于敏感资料。

典型用法¶

1. 先读短文档再操作
   安装完成后依次阅读 docs/using.md（首五分钟）、docs/memory.md、docs/known-gaps.md；遇问题优先对照 gaps 列表。

2. 与个人工作流配合
   - 在面板发起任务或回复智能体提问。
   - 将待处理材料放入安装器输出的材料目录（inbox 监控）。
   - 仅在明确请求或你所写规则允许时，智能体才会开立 Ticket 并进入 Session。

3. 从原型迁移的完整搭建
   若需原版 multi-step 的 dsh-superagent 式部署，README 仍保留 SETUP.md 路径：可对 coding agent 说「Read SETUP.md in this repository and set up dsh-superagent with me」，由 agent 分步提问并安装。个人 fork 日常以 personal profile 与 release 安装为主。

4. 扩展数据源
   按 docs/008-cookbook.md 增加 Source；授权模型见 docs/002-authorization.md。

开发自检（贡献者）：在仓库内 pnpm check 运行 typecheck、测试与 build。

适用场景与注意¶

适合谁

• 已使用 DeepSeek Harness，希望试验「单人 proactive agent + 工单 + 面板」工作流的开发者。
• 愿意按文档配置 Policy、来源与 worker 权限（安装脚本会写入「worker 永不等待审批」一类设置，须理解含义后再用）。
• 接受研究原型：README 声明可能存在 bug，工程风格不一致，非生产就绪。

务必注意

• 社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系；本文亦非官方文档。
• 插件权限即 DSH 进程权限；微信、目录监控等能力涉及凭据与数据出界，请在本机或可控环境试用。
• 不提供模型 key；凭据仅依赖 ~/.credentials.yaml。
• 许可证：MIT。

结尾¶

dsh-personal-agent 把 super-agent 原型收成一人可用的 DSH Bundle：统一入口、Ticket 实参、默认观察、面板汇总待办。适合作为工作流类插件阅读其哲学与授权设计，再按需用 release v0.10.0 装入 personal profile 验证。

• 目录页：https://www.skillhub.cn/plugins/yinguobing/dsh-personal-agent
• 源码与 README：https://github.com/yinguobing/dsh-personal-agent