@tanweilabs/daiti 0.0.1 → 0.0.2

package/README.md

@@ -1,15 +1,15 @@
 # 代体
 
-在你的电脑上运行，通过网页、微信或飞书使用的个人助理。基于 DeepSeek Harness 和 DSH-IM，通过独立插件提供单主会话、助理设置和首次使用流程。
+在你的电脑上运行，通过网页或微信使用的个人助理。基于 DeepSeek Harness 和 DSH-IM，通过独立插件提供单主会话、助理设置和首次使用流程。
 
-**0.0.1 为开发者预览版。** 本包不包含个人记忆、历史会话、密钥或 IM 登录数据。
+**0.0.2 为开发者预览版。** 本包不包含个人记忆、历史会话、密钥或 IM 登录数据。
 
 ## 安装
 
 需要 Node.js `^22.19.0` 或 `>=24.0.0`：
 
 ```sh
-npm install -g @tanweilabs/daiti@0.0.1
+npm install -g @tanweilabs/daiti@0.0.2
 daiti start
 ```
 
@@ -36,7 +36,7 @@ node bin/daiti.mjs stop
 node bin/daiti.mjs start --port 3086 --no-open
 ```
 
-默认端口 3086，只监听本机。关闭浏览器后后台服务继续运行；停止服务或电脑休眠、关机时不能保证 IM 响应。停止前请等待正在执行的任务完成。当前没有开机自启、系统服务或自动升级。
+默认端口 3086，只监听本机；默认端口被占用时自动选择空闲端口，并打开实际地址。同一 DAITI_HOME 已有服务时直接复用；显式指定 `--port` 时不会自动换端口，占用则提示错误。可通过 `daiti status` 查看实际端口。关闭浏览器后后台服务继续运行；停止服务或电脑休眠、关机时不能保证 IM 响应。停止前请等待正在执行的任务完成。当前没有开机自启、系统服务或自动升级。
 
 ## 数据在哪里
 
@@ -55,11 +55,15 @@ DAITI_HOME="$HOME/.daiti-preview" node bin/daiti.mjs stop
 
 PowerShell 对应设置 `$env:DAITI_HOME = "$HOME\.daiti-preview"`。测试时选择新的工作文件夹；不要在两个运行实例中连接同一个 IM 机器人。
 
-## 连接微信和飞书
+## 微信连接
 
-在“设置 → IM机器人”里连接。连接完成后，在本人和机器人的私聊中发送页面生成的 `/session …` 命令，收到绑定成功回复后再开始聊天。不同渠道使用同一条命令，才能共用网页主会话；仅使用同一个工作文件夹不等于共用上下文。
+首版仅支持微信，在“设置 → 助理 → 微信助理”中扫码。连接启动前，代体通过上游自身的绑定方法把扫码账号本人的私聊固定到网页主会话。缺少主会话或目录校验失败时连接报错，不创建替代会话；工作目录和模型由助理统一管理。群聊和非本人消息不接入个人主会话。
 
-现有 DSH-IM 没有公开的扫码激活前绑定接口，因此首版不是自动绑定。如果目标会话工作目录不同，绑定可能重置该机器人的其他会话关联（不删除旧历史）；不要将个人主会话绑定到多人群聊。
+既有错误绑定可在重连时纠正，旧会话历史保留。绑定跨工作区时，上游可能重置该机器人其他会话关联，迁移前需备份。`/new`、`/session` 等切换或配置命令在单助理模式下不可用。
+
+适配包固定 DSH-IM 4.21.0，构建时复用其源码和运行时构造扩展点；不修改原包文件，也不修改 Harness 核心。这些扩展点不是稳定公开 API，上游升级需要契约测试。原许可证保存在适配包中。
+
+0.0.2 已验证主会话绑定与连接健康状态，微信与网页共用会话已由用户实际验收。
 
 ## 开发和本地打包
 
@@ -69,9 +73,9 @@ npm run build
 npm run pack:local
 ```
 
