lantern-harness 0.1.1 → 0.1.3

package/CHANGELOG.md

@@ -1,5 +1,77 @@
 # 版本日志
 
+## [0.1.3] - 2026-10-18
+
+新增「待办与效率」两个插件（任务管理 / 待办事项）并把提示词管理改为内置常开项；空间管理弹窗重做为单层卡片式流程，空间复制不再串数据。
+
+### 新增
+
+#### 待办与效率
+
+- 新插件分类「待办与效率」，内建两个独立插件，数据按空间隔离：任务存 `<空间>/.lantern/local/tasks.json`，待办存 `<空间>/.lantern/local/todos.json`，切换空间看到各自的数据
+- 任务管理：任务池 / 进行中 / 已完成 / 已关闭四态，顶部六张统计卡片（全部 / 任务池 / 进行中 / 已完成 / 已关闭 / 需要紧急）；行内改状态与紧急程度、点日期弹卡片日历、任务周期自动计算；「待办数量」「完成进度」按待办里的「所属任务」实时汇总；右侧抽屉可改名称 / 日期 / 备注并查看已关联待办
+- 待办事项：飞书多维表格样式的列表，按状态分组（进行中 / 待开始 / 已延期 / 已完成 / 已取消）、组标题可折叠，分组方式还可切为「按紧急程度」或「不分组」
+- 待办行内直接改名称 / 状态 / 紧急程度 / 所属任务 / 开始与截止日期 / 备注；状态下拉与紧急程度用颜色胶囊区分，不显示对钩；备注与名称超长省略号显示
+- 每个分组底部「+ 新增记录」：展开一行填完即保存（回车或点空白处），没填任何内容时点空白处自动收起，Esc 放弃；顶部「新建待办」从右侧滑出详情抽屉
+- **结束日期改为只读派生值**：状态改为「已完成 / 已取消」时自动记为当天，之后再改其它字段不会刷新；状态改回「待开始 / 进行中」时清空并显示「待办未完成」；表格、抽屉、AI 工具改状态都按同一规则处理
+- 待办的「所属任务」下拉不出已关闭的任务；待办关联任务时把任务从「任务池 / 已完成」拉回「进行中」（已关闭的不动），打开待办页时也会对既有未完成待办做一次同样对齐
+- 新建待办 / 任务的开始日期、截止日期默认当天
+- 列宽可拖：鼠标移到表头字段右边缘左右拖动即可，宽度按页面记在浏览器本地；宽屏下保持紧凑间距，深色主题下表格、胶囊、日历均已适配
+- 工作台「+」→「计划」下面新增「待办」「任务」手动入口（对应插件关闭时该入口隐藏）：复用新增前的确认卡片，待办分两页（第一页字段、第二页选所属任务并只读展示任务的名称 / 状态 / 紧急程度 / 起止日期，选中后自动带日期与紧急程度到第一页）；手动入口的最后一个按钮是「提交」，AI 触发的仍是「确认新增」；点「取消」或卡片外面只播收起动画，不写入数据
+- 工作台「回合」右侧新增「待办」Tab：默认「全部待办」，按 已逾期 / 今天截止 / 接下来 / 没有截止日期 / 已完成 分桶，也可只看未完成或已完成；每行显示名称、紧急程度、截止日期、剩余天数与所属任务，点左侧圆圈标记完成，右上角跳转完整待办页，停留时每 15 秒自动刷新
+- AI 工具：`todo_add` / `todo_list` / `todo_update` / `todo_delete`、`task_add` / `task_list` / `task_update` / `task_delete`，写入前统一弹确认卡片
+
+#### 空间管理
+
+- 空间管理弹窗重做为单层卡片：默认展示全部空间，「+ 新增空间」直接在弹窗内展开，点击取消回到全部空间；新建空间不再二次弹窗，去掉了无用的「完成」按钮
+- 新增「编辑空间」：可改名称、提示词要求与默认提示词；公共空间名称为锁定状态；保存后当前空间的默认提示词立即生效
+- 新建与编辑共用「提示词要求」输入框：回车触发生成，Shift+回车换行，随内容自动增高
+- 每个空间都补齐「提示词管理 / 默认提示词」，缺失时按包内种子补一份；空间里另存一份「提示词要求」（`.lantern/config/space-brief.json`），便于之后重新生成
+- 空间复制补齐收尾：复制品的工作区注册表改指新目录（此前新空间打开时「工作区」仍停在源空间）；跳过会话检索 sqlite（含 WAL / shm）与 spill 等可重建缓存；仍有会话在运行时拒绝复制并提示先停止
+- 重命名当前空间后服务端数据根同步指向新目录，不再需要重启或手动切换空间
+- 外部纳入的空间在已有 `.lantern` 元数据时「删除数据」按真实删除处理，不再只移出列表留下空壳
+
+#### 插件与导航
+
+- 提示词管理改为**内置常开项**：每个空间都需要默认提示词，插件页显示「内置」且不提供开关；入口固定到侧栏「帮助中心」上方，不参与分组与手动排序
+- 侧栏新增「任务管理」「待办事项」入口，随插件开关显示 / 隐藏；「全局插件」文档补上 `todos` / `tasks`
+- 菜单三点弹窗里的「选择分组」改为「加入分组」
+- 提示词管理页移除「在会话中打开」按钮
+- 新增通用组件：列宽拖拽、卡片式日期选择（去掉原生日历图标，底部「清除 / 今天」）、新增前确认卡片、工作台待办 Tab；`SelectDropdown` 支持自定义触发器与选项前缀、无边框样式、菜单最小宽度
+
+### 变更
+
+- 新建空间默认开启「提示词管理」，侧栏默认是「我的工作台」「提示词管理」「帮助中心」；其余插件仍默认关闭
+- 空间固有内容不再受插件开关影响：提示词管理目录与默认提示词始终存在，旧版本铺出的空壳目录照旧收起
+- 待办抽屉里的「任务结束日期」改称「结束日期」，由日期选择器改为只读文本
+- 版本日志页：没有导语的版本会按小节自动生成一句概览，不再只剩标题
+
+### 修复
+
+- 菜单排序列表里不再出现已关闭插件的条目
+- 编辑空间时不再出现 notfound；新建空间取消后正确回到全部空间列表；新建按钮不可点时有明确的禁用鼠标状态
+- 无数据时待办 / 任务页只保留右上角新建按钮，仍可正常新建
+- 创建确认卡片点卡片外面关闭时带退场动画且不落库，同时修掉该组件的 Fast Refresh 报错
+- 工作台「待办」Tab 在插件关闭时自动退回「对话」，不会停在空白页
+
+### 文档
+
+- 操作手册补「任务管理」「待办事项」两节（字段、分组、内联新增、结束日期规则、任务关联），以及工作台「+」手动新增、确认卡片两页流程与待办 Tab
+- 操作手册补空间管理的新建 / 编辑、复制空间的注意事项（会话运行中不可复制）与删除外部空间的判定
+- 安装手册去掉框架版本信息，首次进入的默认插件表与侧栏说明按「提示词管理内置常开」更新；README 功能表与「全局插件」规格同步补上 `todos` / `tasks`
+
+## [0.1.2] - 2026-10-18
+
+### 变更
+
+- 升级命令由 `lantern install [版本]` 改为 `lantern update` / `lantern update <版本>`，帮助与文档同步；`lantern install` 保留为兼容别名
+- ACP `initialize` 的版本号改为读 `package.json`，不再随发版手改
+
+### 修复
+
+- 重新 `lantern init` 换了数据目录后，空间列表与「当前空间」仍指向上一个数据目录里的空间：注册表改为按池根分区（每条空间记 `root`，激活项记 `activeByRoot`），列表只看当前数据目录；旧版全局 `activeId` 与无 `root` 的条目在读取时按路径推断归属，向后兼容
+- `lantern web` / `lantern status` 把生效的空间目录标成「当前空间」，不再和数据目录混为一谈
+
 ## [0.1.1] - 2026-10-18
 
 ### 变更
