weaver-work-cli 0.1.2 → 0.1.5

package/skills/weaver-work-cli-shared/references/e10-auth-and-session.md

@@ -1,90 +0,0 @@
-# E10 认证与会话
-
-## 什么时候读取
-
-用户需要登录、切换 profile、诊断 E10 连接、处理登录失效，或任务涉及 `base-url`、auth 文件、Keychain、`WEAVER_*` 环境变量时读取本文件。
-
-## 基本检查
-
-```bash
-weaver-work-cli auth status --no-check
-weaver-work-cli auth whoami
-```
-
-`--no-check` 只读取本地登录态；需要实际验证服务端可用性时使用业务命令或明确带 live 校验的命令。
-
-## 认证隔离与禁止探查旧目录
-
-`weaver-work-cli auth root` 是唯一用于确认本 CLI 认证根目录的命令；默认根目录是 `~/.weaver-work-cli/e10`。Agent 不得因为历史兼容信息去读取、列出或 `cat` `~/.e10-cli`、`/Users/<user>/.e10-cli`、`e10-login` / `e10-cli` 的 auth、config 或 Keychain 数据。
-
-登录态判断只允许通过 `weaver-work-cli auth status --no-check`、`weaver-work-cli auth profile list/current`、`weaver-work-cli doctor --e10` 和业务命令返回的 JSON 错误完成。只有用户明确提供外部 auth 文件路径时，才可按用户要求使用 `--auth <path>` 或 `E10_AUTH_PATH`；不能主动搜索旧认证目录。
-
-## 未登录 / 登录失效：必须先向用户提问登录域名，再登录
-
-业务命令依赖 E10 登录态。出现以下任一情况即判定为未登录或登录失效：
-
-- `weaver-work-cli auth status` 输出 `loggedIn: false`，或本地不存在 auth 文件
-- `weaver-work-cli doctor --e10` 的 `e10AuthFile` 检查为 `ok: false`
-- 业务命令失败，stderr JSON 中 `error.type === "authentication"`（如 `E10 auth not found`）
-- 业务命令返回 `error.subtype === "session_expired"`（E10 登录态 401/302 失效）
-
-此时**禁止**：
-
-- 使用示例占位域名（如 `https://weapp.xxx.cn`）或自行猜测域名执行登录
-- 未向用户确认登录域名前，反复重试业务命令
-- 要求用户提供 Cookie、ETEAMSID、业务 Token（见安全边界）
-- 读取、列出或解析 `~/.e10-cli`、`/Users/<user>/.e10-cli`、`e10-login` / `e10-cli` 的历史 auth、config 或 Keychain 数据
-
-**正确流程（按序执行，缺一不可）：**
-
-1. **先调用宿主提供的提问 / 弹框能力询问用户**，让用户二选一：
-   - 输入本次要登录的 E10 登录域名（base URL），形如 `https://<企业域名>`；或
-   - 从已有 profile 中选择一个已登录环境：先运行 `weaver-work-cli auth profile list` 列出候选，让用户选择。
-2. 用户提供了**新域名**时，用真实域名执行浏览器 OAuth 登录：
-   ```bash
-   weaver-work-cli auth login --base-url "<用户输入的域名>"
-   ```
-   端口冲突时加 `--port 19801`。
-3. 用户选择了**已有 profile** 时，切换后验证登录态：
-   ```bash
-   weaver-work-cli auth profile use <name>
-   weaver-work-cli auth status
-   ```
-4. 登录成功后再继续原业务操作。仍失败时，把 `error.type/subtype/message` 原样反馈给用户并停止，不要自动重试。
-
-登录域名一律以用户实际提供为准；拿不到域名前，不要执行任何依赖登录态的业务命令。
-
-## 登录
-
-先取得用户确认的登录域名（见上节流程），再让用户通过浏览器 OAuth 登录：
-
-```bash
-weaver-work-cli auth login --base-url "<用户确认的登录域名>"
-```
-
-如果端口冲突：
-
-```bash
-weaver-work-cli auth login --base-url "<用户确认的登录域名>" --port 19801
-```
-
-保底方式是让用户手动写入浏览器中的 `ETEAMSID`：
-
-```bash
-weaver-work-cli auth set --eteamsid "PCACCOUNT_xxx" --base-url "<用户确认的登录域名>"
-```
-
-## Profile 与环境
-
-```bash
-weaver-work-cli auth profile list
-weaver-work-cli auth profile current
-weaver-work-cli auth profile use <name>
-weaver-work-cli --profile <name> auth status --no-check
-```
-
-通过 `weaver-work-cli run` 执行外部命令时，CLI 会按当前 profile 注入 `WEAVER_BASE_URL`、`WEAVER_ETEAMSID`、`WEAVER_COOKIE`、`WEAVER_USER_AGENT` 和 `WEAVER_AGENT_TYPE`。这些值只给子进程使用，不应在回复或日志中明文展示。
-
-## 安全边界
-
-Agent 不要要求用户贴 Cookie、ETEAMSID、业务 Token、app key 或 app secret，也不要直接读取用户机器上的 auth、config 或 Keychain 数据。业务 Skill 只负责调用 CLI；登录态读取、Cookie 拼接、业务 Token 获取和 HTTP header 注入都由 `weaver-work-cli` 内部完成。