-构建将三个插件打包到 `artifacts/`，生成文件名和 SHA-256 清单。`pack:local` 在 `.local/releases/` 生成 CLI 安装包；包含运行入口、插件包和文档，不包含仓库工作目录、上游源码、个人配置或测试数据。
+构建将四个插件打包到 `artifacts/`，生成文件名和 SHA-256 清单。`pack:local` 在 `.local/releases/` 生成 CLI 安装包；包含运行入口、插件包和文档，不包含仓库工作目录、上游源码、个人配置或测试数据。
 
-未发布的本地安装包可用 `npm install -g /path/to/tanweilabs-daiti-0.0.1.tgz` 安装，随后使用 `daiti start`。安装仍需联网获取声明的运行依赖。
+未发布的本地安装包可用 `npm install -g /path/to/tanweilabs-daiti-0.0.2.tgz` 安装，随后使用 `daiti start`。安装仍需联网获取声明的运行依赖。
 
 - `bin/`、`lib/`：CLI 和后台进程管理。
 - `packages/assistant-ui/`：界面、首次设置和助理配置。
@@ -83,9 +87,9 @@ npm run pack:local
 
 ## 版本和限制
 
-当前固定 Harness `0.1.6-alpha.2`、DSH-IM `4.21.0`。部分界面调整依赖这个版本的插槽、DOM 结构和中文标签；上游升级必须先验收，不能承诺跨版本无改动兼容。
+当前本地代码固定 Harness `0.1.6-alpha.2`、DSH-IM `4.21.0`。部分界面调整依赖这个版本的插槽、DOM 结构和中文标签；上游升级必须先验收，不能承诺跨版本无改动兼容。
 
-完整验证记录见 [docs/validation.md](docs/validation.md)。Windows/Linux 尚需真实机器安装验证；本轮不宣称模型响应或微信/飞书真实收发已端到端通过。升级机制、异常断电恢复和工作目录迁移仍待完善。
+完整验证记录见 [docs/validation.md](docs/validation.md)。Windows/Linux 尚需真实机器安装验证；微信跨端会话已在本机验收，其他平台不在本版支持范围内。升级机制、异常断电恢复和工作目录迁移仍待完善。
 
 ## 许可证
 

package/THIRD_PARTY_NOTICES.md

@@ -6,4 +6,6 @@
 - [DSH-IM](https://github.com/xmanrui/dsh-im), 4.21.0, MIT. Installed as a separate, unmodified dependency with its original license.
 - pnpm, 11.19.0, MIT; esbuild, 0.25.12, MIT (build-time).
 
-The executable package declares the runtime dependencies; setup installs the three local plugin archives and pinned DSH-IM into a separate data directory. No personal memory, session history, model credential or IM login data belongs in this repository or its release artifacts.
+The executable package declares the runtime dependencies; setup installs the four local plugin archives and pinned DSH-IM into a separate data directory. No personal memory, session history, model credential or IM login data belongs in this repository or its release artifacts.
+
+The local single-session WeChat fix bundles selected DSH-IM source through its version-pinned runtime constructor seams. The upstream package files are not edited. Its MIT notice is retained as UPSTREAM-LICENSE in the adapter and assistant UI packages.

package/artifacts/manifest.json

@@ -2,21 +2,27 @@
   "plugins": [
     {
       "name": "@tanweilabs/daiti-ui",
-      "version": "0.0.1",
-      "file": "tanweilabs-daiti-ui-0.0.1.tgz",
-      "sha256": "b6354f22f09c1637632210524f40035a7325e10228719647c2ea4c310c43c456"
+      "version": "0.0.2",
+      "file": "tanweilabs-daiti-ui-0.0.2-3c9ee486f937.tgz",
+      "sha256": "3c9ee486f937aeed2250f013cd53c87d601dc4a102945da9e25cafa97a1c5562"
     },
     {
       "name": "@tanweilabs/daiti-preferences",
-      "version": "0.0.1",
-      "file": "tanweilabs-daiti-preferences-0.0.1.tgz",
-      "sha256": "c458a5895cafe8463433483566793460c9183354b4e3b80a67994972a1f5cf74"
+      "version": "0.0.2",
+      "file": "tanweilabs-daiti-preferences-0.0.2-a0b22ddd8594.tgz",
+      "sha256": "a0b22ddd85949e4e98054be8570bdd6d51661cde5ba33df9e36872c6105f4c2c"
     },
     {
       "name": "@tanweilabs/daiti-loading",
-      "version": "0.0.1",
-      "file": "tanweilabs-daiti-loading-0.0.1.tgz",
-      "sha256": "0914c16b3bd27388004924483263858a7df3ec7c3e7e73b3cae111f48fa957de"
+      "version": "0.0.2",
+      "file": "tanweilabs-daiti-loading-0.0.2-fc449733ecaa.tgz",
+      "sha256": "fc449733ecaafe34452c9544af7cf33a8ed7b6d407b2a5e083f2048b7c5b78b7"
+    },
+    {
+      "name": "@tanweilabs/daiti-im",
+      "version": "0.0.2",
+      "file": "tanweilabs-daiti-im-0.0.2-16f94aa853b3.tgz",
+      "sha256": "16f94aa853b344ff74f93517049e40d95713408a096b4fb60de814637b78256c"
     }
   ]
 }

