dsh-agent-lines 0.3.1 → 0.3.2

package/CHANGELOG.en.md

@@ -2,6 +2,13 @@
 
 English | [中文](CHANGELOG.md)
 
+## 0.3.2 (2026-11-04)
+
+- Zero-config bootstrap: with no plugin config, start one unbound manager line; a root Session can call line_claim_manager to bind itself.
+- Default DB path follows DSH_HOME; without it, still ~/.dsh/agent-lines/lines.db.
+- README now requires a DSH Web restart after install/update; explicit manager/worker config is optional.
+- No schema change; remains v6.
+
 ## 0.3.1 (2026-11-04)
 
 - README is now user-first: scenarios and install come first; technical details are later.

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 [English](CHANGELOG.en.md) | 中文
 
+## 0.3.2 (2026-11-04)
+
+- 零配置启动：没有 plugin config 时自动启动一条未绑定 manager，根会话可调用 line_claim_manager 自己绑定。
+- 默认 DB 路径跟随 DSH_HOME；未设置时仍为 ~/.dsh/agent-lines/lines.db。
+- README 明确：安装或更新后必须重启 DSH Web；显式 manager/worker 配置变为可选。
+- 无 schema 变化，仍为 v6。
+
 ## 0.3.1 (2026-11-04)
 
 - README 改为用户优先：先场景、安装和首次使用，技术细节后置；安装/快速开始不再要求手填 profile。

package/README.en.md

@@ -31,13 +31,15 @@ One-command install (recommended; no need to find a profile):
 
 The script picks the DSH Web profile, installs the plugin, and verifies agent-lines. If it cannot decide, it lists existing profiles and tells you how to specify one.
 
+**Restart DSH Web after install or update.** A running process does not load new plugin code. With no plugin config the plugin starts in zero-config mode: one unbound manager line, and a root Session can call line_claim_manager to bind itself. The explicit "Manager config" block is optional, for a fixed manager/worker setup.
+
 Offline or when npm is unavailable, use the local tarball:
 
-    bash install.sh ./dsh-agent-lines-0.3.1.tgz
+    bash install.sh ./dsh-agent-lines-0.3.2.tgz
 
-When it finishes, the script prints the path to the manager config file. Paste the "Manager config" block below into that file once.
+After install and restart, it works without a config. When you want a fixed manager/worker setup, paste the "Manager config" block below into the file printed by the installer.
 
-### Manager config
+### Manager config (optional)
 
 ```yaml
 - id: agent-lines
@@ -64,8 +66,8 @@ Only `createFrom` may call `line_create`. Worker profiles should leave `allowCre
 ## Quick start
 
 1. Run the installer above.
-2. Open the config file printed by the installer and paste the "Manager config" block once.
-3. Start DSH Web and open any root Session.
+2. **Restart DSH Web** so the plugin is loaded.
+3. Open any root Session. The zero-config path needs no YAML.
 4. Call line_status; if the Session is not bound, call line_claim_manager({ confirm: "bind-manager" }).
 5. Say "create the first-use team"; wait for the member lines, then send the first task separately.
 

package/README.md

@@ -31,13 +31,15 @@ DSH 的 super agent 平替插件。
 
 脚本会自动选择 DSH Web 使用的 profile，安装后检查 agent-lines 是否可用；如果判断不了，会列出已有配置并提示你怎么指定。
 
+**安装或更新后必须重启 DSH Web。** 运行中的进程不会加载新插件代码。插件没有 config 时走零配置：启动一条未绑定 manager，根会话可以调用 line_claim_manager 自己绑定。显式“管理线配置”是可选的，用于固定 manager/worker。
+
 离线或 npm 不可用时，用本地 tarball：
 
-    bash install.sh ./dsh-agent-lines-0.3.1.tgz
+    bash install.sh ./dsh-agent-lines-0.3.2.tgz
 
-安装完成后，脚本会打印管理线配置文件的路径。把下面“管理线配置”整段粘贴进去一次即可。
+安装并重启后，不写配置也可以直接使用；需要固定管理线/worker 时，再把下面“管理线配置”粘贴到脚本打印的配置文件。
 
