dsh-digital-life

dsh-digital-life 将可配置的对话式数字生命代理作为可安装的 Host 与 Client Cordis 插件接入 DeepSeek Harness。

功能

在 digital-life 设置命名空间中持久化数字生命记录。
提供符合 Harness 风格的设置区，用于新增、编辑、启用和删除数字生命记录。
提供 consult_digital_life，用于一次性咨询指定数字生命。
提供 consult_digital_life_category，用于并行咨询一个分类中的多个数字生命。
注册 @<id> 输入源，用于选择已配置的数字生命。
通过 additive sidebar.footer.action Slot 注入 Chat Panel，不替换 Harness 的 Sidebar 或 Workspace 浏览器。
创建不附加 Workspace 的独立会话，并使用所选数字生命初始化会话。
在首页提供组合选择器：选择 数字生命模式 Agent preset 后，再选择具体数字生命。

演示

首页选择器	Chat Panel	设置	新增数字生命
<img src="pics/home.png" alt="Harness 首页中的数字生命选择器" width="960">	<img src="pics/chat.png" alt="数字生命 Chat Panel" width="960">	<img src="pics/setting.png" alt="数字生命设置页面" width="960">	<img src="pics/setting2.png" alt="新增数字生命表单" width="960">

数字生命记录字段

每条记录包含 id、name、description、主领域 category、能力标签 tags[]、agent、persona 和 enabled。agent 是运行时唯一的人格来源：未填写 Agent 文件时，保存会将 persona 写入托管的 <id>/agents/<id>.md，并把相对路径保存到 agent；填写 Agent 文件后，以该 Markdown 正文为准，忽略 persona。新建 custom 主领域的记录时建议填写 customCategory；旧配置缺少该字段时会回退使用数字生命名称。toolFilter 与 model 为可选字段。Host 会校验设置文档，并使用配置的子代理 Provider 创建一次性咨询。智囊团设计见 [docs/think-tank-agent-team.md](docs/think-tank-agent-team.md)。

从 GitHub 安装

dsh-digital-life 安装到 DeepSeek Harness 的 Web Profile 中。下面的命令都在 Harness checkout 中执行，而不是在插件仓库中执行。

前置条件

已经可以正常运行的 DeepSeek Harness checkout
与该 Harness checkout 兼容的 Node.js 和 pnpm
本仓库的 GitHub 地址

安装

cd /path/to/deepseek-harness
pnpm dsh plugin --profile web add https://github.com/elonnzhang/dsh-digital-life.git

该命令会把插件安装到 $DSH_HOME/profiles/web，将插件 bundle 加入 Web Profile，并在下一次启动时加载 Host 和 Client 两部分。

启动 Web Profile：

pnpm dsh web --port 3080

打开 http://127.0.0.1:3080，然后进入 设置 → 数字生命。

> GitHub 仓库必须包含构建后的 lib/ 目录，因为 package.json 的 main 和 Client 入口都指向构建产物。每次发布新的 GitHub 版本前，请先构建并推送： > > ``sh > cd /path/to/dsh-digital-life > pnpm install > pnpm build > git add src lib cordis.patch.yml package.json README.md README.zh.md > git commit -m "build: update plugin" > git push > ``

更新或卸载

在 Harness checkout 中执行：

# 更新已安装的 GitHub 依赖
pnpm dsh plugin --profile web update dsh-digital-life

# 从 Web Profile 卸载插件
pnpm dsh plugin --profile web remove dsh-digital-life

安装、更新或卸载后，重新启动 pnpm dsh web。

本地开发安装

本地开发时，可以把插件 checkout 直接 link 到 Profile：

cd /path/to/dsh-digital-life
pnpm install
pnpm build

cd /path/to/deepseek-harness
pnpm dsh plugin --profile web add /path/to/dsh-digital-life

开发 Client HMR 时，在 Harness checkout 中保持 pnpm run dev:web 运行，并在本插件目录运行 tsdown --watch。

使用方法

1. 配置数字生命

启动 Web Profile 后，打开 设置 → 数字生命，新增或编辑一条记录：

插件界面跟随 Harness 当前语言，完整支持英文和简体中文。切换应用语言时，设置页、Chat Panel 和会话选择器会即时更新；用户填写的名称、描述和人格内容保持原文，不会自动翻译。

