Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -98,6 +98,7 @@ The Superpowers plugin is disabled for this repository. Do not invoke or follow
## Desktop Shell

- 每 workspace 一个 daemon:`workspace_registry`(`src/base/workspace/`)/ `daemon_pool` / `pick_active` / `web_host` / `tray_icon_win` / `notifications_win`;切 workspace 走整页 navigate(跨端口 CORS);webapp 兼容模式(WebView2 不可用或 `--webapp`)用托盘 + 消息循环托住进程,别用 `WaitForSingleObject(msedge)` 当生命周期;单实例互斥 `Local\ACECode-Desktop-Singleton-v1`;关窗默认隐藏到托盘(`desktop.close_to_tray`)。bridge 函数清单(`aceDesktop_*`)与通知抑制规则看 [docs/desktop-shell/multi-workspace.md](docs/desktop-shell/multi-workspace.md) 与归档:Desktop shell + multi-workspace。
- **启动回到上次会话 / 升级后重启前置**:前端经 `aceDesktop_setLastSession` 把当前会话记进 `state.json::last_session`(首页等非会话页传 null 清掉,启动跳转落定前不上报),启动时拼 `?open=…&restore=1` 走已有的启动落地,失败静默回首页;升级重启时旧进程已不是前台程序,所以带 `--relaunched-after-update` 拉起新进程(macOS 已安装的 .app 改走 `open -n`),新进程带该参数或是新版本第一次启动时才用 `show_window_in_foreground` 强制前置,平时启动不抢焦点。main.cpp 离行数上限只差两行,新逻辑放 `last_session.cpp` / `window_foreground.cpp` / `desktop_restart.cpp`。见 [docs/desktop-shell/multi-workspace.md](docs/desktop-shell/multi-workspace.md)。
- 写 workspace.json 一律先读盘再改(`latest_workspace_meta`),Desktop 与 daemon 各持一份缓存。托盘 / 通知 / toast 的 controller 窗口**不能用 HWND_MESSAGE**。
- **打开文件夹**(`aceDesktop_openInExplorer` 异步 bridge):Windows 文件走 `SHOpenFolderAndSelectItems`,**不要改回 `explorer.exe /select`**(每次另起一个不退出的 Explorer 宿主进程,约 1 秒);独立 STA 线程执行,窗口被压在后面才拉起,不抢用户已切走的焦点,不撤用户的置顶。见 [docs/desktop-shell/multi-workspace.md](docs/desktop-shell/multi-workspace.md)。
- **窗口细节**:启动浮窗由独立绘制线程播动画(`splash_animation.cpp` 纯函数);窗口位置跨启动记忆(`window_placement_win.cpp` + `place_saved_desktop_window`,普通边框口径);Win10 顶边 1px 线由宿主窗口自画(别用 `DwmExtendFrameIntoClientArea`,别画在网页里);Ctrl+滚轮缩放只走 `aceDesktop_zoomFactor`,WebView2 `IsZoomControlEnabled` 保持 FALSE;主题异形窗口全部挂在 `g_window_shape.chamfer` 上。归档:启动浮窗动画、主窗口位置跨启动记忆、Win10 顶边、Ctrl+滚轮页面缩放、异形窗口。
Expand Down
37 changes: 34 additions & 3 deletions docs/daemon-api.md
Original file line number Diff line number Diff line change
Expand Up @@ -367,6 +367,7 @@ download when nothing changed.
| GET / PUT | `/api/files/editable` | read or safely save a Desktop workspace text file |
| GET | `/api/fs/roots` | browsable roots for the Web path picker |
| GET | `/api/fs/list` | list any absolute directory for the Web path picker |
| POST | `/api/fs/mkdir` | create one folder from the Web path picker |
| GET | `/api/git/info` | git repo info for a workspace |
| POST | `/api/git/checkout` | switch branch (stash-aware) |
| GET | `/api/git/changes` | working tree changes vs base |
Expand Down Expand Up @@ -2972,7 +2973,7 @@ Lists the direct children of any absolute directory readable by the daemon
process. Unlike `/api/files`, there is no workspace whitelist: any
authenticated client (loopback without a token, or a remote client with a valid
token) may browse the whole filesystem. The route is read-only and logs every
listing with its path.
listing with its path. The only write in `/api/fs` is `POST /api/fs/mkdir`.

