@leviyuan/lodestar 0.18.16 → 0.18.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/dist/lodestar.js +188 -187
  2. package/docs/configuration.md +3 -1
  3. package/docs/usage.md +9 -7
  4. package/package.json +1 -1
package/docs/configuration.md CHANGED
@@ -54,7 +54,7 @@ Codex、Claude、DSH 在 `[runtime.agent_auto_update]` 下分别设置 `codex`
54
54
 
55
55
  清单还包括原生附件的 `im:resource`、机器人发消息的 `im:message:send_as_bot`、Card Kit 权限，以及排障时读取租户和认证信息的权限。需要审批的权限应完成审批，再创建并发布飞书应用版本。取得应用访问凭据不代表业务权限已生效。
56
56
 
57
- 升级已有应用时也应补齐清单并发布应用版本。开通权限不会改变群设置：文件默认直接作为聊天附件发送，只有群内执行 `files on` 才启用云空间，`files off` 恢复附件。文件夹权限与实际文件的分享入口会分别处理，具体行为见[文件与生图](usage.md#文件与生图)。
57
+ 升级已有应用时也应补齐清单并发布应用版本。开通权限不会改变工作目录设置：文件默认直接作为聊天附件发送，只有在同目录任一群执行 `files on` 才启用云空间，`files off` 恢复附件。文件夹权限与实际文件的分享入口会分别处理，具体行为见[文件与生图](usage.md#文件与生图)。
58
58
 
59
59
  ## 本机配置
60
60
 
@@ -81,6 +81,8 @@ tools = "Read,Write,Edit,Bash,Glob,Grep" # Claude / DSH 主会话
81
81
  bin = "/abs/path/to/claude-wrapper" # 可选的 Claude 可执行文件
82
82
  ```
83
83
 
84
+ 项目名用于定位工作目录；工具、MCP 等启动配置按实际目录匹配。同目录的 BTW/FK 与项目别名共享配置，别名配置冲突时明确报错。WT 的目录独立，不自动套用主目录的启动配置；需要配置某个 WT 时，可新增一个项目配置项，将 `cwd` 指向该 WT 的实际路径。工作目录内的 Agent 原生配置仍由相应后端读取。
85
+
84
86
  账号配置、OpenRouter 默认模型和 DSH 接入见[模型与账号](models.md)。手动修改配置后需重启 daemon；群内设置自行保存。
85
87
 
86
88
  ## HTTP 代理
package/docs/usage.md CHANGED
@@ -28,9 +28,9 @@
28
28
  | `codex-account-delete 备注` | — | 删除额外账号的本地记录与独立凭据，清除各群对它的指定 |
29
29
  | `codex-auto` | — | 清除本群手动指定，恢复自动选择最高分账号 |
30
30
  | `task` | — | 创建、查看或删除绑定的飞书任务清单 |
31
- | `files` | — | 查看本群文件交付模式及群文件夹入口 |
32
- | `files on` | — | 开启本群云空间交付，创建或复用与群名一致的文件夹 |
33
- | `files off` | — | 恢复直接发送聊天附件，保留云空间文件和目录绑定 |
31
+ | `files` | — | 查看当前工作目录的交付模式及本群文件夹入口 |
32
+ | `files on` | — | 开启当前工作目录的云空间交付，创建或复用本群文件夹 |
33
+ | `files off` | — | 当前工作目录恢复聊天附件，保留云空间文件和群目录绑定 |
34
34
 
35
35
  模型列表来自各账号的模型目录，获取失败显示 `MISS`。同账号切换 Claude 或 DSH 模型从后续回复生效，Codex 的持久模型设置需重启会话生效；跨账号或后端切换只允许在空闲时进行。账号接入、模型补录与额度说明见[账号与模型](models.md)。
36
36
 
@@ -71,6 +71,8 @@ Linux/macOS 下，额外账号通过软链接共用默认账号的配置、会
71
71
  | `worktree` | `wt` | 列出项目的 `work/*` 分支和工作区状态 |
72
72
  | `worktree feature-x` | `wt feature-x` | 创建或加入 `<project>[feature-x]` 群和同级 worktree 目录，使用 `work/feature-x` 分支 |
73
73
 
74
+ WT 使用独立工作目录，其文件交付、项目工具/MCP 配置与主目录分开。BTW/FK 始终共享来源目录的这些配置，包括从 WT 创建的临时群。任务清单属于项目级，主群、所有 WT 及其临时群共用。临时群的模型、账号在创建时继承，之后各自切换、互不影响。
75
+
74
76
  已合并且未挂载的分支会折叠隐藏，再次启用时更新到主线。卡片上的“删”会检查对应群没有运行中的会话、工作区没有未提交变更，再解散群并删除 worktree；Git 分支保留。
75
77
 
76
78
  ## 临时会话与对话分支
@@ -79,7 +81,7 @@ Linux/macOS 下，额外账号通过软链接共用默认账号的配置、会
79
81
 
80
82
  | 完整指令 | 缩写 / 别名 | 行为 |
81
83
  | --- | --- | --- |
82
- | `btw` | — | 创建 `<session>*MMDD-HHMM` 临时群，继承账号、模型和工作目录，启动新会话 |
84
+ | `btw` | — | 创建 `<session>*MMDD-HHMM` 临时群，继承账号、模型并共享原工作目录配置，启动新会话 |
83
85
  | `fork` | `fk` | 选择一条用户输入，在临时群里从这条输入之前分叉 |
84
86
  | `back` | `bk` | 选择一条用户输入，让本群接到这条输入之前的新分支 |
85
87
  | `bye` | — | 停止并解散当前临时群，仅适用于 Lodestar 创建的临时群 |
@@ -125,7 +127,7 @@ lodestar-agent run --session '<session-id>' --description '继续第二步' --pr
125
127
 
126
128
  ## 飞书任务清单
127
129
 
128
- 发 `task`，点“启用”可创建并绑定 `<project>[lodestar]` 任务清单。删除需要在卡片上再次确认，会删除整个清单及其中任务。该面板管理清单绑定，任务执行由用户和 Agent 安排。
130
+ 发 `task`，点“启用”可为当前项目创建并绑定 `<project>[lodestar]` 任务清单。主群、同一项目的所有 WT 及其 BTW/FK 临时群共用清单。在其中任一群删除清单，都作用于整个项目；删除需要在卡片上再次确认，会删除整个清单及其中任务。该面板管理清单绑定，任务执行由用户和 Agent 安排。
129
131
 
130
132
  ## 本机通知
131
133
 
@@ -147,11 +149,11 @@ Lodestar 启动 Agent 时按本群设置直接注入文件交付约定：云空
147
149
 
148
150
  安装或更新时会自动删除旧 `lodestar-files` Skill 在 Codex、Claude 和共享插件目录中的受管副本；新版 daemon 启动时也会清理。清理沿用本机数据目录设置，失败会明确报错；显式设置 `LODESTAR_DISABLE_SKILL_SYNC=1` 时保留手工管理的 Skill。
149
151
 
150
- 在需要的群中发送 `files on`，开启该群的云空间交付。每个群按 `chat_id` 绑定一个固定文件夹，文件夹名与实际群名一致；之后该群各轮交付都直接放入这个文件夹，不再按轮次创建目录。重启后继续复用原目录，同名群之间独立。群改名后，下次云空间交付或再次执行 `files on` 会同步文件夹名称；目录丢失或不可访问时明确报错，不自动新建空目录掩盖问题。
152
+ 在需要的群中发送 `files on`，开启当前工作目录的云空间交付。同一目录下的主群、BTW/FK 临时群及目录别名共享此开关；WT 使用自己的独立设置，默认聊天附件。在任一同目录群执行 `files off` 会一起切回附件。每个群的云空间文件夹和权限仍各自独立，继承云空间模式的临时群在首次交付时创建自己的文件夹。每个群按 `chat_id` 绑定一个固定文件夹，文件夹名与实际群名一致；之后该群各轮交付都直接放入这个文件夹，不再按轮次创建目录。重启后继续复用原目录，同名群之间独立。群改名后，下次云空间交付或再次执行 `files on` 会同步文件夹名称；目录丢失或不可访问时明确报错，不自动新建空目录掩盖问题。
151
153
 
152
154
  云空间模式下，每轮结束后发送独立“交付文件”卡片，**只列本轮新交付文件**的名称、大小和访问链接。点击文件名打开文件；点击“管理群文件”打开飞书原生文件夹，查看该群所有历史云空间交付文件，并使用重命名、移动和删除等功能。开启者和后续交付发起人会获得群文件夹管理权限，群成员可查看。文件不自动清理；历史卡片是交付时的记录，文件夹展示当前状态，已删除文件的旧链接会失效。
153
155
 
154
- `files` 查看本群设置，`files off` 恢复直接发送聊天附件。开关与目录绑定保存在私有 `file-delivery-groups.json`，关闭不会删除云空间文件，重新开启继续复用原目录。每轮在输入交给 Agent 时固定交付方式，避免文件生成后规则改变。切换开关从下一轮用户任务生效，已有进程会收到一次完整的交付约定更新，无需重启；普通输入不重复附加规则，后台续跑沿用进程已收到的约定。之前发送到聊天的附件不删除，也不自动迁移至云空间。
156
+ `files` 显示当前工作目录、交付模式和本群文件夹入口，`files off` 将同目录各群恢复为聊天附件。目录开关与群文件夹绑定分开保存在私有 `file-delivery-groups.json`，关闭不会删除云空间文件，重新开启继续复用原目录。每轮在输入交给 Agent 时固定交付方式，避免文件生成后规则改变。切换开关在同目录各会话的下一轮用户任务生效，已有进程会收到一次完整的交付约定更新，无需重启；普通输入不重复附加规则，后台续跑沿用进程已收到的约定。之前发送到聊天的附件不删除，也不自动迁移至云空间。旧版按群保存的开关会按已知工作目录迁移，已有文件夹继续保留；同目录旧开关冲突时明确报错，发送 `files on` 或 `files off` 统一即可。
155
157
 
156
158
  **云空间需要同时开通应用身份权限 `drive:drive`、`drive:file:upload`**；后者是文件夹自动改名接口单独要求的权限，前者不能替代。安装向导的[完整权限清单](feishu-permissions.json)已包含这两项，升级用户可补齐后发布飞书应用版本。权限开通不自动开启云空间功能。整个过程不依赖飞书 CLI，也不需要用户授权登录。云空间交付须有可识别的发起人，缺少身份或权限时明确报错。不超过 20 MB 的文件整文件上传，更大的文件按飞书策略分片；实际大小上限与容量由账号决定，不能把企业基础版的认证限额直接套用于飞书个人版。云空间失败不会自动切回聊天附件。自动生图仍沿用下面的图片展示规则。
157
159
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@leviyuan/lodestar",
3
- "version": "0.18.16",
3
+ "version": "0.18.17",
4
4
  "publishConfig": {
5
5
  "access": "public"
6
6
  },