package/docs/validation.md

@@ -22,3 +22,15 @@
 - UI适配依赖当前Harness版本的插槽及部分DOM结构，升级前需重复浏览器验收。
 
 现有个人代体与历史测试实例不属于本次验收数据，未被迁移、重置或停止。公开发布仓库或安装包仍需单独确认。
+
+## 微信单主会话本地修复
+
+18项自动测试通过，其中9项为IM路由、本人私聊限制、缺主会话拒绝、目录同一性及真实上游 ask 路径。隔离 Host probe 已通过实际 modernHarnessApi、HarnessClient 和 BotWorkspaceStore 的绑定及持久化回读。真实账号启动时发现大小写不同但指向同目录的路径误判，改为文件系统身份比较并增加回归测试。修复后账号显示1/1在线，状态healthy且error为空，绑定ID与网页主ID一致；旧独立微信会话文件哈希仍与备份一致。未主动发送真实微信消息；跨端模型回复待用户验证。本地修复未发布npm。
+
+## 2026-09-21 自动端口选择（待随 0.0.2 发布）
+
+- 默认启动先尝试 3086；被占用时由操作系统分配空闲本机端口，实际端口用于就绪校验、状态查询和浏览器地址。显式 `--port` 冲突时明确报错。
+- 同一 DAITI_HOME 的已认证服务优先复用，不因端口参数重复启动。
+- `npm test` 20 项通过，`npm run build` 通过。
+- 独立 `.local/acceptance` 实例真实启动：3086 已占用时选择 55957，重复启动保持同一实例；停止后显式 3086 报错且未创建服务；再次默认启动选择 56049，主会话 ID 不变；最后测试服务已停止，个人 3086 服务仍就绪。
+- 端口探测与 Harness 绑定之间存在很短的竞争窗口；本次没有覆盖其他进程恰在该窗口抢占新端口的情形。

package/lib/cli.mjs