-### 管理线配置
+### 管理线配置（可选）
 
 ```yaml
 - id: agent-lines
@@ -64,8 +66,8 @@ DSH 的 super agent 平替插件。
 ## 快速开始
 
 1. 运行上面的安装脚本。
-2. 按脚本提示打开配置文件，把“管理线配置”整段粘贴进去（只做一次）。
-3. 启动 DSH Web，打开任意根会话。
+2. **重启 DSH Web**，让插件加载。
+3. 打开任意根会话。零配置路径不需要改 YAML。
 4. 先调用 line_status；如果当前会话未绑定，调用 line_claim_manager({ confirm: "bind-manager" })。
 5. 直接说“按首次使用创建团队”，然后等它建好成员线；第一个任务再单独发。
 

package/docs/en/index.html

@@ -43,7 +43,7 @@ footer{padding:34px 0 48px;color:var(--muted);font-size:12px}
 <div class="wrap">
 <header>
   <a class="brand" href="../"><span class="mark"></span>dsh-agent-lines</a>
-  <nav><a href="../">中文</a><a href="https://github.com/Lencen/dsh-agent-lines">GitHub</a><a href="https://github.com/Lencen/dsh-agent-lines/releases/tag/v0.3.1">Release</a></nav>
+  <nav><a href="../">中文</a><a href="https://github.com/Lencen/dsh-agent-lines">GitHub</a><a href="https://github.com/Lencen/dsh-agent-lines/releases/tag/v0.3.2">Release</a></nav>
 </header>
 <main>
 <section class="hero" style="border:0;padding-bottom:22px">
@@ -54,7 +54,7 @@ footer{padding:34px 0 48px;color:var(--muted);font-size:12px}
     <div class="install">curl -fsSL https://raw.githubusercontent.com/Lencen/dsh-agent-lines/main/install.sh -o install.sh &amp;&amp; bash install.sh</div>
     <div class="actions">
       <a class="btn primary" href="https://github.com/Lencen/dsh-agent-lines">GitHub repository</a>
-      <a class="btn" href="https://github.com/Lencen/dsh-agent-lines/releases/tag/v0.3.1">Download 0.3.1</a>
+      <a class="btn" href="https://github.com/Lencen/dsh-agent-lines/releases/tag/v0.3.2">Download 0.3.2</a>
     </div>
   </div>
   <div class="shot">
@@ -78,7 +78,7 @@ research / architecture / uiux / dev / test / acceptance / release / ops
 Then call line_list and wait for my first task.</pre>
   <p style="color:var(--muted);font-size:14px">Full docs, protocol, and limits: <a href="https://github.com/Lencen/dsh-agent-lines">README</a>. Community plugin, not an official DeepSeek product.</p>
 </section>
-<footer>dsh-agent-lines 0.3.1 · Apache-2.0 · Community plugin for DeepSeek Harness. Not an official DeepSeek product.</footer>
+<footer>dsh-agent-lines 0.3.2 · Apache-2.0 · Community plugin for DeepSeek Harness. Not an official DeepSeek product.</footer>
 </main>
 </div>
 </body>

package/docs/index.html

@@ -43,7 +43,7 @@ footer{padding:34px 0 48px;color:var(--muted);font-size:12px}
 <div class="wrap">
 <header>
   <a class="brand" href="./"><span class="mark"></span>dsh-agent-lines</a>
-  <nav><a href="en/index.html">English</a><a href="https://github.com/Lencen/dsh-agent-lines">GitHub</a><a href="https://github.com/Lencen/dsh-agent-lines/releases/tag/v0.3.1">Release</a></nav>
+  <nav><a href="en/index.html">English</a><a href="https://github.com/Lencen/dsh-agent-lines">GitHub</a><a href="https://github.com/Lencen/dsh-agent-lines/releases/tag/v0.3.2">Release</a></nav>
 </header>
 <main>
 <section class="hero" style="border:0;padding-bottom:22px">
@@ -54,7 +54,7 @@ footer{padding:34px 0 48px;color:var(--muted);font-size:12px}
     <div class="install">curl -fsSL https://raw.githubusercontent.com/Lencen/dsh-agent-lines/main/install.sh -o install.sh &amp;&amp; bash install.sh</div>
     <div class="actions">
       <a class="btn primary" href="https://github.com/Lencen/dsh-agent-lines">GitHub 仓库</a>
-      <a class="btn" href="https://github.com/Lencen/dsh-agent-lines/releases/tag/v0.3.1">下载 0.3.1</a>
+      <a class="btn" href="https://github.com/Lencen/dsh-agent-lines/releases/tag/v0.3.2">下载 0.3.2</a>
     </div>
   </div>
   <div class="shot">
@@ -78,7 +78,7 @@ research / architecture / uiux / dev / test / acceptance / release / ops
 创建后用 line_list 确认，然后待命。</pre>
   <p style="color:var(--muted);font-size:14px">完整说明、协议和限制见 <a href="https://github.com/Lencen/dsh-agent-lines">README</a>。社区插件，不是 DeepSeek 官方产品。</p>
 </section>
-<footer>dsh-agent-lines 0.3.1 · Apache-2.0 · Community plugin for DeepSeek Harness. Not an official DeepSeek product.</footer>
+<footer>dsh-agent-lines 0.3.2 · Apache-2.0 · Community plugin for DeepSeek Harness. Not an official DeepSeek product.</footer>
 </main>
 </div>
 </body>

package/docs/market-index.json

@@ -50,11 +50,11 @@
         ]
       },
       "dist-tags": {
-        "latest": "0.3.1"
+        "latest": "0.3.2"
       },
       "versions": [
         {
-          "version": "0.3.1",
+          "version": "0.3.2",
           "publishTimestamp": 1793771000,
           "source": {
             "type": "npm"

package/examples/market-index.json

@@ -50,11 +50,11 @@
         ]
       },
       "dist-tags": {
-        "latest": "0.3.1"
+        "latest": "0.3.2"
       },
       "versions": [
         {
-          "version": "0.3.1",
+          "version": "0.3.2",
           "publishTimestamp": 1793771000,
           "source": {
             "type": "npm"

package/lib/index.js

@@ -40,20 +40,25 @@ function normalizeLine(entry, agentId, index) {
 /** Validate and normalize plugin config. Exported for tests and the CLI. */
 export function normalizeConfig(raw = {}) {
   if (raw === null || typeof raw !== 'object') throw new LineError('LINE_INVALID_CONFIG', 'Plugin config must be an object')
-  const agentId = validateAgentId(raw.agentId)
   const legacy = raw.line !== undefined && raw.sessionId !== undefined
     ? [{ label: raw.line, sessionId: raw.sessionId }]
     : []
   const rawLines = Array.isArray(raw.lines) ? raw.lines : legacy
-  if (rawLines.length === 0) throw new LineError('LINE_INVALID_CONFIG', 'At least one line is required (lines[] or line/sessionId)')
-  const lines = rawLines.map((entry, index) => normalizeLine(entry, agentId, index))
+  const zeroConfig = rawLines.length === 0 && raw.lines === undefined && raw.line === undefined
+  const agentId = raw.agentId === undefined && zeroConfig
+    ? 'agent-lines'
+    : validateAgentId(raw.agentId)
+  if (rawLines.length === 0 && !zeroConfig) throw new LineError('LINE_INVALID_CONFIG', 'At least one line is required (lines[] or line/sessionId)')
+  const lines = zeroConfig
+    ? [{ agentId, label: 'manager', sessionId: '', lineId: lineId(agentId, 'manager'), role: null }]
+    : rawLines.map((entry, index) => normalizeLine(entry, agentId, index))
   const labels = new Set()
   const sessions = new Set()
   for (const line of lines) {
     if (labels.has(line.label)) throw new LineError('LINE_INVALID_CONFIG', `Duplicate line label: ${line.label}`)
-    if (sessions.has(line.sessionId)) throw new LineError('LINE_INVALID_CONFIG', `Duplicate sessionId: ${line.sessionId}`)
+    if (line.sessionId !== '' && sessions.has(line.sessionId)) throw new LineError('LINE_INVALID_CONFIG', `Duplicate sessionId: ${line.sessionId}`)
     labels.add(line.label)
-    sessions.add(line.sessionId)
+    if (line.sessionId !== '') sessions.add(line.sessionId)
   }
   const createFrom = raw.createFrom === undefined ? lines[0].label : validateLineLabel(raw.createFrom)
   if (!labels.has(createFrom)) throw new LineError('LINE_INVALID_CONFIG', `createFrom must name a configured line: ${createFrom}`)
@@ -66,9 +71,9 @@ export function normalizeConfig(raw = {}) {
     transport,
     lines,
     createFrom,
-    maxLines: integer(raw.maxLines, 16, { min: lines.length, max: 256 }),
-    allowCreate: raw.allowCreate === true,
-    allowClaim: raw.allowClaim === true,
+    maxLines: integer(raw.maxLines, 16, { min: Math.max(1, lines.length), max: 256 }),
+    allowCreate: raw.allowCreate === undefined ? zeroConfig : raw.allowCreate === true,
+    allowClaim: raw.allowClaim === undefined ? zeroConfig : raw.allowClaim === true,
     allowSelfSend: raw.allowSelfSend === true,
     dedupeWindowMs: integer(raw.dedupeWindowMs, 5_000, { min: 0, max: 3_600_000 }),
     maxReplyDepth: integer(raw.maxReplyDepth, 8, { min: 1, max: 100 }),
@@ -344,6 +349,10 @@ export async function apply(ctx, rawConfig) {
       startupLines.push(effective)
     }
     for (const def of startupLines) {
+      if (def.sessionId === '') {
+        ctx.logger?.info?.('agent-lines: manager %s is unbound; waiting for claim', def.label)
+        continue
+      }
       if (!(await sessionExists(def.sessionId))) {
         ctx.logger?.warn?.('agent-lines: Session %s for line %s is missing; line stays unbound until claimed', def.sessionId, def.label)
         lineDefs.set(def.sessionId, { ...def, missing: true })

package/lib/store.js

@@ -101,7 +101,10 @@ PRAGMA user_version = 6;
 `
 
 export function defaultDbPath() {
-  return resolve(homedir(), '.dsh', 'agent-lines', 'lines.db')
+  const home = process.env.DSH_HOME === undefined || process.env.DSH_HOME.trim() === ''
+    ? resolve(homedir(), '.dsh')
+    : resolve(process.env.DSH_HOME)
+  return resolve(home, 'agent-lines', 'lines.db')
 }
 
 function expandHome(path) {

package/lib/tools.js

@@ -59,6 +59,7 @@ export function registerStatusTool(ctx, { config, store, lineDefs }) {
       const managerConfig = config.lines.find(line => line.label === config.createFrom)
       const managerDef = [...lineDefs.values()].find(line => line.label === config.createFrom)
       const managerSessionId = (managerDef ?? managerConfig)?.sessionId
+      const effectiveManagerSessionId = managerSessionId === undefined || managerSessionId === '' ? undefined : managerSessionId
       const persistence = ctx.get?.('sessionPersistence')
 
       const sessionState = async (sessionId) => {
@@ -71,12 +72,12 @@ export function registerStatusTool(ctx, { config, store, lineDefs }) {
         return { live, persisted }
       }
 
-      const manager = managerSessionId === undefined
+      const manager = effectiveManagerSessionId === undefined
         ? null
         : {
             label: config.createFrom,
-            sessionId: managerSessionId,
-            ...(await sessionState(managerSessionId)),
+            sessionId: effectiveManagerSessionId,
+            ...(await sessionState(effectiveManagerSessionId)),
             lease: store.listLines().find(line => line.label === config.createFrom)?.lease ?? null,
           }
       const lines = store.listLines().map(line => ({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-agent-lines",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "DSH Agent 的持久、可寻址消息线（社区插件）。",
   "type": "module",
   "license": "Apache-2.0",