@@ -151,5 +223,7 @@ Lantern Harness 首个版本：AI 工作台。一份进程里隔离多套项目
 - 开发服忽略打开内容库目录与空间元数据目录导致的整页热更新
 - 文档与 CLI 统一 pnpm 优先：安装 / 卸载 / 版本列表优先调用 pnpm（未安装则回退 npm）；README、安装手册、操作手册与贡献约定的开发命令改为 pnpm
 
+[0.1.3]: https://www.npmjs.com/package/lantern-harness/v/0.1.3
+[0.1.2]: https://www.npmjs.com/package/lantern-harness/v/0.1.2
 [0.1.1]: https://www.npmjs.com/package/lantern-harness/v/0.1.1
 [0.1.0]: https://www.npmjs.com/package/lantern-harness/v/0.1.0

package/README.md

@@ -8,11 +8,11 @@ AI 工作台：对话与插件工具、需求 / 用例 / 知识 / 提示词内
 
 ## 功能
 
-| 模块      | 说明                                                                                                                                         |
-| --------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
-| AI 工作台 | 多轮对话，流式输出，BYOK（自带密钥）直连模型；默认提示词按空间可改，可按插件挂载工具                                                         |
-| 会话记忆  | 五轨记忆（用户档案 / 全局事实 / 项目关键 / 项目日志 / 每日），待确认队列与工作台「记忆」Tab                                                  |
-| 插件库    | 内置能力开关：内容库（需求 / 用例 / 提示词 / 知识库 / 模板）、生成能力、记忆与检索、开发工具；开启后侧栏出现对应入口，也可让模型推荐能力建议 |
+| 模块      | 说明                                                                                                                                                     |
+| --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| AI 工作台 | 多轮对话，流式输出，BYOK（自带密钥）直连模型；默认提示词按空间可改，可按插件挂载工具                                                                     |
+| 会话记忆  | 五轨记忆（用户档案 / 全局事实 / 项目关键 / 项目日志 / 每日），待确认队列与工作台「记忆」Tab                                                              |
+| 插件库    | 内置能力开关：内容库（需求 / 用例 / 提示词 / 知识库 / 模板）、生成能力、记忆与检索、任务与待办、开发工具；开启后侧栏出现对应入口，也可让模型推荐能力建议 |
 
 模型配置（BYOK）、内容目录约定、插件用法见 **[操作手册](https://lantern.yychuiyan.com/docs/manual/)**。
 
@@ -28,7 +28,7 @@ AI 工作台：对话与插件工具、需求 / 用例 / 知识 / 提示词内
 npx lantern-harness
 ```
 
-执行后会安装全局短命令 `lantern`，之后用 `lantern init` / `lantern web` 操作即可。升级用 `lantern install`。
+执行后会安装全局短命令 `lantern`，之后用 `lantern init` / `lantern web` 操作即可。升级用 `lantern update`。
 
 2、 初始化数据空间（首次必做；可再次执行以更换数据空间）：
 
@@ -61,9 +61,9 @@ lantern logs           # 查看服务日志
 lantern doctor         # 检查运行环境与配置是否正常
 lantern help           # 显示操作命令列表
 lantern version        # 显示当前版本号
-lantern list           # 显示可安装的版本列表
-lantern install        # 安装/更新到最新版本
-lantern install 0.1.x  # 安装/更新到指定版本
+lantern list           # 显示可用版本列表
+lantern update         # 更新到最新版本
+lantern update 0.1.x   # 更新到指定版本
 lantern uninstall      # 卸载本机 lantern 命令（保留数据空间）
 lantern wipe           # 删除当前数据空间（需确认；不可恢复）
 lantern space list     # 列出全部数据空间与当前项
@@ -76,7 +76,7 @@ lantern acp            # 以 ACP 子集供外部编排驱动无 UI Agent
 
 4、 插件默认值：
 
-新建空间的插件全部默认关闭，侧栏只有「我的工作台」「帮助中心」。所有扩展插件（内容库、生成能力、知识库检索、会话记忆、插件开发）都要在「插件」页按分类手动开启；由「插件开发」新增的插件同样默认关闭。
+新建空间默认开启「提示词管理」（每个空间都要有默认提示词，属于内置常开项），侧栏为「我的工作台」「提示词管理」「帮助中心」。其余扩展插件（其它内容库、生成能力、知识库检索、会话记忆、任务管理 / 待办事项、插件开发）都要在「插件」页按分类手动开启；由「插件开发」新增的插件同样默认关闭。
 
 ### 方式二：源码启动
 

package/builtin/session/lh-spaces.mjs

@@ -15,8 +15,12 @@ import os from 'node:os';
 import path from 'node:path';
 
 import {
+  ensureSpaceSystemPrompt,
   prepareExternalSpaceDir,
   prepareSpaceDir,
+  readSpaceBrief,
+  readSpaceSystemPrompt,
+  writeSpaceBrief,
   writeSpaceSystemPrompt,
 } from '../../cli/data-root.mjs';
 import {
@@ -37,6 +41,7 @@ import {
   resolveSpace,
   sanitizeSpaceName,
   setActiveSpace,
+  setRegistryRoot,
   spaceSize,
 } from '../../cli/spaces.mjs';
 import { loadRunState, saveRunState } from '../../cli/user-config.mjs';
@@ -206,12 +211,29 @@ function syncActiveRoot() {
   return { ok: true, id: activeId, changed: true };
 }
 
+/** 重命名的是当前空间时，把服务的数据根指到新目录（否则后续读写仍指向旧路径） */
+function retargetActiveRoot(space) {
+  if (!space || getActiveSpaceId() !== space.id) return;
+  try {
+    const nextRoot = prepareSpaceDir(space.path);
+    if (path.resolve(nextRoot) === path.resolve(getDataRoot())) return;
+    setActiveRoot(nextRoot);
+    closeAllBashSessions();
+    closeAllPwshSessions();
+    syncRunState(nextRoot);
+  } catch {
+    // 名称已改；路径对齐失败时下次切换空间会自愈
+  }
+}
+
 export function lhSpacesPlugin() {
   return {
     name: 'lh-spaces',
     configureServer(server) {
       // 首次进入确定基准根；已切换过的空间不会被覆盖
       ensureSpaceContext(server.config.root);
+      // 注册表按池根分区：先告诉它当前是哪个数据目录，才能只认自己的空间与激活项
+      setRegistryRoot(getBaseRoot());
       // 新进程里 activeRoot 默认是公共空间：按注册表回到用户上次选的空间
       syncActiveRoot();
 
@@ -254,6 +276,8 @@ export function lhSpacesPlugin() {
             try {
               prepareSpaceDir(created.space.path);
               if (promptText.trim()) writeSpaceSystemPrompt(created.space.path, promptText);
+              const brief = typeof body.promptBrief === 'string' ? body.promptBrief.trim() : '';
+              if (brief) writeSpaceBrief(created.space.path, brief);
             } catch (e) {
               return sendJson(res, 500, {
                 ok: false,
@@ -277,11 +301,92 @@ export function lhSpacesPlugin() {
             const body = await readJson(req);
             const out = renameSpace(body.id, body.name, getBaseRoot());
             if (!out.ok) return sendJson(res, 400, { ok: false, error: out.error });
+            retargetActiveRoot(out.space);
             return sendJson(res, 200, { ok: true, space: out.space });
           }
 
+          // 空间详情：名称 / 提示词要求 / 默认提示词，供管理面板编辑
+          if (url === `${PREFIX}/detail` && req.method === 'GET') {
+            const q = new URLSearchParams(req.url.split('?')[1] ?? '');
+            const resolved = resolveSpace(q.get('id') ?? '', getBaseRoot());
+            if (!resolved.ok) return sendJson(res, 404, { ok: false, error: resolved.error });
+            const space = resolved.space;
+            // 外部纳入的空间不铺骨架；托管空间补齐默认提示词文件
+            if (!space.external) {
+              try {
+                prepareSpaceDir(space.path);
+              } catch {
+                // 目录暂时不可写时仍然返回已有内容
+              }
+            }
+            return sendJson(res, 200, {
+              ok: true,
+              space,
+              brief: readSpaceBrief(space.path),
+              systemPrompt: readSpaceSystemPrompt(space.path),
+            });
+          }
+
+          // 保存空间名称 / 提示词要求 / 默认提示词
+          if (url === `${PREFIX}/update` && req.method === 'POST') {
+            const body = await readJson(req);
+            const resolved = resolveSpace(body.id, getBaseRoot());
+            if (!resolved.ok) return sendJson(res, 404, { ok: false, error: resolved.error });
+            let space = resolved.space;
+
+            const nextName = typeof body.name === 'string' ? body.name.trim() : '';
+            if (nextName && nextName !== space.name) {
+              if (space.isPublic) {
+                return sendJson(res, 400, {
+                  ok: false,
+                  error: `${PUBLIC_SPACE_NAME}不支持重命名`,
+                });
+              }
+              const renamed = renameSpace(space.id, nextName, getBaseRoot());
+              if (!renamed.ok) return sendJson(res, 400, { ok: false, error: renamed.error });
+              space = renamed.space;
+              retargetActiveRoot(space);
+            }
+
+            if (typeof body.brief === 'string') {
+              if (body.brief.length > 20_000) {
+                return sendJson(res, 400, { ok: false, error: '提示词要求过长' });
+              }
+              writeSpaceBrief(space.path, body.brief);
+            }
+
+            if (typeof body.systemPrompt === 'string' && body.systemPrompt.trim()) {
+              if (body.systemPrompt.length > 80_000) {
+                return sendJson(res, 400, { ok: false, error: '默认提示词过长' });
+              }
+              try {
+                if (!space.external) ensureSpaceSystemPrompt(space.path);
+                writeSpaceSystemPrompt(space.path, body.systemPrompt);
+              } catch (e) {
+                return sendJson(res, 500, {
+                  ok: false,
+                  error: e instanceof Error ? e.message : String(e),
+                });
+              }
+            }
+
+            return sendJson(res, 200, {
+              ok: true,
+              space,
+              brief: readSpaceBrief(space.path),
+              systemPrompt: readSpaceSystemPrompt(space.path),
+            });
+          }
+
           if (url === `${PREFIX}/copy` && req.method === 'POST') {
             const body = await readJson(req);
+            // 复制是逐文件拷贝：会话在跑时源空间仍在写，拷出来可能半份
+            if (hasRunningSessions()) {
+              return sendJson(res, 409, {
+                ok: false,
+                error: '仍有会话在运行，请先停止后再复制空间',
+              });
+            }
             const out = copySpace(body.id, body.name, getBaseRoot());
             if (!out.ok) return sendJson(res, 400, { ok: false, error: out.error });
             return sendJson(res, 200, { ok: true, space: out.space });

package/cli/acp-server.mjs

@@ -13,10 +13,24 @@
  * - session/update  { sessionId, toolCall: { name, status, args?, result? } }
  */
 import readline from 'node:readline';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
 import { headlessAsk, loadHeadlessSettings } from './headless.mjs';
 
 const PROTOCOL_VERSION = 1;
 
+/** 与 package.json 保持同源，避免发版时漏改 */
+const SERVER_VERSION = (() => {
+  try {
+    const pkg = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', 'package.json');
+    return JSON.parse(fs.readFileSync(pkg, 'utf8')).version || '0.0.0';
+  } catch {
+    return '0.0.0';
+  }
+})();
+
 function send(msg) {
   process.stdout.write(`${JSON.stringify(msg)}\n`);
 }
@@ -74,7 +88,7 @@ export async function runAcpServer(opts) {
           protocolVersion: PROTOCOL_VERSION,
           serverInfo: {
             name: 'lantern-harness-acp',
-            version: '0.1.1',
+            version: SERVER_VERSION,
           },
           capabilities: {
             sessions: true,

package/cli/data-root.mjs

@@ -202,13 +202,16 @@ export function prepareSpaceDir(spaceDir) {
     fs.copyFileSync(PKG_DEFAULTS, destDefaults);
   }
 
-  // 内容目录按插件开关懒建：插件全关的新空间就是一个干净目录，
-  // 不会先铺出「用例管理 / 知识库管理」这类用户还没启用的入口。
+  // 内容目录按插件开关懒建：插件全关的新空间就是一个干净目录（提示词管理例外，
+  // 它承载每个空间必备的「默认提示词」），不会先铺出「用例管理 / 知识库管理」这类入口。
   for (const { dirName, legacyDirNames } of Object.values(DOC_ROOT_DIRS)) {
     // 必须先迁移：一旦先建出中文目录，旧目录里的文件就再也不会被搬过来
     migrateLegacyRoot(root, legacyDirNames, dirName);
     const dir = resolveContentRoot(root, dirName).abs;
-    const enabled = isContentRootEnabled(root, dirName);
+    // 提示词管理是空间的固有部分：每个空间都有「默认提示词」，不受插件开关影响。
+    // 新建空间 / npm 安装后首次启动都要把它铺出来，否则提示词页无内容可显示。
+    const alwaysOn = dirName === DOC_ROOT_DIRS.prompts.dirName;
+    const enabled = alwaysOn || isContentRootEnabled(root, dirName);
     // 旧版本会给所有内容目录铺一个只有 .gitkeep 的空壳：插件没启用就收掉，
     // 让升级后的数据空间和全新安装保持一致（有真实内容的目录绝不动）
     if (!enabled && isDir(dir) && onlyPlaceholders(dir)) {
@@ -224,6 +227,12 @@ export function prepareSpaceDir(spaceDir) {
 
   // 种子只补进已存在的目录（种子晚于建目录，这样「目录已存在」不会阻止种子落位）
   seedSpaceDir(root);
+  // 提示词是空间固有内容：种子缺失或旧空间没铺过时也补一份默认提示词
+  try {
+    ensureSpaceSystemPrompt(root);
+  } catch {
+    // 只读 / 权限异常时不阻断空间准备，提示词页会回退到空内容
+  }
 
   // 新建空间：种子不算「用户搬进来的内容」，别让它触发插件自动开启
   if (freshSpace) markNavRootsDetected(root);
@@ -374,6 +383,74 @@ export function seedSpaceDir(spaceDir) {
   return planted;
 }
 
+/**
+ * 确保空间有「提示词管理」目录与「默认提示词」文件（缺失时用包内种子补上）。
+ * 幂等：提示词页、空间管理编辑面板都靠它拿到当前空间的默认提示词。
+ * @param {string} spaceDir
+ * @returns {string} 默认提示词文件的绝对路径
+ */
+export function ensureSpaceSystemPrompt(spaceDir) {
+  const root = path.resolve(spaceDir);
+  const dir = resolveContentRoot(root, DOC_ROOT_DIRS.prompts.dirName).abs;
+  fs.mkdirSync(dir, { recursive: true });
+  const dest = path.join(dir, SPACE_SYSTEM_PROMPT_FILE);
+  if (!fs.existsSync(dest)) {
+    const seed = path.join(PKG_SEEDS, DOC_ROOT_DIRS.prompts.dirName, SPACE_SYSTEM_PROMPT_FILE);
+    try {
+      if (fs.existsSync(seed)) {
+        const buf = fs.readFileSync(seed);
+        fs.writeFileSync(dest, buf);
+      }
+    } catch {
+      // 种子只是初始内容：失败不阻断读取，前台会显示空提示词
+    }
+  }
+  return dest;
+}
+
+/** 读取空间默认提示词正文（缺失时返回空串，不改动磁盘） */
+export function readSpaceSystemPrompt(spaceDir) {
+  try {
+    const fp = path.join(
+      resolveContentRoot(path.resolve(spaceDir), DOC_ROOT_DIRS.prompts.dirName).abs,
+      SPACE_SYSTEM_PROMPT_FILE,
+    );
+    if (!fs.existsSync(fp)) return '';
+    return fs.readFileSync(fp, 'utf8').replace(/\r\n/g, '\n').trim();
+  } catch {
+    return '';
+  }
+}
+
+/** 空间的「提示词要求」：跟着空间走的小段描述，存 `.lantern/config/space-brief.json` */
+export function readSpaceBrief(spaceDir) {
+  try {
+    const raw = JSON.parse(
+      fs.readFileSync(spaceConfigFile(path.resolve(spaceDir), 'space-brief.json'), 'utf8'),
+    );
+    return typeof raw?.brief === 'string' ? raw.brief : '';
+  } catch {
+    return '';
+  }
+}
+
+/**
+ * 写入空间「提示词要求」（允许写空串，用于清空）。
+ * @param {string} spaceDir
+ * @param {string} brief
+ * @returns {boolean}
+ */
+export function writeSpaceBrief(spaceDir, brief) {
+  try {
+    const dest = spaceConfigFile(path.resolve(spaceDir), 'space-brief.json');
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    fs.writeFileSync(dest, `${JSON.stringify({ brief: String(brief ?? '') }, null, 2)}\n`, 'utf8');
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 /**
  * 把生成/手写的提示词写成该空间的默认提示词（覆盖种子，不覆盖空串）。
  * @param {string} spaceDir

package/cli/lantern.mjs

@@ -36,6 +36,7 @@ import {
   createSpace,
   discoverSpaces,
   exportSpaceToZip,
+  forgetRegistryRoot,
   importSpaceFromZip,
   listSpaces,
   PUBLIC_SPACE_LABEL,
@@ -43,6 +44,7 @@ import {
   renameSpace,
   resolveSpace,
   setActiveSpace,
+  setRegistryRoot,
 } from './spaces.mjs';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
@@ -143,8 +145,9 @@ function printHelp() {
   lantern doctor            检查运行环境与配置
   lantern help              显示本帮助
   lantern version           显示当前版本号
-  lantern list              显示可安装的版本列表
-  lantern install [版本]    安装/更新（默认 latest）
+  lantern list              显示可用版本列表
+  lantern update            更新到最新版本
+  lantern update <版本>     更新到指定版本
   lantern uninstall         卸载本机 lantern（保留数据空间）
   lantern wipe              删除当前数据空间（需确认）
 
@@ -205,6 +208,7 @@ function requireDataRoot(dirOverride) {
   if (dirOverride) {
     const dataRoot = path.resolve(dirOverride);
     if (!fs.existsSync(dataRoot)) fs.mkdirSync(dataRoot, { recursive: true });
+    setRegistryRoot(dataRoot);
     return dataRoot;
   }
   const result = resolveConfiguredDataRoot();
@@ -212,6 +216,8 @@ function requireDataRoot(dirOverride) {
     printDataRootUnavailable(result);
     process.exit(1);
   }
+  // 注册表按池根分区：换过数据空间后，只认这个目录下的空间
+  setRegistryRoot(result.dataRoot);
   return result.dataRoot;
 }
 
@@ -239,6 +245,8 @@ async function cmdInit() {
   }
   prepareSpacesRoot(spacesRoot);
   saveUserConfig({ dataRoot: spacesRoot, host: '127.0.0.1', port: 4321 });
+  // 换数据目录后注册表要按新池根分区，别把上一个目录的空间与激活项带过来
+  setRegistryRoot(spacesRoot);
   console.log('');
   console.log('数据目录已关联：');
   console.log(`  ${spacesRoot}`);
@@ -267,7 +275,7 @@ async function runForegroundServer(dataRoot) {
   console.log('');
   console.log('Lantern Harness 已启动');
   console.log(`  地址：${url}`);
-  console.log(`  数据空间：${root}`);
+  console.log(`  当前空间：${root}`);
   console.log('  按 Ctrl+C 停止');
   console.log('');
 }
@@ -278,7 +286,7 @@ function cmdStart({ foreground = false, dir = null } = {}) {
   if (alive) {
     console.log(`服务已在运行（pid ${alive.pid}）`);
     console.log(`  地址：${alive.url}`);
-    console.log(`  数据空间：${alive.dataRoot}`);
+    console.log(`  当前空间：${alive.dataRoot}`);
     return;
   }
 
@@ -311,9 +319,10 @@ function cmdStart({ foreground = false, dir = null } = {}) {
       console.log('');
       console.log('Lantern Harness 已在后台启动');
       console.log(`  地址：${state.url}`);
-      console.log(`  数据空间：${state.dataRoot}`);
-      console.log(`  日志：${logPath}`);
+      console.log(`  当前空间：${state.dataRoot}`);
       console.log('  停止：lantern stop');
+      console.log('  更新：lantern update');
+      console.log('  更多命令：lantern help');
       console.log('');
       return;
     }
@@ -388,6 +397,7 @@ function cmdStatus() {
   if (run) {
     console.log(`状态：运行中（pid ${run.pid}）`);
     console.log(`地址：${run.url}`);
+    console.log(`当前空间：${run.dataRoot}`);
   } else {
     console.log('状态：未运行');
   }
@@ -510,10 +520,10 @@ function cmdList() {
   }
 }
 
-function cmdInstall(version) {
+function cmdUpdate(version) {
   const pm = getPackageManager();
   const spec = version ? `${PKG_NAME}@${version}` : `${PKG_NAME}@latest`;
-  console.log(`正在安装 ${spec} …`);
+  console.log(version ? `正在更新到 ${spec} …` : `正在更新到最新版本（${spec}）…`);
   const r = spawnSync(pm, pmGlobalArgs(pm, 'install', spec), {
     stdio: 'inherit',
     shell: process.platform === 'win32',
@@ -526,8 +536,12 @@ function cmdInstall(version) {
 /** CLI 里的「基准根」：与网页端一致 —— 已记住的数据空间 */
 function spaceBaseRoot() {
   const result = resolveConfiguredDataRoot();
-  if (result.ok) return result.dataRoot;
+  if (result.ok) {
+    setRegistryRoot(result.dataRoot);
+    return result.dataRoot;
+  }
   // 尚未 init 时，池根退化到当前目录，保证 space 命令本身可用
+  setRegistryRoot(process.cwd());
   return process.cwd();
 }
 
@@ -823,6 +837,7 @@ async function cmdWipe() {
   if (run) cmdStop();
 
   fs.rmSync(resolved, { recursive: true, force: true });
+  forgetRegistryRoot(resolved);
   clearDataRootFromConfig();
   console.log('数据空间已删除，配置中的关联已清除。');
   console.log('如需继续使用，请使用 lantern init 初始化或选择已有数据空间。');
@@ -933,8 +948,10 @@ async function main() {
       case 'list':
         cmdList();
         break;
+      case 'update':
+      // 旧文档 / 老脚本里的 install 仍可用，输出与 update 一致
       case 'install':
-        cmdInstall(args[0]);
+        cmdUpdate(args[0]);
         break;
       case 'uninstall':
         cmdUninstall();

package/cli/server.mjs

@@ -16,6 +16,8 @@ import { lhSpillPlugin } from '../builtin/session/lh-spill.mjs';
 import { lhKbPlugin } from '../lh-plugins/lh-kb.mjs';
 import { lhMemoryPlugin } from '../lh-plugins/lh-memory.mjs';
 import { lhResourcesPlugin } from '../lh-plugins/lh-resources.mjs';
+import { lhTodosPlugin } from '../lh-plugins/lh-todos.mjs';
+import { lhTasksPlugin } from '../lh-plugins/lh-tasks.mjs';
 import { lhWebPlugin } from '../builtin/session/lh-web.mjs';
 import { tbSessionRunsPlugin } from '../builtin/session/session-runs.mjs';
 import { lhSpacesPlugin } from '../builtin/session/lh-spaces.mjs';
@@ -48,6 +50,8 @@ function attachPlugins(app, dataRoot) {
   const plugins = [
     tbSessionRunsPlugin(),
     lhSpacesPlugin(),
+    lhTodosPlugin(),
+    lhTasksPlugin(),
     lhNavGroupsPlugin(),
     lhConfigPlugin(),
     lhResourcesPlugin(),