```json
{
Expand Down Expand Up @@ -3011,6 +3012,36 @@ Errors: `400 {"error":"path must be absolute"}` for an empty or relative
`403 {"error":"permission denied"}` when the daemon cannot read the directory;
`500 {"error":"io error"}` otherwise. Error bodies may add a `detail` string.

### `POST /api/fs/mkdir`

Creates one folder for the picker's **New Folder** button (folder mode only).
Same access rule as `/api/fs/list`: any authenticated client, no workspace
whitelist. Every attempt is logged with its parent and name.

```json
{"parent": "C:/Users/shao/projects", "name": "demo"}
```

Success is `201 {"path": "C:/Users/shao/projects/demo", "name": "demo"}`.
`path` uses the same lexical normalization as `/api/fs/list` and does not
resolve junctions, so a folder created under a junction keeps the junction
spelling. `name` is the name actually used after trimming surrounding ASCII
whitespace.

- Only one level is created. A missing `parent` is an error, never created.
- Names are rejected, never rewritten: empty, `.`, `..`, containing `/`, `\`,
or control characters; on Windows also `< > : " | ? *`, a trailing period or
space, and reserved device names (`CON`, `NUL`, `COM1`, `LPT9`, also with an
extension).
- An existing entry of the same name, whether a folder, file, or dangling link,
is never overwritten.

Errors: `400 {"error":"invalid name"}`; `400 {"error":"path must be absolute"}`
for an empty or relative `parent`; `404 {"error":"not found"}` and
`404 {"error":"not a directory"}` for the parent; `403 {"error":"permission denied"}`;
`409 {"error":"already exists"}`; `500 {"error":"io error"}` otherwise (for
example, a name that is too long). Error bodies may add a `detail` string.

### `GET /api/git/info?cwd=<abs>`

Returns git repository info for a workspace cwd (openspec `add-git-context`).
Expand Down Expand Up @@ -6777,14 +6808,14 @@ Runtime-generated names use underscore separators. Existing hyphen-named data re

| 方法与路径 | 请求 / 返回 |
| --- | --- |
| `POST /api/sessions/:id/shares` | `{mode: "read_only" / "interactive", visibility: "conversation" / "tools", expires_in: 秒}`;201 返回记录及 `link`。默认可交互、只看对话、86400 秒;有效期 60–2592000 秒 |
| `POST /api/sessions/:id/shares` | `{mode?: "read_only" / "interactive", visibility?: "tools", expires_in?: 172800}`;201 返回记录及 `link`。默认只读,固定包含工具内容、172800 秒后失效;其它 visibility 或 expires_in 值返回 400 |
| `GET /api/shares` | `{shares: [...]}`;有效记录可再次复制链接,带 `active`、`revoked`、`expires_at` |
| `DELETE /api/shares/:share_id` | 撤销凭据,立即关闭该分享现有访客连接 |
| `GET /api/shares/:share_id/asks` | `{asks: [...]}`,脱敏后的时间、访客名、问题、答案和取消状态,最多 200 条 |
| `GET /api/config/desktop-clipboard` | `{ok, enabled}` |
| `PUT /api/config/desktop-clipboard` | `{enabled: boolean}`,按现有配置事务即时保存 |

`mode` 决定能否聊天,`visibility` 决定工具内容是否可见,两者独立。dangerous 模式拒绝创建;无法由 daemon 加载的 TUI 主会话不可分享。分享数据不进入 `config.json`。
`mode` 决定能否聊天。新链接内容固定为含工具输出,有效期固定两天;保留 `visibility`、`expires_in` 字段用于明确声明固定值,禁止其它值。已存在分享按原记录生效。dangerous 模式拒绝创建;无法由 daemon 加载的 TUI 主会话不可分享。分享数据不进入 `config.json`。

局域网转发在远程 Web 开启或存在有效分享时运行。仅开启分享时,经转发进入的完整 token 也被拒绝。`web.remote_port=0` 优先尝试 12400,再尝试 daemon 相邻端口,最后由系统分配;链接记录实际监听端口。显式固定端口的已有语义保持不变。

Expand Down
2 changes: 1 addition & 1 deletion docs/design/interface-icons.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ node scripts/preview_web_icons.mjs --output=icon-gallery.html