@@ -5,6 +5,7 @@ import { homedir } from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { randomBytes } from 'node:crypto';
+import { selectPort } from './ports.mjs';
 export const root = fileURLToPath(new URL('../', import.meta.url));
 export const pause = ms => new Promise(resolve => setTimeout(resolve, ms));
 export function paths(env = process.env) {
@@ -18,14 +19,14 @@ export async function atomicJson(file, value) {
   await fs.rename(temp, file);
 }
 export function parseArgs(args) {
-  const command = args[0] || 'help'; let port = 3086, open = true;
+  const command = args[0] || 'help'; let port = 3086, open = true, portExplicit = false;
   for (let i = 1; i < args.length; i++) {
     if (args[i] === '--no-open') open = false;
-    else if (args[i] === '--port') { const value = args[++i]; if (!/^\d+$/.test(value || '') || +value < 1024 || +value > 65535) throw new Error('--port must be between 1024 and 65535'); port = +value; }
+    else if (args[i] === '--port') { const value = args[++i]; if (!/^\d+$/.test(value || '') || +value < 1024 || +value > 65535) throw new Error('--port must be between 1024 and 65535'); port = +value; portExplicit = true; }
     else throw new Error(`Unknown option: ${args[i]}`);
   }
   if (!['setup','start','stop','status','open','help','--help','-h'].includes(command)) throw new Error(`Unknown command: ${command}`);
-  return { command, port, open };
+  return { command, port, open, portExplicit };
 }
 export function runtimeBin() {
   const require = createRequire(path.join(root, 'package.json'));
@@ -72,15 +73,21 @@ export async function setup(p) {
     await fs.copyFile(path.resolve(root, 'artifacts', plugin.file), destination);
     return destination;
   }));
-  await run(['plugin', '--profile', 'web', 'add', '@xmanrui/dsh-im@4.21.0', ...packages], p);
+  await run(['plugin', '--profile', 'web', 'add', '--ignore-scripts', '@xmanrui/dsh-im@4.21.0', ...packages], p);
   const profile = path.join(p.runtime, 'profiles/web');
+  const profileManifest=path.join(profile,'package.json');
+  const profileData=await readJson(profileManifest);
+  const bundles=profileData.dsh.profile.bundles;
+  for(const plugin of manifest.plugins)if(!bundles.includes(plugin.name))bundles.push(plugin.name);
+  await atomicJson(profileManifest,profileData);
   const patch = path.join(profile, 'cordis.patch.yml');
   try { await fs.copyFile(patch, `${patch}.before-daiti-${Date.now()}`); } catch (e) { if (e.code !== 'ENOENT') throw e; }
   // Our overlay is separate from the profile's user-owned patch.
   await atomicJson(path.join(p.home, 'daiti.patch.json'), [
     { id: 'ui-sidebar', disabled: true },
+    { id: 'daiti-single-session-im', disabled: false, config: { settingsPath: path.join(p.home, 'settings.json') } },
     { id: 'daiti-onboarding-preferences', disabled: false, config: { settingsPath: path.join(p.home, 'settings.json') } },
-    { id: 'daiti-ui', disabled: false, config: { settingsPath: path.join(p.home, 'settings.json'), defaultWorkspacePath: path.join(homedir(), 'Daiti') } },
+    { id: 'daiti-ui', disabled: false, config: { settingsPath: path.join(p.home, 'settings.json'), defaultWorkspacePath: path.join(homedir(), 'Daiti'), singleSessionIm: true } },
   ]);
   await atomicJson(marker, { signature, installedAt: new Date().toISOString() });
 }
