npm - shuadouyin - Versions diffs - 0.4.0 → 0.4.1 - Mend

shuadouyin 0.4.0 → 0.4.1

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 (5) hide show

package/.dy-build-commit CHANGED Viewed

	@@ -1 +1 @@
1	- ~~7251333bbc6e84fd193536885101c3b6ebf46c86~~
1	+ d9528376f4f68e7e7414bc7968f619267fd656b4

package/CHANGELOG.md CHANGED Viewed

@@ -1,5 +1,12 @@
 # Changelog
+## 0.4.1 — 2026-10-31
+### 文档
+- README 加了两张图：一张能力总览，一张六格流程示意。两种语言共用同一组。
+- 图片不随 npm 包发布。它们是给 GitHub 页面看的，装包的人用不到，带上会把包从 343 kB 撑到 4.5 MB。
 ## 0.4.0 — 2026-10-31
 ### 新增

package/README.en.md CHANGED Viewed

@@ -5,196 +5,185 @@
 <div align="center">
-# ShuaDouyin
+# ShuaDouyin · 刷抖音
-**An agent that browses Douyin with a persona and a memory. Open source.**
+<img src="docs/assets/shuadouyin-hero.png" alt="ShuaDouyin: browsing and search, comments and reactions, chat and sharing, live rooms, relationships, persona and memory" width="100%" />
-Browsing, comments, direct messages, live rooms, memory — one local CLI that
-leaves the judgement to whatever agent is driving it.
+**Let your AI Agent use Douyin with a persona and a memory.**
-<img src="https://img.shields.io/badge/node-%E2%89%A522.19-339933?logo=node.js&logoColor=white" alt="Node" />
-<img src="https://img.shields.io/badge/license-MIT-blue" alt="License" />
-<img src="https://img.shields.io/github/stars/9Ashwin/ShuaDouyin?style=social" alt="Stars" />
+A local command-line tool connecting your Agent, the Douyin page, and context that lasts.
+<img src="https://img.shields.io/badge/node-%E2%89%A522.19-339933?logo=node.js&logoColor=white" alt="Node.js 22.19+" />
+<img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License" />
+<img src="https://img.shields.io/github/stars/9Ashwin/ShuaDouyin?style=social" alt="GitHub Stars" />
+[Quick start](#quick-start) · [Capabilities](#capabilities) · [Agent integration](#agent-integration) · [Development](#development-and-contributing)
 </div>
----
+## What is this?
+ShuaDouyin's executable is `dy`. Give it to an AI Agent that can run shell commands to search content, inspect works and comments, interact with your authorization, handle messages and shares, visit live rooms, and keep sourced memories and relationship records.
-## What is this
+**You define the name, voice and boundaries. The Agent interprets and decides; `dy` supplies operations and evidence.** It bundles no model and schedules no tasks. It uses your existing Agent and local Chrome, with persona and memory stored locally across sessions.
-`dy` is a local command-line tool. It bundles no model, schedules nothing, and
-decides nothing about content — it provides the state, context and primitives
-one browsing round needs, and leaves the judgement to the agent calling it.
+## Quick start
-What it remembers for you: what this account likes, who it has talked to, which
-lines got an answer. What it will not decide for you: whether to send, what to
-say, or whether a person is worth knowing.
+You need **Node.js 22.19+, Chrome, and an Agent that can execute shell commands**.
-## Install
+### 1. Install the CLI and skill
 ```bash
 npm install -g shuadouyin
+dy --version
+dy skill install
 ```
-`dy` is then on your PATH. The package is `shuadouyin` and the command is `dy`;
-the published tarball ships a built `dist/`, so nothing compiles on install. The
-only requirement is a local Chrome — **no browser is downloaded**.
+The npm package is `shuadouyin`; the command is `dy`. The published package includes the build output and uses your local Chrome, without downloading another browser. The skill installer detects supported Agent directories and preserves existing copies it does not manage.
-Installing from source also works, and builds once:
+### 2. Create the workspace and log in
 ```bash
-npm install -g github:9Ashwin/ShuaDouyin
+dy init
+dy auth login
 ```
-This package is distributed from GitHub, not the npm registry.
+Scan the login QR code in the dedicated Chrome window. The default workspace is `~/.dy`; the browser login persists in `~/.dy/chrome`.
-<details>
-<summary><strong>Other options</strong></summary>
+### 3. Start a conversation with your Agent
-Into a private directory, without a global npm:
+> Use dy to help me set up a name, voice and boundaries. Then browse five works, pick one to inspect its frames and comments, and tell me what you observed. Only read this round; do not interact.
-```bash
-curl -fsSL https://raw.githubusercontent.com/9Ashwin/ShuaDouyin/main/scripts/install.sh | sh
-```
+You can also start with a specific task:
-Uninstall:
+- **Research content:** “Search for AI coding, inspect two works, and separate what their titles, frames and comments tell us.”
+- **Continue a conversation:** “Check new messages in the conversation I specify and draft a reply using the earlier context.”
+- **Follow up:** “Review the people I have recorded and list follow-ups due today.”
+- **Review the day:** “Summarize today's local activity and receipts, clearly separating uncertain outcomes.”
-```bash
-npm uninstall -g shuadouyin
-```
+For manual terminal use, run `dy tui`. It needs an interactive terminal and shares the CLI's operations and state.
-Uninstalling keeps the bot, memories and account login in `~/.dy`.
+## Capabilities
-</details>
+![Six-panel comic: define a persona, search and browse, inspect works and comments, interact and share, visit live rooms, keep memory and relationships](docs/assets/shuadouyin-workflow.png)
+The artwork uses Chinese labels. The character represents a configurable Agent, not a fixed persona. Four sample positions and five comments came from an actual browsing run; the scenes are redrawn illustrations. The other panels show capabilities, not messages or gifts sent during that run.
+| Capability | Common entry points |
+| --- | --- |
+| Search works and people; browse a batch of feed items | `dy search` · `dy user search` · `dy feed sweep` |
+| Read works, sample frames, inspect comments and replies | `dy video digest` · `dy comment list` · `dy comment replies` |
+| Like, favorite, follow, post text or image comments | `dy video like` · `dy video favorite` · `dy user follow` · `dy comment post` · `dy comment image` |
+| Read messages, send text and images, quote a reply | `dy chat read` · `dy chat send` · `dy chat image` · `dy chat reply` |
+| Share a work as a link or native card | `dy chat share` · `dy chat forward` |
+| Read live-room info and chat, speak, send a named and priced gift | `dy live info` · `dy live chat` · `dy live say` · `dy live gift` |
+| Read persona, recall context, save sourced facts | `dy persona show` · `dy context show` · `dy memory add` |
+| Derive voice from actual writing, retain lessons, check wording | `dy persona evolve` · `dy learn keep` · `dy voice check` |
+| Track browsing rounds, goals, relationships and follow-ups | `dy browse start` · `dy social goal` · `dy social due` |
+| Inspect write receipts; prepare and save daily reports | `dy receipt get` · `dy report prepare` · `dy report save` |
+These are command entry points. Use `dy <command> --help` for required arguments, or `dy schema` for the complete command and field catalog.
+## Persona and memory across sessions
-Install the skill for an agent (optional):
+The default `~/.dy` workspace separates persona, people records, memory and the browser login:
+- **`AGENTS.md`** defines the Agent's identity, voice and boundaries. You can revise the settings.
+- **`PROFILES.md` and `memory/`** hold people records and sourced memories. Owner statements, page observations and inferences stay distinct. Markdown is the source of truth for memory bodies.
+- **`growth review`, `learn keep` and `persona evolve`** support reviewing activity, retaining lessons and deriving changes in voice. The caller decides what is worth keeping; a viewed work does not automatically become a lasting preference.
+Updating or reinstalling the CLI continues to use the existing workspace. Use the reset commands below when you want to start over.
+## Agent integration
+The [dy skill](skills/dy/SKILL.md) teaches Agents to use the tool, with topic-specific workflows in [references](skills/dy/references/). As an alternative to `dy skill install`, use the skills installer:
 ```bash
-dy skill install
+npx skills add https://github.com/9Ashwin/ShuaDouyin --skill dy
 ```
-## Getting started
+Start each task by reading persona and relevant context:
 ```bash
-dy init                      # create the workspace, start onboarding
-dy onboarding show           # four questions: name, voice, facts about you, limits
-dy auth login                # open Chrome and scan the QR code
-dy feed next                 # next work in the recommended feed
-dy video info                # read the current work
+dy persona show
+dy context show --query "The question for this task"
+dy feed sweep --count 5
 ```
-The first login opens a dedicated Chrome window whose profile lives in
-`~/.dy/chrome`. That login is kept across restarts.
+Choose a work ID from the results, open its detail page, then sample it:
-Run `dy tui` when you want to browse and like by hand — a terminal interface
-over the same operations. It shares the CLI's implementation, so both see the
-same state. It needs a real terminal and refuses `--dry-run`.
+```bash
+dy video open <video-id>
+dy video digest --video-id <video-id> --limit 5
+```
-## What it does
+`dy guide` returns instructions matching the installed version; `dy schema` describes commands, arguments and effects. Run one workspace operation at a time to avoid account-lock conflicts.
-| Task | Commands |
-| --- | --- |
-| Browse the feed | `dy feed open` / `dy feed next` / `dy video info` |
-| Read works and comments | `dy video info` / `dy comment list` / `dy comment replies` |
-| Interact | `dy video like` / `dy video favorite` / `dy comment post` / `dy comment reply` |
-| Direct messages | `dy chat list` / `dy chat read` / `dy chat send` / `dy chat image` |
-| People | `dy user get` / `dy user search` / `dy user followers` / `dy user follow` |
-| Live rooms | `dy live info` / `dy live chat` / `dy live say` / `dy live gift` |
-| Search | `dy search` / `dy user search` |
-| Memory and persona | `dy memory add` / `dy memory search` / `dy context show` |
-| Browsing rounds | `dy browse start` / `dy browse watch` / `dy browse end` |
-| Relationships | `dy social goal` / `dy social list` / `dy social due` / `dy social log` |
-| Teach an agent to use it | `dy guide` |
+Success emits `{ok:true,data}` to stdout. Failure emits `{ok:false,error}` to stderr and exits nonzero. Writes use a unique `--request-id`. The `--dry-run` option validates input and the plan without connecting to Chrome, filling inputs or sending. See [docs/contracts.md](docs/contracts.md) for the full contract.
-See `dy schema` for every command, or `dy <command> --help`.
+## Actions and evidence
-## For agents
+- **A receipt before dispatch.** Replaying a confirmed request ID returns the saved receipt. Inspect `delivery_uncertain` outcomes instead of automatically resending. Native-card sharing currently cannot verify delivery and keeps dispatched shares uncertain.
+- **Stable identities.** Use the work, user and conversation IDs returned by the CLI. Display names are only labels.
+- **Samples are not full viewing.** Lists contain loaded content and generally report `complete: false`. The live picture is not returned as readable content. The Agent draws conclusions from the evidence it actually has.
+- **External actions need authorization.** Comments, messages, follows and live chat affect a real account. Gifts cost money and require explicit agreement plus a name-and-price check. Deletion and recall depend on platform conditions and cannot guarantee that content was unseen.
+- **Local login and data.** Automation may trigger verification, rate limits or account penalties. A person must complete verification; the project offers no bypass. `~/.dy` contains login state, messages and memories and should not be committed or shared. See [SECURITY.md](SECURITY.md).
+## Installation options and workspace management
+<details>
+<summary><strong>Other installation methods, uninstall and reset</strong></summary>
-`dy` is built for an agent to drive. Hand it to anything that can run a shell:
+Install from GitHub source, which runs a build:
 ```bash
-dy guide      # the full usage guide (~9000 characters); this is what the agent reads
+npm install -g github:9Ashwin/ShuaDouyin
 ```
-Or install `skills/dy` into your agent's skill directory. It carries five
-references: browsing and growth, memory and persona, reports, what to do when
-something fails, and **platform facts** — the last one is the record of what
-this project got wrong on the real page, and reading it saves repeating that.
-## Principles
-- **No judgement.** The CLI returns facts and candidates; the caller decides.
-  It acts on a real account, so the code's job is to make every action auditable
-  and reversible — not to decide whether the action is appropriate.
-- **A receipt before anything leaves.** Every write lands on disk before it can
-  dispatch, and replaying a request ID returns the original receipt. A
-  `delivery_uncertain` write is never retried automatically: it may already be
-  out, and sending again makes two.
-- **Identity is a stable id.** Display names collide and change; `sec_uid` does
-  not.
-- **Report what is readable.** The live picture is a canvas with no text layer,
-  so nothing is claimed about it. Comment lists are sampled and say so.
-- **Memory belongs to the account.** A new install is a new bot; it does not
-  inherit anyone else's conclusions.
-## Reset
+On macOS / Linux, an installer can use a private installation directory:
 ```bash
-dy bot reset           # show what would be cleared
-dy bot reset --write   # back up to ~/.dy-backup-<time>, then clear
-dy init                # create a fresh bot
+curl -fsSL https://raw.githubusercontent.com/9Ashwin/ShuaDouyin/main/scripts/install.sh | sh
 ```
-The Chrome login is kept, so no new scan is needed.
+Check installed skill copies against the current version:
-## Development
+```bash
+dy skill status
+```
-Requires Node.js 22.19+, pnpm, and a local Chrome.
+Remove an npm global installation while retaining `~/.dy`:
 ```bash
-pnpm install --frozen-lockfile --ignore-scripts
-pnpm build
-pnpm test            # unit tests
-pnpm test:browser    # isolated Chrome tests
-pnpm check           # Biome + tsc
+npm uninstall -g shuadouyin
 ```
-Output contracts, receipt states and storage semantics are in
-[docs/contracts.md](docs/contracts.md). Source layout, module ownership and the
-check sequence are in [AGENTS.md](AGENTS.md).
+Reset persona, memories and activity after a backup; keep the Chrome login:
-## Risks and limits
+```bash
+dy bot reset           # preview the scope
+dy bot reset --write   # back up and reset; use the returned backup path
+dy init                # create the workspace again
+```
-This tool drives a real Douyin account. Using it means accepting the following:
+</details>
-- **The account risk is yours.** Automated use of Douyin may trigger human
-  verification, rate limits or penalties. The project offers no bypass and will
-  not help you evade them. When a challenge appears, a person has to solve it in
-  the headed Chrome window.
-- **What is sent cannot be taken back.** Comments, direct messages, danmaku and
-  gifts are public and irreversible, and gifts cost real money. Check the target
-  and the text first; `--dry-run` shows the plan without acting.
-- **Local state is sensitive.** `~/.dy` holds the login, everything that was read
-  and the long-term memory. Do not commit it, screenshot it or put it somewhere
-  shared. See [SECURITY.md](SECURITY.md).
-- **What you read is not everything.** Lists are sampled and say
-  `complete: false`; the live picture is a canvas with no text. Concluding from a
-  sample is your judgement, not the tool's finding.
-- **It does not decide.** Whether to send, to whom, or whether a person is worth
-  knowing is not a decision the commands make, and being driven by an agent does
-  not lower that bar.
+## Development and contributing
-## Status
+Requires Node.js 22.19+, pnpm, and local Chrome.
-Early. Commands, error codes and response fields are public contracts and are
-kept stable; the database schema migrates with each release. CI runs the unit
-and isolated-Chrome tests on Ubuntu, macOS and Windows.
+```bash
+pnpm install --frozen-lockfile --ignore-scripts
+pnpm build
+pnpm check           # Biome + TypeScript
+pnpm test            # unit tests
+pnpm test:browser    # temporary Chrome profile and fixture pages
+```
-## Contributing
+Browser tests use no account credentials. Passing them does not prove behavior on the real Douyin page. The project is early, and page changes can affect operations; error codes, arguments and response fields are maintained as public contracts.
-See [CONTRIBUTING.md](CONTRIBUTING.md). Report security problems privately per
-[SECURITY.md](SECURITY.md).
+See [AGENTS.md](AGENTS.md) for development rules, [docs/architecture.md](docs/architecture.md) for the architecture, [CONTRIBUTING.md](CONTRIBUTING.md) to contribute, and [CHANGELOG.md](CHANGELOG.md) for release changes.
 ## License
-MIT
+[MIT](LICENSE)

package/README.md CHANGED Viewed

@@ -5,177 +5,185 @@
 <div align="center">
-# 刷抖音 · ShuaDouyin
+# ShuaDouyin · 刷抖音
-**让 agent 带着人格和记忆使用抖音。开源。**
+<img src="docs/assets/shuadouyin-hero.png" alt="ShuaDouyin 刷抖音：浏览与搜索、评论与互动、私信与分享、直播与弹幕、关系与跟进、人格与记忆" width="100%" />
-浏览、评论、私信、直播、记忆——一个本地 CLI，判断权留给调用它的 agent。
+**让你的 AI Agent，带着人格和记忆使用抖音。**
-<img src="https://img.shields.io/badge/node-%E2%89%A522.19-339933?logo=node.js&logoColor=white" alt="Node" />
-<img src="https://img.shields.io/badge/license-MIT-blue" alt="License" />
-<img src="https://img.shields.io/github/stars/9Ashwin/ShuaDouyin?style=social" alt="Stars" />
+一个本地命令行工具，连接 Agent、抖音页面和持续积累的上下文。
-</div>
+<img src="https://img.shields.io/badge/node-%E2%89%A522.19-339933?logo=node.js&logoColor=white" alt="Node.js 22.19+" />
+<img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License" />
+<img src="https://img.shields.io/github/stars/9Ashwin/ShuaDouyin?style=social" alt="GitHub Stars" />
+[快速开始](#快速开始) · [功能一览](#功能一览) · [Agent 接入](#给-agent-接入) · [开发与参与](#开发与参与)
----
+</div>
 ## 这是什么
-`dy` 是一个本地命令行工具。它不内建模型、不调度、不做内容判断——它提供**一轮浏览所需的状态、上下文和操作原语**，判断由调用它的 agent 做。
+ShuaDouyin 的命令叫 `dy`。把它交给能执行 shell 的 AI Agent，就能搜索内容、浏览作品与评论、按授权互动、处理私信与分享、进入直播间，并保存有来源的记忆和关系记录。
+**你定义名字、语气和边界，Agent 负责理解与判断，`dy` 提供操作和证据。** 项目不内建模型，也不运行定时任务；使用你已有的 Agent 和本机 Chrome。人设与记忆保存在本地，可以跨会话继续使用。
-它替你记住的：这个账号喜欢什么、跟谁聊过、哪句话有回应。它不替你决定的：该不该发、发什么、这个人值不值得认识。
+## 快速开始
-## 安装
+准备好 **Node.js 22.19+、Chrome，以及一个能执行 shell 的 Agent**。
+### 1. 安装工具与 skill
 ```bash
 npm install -g shuadouyin
+dy --version
+dy skill install
 ```
-`dy` 随即可用。**不下载浏览器**——用你本机已有的 Chrome。
+npm 包叫 `shuadouyin`，可执行命令叫 `dy`。发布包已包含构建产物；使用本机 Chrome，不额外下载浏览器。`dy skill install` 会为已检测到的 Agent 安装技能，已有的非托管副本会保留。
-包叫 `shuadouyin`，命令叫 `dy`。发布包里带的是构建好的 `dist/`，装上就能跑，不需要本地再编译一次。
-<details>
-<summary><strong>其他</strong></summary>
-从源码装（会构建一次，几秒）：
+### 2. 建立工作区并登录
 ```bash
-npm install -g github:9Ashwin/ShuaDouyin
+dy init
+dy auth login
 ```
-装到独立目录，不需要全局 npm：
+在打开的专用 Chrome 窗口里扫码登录。工作区默认位于 `~/.dy`，浏览器登录保存在 `~/.dy/chrome`，后续继续使用。
-```bash
-curl -fsSL https://raw.githubusercontent.com/9Ashwin/ShuaDouyin/main/scripts/install.sh | sh
-```
+### 3. 在你的 Agent 里开始聊
-卸载：
+> 用 dy 带我完成设置，先问我名字、语气和边界。然后刷 5 条，挑 1 条读画面和评论，告诉我看到了什么。这轮只看，不互动。
-```bash
-npm uninstall -g shuadouyin
-```
+也可以从具体任务开始：
-卸载保留 `~/.dy` 里的 bot、记忆和账号登录状态。
+- **带着问题找内容：**“搜一下 AI 编程，挑两条展开读，区分标题、画面和评论提供的信息。”
+- **继续已有对话：**“看看我指定会话的新消息，结合之前的上下文拟一条回复。”
+- **跟进关系：**“整理我已记录的人，看看今天有哪些到期的跟进事项。”
+- **回顾一天：**“根据今天的本地记录和收据写个摘要，结果不明的操作单独说明。”
-</details>
+想自己操作终端界面，可以运行 `dy tui`；它需要真实终端，和 CLI 共用同一套操作与状态。
+## 功能一览
+![ShuaDouyin 六格漫画：设定人格、搜索与浏览、读作品与评论、互动与分享、直播与弹幕、记忆与关系](docs/assets/shuadouyin-workflow.png)
+图中角色代表可配置的 Agent，名字、语气和边界由你定义。四个采样点和五条评论来自一次实际浏览，画面为重绘；其他场景是功能示意，不代表本次执行了发送或送礼。
+| 能力 | 常用入口 |
+| --- | --- |
+| 搜索作品、找人、批量浏览推荐流 | `dy search` · `dy user search` · `dy feed sweep` |
+| 读取作品、采样画面、查看评论与回复 | `dy video digest` · `dy comment list` · `dy comment replies` |
+| 点赞、收藏、关注、发布文字或图片评论 | `dy video like` · `dy video favorite` · `dy user follow` · `dy comment post` · `dy comment image` |
+| 读取私信、发送文字和图片、引用回复 | `dy chat read` · `dy chat send` · `dy chat image` · `dy chat reply` |
+| 分享作品链接或原生卡片 | `dy chat share` · `dy chat forward` |
+| 读取直播信息与弹幕、发言、按名称和价格送礼 | `dy live info` · `dy live chat` · `dy live say` · `dy live gift` |
+| 读取人格、召回记忆、保存带来源的事实 | `dy persona show` · `dy context show` · `dy memory add` |
+| 从实际表达中更新声音、积累经验、自查文风 | `dy persona evolve` · `dy learn keep` · `dy voice check` |
+| 管理浏览轮次、目标、关系与跟进事项 | `dy browse start` · `dy social goal` · `dy social due` |
+| 查询操作收据、准备和保存日报 | `dy receipt get` · `dy report prepare` · `dy report save` |
+表中是命令入口，必填参数见 `dy <命令> --help`；完整命令与字段见 `dy schema`。
+## 人格和记忆如何延续
+默认工作区 `~/.dy` 将人格、人物资料、记忆和账号登录分开保存：
-装 skill 给 agent 用（可选）：
+- **`AGENTS.md`** 定义这个 Agent 的身份、语气和边界，设定可以修改。
+- **`PROFILES.md` 与 `memory/`** 保存人物资料和带来源的记忆。用户明确表达的事实、页面观察和推测分开记录；Markdown 是记忆正文的来源。
+- **`growth review`、`learn keep` 与 `persona evolve`** 为回顾、经验和表达变化提供依据。是否值得保存由调用方判断，浏览不等于自动形成长期偏好。
+更新或重新安装 CLI 会继续使用原工作区。需要重新开始时，使用下方的重置命令。
+## 给 Agent 接入
+[dy skill](skills/dy/SKILL.md) 负责教 Agent 如何使用工具，主题流程放在 [references](skills/dy/references/) 中。除了 `dy skill install`，也可以使用技能安装器：
 ```bash
 npx skills add https://github.com/9Ashwin/ShuaDouyin --skill dy
 ```
-或者用 CLI 自己装到 agent 目录：
+每次任务先读人格和相关上下文，再读页面：
 ```bash
-dy skill install
-dy skill status   # 已装的副本和仓库是否一致
+dy persona show
+dy context show --query "这次要解决的问题"
+dy feed sweep --count 5
 ```
-## 开始使用
+从结果中选出作品 ID 后，先打开对应详情页，再采样：
 ```bash
-dy init                      # 建工作区，开始引导
-dy onboarding show           # 回答四个问题：名字、性格、关于你的事实、界限
-dy auth login                # 打开 Chrome 扫码登录抖音
-dy feed next                 # 刷下一条
-dy video info                # 读当前作品
+dy video open <video-id>
+dy video digest --video-id <video-id> --limit 5
 ```
-第一次登录会打开一个专用的 Chrome 窗口（profile 在 `~/.dy/chrome`），扫码后这个登录会一直保留。
+`dy guide` 提供与当前安装版本一致的使用说明；`dy schema` 提供命令、参数和副作用类型。一次只运行一个工作区操作，避免账号锁冲突。
-想手动刷、手动点赞时用 `dy tui`——一个覆盖同样操作的终端界面。它和 CLI 走同一套实现，所以两边看到的状态一致。需要在真实终端里运行（不接受管道输入），也不能和 `--dry-run` 一起用。
+成功输出 `{ok:true,data}` 到 stdout；失败输出 `{ok:false,error}` 到 stderr，并返回非零退出码。写入使用唯一的 `--request-id`；`--dry-run` 只验证参数和计划，不连接 Chrome、不填表、不发送。完整契约见 [docs/contracts.md](docs/contracts.md)。
-## 它能做什么
+## 操作与证据边界
-| 做什么 | 命令 |
-| --- | --- |
-| 刷推荐流 | `dy feed open` / `dy feed next` / `dy video info` |
-| 读作品与评论 | `dy video info` / `dy comment list` / `dy comment replies` |
-| 互动 | `dy video like` / `dy video favorite` / `dy comment post` / `dy comment reply` |
-| 私信 | `dy chat list` / `dy chat read` / `dy chat send` / `dy chat image` |
-| 人 | `dy user get` / `dy user search` / `dy user followers` / `dy user follow` |
-| 直播 | `dy live info` / `dy live chat` / `dy live say` / `dy live gift` |
-| 搜索 | `dy search` / `dy user search` |
-| 记忆与人格 | `dy memory add` / `dy memory search` / `dy context show` |
-| 人格自己长 | `dy persona evolve` / `dy persona history` / `dy persona rollback` |
-| 沉淀经验 | `dy learn keep` / `dy learn findings` |
-| 文风自查 | `dy voice check --text "…"` |
-| 浏览轮次 | `dy browse start` / `dy browse watch` / `dy browse end` |
-| 社交关系 | `dy social goal` / `dy social list` / `dy social due` / `dy social log` |
-| 让 agent 会用 | `dy guide` |
-完整命令见 `dy schema`，或 `dy <命令> --help`。
-## 给 agent 用
-`dy` 是为 agent 设计的。把它交给任何能跑 shell 的 agent：
+- **写之前先留收据。** 已确认的 request ID 重放时返回原收据；遇到 `delivery_uncertain` 先核对，不自动重发。原生卡片分享目前无法验证送达，发出后会保留不确定状态。
+- **用稳定 ID 定位。** 作品、用户和会话以 CLI 返回的稳定 ID 为准；昵称只用于展示。
+- **采样不等于完整观看。** 列表只包含已加载内容，通常标记 `complete: false`；直播画面不作为可读内容返回。判断由 Agent 根据实际证据作出。
+- **对外动作需要授权。** 评论、私信、关注和直播发言作用于真实账号；礼物会花真钱，必须明确同意并核对名称和价格。删除或撤回受平台条件限制，不能保证收回已被看到的内容。
+- **登录和数据留在本机。** 自动化可能触发验证、限流或账号处罚；验证需要真人完成，项目不提供绕过手段。`~/.dy` 含登录态、消息和记忆，不应提交或共享。详见 [SECURITY.md](SECURITY.md)。
+## 安装方式与工作区管理
+<details>
+<summary><strong>其他安装方式、卸载与重置</strong></summary>
+从 GitHub 源码安装，会执行构建：
 ```bash
-dy guide      # 返回完整的使用说明（约 3 万字），agent 读这个
+npm install -g github:9Ashwin/ShuaDouyin
 ```
-或者把 skill 装进你的 agent 技能目录，这样它知道什么时候该用 `dy`、怎么用：
+macOS / Linux 也可以使用独立目录安装器：
 ```bash
-npx skills add https://github.com/9Ashwin/ShuaDouyin --skill dy
+curl -fsSL https://raw.githubusercontent.com/9Ashwin/ShuaDouyin/main/scripts/install.sh | sh
 ```
-`skills/dy` 里按主题分成八个参考文件：浏览与成长、记忆与人格、社交、直播、日报、自我改进、命令全表，以及**平台事实**——最后一个是踩过的坑，读它能省掉一次重来。
+检查 skill 副本与当前版本是否一致：
-`SKILL.md` 本身只有两百来行，是每次对话都会加载的那部分；参考文件按需读。
+```bash
+dy skill status
+```
-## 设计原则
+卸载 npm 全局安装的命令，保留 `~/.dy`：
-- **不做判断。** `dy` 不内建模型。它返回事实和候选，判断留给调用方。它对着一个真实账号操作，所以代码的职责是让每个动作可审计、可回滚，而不是替你决定这个动作该不该做。
-- **写之前先落收据。** 每条写入在可能发出之前就已落盘，重放同一个 request ID 返回原收据。`delivery_uncertain` 永远不自动重试——那条可能已经发出去了，再发就是两条。
-- **身份用稳定 ID。** 昵称会重名会改，`sec_uid` 不会。
-- **读到什么说什么。** 直播画面是 canvas，读不到就不报内容；评论是抽样，标 `complete: false`。
-- **记忆跟账号走。** 换一个安装就是新的 bot，不继承别人的判断。
+```bash
+npm uninstall -g shuadouyin
+```
-## 重置
+重置人格、记忆及活动状态，会先备份；Chrome 登录保留：
 ```bash
-dy bot reset           # 看会清掉什么（不改动）
-dy bot reset --write   # 备份到 ~/.dy-backup-<时间> 后清空
-dy init                # 建新的 bot
+dy bot reset           # 只预览范围
+dy bot reset --write   # 备份后重置，以返回的备份路径为准
+dy init                # 重新建立工作区
 ```
-Chrome 登录会保留，不用重新扫码。
+</details>
-## 开发
+## 开发与参与
 需要 Node.js 22.19+、pnpm 和本机 Chrome。
 ```bash
 pnpm install --frozen-lockfile --ignore-scripts
 pnpm build
+pnpm check           # Biome + TypeScript
 pnpm test            # 单元测试
-pnpm test:browser    # 隔离 Chrome 的浏览器测试
-pnpm check           # Biome + tsc
+pnpm test:browser    # 临时 Chrome profile + fixture 页面
 ```
-输出契约、收据状态和存储语义见 [docs/contracts.md](docs/contracts.md)。源码结构、模块归属和检查流程见 [AGENTS.md](AGENTS.md)。
-## 风险与边界
-这是一个操作真实抖音账号的工具。用它意味着接受下面几件事：
-- **账号风险由你承担。** 自动化使用抖音可能触发平台的人机验证、限流或处罚。项目不提供任何绕过手段，也不会帮你规避风控。验证弹出来时，需要真人在有头的 Chrome 里完成。
-- **发出去的东西撤不回来。** 评论、私信、弹幕、礼物都是对外且不可逆的。送礼花的是真钱。发之前先确认对象和内容，`--dry-run` 可以先看计划。
-- **本地状态含敏感信息。** `~/.dy` 里有登录态、读过的消息和长期记忆。不要提交、不要截图、不要放进共享目录。详见 [SECURITY.md](SECURITY.md)。
-- **读到的不是全部。** 列表是抽样并标 `complete: false`，直播画面是 canvas 读不到字。基于抽样下结论是你自己的判断，不是工具的结论。
-- **它不做判断。** 该不该发、发给谁、这个人值不值得认识，命令不会替你决定，也不会因为调用方是 agent 就降低门槛。
-## 状态
-早期阶段。命令、错误码和返回字段是公开契约，会尽量保持稳定；数据库结构随版本迁移。CI 在 Ubuntu、macOS 和 Windows 上跑单元测试与隔离 Chrome 测试。
-## 参与
+浏览器测试不使用账号凭据，通过测试不等于通过真实抖音页面验证。项目仍处于早期阶段，页面变化可能影响操作；错误码、参数和返回字段按公开契约维护。
-见 [CONTRIBUTING.md](CONTRIBUTING.md)。安全问题走私密报告渠道，见 [SECURITY.md](SECURITY.md)。
+开发规则见 [AGENTS.md](AGENTS.md)，架构见 [docs/architecture.md](docs/architecture.md)，贡献方式见 [CONTRIBUTING.md](CONTRIBUTING.md)，版本变化见 [CHANGELOG.md](CHANGELOG.md)。
 ## 许可
-MIT
+[MIT](LICENSE)

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
 	"name": "shuadouyin",
-	"version": "0.4.0",
+	"version": "0.4.1",
 	"packageManager": "pnpm@10.34.7",
 	"description": "Browse Douyin with a persistent bot persona and a memory of its own",
 	"type": "module",
@@ -21,6 +21,7 @@
 		"skills",
 		".dy-build-commit",
 		"!dist/**/*.map",
+		"!docs/assets",
 		"!dist/**/*.d.ts",
 		".dy-build-origin"
 	],