## 范围

当前共有 123 个注册名称。MCP 服务器统一使用插头;专家入口使用人头轮廓加齿轮,均为空心描线;模型与推理仍使用 Brain。分享操作使用 Share(开口方框加穿出的上箭头,方框与 ChatBubble 同宽),已分享会话的状态标记使用 Antenna(发射信号的天线,侧栏按 18 px 显示,与同一行其它图标一致)。`interfaceIcons.test.js` 核对注册与公开文件一一对应、无固定色、线宽、真实组件渲染、ARIA、面板状态及文件类型独立渲染。
当前共有 124 个注册名称。MCP 服务器统一使用插头;专家入口使用人头轮廓加齿轮,均为空心描线;模型与推理仍使用 Brain。分享操作使用 Share(开口方框加穿出的上箭头,方框与 ChatBubble 同宽),已分享会话的状态标记使用 Antenna(发射信号的天线,侧栏按 18 px 显示,与同一行其它图标一致)。`interfaceIcons.test.js` 核对注册与公开文件一一对应、无固定色、线宽、真实组件渲染、ARIA、面板状态及文件类型独立渲染。

保留原样的内容:ACECode/供应商品牌 Logo、原生应用/托盘资源、Seti 字体与文件类型映射、PPTX 文件类型图标、统计图和动态百分比仪表。操作用 Document/Folder/OpenFile 属于功能图标,仍使用本规范。

Expand Down
20 changes: 19 additions & 1 deletion docs/desktop-shell/multi-workspace.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,13 +21,31 @@ acecode-desktop.exe / ACECode.app (父)
## 启动顺序

1. desktop 扫 `.acecode/projects/*` → `WorkspaceRegistry`
2. 读 `state.json::last_active_workspace_hash`
2. 读 `state.json::last_active_workspace_hash`;没有显式打开请求且 `state.json::last_session` 可恢复时,它所在的工作区优先(见「回到上次会话」)
3. `pick_active(last_active, current_path, registry)` → active hash
4. registry 空 + 进程 cwd 非空 → 自动 `register_new(cwd)`(首次安装兜底)
5. 注册 4 个 webview bridge:`aceDesktop_listWorkspaces / activateWorkspace / renameWorkspace / addWorkspace`
6. `pool.activate(__shared_daemon__/default)` → 拿到 `{port, token}` → `host.navigate("http://127.0.0.1:port/?token=...")`
7. 主窗口 `host.run()`

## 回到上次会话

启动时直接打开上次停留的会话,实现在 [last_session.cpp](../../src/apps/desktop/last_session.cpp) 与 [lastSessionMemory.js](../../web/src/lib/lastSessionMemory.js):

- **记**:前端在当前会话变化时调 `aceDesktop_setLastSession({session_id, workspace_hash?, no_workspace?, read_only?})`,停在首页 / 定时任务 / 专家组件页时传 `null`,桌面壳写进 `state.json::last_session`(内容没变不落盘)。启动跳转落定之前不上报 —— 那时 `activeRef` 还是空的,会把上次的记录清掉。
- **用**:启动时 `restorable_last_session(registry)` 读回记录(带工作区的会话要求该工作区仍在 registry 且目录还在),该工作区优先成为 active,导航前给 URL 拼上 `?open=<会话>&workspace=<hash>`(或 `no_workspace=1`)`&restore=1`,走与跨 workspace 跳转相同的启动落地。`restore=1` 让前端静默处理失败:会话已被删除时回到首页,不弹「恢复失败」。
- TUI 的 `--open-session` / 邀请链接等显式打开请求优先,此时不恢复。
- 记录只由桌面壳读写:端口每次启动都变,浏览器本地存储留不住;浏览器直连 daemon 与 webapp 兼容模式没有 bridge,不记也不恢复。

## 升级后重启

`aceDesktop_restartApp` 只做预检并请求退出;真正拉起新进程在 `host.run()` 返回、托盘与 daemon 全部收尾之后([desktop_restart.cpp](../../src/apps/desktop/desktop_restart.cpp))。那一刻旧进程的窗口早已销毁,它不再是前台程序,新进程因此拿不到前台权 —— 窗口会出现在别的窗口后面。处理分两头:

