@forsion/extend 0.8.3 → 0.9.0

package/CHANGELOG.md

@@ -1,5 +1,58 @@
 # 更新日志
 
+## 0.9.0 — 2026-10-20
+
+- 这一版需要 Forsion 桌面端 2.13.5 或更新；更早的桌面端继续用自带的版本，升级桌面端后再换上。
+- This version needs Forsion Desktop 2.13.5 or later. Older desktops keep the version they came with and switch after the desktop is updated.
+
+- 新增 **「蓬洲云」Space**：在桌面端看和管理你存在 Forsion 云端的东西。打开先是概览：一共存了多少、按账分段的条、四张账卡（智库同步、Amadeus Cloud、应用文件、导出；有上限的两本各画各的条，用到 90% 变警示色）和占用最多的文件。左栏是位置树，点任一个库、应用、导出或回收站，主区换成文件表、右栏出详情。
+- 能做的事按账分：应用文件可以下载、重命名、移动、移到回收站、恢复、永久删除、恢复历史版本；导出可以下载、重命名、删除；智库同步的库和 Amadeus Cloud 只看和下载（在这里删一个同步库的文件，每台设备都会跟着删）。下载存进「下载」文件夹。远程同步写入时带上设备名，蓬洲云里同步库的文件能看到是哪台写的。
+- 左栏第一行是 **「同步」**：智库、Agents 与记忆、插件数据三项同步的开关、状态和在同步的设备都在这一页；展开智库那一行能看同步计划、方向、没传的文件和云端位置。另一台电脑登录、云端已经有一份智库时，就在这里选「合并两边」「用云端那份」（先就地确认一次，这台不一样的文件会先挪进旁边的备份文件夹）或「这台先不同步智库」；超出额度也在这里说清楚，放不下的文件留在本机，不删。
+- 没开同步或有事等你决定时，打开蓬洲云先落在同步页；有事等你决定或上次没同步成功时，Ribbon 上的蓬洲云图标挂一个点；智库在同步或有文件在传时，图标挂进度环（传文件时以传文件为准）。
+- 蓬洲云也能当网盘用：左栏有 **「我的云盘」**，工具条有「上传」（下拉里还能上传整个文件夹，云端照原样建好一层层）和「新建文件夹」，文件也能从访达直接拖进文件表，拖到某个文件夹那一行上就传进那个文件夹。我的云盘算在应用文件的 10 GB 里，重名自动改成「名字 (1)」，单个文件这一版最大 50 MB；空间不够时整批不开始，告诉你还差多少。
+- 上传和下载都在后台排队（各自同时 3 个），切到别的 Space 也不停。正在传进当前文件夹的文件直接出现在表里、带进度；所有传输汇总在主区右下角的一张浮动卡里：每一项的进度、速度、剩余时间，能暂停、继续、取消、重试，下载完能「在文件夹中显示」。不碰它 10 秒收成一颗胶囊，全部传完 4 秒后自己消失，有没传完的一直留着。不在蓬洲云时传完或失败会弹一句。退出 Forsion 时还有在传的会问一次。暂停后继续、失败重试都是从头传。
+- 多选：⌘ 点加选、⇧ 点连选、⌘A 全选，工具条换成批量条。应用文件里能批量下载、移动、移到回收站；智库同步的库和 Amadeus Cloud 里能批量下载。一次下载多个文件会放进「下载」里的「蓬洲云 日期」文件夹。
+- 需要带同一批接缝的 Forsion 桌面端和服务端；手机和网页版这一轮没有。「同步」这一行、图标上的点和进度环、退出确认、「我的云盘」的图标要带对应接缝的桌面端，更早的版本上没有这几样，别的照常。
+
+- New **Penzor Cloud Space**: see and manage what you keep in Forsion Cloud from the desktop app. It opens on an overview: how much you store, a bar split by ledger, four cards (Vault sync, Amadeus Cloud, App files, Exports; the two with a limit each get their own bar, which turns to a warning color at 90%) and your largest files. The left panel is a tree of places; pick a vault, an app, Exports or Trash and the main area becomes a file table with details on the right.
+- What you can do depends on the ledger: app files can be downloaded, renamed, moved, moved to trash, restored, deleted permanently or rolled back to an earlier version; exports can be downloaded, renamed and deleted; synced vaults and Amadeus Cloud are view and download only (deleting a synced file here would delete it on every device). Downloads go to your Downloads folder. Remote sync now sends the device name with each write, so Penzor Cloud can show which device wrote a synced file.
+- The first row in the left panel is **Sync**: switches, status and syncing devices for your vault, Agents & memory and plugin data, all on one page. Expand the vault row to see its schedule, direction, files that weren’t uploaded and where it lives in the cloud. When you sign in on another computer and the cloud already has a vault, you choose here: merge both, use the cloud copy (confirmed once in place; this computer’s differing files move to a backup folder first) or don’t sync notes on this computer yet. Going over the limit is explained here too; files that don’t fit stay on this computer and nothing is deleted.
+- If nothing is syncing or something needs your decision, Penzor Cloud opens on the Sync page. Its Ribbon icon shows a dot when something needs your decision or the last sync failed, and a progress ring while the vault syncs or files transfer (file transfers take precedence).
+- Penzor Cloud also works as a drive: **My drive** sits in the left panel, the toolbar has Upload (its menu also uploads a whole folder, recreated level by level in the cloud) and New folder, and you can drag files straight from Finder into the file table, or onto a folder's row to put them in that folder. My drive counts toward the 10 GB for app files. Duplicate names become "name (1)", files are limited to 50 MB each for now, and if a batch won't fit, none of it starts and you're told how much space is missing.
+- Uploads and downloads queue in the background (three at a time in each direction) and keep going when you switch Spaces. Files on their way into the folder you're viewing show up in the table with their progress, and every transfer is listed in a floating card at the bottom right of the main area: progress, speed and time left for each, with pause, resume, cancel and retry, plus Show in folder for finished downloads. Left alone for 10 seconds it shrinks to a pill; once everything is done it disappears after 4 seconds, and it stays while anything didn't finish. If you're elsewhere you get a short notice when transfers finish or fail. Quitting Forsion while something is still transferring asks first. Resuming after a pause and retrying both start the file over.
+- Multiple selection: ⌘-click to add, ⇧-click for a range, ⌘A for everything; the toolbar turns into a batch bar. App files can be downloaded, moved or moved to trash in bulk; synced vaults and Amadeus Cloud can be downloaded in bulk. Downloading several files at once puts them in a "Penzor Cloud <date>" folder inside Downloads.
+- Needs a Forsion desktop app and server with the matching hooks; not on phones or the web yet. The Sync row, the dot and progress ring on the icon, the quit prompt and the My drive icon need a desktop app with the matching hooks; on older versions those are missing and everything else works.
+
+- 新增 **「使用指南」Space**：Forsion 的说明书，排在 Space 列表末尾（图标是一本书）。左栏按等级列出章节（Lv.1 初来乍到 → Lv.4 融会贯通，外加「新版本」一组），正文是只读的 Amadeus 页，下面是本章任务。每章导语下面有一张示意图，画出这一章要找的地方在界面哪儿（1–3 处，带编号，正文里的 ①②③ 对得上），跟着当前亮暗和主题色走。本级任务做完，下一级解锁；任务就是你平时的操作（发消息、建笔记、换主题……），以前做过的直接算数。
+- 每项任务都有 **「带我去」**：切到对应的 Space，在真界面上圈住要点的那一处，旁边一张小卡写这一步做什么（「第 n 步，共 m 步」），你自己点；做完这一步圈自动挪到下一步。不压暗屏幕、不挡点击，「知道了」或 Esc 收起，「不再提示」等于关掉指南「···」菜单里的「现场指引」（缺省开）；目标找不到时直接打开对应功能。这一章的任务同时跟到那个 Space 的右栏（伴读），做完一项就地打勾，整章做完伴读自己收起。手机和网页上做不了的任务写着「在电脑上做」，不挡升级。
+- 右栏是本级进度和下一级，**「问 Tangu」** 就是 Tangu 的对话本身：同一个输入框、消息、模型和附件，本章内容挂在输入框上方当引用，问完不用离开指南；这条对话一直接着用，下次打开历史还在，Tangu 的会话列表里也看得到。换一章，引用跟着换。用过一阵的话，右上角「···」里可以全部解锁，也能关掉「使用指南提醒」。
+- 每升一级，收件箱来一封「接下来试试这几件事」，信下面就是那几章的任务，可以直接「带我去」；装上带「新版本」章节的新版本后，也会来一封这个版本可以体验的清单。收件箱里同时只留一封未读的指南信。等级只管解锁章节，Forsion 现有的成就照常算。
+- 需要带同一批接缝的 Forsion 桌面端；更早的桌面端上不出现这个 Space。现场圈注和指南里的对话要带对应接缝的桌面端，不够新时「带我去」直接打开对应功能，「问 Tangu」去 Tangu 里开一条带上本章内容的新对话。
+
+- New **Guide Space**: a manual for Forsion, at the end of your Space list (the book icon). The left panel lists chapters by level (Lv.1 Getting started to Lv.4 Going further, plus a What's new group), the page itself is a read-only Amadeus page, and the chapter's tasks sit below it. Every chapter has a diagram under its intro showing where in the app the things it covers live (one to three numbered spots that match the ①②③ in the text), drawn in your current light/dark mode and accent color. Finish a level's tasks to unlock the next one. Tasks are things you do anyway (send a message, create a note, change the theme), and whatever you've already done counts.
+- Every task has **Take me there**: it switches to the right Space and rings the spot to click on the actual screen, with a small card saying what this step does ("Step n of m"), and you click it yourself; once that step is done the ring moves to the next. Nothing is dimmed or blocked. Got it or Esc dismisses it, and Don't show again turns off On-screen hints in the guide's "···" menu (on by default). If the spot can't be found, it opens the feature directly. The chapter's tasks follow you into that Space's right panel, each one ticks off as you finish it, and the panel closes itself once the chapter is done. Tasks that can't be done on a phone or in the browser say "Do it on your computer" and don't hold you back.
+- The right panel shows the level's progress and the next level, and **Ask Tangu** there is Tangu's own chat: the same input, messages, models and attachments, with the current chapter attached above the input as a quote, so you can ask without leaving the guide. It keeps using one conversation, so your history is there next time, and it also shows up in Tangu's chat list. Switch chapters and the quote follows. If you've been around a while, unlock everything from the ··· menu; the same menu turns Guide reminders off.
+- Each new level brings a letter to your inbox, "try these next", with that level's tasks right under it and a Take me there button on each. After an update that adds What's new chapters you get a list of what to try in that version. Only one unread guide letter stays in your inbox at a time. Levels only unlock chapters; Forsion's existing achievements count as usual.
+- Needs a Forsion desktop app with the matching hooks; on older versions the Space doesn't appear. On-screen hints and the chat in the guide need a desktop app with the matching hooks; on older versions Take me there opens the feature directly and Ask Tangu opens a new chat in Tangu with the chapter attached.
+
+- **笔记云同步**：云端笔记库里每个「同步库」文件夹现在会记下是哪几台设备在同步它。桌面端 Cloud 侧的同步库分区头会显示来源设备（本机写「本机」），要比 2.13.4 更新的桌面端才显示。以前开启同步的库会在下次启动时自动补上本机。
+- 一台设备把某个库的同步全部关掉后，会从记录里摘掉自己；没有设备在同步了，Cloud 侧就不再把它显示成同步库分区。关闭时没联网的，下次打开 Forsion 时自动补做。
+- 桌面端 Cloud 侧可以把根文件夹「设为同步库分区」，或把旧版留下的分区取消掉（需要新版桌面端）。
+- 笔记云同步下载附件（比如图片）时，云端存储那边的拒绝访问（链接过期、文件缺失）不再被当成登录失效、让同步停下等你重新登录，而是稍后自动重试。
+
+- **Note cloud sync**: each synced vault folder in your cloud notes now records which devices are syncing it. On the desktop, the synced vault sections on the Cloud side show the device it comes from ("This device" for this one); this needs a desktop app newer than 2.13.4. Vaults you turned sync on for earlier add this device automatically on the next launch.
+- When a device turns sync off for everything in a vault, it removes itself from that record; once no device is syncing it, the Cloud side stops showing it as a synced vault section. If the device was offline at the time, this happens the next time Forsion starts.
+- On the desktop's Cloud side you can mark a top-level folder as a synced vault section, or remove a section left behind by older versions (needs the new desktop app).
+- When note cloud sync downloads an attachment (an image, say) and cloud storage refuses it (an expired link or a missing file), sync no longer takes that as a sign-in failure and stops until you sign in again; it retries a little later instead.
+
+- 「设置 → Forsion 云端」重新分组：左栏收成账号、会员与额度、背包、插件投稿、帮助与诊断几项；账号下分个人主页、账号资料与安全，会员与额度下分积分与邀请、用量记录，帮助与诊断下分反馈与诊断数据。各页能在设置搜索里按关键词找到。分组要比 2.13.4 更新的桌面端；2.13.4 及更早上这些页面照旧平铺在左栏。
+- 插件投稿页新增详细描述、标签（最多 8 个）、最低 / 最高 Forsion 版本和支持的端；ZIP 投稿会自动读取清单里的版本要求，手填的值要和清单一致。投稿后自动分配唯一插件 ID，名字可以和别的插件重复，更新沿用同一个 ID。
+- 公告弹窗改成排队出：Forsion 自己的协议更新提示和更新内容（What's new）在前，同一时间只露一张，前一张关了下一张才出；全屏引导开着时先不弹。要带同一批接缝的桌面端，更早的版本上照旧直接弹。
+
+- Settings → Forsion Cloud is regrouped: the sidebar now has Account, Membership & quota, Backpack, Submissions, and Help & diagnostics. Account holds Profile, Account details and Security; Membership & quota holds Points & invites and Usage; Help & diagnostics holds Feedback and Diagnostic data. Each page can be found by keyword in Settings search. Grouping needs a desktop app newer than 2.13.4; on 2.13.4 and earlier the pages stay listed one by one in the sidebar.
+- The Submissions page adds a detailed description, tags (up to 8), minimum and maximum Forsion versions, and supported platforms. ZIP submissions read the version requirements from the manifest, and values you type must match it. Each submission gets a unique plugin ID, names may repeat, and updates keep the same ID.
+- Announcements now wait their turn: Forsion's own terms-update notice and What's new come first, only one shows at a time, and the next appears once the previous one is closed; nothing pops up while full-screen onboarding is open. Needs a desktop app with the matching hooks; older versions show announcements right away as before.
+
 ## 0.8.3 — 2026-10-13
 
 - 「设置 → Forsion 云端」新增**插件投稿**页：查看自己投稿的审核状态与原因（待审、已上架、已驳回），用 GitHub 仓库、npm 包或 ZIP 投稿，给 ZIP 投稿提交新版本送审。同一页也出现在商店左栏的「投稿」里。

package/README.md

@@ -16,6 +16,7 @@ Forsion Extend 是 Forsion 桌面端内置的扩展，负责和你的 Forsion
   - **反馈**：提交问题和建议，在桌面上查看回复。
 - **商店里的「会员与积分」**（需要较新的 Forsion 桌面端；旧版本上不出现）：商店左栏多出会员、积分、物品三页。会员档位和积分包在应用里挑，付款在浏览器的支付页完成；物品用积分兑换，在应用里直接完成，兑换到的卡密当场可以复制，之后在背包里也能再看。
 - **公告**：Forsion 发布的重要通知会在你打开桌面端时弹出，看过就不再出现；公告里的链接在浏览器中打开。
+- **使用指南**（0.9，需要较新的 Forsion 桌面端；旧版本上不出现）：Space 列表末尾那本书。Forsion 的说明书，按等级解锁，每章带任务和「带我去」；任务做完的进度存在这台电脑上，升级时收件箱会来一封「接下来试试这几件事」。
 - **笔记云同步与协作**：云端笔记库、按条目同步、与我共享，以及页面分享、发布和在线成员。
 - **设备互联**：让你的其他设备经 Forsion 云端连上这台电脑；账号下的设备可以查看、改名、换图标、移除，或在浏览器中打开。
 - **Forsion Connect**：把 Coding Space 里的项目发布成网页、申请上架商店；预览项目时也能用上 Forsion 的 AI。
@@ -44,6 +45,7 @@ Forsion Extend is built into Forsion Desktop and takes care of everything to do
   - **Usage**: requests, success rate and AI quota used over the last 7, 30 or 90 days.
   - **Feedback**: send issues and suggestions, and read replies in the app.
 - **Membership & points in the Store** (needs a newer Forsion Desktop; it doesn't appear on older versions): the Store's left column gains Membership, Points and Items pages. You pick a plan or a point pack in the app and pay on the payment page in your browser; items are redeemed with points right in the app, the key is shown for copying, and you can view it again later in your backpack.
+- **Guide** (0.9, needs a newer Forsion Desktop; it doesn't appear on older versions): the book at the end of your Space list. A manual for Forsion that unlocks level by level, with tasks and a Take me there button in every chapter. Progress is kept on this computer, and each new level brings an inbox letter with what to try next.
 - **Announcements**: important notices from Forsion pop up when you open the desktop app and don't show again once you've read them; links in them open in your browser.
 - **Note sync and collaboration**: the cloud vault, per-item sync, shared with me, and page sharing, publishing and presence.
 - **Device connectivity**: let your other devices reach this computer through the Forsion cloud, and view, rename, change the icon of, remove or open in your browser the devices on your account.

package/SIGNATURE

@@ -1,14 +1,16 @@
 {
   "alg": "ed25519",
   "files": {
-    "CHANGELOG.md": "0d81bbb918da892642a54d597d2c9bd859582ffd9da852410c54941f6f12bec7",
+    "CHANGELOG.md": "22a3142ce7a11918ed6952f7b052eb34bb6b3f7a0862ae205d314a1977ffd8bd",
     "LICENSE": "5594544ee08011ed5785ee26410f1f2ef005f66e9283833e8d435e34c10de1ed",
-    "README.md": "5a21c360f2a292afc9943e667d7b8fcd883d79d01e405d30a955aaf08516cc98",
+    "README.md": "4cfac819a59de106cea19e2f1be1b7146e17f8f656cd55212573caa68cd31464",
     "dist/THIRD_PARTY_NOTICES.md": "0af426bcae1e6cd82d3f6255768ac232eea116c7079706ae237d2f1f494531b4",
-    "dist/desktop.mjs": "781fcb961ed6b37b01fd7478c0a6d1c477ec0ed9aa3e753f2b6d87e6f5721ad7",
-    "dist/main.js": "490dda9eb5bfa3ba3a201a95c1f126d71ad7ed84039826dab432cc36246495ec",
-    "manifest.json": "6ee290e6f7d1f9359d00febde3e049e77b17b7eda2222450365610035ef89b7b",
-    "package.json": "509cdf50183ceb1795a46f40a51cba32f8b36c487bf54c42dfd2771f9bfc51eb"
+    "dist/desktop.mjs": "e1f19b164670275599626835a410deed0ca57138174c3ee8c048a1ad7ac8eb10",
+    "dist/main.js": "6ee3113a1ff358cb6701f8926d5c61abda6ebf863ca6267715b5c963ea535b3d",
+    "manifest.json": "4703e23d8befcccc789ee4c3186c0aa59951b0d17581111bab93255c94c82521",
+    "package.json": "3eebc0ed0206ba82ff8a21c4de49c87e1136714397bc4c526f9dc9c9f5c97f19",
+    "spaces/guide/space.json": "7da9fb9373278e9e1f75c65f697a21f25b0b45792def0ce94ed5e7f6473979b1",
+    "spaces/penzor/space.json": "478ccfc5f4fec4cd339f7e48e6dd530f45978804ea7cd9e579612e2cc2915429"
   },
-  "sig": "fRsZAxlTEOegvc+m3pP1LuaxGB7aXI+fIaDslJBf4aTXkx+WgZCJ5FEhSSY0yjETuce9A+p1IGtvj8H2Fb5MDw=="
+  "sig": "xVH/8ZTscKJCEZLDPSoEjrH1PN8dWRClEril6PHb8CYtpKcBjkR9+GHMtVmlMNcAFtR6pMBTdN4BG27l7wrjCA=="
 }