dsh-digital-life

Usage

1. Configure digital lives

Open Settings → 数字生命 after the Web Profile starts. Add or edit a record with:

• ID: lowercase letters, numbers, and hyphens, for example startup-mentor
• Name: the display name, for example 创业导师
• Description: a short responsibility summary
• Category: business, science, culture, or custom
• Custom category: recommended when Category is custom
• Tags: searchable capabilities such as 创业, 现金流
• Persona: the initial identity and response rules; converted to a managed Agent file when Agent is empty
• Enabled: only enabled records appear in selection and category consultation

You can enter a Host-readable path to bind an existing Agent Markdown file. Its YAML frontmatter is ignored and its Markdown body is the runtime identity. A file selected through the browser is instead imported into the managed file because the browser does not expose a path that the Host can reopen. When no external path is entered, the Persona is written to:

$DSH_HOME/digital-life//agents/.md

An external Agent file remains the sole source of identity and is not copied or overwritten by the plugin.

The settings document is normally:

$DSH_HOME/settings.yaml

2. Choose the consultation provider

Set 子代理 Provider to a mounted subagent provider. Keep the default spawn unless your Harness profile installs another provider. Set 分类最大咨询数 to the maximum number of enabled records that consult_digital_life_category may consult in parallel. This limit does not affect standalone sessions.

3. Use a digital life from the composer

Type @ in the composer and select a record, for example @startup-mentor. The @ text helps the main Agent choose the consult_digital_life tool; it is not an automatic command. The model may still decide whether a consultation is useful.

The available tools are:

• consult_digital_life(id, question): ask one configured digital life
• consult_digital_life_category(category, question): ask enabled records in one category in parallel and compare their answers

4. Start an independent conversation

You can start one in either way:

• Open Chat Panel in the sidebar and choose a digital life.
• On the homepage, choose the 数字生命模式 Agent preset and then choose a record.

The standalone session has no Workspace (workspaceId/cwd), receives a record-specific system prompt through Host binding, and is forced to the read-only file sandbox. The opening message is brief and does not repeat the full persona. File-reading and consultation are available, but file modifications are blocked.

Inside a standalone digital-life session, mentioning another record as @ requires consult_digital_life; the current digital life must not imitate or answer for that record. Mentioning the current record's own ID is answered directly without a self-consultation.

5. Update the plugin

After publishing a new GitHub revision, build the plugin before pushing. Then update it from the Harness checkout:

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

If the profile still uses an old linked installation, remove and add it again:

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