@@ -104,9 +111,11 @@ export async function main(argv = process.argv.slice(2)) {
   }
   if (options.command === 'open' && !current?.ready) throw new Error('Daiti is not ready. Run daiti start first.');
   if (options.command === 'start' && !current) {
+    // Fail clearly before installing anything when a fixed port is occupied.
+    if (options.portExplicit) await selectPort(options.port, false);
     await setup(p);
     const log = await fs.open(p.log, 'a', 0o600); await log.chmod(0o600);
-    const child = spawn(process.execPath, [path.join(root, 'lib/supervisor.mjs'), String(options.port)], { detached: true, stdio: ['ignore', log.fd, log.fd], env: { ...process.env, DAITI_HOME: p.home } });
+    const child = spawn(process.execPath, [path.join(root, 'lib/supervisor.mjs'), String(options.port), options.portExplicit ? 'fixed' : 'auto'], { detached: true, stdio: ['ignore', log.fd, log.fd], env: { ...process.env, DAITI_HOME: p.home } });
     await new Promise((resolve, reject) => { child.once('spawn', resolve); child.once('error', reject); });
     child.unref(); await log.close();
     for (let i = 0; i < 240; i++) { current = await control(await readJson(p.state)); if (current?.ready) break; if (child.exitCode !== null) throw new Error(`Daiti exited during startup; inspect ${p.log}`); await pause(250); }

package/lib/ports.mjs

@@ -0,0 +1,23 @@
+import { createServer } from 'node:net';
+
+// Probe the same loopback address used by Harness. Port 0 lets the OS choose
+// an available port; no assumptions about neighbouring ports being free.
+async function probe(port) {
+  const server = createServer();
+  await new Promise((resolve, reject) => {
+    server.once('error', reject);
+    server.listen({ port, host: '127.0.0.1', exclusive: true }, resolve);
+  });
+  const selected = server.address().port;
+  await new Promise((resolve, reject) => server.close(error => error ? reject(error) : resolve()));
+  return selected;
+}
+
+export async function selectPort(port, automatic = false) {
+  try { return await probe(port); }
+  catch (error) {
+    if (error.code !== 'EADDRINUSE') throw error;
+    if (automatic) return probe(0);
+    throw new Error(`Port ${port} is already in use. Choose another --port, or omit --port to select automatically.`, { cause: error });
+  }
+}

package/lib/supervisor.mjs

@@ -4,6 +4,7 @@ import { promises as fs } from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { randomBytes, timingSafeEqual } from 'node:crypto';
+import { selectPort } from './ports.mjs';
 import { paths, atomicJson, runtimeBin, runtimePath, root } from './cli.mjs';
 
 
@@ -36,7 +37,7 @@ export async function verifyLaunchUrl(value) {
 
 // Only this parent signals its own ChildProcess. CLI clients never signal a PID
 // obtained from disk, so stale state / PID reuse cannot terminate another app.
-export async function supervise({ p = paths(), port, command = process.execPath, args, timeoutMs = 60000 }) {
+export async function supervise({ p = paths(), port, autoPort = false, command = process.execPath, args, timeoutMs = 60000 }) {
   const lockPath = path.join(p.home, 'service.lock');
   let lock;
   try { lock = await fs.open(lockPath, 'wx', 0o600); }
@@ -60,6 +61,9 @@ export async function supervise({ p = paths(), port, command = process.execPath,
     } else server.close();
   }
   try {
+    const requestedPort = port;
+    port = await selectPort(port, autoPort);
+    if (port !== requestedPort) console.log(`Port ${requestedPort} is occupied; using ${port}.`);
     await new Promise((resolve, reject) => { server.once('error', reject); server.listen(0, '127.0.0.1', resolve); });
     await atomicJson(p.state, { instance, secret, controlPort: server.address().port, pid: process.pid });
     child = spawn(command, args || [runtimeBin(), '--profile', 'web', '--patch', path.join(p.home, 'daiti.patch.json'), '--host', '127.0.0.1', '--port', String(port), '--no-open'], { env: { ...process.env, DSH_HOME: p.runtime, PATH: runtimePath() }, cwd: p.home, stdio: ['ignore', 'pipe', 'pipe'] });
@@ -87,5 +91,5 @@ export async function supervise({ p = paths(), port, command = process.execPath,
   } finally { server.close(); await cleanup(); }
 }
 if (process.argv[1] === fileURLToPath(import.meta.url)) {
-  supervise({ port: Number(process.argv[2]) }).catch(error => { console.error(error.message); process.exitCode = 1; });
+  supervise({ port: Number(process.argv[2]), autoPort: process.argv[3] === 'auto' }).catch(error => { console.error(error.message); process.exitCode = 1; });
 }