- **旧进程**:拉起时带 `--relaunched-after-update`。Windows 上顺手 `AllowSetForegroundWindow(新进程)`(只在自己仍有前台权时生效);macOS 上已安装的 `.app` 改经 LaunchServices 重启(`/usr/bin/open -n <bundle> --args …`),由系统激活新实例,`open` 失败、裸二进制(开发构建)或进程带着 `ACECODE_*` 环境变量(LaunchServices 不继承)时仍直接 exec。
- **新进程**:带该参数、或这是本版本装好后的第一次启动(`state.json::desktop_last_launch_version` 与当前版本不同;旧版本拉起新版本时不会带参数,靠这条兜住)时,首次显示主窗口走 [window_foreground.cpp](../../src/apps/desktop/window_foreground.cpp):临时并入当前前台线程的输入队列再激活(前台程序无响应时不并入),仍被拒绝就用一次置顶脉冲把窗口抬到最上层后立刻撤销。平时的启动不走这条路,用户启动后切去别的程序时不抢焦点。

macOS 的修复由旧进程执行,所以要到「装了这一版之后的下一次升级」才生效。

## 切换 workspace

前端 Sidebar 优先调用共享 daemon:
Expand Down
6 changes: 3 additions & 3 deletions docs/session-sharing.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
# 会话分享

在会话标题栏「属性」左侧点击分享图标,选择链接权限、可见内容和有效期,再生成链接。
在会话标题栏「属性」左侧点击分享图标,按需打开「可交互」开关,再生成链接。开关默认关闭,与「生成链接」按钮同排。

| 链接权限 | 访客能力 |
| --- | --- |
| 只读 | 查看历史、图片和实时进展,没有聊天入口 |
| 可交互 | 在查看之外进行独立提问;使用分享者的模型和受限只读工具 |

「只看对话 / 含工具输出」独立于链接权限。默认可交互、只看对话、一天过期。复制邀请包含主人名、会话标题和链接;复制链接只复制 URL。存在有效分享的会话在侧栏显示发射天线图标。侧栏快捷菜单中的「分享与连接」管理有效分享、提问记录和已保存对端。
新链接始终包含工具内容,创建后两天失效。默认只读;开启「可交互」后显示圈叹号和「打开可交互会话会消耗共享用户的token额度。」提示。内容和有效期不再提供界面选项。已存在链接仍保留创建时的权限、内容范围和失效时间。复制邀请包含主人名、会话标题和链接;复制链接只复制 URL。存在有效分享的会话在侧栏显示发射天线图标。侧栏快捷菜单中的「已存在的链接」管理有效分享、提问记录和已保存对端。

## 连接与权限

Expand All @@ -27,7 +27,7 @@ Windows 安装器及绿色版启动时按当前用户注册协议,无需提权

问题不写入主会话历史、不占用主会话忙碌状态。每个分享码同时最多一个提问,默认每天 30 次,按 UTC 日期重置,响应带下一次恢复时间。检查在调用模型之前进行;只读链接的提问不会消耗额度。

历史、实时输出和答案都经过脱敏。为避免密钥跨流式片段泄露,未完整的文本行及 PEM 块先缓冲,再脱敏发送。脱敏规则不能识别所有可能的秘密,分享者仍应选择适当的内容档位。
历史、实时输出和答案都经过脱敏。为避免密钥跨流式片段泄露,未完整的文本行及 PEM 块先缓冲,再脱敏发送。脱敏规则不能识别所有可能的秘密,分享者仍应确认会话和工具输出适合共享。

## 存储与撤销

Expand Down
6 changes: 3 additions & 3 deletions openspec/changes/add-acecode-invite-links/design.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@

### 用户确认的分享入口与权限

