sophhub 0.4.39 → 0.4.41

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sophhub",
-  "version": "0.4.39",
+  "version": "0.4.41",
   "description": "SophHub CLI - Manage and download AI Agent skills and agents",
   "type": "module",
   "bin": {

package/skills/sophclaw-skill-creator/skill.json

@@ -1,10 +1,20 @@
 {
   "name": "sophclaw-skill-creator",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "types": ["private"],
   "displayName": "Skill 创建向导",
   "description": "在 SophClaw 仓库中创建/修改 Skill 或为已有 Skill 补全 design.md。两条路径：路径 A（创建/修改）三步流程：需求对齐→方案对齐→生成代码；路径 B（补全 design.md）五步流程：确定目标→阅读代码→逆向整理→逐节确认→写入文档",
   "changelog": [
+    {
+      "version": "1.2.0",
+      "date": "2026-06-09",
+      "changes": [
+        "design.md 规范增强：方案设计新增「架构」（ASCII 流程图）和「职责划分」（组件职责表）为强制要点",
+        "关键设计决策要求每条包含「是什么」+「为什么」，帮助维护者理解取舍",
+        "路径 A/B 方案产出模板同步更新，路径 B 第三步新增架构提取步骤",
+        "注意事项新增 UV 相关约束要求：uv run 执行方式、[[tool.uv.index]] 阿里云镜像、pyproject.toml 版本同步"
+      ]
+    },
     {
       "version": "1.1.0",
       "date": "2026-05-28",
@@ -25,5 +35,5 @@
     }
   ],
   "createdAt": "2026-05-25",
-  "updatedAt": "2026-05-28"
+  "updatedAt": "2026-06-09"
 }

package/skills/sophclaw-skill-creator/src/pyproject.toml

@@ -1,5 +1,5 @@
 [project]
 name = "sophclaw-skill-creator"
-version = "1.1.0"
+version = "1.2.0"
 description = "Interactive skill creation wizard for SophClaw repository"
 requires-python = ">=3.8"

package/skills/sophclaw-skill-creator/src/references/path-a-create.md

@@ -138,13 +138,21 @@ description: 使用 Pillow 库对图片进行有损压缩，支持调整质量
 ## 二、方案设计
 - 目录结构
 - 是否需要脚本及理由
-- SKILL.md 关键设计决策
+- 架构（ASCII 流程图，展示数据流向和关键分支）
+- 职责划分（组件职责表，逐一说明各文件/模块的职责）
+- SKILL.md 关键设计决策（决策项 + 理由，帮助维护者理解 WHY）
 - 注意事项
 
 ## 三、测试用例
 | 编号 | 测试场景 | 触发语句 | 预期匹配 | 预期行为 | 预期输出 |
 ```
 
+> **架构流程图要求**：使用 ASCII 框图展示核心流程，包含关键分支、循环（如轮询）、成功/失败路径。流程图的目的是让接手者在不开代码的情况下理解整体数据流。
+>
+> **关键设计决策要求**：每条决策需包含「是什么」+「为什么」，帮助维护者理解取舍而非仅知道配置值。例如不应只写"默认模型是 Seedance-2.0"，而应补充选择依据。
+>
+> **注意事项要求**：覆盖运维和开发层面的关键约束，包括但不限于：`uv run` 执行方式、`[[tool.uv.index]]` 阿里云镜像源配置、`pyproject.toml` 与 `skill.json` 版本同步、外部依赖、运行时约束、路径约定等。
+
 测试用例至少覆盖：正常场景、不触发场景、边界场景。
 
 用户确认后进入下一步。

package/skills/sophclaw-skill-creator/src/references/path-b-backfill.md

@@ -61,7 +61,9 @@ digraph design_backfill {
 **还原方案设计**（从脚本代码 + 目录结构）：
 - 目录结构 ← `ls` 查看实际文件树
 - 是否需要脚本及理由 ← 存在 `src/scripts/` 则"需要"
-- SKILL.md 关键设计决策 ← 代码中的硬编码常量、特殊处理逻辑、注释说明
+- 架构 ← 从脚本主流程提取：入口 → 参数解析 → 核心逻辑 → 分支/循环（如轮询）→ 成功/失败出口，用 ASCII 流程图表示
+- 职责划分 ← 整理各文件/模块的职责分工，生成组件职责表
+- SKILL.md 关键设计决策 ← 代码中的硬编码常量、条件分支、特殊处理逻辑，**每条需解释"为什么"而不仅"是什么"**
 - 注意事项 ← SKILL.md 的异常处理表 + 脚本的错误分支
 
 **还原测试用例**（从 SKILL.md 的异常处理表 + 脚本边界逻辑）：
@@ -98,14 +100,21 @@ digraph design_backfill {
 ## 二、方案设计
 - 目录结构
 - 是否需要脚本及理由
-- SKILL.md 关键设计决策
+- 架构（ASCII 流程图，展示数据流向和关键分支）
+- 职责划分（组件职责表，逐一说明各文件/模块的职责）
+- SKILL.md 关键设计决策（决策项 + 理由，帮助维护者理解 WHY）
 - 注意事项
 
 ## 三、测试用例
 | 编号 | 测试场景 | 触发语句 | 预期匹配 | 预期行为 | 预期输出 |
 ```
 
-**补充说明**（在规范结构基础上可酌情扩充）：
-- 「需求说明」可追加"核心能力""不触发场景"小节，帮助完善边界描述
-- 「方案设计」可追加"架构""职责划分"小节，补充架构图和组件分工表
-- 以上为可选扩充，规范中的 4 个要点和表头必须保留
+> **架构流程图**：使用 ASCII 框图展示核心流程，包含关键分支、循环（如轮询）、成功/失败路径。接手者应能在不读代码的情况下理解整体数据流。
+>
+> **关键设计决策**：每条决策需包含「是什么」+「为什么」，帮助维护者理解取舍而非仅知道配置值。
+>
+> **注意事项**：覆盖运维和开发层面的关键约束，包括但不限于：`uv run` 执行方式、`[[tool.uv.index]]` 阿里云镜像源配置、`pyproject.toml` 与 `skill.json` 版本同步、外部依赖、运行时约束、路径约定等。
+
+**可酌情扩充**（规范要点必须保留，以下为补充）：
+- 「需求说明」可追加"核心能力""不触发场景"小节
+- 以上为可选扩充，规范中的 6 个要点和表头必须保留

package/skills/sophclaw-skill-creator/src/references/skill-notes.md

@@ -255,13 +255,27 @@ design.md 在 skill 创建阶段由 LLM 产出，放在 skill 根目录（与 sk
 ## 二、方案设计
 - 目录结构
 - 是否需要脚本及理由
-- SKILL.md 关键设计决策
+- 架构（ASCII 流程图，展示数据流向和关键分支）
+- 职责划分（组件职责表，逐一说明各文件/模块的职责）
+- SKILL.md 关键设计决策（决策项 + 理由，帮助维护者理解 WHY）
 - 注意事项
 
 ## 三、测试用例
 | 编号 | 测试场景 | 触发语句 | 预期匹配 | 预期行为 | 预期输出 |
 ```
 
+> **架构流程图要求**：使用 ASCII 框图展示核心流程，包含关键分支、循环（如轮询）、成功/失败路径。流程图应让接手者在不读代码的情况下理解整体数据流。
+>
+> **关键设计决策要求**：每条决策需包含「是什么」+「为什么」，帮助维护者理解取舍而非仅知道配置值。例如不应只写"默认模型是 Seedance-2.0"，而应补充选择依据。
+>
+> **注意事项要求**：覆盖运维和开发层面的关键约束，包括但不限于：
+> - 执行方式：`uv run` 而非 `python`
+> - 镜像源：`[[tool.uv.index]]` 是否配置了阿里云镜像
+> - 版本同步：`pyproject.toml` version 与 `skill.json` 保持一致
+> - 外部依赖：API Key、第三方服务、系统工具（如 curl）等
+> - 运行时约束：超时时间、轮询间隔、文件存储时效等
+> - 路径约定：SKILL.md 中路径使用运行时路径（不含 `src/`）
+
 ### 用途
 
 - 记录设计决策，供后续维护者参考

package/skills/sophnet-oss/skill.json

@@ -1,12 +1,23 @@
 {
   "name": "sophnet-oss",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "types": [
     "builtin"
   ],
   "displayName": "OSS链接生成",
   "description": "将文件转换为一个可供下载的文件链接",
   "changelog": [
+    {
+      "changes": [
+        "SKILL.md 全文中文化，精简 description 为中文「功能+触发场景」格式",
+        "Signed URL 章节新增 credential 日期不可修改、禁止重复参数约束",
+        "合并 Processing Mode 与禁止操作章节，输出模板固定化防止 LLM 篡改链接",
+        "新增 design.md 设计文档，含架构流程图和职责划分表",
+        "修复 pyproject.toml 版本号与 skill.json 同步"
+      ],
+      "date": "2026-06-09",
+      "version": "1.1.1"
+    },
     {
       "changes": [
         "补充签名下载链接必须完整保留查询参数的使用约束"
@@ -23,5 +34,5 @@
     }
   ],
   "createdAt": "2026-04-09",
-  "updatedAt": "2026-05-13"
+  "updatedAt": "2026-06-09"
 }

package/skills/sophnet-oss/src/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: sophnet-oss
-description: Convert a local file path to a downloadable URL (valid for 24 hours). Use when users want to turn a file path into a shareable link, get a URL for a file, or need a temporary URL to access a local file.
+description: 将本地文件路径转换为可下载链接（24小时有效）。当用户要求把文件转成链接、获取文件URL、分享文件时使用。
 ---
 
 # File Path to URL
@@ -13,32 +13,23 @@ description: Convert a local file path to a downloadable URL (valid for 24 hours
 
 - **必须**使用脚本输出的 `DOWNLOAD_URL` **完整字符串**（一字不改）填入下文展示模板中的下载链接，或原样写入下游。
 - **禁止**去掉 `?` 及后续查询参数、禁止截取签名片段、禁止尝试「换成更短的裸 URL」或做任何 URL「美化」。
-- 签名 URL 的参数中，**`x-oss-signature-version` 和 `x-oss-credential` 不可省略**，分别为签名算法的版本标识和访问凭证标识，缺失任一参数均会导致签名校验失败。
+- 签名 URL 的参数中，**`x-oss-signature-version` 和 `x-oss-credential` 不可省略**，分别为签名算法的版本标识和访问凭证标识，缺失任一参数均会导致签名校验失败。**`x-oss-credential` 内嵌的日期不可修改**，禁止插入重复的 credential 参数。
 - 若裸域名路径在无签名时可访问，那是偶然行为；本 skill **不以裸链为准**，仅以脚本输出的带签名 URL 为准。
 - 向用户展示时沿用下文「转换成功后」的固定格式即可；**不要改模板结构**，只保证链接内容为完整签名 URL。
 
-## Processing Mode
+## 前置条件
 
-**STRICT SERIAL PROCESSING ONLY** - This skill must execute in a single, sequential operation:
-
-- **NO sub-tasks** - Never spawn background sessions or use sessions_spawn
-- **NO task splitting** - Complete the conversion in one continuous run
-- **NO parallel execution** - Convert one file at a time
-
-## Prerequisites
-
-- Python packages: sophnet-tools
+- Python 包：`sophnet-tools`（需预先安装在系统 Python 环境中）
 
 ## Usage
 
-When a user wants to convert a file path to a URL:
+当用户要求将文件路径转换为 URL 时：
 
-1. **Extract file path** from user input or recent logs (see Path Extraction below).
-2. **Run the script** using uv from workspace or skill directory:
+1. **提取文件路径**：从用户输入或日志中提取（见下文「路径提取」）。
+2. **运行脚本**：
 
 ```bash
-uv run --with sophnet-tools \
-  python {baseDir}/scripts/upload_file.py \
+python3 {baseDir}/scripts/upload_file.py \
   --file /absolute/path/to/file \
   --timeout 120
 ```
@@ -48,72 +39,66 @@ uv run --with sophnet-tools \
 - `--file`: 要转换为 URL 的本地文件路径（必填）
 - `--timeout`: 请求超时秒数（默认 120，大文件可适当增大）
 
-## Output
+## 输出
 
-The script outputs structured key-value pairs:
+脚本输出结构化键值对：
 
+成功时：
 ```
 FILE_PATH=/absolute/path/to/file
 UPLOAD_STATUS=uploaded
 DOWNLOAD_URL=https://...signed-url...
 ```
 
-On failure:
-
+失败时：
 ```
 FILE_PATH=/absolute/path/to/file
 UPLOAD_STATUS=failed
-ERROR=error description
+ERROR=错误描述
 ```
 
-**转换成功后，向用户展示为：**
+**转换成功后，向用户展示为（固定模板，不可修改结构）：**
 
 ```
 文件路径已转换为可访问链接：
 
 文件路径：/absolute/path/to/file
-下载链接：https://...signed-url...
+下载链接：<完整 DOWNLOAD_URL，一字不改>
 
 ⏰ 链接有效期：24小时
 ```
 
-## Path Extraction
+## 路径提取
 
-When users provide files through chat, look for log patterns like:
+当用户通过聊天提供文件时，从日志中查找以下模式：
 
 ```
 Resolved relative path: "media/inbound/images/xxx.pdf" -> "/absolute/path/to/workspace/media/inbound/images/xxx.pdf"
 ```
 
-Extract the absolute path (right side of `->`) for use with the script.
+取 `->` 右侧的绝对路径传入脚本。优先从上述日志中取解析后的路径，再回退到用户输入。
 
-对于用户提供或引用的文件，优先从上述日志中取解析后的绝对路径，再传入脚本做路径转 URL。
+## 示例流程
 
-## Example Workflow
+用户："把这个文件转成链接" / "给我这个文件的 URL"
 
-User: "把这个文件转成链接" / "给我这个文件的 URL"
+1. 从日志 pattern（`Resolved relative path: "..." -> "/absolute/..."`）或用户输入提取文件路径
+2. 执行：`python3 {baseDir}/scripts/upload_file.py --file /absolute/path/to/file --timeout 120`
+3. 解析输出，按固定模板向用户展示下载链接
 
-1. Extract file path from logs (pattern: `Resolved relative path: "..." -> "/absolute/..."`) or user input
-2. Run: `uv run --with sophnet-tools python {baseDir}/scripts/upload_file.py --file /absolute/path/to/file --timeout 120`
-3. Parse the output and display the URL to the user
-
-## Notes
+## 注意事项
 
 - 返回的 URL 有效期为 **24 小时**
 - 任意类型文件均可转换（无扩展名限制）
 - 大文件可增大 `--timeout`（默认 120 秒）
 - 始终使用绝对路径以保证可靠
+- **严格串行执行**：禁止并发、禁止拆分子任务、禁止后台运行，一次只转换一个文件
+- **不修改签名 URL**：`DOWNLOAD_URL` 必须原样使用，不截取、不"美化"、不修改任何参数
 
-## ⚠️ FORBIDDEN OPERATIONS
-
-**Do NOT:**
-
-- Spawn sub-agent sessions (sessions_spawn)
-- Run multiple parallel conversions
-- Split the task into separate operations
-- Use background processes
-
-**ONLY:**
+## ⚠️ 禁止操作
 
-- Run the script once with the file path
-- Return the URL to the user in a single response
+- 禁止派生子会话（sessions_spawn）
+- 禁止并发转换多个文件
+- 禁止将任务拆分为多个步骤
+- 禁止使用后台进程
+- 禁止修改 `DOWNLOAD_URL` 中的任何字符（含查询参数）

package/skills/sophnet-oss/src/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sophnet-oss"
-version = "0.1.0"
+version = "1.1.1"
 description = "Skill-local runtime dependencies for sophnet-oss"
 requires-python = ">=3.10"
 dependencies = [