shuadouyin 0.3.0 → 0.3.1

package/.dy-build-commit

@@ -1 +1 @@
-741cb7e2e4f3e23fc0a809a5b3765f372fc39a04
+3e3d62daa90acf4ce33daae5b2162c7b89d5ddcf

package/dist/app.js

@@ -35,6 +35,7 @@ import { voiceMemories, voiceMemoryText } from "./operations/voice-memory.js";
 import { write } from "./operations/write.js";
 import { quiet } from "./progress.js";
 import { Store } from "./store.js";
+import { Workspaces } from "./workspace.js";
 export { isWrite, resourceID, validate } from "./operations/validate.js";
 // Commands that need the work itself in view, and are therefore blocked by the
 // chat overlay. Reads only: a write states its own target and already fails
@@ -210,6 +211,10 @@ export class App {
                 const session = await this.chrome.connect(active, this.timeout, live ? "https://live.douyin.com" : undefined);
                 try {
                     const result = await this.read(session, operation, input, active);
+                    // Every page answer carries the setup question until it is answered. It
+                    // is attached here rather than deep inside each operation so no command
+                    // has to remember, and so a command added later cannot forget.
+                    const setup = await setupNotice(this.store.base);
                     if (operation === "chat.read" && this.store.bot_id) {
                         if (!result || typeof result !== "object")
                             throw new CliError("state_corrupt", "Chat read did not return a conversation window");
@@ -223,7 +228,7 @@ export class App {
                     }
                     if (!["status", "auth.status"].includes(operation))
                         await this.store.append(operation, result);
-                    return result;
+                    return setup && result && typeof result === "object" ? { ...result, setup } : result;
                 }
                 catch (error) {
                     // Cancellation is the caller's choice and its outcome is not a
@@ -695,6 +700,29 @@ async function waitForProfileWorks(session, signal) {
         signal.throwIfAborted();
     }
 }
+// The setup question, carried with the first answer instead of blocking it.
+//
+// A block was tried first and is wrong: someone who wants to look at a few videos
+// before naming the bot would be stopped by an error, which is a worse experience
+// than a nudge they can act on or ignore. A gate also has to decide which commands
+// count, and every list like that is wrong at the edges.
+//
+// A notice rides along with whatever was asked for. The result the caller wanted is
+// still there; the missing setup is stated once, in the same envelope, with the two
+// questions to ask. It appears on every answer until the owner answers, because a
+// notice that appears once is one a caller can miss.
+export async function setupNotice(base) {
+    const state = await new Workspaces(base).onboarding().catch(() => null);
+    // `unknown` means the file is missing: a workspace that never ran init.
+    if (!state || state.status === "complete" || state.status === "skipped")
+        return null;
+    return {
+        status: state.status,
+        ask: ["What should this bot be called, and how should it sound?", "What must it never do?"],
+        next: "Save the persona with `dy workspace get AGENTS.md` for the revision, `dy workspace set AGENTS.md --text-file <file> --if-match <revision>`, then `dy onboarding complete`. If the owner would rather decide later, run `dy onboarding skip`.",
+        why: "Until this is answered the bot browses and comments as a generic assistant. Nothing in the output would say the owner was never asked.",
+    };
+}
 function publicBrowser(state) {
     return { running: true, headless: state.headless, pid: state.pid, started_at: state.started_at };
 }

package/dist/errors.js

@@ -35,6 +35,9 @@ function category(code) {
         "already_exists",
         "revision_required",
         "revision_conflict",
+        // The bot has no persona yet. This is the installation's own state, not a
+        // failure of the command, and it is answered by asking the owner.
+        "setup_required",
         "account_mismatch",
         "migration_pending",
         // A gate that refused because of the installation's own recorded

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "shuadouyin",
-	"version": "0.3.0",
+	"version": "0.3.1",
 	"packageManager": "pnpm@10.34.7",
 	"description": "Browse Douyin with a persistent bot persona and a memory of its own",
 	"type": "module",

package/skills/dy/SKILL.md

@@ -8,67 +8,47 @@ allowed-tools: Bash(dy:*) Bash(npx dy:*)
 
 `dy` 是本地能力工具。当前 agent 负责理解、判断、对话、总结与调度。用 `dy schema` 查看可用命令；尊重用户当前授权和已有账号状态。
 
-## 先确认 dy 装好了
-
-```bash
-dy --version
-```
+## 第一次用：先问人设
 
-有版本号就直接用。没有就装：
+新工作区里人格还是模板。这时候每个页面命令的返回里都会带一个 `setup` 字段：
 
-```bash
-npm install -g shuadouyin
+```json
+"setup": {
+  "status": "pending",
+  "ask": ["这个 bot 叫什么，说话什么调子？", "有什么事它绝对不能做？"],
+  "next": "…怎么保存人格…",
+  "why": "不回答的话，bot 会用通用助手的声音说话，而输出里没有任何东西会提示主人没被问过"
+}
 ```
 
-包叫 `shuadouyin`，命令叫 `dy`。**唯一需要的是本机已有的 Chrome**，不下载浏览器。装完 `dy init` 建工作区，`dy auth login` 扫码登录抖音。
+**命令照常执行**，`setup` 只是搭在结果上。看到它就先问主人这两个问题，别等主人自己想起来。
 
-从源码装也行（会构建一次，几秒）：
+1. `dy workspace get AGENTS.md` 拿 revision
+2. 改完 `dy workspace set AGENTS.md --text-file <file> --if-match <revision>`
+3. `dy onboarding complete`
 
-```bash
-npm install -g github:9Ashwin/ShuaDouyin
-```
+主人说「以后再说」就跑 `dy onboarding skip`——跳过也是回答，之后不再提示。
 
-装 skill 到 agent 目录（可选，这样其他 agent 也能读到）：
-
-```bash
-npx skills add https://github.com/9Ashwin/ShuaDouyin --skill dy
-```
-
-或者用 CLI 自己装：
-
-```bash
-dy skill install
-```
+`setup` 只在新工作区出现。它没有拦你，是因为拦过一版：想先看几条视频再起名的人会被错误挡住，那比提示更糟。
 
-### 更新 dy
+## 先确认 dy 装好了
 
 ```bash
-dy update --check
+dy --version
 ```
 
-告诉你四件事：这份是怎么装的（`checkout` / `npm-global` / `npm-local` / `managed-release`）、版本号、是哪个 commit 构建的、有没有更新的。
-
-**判断新旧用 `behind`。** 版本号告诉你跨了几层功能，但一层里可能有几十个提交，所以只有 commit 能回答「我是不是最新的」。
-
-按 `update` 字段给的命令更新。从 npm 装的：
-
-```bash
-npm install -g shuadouyin@latest
-```
+有版本号就直接用。没有、或者要更新、要装 skill 到别的 agent 目录，读 `references/setup.md`——那里有安装、更新和各种安装形态的说明。
 
-从源码装的：
+## 每次开始对话，先读人格
 
 ```bash
-npm install -g github:9Ashwin/ShuaDouyin@latest
+dy workspace get AGENTS.md
+dy context show --query "<这一轮要做什么>"
 ```
 
-**从源码装的话，不加 `@latest` 或 `--force` 会显示 up to date 而不更新**——npm 记录的是 commit，不是分支，它认为已经满足要求了。npm 包按版本号，没这个问题。
+**这不是可选的一步。** 那个文件第一行是 bot 的名字，`## 身份与声音` 里是它说话的样子。不读就用你自己默认的语气回答，那等于把主人设的人格扔了——而且从输出里看不出来是漏读了还是没照做。
 
-更新完 skill 也要重装一次，否则 agent 读到的是旧说明：
-
-```bash
-npx skills add https://github.com/9Ashwin/ShuaDouyin --skill dy
-```
+读了之后，你的每一句话都用那个身份说，包括「我」的自称、句子的长短、有没有语气词。人格里写着「话多、爱笑、用短句和语气词」，而你回一段四平八稳的分析，那就是没照着做。
 
 ## 快速开始
 
@@ -207,6 +187,7 @@ dy guide                        # 这份文档的完整内容
 
 | 你在做什么 | 读 |
 | --- | --- |
+| 安装、更新、卸载、磁盘占用 | `references/setup.md` |
 | 不知道该用哪个命令 | `references/commands.md` |
 | 浏览、观察、评论、私信、分享、发图 | `references/browse-and-grow.md` |
 | 进直播间、发弹幕、送礼 | `references/live.md` |
@@ -250,7 +231,19 @@ dy guide                        # 这份文档的完整内容
 
 ## 用什么语气说话
 
-`dy` 是在养一个 bot，不是跑一条流水线。读 `workspace get AGENTS.md` 的人格，用那个身份对用户说话。
+`dy` 是在养一个 bot，不是跑一条流水线。语气来自 `AGENTS.md`，不是你自己的默认风格。
+
+**人格写了什么，就照什么说。** 不是「参考一下」，是执行：
+
+| 人格里写着 | 该有的样子 | 不该有的样子 |
+| --- | --- | --- |
+| 话多、爱笑、用语气词 | 「这条好好笑，评论区都在接梗欸」 | 「该视频评论区呈现互动特征」 |
+| 沉稳、有观察力、先给事实 | 「三帧里两帧是字幕，中间那帧在讲结论」 | 「哇这个也太有意思了吧」 |
+| 简洁、只说结论 | 「没发出去，按钮 0×0」 | 「经过排查，我发现了问题的根本原因在于……」 |
+
+写完先看一眼：这句话换个 bot 也说得出来吗？说得出来，就说明人格没进去。
+
+**名字用文件里的。** 第一行是「阿鱼」就别自称「猫猫」，改了名字也得先改文件。
 
 **不要用交付工单的口吻。** 这些词一出现，人格就没了：
 

package/skills/dy/references/setup.md

@@ -0,0 +1,100 @@
+# 安装与更新
+
+只在需要的时候读这个文件。日常使用看 `SKILL.md`。
+
+## 装 dy
+
+```bash
+npm install -g shuadouyin
+```
+
+包叫 `shuadouyin`，命令叫 `dy`。发布包里带的是构建好的 `dist/`，装上就能跑，不需要本地编译。
+
+**唯一需要的是本机已有的 Chrome**，不下载浏览器。
+
+装完：
+
+```bash
+dy init          # 建工作区
+dy auth login    # 扫码登录抖音（有头 Chrome）
+```
+
+从源码装也行，会构建一次，几秒：
+
+```bash
+npm install -g github:9Ashwin/ShuaDouyin
+```
+
+源码安装需要 `esbuild` 的平台二进制，而它是通过 esbuild 自己的安装脚本下载的。如果 npm 被配置成跳过生命周期脚本（本仓库的 `.npmrc` 就设了 `ignore-scripts`，有些人也是全局设的），安装会失败并提示 `Cannot find package 'esbuild'`。加 `--ignore-scripts=false` 重装即可。
+
+## 装 skill 到 agent 目录
+
+这样别的 agent 也能读到：
+
+```bash
+npx skills add https://github.com/9Ashwin/ShuaDouyin --skill dy
+```
+
+或者用 CLI 自己装：
+
+```bash
+dy skill install
+```
+
+`dy skill status` 检查已装的副本和仓库是否一致。
+
+## 更新
+
+```bash
+dy update --check
+```
+
+告诉你四件事：
+
+- 这份是怎么装的（`checkout` / `npm-global` / `npm-local` / `managed-release`）
+- 版本号
+- 是哪个 commit 构建的
+- 有没有更新的
+
+**判断新旧用 `behind` 和 commit。** 版本号说明跨了几层功能，但一层里可能有几十个提交，所以只有 commit 能回答「我是不是最新的」。
+
+按 `update` 字段给的命令更新。从 npm 装的：
+
+```bash
+npm install -g shuadouyin@latest
+```
+
+从源码装的：
+
+```bash
+npm install -g github:9Ashwin/ShuaDouyin@latest
+```
+
+**从源码装的话，不加 `@latest` 或 `--force` 会显示 up to date 而不更新**——npm 记录的是 commit，不是分支，它认为已经满足要求了。npm 包按版本号，没这个问题。
+
+更新完 skill 也要重装一次，否则 agent 读到的是旧说明：
+
+```bash
+npx skills add https://github.com/9Ashwin/ShuaDouyin --skill dy
+```
+
+## 卸载
+
+```bash
+npm uninstall -g shuadouyin
+```
+
+卸载保留 `~/.dy` 里的 bot、记忆和账号登录状态。
+
+要连状态一起清掉，手动删 `~/.dy`。删之前可以跑 `dy browser clean` 先回收缓存和截图——那部分通常占绝大部分空间，而登录和记忆都在别的文件里。
+
+## 磁盘
+
+`~/.dy` 会持续增长，但增长的几乎都不是 dy 自己的数据。实测一台用了几天的是 1.5G，其中 1.2G 是 Chrome 的 HTTP 缓存、104M 是截图，dy 的事件、记忆和人格一共 2.5M。
+
+```bash
+dy browser clean          # 看能回收多少
+dy browser clean --apply  # 真的删
+```
+
+缓存和截图超过 512MB 时，Chrome 启动前会自动清一次。Cookie、登录数据、事件日志、收据、记忆、人格、快照永远不动。