分享入口放在会话标题栏「属性」左侧,使用开口方框加上箭头的线框图标。图形遵循 `docs/design/interface-icons.md`:`share` 别名指向统一图形库的 `Share`,通过 `VsIcon` 以 16 px 渲染,使用 20×20 坐标、currentColor 和按尺寸计算的线宽;业务组件不另画 SVG。有效分享的会话在侧栏显示统一图形库的 Antenna 发射天线标记(18 px,与侧栏其它图标一致),保留“已分享”无障碍名称。分享对话框显式提供「只读 / 可交互」两种权限,映射到服务端 `allow_questions=false/true`,保留原方案默认允许提问。内容档位「只看对话 / 含工具输出」与权限独立。只读远程视图不显示聊天入口,服务端拒绝提问;可交互只开放独立的受限访客对话,模型额度和工具执行归分享者,不改变主会话历史或忙碌状态。
分享入口放在会话标题栏「属性」左侧,使用开口方框加上箭头的线框图标。图形遵循 `docs/design/interface-icons.md`:`share` 别名指向统一图形库的 `Share`,通过 `VsIcon` 以 16 px 渲染,使用 20×20 坐标、currentColor 和按尺寸计算的线宽;业务组件不另画 SVG。有效分享的会话在侧栏显示统一图形库的 Antenna 发射天线标记(18 px,与侧栏其它图标一致),保留“已分享”无障碍名称。分享对话框提供默认关闭的「可交互」开关,与「生成链接」同排,映射到服务端 `allow_questions=false/true`。开启后用统一 `StatusWarningCircle` 图标显示「打开可交互会话会消耗共享用户的token额度。」;关闭后移除提示。新分享固定包含工具输出、172800 秒后失效,前端明确提交固定值,后端默认只读并拒绝其它内容档位或有效期。已有记录不迁移,继续按原权限与时间生效。删除内容/有效期下拉和旧说明,「分享与连接」统一更名为「已存在的链接」。只读远程视图不显示聊天入口,服务端拒绝提问;可交互只开放独立的受限访客对话,模型额度和工具执行归分享者,不改变主会话历史或忙碌状态。

### 1. 链接形状:固定 host,载荷放路径

Expand Down Expand Up @@ -141,9 +141,9 @@ base64url 只用 `A-Z a-z 0-9 - _`,Chrome 交给系统前做的转义(`EscapeE
## Risks / Trade-offs

- [局域网明文传输,同网段的人能嗅探到对话和分享码] → 第一版明确告知(分享对话框里写「仅限可信局域网」);有效期默认 1 天;链接格式预留证书指纹字段,后续变更用 A 的自签证书、指纹放进链接里,由 B 校验,不需要 CA。这正是 Syncthing(设备 ID 就是证书哈希,线下交换)、KDE Connect(配对后把对方证书作为唯一信任根)、LocalSend(握手时校验证书 SHA-256 指纹)的做法。
- [对方电脑没装 ACECode,或者在 Linux 上用 Chrome,把链接粘进地址栏回车,链接会作为搜索词发给搜索引擎] → 分享码只在局域网里有用,外人拿到也连不上;默认 1 天过期,主人可以随时撤销;复制邀请时附带的说明文字写「用 ACECode 打开」,引导对方把链接粘进 ACECode。
- [对方电脑没装 ACECode,或者在 Linux 上用 Chrome,把链接粘进地址栏回车,链接会作为搜索词发给搜索引擎] → 分享码只在局域网里有用,外人拿到也连不上;固定 2 天过期,主人可以随时撤销;复制邀请时附带的说明文字写「用 ACECode 打开」,引导对方把链接粘进 ACECode。
- [链接被转发给不该看的人] → 链接就是凭据,这一点在分享对话框里写清楚;主人能随时撤销,撤销会断开所有已建立的连接;提问记录里能看到访客自报的名字。
- [访客通过提问套出密钥] → 拒读清单、工具结果过滤、答案脱敏三层。脱敏靠正则,挡不住所有形式,所以默认档位是「只看对话」,并且主人能关掉提问。
- [访客通过提问套出密钥] → 拒读清单、工具结果过滤、答案脱敏三层。脱敏靠正则,挡不住所有形式,所以新分享仍须由主人确认内容适合共享,并且提问默认关闭。
- [访客提问花主人的额度] → 每个分享码同时只能有一个提问,每天 30 次,提问使用主人当前会话的模型,主人在详情里能看到用量。
- [恶意网页触发 `acecode://` 链接,让 B 的 ACECode 去连攻击者的机器] → 确认之前不发任何网络请求;确认框显示地址;对端返回的一切都按不可信数据处理;AI 工具只能用已保存的对端。
- [后台剪贴板监听引起隐私顾虑] → 只做前缀匹配,不落盘、不写日志;尊重「不要监视」标记;设置里能关;macOS 只在激活时检查。
Expand Down
Loading
Loading