siluzan-tso-cli 1.1.8 → 1.1.9-beta.3

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.
package/README.md CHANGED
@@ -2,6 +2,35 @@
2
2
 
3
3
  当用户发来本页面的 **URL** 时,请按顺序协助用户完成安装。
4
4
 
5
+ ## 0. 安全与透明性说明
6
+
7
+ 本 Skill 是 **instruction-only**(纯指令型),不包含可执行代码文件。它通过指导 AI 助手调用 `siluzan-tso` CLI 来操作丝路赞广告管理平台。
8
+
9
+ ### 运行时依赖
10
+ | 项目 | 说明 |
11
+ |------|------|
12
+ | **Node.js 18+** | CLI 运行时 |
13
+ | **npm 8+** 或 **pnpm** | 安装 CLI 全局包 |
14
+ | **siluzan-tso** CLI | 由 `npm install -g siluzan-tso-cli` 安装 |
15
+
16
+ ### 凭据与网络
17
+ | 项目 | 说明 |
18
+ |------|------|
19
+ | API Key / Token | 存储在 `~/.siluzan/config.json`,用于所有 API 调用鉴权 |
20
+ | TSO API | `tso-api.siluzan.com`(生产)/ `tso-api-ci.siluzan.com`(测试) |
21
+ | Google API 网关 | `googleapi.mysiluzan.com` / `googleapi-ci.mysiluzan.com` |
22
+ | 前端页面 | `www.siluzan.com`(充值、激活等浏览器操作) |
23
+ | 错误追踪 | `o605862.ingest.us.sentry.io`(匿名崩溃日志) |
24
+ | 版本检查 | `registry.npmjs.org` |
25
+
26
+ ### 可执行的操作范围
27
+ - **只读**:查询账户列表、余额、消耗数据、报告、预警记录等
28
+ - **写入**(需用户确认):创建/修改/发布广告、开户申请、创建预警规则、报告推送配置
29
+ - **破坏性**(必须用户确认):账户解绑/关闭、MCC/BC 解绑、删除预警/报告/广告、发票申请
30
+
31
+ ### 报告模板外部资源
32
+ HTML 报告模板引用以下 CDN:`cdn.tailwindcss.com`、`cdnjs.cloudflare.com`、`cdn.jsdelivr.net`、`fonts.googleapis.com`。渲染报告时浏览器会发出对应网络请求。
33
+
5
34
  ## 1. 环境
6
35
 
7
36
  - Node.js **18+**
@@ -12,7 +41,7 @@
12
41
  在**用户的目标项目根目录**执行(根据用户使用的助手选择 `--ai`):
13
42
 
14
43
  ```bash
15
- npm install -g siluzan-tso-cli
44
+ npm install -g siluzan-tso-cli@beta
16
45
  siluzan-tso init --ai cursor # 写入 Cursor(默认)
17
46
  siluzan-tso init --ai cursor,claude # 同时写入多个平台
18
47
  siluzan-tso init --ai all # 写入所有支持的平台
@@ -20,6 +49,7 @@ siluzan-tso init -d /path/to/skills # 写入自定义目录
20
49
  siluzan-tso init --force # 强制覆盖已存在文件
21
50
  ```
22
51
 
52
+ > **注意**:当前为测试版(1.1.9-beta.3),供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
23
53
 
24
54
  | 助手 | 建议 `--ai` |
25
55
  |------|-------------|