siluzan-cso-cli 1.1.18 → 1.1.19
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/dist/skill/SKILL.md
CHANGED
|
@@ -202,6 +202,25 @@ siluzan-cso rag query -q "产品 卖点 故事" --tags "产品资产库" --parti
|
|
|
202
202
|
|
|
203
203
|
---
|
|
204
204
|
|
|
205
|
+
## 时间字段输出约定（全局）
|
|
206
|
+
|
|
207
|
+
CLI 返回的时间字段（如 `*DateTime` / `*Time` / `createTime` / `publishTime` / `lastAuthorizationTime` / `expiresOn` 等）如果是 **UTC** 时间，在显示给用户时需要完成时区转换。
|
|
208
|
+
|
|
209
|
+
**输出规则（按优先级）**：
|
|
210
|
+
|
|
211
|
+
1. **优先用用户在当前对话中明确表达过的时区**（如「我在深圳」「PST 时间」「我刚从纽约出差回来」）。
|
|
212
|
+
2. **否则用对话语言推断默认时区**：中文 → `Asia/Shanghai (UTC+8)`，日文 → `Asia/Tokyo (UTC+9)`，英文且无其他线索 → 保留 UTC 并明确标注。
|
|
213
|
+
3. **若仍不确定且时间对用户决策有意义**（如「最近一次更新」、「创建于多久前」、「Token 何时过期」），**主动询问用户所在时区**，不要瞎猜。
|
|
214
|
+
|
|
215
|
+
**展示格式**：
|
|
216
|
+
|
|
217
|
+
- 推荐 `YYYY-MM-DD HH:mm (时区标识)`，例如 `2024-03-15 18:30 (UTC+8)`、`2024-03-15 10:30 (UTC)`。
|
|
218
|
+
- **禁止**把 `2024-03-15T10:30:00Z` 这种原始 ISO 串直接吐给用户——用户会误以为是当地时间。
|
|
219
|
+
- 跨日 / 月底 / 年底 / 夏令时切换附近的时间，换算时要**特别小心**，必要时多核对一遍。
|
|
220
|
+
- 极少数字段（如 `report` 报表里按用户业务时区聚合的统计时间）已经是用户本地时区，文档若有特别说明则以文档为准。
|
|
221
|
+
|
|
222
|
+
---
|
|
223
|
+
|
|
205
224
|
## 常见 HTTP 错误处理
|
|
206
225
|
|
|
207
226
|
| 状态码 | 原因 | 处理方式 |
|
package/dist/skill/_meta.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"slug": "siluzan-cso",
|
|
3
|
-
"version": "1.1.
|
|
4
|
-
"publishedAt":
|
|
3
|
+
"version": "1.1.19",
|
|
4
|
+
"publishedAt": 1779933115462,
|
|
5
5
|
"homepage": "https://www.siluzan.com",
|
|
6
6
|
"source": "https://dev.azure.com/jack4it/Sammamish/_git/siluzan-skill",
|
|
7
7
|
"requiredBinaries": [
|
|
@@ -15,7 +15,24 @@ siluzan-cso authorize --media-type LinkedIn
|
|
|
15
15
|
siluzan-cso authorize --media-type Twitter # X（推特）
|
|
16
16
|
```
|
|
17
17
|
|
|
18
|
-
|
|
18
|
+
命令执行后 CLI 会打印授权链接，并尝试在系统默认浏览器中打开授权页面；用户在浏览器完成授权后会自动跳转回账号管理页。
|
|
19
|
+
|
|
20
|
+
**当前若运行在受限的 API/工具环境（如沙箱、容器、远程 Agent 等无法自动唤起本地浏览器的场景），必须将 CLI 输出的完整授权链接展示给用户，由其手动复制到浏览器打开**
|
|
21
|
+
|
|
22
|
+
> ⚠️ 链接显示规范（必须遵守，否则可能会出现 URL 溢出容器、被强制折行、排版错乱）：
|
|
23
|
+
>
|
|
24
|
+
> - **必须**使用独立的围栏代码块（三个反引号 ` ``` `）展示链接，并指定语言为 `text`，让链接独占一整块、可横向滚动；
|
|
25
|
+
> - **不要**使用单反引号的行内代码（` `...` `）包裹长 URL —— 行内代码不会横向滚动，会被强制折行；
|
|
26
|
+
> - **不要**使用 Markdown 链接语法 `[文本](https://...)` —— 用户复制时容易漏掉字符；
|
|
27
|
+
> - 链接前后各保留一行空行，避免与正文挤在一起。
|
|
28
|
+
>
|
|
29
|
+
> ✅ 正确示例（向用户呈现的内容）：
|
|
30
|
+
>
|
|
31
|
+
> 请在浏览器中打开下面的授权链接完成授权：
|
|
32
|
+
>
|
|
33
|
+
> ```text
|
|
34
|
+
> https://accounts.google.com/o/oauth2/auth?access_type=offline&state=...&client_id=...&redirect_uri=...&scope=...&prompt=consent
|
|
35
|
+
> ```
|
|
19
36
|
|
|
20
37
|
---
|
|
21
38
|
|
|
@@ -54,12 +54,16 @@ siluzan-cso persona create --name <名称> ( --style-guide <markdown> | --style-
|
|
|
54
54
|
|
|
55
55
|
## 字段说明
|
|
56
56
|
|
|
57
|
-
| 字段
|
|
58
|
-
|
|
|
59
|
-
| `personaName`
|
|
60
|
-
| `styleGuide`
|
|
61
|
-
| `materials`
|
|
62
|
-
| `taskStatus`
|
|
57
|
+
| 字段 | 含义 |
|
|
58
|
+
| --------------------- | ----------------------------------------------------- |
|
|
59
|
+
| `personaName` | 人设名称 |
|
|
60
|
+
| `styleGuide` | 风格指南正文（Markdown） |
|
|
61
|
+
| `materials` | 参考素材（文件名、URL 等），新建时固定传空数组 |
|
|
62
|
+
| `taskStatus` | `1` 待生成 · `2` 生成中 · `3` 生成完成 · `4` 生成失败 |
|
|
63
|
+
| `createdDateTime` | **UTC** 时间字符串 |
|
|
64
|
+
| `lastChangedDateTime` | **UTC** 时间字符串 |
|
|
65
|
+
|
|
66
|
+
> 时间字段展示前必须做时区转换，详见 SKILL.md 「时间字段输出约定（全局）」。
|
|
63
67
|
|
|
64
68
|
## 与 Skill 的关系
|
|
65
69
|
|
|
@@ -9,7 +9,7 @@ $ErrorActionPreference = 'Stop'
|
|
|
9
9
|
# -- Package info (injected at build time) ------------------------------------
|
|
10
10
|
$PKG_NAME = 'siluzan-cso-cli'
|
|
11
11
|
# PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
|
|
12
|
-
$PKG_VERSION = '1.1.
|
|
12
|
+
$PKG_VERSION = '1.1.19'
|
|
13
13
|
$CLI_BIN = 'siluzan-cso'
|
|
14
14
|
$SKILL_LABEL = 'Siluzan CSO'
|
|
15
15
|
$INSTALL_CMD = 'npm install -g siluzan-cso-cli'
|
|
@@ -9,7 +9,7 @@ set -euo pipefail
|
|
|
9
9
|
# -- Package info (injected at build time) ------------------------------------
|
|
10
10
|
readonly PKG_NAME="siluzan-cso-cli"
|
|
11
11
|
# PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
|
|
12
|
-
readonly PKG_VERSION="1.1.
|
|
12
|
+
readonly PKG_VERSION="1.1.19"
|
|
13
13
|
readonly CLI_BIN="siluzan-cso"
|
|
14
14
|
readonly SKILL_LABEL="Siluzan CSO"
|
|
15
15
|
readonly INSTALL_CMD="npm install -g siluzan-cso-cli"
|
package/package.json
CHANGED