package/skills/weaver-work-cli-shared/references/weaver-work-cli-installation.md

@@ -1,73 +0,0 @@
-# 安装与可用性检查
-
-## 什么时候读取
-
-命令不可用、版本不确定、用户刚安装、全局命令可能指向旧版本，或需要确认当前安装包含哪些 Agent Skill 时读取本文件。
-
-## 检查命令
-
-```bash
-weaver-work-cli --version
-weaver-work-cli setup invoice
-weaver-work-cli doctor --e10
-weaver-work-cli skills list
-```
-
-`weaver-work-cli skills list` 只证明包内 Skill 文件可读，不证明业务 API 可用；E10 登录态和 live API 仍需按业务命令实际验证。
-
-## 本地源码安装
-
-开发或本机调试时可以从源码构建并 link：
-
-```bash
-# 在克隆到本地的仓库根目录执行（将 <repo-root> 替换为实际路径）
-cd <repo-root>
-npm install
-npm run build
-npm link
-weaver-work-cli --help
-```
-
-如果怀疑全局 `weaver-work-cli` 仍是旧版本，在仓库内验证时优先直接调用当前构建产物：
-
-```bash
-node dist/index.js --version
-node dist/index.js commands list
-node dist/index.js skills list
-```
-
-## 推荐交付模式
-
-`weaver-work-cli` npm 包是唯一必须安装的运行时，包含 CLI 命令、E10 鉴权、
-发票业务 operation 和随包 Agent Skill 文档。普通用户安装 npm 包后即可使用：
-
-```bash
-npm install -g weaver-work-cli
-weaver-work-cli setup invoice
-weaver-work-cli auth login --base-url "<E10_BASE_URL>"
-weaver-work-cli invoice schema
-```
-
-如果当前环境需要让 Codex/Agent 直接加载发票 Skill，优先使用随包一键安装：
-
-```bash
-weaver-work-cli skills install invoice
-```
-
-该命令会同时安装 `weaver-work-cli-shared` 和 `weaver-work-cli-invoice` 到
-`$CODEX_HOME/skills`；未设置 `CODEX_HOME` 时使用 `~/.codex/skills`。默认目标
-面向 Codex CLI；WorkBuddy 等桌面 Agent 的用户级 Skill 目录不是默认目标，需
-显式指定后再安装：
-
-```bash
-weaver-work-cli skills install invoice --target-dir ~/.workbuddy/skills
-```
-
-`skills install` 是拷贝语义，装出的是真实副本，不与源目录联动。目标目录里
-已有旧条目（旧副本或软链）时不能直接覆盖：目标是软链会报
-`ERR_FS_CP_DIR_TO_NON_DIR`，先 `rm` 断链再安装；覆盖安装不会清理目标里已
-不存在的旧文件。安装只是文件拷贝，不需要 E10 登录；Agent 需新会话或重载
-Skill 后才读取新内容。完整安装/升级流程见仓库 `docs/agent-skill-install.md`。
-
-交付给 Agent 的 Skill ZIP 不内置运行时，只声明依赖本机可用的 `weaver-work-cli`
-bin。ZIP 主要用于平台导入、离线分发或版本归档，不应作为普通用户的必经安装步骤。