ID：只能使用小写字母、数字和连字符，例如 startup-mentor
名称：显示名称，例如 创业导师
职责描述：简短说明它负责什么
主领域：business、science、culture 或 custom
自定义领域：主领域选择 custom 时建议填写
能力标签：用于搜索和分类，例如 创业、现金流
人格设定：初始身份、人设和回答规则；未配置 Agent 文件时会转换为托管 Agent 文件
启用：只有启用的记录会出现在选择器和分类咨询中

也可以填写 Host 可读取的路径来绑定已有 Agent Markdown 文件。文件的 YAML frontmatter 会被忽略，Markdown 正文作为运行时唯一人格来源。浏览器不会暴露 Host 可重新读取的文件路径，因此通过文件选择器选中的内容会改为导入托管文件。未填写外部路径时，输入的人格设定会保存到：

$DSH_HOME/digital-life/<id>/agents/<id>.md

外部 Agent 文件不会被插件复制或覆盖。

默认设置文件是：

$DSH_HOME/settings.yaml

2. 配置咨询 Provider

子代理 Provider 必须填写当前 Harness 已挂载的 subagent Provider ID。没有额外 Provider 时保持默认值 spawn。分类最大咨询数 控制 consult_digital_life_category 一次最多并行咨询多少条已启用记录，不影响独立会话。

3. 在输入框中使用数字生命

在输入框输入 @，然后选择数字生命，例如 @startup-mentor。@<id> 只是帮助主 Agent 选择 consult_digital_life 的模型可见文本，不是自动命令；是否咨询仍由模型决定。

可用工具：

consult_digital_life(id, question)：咨询一条指定的数字生命
consult_digital_life_category(category, question)：并行咨询一个领域中的已启用数字生命，再比较各自观点

4. 创建独立会话

有两种方式：

打开侧边栏 Chat Panel，选择一个数字生命。
在首页选择 数字生命模式 Agent preset，再选择具体数字生命。

独立会话不附加 Workspace，不传 workspaceId 或 cwd，并通过 Host binding 注入该记录专属的 system prompt。数字生命会话强制使用只读文件沙箱：可以读取文件和进行咨询，但不能修改文件。开场消息是简短提示，不会重复完整人格设定。

在数字生命独立会话中，使用 @<id> 点名其他记录时必须调用 consult_digital_life，当前数字生命不得模拟或代替对方回答；点名当前数字生命自身的 ID 时直接回答，不进行自我咨询。

5. 更新插件

发布新的 GitHub 版本前，先在插件仓库构建并推送；然后在 Harness checkout 中更新：

pnpm dsh plugin --profile web update dsh-digital-life
pnpm dsh web --port 3080

如果 Profile 仍然使用旧的 link 或安装内容，可以重新卸载并安装：

pnpm dsh plugin --profile web remove dsh-digital-life
pnpm dsh plugin --profile web add https://github.com/OWNER/dsh-digital-life.git

设置项

子代理 Provider

该值必须是当前 Harness 已挂载的 subagent Provider ID，默认值为 spawn。它用于一次性咨询工具，不是模型名称，也不是数字生命 ID。Provider 不存在或不支持所需能力时，咨询会返回明确错误。

分类最大咨询数

该值默认为 3，只影响 consult_digital_life_category。工具会筛选指定分类中已启用的记录，并最多并行启动该数量的数字生命子代理。它不影响单个咨询、@<id>、Chat Panel 或首页独立会话。

模型体验

咨询工具的 schema 会加入主 Agent 的模型请求。单个咨询启动一个子代理并返回文本；分类咨询最多并行启动 maxBatchSize 个已启用记录。独立数字生命会话会接收基于具体记录生成的 system prompt，并强制使用只读文件沙箱；角色设定由 system prompt 承担，对该 Session 持久且对模型可见。

已知限制与后续工作

在普通 Chat 中，@<id> 是帮助 Agent 选择 consult_digital_life 的模型可见文本，不是自动命令；在数字生命独立会话中，持久化 system prompt 要求点名其他记录时必须使用咨询工具，点名自身时直接回答。当前公共 Sidebar 没有 Workspace 浏览器上方的 additive Slot，因此 Chat Panel 使用受支持的 footer action Slot。选择具体记录时，独立会话使用 digital-life-mode Agent preset；每条记录的独立模型配置尚未应用到 Session 创建过程。